smart-lifecycle 0.1.1

package/dist/components/smart-for/smart-for-element.js

@@ -0,0 +1,216 @@
+/**
+ * Implements the responsibility of rendering repeated content for each item in a collection.
+ *
+ * @description
+ * Pure custom element that captures its projected innerHTML as a template, then
+ * renders one instance per item using ITemplateCompiler with reactive SmartForItemScope
+ * bindings. Supports keyed diffing for efficient DOM updates. Uses
+ * `observedAttributes` + `attributeChangedCallback` for reactive updates.
+ *
+ * Does not use the SmartComponent rendering pipeline — no @SmartRender decorator,
+ * no metadata registration, no RenderEngine, no TemplateProvider, no SkeletonRenderer.
+ *
+ * Dependencies resolved via Services.get() in connectedCallback:
+ * - ITemplateCompiler: compiles per-item templates with reactive bindings
+ *
+ * @example
+ * ```html
+ * <smart-for items="{{todos}}" key="id">
+ *   <li>{{$item.text}}</li>
+ * </smart-for>
+ * ```
+ */
+import { Services } from "../../providers/service-provider.js";
+import { SmartForItemScope } from "./smart-for-item-scope.js";
+import { ItemDomContext } from "./item-dom-context.js";
+export class SmartForElement extends HTMLElement {
+    anchor = null;
+    rows = new Map();
+    templateHtml = "";
+    eventListeners = [];
+    pendingRenderFrame = null;
+    templateCompiler = null;
+    objectRegistry = null;
+    static get observedAttributes() {
+        return ["items"];
+    }
+    connectedCallback() {
+        this.eventListeners = [];
+        this.rows = new Map();
+        // Cancel any stale rAF scheduled by attributeChangedCallback that fired
+        // BEFORE this connectedCallback (Custom Element upgrade order: attribute
+        // callbacks fire before connectedCallback). Without this, the rAF triggers
+        // a redundant second render whose updateRows re-inserts rows, causing
+        // disconnect/reconnect of nested smart-for elements that lose their template.
+        if (this.pendingRenderFrame !== null) {
+            cancelAnimationFrame(this.pendingRenderFrame);
+        }
+        this.pendingRenderFrame = null;
+        // Preserve templateHtml across reconnections (e.g. when a parent smart-for
+        // re-renders and insertBefore moves this element, triggering disconnect
+        // followed by reconnect). On first connection templateHtml is "" so we
+        // capture from the data attribute or innerHTML; on subsequent connections
+        // the previously captured template remains valid.
+        if (!this.templateHtml) {
+            const preset = this.getAttribute("data-preset-template");
+            this.templateHtml = preset ?? this.innerHTML;
+            if (preset !== null) {
+                this.removeAttribute("data-preset-template");
+            }
+        }
+        this.innerHTML = "";
+        this.style.display = "contents";
+        this.anchor = document.createComment("smart-for-anchor");
+        this.appendChild(this.anchor);
+        this.templateCompiler =
+            Services.get("ITemplateCompiler");
+        this.objectRegistry = Services.get("IObjectRegistry");
+        void this.renderItems();
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (name === "items" && oldValue !== newValue) {
+            this.scheduleRender();
+        }
+    }
+    disconnectedCallback() {
+        if (this.pendingRenderFrame !== null) {
+            cancelAnimationFrame(this.pendingRenderFrame);
+            this.pendingRenderFrame = null;
+        }
+        this.eventListeners.forEach(({ target, event, handler }) => {
+            target.removeEventListener(event, handler);
+        });
+        this.eventListeners = [];
+        this.disposeAllRows();
+        this.templateCompiler = null;
+        this.objectRegistry = null;
+    }
+    /**
+     * 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.
+     */
+    scheduleRender() {
+        if (this.pendingRenderFrame !== null) {
+            return;
+        }
+        this.pendingRenderFrame = requestAnimationFrame(() => {
+            this.pendingRenderFrame = null;
+            void this.renderItems();
+        });
+    }
+    async renderItems() {
+        if (!this.anchor) {
+            return;
+        }
+        const items = this.resolveItems();
+        const keyAttribute = this.getAttribute("key");
+        await this.updateRows(items, keyAttribute);
+    }
+    /**
+     * 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
+     */
+    async updateRows(items, keyAttribute) {
+        const nextKeys = [];
+        const nextRows = [];
+        for (let index = 0; index < items.length; index++) {
+            const item = items[index];
+            const key = keyAttribute
+                ? this.resolveKey(item, index, keyAttribute)
+                : index;
+            nextKeys.push(key);
+            const existing = this.rows.get(key);
+            if (existing) {
+                existing.scope.setContext({
+                    item,
+                    index,
+                    key,
+                    count: items.length,
+                });
+                nextRows.push(existing);
+            }
+            else {
+                if (!this.templateCompiler) {
+                    return;
+                }
+                const row = await this.createRow(item, index, items.length, key);
+                nextRows.push(row);
+            }
+        }
+        for (const [key, row] of this.rows) {
+            if (!nextKeys.includes(key)) {
+                this.removeRow(row);
+            }
+        }
+        this.rows.clear();
+        let insertBefore = this.anchor?.nextSibling ?? null;
+        nextRows.forEach((row) => {
+            row.nodes.forEach((node) => {
+                this.insertBefore(node, insertBefore);
+                insertBefore = node.nextSibling;
+            });
+            this.rows.set(row.key, row);
+        });
+    }
+    async createRow(item, index, count, key) {
+        const scope = new SmartForItemScope();
+        scope.setContext({ item, index, key, count });
+        const domContext = new ItemDomContext(this);
+        const element = await this.templateCompiler.compile(this.templateHtml || "<div></div>", scope, domContext);
+        domContext.setElement(element);
+        const nodes = [element];
+        const dispose = () => {
+            domContext.destroy();
+        };
+        return { key, scope, nodes, dispose };
+    }
+    removeRow(row) {
+        row.nodes.forEach((node) => {
+            if (node.parentNode === this) {
+                this.removeChild(node);
+            }
+        });
+        row.dispose();
+    }
+    disposeAllRows() {
+        for (const row of this.rows.values()) {
+            row.nodes.forEach((node) => {
+                if (node.parentNode) {
+                    node.parentNode.removeChild(node);
+                }
+            });
+            row.dispose();
+        }
+        this.rows.clear();
+    }
+    resolveItems() {
+        const attrValue = this.getAttribute("items");
+        if (!attrValue) {
+            return [];
+        }
+        const value = this.objectRegistry.get(attrValue);
+        if (Array.isArray(value)) {
+            return value;
+        }
+        return [];
+    }
+    resolveKey(item, index, keyAttr) {
+        if (item && typeof item === "object" && keyAttr in item) {
+            const record = item;
+            const candidate = record[keyAttr];
+            if (typeof candidate === "string" || typeof candidate === "number") {
+                return candidate;
+            }
+        }
+        return index;
+    }
+}
+//# sourceMappingURL=smart-for-element.js.map

