smart-lifecycle 0.1.1

package/dist/rendering/skeleton/skeleton-renderer.d.ts

@@ -0,0 +1,91 @@
+import { SmartComponent } from "../../core/smart-component.js";
+import { ComponentMetadata } from "../../core/component-metadata.js";
+import { IDomContext } from "../dom-context/dom-context.interface.js";
+import { IDomAdapter } from "../dom/dom-adapter.interface.js";
+import type { ISkeletonValidator } from "./skeleton-validator.js";
+/**
+ * Implements the responsibility of handling loading and displaying skeleton states.
+ *
+ * @description
+ * Manages the rendering of loading states (skeletons) during component initialization.
+ * Supports skeleton templates defined in component metadata and a default fallback
+ * skeleton rendered directly to the DOM context.
+ *
+ * @architecture
+ * Skeleton loading priority:
+ * 1. Metadata skeleton: metadata.skeleton property
+ * 2. Fallback: Default skeleton rendered directly to DOM context target root
+ */
+/**
+ * Defines the responsibility of rendering loading states (skeletons) during component initialization.
+ *
+ * @description
+ * Defines the contract for rendering loading states (skeletons) during component initialization.
+ * Implementations handle different skeleton sources: custom methods, metadata, or file-based loading.
+ */
+export interface ISkeletonRenderer {
+    /**
+     * Renders a skeleton element for the given component.
+     *
+     * @param component - The component instance requesting skeleton
+     * @param metadata - The component metadata containing skeleton template
+     * @param domContext - DOM context for managing subscriptions and cleanup
+     * @param constants - Optional resolved constants for [[BINDING]] preprocessing
+     * @returns Promise that completes when skeleton is rendered
+     * @throws Error if component or metadata are null/undefined
+     */
+    render(component: SmartComponent, metadata: ComponentMetadata, domContext: IDomContext, constants?: Record<string, unknown>): Promise<void>;
+}
+export declare class SkeletonRenderer implements ISkeletonRenderer {
+    private readonly domAdapter;
+    private cachedDefaultSkeleton;
+    private readonly validator;
+    /**
+     * Initializes a new instance of SkeletonRenderer.
+     *
+     * @param domAdapter - Adapter for DOM element creation
+     * @param validator - Validator enforcing whitelist rules for skeleton HTML
+     * @throws Error if any dependency is null or undefined
+     */
+    constructor(domAdapter: IDomAdapter, validator: ISkeletonValidator);
+    /**
+     * Renders a skeleton element for the given component
+     *
+     * @description
+     * Attempts to render a skeleton in order of preference, falling back gracefully.
+     * Uses metadata skeleton if available, otherwise renders the default skeleton.
+     *
+     * @param component - The component instance requesting skeleton
+     * @param metadata - The component metadata containing skeleton template
+     * @param domContext - DOM context for managing subscriptions and cleanup
+     * @returns Promise that completes when skeleton is rendered
+     *
+     * @example
+     * ```typescript
+     * // Metadata skeleton via @SmartRender decorator
+     * @SmartRender({
+     *   skeleton: '<div class="loading">Loading component...</div>'
+     * })
+     * ```
+     */
+    render(component: SmartComponent, metadata: ComponentMetadata, domContext: IDomContext, constants?: Record<string, unknown>): Promise<void>;
+    private tryRenderMetadataSkeleton;
+    private renderSkeletonWrapper;
+    private renderDefaultSkeleton;
+    private buildDefaultSkeleton;
+    private createSkeletonStructure;
+    private createSkeletonStyles;
+    /**
+     * Sanitizes skeleton HTML to prevent execution of dangerous content.
+     *
+     * @description
+     * Removes <script> tags and inline event handler attributes (on*). Also strips
+     * javascript: URLs from href/src attributes. Intended as a defensive measure;
+     * skeleton templates are developer-provided, but this ensures SSR/browser safety.
+     *
+     * @param html - Raw HTML string to sanitize
+     * @returns Sanitized HTML string
+     */
+    private sanitizeHTML;
+}
+//# sourceMappingURL=skeleton-renderer.d.ts.map

