@axi-engine/fields 0.3.2 → 0.3.4

package/README.md

@@ -1,6 +1,6 @@
 # @axi-engine/fields
 
-[![NPM version](https://img.shields.io/npm/v/@axi-engine/utils.svg)](https://www.npmjs.com/package/@axi-engine/fields)
+[![NPM version](https://img.shields.io/npm/v/@axi-engine/fields.svg)](https://www.npmjs.com/package/@axi-engine/fields)
 
 
 ## Description
@@ -27,4 +27,8 @@ npm install @axi-engine/fields
 
 ## API Reference
 
-Will be available when code and repository will be fully published 
+[**Browse the API Documentation here**](https://github.com/axijs/engine/tree/main/packages/fields/docs/api) 
+
+## License
+
+MIT

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

@@ -0,0 +1,13 @@
+import { CoreFieldsFactory } from './core-fields-factory';
+import { FieldTreeFactory } from './field-tree-factory';
+import { CoreFields } from './core-fields';
+import { FieldRegistry } from './field-registry';
+import { CoreFieldTree } from './core-field-tree';
+/**
+ * The default factory implementation that creates standard DefaultFields and FieldTree instances.
+ */
+export declare class CoreTreeNodeFactory extends CoreFieldsFactory implements FieldTreeFactory<CoreFields> {
+    constructor(fieldRegistry: FieldRegistry);
+    tree(): CoreFieldTree;
+}
+//# sourceMappingURL=core-field-tree-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-field-tree-factory.d.ts","sourceRoot":"","sources":["../src/core-field-tree-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AACzC,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,iBAAkB,YAAW,gBAAgB,CAAC,UAAU,CAAC;gBACpF,aAAa,EAAE,aAAa;IAIxC,IAAI;CAGL"}

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

@@ -0,0 +1,14 @@
+import { CoreFieldsFactory } from './core-fields-factory';
+import { CoreFieldTree } from './core-field-tree';
+/**
+ * The default factory implementation that creates standard DefaultFields and FieldTree instances.
+ */
+export class CoreTreeNodeFactory extends CoreFieldsFactory {
+    constructor(fieldRegistry) {
+        super(fieldRegistry);
+    }
+    tree() {
+        return new CoreFieldTree(this);
+    }
+}
+//# sourceMappingURL=core-field-tree-factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-field-tree-factory.js","sourceRoot":"","sources":["../src/core-field-tree-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,uBAAuB,CAAC;AAIxD,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,aAA4B;QACtC,KAAK,CAAC,aAAa,CAAC,CAAC;IACvB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF"}

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

@@ -0,0 +1,5 @@
+import { FieldTree } from './field-tree';
+import { CoreFields } from './core-fields';
+export declare class CoreFieldTree extends FieldTree<CoreFields> {
+}
+//# sourceMappingURL=core-field-tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-field-tree.d.ts","sourceRoot":"","sources":["../src/core-field-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAEzC,qBAAa,aAAc,SAAQ,SAAS,CAAC,UAAU,CAAC;CAAG"}

package/dist/core-field-tree.js

@@ -0,0 +1,4 @@
+import { FieldTree } from './field-tree';
+export class CoreFieldTree extends FieldTree {
+}
+//# sourceMappingURL=core-field-tree.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-field-tree.js","sourceRoot":"","sources":["../src/core-field-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAGvC,MAAM,OAAO,aAAc,SAAQ,SAAqB;CAAG"}

package/dist/core-fields-factory.d.ts

@@ -0,0 +1,10 @@
+import { CoreFields } from './core-fields';
+import { FieldRegistry } from './field-registry';
+import { FieldsFactory } from './fields-factory';
+export declare class CoreFieldsFactory implements FieldsFactory<CoreFields> {
+    protected readonly _fieldRegistry: FieldRegistry;
+    get fieldRegistry(): FieldRegistry;
+    constructor(fieldRegistry: FieldRegistry);
+    fields(): CoreFields;
+}
+//# sourceMappingURL=core-fields-factory.d.ts.map

package/dist/core-fields-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-fields-factory.d.ts","sourceRoot":"","sources":["../src/core-fields-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AACzC,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAG/C,qBAAa,iBAAkB,YAAW,aAAa,CAAC,UAAU,CAAC;IACjE,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC;IAEjD,IAAI,aAAa,kBAEhB;gBAEW,aAAa,EAAE,aAAa;IAIxC,MAAM;CAGP"}

package/dist/core-fields-factory.js

@@ -0,0 +1,14 @@
+import { CoreFields } from './core-fields';
+export class CoreFieldsFactory {
+    _fieldRegistry;
+    get fieldRegistry() {
+        return this._fieldRegistry;
+    }
+    constructor(fieldRegistry) {
+        this._fieldRegistry = fieldRegistry;
+    }
+    fields() {
+        return new CoreFields(this._fieldRegistry);
+    }
+}
+//# sourceMappingURL=core-fields-factory.js.map

package/dist/core-fields-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-fields-factory.js","sourceRoot":"","sources":["../src/core-fields-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAKzC,MAAM,OAAO,iBAAiB;IACT,cAAc,CAAgB;IAEjD,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,YAAY,aAA4B;QACtC,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;IACtC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC5C,CAAC;CACF"}

package/dist/core-fields.d.ts

@@ -0,0 +1,47 @@
+import { Fields } from './fields';
+declare const CoreFields_base: import("@axi-engine/utils").Constructor<{
+    createGeneric<T>(name: string, initialValue: T, options?: import("./field").FieldOptions<T> | undefined): import("./field-definitions").CoreField<T>;
+    upsetGeneric<T>(name: string, value: T, options?: import("./field").FieldOptions<T> | undefined): import("./field-definitions").CoreField<T>;
+    getGeneric<T>(name: string): import("./field-definitions").CoreField<T>;
+    readonly typeName: "fields";
+    readonly _fields: Map<string, import("./field").Field<any>>;
+    readonly _fieldRegistry: import("./field-registry").FieldRegistry;
+    onAdd: import("@axi-engine/utils").Emitter<[event: {
+        name: string;
+        field: import("./field").Field<any>;
+    }]>;
+    onRemove: import("@axi-engine/utils").Emitter<[event: {
+        names: string[];
+    }]>;
+    get fields(): Map<string, import("./field").Field<any>>;
+    has(name: string): boolean;
+    add<T extends import("./field").Field<any>>(field: import("./field").Field<any>): T;
+    create<T extends import("./field").Field<any>>(typeName: string, name: string, initialValue: any, options?: any): T;
+    upset<T extends import("./field").Field<any>>(typeName: string, name: string, value: any, options?: any): T;
+    get<TField extends import("./field").Field<any>>(name: string): TField;
+    remove(names: string | string[]): void;
+    clear(): void;
+    destroy(): void;
+} & Fields & {
+    createNumeric: (name: string, initialValue: number, options?: import("./field-definitions").CoreNumericFieldOptions | undefined) => import("./field-definitions").CoreNumericField;
+} & {
+    upsetNumeric: (name: string, value: number, options?: import("./field-definitions").CoreNumericFieldOptions | undefined) => import("./field-definitions").CoreNumericField;
+} & {
+    getNumeric: (name: string) => import("./field-definitions").CoreNumericField;
+} & {
+    createString: (name: string, initialValue: string, options?: import("./field-definitions").CoreStringFieldOptions | undefined) => import("./field-definitions").CoreStringField;
+} & {
+    upsetString: (name: string, value: string, options?: import("./field-definitions").CoreStringFieldOptions | undefined) => import("./field-definitions").CoreStringField;
+} & {
+    getString: (name: string) => import("./field-definitions").CoreStringField;
+} & {
+    createBoolean: (name: string, initialValue: boolean, options?: import("./field-definitions").CoreBooleanFieldOptions | undefined) => import("./field-definitions").CoreBooleanField;
+} & {
+    upsetBoolean: (name: string, value: boolean, options?: import("./field-definitions").CoreBooleanFieldOptions | undefined) => import("./field-definitions").CoreBooleanField;
+} & {
+    getBoolean: (name: string) => import("./field-definitions").CoreBooleanField;
+}>;
+export declare class CoreFields extends CoreFields_base {
+}
+export {};
+//# sourceMappingURL=core-fields.d.ts.map

package/dist/core-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-fields.d.ts","sourceRoot":"","sources":["../src/core-fields.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEhC,qBAAa,UAAW,SAAQ,eAAwF;CAAG"}

package/dist/core-fields.js

@@ -0,0 +1,8 @@
+import { WithBooleanFields } from './mixins/with-boolean-fields.mixin';
+import { WithStringFields } from './mixins/with-string-fields.mixin';
+import { WithNumericFields } from './mixins/with-numeric-fields.mixin';
+import { WithDefaultGenericFields } from './mixins/with-default-generic-fields.mixin';
+import { Fields } from './fields';
+export class CoreFields extends WithBooleanFields(WithStringFields(WithNumericFields(WithDefaultGenericFields(Fields)))) {
+}
+//# sourceMappingURL=core-fields.js.map

package/dist/core-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-fields.js","sourceRoot":"","sources":["../src/core-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAC,gBAAgB,EAAC,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAC,iBAAiB,EAAC,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAC,wBAAwB,EAAC,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAEhC,MAAM,OAAO,UAAW,SAAQ,iBAAiB,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAAG"}

package/dist/data-store-field-resolver.d.ts

@@ -0,0 +1,26 @@
+export interface DataStoreFieldResolver {
+    /**
+     * The typeName this resolver corresponds to in the FieldRegistry.
+     * e.g., 'numeric', 'boolean', 'vector'
+     */
+    typeName: string;
+    /**
+     * Checks if this resolver can handle the given value.
+     * @param value The value to check.
+     * @returns {boolean} True if the value is supported, otherwise false.
+     */
+    supports(value: unknown): boolean;
+}
+export declare class NumericFieldResolver implements DataStoreFieldResolver {
+    readonly typeName: string;
+    supports(value: unknown): boolean;
+}
+export declare class BooleanFieldResolver implements DataStoreFieldResolver {
+    readonly typeName: string;
+    supports(value: unknown): boolean;
+}
+export declare class StringFieldResolver implements DataStoreFieldResolver {
+    readonly typeName: string;
+    supports(value: unknown): boolean;
+}
+//# sourceMappingURL=data-store-field-resolver.d.ts.map

package/dist/data-store-field-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-store-field-resolver.d.ts","sourceRoot":"","sources":["../src/data-store-field-resolver.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;CAClC;AAED,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE,QAAQ,CAAC,QAAQ,SAA6B;IAC9C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAGlC;AAED,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE,QAAQ,CAAC,QAAQ,SAA6B;IAC9C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAGlC;AACD,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE,QAAQ,CAAC,QAAQ,SAA4B;IAC7C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAGlC"}

package/dist/data-store-field-resolver.js

@@ -0,0 +1,21 @@
+import { CoreBooleanField, CoreNumericField, CoreStringField } from './field-definitions';
+import { isBoolean, isNumber, isString } from '@axi-engine/utils';
+export class NumericFieldResolver {
+    typeName = CoreNumericField.typeName;
+    supports(value) {
+        return isNumber(value);
+    }
+}
+export class BooleanFieldResolver {
+    typeName = CoreBooleanField.typeName;
+    supports(value) {
+        return isBoolean(value);
+    }
+}
+export class StringFieldResolver {
+    typeName = CoreStringField.typeName;
+    supports(value) {
+        return isString(value);
+    }
+}
+//# sourceMappingURL=data-store-field-resolver.js.map

package/dist/data-store-field-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-store-field-resolver.js","sourceRoot":"","sources":["../src/data-store-field-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAC,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,mBAAmB,CAAC;AAiBhE,MAAM,OAAO,oBAAoB;IACtB,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAC9C,QAAQ,CAAC,KAAc;QACrB,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,oBAAoB;IACtB,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAC9C,QAAQ,CAAC,KAAc;QACrB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;CACF;AACD,MAAM,OAAO,mBAAmB;IACrB,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;IAC7C,QAAQ,CAAC,KAAc;QACrB,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/data-store.d.ts

@@ -0,0 +1,38 @@
+import { Store, StoreCreateFieldOptions } from './store';
+import { DataStoreFieldResolver } from './data-store-field-resolver';
+import { PathType } from '@axi-engine/utils';
+import { Field, FieldOptions } from './field';
+import { CoreFieldTree } from './core-field-tree';
+import { CoreBooleanField, CoreBooleanFieldOptions, CoreField, CoreNumericField, CoreNumericFieldOptions, CoreStringField, CoreStringFieldOptions } from './field-definitions';
+import { CoreFields } from './core-fields';
+export declare class DataStore implements Store {
+    private readonly tree;
+    private readonly resolvers;
+    private readonly rootFieldsName;
+    private _rootFields;
+    private get rootFields();
+    constructor(tree: CoreFieldTree);
+    registerResolver(resolver: DataStoreFieldResolver): void;
+    clearResolvers(): void;
+    getValue<T>(path: PathType): T;
+    setValue<T>(path: PathType, val: T): T;
+    createValue<T>(path: PathType, val: T, options?: FieldOptions<T> & StoreCreateFieldOptions): T;
+    upsetValue<T>(path: PathType, val: T, options?: FieldOptions<T> & StoreCreateFieldOptions): T;
+    createBoolean(path: PathType, initialValue: boolean, options?: CoreBooleanFieldOptions): CoreBooleanField;
+    createNumeric(path: PathType, initialValue: number, options?: CoreNumericFieldOptions): CoreNumericField;
+    createString(path: PathType, initialValue: string, options?: CoreStringFieldOptions): CoreStringField;
+    createGeneric<T>(path: PathType, initialValue: T, options?: FieldOptions<T>): CoreField<T>;
+    getBoolean(path: PathType): CoreBooleanField;
+    getNumeric(path: PathType): CoreNumericField;
+    getString(path: PathType): CoreStringField;
+    getGeneric<T>(path: PathType): CoreField<T>;
+    getField<TField extends Field<any>>(path: PathType): TField;
+    createFields(path: PathType): CoreFields;
+    createTree(path: PathType): CoreFieldTree;
+    getFields(path: PathType): CoreFields;
+    getTree(path: PathType): CoreFieldTree;
+    remove(path: PathType): void;
+    private isPathToRootFields;
+    private getDestinationFields;
+}
+//# sourceMappingURL=data-store.d.ts.map

package/dist/data-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-store.d.ts","sourceRoot":"","sources":["../src/data-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,uBAAuB,EAAC,MAAM,SAAS,CAAC;AACvD,OAAO,EAEL,sBAAsB,EAGvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAoC,QAAQ,EAAe,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAC,KAAK,EAAE,YAAY,EAAC,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EAAE,SAAS,EAClC,gBAAgB,EAChB,uBAAuB,EAAE,eAAe,EAAE,sBAAsB,EACjE,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAGzC,qBAAa,SAAU,YAAW,KAAK;IAYzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmB;IAClD,OAAO,CAAC,WAAW,CAAyB;IAE5C,OAAO,KAAK,UAAU,GAKrB;gBAE4B,IAAI,EAAE,aAAa;IAMhD,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB;IAIjD,cAAc;IAKd,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,CAAC;IAI9B,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IAOtC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,uBAAuB,GAAG,CAAC;IAa9F,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,uBAAuB,GAAG,CAAC;IAa7F,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,gBAAgB;IAKzG,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,gBAAgB;IAKxG,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,eAAe;IAKrG,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAK1F,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB;IAI5C,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB;IAI5C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe;IAI1C,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;IAI3C,QAAQ,CAAC,MAAM,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM;IAY3D,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU;IAIxC,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa;IAIzC,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU;IAIrC,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa;IAItC,MAAM,CAAC,IAAI,EAAE,QAAQ;IAoBrB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,oBAAoB;CAQ7B"}

package/dist/data-store.js

@@ -0,0 +1,141 @@
+import { BooleanFieldResolver, NumericFieldResolver, StringFieldResolver } from './data-store-field-resolver';
+import { ensurePathArray, ensurePathString, throwIfEmpty } from '@axi-engine/utils';
+import { CoreFieldTree } from './core-field-tree';
+import { CoreFields } from './core-fields';
+export class DataStore {
+    tree;
+    resolvers = [];
+    rootFieldsName = '__root_fields';
+    _rootFields;
+    get rootFields() {
+        if (!this._rootFields) {
+            this._rootFields = this.tree.getOrCreateFields(this.rootFieldsName);
+        }
+        return this._rootFields;
+    }
+    constructor(tree) {
+        this.tree = tree;
+        this.registerResolver(new NumericFieldResolver());
+        this.registerResolver(new BooleanFieldResolver());
+        this.registerResolver(new StringFieldResolver());
+    }
+    registerResolver(resolver) {
+        this.resolvers.unshift(resolver);
+    }
+    clearResolvers() {
+        /* set length to 0 because array is readonly, so we can't just reassign them to empty array */
+        this.resolvers.length = 0;
+    }
+    getValue(path) {
+        return this.getField(path).value;
+    }
+    setValue(path, val) {
+        /** for case when field has policies */
+        const field = this.getField(path);
+        field.value = val;
+        return field.value;
+    }
+    createValue(path, val, options) {
+        const dest = this.getDestinationFields(path);
+        if (options?.fieldType) {
+            return dest.fields.create(options.fieldType, dest.leafName, val, options).value;
+        }
+        for (let resolver of this.resolvers) {
+            if (resolver.supports(val)) {
+                return dest.fields.create(resolver.typeName, dest.leafName, val, options).value;
+            }
+        }
+        return dest.fields.createGeneric(dest.leafName, val, options).value;
+    }
+    upsetValue(path, val, options) {
+        const dest = this.getDestinationFields(path);
+        if (options?.fieldType) {
+            return dest.fields.upset(options.fieldType, dest.leafName, val, options).value;
+        }
+        for (let resolver of this.resolvers) {
+            if (resolver.supports(val)) {
+                return dest.fields.upset(resolver.typeName, dest.leafName, val, options).value;
+            }
+        }
+        return dest.fields.upsetGeneric(dest.leafName, val, options).value;
+    }
+    createBoolean(path, initialValue, options) {
+        const dest = this.getDestinationFields(path);
+        return dest.fields.createBoolean(dest.leafName, initialValue, options);
+    }
+    createNumeric(path, initialValue, options) {
+        const dest = this.getDestinationFields(path);
+        return dest.fields.createNumeric(dest.leafName, initialValue, options);
+    }
+    createString(path, initialValue, options) {
+        const dest = this.getDestinationFields(path);
+        return dest.fields.createString(dest.leafName, initialValue, options);
+    }
+    createGeneric(path, initialValue, options) {
+        const dest = this.getDestinationFields(path);
+        return dest.fields.createGeneric(dest.leafName, initialValue, options);
+    }
+    getBoolean(path) {
+        return this.getField(path);
+    }
+    getNumeric(path) {
+        return this.getField(path);
+    }
+    getString(path) {
+        return this.getField(path);
+    }
+    getGeneric(path) {
+        return this.getField(path);
+    }
+    getField(path) {
+        const pathArr = ensurePathArray(path);
+        throwIfEmpty(pathArr, `Wrong path or path is empty: ${ensurePathString(path)}, should contain at least one path segment`);
+        if (this.isPathToRootFields(pathArr)) {
+            return this.rootFields.get(pathArr[0]);
+        }
+        const fieldName = pathArr.pop();
+        const fields = this.tree.getFields(pathArr);
+        return fields.get(fieldName);
+    }
+    createFields(path) {
+        return this.tree.createFields(path, true);
+    }
+    createTree(path) {
+        return this.tree.createFieldTree(path, true);
+    }
+    getFields(path) {
+        return this.tree.getFields(path);
+    }
+    getTree(path) {
+        return this.tree.getFieldTree(path);
+    }
+    remove(path) {
+        const pathArr = ensurePathArray(path);
+        throwIfEmpty(pathArr, `Wrong path or path is empty: ${ensurePathString(path)}, should contain at least one path segment`);
+        /** remove field from root fields */
+        if (this.isPathToRootFields(pathArr)) {
+            this.rootFields.remove(pathArr);
+            return;
+        }
+        const node = this.tree.findParentNode(pathArr);
+        const leafName = pathArr[pathArr.length - 1];
+        if (node instanceof CoreFields) {
+            node.remove(leafName);
+        }
+        else if (node instanceof CoreFieldTree) {
+            node.removeNode(leafName);
+        }
+    }
+    isPathToRootFields(path) {
+        return ensurePathArray(path).length === 1;
+    }
+    getDestinationFields(path) {
+        const pathArr = ensurePathArray(path);
+        if (this.isPathToRootFields(pathArr)) {
+            return { fields: this.rootFields, leafName: pathArr[0] };
+        }
+        const leafName = pathArr.pop();
+        return { fields: this.tree.getOrCreateFields(path), leafName };
+    }
+}
+//# sourceMappingURL=data-store.js.map

package/dist/data-store.js.map

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

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

@@ -0,0 +1,11 @@
+import { CoreField } from './core-field';
+import { BooleanField, FieldOptions } from '../field';
+export interface CoreBooleanFieldOptions extends FieldOptions<boolean> {
+}
+export declare class CoreBooleanField extends CoreField<boolean> implements BooleanField {
+    static readonly typeName: string;
+    readonly typeName: string;
+    constructor(name: string, initialVal: boolean, options?: CoreBooleanFieldOptions);
+    toggle(): boolean;
+}
+//# sourceMappingURL=core-boolean-field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-boolean-field.d.ts","sourceRoot":"","sources":["../../src/field-definitions/core-boolean-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,YAAY,EAAE,YAAY,EAAC,MAAM,UAAU,CAAC;AAEpD,MAAM,WAAW,uBAAwB,SAAQ,YAAY,CAAC,OAAO,CAAC;CAAI;AAE1E,qBAAa,gBAAiB,SAAQ,SAAS,CAAC,OAAO,CAAE,YAAW,YAAY;IAC9E,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAa;IAC7C,QAAQ,CAAC,QAAQ,SAA6B;gBAElC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAIhF,MAAM,IAAI,OAAO;CAIlB"}

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

@@ -0,0 +1,13 @@
+import { CoreField } from './core-field';
+export class CoreBooleanField extends CoreField {
+    static typeName = 'boolean';
+    typeName = CoreBooleanField.typeName;
+    constructor(name, initialVal, options) {
+        super(name, initialVal, options);
+    }
+    toggle() {
+        this.value = !this.value;
+        return this.value;
+    }
+}
+//# sourceMappingURL=core-boolean-field.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-boolean-field.js","sourceRoot":"","sources":["../../src/field-definitions/core-boolean-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAKvC,MAAM,OAAO,gBAAiB,SAAQ,SAAkB;IACtD,MAAM,CAAU,QAAQ,GAAW,SAAS,CAAC;IACpC,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAE9C,YAAY,IAAY,EAAE,UAAmB,EAAE,OAAiC;QAC9E,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC"}

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

@@ -0,0 +1,51 @@
+import { Subscribable } from '@axi-engine/utils';
+import { Policies } from '../policies';
+import { Field, FieldOptions } from '../field';
+/**
+ * A state container that wraps a value.
+ * It allows applying a pipeline of transformation or validation "policies" before any new value is set.
+ *
+ * @template T The type of the value this field holds.
+ *
+ */
+export declare class CoreField<T> implements Field<T> {
+    /** A type keyword of the field */
+    static readonly typeName: string;
+    readonly typeName: string;
+    /** A unique identifier for the field. */
+    private readonly _name;
+    private _value;
+    private readonly _onChange;
+    readonly onChange: Subscribable<[newValue: T, oldvalue: T]>;
+    readonly policies: Policies<T>;
+    get name(): string;
+    /**
+     * Gets the current raw value of the field.
+     * For reactive updates, it's recommended to use the `.signal` property instead.
+     */
+    get value(): T;
+    /**
+     * Sets a new value for the field.
+     * The provided value will be processed by all registered policies before the underlying signal is updated.
+     * @param val The new value to set.
+     */
+    set value(val: T);
+    /**
+     * Creates an instance of a Field.
+     * @param name A unique identifier for the field.
+     * @param initialVal The initial value of the field.
+     * @param options Optional configuration for the field.
+     * @param options.policies An array of policies to apply to the field's value on every `set` operation.
+     * @param options.isEqual An function for compare old and new value, by default uses the strictEquals from `utils`
+     *
+     */
+    constructor(name: string, initialVal: T, options?: FieldOptions<T>);
+    setValueSilently(val: T): void;
+    batchUpdate(updateFn: (currentValue: T) => T): void;
+    /**
+     * Cleans up resources used by the field and its policies.
+     * This should be called when the field is no longer needed to prevent memory leaks from reactive policies.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=core-field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-field.d.ts","sourceRoot":"","sources":["../../src/field-definitions/core-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAC,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAC;AAErC,OAAO,EAAC,KAAK,EAAE,YAAY,EAAC,MAAM,UAAU,CAAC;AAG7C;;;;;;GAMG;AACH,qBAAa,SAAS,CAAC,CAAC,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAC3C,kCAAkC;IAClC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAa;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAsB;IAE/C,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsD;IAChF,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAkB;IAGhD,IAAI,IAAI,WAEP;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,CAAC,CAEb;IAED;;;;OAIG;IACH,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,EAOf;IAED;;;;;;;;OAQG;gBAED,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,CAAC,EACb,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAQ3B,gBAAgB,CAAC,GAAG,EAAE,CAAC;IAIvB,WAAW,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI;IAInD;;;OAGG;IACH,OAAO;CAIR"}

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

@@ -0,0 +1,74 @@
+import { Emitter } from '@axi-engine/utils';
+import { Policies } from '../policies';
+import { dequal } from 'dequal';
+/**
+ * A state container that wraps a value.
+ * It allows applying a pipeline of transformation or validation "policies" before any new value is set.
+ *
+ * @template T The type of the value this field holds.
+ *
+ */
+export class CoreField {
+    /** A type keyword of the field */
+    static typeName = 'default';
+    typeName = CoreField.typeName;
+    /** A unique identifier for the field. */
+    _name;
+    _value;
+    _onChange = new Emitter();
+    onChange;
+    policies = new Policies();
+    get name() {
+        return this._name;
+    }
+    /**
+     * Gets the current raw value of the field.
+     * For reactive updates, it's recommended to use the `.signal` property instead.
+     */
+    get value() {
+        return this._value;
+    }
+    /**
+     * Sets a new value for the field.
+     * The provided value will be processed by all registered policies before the underlying signal is updated.
+     * @param val The new value to set.
+     */
+    set value(val) {
+        const oldVal = this._value;
+        const finalVal = this.policies.apply(val);
+        if (!dequal(this._value, finalVal)) {
+            this._value = finalVal;
+            this._onChange.emit(this._value, oldVal);
+        }
+    }
+    /**
+     * Creates an instance of a Field.
+     * @param name A unique identifier for the field.
+     * @param initialVal The initial value of the field.
+     * @param options Optional configuration for the field.
+     * @param options.policies An array of policies to apply to the field's value on every `set` operation.
+     * @param options.isEqual An function for compare old and new value, by default uses the strictEquals from `utils`
+     *
+     */
+    constructor(name, initialVal, options) {
+        this.onChange = this._onChange;
+        this._name = name;
+        options?.policies?.forEach(policy => this.policies.add(policy));
+        this.value = initialVal;
+    }
+    setValueSilently(val) {
+        this._value = this.policies.apply(val);
+    }
+    batchUpdate(updateFn) {
+        this.value = updateFn(this.value);
+    }
+    /**
+     * Cleans up resources used by the field and its policies.
+     * This should be called when the field is no longer needed to prevent memory leaks from reactive policies.
+     */
+    destroy() {
+        this.policies.clear();
+        this._onChange.clear();
+    }
+}
+//# sourceMappingURL=core-field.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-field.js","sourceRoot":"","sources":["../../src/field-definitions/core-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAe,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAC;AACrC,OAAO,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAI9B;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IACpB,kCAAkC;IAClC,MAAM,CAAU,QAAQ,GAAW,SAAS,CAAC;IACpC,QAAQ,GAAW,SAAS,CAAC,QAAQ,CAAC;IAE/C,yCAAyC;IACxB,KAAK,CAAS;IACvB,MAAM,CAAK;IACF,SAAS,GAAwC,IAAI,OAAO,EAAE,CAAC;IACvE,QAAQ,CAA2C;IACnD,QAAQ,GAAgB,IAAI,QAAQ,EAAE,CAAC;IAGhD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,IAAI,KAAK,CAAC,GAAM;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;YACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,YACE,IAAY,EACZ,UAAa,EACb,OAAyB;QAEzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;IAC1B,CAAC;IAED,gBAAgB,CAAC,GAAM;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,QAAgC;QAC1C,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC"}

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

@@ -0,0 +1,18 @@
+import { CoreField } from './core-field';
+import { FieldOptions, NumericField } from '../field';
+export interface CoreNumericFieldOptions extends FieldOptions<number> {
+    min?: number;
+    max?: number;
+}
+export declare class CoreNumericField extends CoreField<number> implements NumericField {
+    static readonly typeName: string;
+    readonly typeName: string;
+    get min(): number | undefined;
+    get max(): number | undefined;
+    constructor(name: string, initialVal: number, options?: CoreNumericFieldOptions);
+    isMin(): boolean;
+    isMax(): boolean;
+    inc(amount?: number): void;
+    dec(amount?: number): void;
+}
+//# sourceMappingURL=core-numeric-field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-numeric-field.d.ts","sourceRoot":"","sources":["../../src/field-definitions/core-numeric-field.ts"],"names":[],"mappings":"AAQA,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAC,YAAY,EAAE,YAAY,EAAC,MAAM,UAAU,CAAC;AAGpD,MAAM,WAAW,uBAAwB,SAAQ,YAAY,CAAC,MAAM,CAAC;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,gBAAiB,SAAQ,SAAS,CAAC,MAAM,CAAE,YAAW,YAAY;IAC7E,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAa;IAC7C,QAAQ,CAAC,QAAQ,SAA6B;IAE9C,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAK5B;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAK5B;gBAEW,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAY/E,KAAK,IAAI,OAAO;IAKhB,KAAK,IAAI,OAAO;IAKhB,GAAG,CAAC,MAAM,SAAI;IAId,GAAG,CAAC,MAAM,SAAI;CAGf"}