package/dist/components/smart-for/smart-for-element.js.map

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

package/dist/components/smart-for/smart-for-item-scope.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Implements the responsibility of providing a reactive scope for each smart-for iteration.
+ *
+ * @description
+ * Provides reactive properties ($item, $index, $key, $count, $first, $last, $even, $odd)
+ * for each row. Extends SmartComponent to satisfy ITemplateCompiler's contract —
+ * getPropertyObservable() powers fine-grained reactive text node updates.
+ *
+ * This is NOT a rendered component. It is a pure reactive data context (ViewModel)
+ * used as binding scope by ITemplateCompiler.compile().
+ */
+import { SmartComponent } from "../../core/smart-component.js";
+type KeyType = string | number;
+export declare class SmartForItemScope extends SmartComponent {
+    private itemValue;
+    private indexValue;
+    private keyValue;
+    private countValue;
+    private firstValue;
+    private lastValue;
+    private evenValue;
+    private oddValue;
+    get $item(): unknown;
+    set $item(value: unknown);
+    get $index(): number;
+    set $index(value: number);
+    get $key(): KeyType;
+    set $key(value: KeyType);
+    get $count(): number;
+    set $count(value: number);
+    get $first(): boolean;
+    set $first(value: boolean);
+    get $last(): boolean;
+    set $last(value: boolean);
+    get $even(): boolean;
+    set $even(value: boolean);
+    get $odd(): boolean;
+    set $odd(value: boolean);
+    /**
+     * Updates all context properties for this iteration scope.
+     *
+     * @param params - Object containing item, index, key, and count values
+     */
+    setContext(params: {
+        item: unknown;
+        index: number;
+        key: KeyType;
+        count: number;
+    }): void;
+}
+export {};
+//# sourceMappingURL=smart-for-item-scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smart-for-item-scope.d.ts","sourceRoot":"","sources":["../../../src/components/smart-for/smart-for-item-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,KAAK,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/B,qBAAa,iBAAkB,SAAQ,cAAc;IACnD,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,EAGvB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAGvB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAGtB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAGvB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAGxB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,EAGvB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,EAGvB;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAGtB;IAED;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE;QACjB,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,OAAO,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,IAAI;CAUT"}

