smart-lifecycle 0.1.1

package/dist/components/smart-action/smart-action.lifecycle-manager.js

@@ -0,0 +1,140 @@
+/**
+ * Implements the responsibility of wiring DOM events for smart-action.
+ */
+import { SmartLifecycleManager } from '../../behaviors/lifecycle-manager.base.js';
+import { SmartInputStore } from '../../rendering/inputs/smart-input-store.js';
+import { ObjectRegistry } from '../../utils/object-registry.js';
+export class SmartActionLifecycleManager extends SmartLifecycleManager {
+    hostResolver;
+    eventListeners = [];
+    /**
+     * Initializes a new instance of SmartActionLifecycleManager.
+     *
+     * @param hostResolver - Resolver for obtaining host elements
+     * @throws Error if hostResolver is null or undefined
+     */
+    constructor(hostResolver) {
+        super();
+        this.hostResolver = hostResolver;
+        if (!hostResolver) {
+            throw new Error('Host resolver is required');
+        }
+    }
+    onComponentReady(component) {
+        const host = this.hostResolver.resolve(component);
+        const hasFocusableChild = this.hasFocusableDescendant(host);
+        const clickHandler = (event) => {
+            this.handleClick(event, host);
+        };
+        host.addEventListener('click', clickHandler);
+        this.eventListeners.push({ target: host, event: 'click', handler: clickHandler });
+        if (!hasFocusableChild) {
+            if (!host.hasAttribute('role')) {
+                host.setAttribute('role', 'button');
+            }
+            if (!host.hasAttribute('tabindex')) {
+                host.setAttribute('tabindex', '0');
+            }
+            const keydownHandler = (event) => {
+                this.handleKeydown(event, host);
+            };
+            host.addEventListener('keydown', keydownHandler);
+            this.eventListeners.push({ target: host, event: 'keydown', handler: keydownHandler });
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    onComponentDestroy(_component) {
+        this.eventListeners.forEach(({ target, event, handler }) => {
+            target.removeEventListener(event, handler);
+        });
+        this.eventListeners = [];
+    }
+    handleClick(event, host) {
+        if (event.defaultPrevented) {
+            return;
+        }
+        if (host.hasAttribute('disabled')) {
+            return;
+        }
+        const target = event.target;
+        if (this.isDisabledControl(target)) {
+            return;
+        }
+        this.dispatchAction(host);
+    }
+    handleKeydown(event, host) {
+        if (event.defaultPrevented) {
+            return;
+        }
+        if (event.target !== host) {
+            return;
+        }
+        if (event.key === 'Enter' || event.key === ' ') {
+            event.preventDefault();
+            this.dispatchAction(host);
+        }
+    }
+    dispatchAction(host) {
+        const name = this.resolveActionName(host);
+        if (!name) {
+            return;
+        }
+        const value = this.resolveActionValue(host);
+        const detail = { name };
+        if (value !== undefined) {
+            detail.value = value;
+        }
+        const actionEvent = new CustomEvent('smart-action', {
+            bubbles: true,
+            composed: true,
+            detail
+        });
+        host.dispatchEvent(actionEvent);
+    }
+    resolveActionName(host) {
+        const storedId = SmartInputStore.get(host, 'event');
+        if (storedId) {
+            const registryValue = ObjectRegistry.get(storedId);
+            if (typeof registryValue === 'string' && registryValue.length > 0) {
+                return registryValue;
+            }
+        }
+        const attrValue = host.getAttribute('event');
+        if (attrValue && attrValue.length > 0) {
+            return attrValue;
+        }
+        return null;
+    }
+    resolveActionValue(host) {
+        const storedId = SmartInputStore.get(host, 'value');
+        if (storedId) {
+            const registryValue = ObjectRegistry.get(storedId);
+            if (registryValue !== undefined) {
+                return registryValue;
+            }
+        }
+        const attrValue = host.getAttribute('value');
+        if (attrValue !== null) {
+            return attrValue;
+        }
+        return undefined;
+    }
+    hasFocusableDescendant(host) {
+        const focusable = host.querySelector('button, a[href], input, select, textarea, [tabindex]');
+        return Boolean(focusable);
+    }
+    isDisabledControl(target) {
+        if (!target || !(target instanceof HTMLElement)) {
+            return false;
+        }
+        const tagName = target.tagName.toLowerCase();
+        if (tagName === 'button' || tagName === 'input' || tagName === 'select' || tagName === 'textarea') {
+            return Boolean(target.disabled);
+        }
+        if (target.hasAttribute('disabled')) {
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=smart-action.lifecycle-manager.js.map

package/dist/components/smart-action/smart-action.lifecycle-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-action.lifecycle-manager.js","sourceRoot":"","sources":["../../../src/components/smart-action/smart-action.lifecycle-manager.ts"],"names":[],"mappings":"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"}

package/dist/components/smart-action.d.ts

@@ -0,0 +1,66 @@
+/**
+ * SmartAction - Lightweight custom element for event dispatch
+ *
+ * @description
+ * A simple HTMLElement (not SmartComponent) that emits 'smart-action' CustomEvent
+ * when clicked or activated via keyboard (Enter/Space). Integrates with SmartComponent
+ * instances to invoke view action handlers.
+ *
+ * @attributes
+ * - event: string - Name of the action event to dispatch
+ * - value: string (optional) - Value payload for the action
+ * - disabled: boolean - When present, prevents event dispatch
+ *
+ * @fires smart-action - CustomEvent with detail { name: string, value?: string }
+ * - bubbles: true
+ * - composed: true
+ *
+ * @example
+ * ```html
+ * <smart-action event="increment" value="1">+</smart-action>
+ * <smart-action event="submit">Submit Form</smart-action>
+ * <smart-action event="delete" disabled>Delete (disabled)</smart-action>
+ * ```
+ *
+ * @remarks
+ * - NOT a SmartComponent; pure HTMLElement
+ * - NO lifecycle manager, NO initializer, NO SmartComponent bindings
+ * - Emits native CustomEvent with bubbles:true, composed:true
+ * - Keyboard support: Enter and Space keys
+ */
+export declare class SmartAction extends HTMLElement {
+    constructor();
+    /**
+     * Lifecycle hook: element inserted into DOM
+     */
+    connectedCallback(): void;
+    /**
+     * Lifecycle hook: element removed from DOM
+     */
+    disconnectedCallback(): void;
+    /**
+     * Handles click event
+     */
+    private handleClick;
+    /**
+     * Handles keyboard event (Enter/Space)
+     */
+    private handleKeydown;
+    /**
+     * Dispatches smart-action CustomEvent
+     *
+     * @throws No errors thrown; respects disabled attribute
+     */
+    private dispatchAction;
+}
+/**
+ * Register SmartAction custom element globally
+ *
+ * @example
+ * ```typescript
+ * import { registerSmartAction } from 'smart-lifecycle';
+ * registerSmartAction();
+ * ```
+ */
+export declare function registerSmartAction(): void;
+//# sourceMappingURL=smart-action.d.ts.map

package/dist/components/smart-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-action.d.ts","sourceRoot":"","sources":["../../src/components/smart-action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,WAAY,SAAQ,WAAW;;IAK1C;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAgBzB;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAK5B;;OAEG;IACH,OAAO,CAAC,WAAW,CAEjB;IAEF;;OAEG;IACH,OAAO,CAAC,aAAa,CAKnB;IAEF;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAwBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C"}

package/dist/components/smart-action.js

@@ -0,0 +1,111 @@
+/**
+ * SmartAction - Lightweight custom element for event dispatch
+ *
+ * @description
+ * A simple HTMLElement (not SmartComponent) that emits 'smart-action' CustomEvent
+ * when clicked or activated via keyboard (Enter/Space). Integrates with SmartComponent
+ * instances to invoke view action handlers.
+ *
+ * @attributes
+ * - event: string - Name of the action event to dispatch
+ * - value: string (optional) - Value payload for the action
+ * - disabled: boolean - When present, prevents event dispatch
+ *
+ * @fires smart-action - CustomEvent with detail { name: string, value?: string }
+ * - bubbles: true
+ * - composed: true
+ *
+ * @example
+ * ```html
+ * <smart-action event="increment" value="1">+</smart-action>
+ * <smart-action event="submit">Submit Form</smart-action>
+ * <smart-action event="delete" disabled>Delete (disabled)</smart-action>
+ * ```
+ *
+ * @remarks
+ * - NOT a SmartComponent; pure HTMLElement
+ * - NO lifecycle manager, NO initializer, NO SmartComponent bindings
+ * - Emits native CustomEvent with bubbles:true, composed:true
+ * - Keyboard support: Enter and Space keys
+ */
+export class SmartAction extends HTMLElement {
+    constructor() {
+        super();
+    }
+    /**
+     * Lifecycle hook: element inserted into DOM
+     */
+    connectedCallback() {
+        // Make keyboard accessible
+        if (!this.hasAttribute('tabindex')) {
+            this.setAttribute('tabindex', '0');
+        }
+        // Bind click handler
+        this.addEventListener('click', this.handleClick);
+        // Bind keyboard handler
+        this.addEventListener('keydown', this.handleKeydown);
+        // Apply base styling
+        this.style.cursor = 'pointer';
+    }
+    /**
+     * Lifecycle hook: element removed from DOM
+     */
+    disconnectedCallback() {
+        this.removeEventListener('click', this.handleClick);
+        this.removeEventListener('keydown', this.handleKeydown);
+    }
+    /**
+     * Handles click event
+     */
+    handleClick = () => {
+        this.dispatchAction();
+    };
+    /**
+     * Handles keyboard event (Enter/Space)
+     */
+    handleKeydown = (e) => {
+        if (e.key === 'Enter' || e.key === ' ') {
+            e.preventDefault();
+            this.dispatchAction();
+        }
+    };
+    /**
+     * Dispatches smart-action CustomEvent
+     *
+     * @throws No errors thrown; respects disabled attribute
+     */
+    dispatchAction() {
+        if (this.hasAttribute('disabled')) {
+            return;
+        }
+        const eventName = this.getAttribute('event') || 'action';
+        const value = this.getAttribute('value');
+        const detail = {
+            name: eventName
+        };
+        if (value !== null) {
+            detail.value = value;
+        }
+        const event = new CustomEvent('smart-action', {
+            detail,
+            bubbles: true,
+            composed: true
+        });
+        this.dispatchEvent(event);
+    }
+}
+/**
+ * Register SmartAction custom element globally
+ *
+ * @example
+ * ```typescript
+ * import { registerSmartAction } from 'smart-lifecycle';
+ * registerSmartAction();
+ * ```
+ */
+export function registerSmartAction() {
+    if (!customElements.get('smart-action')) {
+        customElements.define('smart-action', SmartAction);
+    }
+}
+//# sourceMappingURL=smart-action.js.map

package/dist/components/smart-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-action.js","sourceRoot":"","sources":["../../src/components/smart-action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,2BAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAEjD,wBAAwB;QACxB,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAErD,qBAAqB;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACK,WAAW,GAAG,GAAS,EAAE;QAC/B,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC,CAAC;IAEF;;OAEG;IACK,aAAa,GAAG,CAAC,CAAgB,EAAQ,EAAE;QACjD,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YACvC,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;IAEF;;;;OAIG;IACK,cAAc;QACpB,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzC,MAAM,MAAM,GAA4B;YACtC,IAAI,EAAE,SAAS;SAChB,CAAC;QAEF,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,cAAc,EAAE;YAC5C,MAAM;YACN,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QACxC,cAAc,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/components/smart-for/diff-keys.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Implements the responsibility of computing diff operations between two key sequences.
+ *
+ * @description
+ * Pure function that produces a list of add, remove, move, and stay operations
+ * to transform a previous key sequence into the next one. Used by SmartForElement
+ * for efficient keyed list diffing.
+ */
+export type KeyType = string | number;
+export type DiffOp = {
+    type: 'remove';
+    key: KeyType;
+    from: number;
+} | {
+    type: 'add';
+    key: KeyType;
+    to: number;
+} | {
+    type: 'move';
+    key: KeyType;
+    from: number;
+    to: number;
+} | {
+    type: 'stay';
+    key: KeyType;
+    index: number;
+};
+/**
+ * Computes the diff operations between previous and next key sequences.
+ *
+ * @param previous - Sequence of keys before the update
+ * @param next - Sequence of keys after the update
+ * @returns List of diff operations to transform previous into next
+ */
+export declare function diffKeys(previous: KeyType[], next: KeyType[]): DiffOp[];
+//# sourceMappingURL=diff-keys.d.ts.map

package/dist/components/smart-for/diff-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-keys.d.ts","sourceRoot":"","sources":["../../../src/components/smart-for/diff-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtC,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAuBvE"}

package/dist/components/smart-for/diff-keys.js

@@ -0,0 +1,39 @@
+/**
+ * Implements the responsibility of computing diff operations between two key sequences.
+ *
+ * @description
+ * Pure function that produces a list of add, remove, move, and stay operations
+ * to transform a previous key sequence into the next one. Used by SmartForElement
+ * for efficient keyed list diffing.
+ */
+/**
+ * Computes the diff operations between previous and next key sequences.
+ *
+ * @param previous - Sequence of keys before the update
+ * @param next - Sequence of keys after the update
+ * @returns List of diff operations to transform previous into next
+ */
+export function diffKeys(previous, next) {
+    const ops = [];
+    const previousIndex = new Map();
+    previous.forEach((key, index) => previousIndex.set(key, index));
+    previous.forEach((key, index) => {
+        if (!next.includes(key)) {
+            ops.push({ type: 'remove', key, from: index });
+        }
+    });
+    next.forEach((key, index) => {
+        const prevIndex = previousIndex.get(key);
+        if (prevIndex === undefined) {
+            ops.push({ type: 'add', key, to: index });
+        }
+        else if (prevIndex !== index) {
+            ops.push({ type: 'move', key, from: prevIndex, to: index });
+        }
+        else {
+            ops.push({ type: 'stay', key, index });
+        }
+    });
+    return ops;
+}
+//# sourceMappingURL=diff-keys.js.map

package/dist/components/smart-for/diff-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-keys.js","sourceRoot":"","sources":["../../../src/components/smart-for/diff-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAmB,EAAE,IAAe;IAC3D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAEhE,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC1B,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/components/smart-for/item-dom-context.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Implements the responsibility of providing a minimal DOM context for each smart-for row.
+ *
+ * @description
+ * Carries the compiled element reference and manages subscriptions for cleanup.
+ * When a row is removed, destroy() tears down all reactive subscriptions.
+ */
+import type { IDomContext } from "../../rendering/dom-context/dom-context.interface.js";
+import { DomContentType } from "../../rendering/dom-context/dom-context.interface.js";
+import type { Unsubscribe } from "../../reactive/signal.js";
+export declare class ItemDomContext implements IDomContext {
+    private readonly targetRoot;
+    readonly contextId: string;
+    private element;
+    private subscriptions;
+    constructor(targetRoot: HTMLElement);
+    getElement(): HTMLElement | null;
+    getTargetRoot(): HTMLElement;
+    setElement(element: HTMLElement): void;
+    getIsRendered(): boolean;
+    addSubscription(subscription: Unsubscribe): void;
+    query(selector: string): HTMLElement | null;
+    clearSubscriptions(): void;
+    getContentType(): DomContentType;
+    destroy(): void;
+}
+//# sourceMappingURL=item-dom-context.d.ts.map

package/dist/components/smart-for/item-dom-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-dom-context.d.ts","sourceRoot":"","sources":["../../../src/components/smart-for/item-dom-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,qBAAa,cAAe,YAAW,WAAW;IAKpC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,aAAa,CAAqB;gBAEb,UAAU,EAAE,WAAW;IAIpD,UAAU,IAAI,WAAW,GAAG,IAAI;IAIhC,aAAa,IAAI,WAAW;IAI5B,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAItC,aAAa,IAAI,OAAO;IAIxB,eAAe,CAAC,YAAY,EAAE,WAAW,GAAG,IAAI;IAIhD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAM3C,kBAAkB,IAAI,IAAI;IAW1B,cAAc,IAAI,cAAc;IAIhC,OAAO,IAAI,IAAI;CAIhB"}

package/dist/components/smart-for/item-dom-context.js

@@ -0,0 +1,52 @@
+import { DomContentType } from "../../rendering/dom-context/dom-context.interface.js";
+export class ItemDomContext {
+    targetRoot;
+    contextId;
+    element = null;
+    subscriptions = [];
+    constructor(targetRoot) {
+        this.targetRoot = targetRoot;
+        this.contextId = `smart-for-item-${Math.random().toString(36).slice(2)}`;
+    }
+    getElement() {
+        return this.element;
+    }
+    getTargetRoot() {
+        return this.targetRoot;
+    }
+    setElement(element) {
+        this.element = element;
+    }
+    getIsRendered() {
+        return Boolean(this.element);
+    }
+    addSubscription(subscription) {
+        this.subscriptions.push(subscription);
+    }
+    query(selector) {
+        if (!selector)
+            throw new Error("Selector is required");
+        if (!this.element)
+            return null;
+        return this.element.querySelector(selector);
+    }
+    clearSubscriptions() {
+        this.subscriptions.forEach((unsub) => {
+            try {
+                unsub();
+            }
+            catch {
+                /* no-op */
+            }
+        });
+        this.subscriptions = [];
+    }
+    getContentType() {
+        return DomContentType.COMPONENT;
+    }
+    destroy() {
+        this.clearSubscriptions();
+        this.element = null;
+    }
+}
+//# sourceMappingURL=item-dom-context.js.map

package/dist/components/smart-for/item-dom-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-dom-context.js","sourceRoot":"","sources":["../../../src/components/smart-for/item-dom-context.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AAGtF,MAAM,OAAO,cAAc;IAKI;IAJpB,SAAS,CAAS;IACnB,OAAO,GAAuB,IAAI,CAAC;IACnC,aAAa,GAAkB,EAAE,CAAC;IAE1C,YAA6B,UAAuB;QAAvB,eAAU,GAAV,UAAU,CAAa;QAClD,IAAI,CAAC,SAAS,GAAG,kBAAkB,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,UAAU,CAAC,OAAoB;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,aAAa;QACX,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,eAAe,CAAC,YAAyB;QACvC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,QAAgB;QACpB,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,IAAI,CAAC;gBACH,KAAK,EAAE,CAAC;YACV,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,cAAc;QACZ,OAAO,cAAc,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;CACF"}

package/dist/components/smart-for/smart-for-element.d.ts

@@ -0,0 +1,38 @@
+export declare class SmartForElement extends HTMLElement {
+    private anchor;
+    private rows;
+    private templateHtml;
+    private eventListeners;
+    private pendingRenderFrame;
+    private templateCompiler;
+    private objectRegistry;
+    static get observedAttributes(): string[];
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    disconnectedCallback(): void;
+    /**
+     * Schedules a render pass on the next animation frame.
+     *
+     * @description
+     * Batches multiple attribute changes into a single render.
+     * If a frame is already pending, it is reused — only the latest state
+     * is rendered.
+     */
+    private scheduleRender;
+    private renderItems;
+    /**
+     * Updates rows using keyed diffing. When no key attribute is provided,
+     * falls back to array index as key — existing rows at the same index
+     * get their scope updated reactively instead of being destroyed and recreated.
+     *
+     * @param items - Current array of items to render
+     * @param keyAttribute - Optional key attribute name for stable identity
+     */
+    private updateRows;
+    private createRow;
+    private removeRow;
+    private disposeAllRows;
+    private resolveItems;
+    private resolveKey;
+}
+//# sourceMappingURL=smart-for-element.d.ts.map

package/dist/components/smart-for/smart-for-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-for-element.d.ts","sourceRoot":"","sources":["../../../src/components/smart-for/smart-for-element.ts"],"names":[],"mappings":"AAwCA,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,cAAc,CAId;IACR,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,cAAc,CAAgC;IAEtD,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,iBAAiB,IAAI,IAAI;IAuCzB,wBAAwB,CACtB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,IAAI;IAMP,oBAAoB,IAAI,IAAI;IAc5B;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;YAWR,WAAW;IAWzB;;;;;;;OAOG;YACW,UAAU;YAiDV,SAAS;IA0BvB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,UAAU;CAWnB"}