@adaas/a-frame 0.1.1 → 0.1.2

package/dist/browser/core.mjs

@@ -1,2 +1,2 @@
-import {a as a$1}from'./chunk-G66IL2DR.mjs';import {h}from'./chunk-5TTVFB3G.mjs';import {a as a$2,f,g,h as h$1}from'./chunk-GOADBDTE.mjs';export{a as A_FrameContext}from'./chunk-GOADBDTE.mjs';import {b as b$2}from'./chunk-YQJFTBGV.mjs';import'./chunk-K4MZY4ME.mjs';import {c}from'./chunk-AYN7KUQT.mjs';import'./chunk-INS7RO3B.mjs';import {b as b$3}from'./chunk-ZVCTU2DN.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-VDVJWU5T.mjs';import {a,b as b$1}from'./chunk-DMGQW3AO.mjs';import {A_Concept,A_Inject,A_Scope,A_Error,A_Context,A_Component,A_TypeGuards,A_CommonHelper}from'@adaas/a-concept';var v=(s=>(s.COMPONENT="component",s.ENTITY="entity",s.CONTAINER="container",s.FRAGMENT="fragment",s.METHOD="method",s))(v||{});var C=class{static isAllowedTarget(e){return A_TypeGuards.isEntityConstructor(e)||A_TypeGuards.isComponentConstructor(e)||A_TypeGuards.isContainerConstructor(e)||A_TypeGuards.isFragmentConstructor(e)||A_TypeGuards.isComponentInstance(e)||A_TypeGuards.isContainerInstance(e)||A_TypeGuards.isEntityInstance(e)||A_TypeGuards.isFragmentInstance(e)}static getTargetName(e){return A_CommonHelper.getComponentName(e)}static getTargetConstructor(e){return typeof e=="function"?e:e.constructor}};var t=class extends A_Error{};t.InvalidTarget="A-Frame Index Invalid Target Error",t.InvalidConfiguration="A-Frame Index Invalid Configuration Error",t.IndexDefinitionError="A-Frame Index Definition Error",t.IndexMetadataError="A-Frame Index Metadata Error",t.IndexRegistryError="A-Frame Index Registry Error",t.IndexComponentNotFoundError="A-Frame Index Component Not Found Error";function b(r){return function(e,o,n){let a;switch(true){case(!!o&&!!n):a="method";break;case(A_TypeGuards.isComponentConstructor(e)||A_TypeGuards.isComponentInstance(e)):a="component";break;case(A_TypeGuards.isContainerConstructor(e)||A_TypeGuards.isContainerInstance(e)):a="container";break;case(A_TypeGuards.isEntityConstructor(e)||A_TypeGuards.isEntityInstance(e)):a="entity";break;case(A_TypeGuards.isFragmentConstructor(e)||A_TypeGuards.isFragmentInstance(e)):a="fragment";break;default:throw new t(t.InvalidTarget,"@A_Frame.Define decorator cannot be applied to the target.")}let s=r.namespace?r.namespace instanceof c?r.namespace:a$1.getNamespace(r.namespace)||new c({name:r.namespace}):a$1.getDefaultNamespace();if(o&&n){let m=e.constructor,h=String(o),w=n.value.toString();return a$1.addDefinition(new b$3({name:h,dependency:m.name,description:r.description,source:w,metadata:r.metadata,type:"method",namespace:s})),n}if(!C.isAllowedTarget(e))throw new t(t.InvalidTarget,`@A_Frame.${a} decorator can only be applied to allowed targets.`);let F=A_CommonHelper.getComponentName(e),g=C.getTargetConstructor(e),y=e.toString();return a$1.addDefinition(new b$3({name:F,description:r.description,dependency:g.name,source:y,metadata:r.metadata,type:a,namespace:s})),e}}function Y(r={}){return function(e,o,n){if(!r.name)throw new t(t.InvalidConfiguration,"@A_Frame.Namespace decorator requires a name in the configuration.");let a=new c({name:r.name,description:r.description});a$1.addNamespace(a);}}var D=class extends A_Component{static Define(e){return b(e)}static NameSpace(e){return Y(e)}get package(){return []}packDependency(e,o,n){e.resolve(o)||e.register(n);}};var A=class extends D{get package(){return [{ctor:a$2,instance:new a$2},{ctor:b$2,instance:new b$2},{ctor:g,instance:new g},{ctor:h$1,instance:h$1},{ctor:h,instance:new h}]}async injectDependencies(){let e=A_Context.root;if(this.package.forEach(({ctor:o,instance:n})=>this.packDependency(e,o,n)),!e.resolve(a$1)){let o=new a$1;o.inherit(e),e.register(o);}}async load(e,o,n,a,s){if(!n.encryptionKey){a.warn("A_Frame (browser): no encryption key on context \u2014 blobs cannot be decrypted. Call A_FrameContext.setCredentials({...}) before concept.load().");return}s.bundleMeta&&n.serverVersion&&s.bundleMeta.serverVersion!==n.serverVersion&&a.warn(`A_Frame bundle was built against server v${s.bundleMeta.serverVersion} but the current credentials report v${n.serverVersion}. Hydration may skip records \u2014 rebuild the bundle.`);let F=o.listNamespaces(),g=o.listDefinitions();await Promise.all([...F.map(m=>Promise.resolve(m.load()).catch(()=>{})),...g.map(m=>Promise.resolve(m.load()).catch(()=>{}))]);let y=F.filter(m=>!m.isEmbed).length+g.filter(m=>!m.isEmbed).length;y>0&&a.warn(`${y} A-Frame entit${y===1?"y":"ies"} could not be hydrated from the bundle. Rebuild the bundle on the Node side to include them.`);}async build(e){}async start(e){}};a([A_Concept.Load()],A.prototype,"injectDependencies",1),a([A_Concept.Load(),b$1(0,A_Inject(A_Scope)),b$1(1,A_Inject(a$1)),b$1(2,A_Inject(a$2)),b$1(3,A_Inject(h)),b$1(4,A_Inject(f))],A.prototype,"load",1),a([A_Concept.Build(),b$1(0,A_Inject(A_Scope))],A.prototype,"build",1),a([A_Concept.Start(),b$1(0,A_Inject(A_Scope))],A.prototype,"start",1);export{A as A_Frame,D as A_FrameBase,b as A_FrameDefineDecorator,t as A_FrameError,Y as A_FrameNamespaceDecorator,v as A_FrameTargetType,C as A_FrameTypeGuard};//# sourceMappingURL=core.mjs.map
+import {a as a$2,f,g,h as h$1}from'./chunk-EFC7OUNO.mjs';export{a as A_FrameContext}from'./chunk-EFC7OUNO.mjs';import'./chunk-NTOIVRX3.mjs';import {h}from'./chunk-5TTVFB3G.mjs';import {a as a$4}from'./chunk-KFMVTZ7T.mjs';import {a as a$3}from'./chunk-RWQSCROK.mjs';import'./chunk-VSSANMPF.mjs';import'./chunk-INS7RO3B.mjs';import {a as a$1}from'./chunk-ZEONOTRL.mjs';import'./chunk-XR7FVA5M.mjs';import'./chunk-2RNFZSBL.mjs';import'./chunk-UULJJ5C5.mjs';import'./chunk-6WAOMX7M.mjs';import'./chunk-K4MZY4ME.mjs';import {c}from'./chunk-CT67Y46H.mjs';import'./chunk-6NPQURSO.mjs';import'./chunk-TQPC5MYM.mjs';import {b as b$1}from'./chunk-BIBPE2GT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import {a,b}from'./chunk-DMGQW3AO.mjs';import {A_Concept,A_Inject,A_Scope,A_Error,A_Context,A_Component,A_CommonHelper,A_TypeGuards}from'@adaas/a-concept';var k=(s=>(s.COMPONENT="component",s.ENTITY="entity",s.CONTAINER="container",s.FRAGMENT="fragment",s.METHOD="method",s))(k||{});var C=class{static isAllowedTarget(e){return A_TypeGuards.isEntityConstructor(e)||A_TypeGuards.isComponentConstructor(e)||A_TypeGuards.isContainerConstructor(e)||A_TypeGuards.isFragmentConstructor(e)||A_TypeGuards.isComponentInstance(e)||A_TypeGuards.isContainerInstance(e)||A_TypeGuards.isEntityInstance(e)||A_TypeGuards.isFragmentInstance(e)}static getTargetName(e){return A_CommonHelper.getComponentName(e)}static getTargetConstructor(e){return typeof e=="function"?e:e.constructor}};var t=class extends A_Error{};t.InvalidTarget="A-Frame Index Invalid Target Error",t.InvalidConfiguration="A-Frame Index Invalid Configuration Error",t.IndexDefinitionError="A-Frame Index Definition Error",t.IndexMetadataError="A-Frame Index Metadata Error",t.IndexRegistryError="A-Frame Index Registry Error",t.IndexComponentNotFoundError="A-Frame Index Component Not Found Error";function M(r){return function(e,o,n){let a;switch(true){case(!!o&&!!n):a="method";break;case(A_TypeGuards.isComponentConstructor(e)||A_TypeGuards.isComponentInstance(e)):a="component";break;case(A_TypeGuards.isContainerConstructor(e)||A_TypeGuards.isContainerInstance(e)):a="container";break;case(A_TypeGuards.isEntityConstructor(e)||A_TypeGuards.isEntityInstance(e)):a="entity";break;case(A_TypeGuards.isFragmentConstructor(e)||A_TypeGuards.isFragmentInstance(e)):a="fragment";break;default:throw new t(t.InvalidTarget,`@A_Frame.Define decorator cannot be applied to the target : ${A_CommonHelper.getComponentName(e)}. It can only be applied to classes or methods inheriting from allowed base classes.`)}let s=r.namespace?r.namespace instanceof c?r.namespace:a$1.getNamespace(r.namespace)||new c({name:r.namespace}):a$1.getDefaultNamespace();if(o&&n){let m=e.constructor,v=String(o),O=n.value.toString();return a$1.addDefinition(new b$1({name:v,dependency:m.name,description:r.description,source:O,metadata:r.metadata,type:"method",namespace:s})),n}if(!C.isAllowedTarget(e))throw new t(t.InvalidTarget,`@A_Frame.${a} decorator cannot be applied to the target : ${A_CommonHelper.getComponentName(e)}. It can only be applied to allowed targets.`);let F=A_CommonHelper.getComponentName(e),T=C.getTargetConstructor(e),y=e.toString();return a$1.addDefinition(new b$1({name:F,description:r.description,dependency:T.name,source:y,metadata:r.metadata,type:a,namespace:s})),e}}function Y(r={}){return function(e,o,n){if(!r.name)throw new t(t.InvalidConfiguration,"@A_Frame.Namespace decorator requires a name in the configuration.");let a=new c({name:r.name,description:r.description});a$1.addNamespace(a);}}var E=class extends A_Component{static Define(e){return M(e)}static NameSpace(e){return Y(e)}get package(){return []}packDependency(e,o,n){e.resolve(o)||e.register(n);}};var A=class extends E{get package(){return [{ctor:a$2,instance:new a$2},{ctor:a$3,instance:new a$3},{ctor:g,instance:new g},{ctor:h$1,instance:h$1},{ctor:h,instance:new h},{ctor:a$4,instance:a$4}]}async injectDependencies(){let e=A_Context.root;if(this.package.forEach(({ctor:o,instance:n})=>this.packDependency(e,o,n)),e.resolve(f)||e.register(f.instance),!e.resolve(a$1)){let o=new a$1;o.inherit(e),e.register(o);}}async load(e,o,n,a,s){if(!n.encryptionKey&&!s?.hasBundleData){a.warn("A_Frame (browser): no encryption key and no pre-built bundle data. Seed A_FrameBrowserStorageBlobs.fromBundle(bundle) before concept.load(), or call A_FrameContext.setCredentials({...}) for live-session mode.");return}s.bundleMeta&&n.serverVersion&&s.bundleMeta.serverVersion!==n.serverVersion&&a.warn(`A_Frame bundle was built against server v${s.bundleMeta.serverVersion} but the current credentials report v${n.serverVersion}. Hydration may skip records \u2014 rebuild the bundle.`);let F=o.listNamespaces(),T=o.listDefinitions();await Promise.all([...F.map(m=>Promise.resolve(m.load()).catch(()=>{})),...T.map(m=>Promise.resolve(m.load()).catch(()=>{}))]);let y=F.filter(m=>!m.isEmbed).length+T.filter(m=>!m.isEmbed).length;y>0&&a.warn(`${y} A-Frame entit${y===1?"y":"ies"} could not be hydrated from the bundle. Rebuild the bundle on the Node side to include them.`);}async build(e){}async start(e){}};a([A_Concept.Load()],A.prototype,"injectDependencies",1),a([A_Concept.Load(),b(0,A_Inject(A_Scope)),b(1,A_Inject(a$1)),b(2,A_Inject(a$2)),b(3,A_Inject(h)),b(4,A_Inject(f))],A.prototype,"load",1),a([A_Concept.Build(),b(0,A_Inject(A_Scope))],A.prototype,"build",1),a([A_Concept.Start(),b(0,A_Inject(A_Scope))],A.prototype,"start",1);export{A as A_Frame,E as A_FrameBase,M as A_FrameDefineDecorator,t as A_FrameError,Y as A_FrameNamespaceDecorator,k as A_FrameTargetType,C as A_FrameTypeGuard};//# sourceMappingURL=core.mjs.map
 //# sourceMappingURL=core.mjs.map

