smart-lifecycle 0.1.1

package/dist/rendering/support/safe-methods.js

@@ -0,0 +1,138 @@
+/**
+ * Allowlist of safe methods that can be called in expressions.
+ * Only read-only methods are allowed - no state mutation.
+ */
+/**
+ * Safe string methods that can be called in template expressions.
+ * These methods do not mutate the original string.
+ */
+export const SAFE_STRING_METHODS = [
+    'charAt',
+    'charCodeAt',
+    'concat',
+    'endsWith',
+    'includes',
+    'indexOf',
+    'lastIndexOf',
+    'match',
+    'padEnd',
+    'padStart',
+    'repeat',
+    'replace',
+    'search',
+    'slice',
+    'split',
+    'startsWith',
+    'substring',
+    'toLowerCase',
+    'toUpperCase',
+    'trim',
+    'trimEnd',
+    'trimStart'
+];
+/**
+ * Safe number methods that can be called in template expressions.
+ * These methods do not mutate the original number.
+ */
+export const SAFE_NUMBER_METHODS = [
+    'toExponential',
+    'toFixed',
+    'toLocaleString',
+    'toPrecision',
+    'toString',
+    'valueOf'
+];
+/**
+ * Safe array methods that can be called in template expressions.
+ * These methods do not mutate the original array.
+ */
+export const SAFE_ARRAY_METHODS = [
+    'join',
+    'concat',
+    'slice',
+    'indexOf',
+    'lastIndexOf',
+    'includes',
+    'toString',
+    'toLocaleString'
+];
+/**
+ * Safe date methods that can be called in template expressions.
+ * These methods do not mutate the original date.
+ */
+export const SAFE_DATE_METHODS = [
+    'getDate',
+    'getDay',
+    'getFullYear',
+    'getHours',
+    'getMilliseconds',
+    'getMinutes',
+    'getMonth',
+    'getSeconds',
+    'getTime',
+    'toDateString',
+    'toISOString',
+    'toJSON',
+    'toLocaleDateString',
+    'toLocaleString',
+    'toLocaleTimeString',
+    'toString',
+    'toTimeString'
+];
+/**
+ * Safe object methods that can be called in template expressions.
+ * These methods do not mutate the original object.
+ */
+export const SAFE_OBJECT_METHODS = [
+    'toString',
+    'valueOf'
+];
+/**
+ * Checks if a method is safe to call on a given value type.
+ *
+ * @param value - The value to check the method against
+ * @param methodName - The method name to validate
+ * @returns true if the method is safe to call, false otherwise
+ * @throws Error if value is null or undefined
+ */
+export function isSafeMethod(value, methodName) {
+    if (value == null) {
+        throw new Error('Value cannot be null or undefined');
+    }
+    const type = typeof value;
+    if (type === 'string') {
+        return SAFE_STRING_METHODS.includes(methodName);
+    }
+    if (type === 'number') {
+        return SAFE_NUMBER_METHODS.includes(methodName);
+    }
+    if (Array.isArray(value)) {
+        return SAFE_ARRAY_METHODS.includes(methodName);
+    }
+    if (value instanceof Date) {
+        return SAFE_DATE_METHODS.includes(methodName);
+    }
+    // Fallback to object methods
+    return SAFE_OBJECT_METHODS.includes(methodName);
+}
+/**
+ * Gets the list of safe methods for a given value type.
+ *
+ * @param value - The value to get safe methods for
+ * @returns Array of safe method names for the value type
+ */
+export function getSafeMethodsForType(value) {
+    if (value == null)
+        return SAFE_OBJECT_METHODS;
+    const type = typeof value;
+    if (type === 'string')
+        return SAFE_STRING_METHODS;
+    if (type === 'number')
+        return SAFE_NUMBER_METHODS;
+    if (Array.isArray(value))
+        return SAFE_ARRAY_METHODS;
+    if (value instanceof Date)
+        return SAFE_DATE_METHODS;
+    return SAFE_OBJECT_METHODS;
+}
+//# sourceMappingURL=safe-methods.js.map