package/dist/rendering/skeleton/skeleton-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-renderer.d.ts","sourceRoot":"","sources":["../../../src/rendering/skeleton/skeleton-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACL,WAAW,EAEZ,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE;;;;;;;;;;;;GAYG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;OASG;IACH,MAAM,CACJ,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,WAAW,EACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,qBAAa,gBAAiB,YAAW,iBAAiB;IAYtD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAX7B,OAAO,CAAC,qBAAqB,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C;;;;;;OAMG;gBAEgB,UAAU,EAAE,WAAW,EACxC,SAAS,EAAE,kBAAkB;IAM/B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CACV,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,WAAW,EACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC;IAYhB,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,oBAAoB;IAqC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY;CAkCrB"}

package/dist/rendering/skeleton/skeleton-renderer.interface.d.ts

@@ -0,0 +1,33 @@
+import { SmartComponent } from '../../core/smart-component.js';
+import { ComponentMetadata } from '../../core/component-metadata.js';
+import { IDomContext } from '../dom-context/dom-context.interface.js';
+/**
+ * Defines the responsibility of rendering loading states (skeletons) during component initialization.
+ *
+ * @description
+ * Defines the contract for rendering loading states (skeletons) during component initialization.
+ * Implementations handle different skeleton sources: custom methods, metadata, or file-based loading.
+ */
+export interface ISkeletonRenderer {
+    /**
+     * Renders a skeleton element for the given component.
+     *
+     * @param component - The component instance requesting skeleton
+     * @param metadata - The component metadata containing skeleton template
+     * @param domContext - DOM context for managing subscriptions and cleanup
+     * @returns Promise that completes when skeleton is rendered
+     * @throws Error if component or metadata are null/undefined
+     *
+     * @example
+     * ```typescript
+     * await skeletonRenderer.render(
+     *   myComponent,
+     *   metadata,
+     *   domContext
+     * );
+     * // Skeleton is now rendered directly to domContext target root
+     * ```
+     */
+    render(component: SmartComponent, metadata: ComponentMetadata, domContext: IDomContext): Promise<void>;
+}
+//# sourceMappingURL=skeleton-renderer.interface.d.ts.map

package/dist/rendering/skeleton/skeleton-renderer.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-renderer.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/skeleton/skeleton-renderer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CACJ,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/rendering/skeleton/skeleton-renderer.interface.js

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

package/dist/rendering/skeleton/skeleton-renderer.interface.js.map

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

package/dist/rendering/skeleton/skeleton-renderer.js

