@adaas/a-frame 0.0.22 → 0.1.1

package/dist/node/chunk-ZM2RLVVH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/helpers/Hash.helper.ts"],"names":[],"mappings":";;;AAEO,IAAM,oBAAN,MAAwB;AAAA;AAAA,EAG3B,OAAO,MAAM,GAAA,EAAqB;AAC9B,IAAA,IAAI,IAAA,GAAO,UAAA;AACX,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,GAAA,CAAI,QAAQ,CAAA,EAAA,EAAK;AACjC,MAAA,IAAA,IAAQ,GAAA,CAAI,WAAW,CAAC,CAAA;AACxB,MAAA,IAAA,GAAQ,OAAO,QAAA,KAAgB,CAAA;AAAA,IACnC;AACA,IAAA,OAAO,KAAK,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,GAAG,GAAG,CAAA;AAAA,EAC5C;AACJ","file":"chunk-ZM2RLVVH.cjs","sourcesContent":["\n\nexport class A_FrameHashHelper {\n\n    // ─── Hash (FNV-1a 32-bit, no external deps) ──────────────────────────────────\n    static fnv1a(str: string): string {\n        let hash = 2_166_136_261; // offset basis\n        for (let i = 0; i < str.length; i++) {\n            hash ^= str.charCodeAt(i);\n            hash = (hash * 16_777_619) >>> 0; // keep 32-bit unsigned\n        }\n        return hash.toString(16).padStart(8, \"0\");\n    }\n}"]}

package/dist/node/core.cjs

@@ -0,0 +1,259 @@
+'use strict';
+
+var chunkRRLTGGM7_cjs = require('./chunk-RRLTGGM7.cjs');
+var chunkUTJ7CVVB_cjs = require('./chunk-UTJ7CVVB.cjs');
+var chunkF46TSY2K_cjs = require('./chunk-F46TSY2K.cjs');
+var chunkQFUZVN4Y_cjs = require('./chunk-QFUZVN4Y.cjs');
+var chunkGRR6NNWY_cjs = require('./chunk-GRR6NNWY.cjs');
+var chunkXFUF7SDO_cjs = require('./chunk-XFUF7SDO.cjs');
+require('./chunk-KK64VLZN.cjs');
+var chunkKLG6HKFU_cjs = require('./chunk-KLG6HKFU.cjs');
+require('./chunk-R2H234YO.cjs');
+var chunkYVX4W6SI_cjs = require('./chunk-YVX4W6SI.cjs');
+var chunkGBTFMT3K_cjs = require('./chunk-GBTFMT3K.cjs');
+require('./chunk-ZM2RLVVH.cjs');
+require('./chunk-YWWGJ6EJ.cjs');
+var chunkQFHZIG7Y_cjs = require('./chunk-QFHZIG7Y.cjs');
+var aConcept = require('@adaas/a-concept');
+
+// src/lib/A-Frame/A-Frame.types.ts
+var A_FrameTargetType = /* @__PURE__ */ ((A_FrameTargetType2) => {
+  A_FrameTargetType2["COMPONENT"] = "component";
+  A_FrameTargetType2["ENTITY"] = "entity";
+  A_FrameTargetType2["CONTAINER"] = "container";
+  A_FrameTargetType2["FRAGMENT"] = "fragment";
+  A_FrameTargetType2["METHOD"] = "method";
+  return A_FrameTargetType2;
+})(A_FrameTargetType || {});
+var A_FrameTypeGuard = class {
+  /**
+   * Determines if the target is an allowed type for indexing
+   * 
+   * @param target 
+   * @returns 
+   */
+  static isAllowedTarget(target) {
+    return aConcept.A_TypeGuards.isEntityConstructor(target) || aConcept.A_TypeGuards.isComponentConstructor(target) || aConcept.A_TypeGuards.isContainerConstructor(target) || aConcept.A_TypeGuards.isFragmentConstructor(target) || aConcept.A_TypeGuards.isComponentInstance(target) || aConcept.A_TypeGuards.isContainerInstance(target) || aConcept.A_TypeGuards.isEntityInstance(target) || aConcept.A_TypeGuards.isFragmentInstance(target);
+  }
+  static getTargetName(target) {
+    return aConcept.A_CommonHelper.getComponentName(target);
+  }
+  static getTargetConstructor(target) {
+    return typeof target === "function" ? target : target.constructor;
+  }
+};
+var A_FrameError = class extends aConcept.A_Error {
+};
+A_FrameError.InvalidTarget = "A-Frame Index Invalid Target Error";
+A_FrameError.InvalidConfiguration = "A-Frame Index Invalid Configuration Error";
+A_FrameError.IndexDefinitionError = "A-Frame Index Definition Error";
+A_FrameError.IndexMetadataError = "A-Frame Index Metadata Error";
+A_FrameError.IndexRegistryError = "A-Frame Index Registry Error";
+A_FrameError.IndexComponentNotFoundError = "A-Frame Index Component Not Found Error";
+
+// src/lib/A-Frame/decorators/A-FrameDefine.decorator.ts
+function A_FrameDefineDecorator(config) {
+  return function(target, propertyKey, descriptor) {
+    let componentType;
+    switch (true) {
+      case (!!propertyKey && !!descriptor):
+        componentType = "method" /* METHOD */;
+        break;
+      case (aConcept.A_TypeGuards.isComponentConstructor(target) || aConcept.A_TypeGuards.isComponentInstance(target)):
+        componentType = "component" /* COMPONENT */;
+        break;
+      case (aConcept.A_TypeGuards.isContainerConstructor(target) || aConcept.A_TypeGuards.isContainerInstance(target)):
+        componentType = "container" /* CONTAINER */;
+        break;
+      case (aConcept.A_TypeGuards.isEntityConstructor(target) || aConcept.A_TypeGuards.isEntityInstance(target)):
+        componentType = "entity" /* ENTITY */;
+        break;
+      case (aConcept.A_TypeGuards.isFragmentConstructor(target) || aConcept.A_TypeGuards.isFragmentInstance(target)):
+        componentType = "fragment" /* FRAGMENT */;
+        break;
+      default:
+        throw new A_FrameError(
+          A_FrameError.InvalidTarget,
+          `@A_Frame.Define decorator cannot be applied to the target.`
+        );
+    }
+    const namespace = config.namespace ? config.namespace instanceof chunkKLG6HKFU_cjs.A_FrameNamespace ? config.namespace : chunkRRLTGGM7_cjs.A_FrameIndex.getNamespace(config.namespace) || new chunkKLG6HKFU_cjs.A_FrameNamespace({
+      name: config.namespace
+    }) : chunkRRLTGGM7_cjs.A_FrameIndex.getDefaultNamespace();
+    if (!!propertyKey && !!descriptor) {
+      const targetClass2 = target.constructor;
+      const methodName = String(propertyKey);
+      const source2 = descriptor.value.toString();
+      chunkRRLTGGM7_cjs.A_FrameIndex.addDefinition(new chunkGBTFMT3K_cjs.A_FrameDefinition({
+        name: methodName,
+        dependency: targetClass2.name,
+        description: config.description,
+        source: source2,
+        metadata: config.metadata,
+        type: "method" /* METHOD */,
+        namespace
+      }));
+      return descriptor;
+    }
+    if (!A_FrameTypeGuard.isAllowedTarget(target)) {
+      throw new A_FrameError(
+        A_FrameError.InvalidTarget,
+        `@A_Frame.${componentType} decorator can only be applied to allowed targets.`
+      );
+    }
+    const componentName = aConcept.A_CommonHelper.getComponentName(target);
+    const targetClass = A_FrameTypeGuard.getTargetConstructor(target);
+    const source = target.toString();
+    chunkRRLTGGM7_cjs.A_FrameIndex.addDefinition(new chunkGBTFMT3K_cjs.A_FrameDefinition({
+      name: componentName,
+      description: config.description,
+      dependency: targetClass.name,
+      source,
+      metadata: config.metadata,
+      type: componentType,
+      namespace
+    }));
+    return target;
+  };
+}
+
+// src/lib/A-Frame/decorators/A-FrameNamespace.decorator.ts
+function A_FrameNamespaceDecorator(config = {}) {
+  return function(target, propertyKey, descriptor) {
+    if (!config.name)
+      throw new A_FrameError(
+        A_FrameError.InvalidConfiguration,
+        `@A_Frame.Namespace decorator requires a name in the configuration.`
+      );
+    const namespace = new chunkKLG6HKFU_cjs.A_FrameNamespace({
+      name: config.name,
+      description: config.description
+    });
+    chunkRRLTGGM7_cjs.A_FrameIndex.addNamespace(namespace);
+  };
+}
+
+// src/lib/A-Frame/A-Frame.component.ts
+var A_FrameBase = class extends aConcept.A_Component {
+  /**
+   * Primary Decorator to define and index components, containers, entities, fragments and methods in the A-Frame Index structure
+   * 
+   * Those components will participate in AI indexing and retrieval strategy, so they can be used in the better way to build new features and components.
+   * 
+   * @param options 
+   * @returns 
+   */
+  static Define(options) {
+    return A_FrameDefineDecorator(options);
+  }
+  /**
+   * Allows to define a namespace for grouping related components, containers, entities, fragments and methods together in the A-Frame Index structure. This is useful for better organization and retrieval strategy.
+   * 
+   * @param options 
+   * @returns 
+   */
+  static NameSpace(options) {
+    return A_FrameNamespaceDecorator(options);
+  }
+  /**
+   * Default per-instance dependencies registered on first build. The blob
+   * store is intentionally omitted here — the user is expected to seed and
+   * register `A_FrameBrowserStorageBlobs` themselves (typically via
+   * `A_FrameBrowserStorageBlobs.fromBundle(bundle)` before `concept.load()`).
+   * If they don't, `A_FrameBrowserStorageProvider.onLoad()` falls back to the
+   * empty singleton.
+   */
+  get package() {
+    return [
+      // { ctor: A_FrameContext, instance: new A_FrameContext() },
+      // { ctor: A_FrameEnv, instance: new A_FrameEnv() },
+      // { ctor: A_FrameStorageCodec, instance: new A_FrameStorageCodec() },
+      // { ctor: A_FrameBrowserStorageProvider, instance: A_FrameBrowserStorageProvider },
+      // { ctor: A_FrameLogger, instance: new A_FrameLogger() },
+    ];
+  }
+  packDependency(scope, target, def) {
+    const existing = scope.resolve(target);
+    if (!existing) scope.register(def);
+  }
+};
+var _A_Frame = class _A_Frame extends A_FrameBase {
+  async injectDependencies() {
+    const index = new chunkRRLTGGM7_cjs.A_FrameIndex();
+    index.inherit(aConcept.A_Context.root);
+    aConcept.A_Context.root.register(index);
+    aConcept.A_Context.root.register(new chunkXFUF7SDO_cjs.A_FrameEnv());
+    aConcept.A_Context.root.register(new chunkQFUZVN4Y_cjs.A_FrameStorageCodec());
+    aConcept.A_Context.root.register(chunkF46TSY2K_cjs.A_FrameNodeStorage);
+    aConcept.A_Context.root.register(chunkGRR6NNWY_cjs.A_FrameNodeChannel);
+    aConcept.A_Context.root.register(chunkYVX4W6SI_cjs.A_FrameCrypto);
+    aConcept.A_Context.root.register(new chunkUTJ7CVVB_cjs.A_FrameLogger());
+    aConcept.A_Context.root.register(_A_Frame);
+    aConcept.A_Context.root.register(new chunkF46TSY2K_cjs.A_FrameContext());
+  }
+  async load(scope, index, storage, context, channel, env) {
+    const credentials = await channel.getCredentials();
+    context.setCredentials(credentials);
+    const definedNameSpaces = index.listNamespaces();
+    const definedDefinitions = index.listDefinitions();
+    await Promise.all([
+      ...definedNameSpaces.map((ns) => ns.load()),
+      ...definedDefinitions.map((def) => def.load())
+    ]);
+    if (!env.A_FRAME_SYNC) return;
+    const namespacesNeedEmbed = definedNameSpaces.filter(
+      (ns) => !ns.isEmbed || ns.aFrameServerVersion !== context.serverVersion || ns.aFrameVersion !== env.A_FRAME_VERSION
+      // re-embed if the client version has changed since last embed, as it may affect embedding results
+    );
+    const definitionsNeedEmbed = definedDefinitions.filter(
+      (def) => !def.isEmbed || def.aFrameServerVersion !== context.serverVersion || def.aFrameVersion !== env.A_FRAME_VERSION
+      // re-embed if the client version has changed since last embed, as it may affect embedding results
+    );
+    for (const batch of this.chunkArray(namespacesNeedEmbed, 10)) {
+      await Promise.all(batch.map((ns) => ns.embed()));
+      for (const ns of batch) {
+        await ns.save();
+      }
+    }
+    for (const batch of this.chunkArray(definitionsNeedEmbed, 10)) {
+      await Promise.all(batch.map((def) => def.embed()));
+      for (const def of batch) {
+        await def.save();
+      }
+    }
+  }
+  chunkArray(array, size) {
+    const result = [];
+    for (let i = 0; i < array.length; i += size) {
+      result.push(array.slice(i, i + size));
+    }
+    return result;
+  }
+};
+chunkQFHZIG7Y_cjs.__decorateClass([
+  aConcept.A_Concept.Load()
+], _A_Frame.prototype, "injectDependencies", 1);
+chunkQFHZIG7Y_cjs.__decorateClass([
+  aConcept.A_Concept.Load(),
+  chunkQFHZIG7Y_cjs.__decorateParam(0, aConcept.A_Inject(aConcept.A_Scope)),
+  chunkQFHZIG7Y_cjs.__decorateParam(1, aConcept.A_Inject(chunkRRLTGGM7_cjs.A_FrameIndex)),
+  chunkQFHZIG7Y_cjs.__decorateParam(2, aConcept.A_Inject(chunkF46TSY2K_cjs.A_FrameStorage)),
+  chunkQFHZIG7Y_cjs.__decorateParam(3, aConcept.A_Inject(chunkF46TSY2K_cjs.A_FrameContext)),
+  chunkQFHZIG7Y_cjs.__decorateParam(4, aConcept.A_Inject(chunkGRR6NNWY_cjs.A_FrameChannel)),
+  chunkQFHZIG7Y_cjs.__decorateParam(5, aConcept.A_Inject(chunkXFUF7SDO_cjs.A_FrameEnv))
+], _A_Frame.prototype, "load", 1);
+var A_Frame = _A_Frame;
+
+Object.defineProperty(exports, "A_FrameContext", {
+  enumerable: true,
+  get: function () { return chunkF46TSY2K_cjs.A_FrameContext; }
+});
+exports.A_Frame = A_Frame;
+exports.A_FrameBase = A_FrameBase;
+exports.A_FrameDefineDecorator = A_FrameDefineDecorator;
+exports.A_FrameError = A_FrameError;
+exports.A_FrameNamespaceDecorator = A_FrameNamespaceDecorator;
+exports.A_FrameTargetType = A_FrameTargetType;
+exports.A_FrameTypeGuard = A_FrameTypeGuard;
+//# sourceMappingURL=core.cjs.map
+//# sourceMappingURL=core.cjs.map

package/dist/node/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-Frame/A-Frame.types.ts","../../src/lib/A-Frame/A-Frame.guard.ts","../../src/lib/A-Frame/A-Frame.error.ts","../../src/lib/A-Frame/decorators/A-FrameDefine.decorator.ts","../../src/lib/A-Frame/decorators/A-FrameNamespace.decorator.ts","../../src/lib/A-Frame/A-Frame.component.ts","../../src/lib/A-Frame/A-Frame.component.env-node.ts"],"names":["A_FrameTargetType","A_TypeGuards","A_CommonHelper","A_Error","A_FrameNamespace","A_FrameIndex","targetClass","source","A_FrameDefinition","A_Component","A_Context","A_FrameEnv","A_FrameStorageCodec","A_FrameNodeStorage","A_FrameNodeChannel","A_FrameCrypto","A_FrameLogger","A_FrameContext","__decorateClass","A_Concept","__decorateParam","A_Scope","A_FrameStorage","A_FrameChannel"],"mappings":"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","file":"core.cjs","sourcesContent":["import { A_Component, A_Container, A_Entity, A_Fragment, A_TYPES__Component_Constructor, A_TYPES__Container_Constructor, A_TYPES__Entity_Constructor, A_TYPES__Fragment_Constructor, A_TYPES__Required } from \"@adaas/a-concept\"\nimport { A_FrameNamespace } from \"../A-FrameNamespace\"\n\n\nexport type A_FrameOptions = {\n    namespace?: string\n    description?: string\n}\n\n\nexport type A_FrameDefineOptions<T extends Record<string, any> = Record<string, any>> = {\n    /**\n     * The description of the Method or Class to be indexed. Uses for the better explanation and retrieval strategy \n     */\n    description?: string,\n    /**\n     * Define Namespace to separate and group together related components, entities and containers.\n     * \n     * [!] Namespace is a hard separation between groups.\n     */\n    namespace?: string | A_FrameNamespace\n    /***\n     * Optional parameters that can be used to store any additional information about the component, entity or container.\n     * This information can be used for the better retrieval strategy or for the better explanation of the component, entity or container.\n     */\n    metadata?: T,\n    /**\n     * Can add a custom way of explaining the component, entity or container, so it can be used in the better retrieval strategy.\n     */\n    examples?: string[]\n}\n\n\nexport type A_FrameMetaTarget = A_TYPES__Container_Constructor\n    | A_TYPES__Entity_Constructor\n    | A_TYPES__Component_Constructor\n    | A_TYPES__Fragment_Constructor\n\n\n// ===========================================================================\n// --------------------------- Decorator Types -------------------------------\n// ===========================================================================\n// ---------------------------------------------------------------------------\n// -------------------- A-Frame Index Decorator Types-------------------------\n// ---------------------------------------------------------------------------\n/**\n * Indicates a type of Feature Define decorator\n */\nexport type A_FrameDecoratorDescriptor =\n    TypedPropertyDescriptor<(...args: any[]) => any>\n    | TypedPropertyDescriptor<(...args: any[]) => any>\n    | TypedPropertyDescriptor<(...args: any[]) => Promise<any>>\n    | TypedPropertyDescriptor<(...args: any[]) => Promise<any>>\n\n\n/**\n * Describes a target where Feature Define decorator can be applied\n * \n * [!] The feature can be defined on Container, Entity, Component or Command\n */\nexport type A_FrameDecoratorTarget = A_FrameMetaTarget\n    | A_Component\n    | A_Container\n    | A_Entity\n    | A_Fragment\n/**\n * Targets types that can be indexed\n */\nexport enum A_FrameTargetType {\n    COMPONENT = 'component',\n    ENTITY = 'entity',\n    CONTAINER = 'container',\n    FRAGMENT = 'fragment',\n    METHOD = 'method'\n}\n\n/**\n * A type of Meta information stored by Index decorator\n * This information is used by A-Context to build a proper index structure\n */\nexport type A_FrameDecoratorMeta = {\n    /**\n     * Component name\n     */\n    name: string,\n    /**\n     * Component description\n     */\n    description?: string,\n    /**\n     * Type of the component\n     */\n    type: A_FrameTargetType,\n    /**\n     * Namespace for the component\n     */\n    namespace?: string | A_FrameNamespace\n    /**\n     * Constructor reference\n     */\n    constructor: A_FrameDecoratorTarget\n}\n\n\n// ---------------------------------------------------------------------------\n// -------------------- A-Frame Index Decorator Types-------------------------\n// ---------------------------------------------------------------------------\n/**\n * Indicates a type of Feature Define decorator\n */\nexport type A_FrameNamespaceDecoratorDescriptor =\n    TypedPropertyDescriptor<(...args: any[]) => any>\n    | TypedPropertyDescriptor<(...args: any[]) => any>\n    | TypedPropertyDescriptor<(...args: any[]) => Promise<any>>\n    | TypedPropertyDescriptor<(...args: any[]) => Promise<any>>\n\n\n/**\n * Describes a target where Feature Define decorator can be applied\n * \n * [!] The feature can be defined on Container, Entity, Component or Command\n */\nexport type A_FrameNamespaceDecoratorTarget = A_Container\n    | A_Entity\n    | A_Component\n    | A_Fragment\n    | A_TYPES__Fragment_Constructor\n    | A_TYPES__Component_Constructor\n    | A_TYPES__Container_Constructor\n    | A_TYPES__Entity_Constructor\n\n\n\n\n// ---------------------------------------------------------------------------\n// ------------- A-Frame Index Configurations Meta Types----------------------\n// ---------------------------------------------------------------------------\n\n\nexport type A_FrameIndexMetaType = {\n    namespaces: string,\n    descriptions: string,\n    type: string,\n    name: string,\n    methods: Map<string, A_FrameIndexMetaMethodMeta>\n}\n\n\nexport type A_FrameIndexMetaMethodMeta = {\n    name: string,\n    description?: string,\n    methodName: string\n}\n\n\n\n\nexport type A_FrameNamespaceOptions = {\n    /**\n     * Must have UNIQUE name of the Namespace. This is used for the indexing and retrieval strategy. It should be descriptive and concise.\n     */\n    name: string,\n    /**\n     * The description of the Namespace to be indexed. Uses for the better explanation and retrieval strategy\n     */\n    description?: string,\n}","import { A_CommonHelper, A_TypeGuards } from \"@adaas/a-concept\";\nimport { A_FrameDecoratorTarget, A_FrameMetaTarget } from \"./A-Frame.types\";\nimport { A_FrameIndexTarget } from \"../A-FrameIndex/A-FrameIndex.types\";\n\n\n\nexport class A_FrameTypeGuard {\n    /**\n     * Determines if the target is an allowed type for indexing\n     * \n     * @param target \n     * @returns \n     */\n    static isAllowedTarget(target: any): target is A_FrameDecoratorTarget {\n        return A_TypeGuards.isEntityConstructor(target)\n            || A_TypeGuards.isComponentConstructor(target)\n            || A_TypeGuards.isContainerConstructor(target)\n            || A_TypeGuards.isFragmentConstructor(target)\n            || A_TypeGuards.isComponentInstance(target)\n            || A_TypeGuards.isContainerInstance(target)\n            || A_TypeGuards.isEntityInstance(target)\n            || A_TypeGuards.isFragmentInstance(target);\n    }\n\n\n\n    static getTargetName(target: A_FrameDecoratorTarget): string {\n        return A_CommonHelper.getComponentName(target);\n    }\n\n\n    static getTargetConstructor(target: A_FrameDecoratorTarget): A_FrameIndexTarget {\n        return typeof target === 'function' ? target : target.constructor as A_FrameIndexTarget;\n    }\n\n\n}","import { A_Error } from \"@adaas/a-concept\";\n\n\nexport class A_FrameError extends A_Error {\n\n    static readonly InvalidTarget = 'A-Frame Index Invalid Target Error';\n\n    static readonly InvalidConfiguration = 'A-Frame Index Invalid Configuration Error';\n\n    static readonly IndexDefinitionError = 'A-Frame Index Definition Error';\n    static readonly IndexMetadataError = 'A-Frame Index Metadata Error';\n    static readonly IndexRegistryError = 'A-Frame Index Registry Error';\n    static readonly IndexComponentNotFoundError = 'A-Frame Index Component Not Found Error';\n}","import { A_CommonHelper, A_Context, A_Meta, A_TypeGuards } from \"@adaas/a-concept\";\nimport { A_FrameDecoratorTarget, A_FrameTargetType, A_FrameDecoratorDescriptor, A_FrameMetaTarget, A_FrameDefineOptions } from \"../A-Frame.types\";\nimport { A_FrameTypeGuard } from \"../A-Frame.guard\";\nimport { A_FrameError } from \"../A-Frame.error\";\nimport { A_FrameIndex } from \"@adaas/a-frame/index\";\nimport { A_FrameDefinition } from \"@adaas/a-frame/definition\";\nimport { A_FrameNamespace } from \"@adaas/a-frame/namespace\";\n\nexport function A_FrameDefineDecorator(\n    config: A_FrameDefineOptions\n) {\n    return function (\n        target: A_FrameDecoratorTarget,\n        propertyKey?: string | symbol,\n        descriptor?: A_FrameDecoratorDescriptor\n    ): any {\n        let componentType: A_FrameTargetType;\n\n        switch (true) {\n            case !!propertyKey && !!descriptor:\n                componentType = A_FrameTargetType.METHOD;\n                break;\n            case A_TypeGuards.isComponentConstructor(target) || A_TypeGuards.isComponentInstance(target):\n                componentType = A_FrameTargetType.COMPONENT;\n                break;\n            case A_TypeGuards.isContainerConstructor(target) || A_TypeGuards.isContainerInstance(target):\n                componentType = A_FrameTargetType.CONTAINER;\n                break;\n            case A_TypeGuards.isEntityConstructor(target) || A_TypeGuards.isEntityInstance(target):\n                componentType = A_FrameTargetType.ENTITY;\n                break;\n            case A_TypeGuards.isFragmentConstructor(target) || A_TypeGuards.isFragmentInstance(target):\n                componentType = A_FrameTargetType.FRAGMENT;\n                break;\n            default:\n                throw new A_FrameError(\n                    A_FrameError.InvalidTarget,\n                    `@A_Frame.Define decorator cannot be applied to the target.`\n                );\n        }\n        const namespace = config.namespace\n            ? config.namespace instanceof A_FrameNamespace\n                ? config.namespace\n                : A_FrameIndex.getNamespace(config.namespace) || new A_FrameNamespace({\n                    name: config.namespace,\n                })\n            : A_FrameIndex.getDefaultNamespace();\n\n\n        // Handle method decorator case\n        if (!!propertyKey && !!descriptor) {\n            // For methods, target is the class prototype\n            const targetClass = target.constructor as A_FrameMetaTarget;\n            const methodName = String(propertyKey);\n\n            const source = (descriptor.value as Function).toString();\n\n            // Add to methods array\n            A_FrameIndex.addDefinition(new A_FrameDefinition({\n                name: methodName,\n                dependency: targetClass.name,\n                description: config.description,\n                source: source,\n                metadata: config.metadata,\n                type: A_FrameTargetType.METHOD,\n                namespace: namespace\n            }));\n\n            return descriptor;\n        }\n\n        // Handle class decorator case\n        if (!A_FrameTypeGuard.isAllowedTarget(target)) {\n            throw new A_FrameError(\n                A_FrameError.InvalidTarget,\n                `@A_Frame.${componentType} decorator can only be applied to allowed targets.`\n            );\n        }\n\n        // for error messages\n        const componentName = A_CommonHelper.getComponentName(target);\n\n        const targetClass = A_FrameTypeGuard.getTargetConstructor(target);\n\n        // Check for pending namespace and description from other decorators\n        const source = target.toString();\n\n        A_FrameIndex.addDefinition(new A_FrameDefinition({\n            name: componentName,\n            description: config.description,\n            dependency: targetClass.name,\n            source: source,\n            metadata: config.metadata,\n            type: componentType,\n            namespace: namespace\n        }));\n\n        return target;\n\n    };\n}\n\n\n\n","import { A_CommonHelper, A_Context, A_Meta, A_TypeGuards } from \"@adaas/a-concept\";\nimport { A_FrameDecoratorTarget, A_FrameTargetType, A_FrameDecoratorDescriptor, A_FrameMetaTarget, A_FrameNamespaceOptions } from \"../A-Frame.types\";\nimport { A_FrameError } from \"../A-Frame.error\";\nimport { A_FrameIndex } from \"@adaas/a-frame/index\";\nimport { A_FrameNamespace } from \"@adaas/a-frame/namespace\";\n\nexport function A_FrameNamespaceDecorator(\n    config: Partial<A_FrameNamespaceOptions> = {}\n) {\n    return function (\n        target: A_FrameDecoratorTarget,\n        propertyKey?: string | symbol,\n        descriptor?: A_FrameDecoratorDescriptor\n    ): any {\n\n        if (!config.name)\n            throw new A_FrameError(\n                A_FrameError.InvalidConfiguration,\n                `@A_Frame.Namespace decorator requires a name in the configuration.`\n            );\n\n        const namespace = new A_FrameNamespace({\n            name: config.name,\n            description: config.description,\n        });\n\n\n        A_FrameIndex.addNamespace(namespace);\n    };\n}\n\n\n\n","import { A_Component, A_Scope, A_TYPES__A_DependencyInjectable, A_TYPES__Component_Constructor, A_TYPES__Ctor, A_TYPES__Fragment_Constructor } from \"@adaas/a-concept\";\nimport { A_FrameDefineOptions, A_FrameNamespaceOptions } from \"./A-Frame.types\";\nimport { A_FrameDefineDecorator } from \"./decorators/A-FrameDefine.decorator\";\nimport { A_FrameNamespaceDecorator } from \"./decorators/A-FrameNamespace.decorator\";\n\n\n\nexport class A_FrameBase extends A_Component {\n    /**\n     * Primary Decorator to define and index components, containers, entities, fragments and methods in the A-Frame Index structure\n     * \n     * Those components will participate in AI indexing and retrieval strategy, so they can be used in the better way to build new features and components.\n     * \n     * @param options \n     * @returns \n     */\n    static Define(options: A_FrameDefineOptions) {\n        return A_FrameDefineDecorator(options) as ClassDecorator & MethodDecorator;\n\n    }\n    /**\n     * Allows to define a namespace for grouping related components, containers, entities, fragments and methods together in the A-Frame Index structure. This is useful for better organization and retrieval strategy.\n     * \n     * @param options \n     * @returns \n     */\n    static NameSpace(options: A_FrameNamespaceOptions) {\n        return A_FrameNamespaceDecorator(options) as ClassDecorator & MethodDecorator;\n    }\n\n\n\n    /**\n     * Default per-instance dependencies registered on first build. The blob\n     * store is intentionally omitted here — the user is expected to seed and\n     * register `A_FrameBrowserStorageBlobs` themselves (typically via\n     * `A_FrameBrowserStorageBlobs.fromBundle(bundle)` before `concept.load()`).\n     * If they don't, `A_FrameBrowserStorageProvider.onLoad()` falls back to the\n     * empty singleton.\n     */\n    get package(): Array<{ ctor: A_TYPES__Component_Constructor<any> | A_TYPES__Fragment_Constructor<any>; instance: any }> {\n        return [\n            // { ctor: A_FrameContext, instance: new A_FrameContext() },\n            // { ctor: A_FrameEnv, instance: new A_FrameEnv() },\n            // { ctor: A_FrameStorageCodec, instance: new A_FrameStorageCodec() },\n            // { ctor: A_FrameBrowserStorageProvider, instance: A_FrameBrowserStorageProvider },\n            // { ctor: A_FrameLogger, instance: new A_FrameLogger() },\n        ];\n    }\n\n\n    protected packDependency<T extends A_TYPES__A_DependencyInjectable>(\n        scope: A_Scope,\n        target: A_TYPES__Ctor<T> | T,\n        def: A_TYPES__Ctor<T> | T,\n    ) {\n        const existing = scope.resolve(target as any);\n        if (!existing) scope.register(def);\n    }\n\n\n}","import { A_Concept, A_Context, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_FrameBase } from \"./A-Frame.component\";\nimport { A_FrameIndex } from \"../A-FrameIndex\";\nimport { A_FrameStorage } from \"../A-FrameStorage/A-FrameStorage.component\";\nimport { A_FrameChannel } from \"../A-FrameChannel/A-FrameChannel.component\";\nimport { A_FrameContext } from \"./A-Frame.context\";\nimport { A_FrameNodeChannel } from \"../A-FrameChannel/A-FrameChannel.component.env-node\";\nimport { A_FrameNodeStorage } from \"../A-FrameStorage/node/A-FrameNodeStorage.component\";\nimport { A_FrameEnv } from \"../A-FrameEnv/A-FrameEnv.fragment.env-node\";\nimport { A_FrameStorageCodec } from \"../A-FrameStorage/A-FrameStorage.codec\";\nimport { A_FrameCrypto } from \"../A-FrameCrypto/A-FrameCrypto.component.env-node\";\nimport { A_FrameLogger } from \"../A-FrameLogger/A-FrameLogger.component.env-node\";\n\n\n\nexport class A_Frame extends A_FrameBase {\n\n    @A_Concept.Load()\n    async injectDependencies(\n    ) {\n\n        const index = new A_FrameIndex();\n        index.inherit(A_Context.root);\n\n\n        A_Context.root.register(index);\n        A_Context.root.register(new A_FrameEnv());\n        A_Context.root.register(new A_FrameStorageCodec());\n        A_Context.root.register(A_FrameNodeStorage)\n        A_Context.root.register(A_FrameNodeChannel);\n        A_Context.root.register(A_FrameCrypto)\n        A_Context.root.register(new A_FrameLogger());\n        A_Context.root.register(A_Frame);\n        A_Context.root.register(new A_FrameContext());\n    }\n\n\n    @A_Concept.Load()\n    async load(\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(A_FrameIndex) index: A_FrameIndex,\n        @A_Inject(A_FrameStorage) storage: A_FrameStorage,\n        @A_Inject(A_FrameContext) context: A_FrameContext,\n        @A_Inject(A_FrameChannel) channel: A_FrameChannel,\n        @A_Inject(A_FrameEnv) env: A_FrameEnv,\n    ) {\n        // 1. Authenticate — required before any storage or embedding operations\n        const credentials = await channel.getCredentials();\n        context.setCredentials(credentials);\n\n        const definedNameSpaces = index.listNamespaces();\n        const definedDefinitions = index.listDefinitions();\n\n        // 2. Hydrate all from storage in parallel.\n        //    Storage load only calls fromJSON when hash AND aFrameServerVersion match,\n        //    so items with a stale/missing cache remain un-embedded (isEmbed === false).\n        await Promise.all([\n            ...definedNameSpaces.map(ns => ns.load()),\n            ...definedDefinitions.map(def => def.load()),\n        ]);\n\n        // 3. Skip embedding API calls entirely when sync is disabled\n        if (!env.A_FRAME_SYNC) return;\n\n        // 4. Re-embed and persist items whose cache is missing or stale\n        const namespacesNeedEmbed = definedNameSpaces.filter(ns => !ns.isEmbed\n            || (ns.aFrameServerVersion !== context.serverVersion)\n            || (ns.aFrameVersion !== env.A_FRAME_VERSION) // re-embed if the client version has changed since last embed, as it may affect embedding results\n        );\n        const definitionsNeedEmbed = definedDefinitions.filter(def => !def.isEmbed\n            || (def.aFrameServerVersion !== context.serverVersion)\n            || (def.aFrameVersion !== env.A_FRAME_VERSION) // re-embed if the client version has changed since last embed, as it may affect embedding results\n        );\n\n        for (const batch of this.chunkArray(namespacesNeedEmbed, 10)) {\n            // Embed in parallel — each namespace hits its own API call independently\n            await Promise.all(batch.map(ns => ns.embed()));\n            // Save sequentially — all namespaces write to the same __namespaces.aframe file;\n            // parallel writes would race and the last writer would overwrite the others\n            for (const ns of batch) {\n                await ns.save();\n            }\n        }\n\n        for (const batch of this.chunkArray(definitionsNeedEmbed, 10)) {\n            // Embed in parallel — each definition hits its own API call independently\n            await Promise.all(batch.map(def => def.embed()));\n            // Save sequentially within a namespace — definitions in the same namespace share\n            // one file; parallel writes would race and overwrite each other's records\n            for (const def of batch) {\n                await def.save();\n            }\n        }\n    }\n\n\n    chunkArray<T>(array: T[], size: number): T[][] {\n        const result: T[][] = [];\n        for (let i = 0; i < array.length; i += size) {\n            result.push(array.slice(i, i + size));\n        }\n        return result;\n    }\n\n}\n"]}

