@amodx/ncs 0.0.1 → 0.0.21

package/Util/Observable.d.ts

@@ -0,0 +1,28 @@
+export type ObservableFunction<T> = (data: T) => void;
+export declare class Observable<T = void> {
+    private observers;
+    private once;
+    constructor();
+    listener(func: any): ObservableFunction<T>;
+    /**
+     * Subscribe to the observer. If only the first param is set must be the observer function itself which will be used as they key.
+     * Otherwise the first param is the key to subsrcibe to the observer with.
+     */
+    subscribe(func: ObservableFunction<T>): void;
+    /**
+     * Unsubscribe to the observer using the key used in the subscribe function.
+     */
+    unsubscribe(func: ObservableFunction<T>): boolean;
+    /**
+     * Subscribe to the observer once.
+     */
+    subscribeOnce(func: ObservableFunction<T>): void;
+    /**
+     * Run each callback function.
+     */
+    notify(data: T): void;
+    /**
+     * Removes all observers.
+     */
+    clear(): void;
+}

package/Util/Observable.js

@@ -0,0 +1,58 @@
+export class Observable {
+    observers = [];
+    once = null;
+    constructor() { }
+    listener(func) {
+        return func;
+    }
+    /**
+     * Subscribe to the observer. If only the first param is set must be the observer function itself which will be used as they key.
+     * Otherwise the first param is the key to subsrcibe to the observer with.
+     */
+    subscribe(func) {
+        this.observers.push(func);
+    }
+    /**
+     * Unsubscribe to the observer using the key used in the subscribe function.
+     */
+    unsubscribe(func) {
+        for (let i = 0; i < this.observers.length; i++) {
+            if (this.observers[i] == func) {
+                this.observers.splice(i, 1);
+                if (this.once && this.once.has(func))
+                    this.once.delete(func);
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Subscribe to the observer once.
+     */
+    subscribeOnce(func) {
+        this.observers.push(func);
+        if (!this.once)
+            this.once = new Set();
+        this.once.add(func);
+    }
+    /**
+     * Run each callback function.
+     */
+    notify(data) {
+        for (let i = this.observers.length - 1; i >= 0; i--) {
+            const func = this.observers[i];
+            func(data);
+            if (this.once && this.once.has(func)) {
+                this.observers.splice(i, 1);
+                this.once.delete(func);
+            }
+        }
+    }
+    /**
+     * Removes all observers.
+     */
+    clear() {
+        this.once && this.once.clear();
+        this.observers.length = 0;
+    }
+}

package/Util/Util.types.d.ts

@@ -0,0 +1,4 @@
+export type Nullable<T> = T | null;
+export type RecursivePartial<T> = {
+    [P in keyof T]?: RecursivePartial<T[P]>;
+};

package/index.d.ts

@@ -1,8 +1,18 @@
 export * from "./NCS";
+export * from "./Functional";
 export * from "./Graphs/Graph";
-export * from "./Components/ComponentData";
-export * from "./Components/ComponentInstance";
-export * from "./Traits/TraitData";
-export * from "./Traits/TraitInstance";
-export * from "./Nodes/NodeData";
-export * from "./Nodes/NodeInstance";
+export * from "./Data/SerializedData.types";
+export * from "./Schema/Schema";
+export * from "./Schema/Property/Property";
+export * from "./Nodes/NodeCursor";
+export * from "./Nodes/Node.types";
+export * from "./Components/Component.types";
+export * from "./Components/ComponentCursor";
+export * from "./Tags/Tag.types";
+export * from "./Tags/TagCursor";
+export * from "./Contexts/Context.types";
+export * from "./Contexts/ContextCursor";
+export * from "./Queries/Query.types";
+export * from "./Queries/QueryInstance";
+export * from "./Systems/System.types";
+export * from "./Systems/SystemInstance";

package/index.js

@@ -1,8 +1,26 @@
 export * from "./NCS";
+export * from "./Functional";
 export * from "./Graphs/Graph";
-export * from "./Components/ComponentData";
-export * from "./Components/ComponentInstance";
-export * from "./Traits/TraitData";
-export * from "./Traits/TraitInstance";
-export * from "./Nodes/NodeData";
-export * from "./Nodes/NodeInstance";
+//data
+export * from "./Data/SerializedData.types";
+//schema
+export * from "./Schema/Schema";
+export * from "./Schema/Property/Property";
+//nodes
+export * from "./Nodes/NodeCursor";
+export * from "./Nodes/Node.types";
+//components
+export * from "./Components/Component.types";
+export * from "./Components/ComponentCursor";
+//tags
+export * from "./Tags/Tag.types";
+export * from "./Tags/TagCursor";
+//context
+export * from "./Contexts/Context.types";
+export * from "./Contexts/ContextCursor";
+//queries
+export * from "./Queries/Query.types";
+export * from "./Queries/QueryInstance";
+//systems
+export * from "./Systems/System.types";
+export * from "./Systems/SystemInstance";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amodx/ncs",
-  "version": "0.0.01",
+  "version": "0.0.21",
   "module": "index.js",
   "types": "index.d.ts",
   "type": "module",

package/Components/ComponentData.d.ts

@@ -1,112 +0,0 @@
-import { Property } from "@amodx/schemas";
-import { ComponentInstance } from "./ComponentInstance";
-import { TraitData } from "../Traits/TraitData";
-/**
- * Interface representing the meta data of a component.
- */
-export interface ComponentMetaData {
-    name: string;
-    [key: string]: any;
-}
-/**
- * Interface representing the pool data of a component.
- */
-export interface ComponentPoolData {
-    maxSize: number;
-    [key: string]: any;
-}
-/**
- * Interface representing the state data of a component.
- */
-export interface ComponentStateData {
-    [key: string]: any;
-}
-/**
- * Type representing the data of a component.
- *
- * @template ComponentSchema - The ComponentSchema of the component.
- */
-export type ComponentData<ComponentSchema extends object = any> = {
-    /**
-     * The type of the component.
-     */
-    type: string;
-    /**
-     * The namespace of the component.
-     */
-    namespace?: string;
-    /**
-     * The state data of the component.
-     */
-    state: ComponentStateData;
-    /**
-     * The ComponentSchema of the component.
-     */
-    schema: ComponentSchema;
-    /**
-     * The traits associated with the component.
-     */
-    traits: TraitData[];
-};
-/**
- * Type representing the data required to register a component.
- *
- * Used for serlization and creation.
- * @template ComponentSchema - The schema of the component.
- * @template Data - The runtime data of the component.
- * @template Logic - The logic functions of the component.
- * @template Shared - The shared data of all components of this type.
- * @template Meta - The shared meta data of all components of this type.
- */
-export type ComponentRegisterData<ComponentSchema extends object = {}, Data extends Record<string, any> = {}, Logic extends Record<string, any> = {}, Shared extends Record<string, any> = {}> = {
-    /**
-     * The type of the component.
-     */
-    type: string;
-    /**
-     * The namespace of the component.
-     */
-    namespace?: string;
-    pool?: ComponentPoolData;
-    /**
-     * The schema used to create an editable version of the component.
-     * For the actual ComponentInstance the schema is created into an object.
-     */
-    schema?: Property<any, any>[];
-    /**
-     * The logic functions of the component.
-     */
-    logic?: Logic | ((component: ComponentInstance<ComponentSchema, Data, Logic, Shared>) => Logic);
-    /**
-     * The runtime data of the component.
-     */
-    data?: Data | ((component: ComponentInstance<ComponentSchema, Data, Logic, Shared>) => Data);
-    /**
-     * The shared data of all components.
-     */
-    shared?: Shared;
-    /**
-     * The shared meta data of all components.
-     */
-    meta?: ComponentMetaData;
-    /**
-     * Optional initialization function for the component.
-     *
-     * @param component - The instance of the component being initialized.
-     */
-    init?(component: ComponentInstance<ComponentSchema, Data, Logic, Shared>): Promise<void> | void;
-    /**
-     * Optional update function for the component.
-     * The update function is usually called once per frame.
-     * It is up to the graph though when it gets called.
-     *
-     * @param component - The instance of the component being updated.
-     */
-    update?(component: ComponentInstance<ComponentSchema, Data, Logic, Shared>): Promise<void> | void;
-    /**
-     * Optional disposal function for the component.
-     *
-     * @param component - The instance of the component being disposed.
-     */
-    dispose?(component: ComponentInstance<ComponentSchema, Data, Logic, Shared>): Promise<void> | void;
-};

package/Components/ComponentInstance.d.ts

@@ -1,36 +0,0 @@
-import { ComponentData, ComponentStateData } from "./ComponentData";
-import { ObjectSchemaInstance, QueryPath } from "@amodx/schemas";
-import { SchemaNode } from "@amodx/schemas/Schemas/SchemaNode";
-import { NodeInstance } from "../Nodes/NodeInstance";
-import { ComponentObservers } from "./ComponentObservers";
-import { ComponentPipelines } from "./ComponentPipelines";
-import { TraintContainer } from "../Traits/TraitContainer";
-import { ComponentPrototype } from "./ComponentPrototype";
-export declare class ComponentInstance<ComponentSchema extends object = {}, Data extends object = {}, Logic extends object = {}, Shared extends object = {}> {
-    get type(): string;
-    get shared(): Shared;
-    componentPrototype: ComponentPrototype<ComponentSchema, Data, Logic, Shared>;
-    schema: ObjectSchemaInstance<ComponentSchema>;
-    data: Data;
-    logic: Logic;
-    state: ComponentStateData;
-    private _traits?;
-    get traits(): TraintContainer;
-    get hasTraits(): boolean;
-    private _observers?;
-    get observers(): ComponentObservers;
-    get hasObservers(): boolean;
-    private _pipelines?;
-    get pipelines(): ComponentPipelines<ComponentSchema>;
-    get hasPipelines(): boolean;
-    node: NodeInstance;
-    addOnSchemaUpdate(path: QueryPath<ComponentSchema>, listener: (node: SchemaNode) => void): void;
-    removeOnSchemaUpdate(path: QueryPath<ComponentSchema>, listener: (node: SchemaNode) => void): void;
-    init(): Promise<void>;
-    private _disposed;
-    isDisposed(): boolean;
-    dispose(): Promise<void>;
-    getDependencies(): boolean;
-    copy(): ComponentData;
-    toJSON(): ComponentData;
-}

package/Components/ComponentInstance.js

@@ -1,125 +0,0 @@
-import { ObjectPath } from "@amodx/schemas";
-import { GraphUpdate } from "../Graphs/GraphUpdate";
-import { ComponentObservers } from "./ComponentObservers";
-import { ComponentPipelines } from "./ComponentPipelines";
-import { TraintContainer } from "../Traits/TraitContainer";
-export class ComponentInstance {
-    get type() {
-        return this.componentPrototype.data.type;
-    }
-    get shared() {
-        return this.componentPrototype.data.shared;
-    }
-    componentPrototype;
-    schema;
-    data;
-    logic;
-    state;
-    _traits;
-    get traits() {
-        if (!this._traits) {
-            this._traits = new TraintContainer(this);
-        }
-        return this._traits;
-    }
-    get hasTraits() {
-        return Boolean(this._traits);
-    }
-    _observers;
-    get observers() {
-        if (!this._observers) {
-            this._observers = new ComponentObservers();
-        }
-        return this._observers;
-    }
-    get hasObservers() {
-        return Boolean(this._observers);
-    }
-    _pipelines;
-    get pipelines() {
-        if (!this._pipelines) {
-            this._pipelines = new ComponentPipelines();
-        }
-        return this._pipelines;
-    }
-    get hasPipelines() {
-        return Boolean(this._pipelines);
-    }
-    node;
-    addOnSchemaUpdate(path, listener) {
-        this.schema
-            .getSchema()
-            .getNode(ObjectPath.Create(path))
-            ?.observers.updatedOrLoadedIn.subscribe(listener);
-    }
-    removeOnSchemaUpdate(path, listener) {
-        this.schema
-            .getSchema()
-            .getNode(ObjectPath.Create(path))
-            ?.observers.updatedOrLoadedIn.unsubscribe(listener);
-    }
-    async init() {
-        if (!this.componentPrototype.data.init)
-            return;
-        await this.componentPrototype.data.init(this);
-        if (this.componentPrototype.data.update) {
-            GraphUpdate.addComponentToUpdate(this);
-        }
-    }
-    _disposed = false;
-    isDisposed() {
-        return this._disposed;
-    }
-    async dispose() {
-        if (this.componentPrototype.data.update) {
-            GraphUpdate.removeComponentFromUpate(this);
-        }
-        this.hasPipelines &&
-            this.pipelines.isDisposedSet() &&
-            this.pipelines.disposed.pipe(this);
-        this.hasObservers &&
-            this.observers.isDisposedSet() &&
-            this.observers.disposed.notify();
-        if (this.componentPrototype.data.dispose)
-            await this.componentPrototype.data.dispose(this);
-        this._disposed = true;
-        if (this.hasTraits)
-            await this.traits.dispose();
-        this.componentPrototype.destory(this);
-        delete this._traits;
-        delete this._observers;
-        delete this._pipelines;
-    }
-    getDependencies() {
-        //  return this.node.graph.dependencies;
-        return false;
-    }
-    copy() {
-        const data = {
-            schema: this.schema?.getSchema
-                ? this.schema.getSchema().store()
-                : {},
-            type: this.type,
-            state: this.state,
-            traits: (this.hasTraits && this.traits.traits.map((_) => _.toJSON())) || [],
-        };
-        return ((this.hasPipelines &&
-            this.pipelines.isCopySet() &&
-            this.pipelines.copy.pipe(data)) ||
-            data);
-    }
-    toJSON() {
-        const data = {
-            schema: this.schema?.getSchema
-                ? this.schema.getSchema().store()
-                : {},
-            type: this.type,
-            state: this.state,
-            traits: (this.hasTraits && this.traits.traits.map((_) => _.toJSON())) || [],
-        };
-        return ((this.hasPipelines &&
-            this.pipelines.isToJSONSet() &&
-            this.pipelines.toJSON.pipe(data)) ||
-            data);
-    }
-}

package/Components/ComponentInstanceMap.d.ts

@@ -1,7 +0,0 @@
-import { ComponentInstance } from "./ComponentInstance";
-import { ItemGraphMap } from "../Maps/ItemGraphMap";
-export declare class ComponentInstanceMap {
-    private static types;
-    static registerComponent(type: string): ItemGraphMap<any>;
-    static getMap(type: string): ItemGraphMap<ComponentInstance<any, any, any, any>>;
-}

package/Components/ComponentInstanceMap.js

@@ -1,15 +0,0 @@
-import { ItemGraphMap } from "../Maps/ItemGraphMap";
-export class ComponentInstanceMap {
-    static types = new Map();
-    static registerComponent(type) {
-        const map = new ItemGraphMap();
-        this.types.set(type, map);
-        return map;
-    }
-    static getMap(type) {
-        const map = this.types.get(type);
-        if (!map)
-            throw new Error(`Map for component ${type} does not exist`);
-        return map;
-    }
-}

package/Components/ComponentObservers.d.ts

@@ -1,8 +0,0 @@
-import { Observable } from "@amodx/core/Observers";
-export interface ComponentObservers {
-}
-export declare class ComponentObservers {
-    private _disposed?;
-    get disposed(): Observable<void>;
-    isDisposedSet(): boolean;
-}

package/Components/ComponentObservers.js

@@ -1,13 +0,0 @@
-import { Observable } from "@amodx/core/Observers";
-export class ComponentObservers {
-    _disposed;
-    get disposed() {
-        if (!this._disposed) {
-            this._disposed = new Observable();
-        }
-        return this._disposed;
-    }
-    isDisposedSet() {
-        return !!this._disposed;
-    }
-}

package/Components/ComponentPipelines.d.ts

@@ -1,16 +0,0 @@
-import { Pipeline } from "@amodx/core/Pipelines";
-import { ComponentInstance } from "./ComponentInstance";
-import { ComponentData } from "./ComponentData";
-export interface ComponentPipelines {
-}
-export declare class ComponentPipelines<ComponentSchema extends object = {}> {
-    private _disposed?;
-    private _toJSON?;
-    private _copy?;
-    get disposed(): Pipeline<ComponentInstance<ComponentSchema>>;
-    get toJSON(): Pipeline<ComponentData<ComponentSchema>>;
-    get copy(): Pipeline<ComponentData<ComponentSchema>>;
-    isDisposedSet(): boolean;
-    isToJSONSet(): boolean;
-    isCopySet(): boolean;
-}

package/Components/ComponentPipelines.js

@@ -1,33 +0,0 @@
-import { Pipeline } from "@amodx/core/Pipelines";
-export class ComponentPipelines {
-    _disposed;
-    _toJSON;
-    _copy;
-    get disposed() {
-        if (!this._disposed) {
-            this._disposed = new Pipeline();
-        }
-        return this._disposed;
-    }
-    get toJSON() {
-        if (!this._toJSON) {
-            this._toJSON = new Pipeline();
-        }
-        return this._toJSON;
-    }
-    get copy() {
-        if (!this._copy) {
-            this._copy = new Pipeline();
-        }
-        return this._copy;
-    }
-    isDisposedSet() {
-        return !!this._disposed;
-    }
-    isToJSONSet() {
-        return !!this._toJSON;
-    }
-    isCopySet() {
-        return !!this._copy;
-    }
-}

package/Components/ComponentPrototype.d.ts

@@ -1,17 +0,0 @@
-import { ObjectSchemaInstance, Schema } from "@amodx/schemas";
-import { ComponentData, ComponentRegisterData } from "./ComponentData";
-import { ComponentInstance } from "./ComponentInstance";
-import { NodeInstance } from "../Nodes/NodeInstance";
-import { ItemPool } from "../Pools/ItemPool";
-export declare class ComponentPrototype<ComponentSchema extends object = {}, Data extends Record<string, any> = {}, Logic extends Record<string, any> = {}, Shared extends Record<string, any> = {}> {
-    data: ComponentRegisterData<ComponentSchema, Data, Logic, Shared>;
-    schemaController: Schema<ComponentSchema> | null;
-    baseContextSchema: ComponentSchema;
-    pool: ItemPool<ComponentInstance<ComponentSchema, Data, Logic, Shared>>;
-    constructor(data: ComponentRegisterData<ComponentSchema, Data, Logic, Shared>);
-    getSchema(overrides: Partial<ComponentSchema>): ObjectSchemaInstance<ComponentSchema>;
-    private getPooled;
-    private return;
-    create(node: NodeInstance, data: ComponentData): ComponentInstance<ComponentSchema, Data, Logic, Shared>;
-    destory(component: ComponentInstance<ComponentSchema, Data, Logic, Shared>): void;
-}

package/Components/ComponentPrototype.js

@@ -1,73 +0,0 @@
-import { Schema } from "@amodx/schemas";
-import { ComponentInstance } from "./ComponentInstance";
-import { ComponentInstanceMap } from "./ComponentInstanceMap";
-import { ItemPool } from "../Pools/ItemPool";
-export class ComponentPrototype {
-    data;
-    schemaController;
-    baseContextSchema;
-    pool = new ItemPool();
-    constructor(data) {
-        this.data = data;
-        this.schemaController =
-            Array.isArray(data.schema) && data.schema.length
-                ? Schema.Create(...data.schema)
-                : null;
-        this.baseContextSchema = (this.schemaController ? this.schemaController.createData() : {});
-        this.pool.maxSize = data.pool?.maxSize || 100;
-    }
-    getSchema(overrides) {
-        if (!this.schemaController)
-            return structuredClone(this.baseContextSchema);
-        return this.schemaController.instantiate(overrides);
-    }
-    getPooled() {
-        let comp = null;
-        if (this.data.pool?.maxSize) {
-            comp = this.pool.get();
-        }
-        return comp || new ComponentInstance();
-    }
-    return(component) {
-        if (this.data.pool?.maxSize) {
-            return this.pool.addItem(component);
-        }
-        return null;
-    }
-    create(node, data) {
-        const instance = this.getPooled();
-        instance.node = node;
-        instance.componentPrototype = this;
-        if (this.data.schema && !instance.schema) {
-            instance.schema = this.getSchema(data.schema);
-        }
-        if (this.data.schema && instance.schema?.getSchema) {
-            instance.schema.getSchema().loadIn(this.data.schema);
-        }
-        if (this.data.logic) {
-            instance.logic = this.data.logic
-                ? typeof this.data.logic == "function"
-                    ? this.data.logic(instance)
-                    : structuredClone(this.data.logic)
-                : {};
-        }
-        if (this.data.data) {
-            instance.data = this.data.data
-                ? typeof this.data.data == "function"
-                    ? this.data.data(instance)
-                    : structuredClone(this.data.data)
-                : {};
-        }
-        if (data.state) {
-            instance.state = structuredClone(data.state);
-        }
-        const map = ComponentInstanceMap.getMap(data.type);
-        map.addNode(node, instance);
-        return instance;
-    }
-    destory(component) {
-        const map = ComponentInstanceMap.getMap(component.type);
-        map.removeNode(component.node, component);
-        this.return(component);
-    }
-}