smart-lifecycle 0.1.1

package/dist/rendering/slots/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rendering/slots/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/rendering/slots/slot-content.registry.d.ts

@@ -0,0 +1,58 @@
+import { SmartComponent } from '../../core/smart-component.js';
+/**
+ * Implements the responsibility of managing slot content for component instances.
+ *
+ * @description
+ * Singleton registry that associates SmartComponent instances with their slot content
+ * (host element inner HTML). This separates view-related state from the core component,
+ * maintaining proper layer separation (core vs rendering).
+ *
+ * Uses WeakMap for automatic memory cleanup when component instances are garbage collected.
+ *
+ * @example
+ * ```typescript
+ * // Set slot content during template parsing
+ * SlotContentRegistry.set(component, '<div>Slot content</div>');
+ *
+ * // Retrieve slot content during projection
+ * const content = SlotContentRegistry.get(component);
+ *
+ * // Clear when no longer needed
+ * SlotContentRegistry.clear(component);
+ * ```
+ */
+export declare class SlotContentRegistry {
+    private static registry;
+    /**
+     * Associates slot content with a component instance.
+     *
+     * @param component - Component instance to store content for
+     * @param content - HTML string representing slot content
+     * @throws Error if component is null or undefined
+     */
+    static set(component: SmartComponent, content: string): void;
+    /**
+     * Retrieves slot content for a component instance.
+     *
+     * @param component - Component instance to retrieve content for
+     * @returns Slot content HTML string, or undefined if not set
+     * @throws Error if component is null or undefined
+     */
+    static get(component: SmartComponent): string | undefined;
+    /**
+     * Checks if slot content exists for a component instance.
+     *
+     * @param component - Component instance to check
+     * @returns true if slot content is stored, false otherwise
+     * @throws Error if component is null or undefined
+     */
+    static has(component: SmartComponent): boolean;
+    /**
+     * Removes slot content for a component instance.
+     *
+     * @param component - Component instance to clear content for
+     * @throws Error if component is null or undefined
+     */
+    static clear(component: SmartComponent): void;
+}
+//# sourceMappingURL=slot-content.registry.d.ts.map

package/dist/rendering/slots/slot-content.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-content.registry.d.ts","sourceRoot":"","sources":["../../../src/rendering/slots/slot-content.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyC;IAEhE;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5D;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS;IAOzD;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO;IAO9C;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;CAM9C"}

package/dist/rendering/slots/slot-content.registry.js

@@ -0,0 +1,77 @@
+/**
+ * Implements the responsibility of managing slot content for component instances.
+ *
+ * @description
+ * Singleton registry that associates SmartComponent instances with their slot content
+ * (host element inner HTML). This separates view-related state from the core component,
+ * maintaining proper layer separation (core vs rendering).
+ *
+ * Uses WeakMap for automatic memory cleanup when component instances are garbage collected.
+ *
+ * @example
+ * ```typescript
+ * // Set slot content during template parsing
+ * SlotContentRegistry.set(component, '<div>Slot content</div>');
+ *
+ * // Retrieve slot content during projection
+ * const content = SlotContentRegistry.get(component);
+ *
+ * // Clear when no longer needed
+ * SlotContentRegistry.clear(component);
+ * ```
+ */
+export class SlotContentRegistry {
+    static registry = new WeakMap();
+    /**
+     * Associates slot content with a component instance.
+     *
+     * @param component - Component instance to store content for
+     * @param content - HTML string representing slot content
+     * @throws Error if component is null or undefined
+     */
+    static set(component, content) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        this.registry.set(component, content);
+    }
+    /**
+     * Retrieves slot content for a component instance.
+     *
+     * @param component - Component instance to retrieve content for
+     * @returns Slot content HTML string, or undefined if not set
+     * @throws Error if component is null or undefined
+     */
+    static get(component) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        return this.registry.get(component);
+    }
+    /**
+     * Checks if slot content exists for a component instance.
+     *
+     * @param component - Component instance to check
+     * @returns true if slot content is stored, false otherwise
+     * @throws Error if component is null or undefined
+     */
+    static has(component) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        return this.registry.has(component);
+    }
+    /**
+     * Removes slot content for a component instance.
+     *
+     * @param component - Component instance to clear content for
+     * @throws Error if component is null or undefined
+     */
+    static clear(component) {
+        if (!component) {
+            throw new Error('Component is required');
+        }
+        this.registry.delete(component);
+    }
+}
+//# sourceMappingURL=slot-content.registry.js.map