package/dist/rendering/support/safe-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-methods.js","sourceRoot":"","sources":["../../../src/rendering/support/safe-methods.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,UAAU;IACV,SAAS;IACT,aAAa;IACb,OAAO;IACP,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,OAAO;IACP,OAAO;IACP,YAAY;IACZ,WAAW;IACX,aAAa;IACb,aAAa;IACb,MAAM;IACN,SAAS;IACT,WAAW;CACH,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,eAAe;IACf,SAAS;IACT,gBAAgB;IAChB,aAAa;IACb,UAAU;IACV,SAAS;CACD,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM;IACN,QAAQ;IACR,OAAO;IACP,SAAS;IACT,aAAa;IACb,UAAU;IACV,UAAU;IACV,gBAAgB;CACR,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS;IACT,QAAQ;IACR,aAAa;IACb,UAAU;IACV,iBAAiB;IACjB,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,SAAS;IACT,cAAc;IACd,aAAa;IACb,QAAQ;IACR,oBAAoB;IACpB,gBAAgB;IAChB,oBAAoB;IACpB,UAAU;IACV,cAAc;CACN,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU;IACV,SAAS;CACD,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAU,EAAE,UAAkB;IACzD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC;IAE1B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,mBAAmB,CAAC,QAAQ,CAAC,UAAiB,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,mBAAmB,CAAC,QAAQ,CAAC,UAAiB,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC,QAAQ,CAAC,UAAiB,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,iBAAiB,CAAC,QAAQ,CAAC,UAAiB,CAAC,CAAC;IACvD,CAAC;IAED,6BAA6B;IAC7B,OAAO,mBAAmB,CAAC,QAAQ,CAAC,UAAiB,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAU;IAC9C,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,mBAAmB,CAAC;IAE9C,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC;IAE1B,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC;IAClD,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC;IACpD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,iBAAiB,CAAC;IAEpD,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/rendering/support/smart-input-store.d.ts

@@ -0,0 +1,11 @@
+import type { ISmartInputStore } from './smart-input-store.interface.js';
+/**
+ * Implements the responsibility of managing smart input element mappings using WeakMap.
+ *
+ * @description
+ * Provides a memory-efficient way to store mappings between DOM elements and their
+ * associated smart input identifiers. Uses WeakMap to allow garbage collection
+ * when elements are removed from the DOM.
+ */
+export declare const SmartInputStore: ISmartInputStore;
+//# sourceMappingURL=smart-input-store.d.ts.map

package/dist/rendering/support/smart-input-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-store.d.ts","sourceRoot":"","sources":["../../../src/rendering/support/smart-input-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,gBAuF7B,CAAC"}

package/dist/rendering/support/smart-input-store.interface.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Defines the responsibility of storing and retrieving smart input element mappings.
+ */
+export interface ISmartInputStore {
+    /**
+     * Stores a mapping between an element, input name, and unique ID.
+     *
+     * @param el - The element to store the mapping for
+     * @param name - The input name
+     * @param id - The unique identifier
+     * @throws Error if any parameter is null or undefined
+     *
+     * @example
+     * ```typescript
+     * store.set(element, 'username', 'input-123');
+     * ```
+     */
+    set(el: Element, name: string, id: string): void;
+    /**
+     * Retrieves the ID for a given element and input name.
+     *
+     * @param el - The element to retrieve the mapping for
+     * @param name - The input name
+     * @returns The stored ID, or undefined if not found
+     * @throws Error if parameters are null or undefined
+     *
+     * @example
+     * ```typescript
+     * const id = store.get(element, 'username');
+     * if (id) {
+     *   console.log(`Found ID: ${id}`);
+     * }
+     * ```
+     */
+    get(el: Element, name: string): string | undefined;
+    /**
+     * Removes the mapping for a given element and input name.
+     *
+     * @param el - The element to remove the mapping from
+     * @param name - The input name
+     * @throws Error if parameters are null or undefined
+     *
+     * @example
+     * ```typescript
+     * store.delete(element, 'username');
+     * ```
+     */
+    delete(el: Element, name: string): void;
+}
+/**
+ * Token for registering the SmartInputStore in the service provider.
+ */
+export declare const SmartInputStoreToken: "SmartInputStore";
+//# sourceMappingURL=smart-input-store.interface.d.ts.map

package/dist/rendering/support/smart-input-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-store.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/support/smart-input-store.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjD;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAEnD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAG,iBAA0B,CAAC"}

package/dist/rendering/support/smart-input-store.interface.js

@@ -0,0 +1,5 @@
+/**
+ * Token for registering the SmartInputStore in the service provider.
+ */
+export const SmartInputStoreToken = 'SmartInputStore';
+//# sourceMappingURL=smart-input-store.interface.js.map

