@rezi-ui/core 0.1.0-alpha.1

package/dist/runtime/localState.d.ts

@@ -0,0 +1,172 @@
+/**
+ * packages/core/src/runtime/localState.ts — Per-instance local state storage.
+ *
+ * Why: Provides a key-value store for runtime-local state associated with
+ * widget instances. State is keyed by instanceId and persists across renders
+ * for reused instances, but is cleaned up when instances are unmounted.
+ *
+ * Stored state:
+ *   - layout: computed rect from layout pass
+ *   - hover: mouse hover state
+ *   - pressed: mouse press state
+ *   - focusable: whether widget can receive focus
+ *   - tabIndex: position in focus traversal order
+ *
+ * @see docs/guide/runtime-and-layout.md
+ */
+import type { InstanceId } from "./instance.js";
+/** Rectangle in terminal cell coordinates. */
+export type Rect = Readonly<{
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}>;
+/** Local state stored per widget instance. */
+export type RuntimeLocalState = Readonly<{
+    layout: Rect | null;
+    hover: boolean;
+    pressed: boolean;
+    focusable: boolean;
+    tabIndex: number | null;
+}>;
+/** Local state for virtualList instances. */
+export type VirtualListLocalState = Readonly<{
+    scrollTop: number;
+    selectedIndex: number;
+    viewportHeight: number;
+    /** First visible item index (derived from scrollTop). */
+    startIndex: number;
+    /** One past last visible item index (derived from scrollTop + viewportHeight). */
+    endIndex: number;
+}>;
+/** Partial update to local state (undefined fields are not changed). */
+export type RuntimeLocalStatePatch = Readonly<{
+    layout?: Rect | null;
+    hover?: boolean;
+    pressed?: boolean;
+    focusable?: boolean;
+    tabIndex?: number | null;
+}>;
+/** Store interface for per-instance local state. */
+export type RuntimeLocalStateStore = Readonly<{
+    get: (instanceId: InstanceId) => RuntimeLocalState | undefined;
+    set: (instanceId: InstanceId, patch: RuntimeLocalStatePatch) => RuntimeLocalState;
+    delete: (instanceId: InstanceId) => void;
+}>;
+/** Create a new local state store instance. */
+export declare function createRuntimeLocalStateStore(): RuntimeLocalStateStore;
+/** Partial update to virtual list state. */
+export type VirtualListLocalStatePatch = Readonly<{
+    scrollTop?: number;
+    selectedIndex?: number;
+    viewportHeight?: number;
+    startIndex?: number;
+    endIndex?: number;
+}>;
+/** Store interface for per-instance virtual list state. */
+export type VirtualListStateStore = Readonly<{
+    get: (id: string) => VirtualListLocalState;
+    set: (id: string, patch: VirtualListLocalStatePatch) => VirtualListLocalState;
+    delete: (id: string) => void;
+}>;
+/** Create a new virtual list state store instance. */
+export declare function createVirtualListStateStore(): VirtualListStateStore;
+/** Local state for table instances. */
+export type TableLocalState = Readonly<{
+    /** Current scroll position (row offset). */
+    scrollTop: number;
+    /** Index of the focused row (-1 if none). */
+    focusedRowIndex: number;
+    /** Last clicked row key (for shift-select). */
+    lastClickedKey: string | null;
+    /** Viewport height in rows. */
+    viewportHeight: number;
+    /** First visible row index (derived). */
+    startIndex: number;
+    /** One past last visible row index (derived). */
+    endIndex: number;
+}>;
+/** Partial update to table state. */
+export type TableLocalStatePatch = Readonly<{
+    scrollTop?: number;
+    focusedRowIndex?: number;
+    lastClickedKey?: string | null;
+    viewportHeight?: number;
+    startIndex?: number;
+    endIndex?: number;
+}>;
+/** Store interface for per-instance table state. */
+export type TableStateStore = Readonly<{
+    get: (id: string) => TableLocalState;
+    set: (id: string, patch: TableLocalStatePatch) => TableLocalState;
+    delete: (id: string) => void;
+}>;
+/** Create a new table state store instance. */
+export declare function createTableStateStore(): TableStateStore;
+/** Local state for tree instances. */
+export type TreeLocalState = Readonly<{
+    /** Key of the focused node (null if none). */
+    focusedKey: string | null;
+    /** Set of node keys currently loading. */
+    loadingKeys: ReadonlySet<string>;
+    /** Scroll position for virtualized trees. */
+    scrollTop: number;
+    /** Viewport height for virtualization. */
+    viewportHeight: number;
+    /**
+     * Cached flattened nodes for tree-like widgets (tree/filePicker/fileTreeExplorer).
+     * Used to avoid per-frame allocations when inputs are referentially stable.
+     */
+    flatCache: TreeFlatCache | null;
+    /** Cached expanded set (for faster lookup). */
+    expandedSetRef: readonly string[] | undefined;
+    expandedSet: ReadonlySet<string> | undefined;
+    /** Cached tree line prefixes keyed to flatNodes/showLines/indentSize. */
+    prefixCache: TreePrefixCache | null;
+}>;
+export type TreePrefixCache = Readonly<{
+    flatNodesRef: readonly unknown[];
+    showLines: boolean;
+    indentSize: number;
+    prefixes: readonly string[];
+}>;
+export type TreeFlatCache = Readonly<{
+    kind: "fileNode" | "tree";
+    dataRef: unknown;
+    expandedRef: readonly string[];
+    /** Loaded-children map identity (only used for kind="tree"). */
+    loadedRef?: unknown;
+    /** Key function identity (only used for kind="tree"). */
+    getKeyRef: unknown;
+    /** Children function identity (only used for kind="tree"). */
+    getChildrenRef: unknown;
+    /** hasChildren function identity (only used for kind="tree"). */
+    hasChildrenRef: unknown;
+    /** Flattened nodes (typed by kind at call sites). */
+    flatNodes: readonly unknown[];
+}>;
+/** Partial update to tree state. */
+export type TreeLocalStatePatch = Readonly<{
+    focusedKey?: string | null;
+    loadingKeys?: ReadonlySet<string>;
+    scrollTop?: number;
+    viewportHeight?: number;
+    flatCache?: TreeFlatCache | null;
+    expandedSetRef?: readonly string[];
+    expandedSet?: ReadonlySet<string>;
+    prefixCache?: TreePrefixCache | null;
+}>;
+/** Store interface for per-instance tree state. */
+export type TreeStateStore = Readonly<{
+    get: (id: string) => TreeLocalState;
+    set: (id: string, patch: TreeLocalStatePatch) => TreeLocalState;
+    delete: (id: string) => void;
+    /** Add a key to the loading set. */
+    startLoading: (id: string, nodeKey: string) => TreeLocalState;
+    /** Remove a key from the loading set. */
+    finishLoading: (id: string, nodeKey: string) => TreeLocalState;
+}>;
+/** Create a new tree state store instance. */
+export declare function createTreeStateStore(): TreeStateStore;
+//# sourceMappingURL=localState.d.ts.map