package/dist/node/core.d.mts

@@ -0,0 +1,76 @@
+import { A_Component, A_TYPES__Component_Constructor, A_TYPES__Fragment_Constructor, A_TYPES__A_DependencyInjectable, A_Scope, A_TYPES__Ctor, A_Error } from '@adaas/a-concept';
+import { d as A_FrameDefineOptions, e as A_FrameNamespaceOptions, f as A_FrameDecoratorTarget, g as A_FrameDecoratorDescriptor } from './A-FrameDefinition.entity-DWGN_Ujr.mjs';
+export { h as A_FrameDecoratorMeta, i as A_FrameIndexMetaMethodMeta, j as A_FrameIndexMetaType, k as A_FrameMetaTarget, l as A_FrameNamespaceDecoratorDescriptor, m as A_FrameNamespaceDecoratorTarget, n as A_FrameOptions, o as A_FrameTargetType } from './A-FrameDefinition.entity-DWGN_Ujr.mjs';
+import { A as A_FrameStorage, a as A_FrameContext } from './A-FrameStorage.component-BYjHfHJJ.mjs';
+import { A_FrameIndexTarget, A_FrameIndex } from './frame-index.mjs';
+import { A as A_FrameChannel } from './A-FrameChannel.component-NNKcFViw.mjs';
+import { A_FrameEnv } from './env.mjs';
+import './A-FrameNamespace.entity-rCm1AavP.mjs';
+import './vector.mjs';
+import './A-FrameChannel.types-DQF-IiRq.mjs';
+import './A-FrameDynamicStructure.entity-DaBgSRCR.mjs';
+
+declare class A_FrameBase extends A_Component {
+    /**
+     * Primary Decorator to define and index components, containers, entities, fragments and methods in the A-Frame Index structure
+     *
+     * Those components will participate in AI indexing and retrieval strategy, so they can be used in the better way to build new features and components.
+     *
+     * @param options
+     * @returns
+     */
+    static Define(options: A_FrameDefineOptions): ClassDecorator & MethodDecorator;
+    /**
+     * Allows to define a namespace for grouping related components, containers, entities, fragments and methods together in the A-Frame Index structure. This is useful for better organization and retrieval strategy.
+     *
+     * @param options
+     * @returns
+     */
+    static NameSpace(options: A_FrameNamespaceOptions): ClassDecorator & MethodDecorator;
+    /**
+     * Default per-instance dependencies registered on first build. The blob
+     * store is intentionally omitted here — the user is expected to seed and
+     * register `A_FrameBrowserStorageBlobs` themselves (typically via
+     * `A_FrameBrowserStorageBlobs.fromBundle(bundle)` before `concept.load()`).
+     * If they don't, `A_FrameBrowserStorageProvider.onLoad()` falls back to the
+     * empty singleton.
+     */
+    get package(): Array<{
+        ctor: A_TYPES__Component_Constructor<any> | A_TYPES__Fragment_Constructor<any>;
+        instance: any;
+    }>;
+    protected packDependency<T extends A_TYPES__A_DependencyInjectable>(scope: A_Scope, target: A_TYPES__Ctor<T> | T, def: A_TYPES__Ctor<T> | T): void;
+}
+
+declare class A_FrameError extends A_Error {
+    static readonly InvalidTarget = "A-Frame Index Invalid Target Error";
+    static readonly InvalidConfiguration = "A-Frame Index Invalid Configuration Error";
+    static readonly IndexDefinitionError = "A-Frame Index Definition Error";
+    static readonly IndexMetadataError = "A-Frame Index Metadata Error";
+    static readonly IndexRegistryError = "A-Frame Index Registry Error";
+    static readonly IndexComponentNotFoundError = "A-Frame Index Component Not Found Error";
+}
+
+declare class A_FrameTypeGuard {
+    /**
+     * Determines if the target is an allowed type for indexing
+     *
+     * @param target
+     * @returns
+     */
+    static isAllowedTarget(target: any): target is A_FrameDecoratorTarget;
+    static getTargetName(target: A_FrameDecoratorTarget): string;
+    static getTargetConstructor(target: A_FrameDecoratorTarget): A_FrameIndexTarget;
+}
+
+declare function A_FrameDefineDecorator(config: A_FrameDefineOptions): (target: A_FrameDecoratorTarget, propertyKey?: string | symbol, descriptor?: A_FrameDecoratorDescriptor) => any;
+
+declare function A_FrameNamespaceDecorator(config?: Partial<A_FrameNamespaceOptions>): (target: A_FrameDecoratorTarget, propertyKey?: string | symbol, descriptor?: A_FrameDecoratorDescriptor) => any;
+
+declare class A_Frame extends A_FrameBase {
+    injectDependencies(): Promise<void>;
+    load(scope: A_Scope, index: A_FrameIndex, storage: A_FrameStorage, context: A_FrameContext, channel: A_FrameChannel, env: A_FrameEnv): Promise<void>;
+    chunkArray<T>(array: T[], size: number): T[][];
+}
+
+export { A_Frame, A_FrameBase, A_FrameContext, A_FrameDecoratorDescriptor, A_FrameDecoratorTarget, A_FrameDefineDecorator, A_FrameDefineOptions, A_FrameError, A_FrameNamespaceDecorator, A_FrameNamespaceOptions, A_FrameTypeGuard };