package/dist/rendering/support/smart-input-store.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-store.interface.js","sourceRoot":"","sources":["../../../src/rendering/support/smart-input-store.interface.ts"],"names":[],"mappings":"AAoDA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAA0B,CAAC"}

package/dist/rendering/support/smart-input-store.js

@@ -0,0 +1,92 @@
+const store = new WeakMap();
+/**
+ * Implements the responsibility of managing smart input element mappings using WeakMap.
+ *
+ * @description
+ * Provides a memory-efficient way to store mappings between DOM elements and their
+ * associated smart input identifiers. Uses WeakMap to allow garbage collection
+ * when elements are removed from the DOM.
+ */
+export const SmartInputStore = {
+    /**
+     * Stores a mapping between an element, input name, and unique ID.
+     *
+     * @param el - The element to store the mapping for
+     * @param name - The input name
+     * @param id - The unique identifier
+     * @throws Error if any parameter is null or undefined
+     *
+     * @example
+     * ```typescript
+     * SmartInputStore.set(element, 'username', 'input-123');
+     * ```
+     */
+    set(el, name, id) {
+        if (!el) {
+            throw new Error('Element is required');
+        }
+        if (!name) {
+            throw new Error('Name is required');
+        }
+        if (!id) {
+            throw new Error('ID is required');
+        }
+        const entry = store.get(el) ?? new Map();
+        if (!store.has(el)) {
+            store.set(el, entry);
+        }
+        entry.set(name, id);
+    },
+    /**
+     * Retrieves the ID for a given element and input name.
+     *
+     * @param el - The element to retrieve the mapping for
+     * @param name - The input name
+     * @returns The stored ID, or undefined if not found
+     * @throws Error if parameters are null or undefined
+     *
+     * @example
+     * ```typescript
+     * const id = SmartInputStore.get(element, 'username');
+     * ```
+     */
+    get(el, name) {
+        if (!el) {
+            throw new Error('Element is required');
+        }
+        if (!name) {
+            throw new Error('Name is required');
+        }
+        const entry = store.get(el);
+        return entry?.get(name);
+    },
+    /**
+     * Removes the mapping for a given element and input name.
+     *
+     * @param el - The element to remove the mapping from
+     * @param name - The input name
+     * @throws Error if parameters are null or undefined
+     *
+     * @example
+     * ```typescript
+     * SmartInputStore.delete(element, 'username');
+     * ```
+     */
+    delete(el, name) {
+        if (!el) {
+            throw new Error('Element is required');
+        }
+        if (!name) {
+            throw new Error('Name is required');
+        }
+        const entry = store.get(el);
+        if (!entry) {
+            return;
+        }
+        entry.delete(name);
+        if (entry.size === 0) {
+            store.delete(el);
+        }
+    }
+};
+//# sourceMappingURL=smart-input-store.js.map

package/dist/rendering/support/smart-input-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-input-store.js","sourceRoot":"","sources":["../../../src/rendering/support/smart-input-store.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAG,IAAI,OAAO,EAAgC,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,EAAW,EAAE,IAAY,EAAE,EAAU;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,EAAW,EAAE,IAAY;QAC3B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAW,EAAE,IAAY;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/rendering/templates/compiled-template.interface.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Defines the responsibility of representing a pre-compiled template.
+ *
+ * @description
+ * Represents a template that has been parsed and analyzed for bindings.
+ * Can be cloned for instantiation in multiple DOM contexts.
+ *
+ * @example
+ * ```typescript
+ * const compiledTemplate: ICompiledTemplate = {
+ *   templateString: '<div>{{message}}</div>',
+ *   bindings: new Set(['message']),
+ *   clone: () => ({ ...this })
+ * };
+ * ```
+ */
+export interface ICompiledTemplate {
+    /** Original template string */
+    templateString: string;
+    /** Detected bindings (property paths like 'message', 'user.name') */
+    bindings: Set<string>;
+    /**
+     * Clones this compiled template for use in a new context.
+     *
+     * @returns A new ICompiledTemplate instance
+     *
+     * @example
+     * ```typescript
+     * const clone = compiledTemplate.clone();
+     * ```
+     */
+    clone(): ICompiledTemplate;
+}
+//# sourceMappingURL=compiled-template.interface.d.ts.map