package/dist/runtime/localState.d.ts.map

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

package/dist/runtime/localState.js

@@ -0,0 +1,182 @@
+/**
+ * packages/core/src/runtime/localState.ts — Per-instance local state storage.
+ *
+ * Why: Provides a key-value store for runtime-local state associated with
+ * widget instances. State is keyed by instanceId and persists across renders
+ * for reused instances, but is cleaned up when instances are unmounted.
+ *
+ * Stored state:
+ *   - layout: computed rect from layout pass
+ *   - hover: mouse hover state
+ *   - pressed: mouse press state
+ *   - focusable: whether widget can receive focus
+ *   - tabIndex: position in focus traversal order
+ *
+ * @see docs/guide/runtime-and-layout.md
+ */
+const DEFAULT_STATE = Object.freeze({
+    layout: null,
+    hover: false,
+    pressed: false,
+    focusable: false,
+    tabIndex: null,
+});
+function freezeRect(r) {
+    return Object.freeze({ x: r.x, y: r.y, w: r.w, h: r.h });
+}
+function freezeState(s) {
+    const layout = s.layout ? freezeRect(s.layout) : null;
+    return Object.freeze({
+        layout,
+        hover: s.hover,
+        pressed: s.pressed,
+        focusable: s.focusable,
+        tabIndex: s.tabIndex,
+    });
+}
+/** Create a new local state store instance. */
+export function createRuntimeLocalStateStore() {
+    const table = new Map();
+    return Object.freeze({
+        get: (instanceId) => table.get(instanceId),
+        set: (instanceId, patch) => {
+            const prev = table.get(instanceId) ?? DEFAULT_STATE;
+            const next = {
+                layout: patch.layout !== undefined ? patch.layout : prev.layout,
+                hover: patch.hover !== undefined ? patch.hover : prev.hover,
+                pressed: patch.pressed !== undefined ? patch.pressed : prev.pressed,
+                focusable: patch.focusable !== undefined ? patch.focusable : prev.focusable,
+                tabIndex: patch.tabIndex !== undefined ? patch.tabIndex : prev.tabIndex,
+            };
+            const frozen = freezeState(next);
+            table.set(instanceId, frozen);
+            return frozen;
+        },
+        delete: (instanceId) => {
+            table.delete(instanceId);
+        },
+    });
+}
+/* ========== Virtual List State Store ========== */
+const DEFAULT_VLIST_STATE = Object.freeze({
+    scrollTop: 0,
+    selectedIndex: 0,
+    viewportHeight: 0,
+    startIndex: 0,
+    endIndex: 0,
+});
+/** Create a new virtual list state store instance. */
+export function createVirtualListStateStore() {
+    const table = new Map();
+    return Object.freeze({
+        get: (id) => table.get(id) ?? DEFAULT_VLIST_STATE,
+        set: (id, patch) => {
+            const prev = table.get(id) ?? DEFAULT_VLIST_STATE;
+            const next = Object.freeze({
+                scrollTop: patch.scrollTop !== undefined ? patch.scrollTop : prev.scrollTop,
+                selectedIndex: patch.selectedIndex !== undefined ? patch.selectedIndex : prev.selectedIndex,
+                viewportHeight: patch.viewportHeight !== undefined ? patch.viewportHeight : prev.viewportHeight,
+                startIndex: patch.startIndex !== undefined ? patch.startIndex : prev.startIndex,
+                endIndex: patch.endIndex !== undefined ? patch.endIndex : prev.endIndex,
+            });
+            table.set(id, next);
+            return next;
+        },
+        delete: (id) => {
+            table.delete(id);
+        },
+    });
+}
+const DEFAULT_TABLE_STATE = Object.freeze({
+    scrollTop: 0,
+    focusedRowIndex: 0,
+    lastClickedKey: null,
+    viewportHeight: 0,
+    startIndex: 0,
+    endIndex: 0,
+});
+/** Create a new table state store instance. */
+export function createTableStateStore() {
+    const table = new Map();
+    return Object.freeze({
+        get: (id) => table.get(id) ?? DEFAULT_TABLE_STATE,
+        set: (id, patch) => {
+            const prev = table.get(id) ?? DEFAULT_TABLE_STATE;
+            const next = Object.freeze({
+                scrollTop: patch.scrollTop !== undefined ? patch.scrollTop : prev.scrollTop,
+                focusedRowIndex: patch.focusedRowIndex !== undefined ? patch.focusedRowIndex : prev.focusedRowIndex,
+                lastClickedKey: patch.lastClickedKey !== undefined ? patch.lastClickedKey : prev.lastClickedKey,
+                viewportHeight: patch.viewportHeight !== undefined ? patch.viewportHeight : prev.viewportHeight,
+                startIndex: patch.startIndex !== undefined ? patch.startIndex : prev.startIndex,
+                endIndex: patch.endIndex !== undefined ? patch.endIndex : prev.endIndex,
+            });
+            table.set(id, next);
+            return next;
+        },
+        delete: (id) => {
+            table.delete(id);
+        },
+    });
+}
+const DEFAULT_TREE_STATE = Object.freeze({
+    focusedKey: null,
+    loadingKeys: Object.freeze(new Set()),
+    scrollTop: 0,
+    viewportHeight: 0,
+    flatCache: null,
+    expandedSetRef: undefined,
+    expandedSet: undefined,
+    prefixCache: null,
+});
+/** Create a new tree state store instance. */
+export function createTreeStateStore() {
+    const table = new Map();
+    const store = Object.freeze({
+        get: (id) => table.get(id) ?? DEFAULT_TREE_STATE,
+        set: (id, patch) => {
+            const prev = table.get(id) ?? DEFAULT_TREE_STATE;
+            const next = Object.freeze({
+                focusedKey: patch.focusedKey !== undefined ? patch.focusedKey : prev.focusedKey,
+                loadingKeys: patch.loadingKeys !== undefined ? patch.loadingKeys : prev.loadingKeys,
+                scrollTop: patch.scrollTop !== undefined ? patch.scrollTop : prev.scrollTop,
+                viewportHeight: patch.viewportHeight !== undefined ? patch.viewportHeight : prev.viewportHeight,
+                flatCache: patch.flatCache !== undefined ? patch.flatCache : prev.flatCache,
+                expandedSetRef: patch.expandedSetRef !== undefined ? patch.expandedSetRef : prev.expandedSetRef,
+                expandedSet: patch.expandedSet !== undefined ? patch.expandedSet : prev.expandedSet,
+                prefixCache: patch.prefixCache !== undefined ? patch.prefixCache : prev.prefixCache,
+            });
+            table.set(id, next);
+            return next;
+        },
+        delete: (id) => {
+            table.delete(id);
+        },
+        startLoading: (id, nodeKey) => {
+            const prev = table.get(id) ?? DEFAULT_TREE_STATE;
+            const newLoading = new Set(prev.loadingKeys);
+            newLoading.add(nodeKey);
+            const next = Object.freeze({
+                ...prev,
+                loadingKeys: Object.freeze(newLoading),
+            });
+            table.set(id, next);
+            return next;
+        },
+        finishLoading: (id, nodeKey) => {
+            const prev = table.get(id) ?? DEFAULT_TREE_STATE;
+            if (!prev.loadingKeys.has(nodeKey)) {
+                return prev;
+            }
+            const newLoading = new Set(prev.loadingKeys);
+            newLoading.delete(nodeKey);
+            const next = Object.freeze({
+                ...prev,
+                loadingKeys: Object.freeze(newLoading),
+            });
+            table.set(id, next);
+            return next;
+        },
+    });
+    return store;
+}
+//# sourceMappingURL=localState.js.map