package/dist/node/core.d.ts

@@ -0,0 +1,76 @@
+import { A_Component, A_TYPES__Component_Constructor, A_TYPES__Fragment_Constructor, A_TYPES__A_DependencyInjectable, A_Scope, A_TYPES__Ctor, A_Error } from '@adaas/a-concept';
+import { d as A_FrameDefineOptions, e as A_FrameNamespaceOptions, f as A_FrameDecoratorTarget, g as A_FrameDecoratorDescriptor } from './A-FrameDefinition.entity-CAUOdEvU.js';
+export { h as A_FrameDecoratorMeta, i as A_FrameIndexMetaMethodMeta, j as A_FrameIndexMetaType, k as A_FrameMetaTarget, l as A_FrameNamespaceDecoratorDescriptor, m as A_FrameNamespaceDecoratorTarget, n as A_FrameOptions, o as A_FrameTargetType } from './A-FrameDefinition.entity-CAUOdEvU.js';
+import { A as A_FrameStorage, a as A_FrameContext } from './A-FrameStorage.component-CT01fs-t.js';
+import { A_FrameIndexTarget, A_FrameIndex } from './frame-index.js';
+import { A as A_FrameChannel } from './A-FrameChannel.component-BfBcs734.js';
+import { A_FrameEnv } from './env.js';
+import './A-FrameNamespace.entity-D3fZBGDx.js';
+import './vector.js';
+import './A-FrameChannel.types-DQF-IiRq.js';
+import './A-FrameDynamicStructure.entity-DaBgSRCR.js';
+
+declare class A_FrameBase extends A_Component {
+    /**
+     * Primary Decorator to define and index components, containers, entities, fragments and methods in the A-Frame Index structure
+     *
+     * Those components will participate in AI indexing and retrieval strategy, so they can be used in the better way to build new features and components.
+     *
+     * @param options
+     * @returns
+     */
+    static Define(options: A_FrameDefineOptions): ClassDecorator & MethodDecorator;
+    /**
+     * Allows to define a namespace for grouping related components, containers, entities, fragments and methods together in the A-Frame Index structure. This is useful for better organization and retrieval strategy.
+     *
+     * @param options
+     * @returns
+     */
+    static NameSpace(options: A_FrameNamespaceOptions): ClassDecorator & MethodDecorator;
+    /**
+     * Default per-instance dependencies registered on first build. The blob
+     * store is intentionally omitted here — the user is expected to seed and
+     * register `A_FrameBrowserStorageBlobs` themselves (typically via
+     * `A_FrameBrowserStorageBlobs.fromBundle(bundle)` before `concept.load()`).
+     * If they don't, `A_FrameBrowserStorageProvider.onLoad()` falls back to the
+     * empty singleton.
+     */
+    get package(): Array<{
+        ctor: A_TYPES__Component_Constructor<any> | A_TYPES__Fragment_Constructor<any>;
+        instance: any;
+    }>;
+    protected packDependency<T extends A_TYPES__A_DependencyInjectable>(scope: A_Scope, target: A_TYPES__Ctor<T> | T, def: A_TYPES__Ctor<T> | T): void;
+}
+
+declare class A_FrameError extends A_Error {
+    static readonly InvalidTarget = "A-Frame Index Invalid Target Error";
+    static readonly InvalidConfiguration = "A-Frame Index Invalid Configuration Error";
+    static readonly IndexDefinitionError = "A-Frame Index Definition Error";
+    static readonly IndexMetadataError = "A-Frame Index Metadata Error";
+    static readonly IndexRegistryError = "A-Frame Index Registry Error";
+    static readonly IndexComponentNotFoundError = "A-Frame Index Component Not Found Error";
+}
+
+declare class A_FrameTypeGuard {
+    /**
+     * Determines if the target is an allowed type for indexing
+     *
+     * @param target
+     * @returns
+     */
+    static isAllowedTarget(target: any): target is A_FrameDecoratorTarget;
+    static getTargetName(target: A_FrameDecoratorTarget): string;
+    static getTargetConstructor(target: A_FrameDecoratorTarget): A_FrameIndexTarget;
+}
+
+declare function A_FrameDefineDecorator(config: A_FrameDefineOptions): (target: A_FrameDecoratorTarget, propertyKey?: string | symbol, descriptor?: A_FrameDecoratorDescriptor) => any;
+
+declare function A_FrameNamespaceDecorator(config?: Partial<A_FrameNamespaceOptions>): (target: A_FrameDecoratorTarget, propertyKey?: string | symbol, descriptor?: A_FrameDecoratorDescriptor) => any;
+
+declare class A_Frame extends A_FrameBase {
+    injectDependencies(): Promise<void>;
+    load(scope: A_Scope, index: A_FrameIndex, storage: A_FrameStorage, context: A_FrameContext, channel: A_FrameChannel, env: A_FrameEnv): Promise<void>;
+    chunkArray<T>(array: T[], size: number): T[][];
+}
+
+export { A_Frame, A_FrameBase, A_FrameContext, A_FrameDecoratorDescriptor, A_FrameDecoratorTarget, A_FrameDefineDecorator, A_FrameDefineOptions, A_FrameError, A_FrameNamespaceDecorator, A_FrameNamespaceOptions, A_FrameTypeGuard };