package/dist/rendering/slots/slot-content.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-content.registry.js","sourceRoot":"","sources":["../../../src/rendering/slots/slot-content.registry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAC,QAAQ,GAAG,IAAI,OAAO,EAA0B,CAAC;IAEhE;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,SAAyB,EAAE,OAAe;QACnD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,SAAyB;QAClC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,SAAyB;QAClC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,SAAyB;QACpC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC"}

package/dist/rendering/styles/shared-styles-registry.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Defines the responsibility of managing shared CSSStyleSheet instances
+ * that are adopted by every Shadow Root in the framework.
+ *
+ * @description
+ * Follows the Lit pattern: stylesheets are parsed once into CSSStyleSheet
+ * objects and shared across all component shadow roots via adoptedStyleSheets.
+ * This avoids injecting duplicate `<link>` tags into every shadow root.
+ */
+export interface ISharedStylesRegistry {
+    /**
+     * Adds a CSSStyleSheet to the shared set.
+     *
+     * @param sheet - A constructed CSSStyleSheet instance
+     */
+    add(sheet: CSSStyleSheet): void;
+    /**
+     * Returns all registered shared stylesheets.
+     *
+     * @returns Readonly array of CSSStyleSheet instances
+     */
+    getAll(): readonly CSSStyleSheet[];
+    /**
+     * Applies all shared stylesheets to a ShadowRoot via adoptedStyleSheets.
+     *
+     * @param shadowRoot - The target ShadowRoot
+     */
+    applyTo(shadowRoot: ShadowRoot): void;
+}
+/**
+ * Implements the responsibility of storing and distributing shared CSSStyleSheet
+ * instances across all component Shadow Roots.
+ *
+ * @example
+ * ```typescript
+ * const registry = new SharedStylesRegistry();
+ * const sheet = new CSSStyleSheet();
+ * sheet.replaceSync(cssText);
+ * registry.add(sheet);
+ *
+ * // Later, in the render pipeline:
+ * registry.applyTo(shadowRoot);
+ * ```
+ */
+export declare class SharedStylesRegistry implements ISharedStylesRegistry {
+    private readonly sheets;
+    /**
+     * Adds a CSSStyleSheet to the shared set.
+     *
+     * @param sheet - A constructed CSSStyleSheet instance
+     * @throws Error if sheet is not a CSSStyleSheet
+     */
+    add(sheet: CSSStyleSheet): void;
+    /**
+     * Returns all registered shared stylesheets.
+     *
+     * @returns Readonly array of CSSStyleSheet instances
+     */
+    getAll(): readonly CSSStyleSheet[];
+    /**
+     * Applies all shared stylesheets to a ShadowRoot via adoptedStyleSheets.
+     *
+     * @param shadowRoot - The target ShadowRoot
+     * @throws Error if shadowRoot is not provided
+     */
+    applyTo(shadowRoot: ShadowRoot): void;
+}
+//# sourceMappingURL=shared-styles-registry.d.ts.map

package/dist/rendering/styles/shared-styles-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-styles-registry.d.ts","sourceRoot":"","sources":["../../../src/rendering/styles/shared-styles-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAEhC;;;;OAIG;IACH,MAAM,IAAI,SAAS,aAAa,EAAE,CAAC;IAEnC;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAE9C;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAO/B;;;;OAIG;IACH,MAAM,IAAI,SAAS,aAAa,EAAE;IAIlC;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;CAStC"}

package/dist/rendering/styles/shared-styles-registry.js

@@ -0,0 +1,55 @@
+/**
+ * Implements the responsibility of storing and distributing shared CSSStyleSheet
+ * instances across all component Shadow Roots.
+ *
+ * @example
+ * ```typescript
+ * const registry = new SharedStylesRegistry();
+ * const sheet = new CSSStyleSheet();
+ * sheet.replaceSync(cssText);
+ * registry.add(sheet);
+ *
+ * // Later, in the render pipeline:
+ * registry.applyTo(shadowRoot);
+ * ```
+ */
+export class SharedStylesRegistry {
+    sheets = [];
+    /**
+     * Adds a CSSStyleSheet to the shared set.
+     *
+     * @param sheet - A constructed CSSStyleSheet instance
+     * @throws Error if sheet is not a CSSStyleSheet
+     */
+    add(sheet) {
+        if (!(sheet instanceof CSSStyleSheet)) {
+            throw new Error("Expected a CSSStyleSheet instance");
+        }
+        this.sheets.push(sheet);
+    }
+    /**
+     * Returns all registered shared stylesheets.
+     *
+     * @returns Readonly array of CSSStyleSheet instances
+     */
+    getAll() {
+        return this.sheets;
+    }
+    /**
+     * Applies all shared stylesheets to a ShadowRoot via adoptedStyleSheets.
+     *
+     * @param shadowRoot - The target ShadowRoot
+     * @throws Error if shadowRoot is not provided
+     */
+    applyTo(shadowRoot) {
+        if (!shadowRoot)
+            throw new Error("ShadowRoot is required");
+        if (this.sheets.length === 0)
+            return;
+        shadowRoot.adoptedStyleSheets = [
+            ...this.sheets,
+            ...shadowRoot.adoptedStyleSheets,
+        ];
+    }
+}
+//# sourceMappingURL=shared-styles-registry.js.map

