smart-lifecycle 0.1.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"html-aware-token-extractor.js","sourceRoot":"","sources":["../../../src/rendering/templates/html-aware-token-extractor.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,uBAAuB;IAUf;IACA;IACA;IAXnB;;;;;;;OAOG;IACH,YACmB,MAA2B,EAC3B,QAAsC,EACtC,eAAwC;QAFxC,WAAM,GAAN,MAAM,CAAqB;QAC3B,aAAQ,GAAR,QAAQ,CAA8B;QACtC,oBAAe,GAAf,eAAe,CAAyB;QAEzD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACvD,IAAI,CAAC,eAAe;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,QAAgB;QACtB,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,uBAAuB;QACvB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE/C,uEAAuE;QACvE,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC;QAExE,yCAAyC;QACzC,MAAM,SAAS,GAAoB,EAAE,CAAC;QACtC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC9D,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/rendering/templates/html-fragment-parser.interface.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Represents a parsed HTML node from parse5 or similar parser.
+ * This type is opaque as the internal structure varies by parser implementation.
+ */
+export type ParsedNode = unknown;
+/**
+ * Defines the responsibility of parsing HTML template strings into a structured representation.
+ */
+export interface IHtmlFragmentParser {
+    /**
+     * Parses an HTML template string into a document fragment or AST.
+     *
+     * @param html - HTML template string to parse
+     * @returns Parsed HTML structure
+     * @throws Error if html is null or undefined
+     */
+    parse(html: string): ParsedNode;
+}
+//# sourceMappingURL=html-fragment-parser.interface.d.ts.map

package/dist/rendering/templates/html-fragment-parser.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-fragment-parser.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/html-fragment-parser.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;CACjC"}

package/dist/rendering/templates/html-fragment-parser.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=html-fragment-parser.interface.js.map

package/dist/rendering/templates/html-fragment-parser.interface.js.map

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

package/dist/rendering/templates/interpolable-content-selector.interface.d.ts

@@ -0,0 +1,33 @@
+import { ParsedNode } from "./html-fragment-parser.interface.js";
+/**
+ * Represents a fragment of content where interpolation tokens can be extracted.
+ */
+export interface InterpolableFragment {
+    /** The content string to scan for tokens */
+    readonly content: string;
+    /** The type of fragment (text node or attribute value) */
+    readonly type: "text" | "attribute";
+}
+/**
+ * Defines the responsibility of selecting content fragments where interpolation is permitted.
+ *
+ * @description
+ * Identifies text nodes and attribute values that are safe for token extraction,
+ * excluding:
+ * - Tag names and attribute names (HTML structure)
+ * - Content inside `<script>` and `<style>` elements
+ * - HTML comments
+ * - Content inside `<template>` elements (raw/unparsed)
+ * - Sensitive attributes: `on*` event handlers and `style` attribute
+ */
+export interface IInterpolableContentSelector {
+    /**
+     * Extracts fragments from a parsed HTML structure where interpolation is allowed.
+     *
+     * @param parsedHtml - Parsed HTML structure (from IHtmlFragmentParser)
+     * @returns Array of content fragments safe for tokenization
+     * @throws Error if parsedHtml is null or undefined
+     */
+    selectInterpolableFragments(parsedHtml: ParsedNode): InterpolableFragment[];
+}
+//# sourceMappingURL=interpolable-content-selector.interface.d.ts.map

package/dist/rendering/templates/interpolable-content-selector.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolable-content-selector.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/interpolable-content-selector.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;CACrC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;;OAMG;IACH,2BAA2B,CAAC,UAAU,EAAE,UAAU,GAAG,oBAAoB,EAAE,CAAC;CAC7E"}

package/dist/rendering/templates/interpolable-content-selector.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interpolable-content-selector.interface.js.map

package/dist/rendering/templates/interpolable-content-selector.interface.js.map

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

package/dist/rendering/templates/parse5-fragment-parser.d.ts

@@ -0,0 +1,31 @@
+import { IHtmlFragmentParser, ParsedNode } from "./html-fragment-parser.interface.js";
+/**
+ * Implements the responsibility of parsing HTML fragments using parse5.
+ *
+ * @description
+ * Uses parse5 to parse HTML template strings into a structured DOM-like representation.
+ * parse5 is a standards-compliant HTML parser suitable for Node.js environments.
+ *
+ * @example
+ * ```typescript
+ * const parser = new Parse5FragmentParser();
+ * const fragment = parser.parse('<div>{{message}}</div>');
+ * ```
+ */
+export declare class Parse5FragmentParser implements IHtmlFragmentParser {
+    /**
+     * Parses an HTML template string into a parse5 DocumentFragment.
+     *
+     * @param html - HTML template string to parse
+     * @returns parse5 DocumentFragment AST
+     * @throws Error if html is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const parser = new Parse5FragmentParser();
+     * const fragment = parser.parse('<div>{{message}}</div>');
+     * ```
+     */
+    parse(html: string): ParsedNode;
+}
+//# sourceMappingURL=parse5-fragment-parser.d.ts.map

package/dist/rendering/templates/parse5-fragment-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse5-fragment-parser.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/parse5-fragment-parser.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,UAAU,EACX,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;CAOhC"}

package/dist/rendering/templates/parse5-fragment-parser.js

@@ -0,0 +1,36 @@
+import { parseFragment } from "parse5";
+/**
+ * Implements the responsibility of parsing HTML fragments using parse5.
+ *
+ * @description
+ * Uses parse5 to parse HTML template strings into a structured DOM-like representation.
+ * parse5 is a standards-compliant HTML parser suitable for Node.js environments.
+ *
+ * @example
+ * ```typescript
+ * const parser = new Parse5FragmentParser();
+ * const fragment = parser.parse('<div>{{message}}</div>');
+ * ```
+ */
+export class Parse5FragmentParser {
+    /**
+     * Parses an HTML template string into a parse5 DocumentFragment.
+     *
+     * @param html - HTML template string to parse
+     * @returns parse5 DocumentFragment AST
+     * @throws Error if html is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const parser = new Parse5FragmentParser();
+     * const fragment = parser.parse('<div>{{message}}</div>');
+     * ```
+     */
+    parse(html) {
+        if (html === null || html === undefined) {
+            throw new Error("Html is required");
+        }
+        return parseFragment(html);
+    }
+}
+//# sourceMappingURL=parse5-fragment-parser.js.map

package/dist/rendering/templates/parse5-fragment-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse5-fragment-parser.js","sourceRoot":"","sources":["../../../src/rendering/templates/parse5-fragment-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAMvC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/rendering/templates/safe-content-selector.d.ts

@@ -0,0 +1,50 @@
+import type { IInterpolableContentSelector, InterpolableFragment } from "./interpolable-content-selector.interface.js";
+import type { ParsedNode } from "./html-fragment-parser.interface.js";
+/**
+ * Implements the responsibility of selecting safe content for interpolation from parsed HTML.
+ *
+ * @description
+ * Traverses a parse5 DocumentFragment AST and extracts only:
+ * - Text nodes (excluding those inside script/style/template elements)
+ * - Attribute values (excluding on*, style, and attributes inside excluded elements)
+ *
+ * Excluded contexts (no tokenization):
+ * - Tag names and attribute names (HTML structure)
+ * - Content inside `<script>`, `<style>`, `<template>` elements
+ * - HTML comments
+ * - Event handler attributes (`onclick`, `oninput`, etc.)
+ * - `style` attribute values
+ *
+ * @example
+ * ```typescript
+ * const parser = new Parse5FragmentParser();
+ * const selector = new SafeContentSelector();
+ * const fragment = parser.parse('<div>{{message}}</div>');
+ * const fragments = selector.selectInterpolableFragments(fragment);
+ * // fragments = [{ content: '{{message}}', type: 'text' }]
+ * ```
+ */
+export declare class SafeContentSelector implements IInterpolableContentSelector {
+    private readonly excludedElements;
+    private readonly excludedAttributePrefix;
+    private readonly excludedAttributes;
+    /**
+     * Extracts interpolable fragments from a parse5 DocumentFragment.
+     *
+     * @param parsedHtml - parse5 DocumentFragment AST
+     * @returns Array of safe content fragments for tokenization
+     * @throws Error if parsedHtml is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const selector = new SafeContentSelector();
+     * const fragments = selector.selectInterpolableFragments(parsedFragment);
+     * ```
+     */
+    selectInterpolableFragments(parsedHtml: ParsedNode): InterpolableFragment[];
+    private traverseNode;
+    private isAttributeAllowed;
+    private looksLikeInterpolation;
+    private looksLikeHtmlStructure;
+}
+//# sourceMappingURL=safe-content-selector.d.ts.map

package/dist/rendering/templates/safe-content-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-content-selector.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/safe-content-selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,mBAAoB,YAAW,4BAA4B;IACtE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4C;IAC7E,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IAEzD;;;;;;;;;;;;OAYG;IACH,2BAA2B,CAAC,UAAU,EAAE,UAAU,GAAG,oBAAoB,EAAE;IAU3E,OAAO,CAAC,YAAY;IA2EpB,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,sBAAsB;CAO/B"}

package/dist/rendering/templates/safe-content-selector.js

@@ -0,0 +1,138 @@
+/**
+ * Implements the responsibility of selecting safe content for interpolation from parsed HTML.
+ *
+ * @description
+ * Traverses a parse5 DocumentFragment AST and extracts only:
+ * - Text nodes (excluding those inside script/style/template elements)
+ * - Attribute values (excluding on*, style, and attributes inside excluded elements)
+ *
+ * Excluded contexts (no tokenization):
+ * - Tag names and attribute names (HTML structure)
+ * - Content inside `<script>`, `<style>`, `<template>` elements
+ * - HTML comments
+ * - Event handler attributes (`onclick`, `oninput`, etc.)
+ * - `style` attribute values
+ *
+ * @example
+ * ```typescript
+ * const parser = new Parse5FragmentParser();
+ * const selector = new SafeContentSelector();
+ * const fragment = parser.parse('<div>{{message}}</div>');
+ * const fragments = selector.selectInterpolableFragments(fragment);
+ * // fragments = [{ content: '{{message}}', type: 'text' }]
+ * ```
+ */
+export class SafeContentSelector {
+    excludedElements = new Set(["script", "style", "template"]);
+    excludedAttributePrefix = "on";
+    excludedAttributes = new Set(["style"]);
+    /**
+     * Extracts interpolable fragments from a parse5 DocumentFragment.
+     *
+     * @param parsedHtml - parse5 DocumentFragment AST
+     * @returns Array of safe content fragments for tokenization
+     * @throws Error if parsedHtml is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const selector = new SafeContentSelector();
+     * const fragments = selector.selectInterpolableFragments(parsedFragment);
+     * ```
+     */
+    selectInterpolableFragments(parsedHtml) {
+        if (!parsedHtml) {
+            throw new Error("ParsedHtml is required");
+        }
+        const fragments = [];
+        this.traverseNode(parsedHtml, fragments, false);
+        return fragments;
+    }
+    traverseNode(node, fragments, insideExcludedElement) {
+        if (!node || typeof node !== "object")
+            return;
+        const nodeWithName = node;
+        // Handle different node types from parse5
+        if (nodeWithName.nodeName === "#document-fragment" ||
+            nodeWithName.nodeName === "#document") {
+            // Traverse children
+            const nodeWithChildren = node;
+            if (nodeWithChildren.childNodes) {
+                for (const child of nodeWithChildren.childNodes) {
+                    this.traverseNode(child, fragments, insideExcludedElement);
+                }
+            }
+            return;
+        }
+        // Skip comments
+        if (nodeWithName.nodeName === "#comment") {
+            return;
+        }
+        // Handle text nodes
+        if (nodeWithName.nodeName === "#text") {
+            const textNode = node;
+            if (!insideExcludedElement && textNode.value && textNode.value.trim()) {
+                // Exclude text nodes that contain HTML-like content (parse5 artifact from invalid tags)
+                if (!this.looksLikeHtmlStructure(textNode.value)) {
+                    fragments.push({
+                        content: textNode.value,
+                        type: "text",
+                    });
+                }
+            }
+            return;
+        }
+        // Check if this is an excluded element
+        const isExcluded = this.excludedElements.has(nodeWithName.nodeName || "");
+        // Extract allowed attribute values (if not inside excluded element)
+        const elementNode = node;
+        if (!insideExcludedElement && elementNode.attrs) {
+            for (const attr of elementNode.attrs) {
+                if (this.isAttributeAllowed(attr.name) && attr.value) {
+                    fragments.push({
+                        content: attr.value,
+                        type: "attribute",
+                    });
+                }
+            }
+        }
+        // Traverse child nodes
+        const nodeWithChildNodes = node;
+        if (nodeWithChildNodes.childNodes) {
+            for (const child of nodeWithChildNodes.childNodes) {
+                this.traverseNode(child, fragments, insideExcludedElement || isExcluded);
+            }
+        }
+    }
+    isAttributeAllowed(attrName) {
+        // Exclude event handlers (on*)
+        if (attrName.startsWith(this.excludedAttributePrefix)) {
+            return false;
+        }
+        // Exclude specific attributes
+        if (this.excludedAttributes.has(attrName)) {
+            return false;
+        }
+        // Exclude attributes that look like interpolation patterns
+        // (parse5 treats invalid syntax like <{{x}}> as attributes)
+        if (this.looksLikeInterpolation(attrName)) {
+            return false;
+        }
+        return true;
+    }
+    looksLikeInterpolation(attrName) {
+        // Check for common interpolation delimiters in attribute name
+        return (attrName.includes("{{") ||
+            attrName.includes("}}") ||
+            attrName.includes("${") ||
+            attrName.includes("[[") ||
+            attrName.includes("]]"));
+    }
+    looksLikeHtmlStructure(textValue) {
+        // Text nodes that look like HTML tags are artifacts from invalid syntax
+        // (e.g., <{{tag}}> becomes a text node "<{{tag}}>")
+        // Exclude if it starts with '<' and contains '>'
+        const trimmed = textValue.trim();
+        return trimmed.startsWith("<") && trimmed.includes(">");
+    }
+}
+//# sourceMappingURL=safe-content-selector.js.map

package/dist/rendering/templates/safe-content-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-content-selector.js","sourceRoot":"","sources":["../../../src/rendering/templates/safe-content-selector.ts"],"names":[],"mappings":"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"}

package/dist/rendering/templates/simple-template-analyzer.d.ts

@@ -0,0 +1,29 @@
+import { ICompiledTemplate } from './compiled-template.interface.js';
+import { ITemplateAnalyzer } from './template-analyzer.interface.js';
+import { ITemplateTokenExtractor } from './template-token.interface.js';
+/**
+ * Implements the responsibility of analyzing templates and extracting bindings.
+ * Extracts template tokens using pluggable dialect extractors.
+ */
+export declare class TemplateAnalyzer implements ITemplateAnalyzer {
+    private readonly extractor;
+    constructor(extractor?: ITemplateTokenExtractor);
+    /**
+     * Analyzes a template and extracts bindings.
+     *
+     * @param template - HTML template string with {{bindings}}
+     * @returns Compiled template with extracted bindings
+     * @throws Error if template is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const analyzer = new TemplateAnalyzer();
+     * const compiled = analyzer.analyze('<div>{{message}}</div>');
+     * console.log(compiled.bindings); // Set(['message'])
+     * ```
+     */
+    analyze(template: string): ICompiledTemplate;
+    private collectBindings;
+    private static createDefaultExtractor;
+}
+//# sourceMappingURL=simple-template-analyzer.d.ts.map

package/dist/rendering/templates/simple-template-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-template-analyzer.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/simple-template-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,EAAE,uBAAuB,EAAiB,MAAM,+BAA+B,CAAC;AAEvF;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,SAAS,CAAC,EAAE,uBAAuB;IAI/C;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB;IAmB5C,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAItC"}

package/dist/rendering/templates/simple-template-analyzer.js

@@ -0,0 +1,59 @@
+import { CompositeTokenExtractor } from './composite-token-extractor.js';
+import { DelimitedTokenExtractor } from './delimited-token-extractor.js';
+/**
+ * Implements the responsibility of analyzing templates and extracting bindings.
+ * Extracts template tokens using pluggable dialect extractors.
+ */
+export class TemplateAnalyzer {
+    extractor;
+    constructor(extractor) {
+        this.extractor = extractor ?? TemplateAnalyzer.createDefaultExtractor();
+    }
+    /**
+     * Analyzes a template and extracts bindings.
+     *
+     * @param template - HTML template string with {{bindings}}
+     * @returns Compiled template with extracted bindings
+     * @throws Error if template is null or undefined
+     *
+     * @example
+     * ```typescript
+     * const analyzer = new TemplateAnalyzer();
+     * const compiled = analyzer.analyze('<div>{{message}}</div>');
+     * console.log(compiled.bindings); // Set(['message'])
+     * ```
+     */
+    analyze(template) {
+        if (!template)
+            throw new Error('Template is required');
+        const tokens = this.extractor.extract(template);
+        const bindings = this.collectBindings(tokens);
+        return {
+            templateString: template,
+            bindings,
+            clone() {
+                return {
+                    templateString: this.templateString,
+                    bindings: new Set(this.bindings),
+                    clone: this.clone
+                };
+            }
+        };
+    }
+    collectBindings(tokens) {
+        const bindings = new Set();
+        tokens
+            .filter((token) => token.kind === 'binding')
+            .forEach((token) => {
+            if (token.value) {
+                bindings.add(token.value);
+            }
+        });
+        return bindings;
+    }
+    static createDefaultExtractor() {
+        const bindingExtractor = new DelimitedTokenExtractor('{{', '}}', 'binding');
+        return new CompositeTokenExtractor([bindingExtractor]);
+    }
+}
+//# sourceMappingURL=simple-template-analyzer.js.map

package/dist/rendering/templates/simple-template-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-template-analyzer.js","sourceRoot":"","sources":["../../../src/rendering/templates/simple-template-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAGzE;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACV,SAAS,CAA0B;IAEpD,YAAY,SAAmC;QAC7C,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,gBAAgB,CAAC,sBAAsB,EAAE,CAAC;IAC1E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,QAAgB;QACtB,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAE9C,OAAO;YACL,cAAc,EAAE,QAAQ;YACxB,QAAQ;YACR,KAAK;gBACH,OAAO;oBACL,cAAc,EAAE,IAAI,CAAC,cAAc;oBACnC,QAAQ,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;oBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,MAAuB;QAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,MAAM;aACH,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;aAC3C,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,CAAC;QACL,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,sBAAsB;QACnC,MAAM,gBAAgB,GAAG,IAAI,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC5E,OAAO,IAAI,uBAAuB,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/rendering/templates/template-analyzer.d.ts

@@ -0,0 +1,60 @@
+import { ICompiledTemplate } from "./compiled-template.interface.js";
+import { ITemplateTokenExtractor } from "./template-token.interface.js";
+/**
+ * Implements the responsibility of analyzing templates and extracting bindings.
+ *
+ * @description
+ * Extracts template tokens using HTML-aware context selection.
+ * Tokenization occurs ONLY in:
+ * - Text nodes (excluding script/style/template/comments)
+ * - Attribute values (excluding on*, style, tag names, attribute names)
+ *
+ * Uses pluggable dialect extractors for different interpolation syntaxes.
+ */
+/**
+ * Defines the responsibility of analyzing templates and producing compiled representations.
+ */
+export interface ITemplateAnalyzer {
+    /**
+     * Analyzes a template and returns its compiled representation.
+     *
+     * @param template - Template source string
+     * @returns Compiled template with extracted bindings
+     * @throws Error if template is null or undefined
+     */
+    analyze(template: string): ICompiledTemplate;
+}
+export declare class TemplateAnalyzer implements ITemplateAnalyzer {
+    private readonly extractor;
+    constructor(extractor?: ITemplateTokenExtractor);
+    /**
+     * Analyzes a template and extracts bindings from safe contexts only.
+     *
+     * @param template - HTML template string with {{bindings}}
+     * @returns Compiled template with extracted bindings
+     * @throws Error if template is null or undefined
+     *
+     * @description
+     * Tokenization occurs ONLY in text nodes and allowed attribute values.
+     * Excluded contexts: tag names, attribute names, script/style content,
+     * comments, template elements, on* attributes, style attribute.
+     * Empty string templates are allowed and return zero bindings.
+     *
+     * @example
+     * ```typescript
+     * const analyzer = new TemplateAnalyzer();
+     * // Valid: text node
+     * analyzer.analyze('<div>{{message}}</div>'); // bindings: {'message'}
+     * // Valid: attribute value
+     * analyzer.analyze('<div attr="{{x}}"></div>'); // bindings: {'x'}
+     * // Invalid: tag name (excluded)
+     * analyzer.analyze('<{{tag}}></{{tag}}>'); // bindings: {}
+     * // Invalid: script content (excluded)
+     * analyzer.analyze('<script>{{x}}</script>'); // bindings: {}
+     * ```
+     */
+    analyze(template: string): ICompiledTemplate;
+    private collectBindings;
+    private static createDefaultExtractor;
+}
+//# sourceMappingURL=template-analyzer.d.ts.map

package/dist/rendering/templates/template-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-analyzer.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/template-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,EACL,uBAAuB,EAExB,MAAM,+BAA+B,CAAC;AAKvC;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAC9C;AAED,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,SAAS,CAAC,EAAE,uBAAuB;IAI/C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB;IAqB5C,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAQtC"}

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

@@ -0,0 +1,15 @@
+import { ICompiledTemplate } from './compiled-template.interface.js';
+/**
+ * Defines the responsibility of analyzing templates and producing compiled representations.
+ */
+export interface ITemplateAnalyzer {
+    /**
+     * Analyzes a template and returns its compiled representation.
+     *
+     * @param template - Template source string
+     * @returns Compiled template with extracted bindings
+     * @throws Error if template is null or undefined
+     */
+    analyze(template: string): ICompiledTemplate;
+}
+//# sourceMappingURL=template-analyzer.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template-analyzer.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/templates/template-analyzer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAC9C"}

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

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

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

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

package/dist/rendering/templates/template-analyzer.js

@@ -0,0 +1,74 @@
+import { CompositeTokenExtractor } from "./composite-token-extractor.js";
+import { DelimitedTokenExtractor } from "./delimited-token-extractor.js";
+import { HtmlAwareTokenExtractor } from "./html-aware-token-extractor.js";
+import { Parse5FragmentParser } from "./parse5-fragment-parser.js";
+import { SafeContentSelector } from "./safe-content-selector.js";
+export class TemplateAnalyzer {
+    extractor;
+    constructor(extractor) {
+        this.extractor = extractor ?? TemplateAnalyzer.createDefaultExtractor();
+    }
+    /**
+     * Analyzes a template and extracts bindings from safe contexts only.
+     *
+     * @param template - HTML template string with {{bindings}}
+     * @returns Compiled template with extracted bindings
+     * @throws Error if template is null or undefined
+     *
+     * @description
+     * Tokenization occurs ONLY in text nodes and allowed attribute values.
+     * Excluded contexts: tag names, attribute names, script/style content,
+     * comments, template elements, on* attributes, style attribute.
+     * Empty string templates are allowed and return zero bindings.
+     *
+     * @example
+     * ```typescript
+     * const analyzer = new TemplateAnalyzer();
+     * // Valid: text node
+     * analyzer.analyze('<div>{{message}}</div>'); // bindings: {'message'}
+     * // Valid: attribute value
+     * analyzer.analyze('<div attr="{{x}}"></div>'); // bindings: {'x'}
+     * // Invalid: tag name (excluded)
+     * analyzer.analyze('<{{tag}}></{{tag}}>'); // bindings: {}
+     * // Invalid: script content (excluded)
+     * analyzer.analyze('<script>{{x}}</script>'); // bindings: {}
+     * ```
+     */
+    analyze(template) {
+        if (template === null || template === undefined) {
+            throw new Error("Template is required");
+        }
+        const tokens = this.extractor.extract(template);
+        const bindings = this.collectBindings(tokens);
+        return {
+            templateString: template,
+            bindings,
+            clone() {
+                return {
+                    templateString: this.templateString,
+                    bindings: new Set(this.bindings),
+                    clone: this.clone,
+                };
+            },
+        };
+    }
+    collectBindings(tokens) {
+        const bindings = new Set();
+        tokens
+            .filter((token) => token.kind === "binding")
+            .forEach((token) => {
+            if (token.value) {
+                bindings.add(token.value);
+            }
+        });
+        return bindings;
+    }
+    static createDefaultExtractor() {
+        const parser = new Parse5FragmentParser();
+        const selector = new SafeContentSelector();
+        const bindingExtractor = new DelimitedTokenExtractor("{{", "}}", "binding");
+        const stringExtractor = new CompositeTokenExtractor([bindingExtractor]);
+        return new HtmlAwareTokenExtractor(parser, selector, stringExtractor);
+    }
+}
+//# sourceMappingURL=template-analyzer.js.map

package/dist/rendering/templates/template-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-analyzer.js","sourceRoot":"","sources":["../../../src/rendering/templates/template-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAKzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AA4BjE,MAAM,OAAO,gBAAgB;IACV,SAAS,CAA0B;IAEpD,YAAY,SAAmC;QAC7C,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,gBAAgB,CAAC,sBAAsB,EAAE,CAAC;IAC1E,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,QAAgB;QACtB,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAE9C,OAAO;YACL,cAAc,EAAE,QAAQ;YACxB,QAAQ;YACR,KAAK;gBACH,OAAO;oBACL,cAAc,EAAE,IAAI,CAAC,cAAc;oBACnC,QAAQ,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;oBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,MAAuB;QAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,MAAM;aACH,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;aAC3C,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACjB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,CAAC;QACL,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,sBAAsB;QACnC,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAC3C,MAAM,gBAAgB,GAAG,IAAI,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC5E,MAAM,eAAe,GAAG,IAAI,uBAAuB,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAExE,OAAO,IAAI,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;IACxE,CAAC;CACF"}