@adaas/a-frame 0.0.21 → 0.0.23

package/dist/node/dynamic-structure.cjs

@@ -0,0 +1,143 @@
+'use strict';
+
+require('./chunk-QFHZIG7Y.cjs');
+var aConcept = require('@adaas/a-concept');
+
+// src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.constants.ts
+var A_FrameDynamicStructureFeatures = {
+  Load: "_A_FRAME_DYNAMIC_STRUCTURE_LOAD",
+  Update: "_A_FRAME_DYNAMIC_STRUCTURE_UPDATE",
+  Generate: "_A_FRAME_DYNAMIC_STRUCTURE_GENERATE"
+};
+var A_FrameDynamicStructureEvents = {
+  Updated: "_A_FRAME_DYNAMIC_STRUCTURE_UPDATED"
+};
+var A_FrameDynamicStructure = class extends aConcept.A_Entity {
+  constructor() {
+    super(...arguments);
+    this._version = 0;
+  }
+  static get concept() {
+    return "a-frame";
+  }
+  fromNew(options) {
+    this.createdAt = Date.now();
+    this._components = [];
+    this._history = [];
+    this._version = 0;
+    this.listeners = /* @__PURE__ */ new Map();
+    this.prompt = options.prompt;
+    this.model = options.model;
+    this.context = options.context ?? "generic";
+    this.metaHint = options.metaHint ?? "";
+    this.includeBases = (options.includeBases || []).map((b) => typeof b === "string" ? b : aConcept.A_CommonHelper.getComponentName(b));
+    this.excludeBases = (options.excludeBases || []).map((b) => typeof b === "string" ? b : aConcept.A_CommonHelper.getComponentName(b));
+    this.enabledComponents = (options.enabledComponents || []).map((b) => typeof b === "string" ? b : aConcept.A_CommonHelper.getComponentName(b));
+  }
+  // ── Public read-only accessors ───────────────────────────────────────────────
+  /** The current resolved component list (output of the last generate or patch). */
+  get components() {
+    return this._components;
+  }
+  /** Immutable patch history. */
+  get history() {
+    return this._history;
+  }
+  /** Current schema version (increments with each patch). */
+  get version() {
+    return this._version;
+  }
+  // ── Main pipeline ────────────────────────────────────────────────────────────
+  /**
+   * Run the full generation pipeline:
+   *   content generation → structure mapping → encode → patch
+   *
+   * @returns The resolved component list.
+   */
+  async generate() {
+  }
+  async patch(prompt) {
+    this._version++;
+  }
+  /**
+   * Restore the component list to a specific version from history.
+   * Creates a new patch entry so the revert itself is tracked.
+   */
+  revertTo(version) {
+    return this;
+  }
+  // ── Serialisation ─────────────────────────────────────────────────────────────
+  // /**
+  //  * Encode the complete DynamicStructure state to an opaque base64 string.
+  //  * Suitable for storage, transport, or embedding in another system.
+  //  */
+  // serialize(): string {
+  //     const payload: SerializedDynamicStructure = {
+  //         id: this.id,
+  //         version: this._version,
+  //         prompt: this.prompt,
+  //         components: [...this._components],
+  //         history: this._history.map(({ version, timestamp, reason }) => ({
+  //             version,
+  //             timestamp,
+  //             reason,
+  //         })),
+  //     };
+  //     return encode(payload);
+  // }
+  // /**
+  //  * Decode a serialised string back to its raw payload.
+  //  * Note: this is a static factory that returns the data only —
+  //  * it does not reconstruct a live DynamicStructure instance.
+  //  *
+  //  * To reconstruct a live instance, create a new DynamicStructure and
+  //  * call .patch() with the decoded components.
+  //  */
+  // static deserialize(encoded: string): SerializedDynamicStructure {
+  //     return decode<SerializedDynamicStructure>(encoded);
+  // }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      name: this.prompt,
+      description: `DynamicStructure with ${this._components.length} components and ${this._history.length} patches`,
+      metadata: {
+        model: this.model,
+        context: this.context,
+        metaHint: this.metaHint,
+        includeBases: this.includeBases,
+        excludeBases: this.excludeBases,
+        enabledComponents: this.enabledComponents,
+        createdAt: this.createdAt
+      },
+      history: this._history.map((item) => item.toJSON())
+    };
+  }
+  // ── Internals ──────────────────────────────────────────────────────────────
+  subscribe(feature, listener) {
+    if (!this.listeners.has(feature)) {
+      this.listeners.set(feature, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(feature).add(listener);
+  }
+  unsubscribe(feature, listener) {
+    this.listeners.get(feature)?.delete(listener);
+  }
+  emit(stage, context) {
+    this.listeners.get(stage)?.forEach((listener) => listener(context));
+  }
+};
+var A_FrameDynamicStructureError = class extends aConcept.A_Error {
+};
+A_FrameDynamicStructureError.InvalidPatch = "InvalidPatch";
+A_FrameDynamicStructureError.VersionMismatch = "VersionMismatch";
+A_FrameDynamicStructureError.ComponentNotFound = "ComponentNotFound";
+A_FrameDynamicStructureError.InvalidOperation = "InvalidOperation";
+A_FrameDynamicStructureError.GenerationFailed = "GenerationFailed";
+
+exports.A_FrameDynamicStructure = A_FrameDynamicStructure;
+exports.A_FrameDynamicStructureError = A_FrameDynamicStructureError;
+exports.A_FrameDynamicStructureEvents = A_FrameDynamicStructureEvents;
+exports.A_FrameDynamicStructureFeatures = A_FrameDynamicStructureFeatures;
+//# sourceMappingURL=dynamic-structure.cjs.map
+//# sourceMappingURL=dynamic-structure.cjs.map

package/dist/node/dynamic-structure.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.constants.ts","../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.entity.ts","../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.error.ts"],"names":["A_Entity","A_CommonHelper","A_Error"],"mappings":"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","file":"dynamic-structure.cjs","sourcesContent":["\n\n\nexport const A_FrameDynamicStructureFeatures = {\n    Load: '_A_FRAME_DYNAMIC_STRUCTURE_LOAD',\n    Update: '_A_FRAME_DYNAMIC_STRUCTURE_UPDATE',\n    Generate: '_A_FRAME_DYNAMIC_STRUCTURE_GENERATE',\n} as const;\n\n\nexport const A_FrameDynamicStructureEvents = {\n    Updated: '_A_FRAME_DYNAMIC_STRUCTURE_UPDATED',\n} as const;","import { A_CommonHelper, A_Context, A_Entity, A_Scope, A_TYPES__A_DependencyInjectable } from \"@adaas/a-concept\";\nimport { A_FrameDynamicStructure_Init, A_FrameDynamicStructure_Serialized, A_FrameDynamicStructureEventNames, A_FrameDynamicStructureListener, A_FrameDynamicStructureResolvedComponent } from \"./A-FrameDynamicStructure.types\";\nimport { A_FrameDynamicStructureFeatures } from \"./A-FrameDynamicStructure.constants\";\nimport { A_FrameDynamicPatch } from \"../A-FrameDynamicPatch/A-FrameDynamicPatch.entity\";\nimport { A_FrameDynamicStructureError } from \"./A-FrameDynamicStructure.error\";\n\n\n\nexport class A_FrameDynamicStructure extends A_Entity<A_FrameDynamicStructure_Init, A_FrameDynamicStructure_Serialized> {\n    \n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    // ── Identity ────────────────────────────────────────────────────────────────\n    prompt!: string;\n    createdAt!: number;\n\n    // ── Config ──────────────────────────────────────────────────────────────────\n    private model!: string;\n    private context!: string;\n    private metaHint!: string;\n    private includeBases!: string[];\n    private excludeBases!: string[];\n    private enabledComponents!: string[];\n    // ── State ───────────────────────────────────────────────────────────────────\n    private _components!: A_FrameDynamicStructureResolvedComponent[]\n    private _history!: A_FrameDynamicPatch[]\n    private _version = 0;\n\n    private listeners!: Map<string, Set<A_FrameDynamicStructureListener>>;\n\n    fromNew(options: A_FrameDynamicStructure_Init) {\n        this.createdAt = Date.now();\n\n        this._components = [];\n        this._history = [];\n        this._version = 0;\n\n        this.listeners = new Map();\n\n        this.prompt = options.prompt;\n        this.model = options.model;\n        this.context = options.context ?? 'generic';\n        this.metaHint = options.metaHint ?? '';\n        this.includeBases = (options.includeBases || []).map((b) => typeof b === 'string' ? b : A_CommonHelper.getComponentName(b));\n        this.excludeBases = (options.excludeBases || []).map((b) => typeof b === 'string' ? b : A_CommonHelper.getComponentName(b));\n        this.enabledComponents = (options.enabledComponents || []).map((b) => typeof b === 'string' ? b : A_CommonHelper.getComponentName(b));\n    }\n\n    // ── Public read-only accessors ───────────────────────────────────────────────\n\n    /** The current resolved component list (output of the last generate or patch). */\n    get components(): ReadonlyArray<A_FrameDynamicStructureResolvedComponent> {\n        return this._components;\n    }\n\n    /** Immutable patch history. */\n    get history(): ReadonlyArray<A_FrameDynamicPatch> {\n        return this._history;\n    }\n\n    /** Current schema version (increments with each patch). */\n    get version(): number {\n        return this._version;\n    }\n\n\n    // ── Main pipeline ────────────────────────────────────────────────────────────\n\n    /**\n     * Run the full generation pipeline:\n     *   content generation → structure mapping → encode → patch\n     *\n     * @returns The resolved component list.\n     */\n    async generate(): Promise<void> {\n        // const context = new A_FrameDynamicStructureOperation();\n\n        // const executionScope = new A_Scope({\n        //     name: 'a-frame-dynamic-structure-generate',\n        //     fragments: [context],\n        // })\n        //     .inherit(A_Context.scope(this));\n\n        // try {\n\n        //     await this.call(A_FrameDynamicStructureFeatures.Generate, executionScope);\n\n        //     executionScope.destroy();\n\n        //     return context;\n\n        // } catch (err) {\n        //     executionScope.destroy();\n        //     throw new A_FrameDynamicStructureError({\n        //         title: A_FrameDynamicStructureError.GenerationFailed,\n        //         description: `Failed to generate structure: ${err instanceof Error ? err.message : String(err)}`,\n        //     });\n        // }\n    }\n\n\n    async patch(prompt: string): Promise<void> {\n        this._version++;\n\n    }\n\n    /**\n     * Restore the component list to a specific version from history.\n     * Creates a new patch entry so the revert itself is tracked.\n     */\n    revertTo(version: number): this {\n        // this._currentVersion = version;\n\n        return this;\n    }\n\n    // ── Serialisation ─────────────────────────────────────────────────────────────\n\n    // /**\n    //  * Encode the complete DynamicStructure state to an opaque base64 string.\n    //  * Suitable for storage, transport, or embedding in another system.\n    //  */\n    // serialize(): string {\n    //     const payload: SerializedDynamicStructure = {\n    //         id: this.id,\n    //         version: this._version,\n    //         prompt: this.prompt,\n    //         components: [...this._components],\n    //         history: this._history.map(({ version, timestamp, reason }) => ({\n    //             version,\n    //             timestamp,\n    //             reason,\n    //         })),\n    //     };\n    //     return encode(payload);\n    // }\n\n    // /**\n    //  * Decode a serialised string back to its raw payload.\n    //  * Note: this is a static factory that returns the data only —\n    //  * it does not reconstruct a live DynamicStructure instance.\n    //  *\n    //  * To reconstruct a live instance, create a new DynamicStructure and\n    //  * call .patch() with the decoded components.\n    //  */\n    // static deserialize(encoded: string): SerializedDynamicStructure {\n    //     return decode<SerializedDynamicStructure>(encoded);\n    // }\n\n    toJSON(): A_FrameDynamicStructure_Serialized {\n        return {\n            ...super.toJSON(),\n            name: this.prompt,\n            description: `DynamicStructure with ${this._components.length} components and ${this._history.length} patches`,\n            metadata: {\n                model: this.model,\n                context: this.context,\n                metaHint: this.metaHint,\n                includeBases: this.includeBases,\n                excludeBases: this.excludeBases,\n                enabledComponents: this.enabledComponents,\n                createdAt: this.createdAt,\n            },\n            history: this._history.map(item => item.toJSON()),\n        }\n    }\n\n    // ── Internals ──────────────────────────────────────────────────────────────\n    subscribe(feature: A_FrameDynamicStructureEventNames, listener: A_FrameDynamicStructureListener): void {\n        if (!this.listeners.has(feature)) {\n            this.listeners.set(feature, new Set());\n        }\n        this.listeners.get(feature)!.add(listener);\n    }\n\n    unsubscribe(feature: A_FrameDynamicStructureEventNames, listener: A_FrameDynamicStructureListener): void {\n        this.listeners.get(feature)?.delete(listener);\n    }\n\n\n    emit(stage: A_FrameDynamicStructureEventNames, context: any): void {\n        this.listeners.get(stage)?.forEach(listener => listener(context));\n    }\n\n}","import { A_Error } from \"@adaas/a-concept\";\n\n\nexport class A_FrameDynamicStructureError extends A_Error {\n\n    static readonly InvalidPatch = 'InvalidPatch';\n    static readonly VersionMismatch = 'VersionMismatch';\n    static readonly ComponentNotFound = 'ComponentNotFound';\n    static readonly InvalidOperation = 'InvalidOperation';\n\n    static readonly GenerationFailed = 'GenerationFailed';\n   \n}"]}