package/dist/rendering/styles/shared-styles-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-styles-registry.js","sourceRoot":"","sources":["../../../src/rendering/styles/shared-styles-registry.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,oBAAoB;IACd,MAAM,GAAoB,EAAE,CAAC;IAE9C;;;;;OAKG;IACH,GAAG,CAAC,KAAoB;QACtB,IAAI,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,UAAsB;QAC5B,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,UAAU,CAAC,kBAAkB,GAAG;YAC9B,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,UAAU,CAAC,kBAAkB;SACjC,CAAC;IACJ,CAAC;CACF"}

package/dist/rendering/support/error-render-options.interface.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Defines the responsibility of carrying error rendering options.
+ *
+ * @description
+ * Encapsulates optional data required by `ErrorRenderer` to display a custom
+ * error overlay, including an HTML template and static constants for
+ * preprocessing.
+ *
+ * @example
+ * ```typescript
+ * const options: ErrorRenderOptions = {
+ *   errorTemplate: '<div class="error">{{message}}</div>',
+ *   constants: { Styles: { ERROR: 'error' } }
+ * };
+ * ```
+ */
+export interface ErrorRenderOptions {
+    /**
+     * Optional HTML template used to render the error overlay. Supports
+     * `{{message}}` placeholder, which will be replaced by the final error message.
+     */
+    errorTemplate?: string;
+    /**
+     * Optional constants object used by the static binding resolver to preprocess
+     * template placeholders like `[[Styles.ERROR]]`.
+     */
+    constants?: Record<string, unknown>;
+}
+//# sourceMappingURL=error-render-options.interface.d.ts.map

package/dist/rendering/support/error-render-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-render-options.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/support/error-render-options.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC"}

package/dist/rendering/support/error-render-options.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-render-options.interface.js.map

package/dist/rendering/support/error-render-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-render-options.interface.js","sourceRoot":"","sources":["../../../src/rendering/support/error-render-options.interface.ts"],"names":[],"mappings":""}

package/dist/rendering/support/error-renderer.d.ts

@@ -0,0 +1,56 @@
+import { IErrorRenderer } from './error-renderer.interface.js';
+import { IDomContext } from '../dom-context/dom-context.interface.js';
+import { IDomAdapter } from '../dom/dom-adapter.interface.js';
+import type { ErrorRenderOptions } from './error-render-options.interface.js';
+/**
+ * Implements the responsibility of rendering error states and overlays.
+ *
+ * @description
+ * Handles the rendering of error states when component rendering fails.
+ * Supports custom error templates from component metadata and provides
+ * a coherent fallback error overlay without hardcoded styles.
+ *
+ * @architecture
+ * Error Display Priority:
+ * 1. Custom error template: @SmartCustom({ errorTemplate: '...' })
+ * 2. Fallback overlay: Simple HTML structure with message
+ */
+export declare class ErrorRenderer implements IErrorRenderer {
+    private readonly domAdapter;
+    /**
+     * Initializes a new instance of ErrorRenderer.
+     *
+     * @param domAdapter - Adapter for DOM element creation
+     * @throws Error if domAdapter is null or undefined
+     */
+    constructor(domAdapter: IDomAdapter);
+    /**
+     * Renders an error overlay in the DOM context
+     *
+     * @description
+     * Displays error message by either using custom error template from metadata
+     * or showing a simple fallback overlay. Preprocesses constants in custom templates.
+     *
+     * @param domContext - DOM context for managing the error display
+     * @param errorMessage - Error message to display
+     * @param componentId - Component identifier for custom error template lookup
+     *
+     * @example
+     * ```typescript
+     * // Custom error template with constants
+     * @SmartCustom({
+     *   selector: 'my-component',
+     *   constants: { Styles: { ERROR: 'error-overlay' } },
+     *   errorTemplate: `<div class="[[Styles.ERROR]]">{{message}}</div>`
+     * })
+     *
+     * // Fallback: Simple structure without styles
+     * <div><div>⚠️</div><div>Error message</div></div>
+     * ```
+     */
+    render(domContext: IDomContext, errorMessage: string, options?: ErrorRenderOptions): Promise<void>;
+    private tryRenderCustomErrorTemplate;
+    private renderCustomErrorTemplate;
+    private renderDefaultErrorOverlay;
+}
+//# sourceMappingURL=error-renderer.d.ts.map