package/dist/browser/core.mjs.map

@@ -1 +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-browser.ts"],"names":["A_FrameTargetType","A_FrameTypeGuard","target","A_TypeGuards","A_CommonHelper","A_FrameError","A_Error","A_FrameDefineDecorator","config","propertyKey","descriptor","componentType","namespace","A_FrameNamespace","A_FrameIndex","targetClass","methodName","source","A_FrameDefinition","componentName","A_FrameNamespaceDecorator","A_FrameBase","A_Component","options","scope","def","A_Frame","A_FrameContext","A_FrameEnv","A_FrameStorageCodec","A_FrameBrowserStorageProvider","A_FrameLogger","A_Context","ctor","instance","index","context","logger","blobs","namespaces","definitions","ns","unloaded","__decorateClass","A_Concept","__decorateParam","A_Inject","A_Scope","A_FrameBrowserStorageBlobs"],"mappings":"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","file":"core.mjs","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_Fragment, A_Inject, A_Scope, A_TYPES__A_DependencyInjectable, A_TYPES__Component_Constructor, A_TYPES__Ctor, A_TYPES__Fragment_Constructor } from \"@adaas/a-concept\";\nimport { A_FrameBase } from \"./A-Frame.component\";\nimport { A_FrameBrowserStorageProvider } from \"../A-FrameStorage/browser/A-FrameBrowserStorage.component\";\nimport { A_FrameBrowserStorageBlobs } from \"../A-FrameStorage/browser/A-FrameBrowserStorageBlobs.context\";\nimport { A_FrameStorageCodec } from \"../A-FrameStorage/A-FrameStorage.codec\";\nimport { A_FrameIndex } from \"../A-FrameIndex\";\nimport { A_FrameContext } from \"./A-Frame.context\";\nimport { A_FrameLogger } from \"../A-FrameLogger/A-FrameLogger.component.env-browser\";\nimport { A_FrameEnv } from \"../A-FrameEnv/A-FrameEnv.fragment.env-browser\";\n\n\n\nexport class A_Frame extends A_FrameBase {\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    @A_Concept.Load()\n    async injectDependencies(\n    ) {\n        const scope = A_Context.root\n\n        // Register \n        // every package dep that isn't already in scope.\n        this.package.forEach(({ ctor, instance }) => this.packDependency(scope, ctor, instance));\n\n        // A_FrameIndex needs to inherit the scope so its registry is visible\n        // to all later resolutions (entities query it during load).\n        if (!scope.resolve(A_FrameIndex)) {\n            const index = new A_FrameIndex();\n            index.inherit(scope);\n            scope.register(index);\n        }\n    }\n\n\n    /**\n     * Hydrate all known namespaces and definitions from the in-memory bundle\n     * blobs. Read-only — never calls embed (no network in the browser).\n     *\n     * The caller is responsible for:\n     *   1. Seeding `A_FrameBrowserStorageBlobs` from a prebuilt `A_FrameBundle`.\n     *   2. Setting `A_FrameContext.encryptionKey` and `serverVersion` so blobs\n     *      can be decrypted and validated.\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_FrameContext) context: A_FrameContext,\n        @A_Inject(A_FrameLogger) logger: A_FrameLogger,\n        @A_Inject(A_FrameBrowserStorageBlobs) blobs: A_FrameBrowserStorageBlobs,\n    ) {\n        if (!context.encryptionKey) {\n            logger.warn(\n                'A_Frame (browser): no encryption key on context — blobs cannot be decrypted. ' +\n                'Call A_FrameContext.setCredentials({...}) before concept.load().'\n            );\n            return;\n        }\n\n        // Surface a soft mismatch warning when the bundle was built against a\n        // different server version than the one the user has authenticated with.\n        if (blobs.bundleMeta && context.serverVersion && blobs.bundleMeta.serverVersion !== context.serverVersion) {\n            logger.warn(\n                `A_Frame bundle was built against server v${blobs.bundleMeta.serverVersion} ` +\n                `but the current credentials report v${context.serverVersion}. ` +\n                `Hydration may skip records — rebuild the bundle.`\n            );\n        }\n\n        const namespaces = index.listNamespaces();\n        const definitions = index.listDefinitions();\n\n        await Promise.all([\n            ...namespaces.map(ns => Promise.resolve(ns.load()).catch(() => { })),\n            ...definitions.map(def => Promise.resolve(def.load()).catch(() => { })),\n        ]);\n\n        const unloaded =\n            namespaces.filter(ns => !ns.isEmbed).length +\n            definitions.filter(def => !def.isEmbed).length;\n        if (unloaded > 0) {\n            logger.warn(\n                `${unloaded} A-Frame entit${unloaded === 1 ? 'y' : 'ies'} could not be hydrated from the bundle. ` +\n                `Rebuild the bundle on the Node side to include them.`\n            );\n        }\n    }\n\n\n    @A_Concept.Build()\n    async build(\n        @A_Inject(A_Scope) scope: A_Scope,\n    ) {\n        // Build phase is now redundant for registration (handled in @Load above)\n        // but kept as a hook for downstream extensions.\n    }\n\n\n    @A_Concept.Start()\n    async start(\n        @A_Inject(A_Scope) scope: A_Scope,\n    ) {\n        // Start logic here\n    }\n\n\n\n}\n"]}
+{"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-browser.ts"],"names":["A_FrameTargetType","A_FrameTypeGuard","target","A_TypeGuards","A_CommonHelper","A_FrameError","A_Error","A_FrameDefineDecorator","config","propertyKey","descriptor","componentType","namespace","A_FrameNamespace","A_FrameIndex","targetClass","methodName","source","A_FrameDefinition","componentName","A_FrameNamespaceDecorator","A_FrameBase","A_Component","options","scope","def","A_Frame","A_FrameContext","A_FrameEnv","A_FrameStorageCodec","A_FrameBrowserStorageProvider","A_FrameLogger","A_FrameBrowserChannel","A_Context","ctor","instance","A_FrameBrowserStorageBlobs","index","context","logger","blobs","namespaces","definitions","ns","unloaded","__decorateClass","A_Concept","__decorateParam","A_Inject","A_Scope"],"mappings":"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","file":"core.mjs","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 : ${A_CommonHelper.getComponentName(target)}. It can only be applied to classes or methods inheriting from allowed base classes.`\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 cannot be applied to the target : ${A_CommonHelper.getComponentName(target)}. It 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_Fragment, A_Inject, A_Scope, A_TYPES__A_DependencyInjectable, A_TYPES__Component_Constructor, A_TYPES__Ctor, A_TYPES__Fragment_Constructor } from \"@adaas/a-concept\";\nimport { A_FrameBase } from \"./A-Frame.component\";\nimport { A_FrameBrowserStorageProvider } from \"../A-FrameStorage/browser/A-FrameBrowserStorage.component\";\nimport { A_FrameBrowserStorageBlobs } from \"../A-FrameStorage/browser/A-FrameBrowserStorageBlobs.context\";\nimport { A_FrameStorageCodec } from \"../A-FrameStorage/A-FrameStorage.codec\";\nimport { A_FrameIndex } from \"../A-FrameIndex\";\nimport { A_FrameContext } from \"./A-Frame.context\";\nimport { A_FrameLogger } from \"../A-FrameLogger/A-FrameLogger.component.env-browser\";\nimport { A_FrameEnv } from \"../A-FrameEnv/A-FrameEnv.fragment.env-browser\";\nimport { A_FrameBrowserChannel } from \"../A-FrameChannel/A-FrameChannel.component.env-browser\";\n\n\n\nexport class A_Frame extends A_FrameBase {\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            { ctor: A_FrameBrowserChannel, instance: A_FrameBrowserChannel },\n        ];\n    }\n\n\n    @A_Concept.Load()\n    async injectDependencies(\n    ) {\n        const scope = A_Context.root\n\n        // Register \n        // every package dep that isn't already in scope.\n        this.package.forEach(({ ctor, instance }) => this.packDependency(scope, ctor, instance));\n\n        // Register the blobs singleton so it is always injectable via\n        // @A_Inject(A_FrameBrowserStorageBlobs).  This must happen here\n        // (not in A_FrameBrowserStorageProvider.onLoad) because the concept\n        // only loads A_Frame as a component — the provider is only a DI token.\n        if (!scope.resolve(A_FrameBrowserStorageBlobs)) {\n            scope.register(A_FrameBrowserStorageBlobs.instance);\n        }\n\n        // A_FrameIndex needs to inherit the scope so its registry is visible\n        // to all later resolutions (entities query it during load).\n        if (!scope.resolve(A_FrameIndex)) {\n            const index = new A_FrameIndex();\n            index.inherit(scope);\n            scope.register(index);\n        }\n    }\n\n\n    /**\n     * Hydrate all known namespaces and definitions from the in-memory bundle\n     * blobs. Read-only — never calls embed (no network in the browser).\n     *\n     * The caller is responsible for:\n     *   1. Seeding `A_FrameBrowserStorageBlobs` from a prebuilt `A_FrameBundle`.\n     *   2. Setting `A_FrameContext.encryptionKey` and `serverVersion` so blobs\n     *      can be decrypted and validated.\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_FrameContext) context: A_FrameContext,\n        @A_Inject(A_FrameLogger) logger: A_FrameLogger,\n        @A_Inject(A_FrameBrowserStorageBlobs) blobs: A_FrameBrowserStorageBlobs,\n    ) {\n        if (!context.encryptionKey && !blobs?.hasBundleData) {\n            logger.warn(\n                'A_Frame (browser): no encryption key and no pre-built bundle data. ' +\n                'Seed A_FrameBrowserStorageBlobs.fromBundle(bundle) before concept.load(), ' +\n                'or call A_FrameContext.setCredentials({...}) for live-session mode.'\n            );\n            return;\n        }\n\n        // Surface a soft mismatch warning when the bundle was built against a\n        // different server version than the one the user has authenticated with.\n        if (blobs.bundleMeta && context.serverVersion && blobs.bundleMeta.serverVersion !== context.serverVersion) {\n            logger.warn(\n                `A_Frame bundle was built against server v${blobs.bundleMeta.serverVersion} ` +\n                `but the current credentials report v${context.serverVersion}. ` +\n                `Hydration may skip records — rebuild the bundle.`\n            );\n        }\n\n        const namespaces = index.listNamespaces();\n        const definitions = index.listDefinitions();\n\n        await Promise.all([\n            ...namespaces.map(ns => Promise.resolve(ns.load()).catch(() => { })),\n            ...definitions.map(def => Promise.resolve(def.load()).catch(() => { })),\n        ]);\n\n        const unloaded =\n            namespaces.filter(ns => !ns.isEmbed).length +\n            definitions.filter(def => !def.isEmbed).length;\n        if (unloaded > 0) {\n            logger.warn(\n                `${unloaded} A-Frame entit${unloaded === 1 ? 'y' : 'ies'} could not be hydrated from the bundle. ` +\n                `Rebuild the bundle on the Node side to include them.`\n            );\n        }\n    }\n\n\n    @A_Concept.Build()\n    async build(\n        @A_Inject(A_Scope) scope: A_Scope,\n    ) {\n        // Build phase is now redundant for registration (handled in @Load above)\n        // but kept as a hook for downstream extensions.\n    }\n\n\n    @A_Concept.Start()\n    async start(\n        @A_Inject(A_Scope) scope: A_Scope,\n    ) {\n        // Start logic here\n    }\n\n\n\n}\n"]}