@@ -0,0 +1,188 @@
+import { DomContentType, } from "../dom-context/dom-context.interface.js";
+import { StaticBindingResolver } from "../bindings/static-binding-resolver.js";
+export class SkeletonRenderer {
+    domAdapter;
+    cachedDefaultSkeleton = null;
+    validator;
+    /**
+     * Initializes a new instance of SkeletonRenderer.
+     *
+     * @param domAdapter - Adapter for DOM element creation
+     * @param validator - Validator enforcing whitelist rules for skeleton HTML
+     * @throws Error if any dependency is null or undefined
+     */
+    constructor(domAdapter, validator) {
+        this.domAdapter = domAdapter;
+        if (!domAdapter)
+            throw new Error("Dom adapter is required");
+        if (!validator)
+            throw new Error("Skeleton validator is required");
+        this.validator = validator;
+    }
+    /**
+     * Renders a skeleton element for the given component
+     *
+     * @description
+     * Attempts to render a skeleton in order of preference, falling back gracefully.
+     * Uses metadata skeleton if available, otherwise renders the default skeleton.
+     *
+     * @param component - The component instance requesting skeleton
+     * @param metadata - The component metadata containing skeleton template
+     * @param domContext - DOM context for managing subscriptions and cleanup
+     * @returns Promise that completes when skeleton is rendered
+     *
+     * @example
+     * ```typescript
+     * // Metadata skeleton via @SmartRender decorator
+     * @SmartRender({
+     *   skeleton: '<div class="loading">Loading component...</div>'
+     * })
+     * ```
+     */
+    async render(component, metadata, domContext, constants) {
+        if (!component)
+            throw new Error("Component is required");
+        if (!metadata)
+            throw new Error("Metadata is required");
+        if (!domContext)
+            throw new Error("DOM context is required");
+        if (this.tryRenderMetadataSkeleton(metadata, domContext, constants)) {
+            return;
+        }
+        this.renderDefaultSkeleton(domContext);
+    }
+    tryRenderMetadataSkeleton(metadata, domContext, constants) {
+        if (!metadata.skeleton) {
+            return false;
+        }
+        // Validate skeleton template before rendering
+        try {
+            this.validator.validate(metadata.skeleton);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error("[SkeletonRenderer] Skeleton template validation failed:", msg);
+            throw error;
+        }
+        let skeletonHTML = metadata.skeleton;
+        if (constants) {
+            const resolver = new StaticBindingResolver();
+            skeletonHTML = resolver.resolve(skeletonHTML, constants);
+        }
+        this.renderSkeletonWrapper(skeletonHTML, domContext);
+        return true;
+    }
+    renderSkeletonWrapper(skeletonHTML, domContext) {
+        const wrapper = this.domAdapter.createElement("div");
+        const safeHTML = this.sanitizeHTML(skeletonHTML);
+        wrapper.innerHTML = safeHTML;
+        wrapper.setAttribute("data-skeleton", "true");
+        domContext.setElement(wrapper, DomContentType.SKELETON);
+    }
+    renderDefaultSkeleton(domContext) {
+        const skeletonElement = this.buildDefaultSkeleton();
+        skeletonElement.setAttribute("data-skeleton", "true");
+        domContext.setElement(skeletonElement, DomContentType.SKELETON);
+    }
+    buildDefaultSkeleton() {
+        // Cache the complete default skeleton (structure + styles) to avoid re-creating it
+        if (this.cachedDefaultSkeleton) {
+            return this.cachedDefaultSkeleton.cloneNode(true);
+        }
+        // Build wrapper once
+        const wrapper = this.domAdapter.createElement("div");
+        wrapper.appendChild(this.createSkeletonStructure());
+        wrapper.appendChild(this.createSkeletonStyles());
+        this.cachedDefaultSkeleton = wrapper;
+        // Return a clone for this use
+        return wrapper.cloneNode(true);
+    }
+    createSkeletonStructure() {
+        const container = this.domAdapter.createElement("div");
+        container.className = "smart-default-skeleton";
+        const dots = this.domAdapter.createElement("div");
+        dots.className = "smart-skeleton-dots";
+        for (let i = 0; i < 3; i++) {
+            const dot = this.domAdapter.createElement("div");
+            dot.className = "smart-skeleton-dot";
+            dots.appendChild(dot);
+        }
+        container.appendChild(dots);
+        return container;
+    }
+    createSkeletonStyles() {
+        const style = this.domAdapter.createElement("style");
+        style.textContent = `
+      .smart-default-skeleton {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        min-height: 100px;
+        background: #f5f5f5;
+        border-radius: 4px;
+      }
+      .smart-skeleton-dots {
+        display: flex;
+        align-items: center;
+      }
+      .smart-skeleton-dot {
+        width: 20px;
+        height: 20px;
+        background: #e0e0e0;
+        border-radius: 50%;
+        margin: 0 8px;
+        animation: smart-skeleton-pulse 1.5s ease-in-out infinite;
+      }
+      .smart-skeleton-dot:nth-child(2) {
+        animation-delay: 0.3s;
+      }
+      .smart-skeleton-dot:nth-child(3) {
+        animation-delay: 0.6s;
+      }
+      @keyframes smart-skeleton-pulse {
+        0%, 100% { opacity: 1; }
+        50% { opacity: 0.5; }
+      }
+    `;
+        return style;
+    }
+    /**
+     * Sanitizes skeleton HTML to prevent execution of dangerous content.
+     *
+     * @description
+     * Removes <script> tags and inline event handler attributes (on*). Also strips
+     * javascript: URLs from href/src attributes. Intended as a defensive measure;
+     * skeleton templates are developer-provided, but this ensures SSR/browser safety.
+     *
+     * @param html - Raw HTML string to sanitize
+     * @returns Sanitized HTML string
+     */
+    sanitizeHTML(html) {
+        const temp = this.domAdapter.createElement("div");
+        temp.innerHTML = html || "";
+        // Remove <script> elements
+        const scripts = Array.from(temp.querySelectorAll("script"));
+        scripts.forEach((s) => s.remove());
+        // Walk elements and strip dangerous attributes
+        const walk = (el) => {
+            // Remove inline event handlers (on*)
+            Array.from(el.attributes).forEach((attr) => {
+                const name = attr.name.toLowerCase();
+                const value = attr.value?.toLowerCase() || "";
+                if (name.startsWith("on")) {
+                    el.removeAttribute(attr.name);
+                    return;
+                }
+                // Strip javascript: urls in href/src
+                if ((name === "href" || name === "src") &&
+                    value.trim().startsWith("javascript:")) {
+                    el.removeAttribute(attr.name);
+                }
+            });
+            Array.from(el.children).forEach((child) => walk(child));
+        };
+        Array.from(temp.children).forEach((child) => walk(child));
+        return temp.innerHTML;
+    }
+}
+//# sourceMappingURL=skeleton-renderer.js.map