package/dist/rendering/templates/compiled-template.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-template.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/compiled-template.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;IAEvB,qEAAqE;IACrE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEtB;;;;;;;;;OASG;IACH,KAAK,IAAI,iBAAiB,CAAC;CAC5B"}

package/dist/rendering/templates/compiled-template.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compiled-template.interface.js.map

package/dist/rendering/templates/compiled-template.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-template.interface.js","sourceRoot":"","sources":["../../../src/rendering/templates/compiled-template.interface.ts"],"names":[],"mappings":""}

package/dist/rendering/templates/composite-token-extractor.d.ts

@@ -0,0 +1,10 @@
+import { ITemplateTokenExtractor, TemplateToken } from "./template-token.interface.js";
+/**
+ * Implements the responsibility of aggregating multiple token extractors.
+ */
+export declare class CompositeTokenExtractor implements ITemplateTokenExtractor {
+    private readonly extractors;
+    constructor(extractors: ITemplateTokenExtractor[]);
+    extract(template: string): TemplateToken[];
+}
+//# sourceMappingURL=composite-token-extractor.d.ts.map

package/dist/rendering/templates/composite-token-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-token-extractor.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/composite-token-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,aAAa,EACd,MAAM,+BAA+B,CAAC;AAEvC;;GAEG;AACH,qBAAa,uBAAwB,YAAW,uBAAuB;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;gBAE3C,UAAU,EAAE,uBAAuB,EAAE;IAOjD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;CAG3C"}

package/dist/rendering/templates/composite-token-extractor.js

@@ -0,0 +1,16 @@
+/**
+ * Implements the responsibility of aggregating multiple token extractors.
+ */
+export class CompositeTokenExtractor {
+    extractors;
+    constructor(extractors) {
+        if (!extractors || extractors.length === 0) {
+            throw new Error("At least one extractor is required");
+        }
+        this.extractors = extractors;
+    }
+    extract(template) {
+        return this.extractors.flatMap((extractor) => extractor.extract(template));
+    }
+}
+//# sourceMappingURL=composite-token-extractor.js.map

package/dist/rendering/templates/composite-token-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-token-extractor.js","sourceRoot":"","sources":["../../../src/rendering/templates/composite-token-extractor.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,OAAO,uBAAuB;IACjB,UAAU,CAA4B;IAEvD,YAAY,UAAqC;QAC/C,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,QAAgB;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/dist/rendering/templates/delimited-token-extractor.d.ts

@@ -0,0 +1,12 @@
+import { ITemplateTokenExtractor, TemplateToken } from "./template-token.interface.js";
+/**
+ * Implements the responsibility of extracting delimited tokens (e.g., {{binding}}, [[CONSTANT]]).
+ */
+export declare class DelimitedTokenExtractor implements ITemplateTokenExtractor {
+    private readonly kind;
+    private readonly pattern;
+    constructor(start: string, end: string, kind: string);
+    extract(template: string): TemplateToken[];
+    private static escapeRegex;
+}
+//# sourceMappingURL=delimited-token-extractor.d.ts.map

package/dist/rendering/templates/delimited-token-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delimited-token-extractor.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/delimited-token-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,aAAa,EACd,MAAM,+BAA+B,CAAC;AAEvC;;GAEG;AACH,qBAAa,uBAAwB,YAAW,uBAAuB;IACrE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAWpD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IA0B1C,OAAO,CAAC,MAAM,CAAC,WAAW;CAG3B"}

package/dist/rendering/templates/delimited-token-extractor.js

@@ -0,0 +1,44 @@
+/**
+ * Implements the responsibility of extracting delimited tokens (e.g., {{binding}}, [[CONSTANT]]).
+ */
+export class DelimitedTokenExtractor {
+    kind;
+    pattern;
+    constructor(start, end, kind) {
+        if (!start)
+            throw new Error("Start delimiter is required");
+        if (!end)
+            throw new Error("End delimiter is required");
+        if (!kind)
+            throw new Error("Token kind is required");
+        this.kind = kind;
+        const escapedStart = DelimitedTokenExtractor.escapeRegex(start);
+        const escapedEnd = DelimitedTokenExtractor.escapeRegex(end);
+        this.pattern = new RegExp(`${escapedStart}([^]*?)${escapedEnd}`, "g");
+    }
+    extract(template) {
+        if (!template) {
+            return [];
+        }
+        const tokens = [];
+        let match;
+        while ((match = this.pattern.exec(template)) !== null) {
+            const raw = match[0];
+            const value = (match[1] ?? "").trim();
+            const startIndex = match.index;
+            const endIndex = startIndex + raw.length;
+            tokens.push({
+                kind: this.kind,
+                value,
+                raw,
+                start: startIndex,
+                end: endIndex,
+            });
+        }
+        return tokens;
+    }
+    static escapeRegex(value) {
+        return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    }
+}
+//# sourceMappingURL=delimited-token-extractor.js.map