package/dist/components/smart-for/smart-for-item-scope.js

@@ -0,0 +1,94 @@
+/**
+ * Implements the responsibility of providing a reactive scope for each smart-for iteration.
+ *
+ * @description
+ * Provides reactive properties ($item, $index, $key, $count, $first, $last, $even, $odd)
+ * for each row. Extends SmartComponent to satisfy ITemplateCompiler's contract —
+ * getPropertyObservable() powers fine-grained reactive text node updates.
+ *
+ * This is NOT a rendered component. It is a pure reactive data context (ViewModel)
+ * used as binding scope by ITemplateCompiler.compile().
+ */
+import { SmartComponent } from "../../core/smart-component.js";
+export class SmartForItemScope extends SmartComponent {
+    itemValue = null;
+    indexValue = 0;
+    keyValue = 0;
+    countValue = 0;
+    firstValue = false;
+    lastValue = false;
+    evenValue = false;
+    oddValue = false;
+    get $item() {
+        return this.itemValue;
+    }
+    set $item(value) {
+        this.itemValue = value;
+        this.getPropertyObservable("$item").notify();
+    }
+    get $index() {
+        return this.indexValue;
+    }
+    set $index(value) {
+        this.indexValue = value;
+        this.getPropertyObservable("$index").notify();
+    }
+    get $key() {
+        return this.keyValue;
+    }
+    set $key(value) {
+        this.keyValue = value;
+        this.getPropertyObservable("$key").notify();
+    }
+    get $count() {
+        return this.countValue;
+    }
+    set $count(value) {
+        this.countValue = value;
+        this.getPropertyObservable("$count").notify();
+    }
+    get $first() {
+        return this.firstValue;
+    }
+    set $first(value) {
+        this.firstValue = value;
+        this.getPropertyObservable("$first").notify();
+    }
+    get $last() {
+        return this.lastValue;
+    }
+    set $last(value) {
+        this.lastValue = value;
+        this.getPropertyObservable("$last").notify();
+    }
+    get $even() {
+        return this.evenValue;
+    }
+    set $even(value) {
+        this.evenValue = value;
+        this.getPropertyObservable("$even").notify();
+    }
+    get $odd() {
+        return this.oddValue;
+    }
+    set $odd(value) {
+        this.oddValue = value;
+        this.getPropertyObservable("$odd").notify();
+    }
+    /**
+     * Updates all context properties for this iteration scope.
+     *
+     * @param params - Object containing item, index, key, and count values
+     */
+    setContext(params) {
+        this.$item = params.item;
+        this.$index = params.index;
+        this.$key = params.key;
+        this.$count = params.count;
+        this.$first = params.index === 0;
+        this.$last = params.index === params.count - 1;
+        this.$even = params.index % 2 === 0;
+        this.$odd = !this.$even;
+    }
+}
+//# sourceMappingURL=smart-for-item-scope.js.map

package/dist/components/smart-for/smart-for-item-scope.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * Implements the responsibility of repeating projected content for each item.
+ */
+import { SmartComponent } from '../../core/smart-component.js';
+/**
+ * Implements the responsibility of hosting repeated templates driven by items input.
+ */
+export declare class SmartFor extends SmartComponent {
+}
+//# sourceMappingURL=smart-for.component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smart-for.component.d.ts","sourceRoot":"","sources":["../../../src/components/smart-for/smart-for.component.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAS/D;;GAEG;AACH,qBAWa,QAAS,SAAQ,cAAc;CAAG"}

package/dist/components/smart-for/smart-for.component.js