package/dist/node/dynamic-structure.d.mts

@@ -0,0 +1,12 @@
+export { A as A_FrameDynamicStructure, a as A_FrameDynamicStructureDefinition, b as A_FrameDynamicStructureDefinitionEntity, c as A_FrameDynamicStructureEventNames, d as A_FrameDynamicStructureEvents, e as A_FrameDynamicStructureFeatureNames, f as A_FrameDynamicStructureFeatures, g as A_FrameDynamicStructureListener, h as A_FrameDynamicStructureResolvedComponent, i as A_FrameDynamicStructure_Init, j as A_FrameDynamicStructure_Serialized, B as BaseClassName, D as DynamicStructureDefaultBasesNames } from './A-FrameDynamicStructure.entity-DaBgSRCR.mjs';
+import { A_Error } from '@adaas/a-concept';
+
+declare class A_FrameDynamicStructureError extends A_Error {
+    static readonly InvalidPatch = "InvalidPatch";
+    static readonly VersionMismatch = "VersionMismatch";
+    static readonly ComponentNotFound = "ComponentNotFound";
+    static readonly InvalidOperation = "InvalidOperation";
+    static readonly GenerationFailed = "GenerationFailed";
+}
+
+export { A_FrameDynamicStructureError };

package/dist/node/dynamic-structure.d.ts