package/dist/rendering/templates/delimited-token-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delimited-token-extractor.js","sourceRoot":"","sources":["../../../src/rendering/templates/delimited-token-extractor.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,OAAO,uBAAuB;IACjB,IAAI,CAAS;IACb,OAAO,CAAS;IAEjC,YAAY,KAAa,EAAE,GAAW,EAAE,IAAY;QAClD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAErD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,YAAY,GAAG,uBAAuB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,uBAAuB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,UAAU,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,CAAC,QAAgB;QACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,IAAI,KAA6B,CAAC;QAElC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;YAC/B,MAAM,QAAQ,GAAG,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC;YAEzC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK;gBACL,GAAG;gBACH,KAAK,EAAE,UAAU;gBACjB,GAAG,EAAE,QAAQ;aACd,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,MAAM,CAAC,WAAW,CAAC,KAAa;QACtC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/rendering/templates/host-projector.interface.d.ts

@@ -0,0 +1,25 @@
+import { SmartComponent } from '../../core/smart-component.js';
+/**
+ * Defines the responsibility of projecting content into <smart-host> elements.
+ *
+ * @description
+ * Defines the contract for projecting content into <smart-host> elements,
+ * handling both named and default hosts according to SmartComponents standards.
+ */
+export interface IHostProjector {
+    /**
+     * Projects captured host content into template hosts.
+     *
+     * @param element - Template root element containing <smart-host> elements
+     * @param component - Component instance with captured host content
+     * @throws Error if element or component are null/undefined
+     *
+     * @example
+     * ```typescript
+     * const projector = new HostProjector(domAdapter);
+     * projector.project(templateRoot, myComponent);
+     * ```
+     */
+    project(element: HTMLElement, component: SmartComponent): void;
+}
+//# sourceMappingURL=host-projector.interface.d.ts.map

package/dist/rendering/templates/host-projector.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-projector.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/host-projector.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;CAChE"}

package/dist/rendering/templates/host-projector.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-projector.interface.js.map

package/dist/rendering/templates/host-projector.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-projector.interface.js","sourceRoot":"","sources":["../../../src/rendering/templates/host-projector.interface.ts"],"names":[],"mappings":""}

package/dist/rendering/templates/html-aware-token-extractor.d.ts

@@ -0,0 +1,56 @@
+import type { ITemplateTokenExtractor, TemplateToken } from "./template-token.interface.js";
+import type { IHtmlFragmentParser } from "./html-fragment-parser.interface.js";
+import type { IInterpolableContentSelector } from "./interpolable-content-selector.interface.js";
+/**
+ * Implements the responsibility of extracting tokens from HTML templates with context awareness.
+ *
+ * @description
+ * HTML-aware token extractor that:
+ * 1. Parses the template HTML into a structured representation
+ * 2. Selects only safe/interpolable content (text nodes and allowed attribute values)
+ * 3. Delegates actual token extraction to a string-based extractor
+ *
+ * This ensures tokens are ONLY extracted from:
+ * - Text node content (excluding script/style/template/comments)
+ * - Attribute values (excluding on*, style, and structure like tag/attr names)
+ *
+ * @example
+ * ```typescript
+ * const parser = new Parse5FragmentParser();
+ * const selector = new SafeContentSelector();
+ * const stringExtractor = new DelimitedTokenExtractor('{{', '}}', 'binding');
+ * const htmlExtractor = new HtmlAwareTokenExtractor(parser, selector, stringExtractor);
+ *
+ * const tokens = htmlExtractor.extract('<div>{{message}}</div>');
+ * // tokens = [{ kind: 'binding', value: 'message', ... }]
+ * ```
+ */
+export declare class HtmlAwareTokenExtractor implements ITemplateTokenExtractor {
+    private readonly parser;
+    private readonly selector;
+    private readonly stringExtractor;
+    /**
+     * Initializes a new instance of HtmlAwareTokenExtractor.
+     *
+     * @param parser - HTML fragment parser for template parsing
+     * @param selector - Content selector for safe fragment extraction
+     * @param stringExtractor - String-based token extractor for actual tokenization
+     * @throws Error if any dependency is null or undefined
+     */
+    constructor(parser: IHtmlFragmentParser, selector: IInterpolableContentSelector, stringExtractor: ITemplateTokenExtractor);
+    /**
+     * Extracts tokens from an HTML template string.
+     *
+     * @param template - HTML template string
+     * @returns Array of extracted tokens from safe/interpolable content only
+     * @throws Error if template is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const extractor = new HtmlAwareTokenExtractor(parser, selector, stringExtractor);
+     * const tokens = extractor.extract('<div>{{message}}</div>');
+     * ```
+     */
+    extract(template: string): TemplateToken[];
+}
+//# sourceMappingURL=html-aware-token-extractor.d.ts.map