@@ -0,0 +1,69 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+/**
+ * Implements the responsibility of repeating projected content for each item.
+ */
+import { SmartComponent } from '../../core/smart-component.js';
+import { SmartRender } from '../../decorators/smart-render.decorator.js';
+import { SmartForLifecycleManager } from './smart-for.lifecycle-manager.js';
+import { Services } from '../../providers/service-provider.js';
+/**
+ * Implements the responsibility of hosting repeated templates driven by items input.
+ */
+let SmartFor = (() => {
+    let _classDecorators = [SmartRender({
+            selector: 'smart-for',
+            template: '<smart-host></smart-host>',
+            lifecycle: () => new SmartForLifecycleManager(Services.get('IHostResolver'), Services.get('ITemplateCompiler'), Services.get('IHostProjectionRegistry'), Services.get('ISmartInputStore')),
+            hostDisplay: 'contents'
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = SmartComponent;
+    var SmartFor = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            SmartFor = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+    };
+    return SmartFor = _classThis;
+})();
+export { SmartFor };
+//# sourceMappingURL=smart-for.component.js.map

package/dist/components/smart-for/smart-for.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-for.component.js","sourceRoot":"","sources":["../../../src/components/smart-for/smart-for.component.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAM/D;;GAEG;IAYU,QAAQ;4BAXpB,WAAW,CAAC;YACX,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,2BAA2B;YACrC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,wBAAwB,CAC3C,QAAQ,CAAC,GAAG,CAAgB,eAAe,CAAC,EAC5C,QAAQ,CAAC,GAAG,CAAoB,mBAAmB,CAAC,EACpD,QAAQ,CAAC,GAAG,CAA0B,yBAAyB,CAAC,EAChE,QAAQ,CAAC,GAAG,CAAmB,kBAAkB,CAAC,CACnD;YACD,WAAW,EAAE,UAAU;SACxB,CAAC;;;;sBAC4B,cAAc;wBAAtB,SAAQ,WAAc;;;;YAA5C,6KAA+C;;;YAAlC,uDAAQ;;;;;SAAR,QAAQ"}

package/dist/components/smart-for/smart-for.lifecycle-manager.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Implements the responsibility of rendering repeated content for items input.
+ */
+import { SmartLifecycleManager } from '../../behaviors/lifecycle-manager.js';
+import type { ISmartInputStore } from '../../rendering/bindings/smart-input-store.interface.js';
+import type { ITemplateCompiler } from '../../rendering/templates/template-compiler.interface.js';
+import type { IHostResolver } from '../../rendering/dom-context/host-resolver.interface.js';
+import type { SmartFor } from './smart-for.component.js';
+import type { IHostProjectionRegistry } from '../../rendering/host-projection/host-projection-registry.interface.js';
+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[];
+/**
+ * Implements the responsibility of managing smart-for lifecycle and rendering keyed lists.
+ *
+ * @description
+ * Receives dependencies via constructor injection (DIP):
+ * - IHostResolver: Resolves the host element for the component
+ * - ITemplateCompiler: Compiles item templates with reactive bindings
+ * - IDomAdapter: Cross-platform DOM manipulation
+ * - IBindingResolver: Resolves template bindings
+ */
+export declare class SmartForLifecycleManager extends SmartLifecycleManager<SmartFor> {
+    private readonly hostResolver;
+    private readonly templateCompiler;
+    private readonly hostProjectionRegistry;
+    private readonly smartInputStore;
+    private anchor;
+    private rows;
+    private templateHtml;
+    private eventListeners;
+    private pendingRenderFrame;
+    private pendingHost;
+    private pendingComponent;
+    /**
+     * Initializes SmartForLifecycleManager with injected dependencies.
+     *
+     * @param hostResolver - Resolver for component host element
+     * @param templateCompiler - Compiler for item templates
+     * @param hostProjectionRegistry - Registry for host projection content
+     * @param smartInputStore - Store for smart input element mappings
+     * @throws Error if any dependency is null or undefined
+     */
+    constructor(hostResolver: IHostResolver, templateCompiler: ITemplateCompiler, hostProjectionRegistry: IHostProjectionRegistry, smartInputStore: ISmartInputStore);
+    protected onComponentReady(component: SmartFor): void;
+    protected onComponentDestroy(): void;
+    /**
+     * Schedules a render pass on the next animation frame.
+     *
+     * @description
+     * Batches multiple smart-input-changed events 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 host - Host element containing the rows
+     * @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.lifecycle-manager.d.ts.map

package/dist/components/smart-for/smart-for.lifecycle-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-for.lifecycle-manager.d.ts","sourceRoot":"","sources":["../../../src/components/smart-for/smart-for.lifecycle-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yDAAyD,CAAC;AAEhG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wDAAwD,CAAC;AAE5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uEAAuE,CAAC;AAErH,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;AAoKD;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,SAAQ,qBAAqB,CAAC,QAAQ,CAAC;IAmBzE,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe;IArBlC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,cAAc,CAAkG;IACxH,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,gBAAgB,CAAyB;IAEjD;;;;;;;;OAQG;gBAEgB,YAAY,EAAE,aAAa,EAC3B,gBAAgB,EAAE,iBAAiB,EACnC,sBAAsB,EAAE,uBAAuB,EAC/C,eAAe,EAAE,gBAAgB;IASpD,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,GAAG,IAAI;IAuBrD,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAcpC;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;YAaR,WAAW;IAWzB;;;;;;;;OAQG;YACW,UAAU;YA2CV,SAAS;IAuBvB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,UAAU;CAWnB"}