@@ -0,0 +1,12 @@
+export { A as A_FrameDynamicStructure, a as A_FrameDynamicStructureDefinition, b as A_FrameDynamicStructureDefinitionEntity, c as A_FrameDynamicStructureEventNames, d as A_FrameDynamicStructureEvents, e as A_FrameDynamicStructureFeatureNames, f as A_FrameDynamicStructureFeatures, g as A_FrameDynamicStructureListener, h as A_FrameDynamicStructureResolvedComponent, i as A_FrameDynamicStructure_Init, j as A_FrameDynamicStructure_Serialized, B as BaseClassName, D as DynamicStructureDefaultBasesNames } from './A-FrameDynamicStructure.entity-DaBgSRCR.js';
+import { A_Error } from '@adaas/a-concept';
+
+declare class A_FrameDynamicStructureError extends A_Error {
+    static readonly InvalidPatch = "InvalidPatch";
+    static readonly VersionMismatch = "VersionMismatch";
+    static readonly ComponentNotFound = "ComponentNotFound";
+    static readonly InvalidOperation = "InvalidOperation";
+    static readonly GenerationFailed = "GenerationFailed";
+}
+
+export { A_FrameDynamicStructureError };

package/dist/node/dynamic-structure.mjs

@@ -0,0 +1,138 @@
+import './chunk-OI76LHVT.mjs';
+import { A_Error, A_Entity, A_CommonHelper } from '@adaas/a-concept';
+
+// src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.constants.ts
+var A_FrameDynamicStructureFeatures = {
+  Load: "_A_FRAME_DYNAMIC_STRUCTURE_LOAD",
+  Update: "_A_FRAME_DYNAMIC_STRUCTURE_UPDATE",
+  Generate: "_A_FRAME_DYNAMIC_STRUCTURE_GENERATE"
+};
+var A_FrameDynamicStructureEvents = {
+  Updated: "_A_FRAME_DYNAMIC_STRUCTURE_UPDATED"
+};
+var A_FrameDynamicStructure = class extends A_Entity {
+  constructor() {
+    super(...arguments);
+    this._version = 0;
+  }
+  static get concept() {
+    return "a-frame";
+  }
+  fromNew(options) {
+    this.createdAt = Date.now();
+    this._components = [];
+    this._history = [];
+    this._version = 0;
+    this.listeners = /* @__PURE__ */ new Map();
+    this.prompt = options.prompt;
+    this.model = options.model;
+    this.context = options.context ?? "generic";
+    this.metaHint = options.metaHint ?? "";
+    this.includeBases = (options.includeBases || []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+    this.excludeBases = (options.excludeBases || []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+    this.enabledComponents = (options.enabledComponents || []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+  }
+  // ── Public read-only accessors ───────────────────────────────────────────────
+  /** The current resolved component list (output of the last generate or patch). */
+  get components() {
+    return this._components;
+  }
+  /** Immutable patch history. */
+  get history() {
+    return this._history;
+  }
+  /** Current schema version (increments with each patch). */
+  get version() {
+    return this._version;
+  }
+  // ── Main pipeline ────────────────────────────────────────────────────────────
+  /**
+   * Run the full generation pipeline:
+   *   content generation → structure mapping → encode → patch
+   *
+   * @returns The resolved component list.
+   */
+  async generate() {
+  }
+  async patch(prompt) {
+    this._version++;
+  }
+  /**
+   * Restore the component list to a specific version from history.
+   * Creates a new patch entry so the revert itself is tracked.
+   */
+  revertTo(version) {
+    return this;
+  }
+  // ── Serialisation ─────────────────────────────────────────────────────────────
+  // /**
+  //  * Encode the complete DynamicStructure state to an opaque base64 string.
+  //  * Suitable for storage, transport, or embedding in another system.
+  //  */
+  // serialize(): string {
+  //     const payload: SerializedDynamicStructure = {
+  //         id: this.id,
+  //         version: this._version,
+  //         prompt: this.prompt,
+  //         components: [...this._components],
+  //         history: this._history.map(({ version, timestamp, reason }) => ({
+  //             version,
+  //             timestamp,
+  //             reason,
+  //         })),
+  //     };
+  //     return encode(payload);
+  // }
+  // /**
+  //  * Decode a serialised string back to its raw payload.
+  //  * Note: this is a static factory that returns the data only —
+  //  * it does not reconstruct a live DynamicStructure instance.
+  //  *
+  //  * To reconstruct a live instance, create a new DynamicStructure and
+  //  * call .patch() with the decoded components.
+  //  */
+  // static deserialize(encoded: string): SerializedDynamicStructure {
+  //     return decode<SerializedDynamicStructure>(encoded);
+  // }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      name: this.prompt,
+      description: `DynamicStructure with ${this._components.length} components and ${this._history.length} patches`,
+      metadata: {
+        model: this.model,
+        context: this.context,
+        metaHint: this.metaHint,
+        includeBases: this.includeBases,
+        excludeBases: this.excludeBases,
+        enabledComponents: this.enabledComponents,
+        createdAt: this.createdAt
+      },
+      history: this._history.map((item) => item.toJSON())
+    };
+  }
+  // ── Internals ──────────────────────────────────────────────────────────────
+  subscribe(feature, listener) {
+    if (!this.listeners.has(feature)) {
+      this.listeners.set(feature, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(feature).add(listener);
+  }
+  unsubscribe(feature, listener) {
+    this.listeners.get(feature)?.delete(listener);
+  }
+  emit(stage, context) {
+    this.listeners.get(stage)?.forEach((listener) => listener(context));
+  }
+};
+var A_FrameDynamicStructureError = class extends A_Error {
+};
+A_FrameDynamicStructureError.InvalidPatch = "InvalidPatch";
+A_FrameDynamicStructureError.VersionMismatch = "VersionMismatch";
+A_FrameDynamicStructureError.ComponentNotFound = "ComponentNotFound";
+A_FrameDynamicStructureError.InvalidOperation = "InvalidOperation";
+A_FrameDynamicStructureError.GenerationFailed = "GenerationFailed";
+
+export { A_FrameDynamicStructure, A_FrameDynamicStructureError, A_FrameDynamicStructureEvents, A_FrameDynamicStructureFeatures };
+//# sourceMappingURL=dynamic-structure.mjs.map
+//# sourceMappingURL=dynamic-structure.mjs.map

package/dist/node/dynamic-structure.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.constants.ts","../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.entity.ts","../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.error.ts"],"names":[],"mappings":"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","file":"dynamic-structure.mjs","sourcesContent":["\n\n\nexport const A_FrameDynamicStructureFeatures = {\n    Load: '_A_FRAME_DYNAMIC_STRUCTURE_LOAD',\n    Update: '_A_FRAME_DYNAMIC_STRUCTURE_UPDATE',\n    Generate: '_A_FRAME_DYNAMIC_STRUCTURE_GENERATE',\n} as const;\n\n\nexport const A_FrameDynamicStructureEvents = {\n    Updated: '_A_FRAME_DYNAMIC_STRUCTURE_UPDATED',\n} as const;","import { A_CommonHelper, A_Context, A_Entity, A_Scope, A_TYPES__A_DependencyInjectable } from \"@adaas/a-concept\";\nimport { A_FrameDynamicStructure_Init, A_FrameDynamicStructure_Serialized, A_FrameDynamicStructureEventNames, A_FrameDynamicStructureListener, A_FrameDynamicStructureResolvedComponent } from \"./A-FrameDynamicStructure.types\";\nimport { A_FrameDynamicStructureFeatures } from \"./A-FrameDynamicStructure.constants\";\nimport { A_FrameDynamicPatch } from \"../A-FrameDynamicPatch/A-FrameDynamicPatch.entity\";\nimport { A_FrameDynamicStructureError } from \"./A-FrameDynamicStructure.error\";\n\n\n\nexport class A_FrameDynamicStructure extends A_Entity<A_FrameDynamicStructure_Init, A_FrameDynamicStructure_Serialized> {\n    \n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    // ── Identity ────────────────────────────────────────────────────────────────\n    prompt!: string;\n    createdAt!: number;\n\n    // ── Config ──────────────────────────────────────────────────────────────────\n    private model!: string;\n    private context!: string;\n    private metaHint!: string;\n    private includeBases!: string[];\n    private excludeBases!: string[];\n    private enabledComponents!: string[];\n    // ── State ───────────────────────────────────────────────────────────────────\n    private _components!: A_FrameDynamicStructureResolvedComponent[]\n    private _history!: A_FrameDynamicPatch[]\n    private _version = 0;\n\n    private listeners!: Map<string, Set<A_FrameDynamicStructureListener>>;\n\n    fromNew(options: A_FrameDynamicStructure_Init) {\n        this.createdAt = Date.now();\n\n        this._components = [];\n        this._history = [];\n        this._version = 0;\n\n        this.listeners = new Map();\n\n        this.prompt = options.prompt;\n        this.model = options.model;\n        this.context = options.context ?? 'generic';\n        this.metaHint = options.metaHint ?? '';\n        this.includeBases = (options.includeBases || []).map((b) => typeof b === 'string' ? b : A_CommonHelper.getComponentName(b));\n        this.excludeBases = (options.excludeBases || []).map((b) => typeof b === 'string' ? b : A_CommonHelper.getComponentName(b));\n        this.enabledComponents = (options.enabledComponents || []).map((b) => typeof b === 'string' ? b : A_CommonHelper.getComponentName(b));\n    }\n\n    // ── Public read-only accessors ───────────────────────────────────────────────\n\n    /** The current resolved component list (output of the last generate or patch). */\n    get components(): ReadonlyArray<A_FrameDynamicStructureResolvedComponent> {\n        return this._components;\n    }\n\n    /** Immutable patch history. */\n    get history(): ReadonlyArray<A_FrameDynamicPatch> {\n        return this._history;\n    }\n\n    /** Current schema version (increments with each patch). */\n    get version(): number {\n        return this._version;\n    }\n\n\n    // ── Main pipeline ────────────────────────────────────────────────────────────\n\n    /**\n     * Run the full generation pipeline:\n     *   content generation → structure mapping → encode → patch\n     *\n     * @returns The resolved component list.\n     */\n    async generate(): Promise<void> {\n        // const context = new A_FrameDynamicStructureOperation();\n\n        // const executionScope = new A_Scope({\n        //     name: 'a-frame-dynamic-structure-generate',\n        //     fragments: [context],\n        // })\n        //     .inherit(A_Context.scope(this));\n\n        // try {\n\n        //     await this.call(A_FrameDynamicStructureFeatures.Generate, executionScope);\n\n        //     executionScope.destroy();\n\n        //     return context;\n\n        // } catch (err) {\n        //     executionScope.destroy();\n        //     throw new A_FrameDynamicStructureError({\n        //         title: A_FrameDynamicStructureError.GenerationFailed,\n        //         description: `Failed to generate structure: ${err instanceof Error ? err.message : String(err)}`,\n        //     });\n        // }\n    }\n\n\n    async patch(prompt: string): Promise<void> {\n        this._version++;\n\n    }\n\n    /**\n     * Restore the component list to a specific version from history.\n     * Creates a new patch entry so the revert itself is tracked.\n     */\n    revertTo(version: number): this {\n        // this._currentVersion = version;\n\n        return this;\n    }\n\n    // ── Serialisation ─────────────────────────────────────────────────────────────\n\n    // /**\n    //  * Encode the complete DynamicStructure state to an opaque base64 string.\n    //  * Suitable for storage, transport, or embedding in another system.\n    //  */\n    // serialize(): string {\n    //     const payload: SerializedDynamicStructure = {\n    //         id: this.id,\n    //         version: this._version,\n    //         prompt: this.prompt,\n    //         components: [...this._components],\n    //         history: this._history.map(({ version, timestamp, reason }) => ({\n    //             version,\n    //             timestamp,\n    //             reason,\n    //         })),\n    //     };\n    //     return encode(payload);\n    // }\n\n    // /**\n    //  * Decode a serialised string back to its raw payload.\n    //  * Note: this is a static factory that returns the data only —\n    //  * it does not reconstruct a live DynamicStructure instance.\n    //  *\n    //  * To reconstruct a live instance, create a new DynamicStructure and\n    //  * call .patch() with the decoded components.\n    //  */\n    // static deserialize(encoded: string): SerializedDynamicStructure {\n    //     return decode<SerializedDynamicStructure>(encoded);\n    // }\n\n    toJSON(): A_FrameDynamicStructure_Serialized {\n        return {\n            ...super.toJSON(),\n            name: this.prompt,\n            description: `DynamicStructure with ${this._components.length} components and ${this._history.length} patches`,\n            metadata: {\n                model: this.model,\n                context: this.context,\n                metaHint: this.metaHint,\n                includeBases: this.includeBases,\n                excludeBases: this.excludeBases,\n                enabledComponents: this.enabledComponents,\n                createdAt: this.createdAt,\n            },\n            history: this._history.map(item => item.toJSON()),\n        }\n    }\n\n    // ── Internals ──────────────────────────────────────────────────────────────\n    subscribe(feature: A_FrameDynamicStructureEventNames, listener: A_FrameDynamicStructureListener): void {\n        if (!this.listeners.has(feature)) {\n            this.listeners.set(feature, new Set());\n        }\n        this.listeners.get(feature)!.add(listener);\n    }\n\n    unsubscribe(feature: A_FrameDynamicStructureEventNames, listener: A_FrameDynamicStructureListener): void {\n        this.listeners.get(feature)?.delete(listener);\n    }\n\n\n    emit(stage: A_FrameDynamicStructureEventNames, context: any): void {\n        this.listeners.get(stage)?.forEach(listener => listener(context));\n    }\n\n}","import { A_Error } from \"@adaas/a-concept\";\n\n\nexport class A_FrameDynamicStructureError extends A_Error {\n\n    static readonly InvalidPatch = 'InvalidPatch';\n    static readonly VersionMismatch = 'VersionMismatch';\n    static readonly ComponentNotFound = 'ComponentNotFound';\n    static readonly InvalidOperation = 'InvalidOperation';\n\n    static readonly GenerationFailed = 'GenerationFailed';\n   \n}"]}

package/dist/node/env.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+var chunkB7ZDJXD3_cjs = require('./chunk-B7ZDJXD3.cjs');
+require('./chunk-3LOMGNWA.cjs');
+require('./chunk-QFHZIG7Y.cjs');
+
+
+
+Object.defineProperty(exports, "A_FrameEnv", {
+  enumerable: true,
+  get: function () { return chunkB7ZDJXD3_cjs.A_FrameEnv; }
+});
+//# sourceMappingURL=env.cjs.map
+//# sourceMappingURL=env.cjs.map

package/dist/node/env.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"env.cjs"}

