@adaas/are 0.0.2 → 0.0.4

package/dist/node/lib/AreStore/AreStore.context.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/AreStore/AreStore.context.ts"],"names":[],"mappings":";;;;AASO,IAAM,QAAA,GAAN,cAEG,kBAAA,CAAsB;AAAA,EAE5B,YAAY,KAAA,EAAc;AACtB,IAAA,KAAA,CAAM,KAAA,CAAM,UAAU,CAAA;AAAA,EAC1B;AAAA,EAMA,GAAA,CACI,QACA,MAAA,EACI;AACJ,IAAA,IAAI,OAAO,WAAW,QAAA,EAAU;AAC5B,MAAA,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM;AAC7C,QAAA,KAAA,CAAM,GAAA,CAAI,KAAU,KAAa,CAAA;AAAA,MACrC,CAAC,CAAA;AAAA,IACL,CAAA,MAAA,IAAW,WAAW,MAAA,EAAW;AAC7B,MAAA,KAAA,CAAM,GAAA,CAAI,QAAa,MAAM,CAAA;AAAA,IACjC;AACA,IAAA,OAAO,IAAA;AAAA,EACX;AAEJ;AA1Ba,QAAA,GAAN,eAAA,CAAA;AAAA,EAHN,QAAQ,QAAA,CAAS;AAAA,IACd,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACY,QAAA,CAAA","file":"AreStore.context.mjs","sourcesContent":["import { ASEID } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { A_ExecutionContext } from \"@adaas/a-utils/a-execution\";\n\n\n\n@A_Frame.Fragment({\n    description: \"Are Store uses to keep AreNode related information for interpolations, runtime data, etc. This object can be injected to manipulate with data at runtime.\",\n})\nexport class AreStore<\n    T extends Record<string, any> = Record<string, any>\n> extends A_ExecutionContext<T> {\n\n    constructor(aseid: ASEID) {\n        super(aseid.toString());\n    }\n\n\n\n    set<K extends keyof T>(values: Partial<T>): this \n    set<K extends keyof T>(key: K, value: T[K]): this \n    set<K extends keyof T>(\n        param1: K | Partial<T>,\n        param2?: T[K]\n    ): this {\n        if (typeof param1 === 'object') {\n            Object.entries(param1).forEach(([key, value]) => {\n                super.set(key as K, value as T[K]);\n            });\n        } else if (param2 !== undefined) {\n            super.set(param1 as K, param2);\n        }\n        return this;\n    }\n\n}"]}
+{"version":3,"sources":["../../../../src/lib/AreStore/AreStore.context.ts"],"names":[],"mappings":"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","file":"AreStore.context.mjs","sourcesContent":["import { A_Context, A_TYPES__ComponentMeta, A_TYPES__Paths, ASEID } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { A_ExecutionContext } from \"@adaas/a-utils/a-execution\";\nimport type { AreNode } from \"@adaas/are/node/AreNode.entity\";\nimport type { Are } from \"@adaas/are/component/Are.component\";\nimport type { AreMeta } from \"@adaas/are/component/Are.meta\";\nimport { AreStoreAreComponentMetaKeys } from \"./AreStore.constants\";\nimport { AreStorePathValue, AreStoreWatchingEntity } from \"./AreStore.types\";\nimport { AreContext } from \"@adaas/are/component/Are.context\";\nimport { A_UtilsHelper } from \"@adaas/a-utils/helpers\";\n\n\n\n\n@A_Frame.Fragment({\n    description: \"Are Store uses to keep AreNode related information for interpolations, runtime data, etc. This object can be injected to manipulate with data at runtime.\",\n})\nexport class AreStore<\n    T extends Record<string, any> = Record<string, any>\n> extends A_ExecutionContext<T> {\n\n    protected dependencies: Map<string, Set<AreStoreWatchingEntity>> = new Map();\n\n    protected _keys: Set<keyof T> = new Set();\n\n\n\n    /**\n     * Allows to define a pure function that will be executed in the context of the store, so it can access the store's data and methods, but it won't have access to the component's scope or other features. This can be useful for example for defining a function that will update the store's data based on some logic, without having access to the component's scope or other features, so we can keep the store's logic separate from the component's logic.\n     */\n    static get Function() {\n        return <T extends Are>(target: T, propertyKey: string, descriptor: PropertyDescriptor) => {\n            // TODO: fix types\n            const targetMeta = A_Context.meta<AreMeta<A_TYPES__ComponentMeta>, T>(target.constructor as any) as any;\n\n            const originalMethod = descriptor.value;\n\n            const allExtensions = targetMeta.get(AreStoreAreComponentMetaKeys.StoreExtensions) || {};\n\n            allExtensions[propertyKey] = originalMethod;\n\n            targetMeta.set(AreStoreAreComponentMetaKeys.StoreExtensions, allExtensions);\n\n            return descriptor;\n        }\n    }\n\n    get owner(): AreNode {\n        return A_Context.scope(this).issuer() as AreNode;\n    }\n\n    get parent(): AreStore | undefined {\n        return this.owner.parent?.scope.resolve<AreStore>(AreStore);\n    }\n\n    get context(): AreContext {\n        return A_Context.scope(this).resolve(AreContext) as AreContext;\n    }\n\n    constructor(aseid: ASEID | string) {\n        super(aseid.toString());\n    }\n\n    get watchers(): Set<AreStoreWatchingEntity> {\n        return this.context.get('watchers') || new Set();\n    }\n\n    get keys(): Set<keyof T> {\n        return this._keys;\n    }\n\n\n    watch(instruction: AreStoreWatchingEntity): void {\n        const watchers: Set<AreStoreWatchingEntity> = this.context.get('watchers') || new Set();\n        watchers.add(instruction);\n        this.context.set('watchers', watchers);\n    }\n\n    unwatch(instruction: AreStoreWatchingEntity): void {\n        const watchers: Set<AreStoreWatchingEntity> = this.context.get('watchers') || new Set();\n        watchers.delete(instruction);\n        this.context.set('watchers', watchers);\n    }\n\n    set<K extends keyof T>(values: Partial<T>): this\n    set<P extends A_TYPES__Paths<T>>(key: P, value: AreStorePathValue<T, P>): this\n    set<K extends keyof T, P extends A_TYPES__Paths<T>>(\n        param1: K | Partial<T> | P,\n        param2?: T[K] | AreStorePathValue<T, P>\n    ): this {\n        if (typeof param1 === 'string' && param2 !== undefined) {\n            this.setAsKeyValue(param1 as P, param2 as AreStorePathValue<T, P>);\n        } else if (typeof param1 === 'object') {\n            this.setAsObject(param1 as Partial<T>);\n        } else {\n            throw new Error('Invalid parameters for set method. Expected either (key: string, value: any) or (values: object).');\n        }\n\n\n        return this;\n    }\n\n\n    get<K extends keyof T>(key: K): T[K] | undefined {\n        const [firstPart, ...pathPart] = String(key).split('.');\n\n        if (!this._keys.has(firstPart as keyof T)) {\n            return this.parent?.get(key as any);\n        }\n\n        if (this.watchers.size > 0) {\n            const ancestors = this.extractPathSegments(String(key))\n\n            for (const ancestor of ancestors) {\n                // normalize once at registration — not at lookup\n                const normAncestor = this.normalizePath(ancestor)\n\n                if (!this.dependencies.has(normAncestor)) {\n                    this.dependencies.set(normAncestor, new Set())\n                }\n\n\n                this.watchers.forEach(watcher => this.dependencies.get(normAncestor)!.add(watcher))\n            }\n        }\n\n        const primaryObject = super.get(firstPart);\n\n        const value = A_UtilsHelper.getByPath(primaryObject, pathPart.join('.'));\n\n        return value as T[K] | undefined;\n    }\n\n\n    protected setAsObject(values: Partial<T>): this {\n        const entires = Object.entries(values);\n\n        for (const [key, value] of entires) {\n\n            this._keys.add(key as keyof T);\n            super.set(key as keyof T, value as T[keyof T]);\n\n            // normalize once — dependencies are already stored normalized\n            const normChanged = this.normalizePath(String(key))\n            const prefix = normChanged + '.'\n\n\n            for (const [normRegistered, instructions] of this.dependencies) {\n                if (\n                    normRegistered === normChanged ||   // exact\n                    normRegistered.startsWith(prefix) ||   // descendant\n                    normChanged.startsWith(normRegistered + '.') // ancestor\n                ) {\n                    this.notify(instructions)\n                }\n            }\n\n        }\n        return this;\n    }\n\n    protected setAsKeyValue<K extends keyof T, P extends A_TYPES__Paths<T>>(\n        key: K | P,\n        value: T[K] | AreStorePathValue<T, P>\n    ): this {\n        const [firstPart, ...pathPart] = String(key).split('.');\n\n        this._keys.add(firstPart as keyof T);\n\n        const primaryObject = super.get(firstPart);\n\n        const result = A_UtilsHelper.setBypath(primaryObject, pathPart.join('.'), value);\n\n        super.set(firstPart as keyof T, result ? result[firstPart] : value);\n\n        // normalize once — dependencies are already stored normalized\n        const normChanged = this.normalizePath(String(key))\n        const prefix = normChanged + '.'\n\n        for (const [normRegistered, instructions] of this.dependencies) {\n            if (\n                normRegistered === normChanged ||   // exact\n                normRegistered.startsWith(prefix) ||   // descendant\n                normChanged.startsWith(normRegistered + '.') // ancestor\n            ) {\n                this.notify(instructions)\n            }\n        }\n\n        return this;\n    }\n\n\n    /**\n     * Notifies instructions — immediately or deferred if inside a batch.\n     */\n    private notify(instructions: Set<AreStoreWatchingEntity>): void {\n        for (const instruction of instructions) {\n\n            try {\n                instruction.update()\n            } catch (error) {\n\n            }\n            // instruction.owner.scene.unApply(instruction);\n        }\n    }\n    /**\n     * Removes an instruction from all dependency sets.\n     * Called when an instruction is reverted/destroyed.\n     */\n    unregister(instruction: AreStoreWatchingEntity): void {\n        for (const instructions of this.dependencies.values()) {\n            instructions.delete(instruction);\n        }\n    }\n    /**\n     * Normalizes a path once — reused in both get and set.\n     */\n    private normalizePath(path: string): string {\n        return path.replace(/\\[(\\d+)\\]/g, '.$1')\n    }\n\n    /**\n     * Extracts direct children of the current markup level into typed instances.\n     * No tree walking, recursion, or nested parsing — just direct children.\n     */\n    extractPathSegments(path: string): string[] {\n        const normalized = path.replace(/\\[(\\d+)\\]/g, '.$1')\n        const parts = normalized.split('.').filter(Boolean)\n        const ancestors: string[] = []\n        let current = ''\n\n        for (let i = 0; i < parts.length; i++) {\n            const part = parts[i]\n            const isIndex = /^\\d+$/.test(part)\n\n            if (i === 0) {\n                current = part\n            } else if (isIndex) {\n                current = `${current}[${part}]`\n            } else {\n                current = `${current}.${part}`\n            }\n\n            ancestors.push(current)\n        }\n\n        return ancestors\n    }\n\n    /**\n     * Method allows to initialize all extensions defined in the component with @AreStore.Function decorator, so we can use them in the store's context. This method should be called in the component's constructor after super() call, so the store will have access to the component's instance and its properties.\n     * \n     * @param component \n     */\n    loadExtensions(component: Are) {\n        const targetMeta = A_Context.meta<AreMeta<A_TYPES__ComponentMeta>, Are>(component as any) as any;\n\n        const allExtensions = targetMeta.get(AreStoreAreComponentMetaKeys.StoreExtensions) || {};\n\n        this.set(allExtensions);\n    }\n\n}\n"]}