package/dist/browser/credentials.d.mts

@@ -0,0 +1,74 @@
+import { A_TYPES__Entity_Serialized, A_Entity, A_Scope } from '@adaas/a-concept';
+
+/**
+ * Initialization shape — matches the server response from GET /api/v1/credentials/me
+ */
+type A_FrameCredentials_Init = {
+    /** Unique identifier for the credential (as returned by the a-frame-mcp server) */
+    id: string;
+    /** Human-readable credential name */
+    name: string;
+    /** Optional description */
+    description?: string | null;
+    /** Encryption key in the encoding specified by key_encoding */
+    encryption_key: string;
+    /** Encryption algorithm (e.g. "AES-256-GCM") */
+    algorithm: string;
+    /** Encoding format of the key (e.g. "base64") */
+    key_encoding: string;
+    /** Usage note provided by the server */
+    usage_note?: string | null;
+    /** Version of the a-frame-mcp server that issued this credential */
+    server_version: string;
+};
+/**
+ * Serialized shape — persisted / round-tripped via toJSON / fromJSON.
+ * The encryption key is intentionally excluded from serialization.
+ */
+type A_FrameCredentials_Serialized = {
+    credentialId: string;
+    name: string;
+    description?: string | null;
+    algorithm: string;
+    key_encoding: string;
+    serverVersion: string;
+} & A_TYPES__Entity_Serialized;
+
+declare class A_FrameCredentials extends A_Entity<A_FrameCredentials_Init, A_FrameCredentials_Serialized> {
+    static get concept(): string;
+    protected _credentialId: string;
+    protected _name: string;
+    protected _description?: string | null;
+    protected _encryptionKey: string;
+    protected _algorithm: string;
+    protected _keyEncoding: string;
+    protected _usageNote?: string | null;
+    protected _serverVersion: string;
+    get credentialId(): string;
+    get name(): string;
+    get description(): string | null | undefined;
+    /**
+     * The raw encryption key as returned by the server.
+     * Use this for encrypting / decrypting data exchanged with the a-frame-mcp server.
+     */
+    get encryptionKey(): string;
+    get algorithm(): string;
+    get keyEncoding(): string;
+    get usageNote(): string | null | undefined;
+    get serverVersion(): string;
+    get isAuthenticated(): boolean;
+    load(scope?: A_Scope): Promise<void> | void;
+    save(scope?: A_Scope): Promise<void> | void;
+    destroy(scope?: A_Scope): Promise<void> | void;
+    fromNew(init: A_FrameCredentials_Init): void;
+    fromJSON(serialized: A_FrameCredentials_Serialized): void;
+    toJSON(): A_FrameCredentials_Serialized;
+}
+
+declare const A_FrameCredentialsFeatures: {
+    readonly Load: "_A_FRAME_CREDENTIALS_LOAD";
+    readonly Save: "_A_FRAME_CREDENTIALS_SAVE";
+    readonly Destroy: "_A_FRAME_CREDENTIALS_DESTROY";
+};
+
+export { A_FrameCredentials, A_FrameCredentialsFeatures, type A_FrameCredentials_Init, type A_FrameCredentials_Serialized };

