@axi-engine/fields 0.3.3 → 0.3.5

package/dist/field-definitions/core-numeric-field.js

@@ -0,0 +1,45 @@
+import { clampPolicy, clampMaxPolicy, clampMinPolicy, ClampPolicy, ClampMinPolicy, ClampMaxPolicy } from '../policies';
+import { CoreField } from './core-field';
+import { isNullOrUndefined } from '@axi-engine/utils';
+export class CoreNumericField extends CoreField {
+    static typeName = 'numeric';
+    typeName = CoreNumericField.typeName;
+    get min() {
+        const policy = this.policies.get(ClampPolicy.id) ??
+            this.policies.get(ClampMinPolicy.id);
+        return policy?.min;
+    }
+    get max() {
+        const policy = this.policies.get(ClampPolicy.id) ??
+            this.policies.get(ClampMaxPolicy.id);
+        return policy?.max;
+    }
+    constructor(name, initialVal, options) {
+        const policies = options?.policies ?? [];
+        if (!isNullOrUndefined(options?.min) && !isNullOrUndefined(options?.max)) {
+            policies.unshift(clampPolicy(options.min, options.max));
+        }
+        else if (!isNullOrUndefined(options?.min)) {
+            policies.unshift(clampMinPolicy(options.min));
+        }
+        else if (!isNullOrUndefined(options?.max)) {
+            policies.unshift(clampMaxPolicy(options.max));
+        }
+        super(name, initialVal, { policies });
+    }
+    isMin() {
+        const min = this.min;
+        return isNullOrUndefined(min) ? false : this.value <= min;
+    }
+    isMax() {
+        const max = this.max;
+        return isNullOrUndefined(max) ? false : this.value >= max;
+    }
+    inc(amount = 1) {
+        this.value = this.value + amount;
+    }
+    dec(amount = 1) {
+        this.value = this.value - amount;
+    }
+}
+//# sourceMappingURL=core-numeric-field.js.map

package/dist/field-definitions/core-numeric-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-numeric-field.js","sourceRoot":"","sources":["../../src/field-definitions/core-numeric-field.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AASpD,MAAM,OAAO,gBAAiB,SAAQ,SAAiB;IACrD,MAAM,CAAU,QAAQ,GAAW,SAAS,CAAC;IACpC,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAE9C,IAAI,GAAG;QACL,MAAM,MAAM,GACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAc,WAAW,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAiB,cAAc,CAAC,EAAE,CAAC,CAAC;QACvD,OAAO,MAAM,EAAE,GAAG,CAAC;IACrB,CAAC;IAED,IAAI,GAAG;QACL,MAAM,MAAM,GACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAc,WAAW,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAiB,cAAc,CAAC,EAAE,CAAC,CAAC;QACvD,OAAO,MAAM,EAAE,GAAG,CAAC;IACrB,CAAC;IAED,YAAY,IAAY,EAAE,UAAkB,EAAE,OAAiC;QAC7E,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;YACzE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,OAAQ,CAAC,GAAI,EAAE,OAAQ,CAAC,GAAI,CAAC,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;YAC5C,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,OAAQ,CAAC,GAAI,CAAC,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;YAC5C,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,OAAQ,CAAC,GAAI,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,EAAC,QAAQ,EAAC,CAAC,CAAC;IACtC,CAAC;IAED,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,GAAI,CAAC;IAC7D,CAAC;IAED,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,GAAI,CAAC;IAC7D,CAAC;IAED,GAAG,CAAC,MAAM,GAAG,CAAC;QACZ,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,MAAM,GAAG,CAAC;QACZ,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;IACnC,CAAC"}

package/dist/field-definitions/core-string-field.d.ts