package/dist/node/env.d.mts

@@ -0,0 +1,22 @@
+import { A_Fragment } from '@adaas/a-concept';
+
+interface IA_FrameEnv {
+    A_FRAME_TOKEN: string;
+    A_FRAME_SERVER_URL: string;
+    A_FRAME_SERVER_API_KEY: string;
+    A_FRAME_STORAGE_DIR: string;
+    A_FRAME_VERSION: string;
+}
+
+declare class A_FrameEnv extends A_Fragment implements IA_FrameEnv {
+    get A_FRAME_FILE_EXTENSION(): string;
+    get A_FRAME_NAMESPACES_BIN(): string;
+    get A_FRAME_SYNC(): boolean;
+    get A_FRAME_TOKEN(): string;
+    get A_FRAME_SERVER_URL(): string;
+    get A_FRAME_SERVER_API_KEY(): string;
+    get A_FRAME_STORAGE_DIR(): string;
+    get A_FRAME_VERSION(): string;
+}
+
+export { A_FrameEnv };

package/dist/node/env.d.ts

@@ -0,0 +1,22 @@
+import { A_Fragment } from '@adaas/a-concept';
+
+interface IA_FrameEnv {
+    A_FRAME_TOKEN: string;
+    A_FRAME_SERVER_URL: string;
+    A_FRAME_SERVER_API_KEY: string;
+    A_FRAME_STORAGE_DIR: string;
+    A_FRAME_VERSION: string;
+}
+
+declare class A_FrameEnv extends A_Fragment implements IA_FrameEnv {
+    get A_FRAME_FILE_EXTENSION(): string;
+    get A_FRAME_NAMESPACES_BIN(): string;
+    get A_FRAME_SYNC(): boolean;
+    get A_FRAME_TOKEN(): string;
+    get A_FRAME_SERVER_URL(): string;
+    get A_FRAME_SERVER_API_KEY(): string;
+    get A_FRAME_STORAGE_DIR(): string;
+    get A_FRAME_VERSION(): string;
+}
+
+export { A_FrameEnv };