package/dist/node/lib/AreStore/AreStore.types.d.mts

@@ -0,0 +1,9 @@
+import { AreStoreAreComponentMetaKeys } from './AreStore.constants.mjs';
+
+type AreStorePathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? AreStorePathValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+type AreStoreWatchingEntity = {
+    update(...args: any[]): void;
+};
+type AreStoreAreComponentMetaKeyNames = typeof AreStoreAreComponentMetaKeys[keyof typeof AreStoreAreComponentMetaKeys];
+
+export type { AreStoreAreComponentMetaKeyNames, AreStorePathValue, AreStoreWatchingEntity };

package/dist/node/lib/AreStore/AreStore.types.d.ts

@@ -0,0 +1,9 @@
+import { AreStoreAreComponentMetaKeys } from './AreStore.constants.js';
+
+type AreStorePathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? AreStorePathValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+type AreStoreWatchingEntity = {
+    update(...args: any[]): void;
+};
+type AreStoreAreComponentMetaKeyNames = typeof AreStoreAreComponentMetaKeys[keyof typeof AreStoreAreComponentMetaKeys];
+
+export type { AreStoreAreComponentMetaKeyNames, AreStorePathValue, AreStoreWatchingEntity };

package/dist/node/lib/AreStore/AreStore.types.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=AreStore.types.js.map
+//# sourceMappingURL=AreStore.types.js.map