package/dist/rendering/support/error-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-renderer.d.ts","sourceRoot":"","sources":["../../../src/rendering/support/error-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAkB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,cAAc;IAOtC,OAAO,CAAC,QAAQ,CAAC,UAAU;IANvC;;;;;OAKG;gBAC0B,UAAU,EAAE,WAAW;IAGpD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,MAAM,CACV,UAAU,EAAE,WAAW,EACvB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAWhB,OAAO,CAAC,4BAA4B;YAUtB,yBAAyB;IAoBvC,OAAO,CAAC,yBAAyB;CAWlC"}

package/dist/rendering/support/error-renderer.interface.d.ts

@@ -0,0 +1,29 @@
+import { IDomContext } from '../dom-context/dom-context.interface.js';
+import type { ErrorRenderOptions } from './error-render-options.interface.js';
+/**
+ * Defines the responsibility of rendering error states and overlays.
+ *
+ * @description
+ * Defines the contract for rendering error states when component rendering fails,
+ * including custom error templates and fallback overlays.
+ */
+export interface IErrorRenderer {
+    /**
+     * Renders an error overlay in the DOM context.
+     *
+     * @param domContext - DOM context for managing the error display
+     * @param errorMessage - Error message to display
+     * @param options - Optional custom template and constants to render error overlay
+     * @throws Error if domContext or errorMessage are null/undefined
+     *
+     * @example
+     * ```typescript
+     * await errorRenderer.render(domContext, 'Component failed to render', {
+     *   errorTemplate: '<div class="error">{{message}}</div>',
+     *   constants: { Styles: { ERROR: 'error' } }
+     * });
+     * ```
+     */
+    render(domContext: IDomContext, errorMessage: string, options?: ErrorRenderOptions): Promise<void>;
+}
+//# sourceMappingURL=error-renderer.interface.d.ts.map

package/dist/rendering/support/error-renderer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-renderer.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/support/error-renderer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,UAAU,EAAE,WAAW,EACvB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/rendering/support/error-renderer.interface.js

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

package/dist/rendering/support/error-renderer.interface.js.map

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

package/dist/rendering/support/error-renderer.js