package/dist/rendering/skeleton/skeleton-renderer.js.map

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

package/dist/rendering/skeleton/skeleton-validator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Defines the responsibility of validating skeleton templates.
+ *
+ * @description
+ * Contract for validating developer-supplied skeleton HTML. Implementations must
+ * throw an Error describing the violation when the input is not acceptable.
+ */
+export interface ISkeletonValidator {
+    /**
+     * Validates the provided skeleton HTML string.
+     *
+     * @param html - Raw skeleton HTML to validate
+     * @throws Error if the HTML contains disallowed tags, attributes, or URLs
+     */
+    validate(html: string): void;
+}
+/**
+ * Implements the responsibility of validating skeleton HTML templates.
+ *
+ * @description
+ * Enforces whitelist of allowed tags and attributes to prevent developers
+ * from accidentally breaking layouts, performance, or security via skeleton templates.
+ * Fails fast with clear errors so developers know what went wrong.
+ *
+ * @remarks
+ * - Allowed tags include common semantic, structural, and basic SVG elements.
+ * - Allowed attributes include common HTML and selected SVG attributes; prefixes `data-*`, `aria-*`, and XMLNS/xlink are permitted.
+ * - Forbidden content includes `<style>`, `<script>`, inline event handlers (`on*`), and `javascript:` URLs.
+ */
+export declare class SkeletonValidator implements ISkeletonValidator {
+    private readonly ALLOWED_TAGS;
+    private readonly ALLOWED_ATTRIBUTES;
+    /**
+     * Validates skeleton HTML template.
+     *
+     * @param html - Raw skeleton HTML to validate
+     * @throws Error with clear message if validation fails
+     *
+     * @example
+     * ```typescript
+     * const validator = new SkeletonValidator();
+     * validator.validate('<div class="loader"><span>Loading...</span></div>'); // OK
+     * validator.validate('<style>body { display: none; }</style>'); // Throws error
+     * ```
+     */
+    validate(html: string): void;
+    private checkForbiddenTags;
+    private checkForbiddenAttributes;
+    private checkDangerousUrls;
+}
+//# sourceMappingURL=skeleton-validator.d.ts.map

package/dist/rendering/skeleton/skeleton-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-validator.d.ts","sourceRoot":"","sources":["../../../src/rendering/skeleton/skeleton-validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAyE1B;IAEH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAsChC;IAEH;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa5B,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,wBAAwB;IA4ChC,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/rendering/skeleton/skeleton-validator.interface.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Defines the responsibility of validating skeleton templates.
+ *
+ * @description
+ * Contract for validating developer-supplied skeleton HTML. Implementations must
+ * throw an Error describing the violation when the input is not acceptable.
+ */
+export interface ISkeletonValidator {
+    /**
+     * Validates the provided skeleton HTML string.
+     *
+     * @param html - Raw skeleton HTML to validate
+     * @throws Error if the HTML contains disallowed tags, attributes, or URLs
+     *
+     * @example
+     * ```typescript
+     * const validator: ISkeletonValidator = new SkeletonValidator();
+     * validator.validate('<div class="skeleton"></div>');
+     * ```
+     */
+    validate(html: string): void;
+}
+//# sourceMappingURL=skeleton-validator.interface.d.ts.map