package/dist/node/lib/AreStore/AreStore.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"AreStore.types.js"}

package/dist/node/lib/AreStore/AreStore.types.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=AreStore.types.mjs.map
+//# sourceMappingURL=AreStore.types.mjs.map

package/dist/node/lib/AreStore/AreStore.types.mjs.map

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

package/dist/node/lib/AreSyntax/AreSyntax.constants.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/node/lib/AreSyntax/AreSyntax.constants.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/node/lib/AreSyntax/AreSyntax.constants.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=AreSyntax.constants.js.map
+//# sourceMappingURL=AreSyntax.constants.js.map

package/dist/node/lib/AreSyntax/AreSyntax.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"AreSyntax.constants.js"}

package/dist/node/lib/AreSyntax/AreSyntax.constants.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=AreSyntax.constants.mjs.map
+//# sourceMappingURL=AreSyntax.constants.mjs.map

package/dist/node/lib/AreSyntax/AreSyntax.constants.mjs.map

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

package/dist/node/lib/AreSyntax/AreSyntax.context.d.mts

@@ -1,80 +1,128 @@
 import { A_Fragment } from '@adaas/a-concept';
-import { AreSyntaxInitOptions } from './AreSyntax.types.mjs';
+import { q as AreSyntaxInitOptions, t as AreSyntaxTokenRules, g as AreNode, p as AreSyntaxCompiledExpression, o as AreStore } from '../../Are.context-D7w32H1G.mjs';
+import '@adaas/a-utils/a-signal';
+import '../AreEvent/AreEvent.context.mjs';
+import '@adaas/a-utils/a-execution';
+import '../AreStore/AreStore.types.mjs';
+import '../AreStore/AreStore.constants.mjs';
+import '../AreScene/AreScene.constants.mjs';
+import '../AreAttribute/AreAttribute.types.mjs';
+import '../AreAttribute/AreAttribute.constants.mjs';
+import '../AreComponent/Are.component.mjs';
+import '../AreComponent/Are.types.mjs';
+import '../AreComponent/Are.constants.mjs';
+import '../AreNode/AreNode.constants.mjs';
 