package/dist/browser/credentials.mjs

@@ -0,0 +1,2 @@
+export{b as A_FrameCredentials,a as A_FrameCredentialsFeatures}from'./chunk-VSSANMPF.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=credentials.mjs.map
+//# sourceMappingURL=credentials.mjs.map

package/dist/browser/credentials.mjs.map

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

package/dist/browser/definition.d.mts

@@ -1,7 +1,8 @@
-export { A as A_FrameDefinition, a as A_FrameDefinition_EmbeddingMeta, b as A_FrameDefinition_Init, c as A_FrameDefinition_Serialized } from './A-FrameDefinition.entity-DWGN_Ujr.mjs';
+export { A as A_FrameDefinition } from './A-FrameDefinition.entity-yA0GsBoe.mjs';
+export { A as A_FrameDefinition_EmbeddingMeta, a as A_FrameDefinition_Init, b as A_FrameDefinition_Serialized, D as DefinitionExtractedMeta } from './A-FrameDefinition.types-BT02yAhQ.mjs';
 import '@adaas/a-concept';
-import './A-FrameNamespace.entity-rCm1AavP.mjs';
 import './vector.mjs';
+import './A-FrameNamespace.entity-BDg1FUgo.mjs';
 
 declare const A_FrameDefinitionFeatures: {
     readonly Load: "_A_FRAME_DEFINITION_LOAD";

package/dist/browser/definition.mjs

@@ -1,2 +1,2 @@
-export{b as A_FrameDefinition,a as A_FrameDefinitionFeatures}from'./chunk-ZVCTU2DN.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-VDVJWU5T.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=definition.mjs.map
+export{b as A_FrameDefinition,a as A_FrameDefinitionFeatures}from'./chunk-BIBPE2GT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=definition.mjs.map
 //# sourceMappingURL=definition.mjs.map

package/dist/browser/dynamic-content.d.mts

@@ -0,0 +1,13 @@
+export { A as A_FrameContentGenerateResponse, a as A_FrameContentPatchOperation, b as A_FrameContentPatchPosition, c as A_FrameContentPatchResponse, d as A_FrameContentPiece, e as A_FrameContentSegmentWire, f as A_FrameDynamicContent, g as A_FrameDynamicContentFeatureNames, h as A_FrameDynamicContentFeatures, i as A_FrameDynamicContentOperation, j as A_FrameDynamicContentOptions, k as A_FrameDynamicContent_Init, l as A_FrameDynamicContent_Serialized } from './A-FrameDynamicContentOperation.context-CoViNb19.mjs';
+import { A_Error } from '@adaas/a-concept';
+import './vector.mjs';
+import './A-FrameSegment.entity-D1xjjWvG.mjs';
+
+declare class A_FrameDynamicContentError extends A_Error {
+    static readonly GenerationFailed = "GenerationFailed";
+    static readonly PatchFailed = "PatchFailed";
+    static readonly InvalidPatch = "InvalidPatch";
+    static readonly PieceNotFound = "PieceNotFound";
+}
+
+export { A_FrameDynamicContentError };

package/dist/browser/dynamic-content.mjs

@@ -0,0 +1,2 @@
+export{e as A_FrameDynamicContent,d as A_FrameDynamicContentError,b as A_FrameDynamicContentFeatures,c as A_FrameDynamicContentOperation}from'./chunk-UULJJ5C5.mjs';import'./chunk-TQPC5MYM.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=dynamic-content.mjs.map
+//# sourceMappingURL=dynamic-content.mjs.map

package/dist/browser/dynamic-content.mjs.map

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

package/dist/browser/dynamic-feature.d.mts

@@ -1,10 +1,70 @@
-import { A_TYPES__Entity_Serialized, A_Entity } from '@adaas/a-concept';
+import { A as A_FrameDynamicFeatureStepMapEntry, a as A_FrameDynamicFeatureElementMapEntry, b as A_FrameDynamicFeatureDefinition, c as A_FrameDynamicFeatureMapResult, d as A_FrameDynamicFeature, e as A_FrameChannel } from './A-FrameChannel.component-4mTNctXL.mjs';
+export { f as A_FrameDynamicFeatureFeatureNames, g as A_FrameDynamicFeatureFeatures, h as A_FrameDynamicFeatureOperation, i as A_FrameDynamicFeatureOptions, j as A_FrameDynamicFeatureParam, k as A_FrameDynamicFeatureStep, l as A_FrameDynamicFeature_Init, m as A_FrameDynamicFeature_Serialized, n as A_FrameFeatureGenerateResponse, o as A_FrameFeaturePatchResponse } from './A-FrameChannel.component-4mTNctXL.mjs';
+import { A_Error, A_Fragment, A_Component } from '@adaas/a-concept';
+import { A_FrameIndex } from './frame-index.mjs';
+import './A-FrameChannel.types-BXEKJK9t.mjs';
+import './A-FrameDefinition.types-BT02yAhQ.mjs';
+import './A-FrameNamespace.entity-BDg1FUgo.mjs';
+import './vector.mjs';
+import './A-FrameEnv.types-DnK-CYVk.mjs';
+import './A-FrameDefinition.entity-yA0GsBoe.mjs';
+import './A-FrameDynamicContentOperation.context-CoViNb19.mjs';
+import './A-FrameSegment.entity-D1xjjWvG.mjs';
+import './A-FrameCompletion.entity-Dzy9sIa8.mjs';
+import './A-FrameSchema.entity-DjYIhsoj.mjs';
 
-type A_FrameDynamicFeature_Init = {};
-type A_FrameDynamicFeature_Serialized = {} & A_TYPES__Entity_Serialized;
+declare class A_FrameDynamicFeatureError extends A_Error {
+    static readonly GenerationFailed = "GenerationFailed";
+    static readonly PatchFailed = "PatchFailed";
+    static readonly MappingFailed = "MappingFailed";
+    static readonly MethodNotFound = "MethodNotFound";
+    static readonly InvalidOperation = "InvalidOperation";
+}
+
+/**
+ * Context fragment that accumulates the method/component-mapping results
+ * produced by `A_FrameMethodMapper.mapFeature()`.
+ *
+ * Uses `prompt` as the unique key — same approach as `A_FrameComponentMapIndex`.
+ * Call `toResult(definition)` after the mapper finishes to build the fully
+ * structured `A_FrameDynamicFeatureMapResult`.
+ */
+declare class A_FrameMethodMapIndex extends A_Fragment {
+    private _stepEntries;
+    private _elementEntries;
+    constructor();
+    setStep(entry: A_FrameDynamicFeatureStepMapEntry): void;
+    getStep(prompt: string): A_FrameDynamicFeatureStepMapEntry | undefined;
+    setElement(entry: A_FrameDynamicFeatureElementMapEntry): void;
+    getElement(prompt: string): A_FrameDynamicFeatureElementMapEntry | undefined;
+    clear(): void;
+    get stepCount(): number;
+    get elementCount(): number;
+    get matchedSteps(): A_FrameDynamicFeatureStepMapEntry[];
+    get unmatchedSteps(): A_FrameDynamicFeatureStepMapEntry[];
+    /**
+     * Construct a fully structured `A_FrameDynamicFeatureMapResult` from the
+     * accumulated entries and the provided definition.
+     */
+    toResult(definition: A_FrameDynamicFeatureDefinition): A_FrameDynamicFeatureMapResult;
+}
 
-declare class A_FrameDynamicFeature extends A_Entity<A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized> {
-    static get concept(): string;
+/**
+ * Stateless component that implements the `Map` feature for
+ * `A_FrameDynamicFeature`.
+ *
+ * Algorithm:
+ *  1. Read `feature.definition` (includes server-computed embeddings on steps
+ *     and supporting elements).
+ *  2. Run cosine-similarity search against `A_FrameIndex` for every step and
+ *     every supporting element.
+ *  3. For steps that remain unmatched, issue a server patch to refine their
+ *     descriptions (up to `feature.maxRetries` times), then re-match.
+ *  4. Mark any still-unmatched steps with a `matchError`.
+ *  5. Hydrate the feature with `mapIndex.toResult(def)`.
+ */
+declare class A_FrameMethodMapper extends A_Component {
+    mapFeature(feature: A_FrameDynamicFeature, mapIndex: A_FrameMethodMapIndex, frameIndex: A_FrameIndex, channel: A_FrameChannel): Promise<void>;
 }
 
-export { A_FrameDynamicFeature, type A_FrameDynamicFeature_Init, type A_FrameDynamicFeature_Serialized };
+export { A_FrameDynamicFeature, A_FrameDynamicFeatureDefinition, A_FrameDynamicFeatureElementMapEntry, A_FrameDynamicFeatureError, A_FrameDynamicFeatureMapResult, A_FrameDynamicFeatureStepMapEntry, A_FrameMethodMapIndex, A_FrameMethodMapper };

package/dist/browser/dynamic-feature.mjs

@@ -1,2 +1,4 @@
-import'./chunk-DMGQW3AO.mjs';import {A_Entity}from'@adaas/a-concept';var e=class extends A_Entity{static get concept(){return "a-frame"}};export{e as A_FrameDynamicFeature};//# sourceMappingURL=dynamic-feature.mjs.map
+import {a as a$1}from'./chunk-ZEONOTRL.mjs';import {q,m,p,r,f,a as a$2,o}from'./chunk-XR7FVA5M.mjs';export{q as A_FrameDynamicFeature,o as A_FrameDynamicFeatureError,m as A_FrameDynamicFeatureFeatures,n as A_FrameDynamicFeatureOperation,p as A_FrameMethodMapIndex}from'./chunk-XR7FVA5M.mjs';import'./chunk-2RNFZSBL.mjs';import'./chunk-UULJJ5C5.mjs';import'./chunk-6WAOMX7M.mjs';import'./chunk-K4MZY4ME.mjs';import'./chunk-CT67Y46H.mjs';import'./chunk-6NPQURSO.mjs';import'./chunk-TQPC5MYM.mjs';import'./chunk-BIBPE2GT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import {a as a$3}from'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import {a,b}from'./chunk-DMGQW3AO.mjs';import {A_Feature,A_Inject,A_Caller,A_Component,A_Scope,A_Context}from'@adaas/a-concept';var d=class extends A_Component{async mapFeature(o$1,n,u,F){let f$1=o$1.definition;if(!f$1)return;let w=(t,e)=>{if(!t.embedding?.length)return {matchedClass:null,matchedMethod:null,matchScore:0};let r=u.search(new a$3(t.embedding),{topK:1})[0];if(r&&r.score>=e){let a=r.record.dependency.name,s=r.record.name;return {matchedClass:a,matchedMethod:s,matchScore:r.score}}return {matchedClass:null,matchedMethod:null,matchScore:r?.score??0}},l=(t,e)=>{if(!t.embedding?.length)return {matchedClass:null,matchScore:0};let r=u.search(new a$3(t.embedding),{topK:1})[0];return r&&r.score>=e?{matchedClass:r.record.name,matchScore:r.score}:{matchedClass:null,matchScore:r?.score??0}},x=t=>{let e=c=>{let{embedding:r,...a}=c;return a};return {...t,steps:t.steps.map(e),components:t.components.map(e),fragments:t.fragments.map(e),entities:t.entities.map(e)}},y=t=>{n.clear();for(let e of t.steps)n.setStep({prompt:e.prompt,inputs:e.inputs,outputs:e.outputs,...w(e,o$1.minScore)});for(let e of t.components)n.setElement({prompt:e.prompt,...l(e,o$1.minScore)});for(let e of t.fragments)n.setElement({prompt:e.prompt,...l(e,o$1.minScore)});for(let e of t.entities)n.setElement({prompt:e.prompt,...l(e,o$1.minScore)});},m=f$1;y(m);for(let t=0;t<o$1.maxRetries;t++){let e=m.steps.filter(s=>s.embedding?.length&&n.getStep(s.prompt)?.matchedMethod===null);if(e.length===0)break;let c=["The following workflow steps could not be matched to any registered method.","Please re-describe each step with more specific, method-oriented language:",e.map(s=>`- "${s.prompt}"`).join(`
+`)].join(`
+`),r=new f("POST","/api/v1/feature/patch",{originalPrompt:o$1.prompt,definition:x(m),patchInstruction:c,model:o$1.modelName,context:o$1.contextHint}),a=new A_Scope({name:`A_FrameMethodMapper.mapFeature:retry${t}`,fragments:[r]}).inherit(A_Context.scope(F));if(await F.call(a$2.Request,a),a.destroy(),!r.response)break;m=r.response.definition,y(m);}for(let t of m.steps){let e=n.getStep(t.prompt);e&&e.matchedMethod===null&&t.embedding?.length&&n.setStep({...e,matchError:{title:o.MethodNotFound,description:`Unable to match "${t.prompt}" to any registered method after ${o$1.maxRetries} retries.`}});}o$1.hydrateFromMap(n.toResult(m));}};a([A_Feature.Extend({name:m.Map,scope:[q]}),b(0,A_Inject(A_Caller)),b(1,A_Inject(p)),b(2,A_Inject(a$1)),b(3,A_Inject(r))],d.prototype,"mapFeature",1);export{d as A_FrameMethodMapper};//# sourceMappingURL=dynamic-feature.mjs.map
 //# sourceMappingURL=dynamic-feature.mjs.map

package/dist/browser/dynamic-feature.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameDynamicFeature.entity.ts"],"names":["A_FrameDynamicFeature","A_Entity"],"mappings":"qEAKO,IAAMA,CAAAA,CAAN,cAAoCC,QAAuE,CAE9G,WAAW,OAAA,EAAkB,CACzB,OAAO,SACX,CAGJ","file":"dynamic-feature.mjs","sourcesContent":["import { A_Entity } from \"@adaas/a-concept\";\nimport { A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized } from \"./A-FrameDynamicFeature.types\";\n\n\n\nexport class A_FrameDynamicFeature extends A_Entity<A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n\n}"]}
+{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameMethodMapper.component.ts"],"names":["A_FrameMethodMapper","A_Component","feature","mapIndex","frameIndex","channel","def","tryMatchStep","step","minScore","top","A_FrameVector","matchedClass","matchedMethod","tryMatchElement","el","stripEmbeddings","d","strip","embedding","rest","matchAll","workingDef","retry","unmatchedSteps","refinementInstruction","patchReq","A_FrameChannelRequest","patchScope","A_Scope","A_Context","A_FrameFeatures","entry","A_FrameDynamicFeatureError","__decorateClass","A_Feature","A_FrameDynamicFeatureFeatures","A_FrameDynamicFeature","__decorateParam","A_Inject","A_Caller","A_FrameMethodMapIndex","A_FrameIndex","A_FrameChannel"],"mappings":"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","file":"dynamic-feature.mjs","sourcesContent":["import { A_Caller, A_Component, A_Context, A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_FrameChannel } from \"../A-FrameChannel/A-FrameChannel.component\";\nimport { A_FrameFeatures } from \"../A-FrameChannel/A-FrameChannel.constants\";\nimport { A_FrameChannelRequest } from \"../A-FrameChannel/A-FrameChannelRequest.context\";\nimport { A_FrameIndex } from \"../A-FrameIndex/A-FrameIndex.context\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameDynamicFeature } from \"./A-FrameDynamicFeature.entity\";\nimport { A_FrameDynamicFeatureFeatures } from \"./A-FrameDynamicFeature.constants\";\nimport { A_FrameDynamicFeatureError } from \"./A-FrameDynamicFeature.error\";\nimport {\n    A_FrameDynamicFeatureDefinition,\n    A_FrameDynamicFeatureElementMapEntry,\n    A_FrameDynamicFeatureStep,\n    A_FrameDynamicFeatureStepMapEntry,\n    A_FrameFeaturePatchResponse,\n} from \"./A-FrameDynamicFeature.types\";\nimport { A_FrameMethodMapIndex } from \"./A-FrameMethodMapIndex.context\";\n\n\n/**\n * Stateless component that implements the `Map` feature for\n * `A_FrameDynamicFeature`.\n *\n * Algorithm:\n *  1. Read `feature.definition` (includes server-computed embeddings on steps\n *     and supporting elements).\n *  2. Run cosine-similarity search against `A_FrameIndex` for every step and\n *     every supporting element.\n *  3. For steps that remain unmatched, issue a server patch to refine their\n *     descriptions (up to `feature.maxRetries` times), then re-match.\n *  4. Mark any still-unmatched steps with a `matchError`.\n *  5. Hydrate the feature with `mapIndex.toResult(def)`.\n */\nexport class A_FrameMethodMapper extends A_Component {\n\n    @A_Feature.Extend({\n        name: A_FrameDynamicFeatureFeatures.Map,\n        scope: [A_FrameDynamicFeature],\n    })\n    async mapFeature(\n        @A_Inject(A_Caller) feature: A_FrameDynamicFeature,\n        @A_Inject(A_FrameMethodMapIndex) mapIndex: A_FrameMethodMapIndex,\n        @A_Inject(A_FrameIndex) frameIndex: A_FrameIndex,\n        @A_Inject(A_FrameChannel) channel: A_FrameChannel,\n    ): Promise<void> {\n\n        const def = feature.definition;\n        if (!def) return;\n\n        // ── helpers ──────────────────────────────────────────────────────────\n\n        const tryMatchStep = (\n            step: A_FrameDynamicFeatureStep,\n            minScore: number,\n        ): Pick<A_FrameDynamicFeatureStepMapEntry, 'matchedClass' | 'matchedMethod' | 'matchScore'> => {\n            if (!step.embedding?.length) {\n                return { matchedClass: null, matchedMethod: null, matchScore: 0 };\n            }\n            const results = frameIndex.search(new A_FrameVector(step.embedding), { topK: 1 });\n            const top = results[0];\n            if (top && top.score >= minScore) {\n                // Method definitions store name = \"methodName\" and dependency.name = \"ClassName\".\n                // Class definitions store both name and dependency.name as the class name.\n                const matchedClass = top.record.dependency.name;\n                const matchedMethod = top.record.name;\n                return { matchedClass, matchedMethod, matchScore: top.score };\n            }\n            return { matchedClass: null, matchedMethod: null, matchScore: top?.score ?? 0 };\n        };\n\n        const tryMatchElement = (\n            el: { prompt: string; class?: string; embedding?: number[] },\n            minScore: number,\n        ): Pick<A_FrameDynamicFeatureElementMapEntry, 'matchedClass' | 'matchScore'> => {\n            if (!el.embedding?.length) {\n                return { matchedClass: null, matchScore: 0 };\n            }\n            const results = frameIndex.search(new A_FrameVector(el.embedding), { topK: 1 });\n            const top = results[0];\n            if (top && top.score >= minScore) {\n                return { matchedClass: top.record.name, matchScore: top.score };\n            }\n            return { matchedClass: null, matchScore: top?.score ?? 0 };\n        };\n\n        const stripEmbeddings = (d: A_FrameDynamicFeatureDefinition): A_FrameDynamicFeatureDefinition => {\n            const strip = (el: any): any => { const { embedding, ...rest } = el; return rest; };\n            return {\n                ...d,\n                steps:      d.steps.map(strip),\n                components: d.components.map(strip),\n                fragments:  d.fragments.map(strip),\n                entities:   d.entities.map(strip),\n            };\n        };\n\n        const matchAll = (d: A_FrameDynamicFeatureDefinition): void => {\n            mapIndex.clear();\n            for (const step of d.steps) {\n                mapIndex.setStep({\n                    prompt:  step.prompt,\n                    inputs:  step.inputs,\n                    outputs: step.outputs,\n                    ...tryMatchStep(step, feature.minScore),\n                });\n            }\n            for (const el of d.components) {\n                mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });\n            }\n            for (const el of d.fragments) {\n                mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });\n            }\n            for (const el of d.entities) {\n                mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });\n            }\n        };\n\n        // ── initial matching pass ─────────────────────────────────────────────\n\n        let workingDef = def;\n        matchAll(workingDef);\n\n        // ── retry loop: refine unmatched steps via server patch ───────────────\n\n        for (let retry = 0; retry < feature.maxRetries; retry++) {\n            const unmatchedSteps = workingDef.steps.filter(\n                step => step.embedding?.length && mapIndex.getStep(step.prompt)?.matchedMethod === null,\n            );\n            if (unmatchedSteps.length === 0) break;\n\n            const refinementInstruction = [\n                `The following workflow steps could not be matched to any registered method.`,\n                `Please re-describe each step with more specific, method-oriented language:`,\n                unmatchedSteps.map(s => `- \"${s.prompt}\"`).join('\\n'),\n            ].join('\\n');\n\n            const patchReq = new A_FrameChannelRequest<A_FrameFeaturePatchResponse>(\n                'POST',\n                '/api/v1/feature/patch',\n                {\n                    originalPrompt:    feature.prompt,\n                    definition:        stripEmbeddings(workingDef),\n                    patchInstruction:  refinementInstruction,\n                    model:             feature.modelName,\n                    context:           feature.contextHint,\n                },\n            );\n\n            const patchScope = new A_Scope({\n                name: `A_FrameMethodMapper.mapFeature:retry${retry}`,\n                fragments: [patchReq],\n            }).inherit(A_Context.scope(channel));\n\n            await channel.call(A_FrameFeatures.Request, patchScope);\n            patchScope.destroy();\n\n            if (!patchReq.response) break;\n\n            workingDef = patchReq.response.definition;\n            matchAll(workingDef);\n        }\n\n        // ── finalize: mark remaining unmatched steps with an error ────────────\n\n        for (const step of workingDef.steps) {\n            const entry = mapIndex.getStep(step.prompt);\n            if (entry && entry.matchedMethod === null && step.embedding?.length) {\n                mapIndex.setStep({\n                    ...entry,\n                    matchError: {\n                        title: A_FrameDynamicFeatureError.MethodNotFound,\n                        description: `Unable to match \"${step.prompt}\" to any registered method after ${feature.maxRetries} retries.`,\n                    },\n                });\n            }\n        }\n\n        // ── hydrate the feature with the map result ───────────────────────────\n\n        feature.hydrateFromMap(mapIndex.toResult(workingDef));\n    }\n}\n"]}

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