package/dist/runtime/localState.js.map

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

package/dist/runtime/reconcile.d.ts

@@ -0,0 +1,64 @@
+/**
+ * packages/core/src/runtime/reconcile.ts — VNode tree reconciliation.
+ *
+ * Why: Matches new VNode children against previous children to determine which
+ * instances can be reused, which are new, and which should be unmounted. Uses
+ * key-based matching when keys are provided, index-based otherwise.
+ *
+ * Reconciliation rules:
+ *   - Keyed children match by key (deterministic across reordering)
+ *   - Unkeyed children match by index (position-based)
+ *   - Duplicate keys within siblings are fatal errors
+ *   - Reused instances keep their instanceId; new instances get fresh IDs
+ *
+ * @see docs/guide/runtime-and-layout.md
+ */
+import type { VNode } from "../index.js";
+import type { InstanceId, InstanceIdAllocator } from "./instance.js";
+/** Slot identifier: keyed ("k:mykey") or indexed ("i:0"). */
+export type SlotId = `k:${string}` | `i:${number}`;
+/** Fatal error from reconciliation (duplicate keys). */
+export type ReconcileFatal = Readonly<{
+    code: "ZRUI_DUPLICATE_KEY";
+    detail: string;
+}>;
+/** Result of matching a single child in reconciliation. */
+export type ReconciledChild = Readonly<{
+    slotId: SlotId;
+    vnode: VNode;
+    instanceId: InstanceId;
+    kind: "reused" | "new";
+    prevIndex: number | null;
+}>;
+/** Successful reconciliation result with instance lifecycle information. */
+export type ReconcileChildrenOk = Readonly<{
+    nextChildren: readonly ReconciledChild[];
+    reusedInstanceIds: readonly InstanceId[];
+    newInstanceIds: readonly InstanceId[];
+    unmountedInstanceIds: readonly InstanceId[];
+}>;
+export type ReconcileChildrenResult = Readonly<{
+    ok: true;
+    value: ReconcileChildrenOk;
+}> | Readonly<{
+    ok: false;
+    fatal: ReconcileFatal;
+}>;
+type PrevChild = Readonly<{
+    instanceId: InstanceId;
+    vnode: VNode;
+}>;
+/** Compute the slot ID for a child: keyed if key present, indexed otherwise. */
+export declare function slotIdForChild(child: VNode, childIndex: number): SlotId;
+/**
+ * Reconcile previous children against new VNode children.
+ *
+ * @param parentInstanceId - ID of parent instance (for error messages)
+ * @param prevChildren - Previous children with instance IDs
+ * @param nextVChildren - New VNode children to reconcile
+ * @param allocator - Instance ID allocator for new children
+ * @returns Reconciliation result or fatal error for duplicate keys
+ */
+export declare function reconcileChildren(parentInstanceId: InstanceId, prevChildren: readonly PrevChild[], nextVChildren: readonly VNode[], allocator: InstanceIdAllocator): ReconcileChildrenResult;
+export {};
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/runtime/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/runtime/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAErE,6DAA6D;AAC7D,MAAM,MAAM,MAAM,GAAG,KAAK,MAAM,EAAE,GAAG,KAAK,MAAM,EAAE,CAAC;AAEnD,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IACzC,iBAAiB,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,cAAc,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,oBAAoB,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAC/B,QAAQ,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC,GAClD,QAAQ,CAAC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC,CAAC;AAEnD,KAAK,SAAS,GAAG,QAAQ,CAAC;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AA4CpE,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIvE;AAkFD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,UAAU,EAC5B,YAAY,EAAE,SAAS,SAAS,EAAE,EAClC,aAAa,EAAE,SAAS,KAAK,EAAE,EAC/B,SAAS,EAAE,mBAAmB,GAC7B,uBAAuB,CAwFzB"}