@@ -0,0 +1,15 @@
+import { CoreField } from './core-field';
+import { FieldOptions, StringField } from '../field';
+export interface CoreStringFieldOptions extends FieldOptions<string> {
+}
+export declare class CoreStringField extends CoreField<string> implements StringField {
+    static readonly typeName: string;
+    readonly typeName: string;
+    constructor(name: string, initialVal: string, options?: CoreStringFieldOptions);
+    append(str: string | number): this;
+    prepend(str: string | number): this;
+    trim(): this;
+    isEmpty(): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=core-string-field.d.ts.map

package/dist/field-definitions/core-string-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-string-field.d.ts","sourceRoot":"","sources":["../../src/field-definitions/core-string-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,YAAY,EAAE,WAAW,EAAC,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,sBAAuB,SAAQ,YAAY,CAAC,MAAM,CAAC;CAAI;AAExE,qBAAa,eAAgB,SAAQ,SAAS,CAAC,MAAM,CAAE,YAAW,WAAW;IAC3E,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAY;IAC5C,QAAQ,CAAC,QAAQ,SAA4B;gBAEjC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAI9E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI5B,IAAI;IAIJ,OAAO;IAIP,KAAK;CAGN"}

package/dist/field-definitions/core-string-field.js

@@ -0,0 +1,27 @@
+import { CoreField } from './core-field';
+export class CoreStringField extends CoreField {
+    static typeName = 'string';
+    typeName = CoreStringField.typeName;
+    constructor(name, initialVal, options) {
+        super(name, initialVal, options);
+    }
+    append(str) {
+        this.value = this.value + str;
+        return this;
+    }
+    prepend(str) {
+        this.value = str + this.value;
+        return this;
+    }
+    trim() {
+        this.value = this.value.trim();
+        return this;
+    }
+    isEmpty() {
+        return this.value.length === 0;
+    }
+    clear() {
+        this.value = '';
+    }
+}
+//# sourceMappingURL=core-string-field.js.map

package/dist/field-definitions/core-string-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-string-field.js","sourceRoot":"","sources":["../../src/field-definitions/core-string-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAKvC,MAAM,OAAO,eAAgB,SAAQ,SAAiB;IACpD,MAAM,CAAU,QAAQ,GAAW,QAAQ,CAAC;IACnC,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;IAE7C,YAAY,IAAY,EAAE,UAAkB,EAAE,OAAgC;QAC5E,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,GAAoB;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,GAAoB;QAC1B,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC"}

package/dist/field-definitions/index.d.ts

@@ -0,0 +1,5 @@
+export * from './core-field';
+export * from './core-boolean-field';
+export * from './core-string-field';
+export * from './core-numeric-field';
+//# sourceMappingURL=index.d.ts.map

package/dist/field-definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/field-definitions/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/field-definitions/index.js

@@ -0,0 +1,5 @@
+export * from './core-field';
+export * from './core-boolean-field';
+export * from './core-string-field';
+export * from './core-numeric-field';
+//# sourceMappingURL=index.js.map

package/dist/field-definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/field-definitions/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/field-registry.d.ts

@@ -0,0 +1,5 @@
+import { ConstructorRegistry } from '@axi-engine/utils';
+import { Field } from './field';
+export declare class FieldRegistry extends ConstructorRegistry<Field<any>> {
+}
+//# sourceMappingURL=field-registry.d.ts.map

package/dist/field-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-registry.d.ts","sourceRoot":"","sources":["../src/field-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAC,KAAK,EAAC,MAAM,SAAS,CAAC;AAG9B,qBAAa,aAAc,SAAQ,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;CAAI"}

package/dist/field-registry.js

@@ -0,0 +1,4 @@
+import { ConstructorRegistry } from '@axi-engine/utils';
+export class FieldRegistry extends ConstructorRegistry {
+}
+//# sourceMappingURL=field-registry.js.map

package/dist/field-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-registry.js","sourceRoot":"","sources":["../src/field-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AAItD,MAAM,OAAO,aAAc,SAAQ,mBAA+B;CAAI"}

package/dist/field-tree-factory.d.ts

@@ -0,0 +1,12 @@
+import { Fields } from './fields';
+import { FieldTree } from './field-tree';
+import { FieldsFactory } from './fields-factory';
+/**
+ * Defines the contract for a factory that creates nodes for a FieldTree.
+ * This allows for custom implementations of Fields and FieldTree to be used.
+ */
+export interface FieldTreeFactory<TFields extends Fields> extends FieldsFactory<TFields> {
+    fields(): TFields;
+    tree(): FieldTree<TFields>;
+}
+//# sourceMappingURL=field-tree-factory.d.ts.map

package/dist/field-tree-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-tree-factory.d.ts","sourceRoot":"","sources":["../src/field-tree-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAChC,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAG/C;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,MAAM,CAAE,SAAQ,aAAa,CAAC,OAAO,CAAC;IACtF,MAAM,IAAI,OAAO,CAAC;IAClB,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,CAAA;CAC3B"}

package/dist/field-tree-factory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=field-tree-factory.js.map

package/dist/field-tree-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-tree-factory.js","sourceRoot":"","sources":["../src/field-tree-factory.ts"],"names":[],"mappings":""}

package/dist/field-tree.d.ts

@@ -0,0 +1,171 @@
+import { Emitter, PathType } from '@axi-engine/utils';
+import { Fields } from './fields';
+import { FieldTreeFactory } from './field-tree-factory';
+/** A type alias for any container that can be a child node in a FieldTree */
+export type TreeNode<F extends Fields> = FieldTree<F> | F;
+/**
+ * Represents a hierarchical data structure for managing the global state of the system.
+ *
+ * This class acts as the single source of truth for long-term data that exists
+ * across different scenes and scripts, such as player stats, inventory,
+ * and overall game progress. It uses a path-based system for accessing and
+ * manipulating nested data, similar to a file system.
+ *
+ */
+export declare class FieldTree<TFields extends Fields> {
+    static readonly typeName = "fieldTree";
+    readonly typeName = "fieldTree";
+    /** @private The internal map storing child nodes (branches or leaves). */
+    private readonly _nodes;
+    /** @private The factory used to create new child nodes. */
+    private readonly _factory;
+    /**
+     * An event emitter that fires immediately after a new node is added to this tree branch.
+     * @event
+     * @param {object} event - The event payload.
+     * @param {string} event.name - The name (key) of the added node.
+     * @param event.node - The node instance that was added.
+     * @example
+     * myTree.onAdd.subscribe(({ name, node }) => {
+     *   console.log(`Node '${name}' was added.`, node);
+     * });
+     */
+    onAdd: Emitter<[event: {
+        name: string;
+        node: TreeNode<TFields>;
+    }]>;
+    /**
+     * An event emitter that fires once after one or more nodes have been successfully removed.
+     * @event
+     * @param {object} event - The event payload.
+     * @param {string[]} event.names - An array of names of the nodes that were removed.
+     * @example
+     * myTree.onRemove.subscribe(({ names }) => {
+     *   console.log(`Nodes removed: ${names.join(', ')}`);
+     * });
+     */
+    onRemove: Emitter<[event: {
+        names: string[];
+    }]>;
+    /**
+     * Gets the collection of direct child nodes of this tree branch.
+     */
+    get nodes(): Map<string, TreeNode<TFields>>;
+    /**
+     * Creates an instance of FieldTree.
+     * @param {FieldTreeFactory} factory - A factory responsible for creating new nodes within the tree.
+     */
+    constructor(factory: FieldTreeFactory<TFields>);
+    /**
+     * Checks if a direct child node with the given name exists.
+     * @param {string} name - The name of the direct child node.
+     * @returns {boolean} `true` if the node exists, otherwise `false`.
+     */
+    has(name: string): boolean;
+    /**
+     * Checks if a node exists at a given path, traversing the tree.
+     * @param {PathType} path - The path to check (e.g., 'player/stats' or ['player', 'stats']).
+     * @returns {boolean} `true` if the entire path resolves to a node, otherwise `false`.
+     */
+    hasPath(path: PathType): boolean;
+    /**
+     * Adds a pre-existing node as a direct child of this tree branch.
+     * @param {string} name - The name to assign to the new child node.
+     * @param {TreeNode} node - The node instance to add.
+     * @returns {TreeNode} The added node.
+     * @throws If a node with the same name already exists.
+     */
+    addNode(name: string, node: TreeNode<TFields>): TreeNode<TFields>;
+    /**
+     * Retrieves a direct child node by its name.
+     * @param {string} name - The name of the child node.
+     * @returns {TreeNode} The retrieved node.
+     * @throws If a node with the given name cannot be found.
+     */
+    getNode(name: string): TreeNode<TFields>;
+    /**
+     * Removes one or more nodes from this tree branch.
+     *
+     * This method first validates that all specified nodes exist. If validation passes,
+     * it recursively calls `destroy()` on each node to ensure proper cleanup of the entire subtree.
+     * Finally, it emits a single `onRemove` event with the names of all successfully removed nodes.
+     *
+     * @param {string | string[]} names - A single name or an array of names of the nodes to remove.
+     * @throws If any of the specified names do not correspond to an existing node.
+     */
+    removeNode(names: string | string[]): void;
+    /**
+     * Creates a new `FieldTree` (branch) node at the specified path.
+     * @param {PathType} path - The path where the new `FieldTree` should be created.
+     * @param {boolean} [createPath=false] - If `true`, any missing parent branches in the path will be created automatically.
+     * @returns {FieldTree} The newly created `FieldTree` instance.
+     * @throws If the path is invalid or a node already exists at the target location.
+     */
+    createFieldTree<T extends FieldTree<TFields>>(path: PathType, createPath?: boolean): T;
+    /**
+     * Creates a new `Fields` (leaf) container at the specified path.
+     * @param {PathType} path - The path where the new `Fields` container should be created.
+     * @param {boolean} [createPath=false] - If `true`, any missing parent branches in the path will be created automatically.
+     * @returns {Fields} The newly created `Fields` instance.
+     * @throws If the path is invalid or a node already exists at the target location.
+     */
+    createFields(path: PathType, createPath?: boolean): TFields;
+    /**
+     * Retrieves a `FieldTree` (branch) node from a specified path.
+     * @param {PathType} path - The path to the `FieldTree` node.
+     * @returns {FieldTree} The `FieldTree` instance at the specified path.
+     * @throws If the path is invalid or the node at the path is not a `FieldTree`.
+     */
+    getFieldTree(path: PathType): FieldTree<TFields>;
+    /**
+     * Retrieves a `Fields` (leaf) container from a specified path.
+     * @param {PathType} path - The path to the `Fields` container.
+     * @returns {Fields} The `Fields` instance at the specified path.
+     * @throws If the path is invalid or the node at the path is not a `Fields` container.
+     */
+    getFields(path: PathType): TFields;
+    /**
+     * Retrieves a `FieldTree` at the specified path. If it or any part of the path doesn't exist, it will be created.
+     * @param {PathType} path - The path to the `FieldTree` node.
+     * @returns {FieldTree} The existing or newly created `FieldTree` instance.
+     */
+    getOrCreateFieldTree(path: PathType): FieldTree<TFields>;
+    /**
+     * Retrieves a `Fields` container at the specified path. If it or any part of the path doesn't exist, it will be created.
+     * @param {PathType} path - The path to the `Fields` container.
+     * @returns {Fields} The existing or newly created `Fields` instance.
+     */
+    getOrCreateFields(path: PathType): TFields;
+    /**
+     * Finds the parent node for a given path.
+     * @param path The path to the target node.
+     * @returns The parent node (either a FieldTree or Fields).
+     * @throws An error if the path is invalid or any intermediate node is not a FieldTree.
+     */
+    findParentNode(path: PathType): FieldTree<TFields> | TFields;
+    /**
+     * Removes all child nodes from this tree branch.
+     * This method ensures that `destroy()` is called on each child node, allowing for
+     * a full, recursive cleanup of the entire subtree.
+     */
+    clear(): void;
+    /**
+     * Performs a complete cleanup of this node and its entire subtree.
+     *
+     * It recursively destroys all child nodes by calling `clear()` and then
+     * unsubscribes all listeners from its own event emitters.
+     * This method should be called when a node is no longer needed.
+     */
+    destroy(): void;
+    /**
+     * @private
+     * Navigates the tree to the parent of a target node.
+     * This is the core traversal logic for all path-based operations.
+     * @param {PathType} path - The full path to the target node.
+     * @param {boolean} [createPath=false] - If `true`, creates missing `FieldTree` branches along the path.
+     * @returns {{branch: FieldTree, leafName: string}} An object containing the final branch (parent node) and the name of the leaf (target node).
+     * @throws If the path is empty, invalid, or contains a `Fields` container as an intermediate segment.
+     */
+    private traversePath;
+}
+//# sourceMappingURL=field-tree.d.ts.map

package/dist/field-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-tree.d.ts","sourceRoot":"","sources":["../src/field-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAqC,QAAQ,EAAwB,MAAM,mBAAmB,CAAC;AAC9G,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAChC,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAEtD,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE1D;;;;;;;;GAQG;AACH,qBAAa,SAAS,CAAC,OAAO,SAAS,MAAM;IAC3C,MAAM,CAAC,QAAQ,CAAC,QAAQ,eAAe;IACvC,QAAQ,CAAC,QAAQ,eAAsB;IAEvC,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAEpE,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAErD;;;;;;;;;;OAUG;IACH,KAAK;cACG,MAAM;cACN,QAAQ,CAAC,OAAO,CAAC;QACnB;IAEN;;;;;;;;;OASG;IACH,QAAQ;eACC,MAAM,EAAE;QACX;IAEN;;OAEG;IACH,IAAI,KAAK,mCAER;IAED;;;OAGG;gBACS,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;IAI9C;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAKhC;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;IAOjE;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC;IAMxC;;;;;;;;;OASG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAcnC;;;;;;OAMG;IACH,eAAe,CAAC,CAAC,SAAS,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,CAAC;IAKtF;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO;IAK3D;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC;IAUhD;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAUlC;;;;OAIG;IACH,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC;IAOxD;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAO1C;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO;IAK5D;;;;OAIG;IACH,KAAK;IAIL;;;;;;OAMG;IACH,OAAO;IAMP;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;CAyBrB"}

package/dist/field-tree.js

@@ -0,0 +1,248 @@
+import { Emitter, ensurePathArray, ensurePathString, throwIf, throwIfEmpty } from '@axi-engine/utils';
+import { Fields } from './fields';
+/**
+ * Represents a hierarchical data structure for managing the global state of the system.
+ *
+ * This class acts as the single source of truth for long-term data that exists
+ * across different scenes and scripts, such as player stats, inventory,
+ * and overall game progress. It uses a path-based system for accessing and
+ * manipulating nested data, similar to a file system.
+ *
+ */
+export class FieldTree {
+    static typeName = 'fieldTree';
+    typeName = FieldTree.typeName;
+    /** @private The internal map storing child nodes (branches or leaves). */
+    _nodes = new Map();
+    /** @private The factory used to create new child nodes. */
+    _factory;
+    /**
+     * An event emitter that fires immediately after a new node is added to this tree branch.
+     * @event
+     * @param {object} event - The event payload.
+     * @param {string} event.name - The name (key) of the added node.
+     * @param event.node - The node instance that was added.
+     * @example
+     * myTree.onAdd.subscribe(({ name, node }) => {
+     *   console.log(`Node '${name}' was added.`, node);
+     * });
+     */
+    onAdd = new Emitter();
+    /**
+     * An event emitter that fires once after one or more nodes have been successfully removed.
+     * @event
+     * @param {object} event - The event payload.
+     * @param {string[]} event.names - An array of names of the nodes that were removed.
+     * @example
+     * myTree.onRemove.subscribe(({ names }) => {
+     *   console.log(`Nodes removed: ${names.join(', ')}`);
+     * });
+     */
+    onRemove = new Emitter();
+    /**
+     * Gets the collection of direct child nodes of this tree branch.
+     */
+    get nodes() {
+        return this._nodes;
+    }
+    /**
+     * Creates an instance of FieldTree.
+     * @param {FieldTreeFactory} factory - A factory responsible for creating new nodes within the tree.
+     */
+    constructor(factory) {
+        this._factory = factory;
+    }
+    /**
+     * Checks if a direct child node with the given name exists.
+     * @param {string} name - The name of the direct child node.
+     * @returns {boolean} `true` if the node exists, otherwise `false`.
+     */
+    has(name) {
+        return this._nodes.has(name);
+    }
+    /**
+     * Checks if a node exists at a given path, traversing the tree.
+     * @param {PathType} path - The path to check (e.g., 'player/stats' or ['player', 'stats']).
+     * @returns {boolean} `true` if the entire path resolves to a node, otherwise `false`.
+     */
+    hasPath(path) {
+        const traversedPath = this.traversePath(path);
+        return traversedPath.branch.has(traversedPath.leafName);
+    }
+    /**
+     * Adds a pre-existing node as a direct child of this tree branch.
+     * @param {string} name - The name to assign to the new child node.
+     * @param {TreeNode} node - The node instance to add.
+     * @returns {TreeNode} The added node.
+     * @throws If a node with the same name already exists.
+     */
+    addNode(name, node) {
+        throwIf(this.has(name), `Can't add node with name: '${name}', node already exists`);
+        this._nodes.set(name, node);
+        this.onAdd.emit({ name, node });
+        return node;
+    }
+    /**
+     * Retrieves a direct child node by its name.
+     * @param {string} name - The name of the child node.
+     * @returns {TreeNode} The retrieved node.
+     * @throws If a node with the given name cannot be found.
+     */
+    getNode(name) {
+        const node = this._nodes.get(name);
+        throwIfEmpty(node, `Can't find node with name '${name}'`);
+        return node;
+    }
+    /**
+     * Removes one or more nodes from this tree branch.
+     *
+     * This method first validates that all specified nodes exist. If validation passes,
+     * it recursively calls `destroy()` on each node to ensure proper cleanup of the entire subtree.
+     * Finally, it emits a single `onRemove` event with the names of all successfully removed nodes.
+     *
+     * @param {string | string[]} names - A single name or an array of names of the nodes to remove.
+     * @throws If any of the specified names do not correspond to an existing node.
+     */
+    removeNode(names) {
+        const toRemoveNames = Array.isArray(names) ? names : [names];
+        toRemoveNames.forEach(name => {
+            throwIf(!this.has(name), `Can't remove node with name: '${name}', node doesn't exists`);
+        });
+        toRemoveNames.forEach(name => {
+            this._nodes.get(name).destroy();
+            this._nodes.delete(name);
+        });
+        if (toRemoveNames.length) {
+            this.onRemove.emit({ names: toRemoveNames });
+        }
+    }
+    /**
+     * Creates a new `FieldTree` (branch) node at the specified path.
+     * @param {PathType} path - The path where the new `FieldTree` should be created.
+     * @param {boolean} [createPath=false] - If `true`, any missing parent branches in the path will be created automatically.
+     * @returns {FieldTree} The newly created `FieldTree` instance.
+     * @throws If the path is invalid or a node already exists at the target location.
+     */
+    createFieldTree(path, createPath) {
+        const traversedPath = this.traversePath(path, createPath);
+        return traversedPath.branch.addNode(traversedPath.leafName, this._factory.tree());
+    }
+    /**
+     * Creates a new `Fields` (leaf) container at the specified path.
+     * @param {PathType} path - The path where the new `Fields` container should be created.
+     * @param {boolean} [createPath=false] - If `true`, any missing parent branches in the path will be created automatically.
+     * @returns {Fields} The newly created `Fields` instance.
+     * @throws If the path is invalid or a node already exists at the target location.
+     */
+    createFields(path, createPath) {
+        const traversedPath = this.traversePath(path, createPath);
+        return traversedPath.branch.addNode(traversedPath.leafName, this._factory.fields());
+    }
+    /**
+     * Retrieves a `FieldTree` (branch) node from a specified path.
+     * @param {PathType} path - The path to the `FieldTree` node.
+     * @returns {FieldTree} The `FieldTree` instance at the specified path.
+     * @throws If the path is invalid or the node at the path is not a `FieldTree`.
+     */
+    getFieldTree(path) {
+        const traversedPath = this.traversePath(path);
+        const node = traversedPath.branch.getNode(traversedPath.leafName);
+        throwIf(!(node instanceof FieldTree), `Node with name: ${traversedPath.leafName} by path: '${ensurePathString(path)}' should be instance of FieldTree`);
+        return node;
+    }
+    /**
+     * Retrieves a `Fields` (leaf) container from a specified path.
+     * @param {PathType} path - The path to the `Fields` container.
+     * @returns {Fields} The `Fields` instance at the specified path.
+     * @throws If the path is invalid or the node at the path is not a `Fields` container.
+     */
+    getFields(path) {
+        const traversedPath = this.traversePath(path);
+        const node = traversedPath.branch.getNode(traversedPath.leafName);
+        throwIf(!(node instanceof Fields), `Node with name: ${traversedPath.leafName} by path: '${ensurePathString(path)}' should be instance of Fields`);
+        return node;
+    }
+    /**
+     * Retrieves a `FieldTree` at the specified path. If it or any part of the path doesn't exist, it will be created.
+     * @param {PathType} path - The path to the `FieldTree` node.
+     * @returns {FieldTree} The existing or newly created `FieldTree` instance.
+     */
+    getOrCreateFieldTree(path) {
+        const traversedPath = this.traversePath(path, true);
+        return traversedPath.branch.has(traversedPath.leafName) ?
+            traversedPath.branch.getFieldTree(traversedPath.leafName) :
+            traversedPath.branch.createFieldTree(traversedPath.leafName);
+    }
+    /**
+     * Retrieves a `Fields` container at the specified path. If it or any part of the path doesn't exist, it will be created.
+     * @param {PathType} path - The path to the `Fields` container.
+     * @returns {Fields} The existing or newly created `Fields` instance.
+     */
+    getOrCreateFields(path) {
+        const traversedPath = this.traversePath(path, true);
+        return traversedPath.branch.has(traversedPath.leafName) ?
+            traversedPath.branch.getFields(traversedPath.leafName) :
+            traversedPath.branch.createFields(traversedPath.leafName);
+    }
+    /**
+     * Finds the parent node for a given path.
+     * @param path The path to the target node.
+     * @returns The parent node (either a FieldTree or Fields).
+     * @throws An error if the path is invalid or any intermediate node is not a FieldTree.
+     */
+    findParentNode(path) {
+        const info = this.traversePath(path);
+        return info.branch;
+    }
+    /**
+     * Removes all child nodes from this tree branch.
+     * This method ensures that `destroy()` is called on each child node, allowing for
+     * a full, recursive cleanup of the entire subtree.
+     */
+    clear() {
+        this.removeNode(Array.from(this._nodes.keys()));
+    }
+    /**
+     * Performs a complete cleanup of this node and its entire subtree.
+     *
+     * It recursively destroys all child nodes by calling `clear()` and then
+     * unsubscribes all listeners from its own event emitters.
+     * This method should be called when a node is no longer needed.
+     */
+    destroy() {
+        this.clear();
+        this.onAdd.clear();
+        this.onRemove.clear();
+    }
+    /**
+     * @private
+     * Navigates the tree to the parent of a target node.
+     * This is the core traversal logic for all path-based operations.
+     * @param {PathType} path - The full path to the target node.
+     * @param {boolean} [createPath=false] - If `true`, creates missing `FieldTree` branches along the path.
+     * @returns {{branch: FieldTree, leafName: string}} An object containing the final branch (parent node) and the name of the leaf (target node).
+     * @throws If the path is empty, invalid, or contains a `Fields` container as an intermediate segment.
+     */
+    traversePath(path, createPath) {
+        const pathArr = ensurePathArray(path);
+        throwIfEmpty(pathArr, 'The path is empty');
+        const leafName = pathArr.pop();
+        let currentNode = this;
+        for (const pathPart of pathArr) {
+            let node;
+            if (currentNode.has(pathPart)) {
+                node = currentNode.getNode(pathPart);
+            }
+            else {
+                if (createPath) {
+                    node = currentNode.createFieldTree(pathPart);
+                }
+            }
+            throwIfEmpty(node, `Can't find node with name ${pathPart} by path parsing: ${ensurePathString(path)}`);
+            throwIf(node instanceof Fields, `Node with name ${pathPart} should be instance of FieldTree`);
+            currentNode = node;
+        }
+        return { branch: currentNode, leafName: leafName };
+    }
+}
+//# sourceMappingURL=field-tree.js.map

package/dist/field-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-tree.js","sourceRoot":"","sources":["../src/field-tree.ts"],"names":[],"mappings":"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"}

package/dist/field.d.ts

@@ -0,0 +1,34 @@
+import { Subscribable } from '@axi-engine/utils';
+import { Policies, Policy } from './policies';
+export interface FieldOptions<T> {
+    policies?: Policy<T>[];
+}
+export interface Field<T> {
+    readonly typeName: string;
+    readonly name: string;
+    value: T;
+    policies: Policies<T>;
+    setValueSilently(val: T): void;
+    batchUpdate(updateFn: (currentValue: T) => T): void;
+    onChange: Subscribable<[newValue: T, oldValue: T]>;
+    destroy(): void;
+}
+export interface NumericField extends Field<number> {
+    readonly min: number | undefined;
+    readonly max: number | undefined;
+    isMin(): boolean;
+    isMax(): boolean;
+    inc(val: number): void;
+    dec(val: number): void;
+}
+export interface BooleanField extends Field<boolean> {
+    toggle(): boolean;
+}
+export interface StringField extends Field<string> {
+    append(str: string | number): this;
+    prepend(str: string | number): this;
+    trim(): this;
+    isEmpty(): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=field.d.ts.map

package/dist/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../src/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,QAAQ,EAAE,MAAM,EAAC,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtB,gBAAgB,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;IAE/B,WAAW,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAEpD,QAAQ,EAAE,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,MAAM,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC,KAAK,IAAI,OAAO,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC;IAEjB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,YAAa,SAAQ,KAAK,CAAC,OAAO,CAAC;IAClD,MAAM,IAAI,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAY,SAAQ,KAAK,CAAC,MAAM,CAAC;IAChD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,OAAO,CAAA;IAClB,KAAK,IAAI,IAAI,CAAA;CACd"}

package/dist/field.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=field.js.map