-declare class AreSyntaxContext extends A_Fragment {
+declare class AreSyntax extends A_Fragment {
     /**
-     * Initialization options for configuring the AreSyntax context.
+     * Max allowed length of an expression string to prevent excessively long inputs that could lead to performance issues or abuse.
      */
-    protected readonly config: Partial<AreSyntaxInitOptions>;
-    constructor(
+    private readonly MAX_LENGTH;
     /**
-     * Initialization options for configuring the AreSyntax context.
+     * Max allowed nesting depth of parentheses, brackets, and braces in expressions to prevent excessively complex inputs that could lead to performance issues or abuse. Default is 5 levels of nesting.
      */
-    config?: Partial<AreSyntaxInitOptions>);
+    private readonly MAX_DEPTH;
     /**
-     * identifier of the root tag to use when compiling in browser context.
-     *
-     * @return {string} The root tag identifier.
+     * List of regex patterns that are blocked in expressions to prevent access to unsafe or sensitive features. This includes patterns for global objects, functions, and syntax that could be used for malicious purposes (e.g. "eval", "Function", "fetch", "XMLHttpRequest", "import", "require", "document", "window", "globalThis", "global", "process", "__proto__", "constructor", "prototype"). Expressions containing any of these patterns will be rejected during validation.
      */
-    get rootTag(): string;
+    private readonly BLOCKED_PATTERNS;
     /**
-     * List of standard HTML tags to recognize.
-     * [!] This is a set of tags that can be ignored when determining if a node is a custom component.
-     *
-     * @return {Set<string>} A set of standard HTML tag names.
+     * Set of global identifiers that are blocked in expressions to prevent access to unsafe or sensitive features. This includes global objects and functions that could be used for malicious purposes (e.g. "eval", "Function", "fetch", "XMLHttpRequest", "document", "window", "globalThis", "global", "process", "setTimeout", "setInterval", "localStorage", "sessionStorage", "indexedDB", "WebSocket", "Worker"). Accessing any of these identifiers in an expression will be rejected during validation.
      */
-    get standardTags(): Set<string>;
+    private readonly BLOCKED_GLOBALS;
     /**
-     * Enable or disable debug mode for syntax parsing.
-     * When enabled, additional debug information will be logged during parsing.
-     *
-     * @return {boolean} True if debug mode is enabled, false otherwise.
+     * Regex pattern that defines the allowed characters in expressions. This pattern allows letters, digits, whitespace, and common operators and punctuation used in JavaScript expressions. Expressions containing characters that do not match this pattern will be rejected during validation to prevent injection of potentially harmful code.
      */
-    get debugMode(): boolean;
+    private readonly ALLOWED_CHARS;
     /**
-     * Custom interpolation delimiters for template parsing.
-     * Default is ['{{', '}}'].
-     *
-     * @return {[string, string]} The opening and closing interpolation delimiters.
+     * Simple dot-path identifier pattern (e.g. "name", "user.name", "user.profile.name").
+     * Matches strings that consist solely of identifier characters separated by dots.
      */
-    get interpolationDelimiters(): [string, string];
+    private readonly SIMPLE_PATH;
     /**
-     * Custom binding delimiter for data binding parsing.
-     * Default is ':'.
-     * @return {string} The binding delimiter.
+     * Compiled expression — a pre-parsed function ready for repeated execution.
+     * Created once via compile(), reused on every apply/click.
      */
-    get bindingDelimiter(): string;
+    private readonly _rules;
+    private readonly _trimWhitespace;
+    private readonly _strictMode;
+    constructor(config?: Partial<AreSyntaxInitOptions>);
     /**
-     * Custom listener delimiter for event binding parsing.
-     * Default is '@'.
-     *
-     * @return {string} The listener delimiter.
+     * Get the array of token rules that define the syntax for parsing templates. Each rule specifies how to identify and process a particular type of token (e.g. interpolation, directive, comment) within templates. The rules are checked in order of priority, allowing for flexible and customizable parsing behavior.
      */
-    get listenerDelimiter(): string;
+    get rules(): AreSyntaxTokenRules<AreNode>[];
     /**
-     * Enable or disable strict mode for syntax parsing.
-     * When enabled, the parser will throw errors for any syntax violations.
-     * Default is true.
-     *
-     * @return {boolean} True if strict mode is enabled, false otherwise.
+     * Indicates whether leading and trailing whitespace should be trimmed from token content. When enabled, any whitespace at the start or end of the content captured by a token will be removed before further processing. This can help prevent issues with unintended spaces affecting rendering or logic, especially in cases like interpolations or directives where extra whitespace may be common. Default is true.
+     */
+    get trimWhitespace(): boolean;
+    /**
+     * Indicates whether the parser should throw an error when it encounters unclosed tokens. When enabled, if the parser finds an opening delimiter without a corresponding closing delimiter (e.g. an unclosed interpolation or directive), it will throw an error instead of silently ignoring it. This can help catch syntax errors and ensure that templates are well-formed. Default is true.
      */
     get strictMode(): boolean;
     /**
-     * Enable or disable whitespace trimming in templates.
-     * When enabled, leading and trailing whitespace in template expressions will be trimmed.
-     * Default is true.
+     * Compiles an expression string into a reusable executor.
+     * Performs validation and Function construction once.
+     * Use when the same expression will be evaluated multiple times
+     * e.g. event handlers, instructions that re-apply on store changes.
      *
-     * @return {boolean} True if whitespace trimming is enabled, false otherwise.
+     * @example
+     *   // compile once at apply() time
+     *   const compiled = AreCommonHelper.compile('(e) => !!pageTitle ? $testHandler(e, item) : null')
+     *
+     *   // execute on every click — no re-parsing, no re-validation
+     *   element.addEventListener('click', (e) => {
+     *       const fn = compiled.execute(store, { $testHandler: handler, item })
+     *       if (typeof fn === 'function') fn(e)
+     *   })
      */
-    get trimWhitespace(): boolean;
+    compile(expr: string): AreSyntaxCompiledExpression;
+    /**
+     * Evaluates an expression string against the provided store.
+     * Automatically determines whether the result should be callable
+     * based on the shape of the expression.
+     *
+     * Returns the raw value for plain expressions (interpolations, bindings).
+     * Returns a bound function for callable expressions (event handlers).
+     *
+     * @param expr  Expression string to evaluate.
+     * @param store AreStore used for identifier resolution.
+     * @param scope Optional extra bindings checked **before** the store.
+     *              Useful for injecting event-specific values (`$event`, `element`)
+     *              or emit wrappers (`$handleClick`).
+     *
+     * @example
+     *   // simple value
+     *   evaluate('user.name', store)
+     *
+     *   // with emit wrapper
+     *   evaluate('$handleClick($event, user.name)', store, {
+     *       $event: domEvent,
+     *       $handleClick: (...args) => node.emit(new AreEvent('handleClick', args)),
+     *   })
+     *
+     *   // arrow with conditional
+     *   evaluate('(e) => isValid(user.name) ? $handleClick(e) : null', store, {
+     *       $handleClick: (...args) => node.emit(new AreEvent('handleClick', args)),
+     *   })
+     */
+    evaluate(expr: string, store: AreStore, scope?: Record<string, any>): any;
     /**
-     * Custom directive delimiter for directive parsing.
-     * Default is '$'.
+     * Extracts $-prefixed handler names from an expression.
+     * These represent event emission targets, not store references.
      *
-     * @return {string} The directive delimiter.
+     * Examples:
+     *   "$handleClick"                                     → Set(["handleClick"])
+     *   "$handleClick(user.name)"                           → Set(["handleClick"])
+     *   "(e) => isValid(user.name) ? $handleClick(e) : null" → Set(["handleClick"])
      */
-    get directiveDelimiter(): string;
-    get customDirectives(): string[];
+    extractEmitHandlers(expr: string): Set<string>;
+    private isCallableExpression;
+    private validate;
+    private checkDepth;
+    private createSandbox;
+    private nestedHandler;
+    private assertSafeKey;
+    private execute;
 }
 
-export { AreSyntaxContext };
+export { AreSyntax };

package/dist/node/lib/AreSyntax/AreSyntax.context.d.ts

@@ -1,80 +1,128 @@
 import { A_Fragment } from '@adaas/a-concept';
-import { AreSyntaxInitOptions } from './AreSyntax.types.js';
+import { q as AreSyntaxInitOptions, t as AreSyntaxTokenRules, g as AreNode, p as AreSyntaxCompiledExpression, o as AreStore } from '../../Are.context-9Ija_fdC.js';
+import '@adaas/a-utils/a-signal';
+import '../AreEvent/AreEvent.context.js';
+import '@adaas/a-utils/a-execution';
+import '../AreStore/AreStore.types.js';
+import '../AreStore/AreStore.constants.js';
+import '../AreScene/AreScene.constants.js';
+import '../AreAttribute/AreAttribute.types.js';
+import '../AreAttribute/AreAttribute.constants.js';
+import '../AreComponent/Are.component.js';
+import '../AreComponent/Are.types.js';
+import '../AreComponent/Are.constants.js';
+import '../AreNode/AreNode.constants.js';
 
-declare class AreSyntaxContext extends A_Fragment {
+declare class AreSyntax extends A_Fragment {
     /**
-     * Initialization options for configuring the AreSyntax context.
+     * Max allowed length of an expression string to prevent excessively long inputs that could lead to performance issues or abuse.
      */
-    protected readonly config: Partial<AreSyntaxInitOptions>;
-    constructor(
+    private readonly MAX_LENGTH;
     /**
-     * Initialization options for configuring the AreSyntax context.
+     * Max allowed nesting depth of parentheses, brackets, and braces in expressions to prevent excessively complex inputs that could lead to performance issues or abuse. Default is 5 levels of nesting.
      */
-    config?: Partial<AreSyntaxInitOptions>);
+    private readonly MAX_DEPTH;
     /**
-     * identifier of the root tag to use when compiling in browser context.
-     *
-     * @return {string} The root tag identifier.
+     * List of regex patterns that are blocked in expressions to prevent access to unsafe or sensitive features. This includes patterns for global objects, functions, and syntax that could be used for malicious purposes (e.g. "eval", "Function", "fetch", "XMLHttpRequest", "import", "require", "document", "window", "globalThis", "global", "process", "__proto__", "constructor", "prototype"). Expressions containing any of these patterns will be rejected during validation.
      */
-    get rootTag(): string;
+    private readonly BLOCKED_PATTERNS;
     /**
-     * List of standard HTML tags to recognize.
-     * [!] This is a set of tags that can be ignored when determining if a node is a custom component.
-     *
-     * @return {Set<string>} A set of standard HTML tag names.
+     * Set of global identifiers that are blocked in expressions to prevent access to unsafe or sensitive features. This includes global objects and functions that could be used for malicious purposes (e.g. "eval", "Function", "fetch", "XMLHttpRequest", "document", "window", "globalThis", "global", "process", "setTimeout", "setInterval", "localStorage", "sessionStorage", "indexedDB", "WebSocket", "Worker"). Accessing any of these identifiers in an expression will be rejected during validation.
      */
-    get standardTags(): Set<string>;
+    private readonly BLOCKED_GLOBALS;
     /**
-     * Enable or disable debug mode for syntax parsing.
-     * When enabled, additional debug information will be logged during parsing.
-     *
-     * @return {boolean} True if debug mode is enabled, false otherwise.
+     * Regex pattern that defines the allowed characters in expressions. This pattern allows letters, digits, whitespace, and common operators and punctuation used in JavaScript expressions. Expressions containing characters that do not match this pattern will be rejected during validation to prevent injection of potentially harmful code.
      */
-    get debugMode(): boolean;
+    private readonly ALLOWED_CHARS;
     /**
-     * Custom interpolation delimiters for template parsing.
-     * Default is ['{{', '}}'].
-     *
-     * @return {[string, string]} The opening and closing interpolation delimiters.
+     * Simple dot-path identifier pattern (e.g. "name", "user.name", "user.profile.name").
+     * Matches strings that consist solely of identifier characters separated by dots.
      */
-    get interpolationDelimiters(): [string, string];
+    private readonly SIMPLE_PATH;
     /**
-     * Custom binding delimiter for data binding parsing.
-     * Default is ':'.
-     * @return {string} The binding delimiter.
+     * Compiled expression — a pre-parsed function ready for repeated execution.
+     * Created once via compile(), reused on every apply/click.
      */
-    get bindingDelimiter(): string;
+    private readonly _rules;
+    private readonly _trimWhitespace;
+    private readonly _strictMode;
+    constructor(config?: Partial<AreSyntaxInitOptions>);
     /**
-     * Custom listener delimiter for event binding parsing.
-     * Default is '@'.
-     *
-     * @return {string} The listener delimiter.
+     * Get the array of token rules that define the syntax for parsing templates. Each rule specifies how to identify and process a particular type of token (e.g. interpolation, directive, comment) within templates. The rules are checked in order of priority, allowing for flexible and customizable parsing behavior.
      */
-    get listenerDelimiter(): string;
+    get rules(): AreSyntaxTokenRules<AreNode>[];
     /**
-     * Enable or disable strict mode for syntax parsing.
-     * When enabled, the parser will throw errors for any syntax violations.
-     * Default is true.
-     *
-     * @return {boolean} True if strict mode is enabled, false otherwise.
+     * Indicates whether leading and trailing whitespace should be trimmed from token content. When enabled, any whitespace at the start or end of the content captured by a token will be removed before further processing. This can help prevent issues with unintended spaces affecting rendering or logic, especially in cases like interpolations or directives where extra whitespace may be common. Default is true.
+     */
+    get trimWhitespace(): boolean;
+    /**
+     * Indicates whether the parser should throw an error when it encounters unclosed tokens. When enabled, if the parser finds an opening delimiter without a corresponding closing delimiter (e.g. an unclosed interpolation or directive), it will throw an error instead of silently ignoring it. This can help catch syntax errors and ensure that templates are well-formed. Default is true.
      */
     get strictMode(): boolean;
     /**
-     * Enable or disable whitespace trimming in templates.
-     * When enabled, leading and trailing whitespace in template expressions will be trimmed.
-     * Default is true.
+     * Compiles an expression string into a reusable executor.
+     * Performs validation and Function construction once.
+     * Use when the same expression will be evaluated multiple times
+     * e.g. event handlers, instructions that re-apply on store changes.
      *
-     * @return {boolean} True if whitespace trimming is enabled, false otherwise.
+     * @example
+     *   // compile once at apply() time
+     *   const compiled = AreCommonHelper.compile('(e) => !!pageTitle ? $testHandler(e, item) : null')
+     *
+     *   // execute on every click — no re-parsing, no re-validation
+     *   element.addEventListener('click', (e) => {
+     *       const fn = compiled.execute(store, { $testHandler: handler, item })
+     *       if (typeof fn === 'function') fn(e)
+     *   })
      */
-    get trimWhitespace(): boolean;
+    compile(expr: string): AreSyntaxCompiledExpression;
+    /**
+     * Evaluates an expression string against the provided store.
+     * Automatically determines whether the result should be callable
+     * based on the shape of the expression.
+     *
+     * Returns the raw value for plain expressions (interpolations, bindings).
+     * Returns a bound function for callable expressions (event handlers).
+     *
+     * @param expr  Expression string to evaluate.
+     * @param store AreStore used for identifier resolution.
+     * @param scope Optional extra bindings checked **before** the store.
+     *              Useful for injecting event-specific values (`$event`, `element`)
+     *              or emit wrappers (`$handleClick`).
+     *
+     * @example
+     *   // simple value
+     *   evaluate('user.name', store)
+     *
+     *   // with emit wrapper
+     *   evaluate('$handleClick($event, user.name)', store, {
+     *       $event: domEvent,
+     *       $handleClick: (...args) => node.emit(new AreEvent('handleClick', args)),
+     *   })
+     *
+     *   // arrow with conditional
+     *   evaluate('(e) => isValid(user.name) ? $handleClick(e) : null', store, {
+     *       $handleClick: (...args) => node.emit(new AreEvent('handleClick', args)),
+     *   })
+     */
+    evaluate(expr: string, store: AreStore, scope?: Record<string, any>): any;
     /**
-     * Custom directive delimiter for directive parsing.
-     * Default is '$'.
+     * Extracts $-prefixed handler names from an expression.
+     * These represent event emission targets, not store references.
      *
-     * @return {string} The directive delimiter.
+     * Examples:
+     *   "$handleClick"                                     → Set(["handleClick"])
+     *   "$handleClick(user.name)"                           → Set(["handleClick"])
+     *   "(e) => isValid(user.name) ? $handleClick(e) : null" → Set(["handleClick"])
      */
-    get directiveDelimiter(): string;
-    get customDirectives(): string[];
+    extractEmitHandlers(expr: string): Set<string>;
+    private isCallableExpression;
+    private validate;
+    private checkDepth;
+    private createSandbox;
+    private nestedHandler;
+    private assertSafeKey;
+    private execute;
 }
 
-export { AreSyntaxContext };
+export { AreSyntax };