@@ -0,0 +1,92 @@
+import { DomContentType } from '../dom-context/dom-context.interface.js';
+/**
+ * Implements the responsibility of rendering error states and overlays.
+ *
+ * @description
+ * Handles the rendering of error states when component rendering fails.
+ * Supports custom error templates from component metadata and provides
+ * a coherent fallback error overlay without hardcoded styles.
+ *
+ * @architecture
+ * Error Display Priority:
+ * 1. Custom error template: @SmartCustom({ errorTemplate: '...' })
+ * 2. Fallback overlay: Simple HTML structure with message
+ */
+export class ErrorRenderer {
+    domAdapter;
+    /**
+     * Initializes a new instance of ErrorRenderer.
+     *
+     * @param domAdapter - Adapter for DOM element creation
+     * @throws Error if domAdapter is null or undefined
+     */
+    constructor(domAdapter) {
+        this.domAdapter = domAdapter;
+        if (!domAdapter)
+            throw new Error('Dom adapter is required');
+    }
+    /**
+     * Renders an error overlay in the DOM context
+     *
+     * @description
+     * Displays error message by either using custom error template from metadata
+     * or showing a simple fallback overlay. Preprocesses constants in custom templates.
+     *
+     * @param domContext - DOM context for managing the error display
+     * @param errorMessage - Error message to display
+     * @param componentId - Component identifier for custom error template lookup
+     *
+     * @example
+     * ```typescript
+     * // Custom error template with constants
+     * @SmartCustom({
+     *   selector: 'my-component',
+     *   constants: { Styles: { ERROR: 'error-overlay' } },
+     *   errorTemplate: `<div class="[[Styles.ERROR]]">{{message}}</div>`
+     * })
+     *
+     * // Fallback: Simple structure without styles
+     * <div><div>⚠️</div><div>Error message</div></div>
+     * ```
+     */
+    async render(domContext, errorMessage, options) {
+        if (!domContext)
+            throw new Error('DOM context is required');
+        if (!errorMessage)
+            throw new Error('Error message is required');
+        if (this.tryRenderCustomErrorTemplate(domContext, errorMessage, options)) {
+            return;
+        }
+        this.renderDefaultErrorOverlay(domContext, errorMessage);
+    }
+    tryRenderCustomErrorTemplate(domContext, errorMessage, options) {
+        if (!options?.errorTemplate)
+            return false;
+        this.renderCustomErrorTemplate(domContext, errorMessage, options.errorTemplate, options.constants);
+        return true;
+    }
+    async renderCustomErrorTemplate(domContext, errorMessage, errorTemplate, constants) {
+        let template = errorTemplate;
+        if (constants) {
+            const { StaticBindingResolver } = await import('../bindings/static-binding-resolver.js');
+            const resolver = new StaticBindingResolver();
+            template = resolver.resolve(template, constants);
+        }
+        const wrapper = this.domAdapter.createElement('div');
+        wrapper.innerHTML = template.replace(/\{\{\s*message\s*\}\}/g, errorMessage);
+        wrapper.setAttribute('data-error', 'true');
+        domContext.setElement(wrapper, DomContentType.ERROR);
+    }
+    renderDefaultErrorOverlay(domContext, errorMessage) {
+        const overlay = this.domAdapter.createElement('div');
+        overlay.setAttribute('data-error', 'true');
+        overlay.innerHTML = `
+      <div>
+        <div>⚠️</div>
+        <div>${errorMessage}</div>
+      </div>
+    `;
+        domContext.setElement(overlay, DomContentType.ERROR);
+    }
+}
+//# sourceMappingURL=error-renderer.js.map

package/dist/rendering/support/error-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-renderer.js","sourceRoot":"","sources":["../../../src/rendering/support/error-renderer.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAItF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,aAAa;IAOK;IAN7B;;;;;OAKG;IACH,YAA6B,UAAuB;QAAvB,eAAU,GAAV,UAAU,CAAa;QAClD,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC9D,CAAC;IACD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,MAAM,CACV,UAAuB,EACvB,YAAoB,EACpB,OAA4B;QAE5B,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAEhE,IAAI,IAAI,CAAC,4BAA4B,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC;YACzE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,yBAAyB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC3D,CAAC;IAEO,4BAA4B,CAClC,UAAuB,EACvB,YAAoB,EACpB,OAA4B;QAE5B,IAAI,CAAC,OAAO,EAAE,aAAa;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,CAAC,yBAAyB,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,yBAAyB,CACrC,UAAuB,EACvB,YAAoB,EACpB,aAAqB,EACrB,SAA2C;QAE3C,IAAI,QAAQ,GAAG,aAAa,CAAC;QAE7B,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,wCAAwC,CAAC,CAAC;YACzF,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;YAC7C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrD,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAC;QAC7E,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC3C,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAEO,yBAAyB,CAAC,UAAuB,EAAE,YAAoB;QAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrD,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO,CAAC,SAAS,GAAG;;;eAGT,YAAY;;KAEtB,CAAC;QACF,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/rendering/support/safe-methods.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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 declare const SAFE_STRING_METHODS: readonly ["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 declare const SAFE_NUMBER_METHODS: readonly ["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 declare const SAFE_ARRAY_METHODS: readonly ["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 declare const SAFE_DATE_METHODS: readonly ["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 declare const SAFE_OBJECT_METHODS: readonly ["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 declare function isSafeMethod(value: any, methodName: string): boolean;
+/**
+ * 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 declare function getSafeMethodsForType(value: any): readonly string[];
+//# sourceMappingURL=safe-methods.d.ts.map

package/dist/rendering/support/safe-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-methods.d.ts","sourceRoot":"","sources":["../../../src/rendering/support/safe-methods.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,wQAuBtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,+FAOtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB,0GASrB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,iBAAiB,oQAkBpB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,kCAGtB,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAyBpE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,SAAS,MAAM,EAAE,CAWnE"}