package/dist/rendering/skeleton/skeleton-validator.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-validator.interface.d.ts","sourceRoot":"","sources":["../../../src/rendering/skeleton/skeleton-validator.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B"}

package/dist/rendering/skeleton/skeleton-validator.interface.js

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

package/dist/rendering/skeleton/skeleton-validator.interface.js.map

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

package/dist/rendering/skeleton/skeleton-validator.js

@@ -0,0 +1,215 @@
+/**
+ * Implements the responsibility of validating skeleton HTML templates.
+ *
+ * @description
+ * Enforces whitelist of allowed tags and attributes to prevent developers
+ * from accidentally breaking layouts, performance, or security via skeleton templates.
+ * Fails fast with clear errors so developers know what went wrong.
+ *
+ * @remarks
+ * - Allowed tags include common semantic, structural, and basic SVG elements.
+ * - Allowed attributes include common HTML and selected SVG attributes; prefixes `data-*`, `aria-*`, and XMLNS/xlink are permitted.
+ * - Forbidden content includes `<style>`, `<script>`, inline event handlers (`on*`), and `javascript:` URLs.
+ */
+export class SkeletonValidator {
+    ALLOWED_TAGS = new Set([
+        // Containers
+        "div",
+        "span",
+        "section",
+        "article",
+        "header",
+        "footer",
+        "main",
+        "aside",
+        "nav",
+        // Text
+        "p",
+        "h1",
+        "h2",
+        "h3",
+        "h4",
+        "h5",
+        "h6",
+        "strong",
+        "em",
+        "b",
+        "i",
+        "small",
+        "mark",
+        "code",
+        "pre",
+        // Media
+        "img",
+        "svg",
+        "picture",
+        "source",
+        "circle",
+        "rect",
+        "path",
+        "g",
+        "line",
+        "polyline",
+        "polygon",
+        "text",
+        "tspan",
+        "defs",
+        "use",
+        "a",
+        // Forms
+        "button",
+        "form",
+        "input",
+        "label",
+        "fieldset",
+        "legend",
+        "textarea",
+        "select",
+        "option",
+        // Lists
+        "ul",
+        "li",
+        "ol",
+        "dl",
+        "dt",
+        "dd",
+        // Semantic
+        "figure",
+        "figcaption",
+        "table",
+        "tbody",
+        "thead",
+        "tfoot",
+        "tr",
+        "td",
+        "th",
+        "blockquote",
+        "hr",
+    ]);
+    ALLOWED_ATTRIBUTES = new Set([
+        "class",
+        "id",
+        "role",
+        "title",
+        "alt",
+        "type",
+        "placeholder",
+        "disabled",
+        "readonly",
+        "required",
+        "tabindex",
+        "aria-label",
+        "aria-labelledby",
+        "aria-describedby",
+        "aria-hidden",
+        "aria-live",
+        "aria-atomic",
+        "width",
+        "height",
+        "src",
+        "href",
+        "target",
+        "rel",
+        "xmlns",
+        "viewbox",
+        "cx",
+        "cy",
+        "r",
+        "x",
+        "y",
+        "d",
+        "fill",
+        "stroke",
+        "stroke-width",
+        "transform",
+        "xmlns:xlink",
+        "xlink:href",
+    ]);
+    /**
+     * Validates skeleton HTML template.
+     *
+     * @param html - Raw skeleton HTML to validate
+     * @throws Error with clear message if validation fails
+     *
+     * @example
+     * ```typescript
+     * const validator = new SkeletonValidator();
+     * validator.validate('<div class="loader"><span>Loading...</span></div>'); // OK
+     * validator.validate('<style>body { display: none; }</style>'); // Throws error
+     * ```
+     */
+    validate(html) {
+        if (!html || !html.trim()) {
+            return; // Empty skeleton is valid
+        }
+        // Check for forbidden tags
+        this.checkForbiddenTags(html);
+        // Check for forbidden attributes
+        this.checkForbiddenAttributes(html);
+        // Check for dangerous URLs
+        this.checkDangerousUrls(html);
+    }
+    checkForbiddenTags(html) {
+        // Check for <style> tags
+        if (/<style[\s>]/i.test(html)) {
+            throw new Error(`[SkeletonValidator] Tag <style> is not allowed in skeleton templates. ` +
+                `Allowed tags: ${Array.from(this.ALLOWED_TAGS).join(", ")}`);
+        }
+        // Check for <script> tags
+        if (/<script[\s>]/i.test(html)) {
+            throw new Error(`[SkeletonValidator] Tag <script> is not allowed in skeleton templates. ` +
+                `Allowed tags: ${Array.from(this.ALLOWED_TAGS).join(", ")}`);
+        }
+        // Check for tags not in whitelist using regex
+        const tagRegex = /<\/?\s*([a-z][a-z0-9-]*)/gi;
+        let match;
+        const checkedTags = new Set();
+        while ((match = tagRegex.exec(html)) !== null) {
+            const tag = match[1].toLowerCase();
+            if (!checkedTags.has(tag) && !this.ALLOWED_TAGS.has(tag)) {
+                checkedTags.add(tag);
+                throw new Error(`[SkeletonValidator] Tag <${tag}> is not allowed in skeleton templates. ` +
+                    `Allowed tags: ${Array.from(this.ALLOWED_TAGS).join(", ")}`);
+            }
+        }
+    }
+    checkForbiddenAttributes(html) {
+        // Check for event handlers (on*)
+        if (/\s(on[a-z]+)\s*=/i.test(html)) {
+            const match = html.match(/\s(on[a-z]+)\s*=/i);
+            const attr = match ? match[1] : "on*";
+            throw new Error(`[SkeletonValidator] Event handler attribute "${attr}" is not allowed in skeleton templates. ` +
+                `Use data-* attributes or CSS classes instead.`);
+        }
+        // Check for style attribute
+        if (/\sstyle\s*=/i.test(html)) {
+            throw new Error(`[SkeletonValidator] Attribute "style" is not allowed in skeleton templates.`);
+        }
+        // Check for disallowed attributes (not in whitelist and not data-* or aria-* or namespaced)
+        const attrRegex = /\s([a-z][a-z0-9:_-]*)\s*=/gi;
+        let match;
+        const checkedAttrs = new Set();
+        while ((match = attrRegex.exec(html)) !== null) {
+            const attr = match[1].toLowerCase();
+            if (!checkedAttrs.has(attr)) {
+                checkedAttrs.add(attr);
+                // Allow data-*, aria-*, namespaced (xmlns, xlink:*), and whitelisted
+                if (!attr.startsWith("data-") &&
+                    !attr.startsWith("aria-") &&
+                    !attr.startsWith("xmlns") &&
+                    !attr.startsWith("xlink:") &&
+                    !this.ALLOWED_ATTRIBUTES.has(attr)) {
+                    throw new Error(`[SkeletonValidator] Attribute "${attr}" is not allowed in skeleton templates. ` +
+                        `Allowed attributes: ${Array.from(this.ALLOWED_ATTRIBUTES).join(", ")}, data-*, aria-*, xmlns*`);
+                }
+            }
+        }
+    }
+    checkDangerousUrls(html) {
+        // Check for javascript: URLs in href or src
+        if (/\s(?:href|src)\s*=\s*["']?\s*javascript:/i.test(html)) {
+            throw new Error(`[SkeletonValidator] JavaScript URLs are not allowed in href/src attributes.`);
+        }
+    }
+}
+//# sourceMappingURL=skeleton-validator.js.map

package/dist/rendering/skeleton/skeleton-validator.js.map

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

package/dist/rendering/slots/index.d.ts

@@ -0,0 +1,2 @@
+export { SlotContentRegistry } from './slot-content.registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rendering/slots/index.d.ts.map

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

package/dist/rendering/slots/index.js

@@ -0,0 +1,2 @@
+export { SlotContentRegistry } from './slot-content.registry.js';
+//# sourceMappingURL=index.js.map