Kaeon United is, in short, an "everything engine".
Kaeon United's primary purpose is to act as both the framework and the platform for Kaeon META, a distributed and dynamic network of servers, applications, and physical devices, which shall, via the integration of powerful AI utilities, collectively carry out requests from human users, ranging from minor tasks to massive projects, in both digital and physical space.
In scaling to such needs, Kaeon United features a vast array of utilities for various domains of software and hardware that may be used independently for third party projects.
The way Kaeon United actually works can be summed up as "an interface of interfaces to a library of libraries".
At its core, Kaeon United consists of a suite of APIs and applications for various uses and platforms, many of which come in multiple versions for the different platforms it may operate within. This suite consists of disparate parts linked together by reference documents, and many of these parts are reliant on one another.
The suite is accessible via modules referred to as interfaces, which are libraries or applications linked to the core reference document of the suite, which automatically dynamically import and adapt the suite's contents into the context that said modules are executed in as requested, which it can do via CDN if needed, reducing setup.
The current interfaces for Kaeon United allow it to run in the console, for singular tasks, or as an application or server, to run as a web application, or to be used as an all-purpose library with various sub-modules.
Kaeon United, being an "everything engine", provides such a vast array of functionality, that it would be simpler to describe what it doesn't do.
The full scope of the ever growing set of features provided by Kaeon United is detailed in the Kaeon United Specification.
That said, here are some key highlights at the time of writing:
GhostHost is a platform built into Kaeon United which allows users to render code stored in plain text on external sources as live websites.
Kaeon FUSION is a modular programming language which can be extended and modified at runtime to take on virtually any programming paradigm, from dynamically integrating strong typing mid-program to allowing code to run backwards.
Kaeon FUSION also integrates the ONE and ONE+ data interchange languages, as well as the Universal Preprocessor, which takes the basic concept of PHP and extends it to allow preprocessor scripts written in any language to write to the source code of any other, allowing the syntax of the target source code to be customized to an indefinite extent.
Kaeon Origin is a virtual OS which runs on GhostHost, providing a file system, and a terminal interface with linux style commands in the browser.
Kaeon Origin also comes with a virtual assistant called Kaeon META, which has generative AI chat functionality and audio playback functionality.
Kaeon META can also be used in user code via a library.
Kaeon United provides a vast array of libraries, with builds for various programming languages sharing identical interfaces, though the most developed of these are for JS, and with options for access via CDN, package manager, and manual installation.
Many of the general utilities in these libraries pertain to networking, I/O, and parsing.
In addition to these, Kaeon United provides a series of frameworks for more specialized operations:
Vision is a lightweight UI framework allowing for HTML5 applications to be constructed entirely in JS without the need for building prior to deployment.
United C is a backwards-compatible hybrid of C and C++ with several modernized syntax features, such as code outside the main function, optional semicolons, optional inferred typing, and more, plus a streamlined build process.
United JS is a variant of JS which allows CommonJS to be used inside the browser, which causes node to automatically install any uninstalled packages at runtime, and which allows CommonJS to fetch code from CDNs, which uses CORS proxies to nullify the same origin policy in the browser, and which allows for top-level awaits.
And here are some features which are in development:
Kaeon ACE is a game and visualization framework which allows the content of a scripted game or scene to be specified in ONE+ such that it may be built to various game and visualization engines.
In a nutshell, it is to game engines what HTML is to browsers.
It supports both augmented and virtual reality.
Kaeon Control is a hardware telemetry suite which consists of two elements.
The first is a plugin that may be installed with a native Kaeon United installation onto SBCs, with support for pin and I/O, as well as wireless, bluetooth, and cellular communication.
The second is a suite of tools that may be used to format and send requests to devices utilizing said plugin in order to remotely control, monitor, and script them.
Waypoint is a lightweight framework for state and database management, with features optimized for MVC architectures.
To use Kaeon United as a script, reference it via jsDelivr or another similar service.
Kaeon United can be accessed through jsDelivr via the following URL:
https://cdn.jsdelivr.net/gh/kaeon-united/kaeon-united/Kaeon%20United/2%20-%20Wonders/2%20-%20Source/1%20-%20Code/1%20-%20Interface/2%20-%20Singularities/1%20-%20Modules/2%20-%20Library/1%20-%20Frontend/kaeonUnitedSingularityScript.js
As a script, Kaeon United shall provide access to the United JavaScript version of CommonJS in the browser.
Kaeon United is available on npm under the alias "kaeon-united", and as such, it may be used as a command line utility via npx.
A Kaeon United CLI command follows this general format:
npx kaeon-united [(1) operation] [(2*) "open" / "read"] [(3*) file / data] [(4*) export path / argument 1] [(5+*) argument 2+]
An asterisk indicates that the argument may or may not be necessary depending on the operation
All Kaeon United CLI commands operate on data which must either be imported from a file or specified literally.
The first argument specifies which operation to perform.
The second argument specifies whether the provided data will be imported from a file, in which case the argument shall be "open", or specified literally, in which case the argument shall be "read".
The third argument shall either specify the path to the file from which to import the data if the second argument was "open", or shall specify the literal data if the second argument was "read".
If a file path is specified, it may be in the form of a URL to a raw text file stored online.
The fourth argument shall specify a file path to export any output of the operation to.
Kaeon United operations are separated into the two categories, processor operations and translator operations.
Processor operations, each of which are associated with a specific programming language, may or may not have the second and third arguments, and the third argument may be followed by an indefinite number of other arguments.
If arguments two and three are provided, then they shall take the specified data and execute it as code in their respective language, with any additional arguments passed to said code as command line arguments. If arguments two and three are not provided, then they shall open a REPL for their respective language.
Translator operations, each of which are associated with two specific programming languages, an input language and an output language, must have the second and third arguments, and may or may not use a fourth argument to specify an export path.
They shall take the data specified by the second and third arguments as code in their respective input language and convert it to code in their respective output language.
If the fourth argument is present, they shall write the output to the file path specified by said argument, and if not, they shall write the output to the console.
The operations that Kaeon United supports are "js", "process", "parse", "preprocess", "ucc", "assemble", and "disassemble".
The js operation is a processor operation for United JavaScript.
The process operation is a processor operation for Kaeon FUSION.
The parse operation is a translator operation where ONE+ is the input language and ONE is the output language.
The preprocess operation is a translator operation where the Universal Preprocessor is the input language and raw text is the output language.
The UCC operation is a translator operation where United C is the input language and C is the output language.
The UCC operation should specify the input as a file path using "read".
The UCC operation requires both gcc and make to be installed.
The assemble operation is a translator operation where CSB is the input language and binary is the output language.
The disassemble operation is a translator operation where binary is the input language and CSB is the output language.
The disassemble operation should specify the input as a file path using "read".
If using United JavaScript through Kaeon United's CDN, Script, or CLI modes, then Kaeon United may be imported as a CommonJS style module through the KaeonUnited require function via the alias "Kaeon United" and "kaeon-united".
Said module shall take the form of a function which, when called with a string argument, shall return a module from the Kaeon Utilities with an alias matching said argument.
Calling said function without a string argument shall return a JSON object specfying the aliases of all modules available through the function.
For example:
var io = require("kaeon-united")("io");
shall load the io module and store it in a variable called "io", and:
console.log(require("kaeon-united")());
shall print the aforementioned JSON object.
The imported module may act also as a Kaeon FUSION interface, which shall load the most important Kaeon FUSION modules, including the standard module.
For example:
Use: Kaeon United; Log Line: 'Hello, world!'
shall log "Hello, world!" to the console.