package/dist/node/env.mjs

@@ -0,0 +1,5 @@
+export { A_FrameEnv } from './chunk-JQBYDEMW.mjs';
+import './chunk-TO4BPKCY.mjs';
+import './chunk-OI76LHVT.mjs';
+//# sourceMappingURL=env.mjs.map
+//# sourceMappingURL=env.mjs.map

package/dist/node/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"env.mjs"}

package/dist/node/frame-index.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunkRRLTGGM7_cjs = require('./chunk-RRLTGGM7.cjs');
+require('./chunk-KLG6HKFU.cjs');
+require('./chunk-ZM2RLVVH.cjs');
+require('./chunk-YWWGJ6EJ.cjs');
+require('./chunk-QFHZIG7Y.cjs');
+
+
+
+Object.defineProperty(exports, "A_FrameIndex", {
+  enumerable: true,
+  get: function () { return chunkRRLTGGM7_cjs.A_FrameIndex; }
+});
+//# sourceMappingURL=frame-index.cjs.map
+//# sourceMappingURL=frame-index.cjs.map

package/dist/node/frame-index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"frame-index.cjs"}

package/dist/node/frame-index.d.mts

@@ -0,0 +1,95 @@
+import { A_TYPES__Container_Constructor, A_TYPES__Entity_Constructor, A_TYPES__Component_Constructor, A_TYPES__Fragment_Constructor, A_Fragment, A_Scope, ASEID } from '@adaas/a-concept';
+import { A_FrameVector } from './vector.mjs';
+import { A as A_FrameNamespace } from './A-FrameNamespace.entity-rCm1AavP.mjs';
+import { A as A_FrameDefinition, o as A_FrameTargetType } from './A-FrameDefinition.entity-DWGN_Ujr.mjs';
+
+type A_FrameIndexTarget = A_TYPES__Container_Constructor | A_TYPES__Entity_Constructor | A_TYPES__Component_Constructor | A_TYPES__Fragment_Constructor;
+type A_FrameMetaDefinition<T extends Record<string, any> = {}> = {
+    name: string;
+    hash: string;
+    source: string;
+    type: A_FrameTargetType;
+    namespace?: string | A_FrameNamespace;
+    description?: string;
+    metadata?: T;
+    examples?: string[];
+};
+type A_FrameIndexMetaType = {
+    namespaces: string;
+    descriptions: string;
+    type: string;
+    name: string;
+    methods: Map<string, A_FrameIndexMetaMethodMeta>;
+};
+type A_FrameIndexMetaMethodMeta = {
+    name: string;
+    description?: string;
+    methodName: string;
+};
+type A_FrameSearchOptions = {
+    /** Maximum number of results; default 10 */
+    topK?: number;
+    /** Restrict search to a single namespace; undefined = all */
+    namespace?: string;
+    /** Minimum cosine similarity score (0–1); default 0 */
+    minScore?: number;
+};
+type A_FrameDefinition_SearchResult = {
+    record: A_FrameDefinition;
+    score: number;
+};
+
+declare class A_FrameIndex extends A_Fragment {
+    private static _instance;
+    static get instance(): A_FrameIndex;
+    static get indexSize(): number;
+    static inherit(scope: A_Scope): void;
+    static addDefinition(def: A_FrameDefinition): void;
+    static getDefinition(nameOrHash: string): A_FrameDefinition | undefined;
+    static listDefinitions(filter: {
+        namespace?: string | A_FrameNamespace;
+    }): A_FrameDefinition[];
+    static removeDefinition(def: A_FrameDefinition): void;
+    static addNamespace(namespace: A_FrameNamespace): void;
+    static getDefaultNamespace(): A_FrameNamespace;
+    static getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined;
+    static listNamespaces(): A_FrameNamespace[];
+    static removeNamespace(namespace: A_FrameNamespace): void;
+    static search(vector: A_FrameVector, options?: A_FrameSearchOptions): A_FrameDefinition_SearchResult[];
+    private definitions;
+    private namespaces;
+    private _index;
+    /**
+     * Scope where all definitions and namespaces are registered as dependencies, allowing for lookup by ASEID or constructor reference.
+     */
+    private scope;
+    constructor();
+    /** Number of loaded records */
+    get indexSize(): number;
+    inherit(scope: A_Scope): void;
+    addDefinition(def: A_FrameDefinition): void;
+    getDefinition(name: string): A_FrameDefinition | undefined;
+    listDefinitions(filter?: {
+        namespace?: string | A_FrameNamespace;
+    }): A_FrameDefinition[];
+    removeDefinition(def: A_FrameDefinition): void;
+    addNamespace(namespace: A_FrameNamespace): void;
+    getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined;
+    getDefaultNamespace(): A_FrameNamespace;
+    listNamespaces(): A_FrameNamespace[];
+    removeNamespace(namespace: A_FrameNamespace): void;
+    /**
+     * Search by a pre-computed embedding vector (cosine similarity).
+     */
+    search(vector: A_FrameVector, options?: A_FrameSearchOptions): A_FrameDefinition_SearchResult[];
+    cosineSimilarity(a: A_FrameVector, b?: A_FrameVector): number;
+    euclideanDistance(a: A_FrameVector, b: A_FrameVector): number;
+    nearest(query: A_FrameVector, vectors: readonly A_FrameVector[], limit?: number): A_FrameVector[];
+    rank(query: A_FrameVector, vectors: readonly A_FrameVector[]): Array<{
+        vector: A_FrameVector;
+        score: number;
+    }>;
+    private assertSameLength;
+}
+
+export { type A_FrameDefinition_SearchResult, A_FrameIndex, type A_FrameIndexMetaMethodMeta, type A_FrameIndexMetaType, type A_FrameIndexTarget, type A_FrameMetaDefinition, type A_FrameSearchOptions };