package/dist/runtime/reconcile.js

@@ -0,0 +1,223 @@
+/**
+ * packages/core/src/runtime/reconcile.ts — VNode tree reconciliation.
+ *
+ * Why: Matches new VNode children against previous children to determine which
+ * instances can be reused, which are new, and which should be unmounted. Uses
+ * key-based matching when keys are provided, index-based otherwise.
+ *
+ * Reconciliation rules:
+ *   - Keyed children match by key (deterministic across reordering)
+ *   - Unkeyed children match by index (position-based)
+ *   - Duplicate keys within siblings are fatal errors
+ *   - Reused instances keep their instanceId; new instances get fresh IDs
+ *
+ * @see docs/guide/runtime-and-layout.md
+ */
+function getVNodeKey(v) {
+    switch (v.kind) {
+        case "text":
+            return v.props.key;
+        case "box":
+        case "row":
+        case "column":
+            return v.props.key;
+        case "spacer":
+            return v.props.key;
+        case "button":
+            return v.props.key;
+        case "input":
+            return v.props.key;
+        case "focusZone":
+        case "focusTrap":
+            return v.props.key;
+        case "virtualList":
+            return v.props.key;
+        case "layers":
+            return v.props.key;
+        case "modal":
+            return v.props.key;
+        case "dropdown":
+            return v.props.key;
+        case "layer":
+            return v.props.key;
+        case "table":
+            return v.props.key;
+        case "tree":
+            return v.props.key;
+        case "field":
+            return v.props.key;
+        case "select":
+            return v.props.key;
+        case "checkbox":
+            return v.props.key;
+        case "radioGroup":
+            return v.props.key;
+    }
+}
+/** Compute the slot ID for a child: keyed if key present, indexed otherwise. */
+export function slotIdForChild(child, childIndex) {
+    const key = getVNodeKey(child);
+    if (key !== undefined)
+        return `k:${key}`;
+    return `i:${childIndex}`;
+}
+function duplicateKeyDetail(parentInstanceId, key, aIndex, bIndex) {
+    // Deterministic, stable detail string (no object dumps, no JSON ordering concerns).
+    return `duplicate sibling key "${key}" under parent instanceId=${String(parentInstanceId)} (child indices ${String(aIndex)} and ${String(bIndex)})`;
+}
+function containsAnyKeyInPrevChildren(prevChildren) {
+    for (let i = 0; i < prevChildren.length; i++) {
+        const prev = prevChildren[i];
+        if (!prev)
+            continue;
+        if (getVNodeKey(prev.vnode) !== undefined)
+            return true;
+    }
+    return false;
+}
+function containsAnyKeyInNextChildren(nextVChildren) {
+    for (let i = 0; i < nextVChildren.length; i++) {
+        const vnode = nextVChildren[i];
+        if (!vnode)
+            continue;
+        if (getVNodeKey(vnode) !== undefined)
+            return true;
+    }
+    return false;
+}
+function reconcileUnkeyedChildren(prevChildren, nextVChildren, allocator) {
+    const nextChildren = [];
+    const reusedInstanceIds = [];
+    const newInstanceIds = [];
+    const unmountedInstanceIds = [];
+    const sharedLength = Math.min(prevChildren.length, nextVChildren.length);
+    for (let i = 0; i < sharedLength; i++) {
+        const prev = prevChildren[i];
+        const vnode = nextVChildren[i];
+        if (!vnode)
+            continue;
+        const slotId = `i:${i}`;
+        if (prev) {
+            const instanceId = prev.instanceId;
+            reusedInstanceIds.push(instanceId);
+            nextChildren.push({ slotId, vnode, instanceId, kind: "reused", prevIndex: i });
+            continue;
+        }
+        const instanceId = allocator.allocate();
+        newInstanceIds.push(instanceId);
+        nextChildren.push({ slotId, vnode, instanceId, kind: "new", prevIndex: null });
+    }
+    for (let i = sharedLength; i < nextVChildren.length; i++) {
+        const vnode = nextVChildren[i];
+        if (!vnode)
+            continue;
+        const slotId = `i:${i}`;
+        const instanceId = allocator.allocate();
+        newInstanceIds.push(instanceId);
+        nextChildren.push({ slotId, vnode, instanceId, kind: "new", prevIndex: null });
+    }
+    for (let i = sharedLength; i < prevChildren.length; i++) {
+        const prev = prevChildren[i];
+        if (!prev)
+            continue;
+        unmountedInstanceIds.push(prev.instanceId);
+    }
+    return {
+        nextChildren,
+        reusedInstanceIds,
+        newInstanceIds,
+        unmountedInstanceIds,
+    };
+}
+/**
+ * Reconcile previous children against new VNode children.
+ *
+ * @param parentInstanceId - ID of parent instance (for error messages)
+ * @param prevChildren - Previous children with instance IDs
+ * @param nextVChildren - New VNode children to reconcile
+ * @param allocator - Instance ID allocator for new children
+ * @returns Reconciliation result or fatal error for duplicate keys
+ */
+export function reconcileChildren(parentInstanceId, prevChildren, nextVChildren, allocator) {
+    const prevContainsKeys = containsAnyKeyInPrevChildren(prevChildren);
+    const nextContainsKeys = containsAnyKeyInNextChildren(nextVChildren);
+    if (!prevContainsKeys && !nextContainsKeys) {
+        return {
+            ok: true,
+            value: reconcileUnkeyedChildren(prevChildren, nextVChildren, allocator),
+        };
+    }
+    const prevBySlotId = new Map();
+    for (let i = 0; i < prevChildren.length; i++) {
+        const prev = prevChildren[i];
+        if (!prev)
+            continue;
+        const slotId = slotIdForChild(prev.vnode, i);
+        if (slotId.startsWith("k:")) {
+            const existing = prevBySlotId.get(slotId);
+            if (existing !== undefined) {
+                return {
+                    ok: false,
+                    fatal: {
+                        code: "ZRUI_DUPLICATE_KEY",
+                        detail: duplicateKeyDetail(parentInstanceId, slotId.slice(2), existing, i),
+                    },
+                };
+            }
+        }
+        prevBySlotId.set(slotId, i);
+    }
+    const seenNextKeySlot = new Map();
+    const usedPrev = new Array(prevChildren.length).fill(false);
+    const nextChildren = [];
+    const reusedInstanceIds = [];
+    const newInstanceIds = [];
+    for (let nextIndex = 0; nextIndex < nextVChildren.length; nextIndex++) {
+        const vnode = nextVChildren[nextIndex];
+        if (!vnode)
+            continue;
+        const slotId = slotIdForChild(vnode, nextIndex);
+        if (slotId.startsWith("k:")) {
+            const key = slotId.slice(2);
+            const existing = seenNextKeySlot.get(key);
+            if (existing !== undefined) {
+                return {
+                    ok: false,
+                    fatal: {
+                        code: "ZRUI_DUPLICATE_KEY",
+                        detail: duplicateKeyDetail(parentInstanceId, key, existing, nextIndex),
+                    },
+                };
+            }
+            seenNextKeySlot.set(key, nextIndex);
+        }
+        const prevIndex = prevBySlotId.get(slotId);
+        const prevChild = prevIndex !== undefined ? prevChildren[prevIndex] : undefined;
+        if (prevIndex !== undefined && prevChild !== undefined && usedPrev[prevIndex] === false) {
+            usedPrev[prevIndex] = true;
+            const instanceId = prevChild.instanceId;
+            reusedInstanceIds.push(instanceId);
+            nextChildren.push({ slotId, vnode, instanceId, kind: "reused", prevIndex });
+            continue;
+        }
+        const instanceId = allocator.allocate();
+        newInstanceIds.push(instanceId);
+        nextChildren.push({ slotId, vnode, instanceId, kind: "new", prevIndex: null });
+    }
+    const unmountedInstanceIds = [];
+    for (let i = 0; i < prevChildren.length; i++) {
+        const prev = prevChildren[i];
+        if (!usedPrev[i] && prev)
+            unmountedInstanceIds.push(prev.instanceId);
+    }
+    return {
+        ok: true,
+        value: {
+            nextChildren,
+            reusedInstanceIds,
+            newInstanceIds,
+            unmountedInstanceIds,
+        },
+    };
+}
+//# sourceMappingURL=reconcile.js.map