@@ -1,5 +1,17 @@
-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';
+import { p as A_FrameComponentMapEntry, q as A_FrameDynamicStructureDefinition, r as A_FrameComponentMapResult, s as A_FrameDynamicStructure, e as A_FrameChannel } from './A-FrameChannel.component-4mTNctXL.mjs';
+export { t as A_FrameComponentMapOptions, u as A_FrameDynamicStructureDefinitionEntity, v as A_FrameDynamicStructureEvents, w as A_FrameDynamicStructureFeatureNames, x as A_FrameDynamicStructureFeatures, y as A_FrameDynamicStructureOptions, z as A_FrameDynamicStructure_Init, B as A_FrameDynamicStructure_Serialized, C as A_FrameStructureGenerateResponse, D as A_FrameStructurePatchResponse, E as A_FrameStructureSelectCandidate, F as A_FrameStructureSelectElement, G as A_FrameStructureSelectRequest, H as A_FrameStructureSelectResolution, I as A_FrameStructureSelectResolutionType, J as A_FrameStructureSelectResponse, K as BaseClassName, L as DynamicStructureDefaultBasesNames } from './A-FrameChannel.component-4mTNctXL.mjs';
+import { A_Error, A_Fragment, A_Component } from '@adaas/a-concept';
+import { A_FrameIndex } from './frame-index.mjs';
+export { m as A_FrameDynamicPatch, n as A_FrameDynamicPatch_Init, o as A_FrameDynamicPatch_Serialized } from './A-FrameDynamicContentOperation.context-CoViNb19.mjs';
+import './A-FrameChannel.types-BXEKJK9t.mjs';
+import './A-FrameDefinition.types-BT02yAhQ.mjs';
+import './A-FrameNamespace.entity-BDg1FUgo.mjs';
+import './vector.mjs';
+import './A-FrameEnv.types-DnK-CYVk.mjs';
+import './A-FrameDefinition.entity-yA0GsBoe.mjs';
+import './A-FrameSegment.entity-D1xjjWvG.mjs';
+import './A-FrameCompletion.entity-Dzy9sIa8.mjs';
+import './A-FrameSchema.entity-DjYIhsoj.mjs';
 
 declare class A_FrameDynamicStructureError extends A_Error {
     static readonly InvalidPatch = "InvalidPatch";
@@ -9,4 +21,66 @@ declare class A_FrameDynamicStructureError extends A_Error {
     static readonly GenerationFailed = "GenerationFailed";
 }
 
-export { A_FrameDynamicStructureError };
+/**
+ * Context fragment that accumulates component-mapping results produced by
+ * `A_FrameComponentMapper.mapStructure()`.
+ *
+ * Uses a flat `prompt → A_FrameComponentMapEntry` map so lookups are O(1).
+ * Call `toResult(definition)` after the mapper has finished to build the
+ * structured `A_FrameComponentMapResult` that mirrors the definition layout.
+ */
+declare class A_FrameComponentMapIndex extends A_Fragment {
+    private _entries;
+    constructor();
+    /**
+     * Store (or overwrite) a map entry for the element identified by `entry.prompt`.
+     */
+    set(entry: A_FrameComponentMapEntry): void;
+    /**
+     * Retrieve the map entry for the given prompt, or `undefined` if not yet stored.
+     */
+    get(prompt: string): A_FrameComponentMapEntry | undefined;
+    /** Remove all stored entries. */
+    clear(): void;
+    /** Total number of stored entries. */
+    get size(): number;
+    /** All stored entries in insertion order. */
+    list(): A_FrameComponentMapEntry[];
+    /** Entries that have been successfully matched to a registered class. */
+    get matched(): A_FrameComponentMapEntry[];
+    /** Entries where no matching registered class was found. */
+    get unmatched(): A_FrameComponentMapEntry[];
+    /**
+     * Construct a fully structured `A_FrameComponentMapResult` from the
+     * accumulated entries and the provided definition.
+     *
+     * For each element in the definition the method looks up its entry by
+     * prompt.  If no entry exists (element had no server embedding), a default
+     * unmatched entry is generated so the result shape always matches the
+     * definition shape.
+     */
+    toResult(definition: A_FrameDynamicStructureDefinition): A_FrameComponentMapResult;
+}
+
+/**
+ * Stateless component that implements the `Map` feature for
+ * `A_FrameDynamicStructure`.
+ *
+ * Receives all necessary context via `@A_Inject` — it stores no state of its
+ * own.  Injects the calling structure (via `A_Caller`), the local definition
+ * index (`A_FrameIndex`), the map-result accumulator (`A_FrameComponentMapIndex`),
+ * and the HTTP channel (`A_FrameChannel`) needed for refinement retry calls.
+ *
+ * Algorithm:
+ *  1. Read `structure.definition` (raw, with server embeddings).
+ *  2. For every element run cosine-similarity search against `A_FrameIndex`.
+ *  3. For remaining unmatched elements (up to `structure.maxRetries`): ask the
+ *     server to refine their descriptions, then re-match the new definition.
+ *  4. Mark still-unmatched elements with a `matchError`.
+ *  5. Call `structure.hydrateFromMap(mapIndex.toResult(workingDef))`.
+ */
+declare class A_FrameComponentMapper extends A_Component {
+    mapStructure(structure: A_FrameDynamicStructure, mapIndex: A_FrameComponentMapIndex, frameIndex: A_FrameIndex, channel: A_FrameChannel): Promise<void>;
+}
+
+export { A_FrameComponentMapEntry, A_FrameComponentMapIndex, A_FrameComponentMapResult, A_FrameComponentMapper, A_FrameDynamicStructure, A_FrameDynamicStructureDefinition, A_FrameDynamicStructureError };

package/dist/browser/dynamic-structure.mjs

@@ -1,2 +1,2 @@
-import'./chunk-DMGQW3AO.mjs';import {A_Error,A_Entity,A_CommonHelper}from'@adaas/a-concept';var p={Load:"_A_FRAME_DYNAMIC_STRUCTURE_LOAD",Update:"_A_FRAME_DYNAMIC_STRUCTURE_UPDATE",Generate:"_A_FRAME_DYNAMIC_STRUCTURE_GENERATE"},_={Updated:"_A_FRAME_DYNAMIC_STRUCTURE_UPDATED"};var i=class extends A_Entity{constructor(){super(...arguments);this._version=0;}static get concept(){return "a-frame"}fromNew(e){this.createdAt=Date.now(),this._components=[],this._history=[],this._version=0,this.listeners=new Map,this.prompt=e.prompt,this.model=e.model,this.context=e.context??"generic",this.metaHint=e.metaHint??"",this.includeBases=(e.includeBases||[]).map(t=>typeof t=="string"?t:A_CommonHelper.getComponentName(t)),this.excludeBases=(e.excludeBases||[]).map(t=>typeof t=="string"?t:A_CommonHelper.getComponentName(t)),this.enabledComponents=(e.enabledComponents||[]).map(t=>typeof t=="string"?t:A_CommonHelper.getComponentName(t));}get components(){return this._components}get history(){return this._history}get version(){return this._version}async generate(){}async patch(e){this._version++;}revertTo(e){return this}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(e=>e.toJSON())}}subscribe(e,t){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(t);}unsubscribe(e,t){this.listeners.get(e)?.delete(t);}emit(e,t){this.listeners.get(e)?.forEach(a=>a(t));}};var n=class extends A_Error{};n.InvalidPatch="InvalidPatch",n.VersionMismatch="VersionMismatch",n.ComponentNotFound="ComponentNotFound",n.InvalidOperation="InvalidOperation",n.GenerationFailed="GenerationFailed";export{i as A_FrameDynamicStructure,n as A_FrameDynamicStructureError,_ as A_FrameDynamicStructureEvents,p as A_FrameDynamicStructureFeatures};//# sourceMappingURL=dynamic-structure.mjs.map
+import {a as a$1}from'./chunk-ZEONOTRL.mjs';import {l,h,k,r,f,a as a$3,j}from'./chunk-XR7FVA5M.mjs';export{k as A_FrameComponentMapIndex,l as A_FrameDynamicStructure,j as A_FrameDynamicStructureError,i as A_FrameDynamicStructureEvents,h as A_FrameDynamicStructureFeatures}from'./chunk-XR7FVA5M.mjs';import'./chunk-2RNFZSBL.mjs';export{a as A_FrameDynamicPatch}from'./chunk-UULJJ5C5.mjs';import'./chunk-6WAOMX7M.mjs';import'./chunk-K4MZY4ME.mjs';import'./chunk-CT67Y46H.mjs';import'./chunk-6NPQURSO.mjs';import'./chunk-TQPC5MYM.mjs';import'./chunk-BIBPE2GT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import {a as a$2}from'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import {a,b}from'./chunk-DMGQW3AO.mjs';import {A_Feature,A_Inject,A_Caller,A_Component,A_Scope,A_Context,A_Container,A_Fragment,A_Entity}from'@adaas/a-concept';var C=class extends A_Component{async mapStructure(a,n,D,b){let R=a.definition;if(!R)return;let p=(t,r,e)=>{if(!t.embedding?.length)return {matchedClass:null,matchScore:0};let i=D.search(new a$2(t.embedding),{topK:1,inherit:e})[0];return i&&i.score>=r?{matchedClass:i.record.name,matchScore:i.score}:{matchedClass:null,matchScore:i?.score??0}},w=t=>[...t.containers,...t.containers.flatMap(r=>[...r.components??[],...r.fragments??[],...r.entities??[]]),...t.components,...t.fragments,...t.entities],T=(t,r)=>{if(r.containers.some(e=>e.prompt===t.prompt))return {class:A_Container};if(r.components.some(e=>e.prompt===t.prompt))return {class:A_Component};if(r.fragments.some(e=>e.prompt===t.prompt))return {class:A_Fragment};if(r.entities.some(e=>e.prompt===t.prompt))return {class:A_Entity};for(let e of r.containers){if((e.components??[]).some(o=>o.prompt===t.prompt))return {class:A_Component};if((e.fragments??[]).some(o=>o.prompt===t.prompt))return {class:A_Fragment};if((e.entities??[]).some(o=>o.prompt===t.prompt))return {class:A_Entity}}},V=(t,r,e,o,i)=>{let c=m=>{m.prompt===r&&(m.prompt=e,m.embedding=o,i!==void 0&&(m.role=i));};t.containers.forEach(c),t.containers.forEach(m=>{(m.components??[]).forEach(c),(m.fragments??[]).forEach(c),(m.entities??[]).forEach(c);}),t.components.forEach(c),t.fragments.forEach(c),t.entities.forEach(c);},z=t=>{n.clear();let r=a.minScore;for(let e of t.containers){n.set({prompt:e.prompt,role:e.role,class:e.class,...p(e,r,{class:A_Container})});for(let o of e.components??[])n.set({prompt:o.prompt,role:o.role,class:o.class,...p(o,r,{class:A_Component})});for(let o of e.fragments??[])n.set({prompt:o.prompt,role:o.role,class:o.class,...p(o,r,{class:A_Fragment})});for(let o of e.entities??[])n.set({prompt:o.prompt,role:o.role,class:o.class,...p(o,r,{class:A_Entity})});}for(let e of t.components)n.set({prompt:e.prompt,role:e.role,class:e.class,...p(e,r,{class:A_Component})});for(let e of t.fragments)n.set({prompt:e.prompt,role:e.role,class:e.class,...p(e,r,{class:A_Fragment})});for(let e of t.entities)n.set({prompt:e.prompt,role:e.role,class:e.class,...p(e,r,{class:A_Entity})});},l=R;z(l);for(let t=0;t<a.maxRetries;t++){let r=w(l).filter(s=>s.embedding?.length&&n.get(s.prompt)?.matchedClass===null);if(r.length===0)break;let e=a.candidateCount,o=r.map(s=>{n.get(s.prompt);let g=D.search(new a$2(s.embedding),{topK:e});return {prompt:s.prompt,role:s.role,candidates:g.map(u=>({name:u.record.name,description:u.record.description}))}}),i=new f("POST","/api/v1/structure/select",{originalPrompt:a.prompt,elements:o,model:a.modelName}),c=new A_Scope({name:`A_FrameComponentMapper.mapStructure:select${t}`,fragments:[i]}).inherit(A_Context.scope(b));if(await b.call(a$3.Request,c),c.destroy(),!i.response)break;let m=false;for(let s of i.response.resolutions){let f=n.get(s.elementPrompt);if(f){if(s.type==="select"&&s.selectedClass)n.set({...f,matchedClass:s.selectedClass,matchScore:1}),m=true;else if(s.type==="suggest"&&s.suggestion){let{prompt:g,role:u,embedding:E}=s.suggestion;if(E?.length){let P=r.find(G=>G.prompt===s.elementPrompt),B=P?T(P,l):void 0,_=D.search(new a$2(E),{topK:1,inherit:B})[0];_&&_.score>=a.minScore?(n.set({...f,matchedClass:_.record.name,matchScore:_.score}),m=true):(n.set({...f,prompt:g,role:u}),V(l,s.elementPrompt,g,E,u),m=true);}else n.set({...f,prompt:g,role:u}),m=true;}}}if(!m)break}for(let t of w(l)){let r=n.get(t.prompt);r&&r.matchedClass===null&&t.embedding?.length&&n.set({...r,matchError:{title:j.ComponentNotFound,description:`Unable to match "${t.prompt}" to any registered implementation after ${a.maxRetries} retries.`}});}a.hydrateFromMap(n.toResult(l));}};a([A_Feature.Extend({name:h.Map,scope:[l]}),b(0,A_Inject(A_Caller)),b(1,A_Inject(k)),b(2,A_Inject(a$1)),b(3,A_Inject(r))],C.prototype,"mapStructure",1);export{C as A_FrameComponentMapper};//# sourceMappingURL=dynamic-structure.mjs.map
 //# sourceMappingURL=dynamic-structure.mjs.map