package/dist/node/frame-index.d.ts

@@ -0,0 +1,95 @@
+import { A_TYPES__Container_Constructor, A_TYPES__Entity_Constructor, A_TYPES__Component_Constructor, A_TYPES__Fragment_Constructor, A_Fragment, A_Scope, ASEID } from '@adaas/a-concept';
+import { A_FrameVector } from './vector.js';
+import { A as A_FrameNamespace } from './A-FrameNamespace.entity-D3fZBGDx.js';
+import { A as A_FrameDefinition, o as A_FrameTargetType } from './A-FrameDefinition.entity-CAUOdEvU.js';
+
+type A_FrameIndexTarget = A_TYPES__Container_Constructor | A_TYPES__Entity_Constructor | A_TYPES__Component_Constructor | A_TYPES__Fragment_Constructor;
+type A_FrameMetaDefinition<T extends Record<string, any> = {}> = {
+    name: string;
+    hash: string;
+    source: string;
+    type: A_FrameTargetType;
+    namespace?: string | A_FrameNamespace;
+    description?: string;
+    metadata?: T;
+    examples?: string[];
+};
+type A_FrameIndexMetaType = {
+    namespaces: string;
+    descriptions: string;
+    type: string;
+    name: string;
+    methods: Map<string, A_FrameIndexMetaMethodMeta>;
+};
+type A_FrameIndexMetaMethodMeta = {
+    name: string;
+    description?: string;
+    methodName: string;
+};
+type A_FrameSearchOptions = {
+    /** Maximum number of results; default 10 */
+    topK?: number;
+    /** Restrict search to a single namespace; undefined = all */
+    namespace?: string;
+    /** Minimum cosine similarity score (0–1); default 0 */
+    minScore?: number;
+};
+type A_FrameDefinition_SearchResult = {
+    record: A_FrameDefinition;
+    score: number;
+};
+
+declare class A_FrameIndex extends A_Fragment {
+    private static _instance;
+    static get instance(): A_FrameIndex;
+    static get indexSize(): number;
+    static inherit(scope: A_Scope): void;
+    static addDefinition(def: A_FrameDefinition): void;
+    static getDefinition(nameOrHash: string): A_FrameDefinition | undefined;
+    static listDefinitions(filter: {
+        namespace?: string | A_FrameNamespace;
+    }): A_FrameDefinition[];
+    static removeDefinition(def: A_FrameDefinition): void;
+    static addNamespace(namespace: A_FrameNamespace): void;
+    static getDefaultNamespace(): A_FrameNamespace;
+    static getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined;
+    static listNamespaces(): A_FrameNamespace[];
+    static removeNamespace(namespace: A_FrameNamespace): void;
+    static search(vector: A_FrameVector, options?: A_FrameSearchOptions): A_FrameDefinition_SearchResult[];
+    private definitions;
+    private namespaces;
+    private _index;
+    /**
+     * Scope where all definitions and namespaces are registered as dependencies, allowing for lookup by ASEID or constructor reference.
+     */
+    private scope;
+    constructor();
+    /** Number of loaded records */
+    get indexSize(): number;
+    inherit(scope: A_Scope): void;
+    addDefinition(def: A_FrameDefinition): void;
+    getDefinition(name: string): A_FrameDefinition | undefined;
+    listDefinitions(filter?: {
+        namespace?: string | A_FrameNamespace;
+    }): A_FrameDefinition[];
+    removeDefinition(def: A_FrameDefinition): void;
+    addNamespace(namespace: A_FrameNamespace): void;
+    getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined;
+    getDefaultNamespace(): A_FrameNamespace;
+    listNamespaces(): A_FrameNamespace[];
+    removeNamespace(namespace: A_FrameNamespace): void;
+    /**
+     * Search by a pre-computed embedding vector (cosine similarity).
+     */
+    search(vector: A_FrameVector, options?: A_FrameSearchOptions): A_FrameDefinition_SearchResult[];
+    cosineSimilarity(a: A_FrameVector, b?: A_FrameVector): number;
+    euclideanDistance(a: A_FrameVector, b: A_FrameVector): number;
+    nearest(query: A_FrameVector, vectors: readonly A_FrameVector[], limit?: number): A_FrameVector[];
+    rank(query: A_FrameVector, vectors: readonly A_FrameVector[]): Array<{
+        vector: A_FrameVector;
+        score: number;
+    }>;
+    private assertSameLength;
+}
+
+export { type A_FrameDefinition_SearchResult, A_FrameIndex, type A_FrameIndexMetaMethodMeta, type A_FrameIndexMetaType, type A_FrameIndexTarget, type A_FrameMetaDefinition, type A_FrameSearchOptions };