package/dist/rendering/templates/html-aware-token-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-aware-token-extractor.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/html-aware-token-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8CAA8C,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,uBAAwB,YAAW,uBAAuB;IAUnE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAXlC;;;;;;;OAOG;gBAEgB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,4BAA4B,EACtC,eAAe,EAAE,uBAAuB;IAO3D;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;CAoB3C"}

package/dist/rendering/templates/html-aware-token-extractor.js

@@ -0,0 +1,78 @@
+/**
+ * Implements the responsibility of extracting tokens from HTML templates with context awareness.
+ *
+ * @description
+ * HTML-aware token extractor that:
+ * 1. Parses the template HTML into a structured representation
+ * 2. Selects only safe/interpolable content (text nodes and allowed attribute values)
+ * 3. Delegates actual token extraction to a string-based extractor
+ *
+ * This ensures tokens are ONLY extracted from:
+ * - Text node content (excluding script/style/template/comments)
+ * - Attribute values (excluding on*, style, and structure like tag/attr names)
+ *
+ * @example
+ * ```typescript
+ * const parser = new Parse5FragmentParser();
+ * const selector = new SafeContentSelector();
+ * const stringExtractor = new DelimitedTokenExtractor('{{', '}}', 'binding');
+ * const htmlExtractor = new HtmlAwareTokenExtractor(parser, selector, stringExtractor);
+ *
+ * const tokens = htmlExtractor.extract('<div>{{message}}</div>');
+ * // tokens = [{ kind: 'binding', value: 'message', ... }]
+ * ```
+ */
+export class HtmlAwareTokenExtractor {
+    parser;
+    selector;
+    stringExtractor;
+    /**
+     * Initializes a new instance of HtmlAwareTokenExtractor.
+     *
+     * @param parser - HTML fragment parser for template parsing
+     * @param selector - Content selector for safe fragment extraction
+     * @param stringExtractor - String-based token extractor for actual tokenization
+     * @throws Error if any dependency is null or undefined
+     */
+    constructor(parser, selector, stringExtractor) {
+        this.parser = parser;
+        this.selector = selector;
+        this.stringExtractor = stringExtractor;
+        if (!parser)
+            throw new Error("Parser is required");
+        if (!selector)
+            throw new Error("Selector is required");
+        if (!stringExtractor)
+            throw new Error("StringExtractor is required");
+    }
+    /**
+     * Extracts tokens from an HTML template string.
+     *
+     * @param template - HTML template string
+     * @returns Array of extracted tokens from safe/interpolable content only
+     * @throws Error if template is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const extractor = new HtmlAwareTokenExtractor(parser, selector, stringExtractor);
+     * const tokens = extractor.extract('<div>{{message}}</div>');
+     * ```
+     */
+    extract(template) {
+        if (template === null || template === undefined) {
+            throw new Error("Template is required");
+        }
+        // Parse HTML structure
+        const parsedHtml = this.parser.parse(template);
+        // Select interpolable fragments (text nodes and safe attribute values)
+        const fragments = this.selector.selectInterpolableFragments(parsedHtml);
+        // Extract tokens from each safe fragment
+        const allTokens = [];
+        for (const fragment of fragments) {
+            const tokens = this.stringExtractor.extract(fragment.content);
+            allTokens.push(...tokens);
+        }
+        return allTokens;
+    }
+}
+//# sourceMappingURL=html-aware-token-extractor.js.map