@but212/atom-effect-jquery 0.32.0 → 0.32.1

package/dist/bindings/form.d.ts

@@ -10,7 +10,11 @@ import { FormOptions } from '../types';
  *   browser-native APIs.
  *
  * @param form - The target form element to bind.
- * @param atom - A writable atom containing the state model.
+ * @param atom - A writable atom or an array of atoms.
+ *               Logic: Polymorphic Input
+ *               If an array is provided, it is merged via `mergeLenses`.
+ *               Note: When merging, later atoms in the array override
+ *               properties with the same path from earlier atoms.
  * @param options - Configuration for transformations and reactive validation.
  *
  * @example
@@ -25,5 +29,5 @@ import { FormOptions } from '../types';
  * });
  * ```
  */
-export declare function bindForm<T extends object>(form: HTMLFormElement, atom: WritableAtom<T>, options?: FormOptions<unknown>): void;
+export declare function bindForm<T extends object>(form: HTMLFormElement, atom: WritableAtom<T> | WritableAtom<unknown>[], options?: FormOptions<unknown>): void;
 //# sourceMappingURL=form.d.ts.map

package/dist/bindings/form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/bindings/form.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA0S3C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,OAAO,GAAE,WAAW,CAAC,OAAO,CAAM,GACjC,IAAI,CAGN"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/bindings/form.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAmZ3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,EAAE,EAC/C,OAAO,GAAE,WAAW,CAAC,OAAO,CAAM,GACjC,IAAI,CAIN"}

package/dist/bindings/list/context.d.ts

@@ -1,61 +1,82 @@
 import { EffectObject, ListKey } from '../../types';
 /**
- * Manages the reconciliation state and lifecycle for the `$.fn.atomList` binding.
+ * Represents the state of a single list item at a point in time.
+ * Used by the reconciler to calculate moves, updates, and removals.
+ */
+export interface ListSnapshot<T> {
+    key: ListKey;
+    item: T;
+    /** The actual DOM element or JQuery wrapper currently representing this item. */
+    node?: Element | JQuery | undefined;
+}
+/**
+ * Persistent state for the `$.fn.atomList` binding.
  *
- * This context tracks historical DOM nodes and keys to enable efficient diffing.
- * Its primary responsibility is coordinating asynchronous item removals (e.g., animations)
- * while ensuring that elements reused in the same cycle are not accidentally destroyed.
+ * WHY:
+ * Reactive lists require a stable reference to track historical DOM nodes across
+ * multiple rendering cycles. Using a POJO (Plain Old JavaScript Object) ensures
+ * state is decoupled from logic, following a functional "Relation Function" pattern.
  *
  * @internal
  */
-export declare class ListContext<T> {
+export interface ListContext<T> {
+    /** Sequential snapshot of the previous render state. */
+    snapshots: ListSnapshot<T>[];
+    /** Keys currently undergoing asynchronous exit animations. */
+    readonly removingKeys: Set<ListKey>;
+    /** Cached reference to the placeholder element shown when the list is empty. */
+    $emptyEl: JQuery | null;
+    /** Inverse lookup for O(1) index retrieval from a key. */
+    keyToIndex: Map<ListKey, number>;
+    /** The reactive effect controlling this list. Needed to check disposal state during async tasks. */
+    fx?: EffectObject;
+    /** Target container element. */
     readonly $container: JQuery;
+    /** Selector for the container. */
     readonly containerSelector: string;
+    /** Optional removal lifecycle hook. */
     readonly onRemove: (($el: JQuery) => Promise<void> | void) | undefined;
-    private _oldKeys;
-    private _oldItems;
-    private _oldNodes;
-    private readonly _removingKeys;
-    private _emptyEl;
-    private readonly _keyToIndex;
-    fx?: EffectObject;
-    constructor($container: JQuery, containerSelector: string, onRemove: (($el: JQuery) => Promise<void> | void) | undefined);
-    get oldKeys(): ListKey[];
-    set oldKeys(v: ListKey[]);
-    get oldItems(): T[];
-    set oldItems(v: T[]);
-    get oldNodes(): (Element | JQuery<HTMLElement> | undefined)[];
-    set oldNodes(v: (Element | JQuery<HTMLElement> | undefined)[]);
-    get removingKeys(): Set<ListKey>;
-    get keyToIndex(): Map<ListKey, number>;
-    get $emptyEl(): JQuery<HTMLElement> | null;
-    set $emptyEl(v: JQuery<HTMLElement> | null);
-    /**
-     * Retrieves the index of a key, supporting string-to-number normalization.
-     *
-     * Reason: DOM attributes (like `data-atom-key`) are always returned as strings,
-     * but the internal `_keyToIndex` map might use numbers.
-     */
-    getIndex(key: ListKey | string): number | undefined;
-    /**
-     * Orchestrates the physical removal of an element from the DOM.
-     *
-     * Logic:
-     * 1. If `onRemove` returns a Promise, it waits for completion (e.g., a fade-out animation).
-     * 2. Constraint: Before calling `.remove()`, it checks if the element has been "resurrected"
-     *    (assigned a new `data-atom-key`) by a subsequent render cycle.
-     */
-    scheduleRemoval(k: ListKey, $el: JQuery): void;
-    /**
-     * Marks a key as "removing" and initiates the removal sequence.
-     *
-     * Note: The `data-atom-key` attribute is cleared immediately to prevent the reconciler
-     * from finding this "ghost" element via DOM lookups while animations are still running.
-     */
-    removeItem(k: ListKey, $el: JQuery): void;
-    /**
-     * Performs full cleanup of the list state and event listeners.
-     */
-    dispose(): void;
 }
+/**
+ * Factory to initialize a new ListContext.
+ */
+export declare function createListContext<T>($container: JQuery, containerSelector: string, onRemove: (($el: JQuery) => Promise<void> | void) | undefined): ListContext<T>;
+/**
+ * Retrieves the index of a key, handling string-to-number normalization.
+ *
+ * WHY: DOM `data-atom-key` attributes are always strings. If the original
+ * atom keys were numbers, a direct Map lookup will fail.
+ *
+ * @internal
+ */
+export declare function getListIndex<T>(ctx: ListContext<T>, key: ListKey | string): number | undefined;
+/**
+ * Marks a key as "in transit" and starts the removal lifecycle.
+ * @internal
+ */
+export declare function removeListItem<T>(ctx: ListContext<T>, k: ListKey, $el: JQuery): void;
+/**
+ * Initiates the physical removal of an element.
+ *
+ * PERFORMANCE: Allocation-free path for synchronous removals.
+ * Closures are only created if `onRemove` returns a Promise.
+ * @internal
+ */
+export declare function scheduleListItemRemoval<T>(ctx: ListContext<T>, k: ListKey, $el: JQuery): void;
+/**
+ * Finalizes DOM removal and state cleanup.
+ *
+ * GUARD: If an element is "resurrected" (reused for a new key) during the
+ * asynchronous removal delay, this method aborts to prevent accidental destruction.
+ * @internal
+ */
+export declare function commitListItemRemoval<T>(ctx: ListContext<T>, k: ListKey, $el: JQuery): void;
+/**
+ * Full cleanup of state and DOM references.
+ *
+ * GC: Reuses the `snapshots` array instance (length = 0) to reduce
+ * memory fragmentation on high-frequency list swaps.
+ * @internal
+ */
+export declare function disposeListContext<T>(ctx: ListContext<T>): void;
 //# sourceMappingURL=context.d.ts.map

package/dist/bindings/list/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGrD;;;;;;;;GAQG;AACH,qBAAa,WAAW,CAAC,CAAC;aAWN,UAAU,EAAE,MAAM;aAClB,iBAAiB,EAAE,MAAM;aACzB,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS;IAZ/E,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAEnD,EAAE,CAAC,EAAE,YAAY,CAAC;gBAGP,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS;IAG/E,IAAI,OAAO,cAEV;IACD,IAAI,OAAO,CAAC,CAAC,WAAA,EAEZ;IACD,IAAI,QAAQ,QAEX;IACD,IAAI,QAAQ,CAAC,CAAC,KAAA,EAEb;IACD,IAAI,QAAQ,kDAEX;IACD,IAAI,QAAQ,CAAC,CAAC,+CAAA,EAEb;IACD,IAAI,YAAY,iBAEf;IACD,IAAI,UAAU,yBAEb;IACD,IAAI,QAAQ,+BAEX;IACD,IAAI,QAAQ,CAAC,CAAC,4BAAA,EAEb;IAED;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAWnD;;;;;;;OAOG;IACH,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAiB9C;;;;;OAKG;IACH,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMzC;;OAEG;IACH,OAAO,IAAI,IAAI;CAShB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGrD;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;IACR,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,wDAAwD;IACxD,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,gFAAgF;IAChF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,0DAA0D;IAC1D,UAAU,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjC,oGAAoG;IACpG,EAAE,CAAC,EAAE,YAAY,CAAC;IAClB,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CACxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,SAAS,GAC5D,WAAW,CAAC,CAAC,CAAC,CAUhB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAW9F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAIpF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAS7F;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAY3F;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAM/D"}

package/dist/bindings/list/diff.d.ts

@@ -2,29 +2,21 @@ import { ListKeyFn, ListOptions } from '../../types';
 import { ListContext } from './context';
 import { PreparedDiff } from './types';
 /**
- * Generates a reconciliation plan by calculating the difference between the
- * current list state and the new item set.
- *
- * Logic: This function implements a double-ended diffing algorithm to identify
- * reusable DOM nodes, new entries, and required replacements. It optimizes
- * performance by isolating the "dirty" range — skipping unchanged items at
- * both the head and tail of the list.
+ * Generates a reconciliation plan between the previous and next state of a list.
  *
  * When to use:
  * - Internal orchestration of DOM mutations for the `atomList` binding.
  *
- * @param ctx - The current list context containing historical DOM state.
- * @param items - The new set of items to render.
- * @param itemCount - The total number of new items.
- * @param getKey - A function to derive a unique key for each item.
- * @param update - An optional callback used to patch existing DOM nodes.
- * @param isEqual - An optional equality comparator for items.
- * @returns A detailed diff plan used to execute DOM updates.
+ * Performance:
+ * - O(N) time complexity.
+ * - Best case: O(1) for pure appends/prepends via head/tail fast-forwarding.
+ *
+ * @param ctx - Persistent state containing historical DOM and keys.
+ * @param items - The new data array from the source atom.
  *
  * @example
- * ```typescript
- * const diff = buildIndices(context, nextItems, nextItems.length, getKey, onUpdate, onEqual);
- * ```
+ * const diff = buildIndices(ctx, nextItems, nextItems.length, getKey, update, isEqual);
+ * // diff.slots now contains the mapping instructions for each index.
  *
  * @internal
  */

package/dist/bindings/list/diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/diff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAChC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GACjC,YAAY,CAAC,CAAC,CAAC,CA6HjB"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/diff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAChC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GACjC,YAAY,CAAC,CAAC,CAAC,CAyHjB"}

package/dist/bindings/list/dom.d.ts

@@ -2,62 +2,49 @@ import { ListOptions } from '../../types';
 import { ListContext } from './context';
 import { PlaceCallbacks, PreparedDiff } from './types';
 /**
- * A low-level DOM utility for inserting elements before a specific reference node.
+ * Inserts elements before a reference node with zero-allocation for jQuery collections.
  *
- * This helper supports both raw `Element` instances and jQuery collections,
- * ensuring consistent insertion behavior regardless of the input type.
- *
- * @param elOrJq - The element or jQuery collection to insert.
- * @param nextNode - The reference node to insert before. If null, appends to the container.
- * @param container - The parent container element.
- * @internal
+ * Why:
+ * - Directly iterates over JQuery objects to avoid `.get()` or `Array.from()` array allocations.
+ * - Handles polymorphic inputs (Element | JQuery) to keep the caller's logic simple.
  */
 export declare function insertOrAppend(elOrJq: Element | JQuery | undefined, nextNode: Node | null, container: Element): void;
 /**
- * Orchestrates the cleanup of a list container and the rendering of empty placeholders.
- *
- * Logic: If an `onRemove` callback is provided, the function performs asynchronous
- * removals for each item to allow for exit animations. Otherwise, it executes a
- * destructive `empty()` on the container for efficiency.
+ * Resets the container or renders an empty placeholder.
  *
- * When to use:
- * - To reset a list container during reconciliation or when the data source becomes empty.
- *
- * @param ctx - The list context containing historical state.
- * @param itemCount - The number of items in the new data set.
- * @param $container - The jQuery-wrapped container.
- * @param empty - The template or element to display when the list is empty.
- * @internal
+ * Why:
+ * - Decouples destructive cleanup (`.empty()`) from animated cleanup (`removeItem`).
+ * - Ensures the historical context is cleared only after the DOM reflects the empty state.
  */
 export declare function handleEmpty<T>(ctx: ListContext<T>, itemCount: number, $container: JQuery, empty: ListOptions<T>['empty']): void;
 /**
- * Transforms items into DOM handles based on the reconciliation plan.
- *
- * Optimization: If all items utilize string templates and the list is undergoing
- * an initial render (cold start), the function returns sanitized HTML fragments
- * for direct `innerHTML` injection, bypassing the overhead of individual jQuery
- * object construction.
+ * Transforms items into DOM nodes or sanitized HTML strings.
  *
- * When to use:
- * - Internal processing of new items within the `atomList` lifecycle.
+ * Performance:
+ * - Provides a "Cold Start" optimization: returns raw HTML strings for initial render
+ *   to allow direct `innerHTML` injection, bypassing jQuery construction overhead.
  *
- * @param diff - The prepared diff plan.
- * @param options - Configuration options for the list.
- * @param isInitial - Indicates whether this is the first render of the list.
- * @returns An array of sanitized HTML strings if the fast-path is applicable; otherwise null.
- * @internal
+ * Why:
+ * - String parsing is batched (`batchSanitize`) to reduce sanitization engine overhead.
  */
 export declare function renderItems<T>(diff: PreparedDiff<T>, options: ListOptions<T>, isInitial: boolean): string[] | null;
 /**
- * Identifies and removes items that are no longer present in the reactive data set.
+ * Triggers removal lifecycle for items missing in the new data set.
+ *
+ * When to use:
+ * - Called during the diffing phase before new items are placed.
+ */
+export declare function cleanupRemoved<T>(ctx: ListContext<T>): void;
+/**
+ * Positions items in the DOM and executes lifecycle callbacks.
  *
- * Logic: Iterates through the historical key set and triggers the removal
- * lifecycle for any key that is not found in the new state.
+ * Logic:
+ * 1. Initial Render: Replaces entire innerHTML or appends via DocumentFragment.
+ * 2. Reconciliation: Moves existing nodes or inserts new ones based on the diff plan.
  *
- * @param ctx - The list context containing historical state.
- * @param diff - The prepared diff plan.
- * @internal
+ * Performance:
+ * - Uses a reverse loop for reconciliation to maintain DOM order with minimal moves.
+ * - Uses `switch` instead of a handler Map to avoid object allocation in the hot loop.
  */
-export declare function cleanupRemoved<T>(ctx: ListContext<T>, diff: PreparedDiff<T>): void;
 export declare function placeItems<T>(ctx: ListContext<T>, diff: PreparedDiff<T>, container: Element, callbacks: PlaceCallbacks<T>, htmlFragments: string[] | null): void;
 //# sourceMappingURL=dom.d.ts.map

package/dist/bindings/list/dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/dom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5E;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,EACpC,QAAQ,EAAE,IAAI,GAAG,IAAI,EACrB,SAAS,EAAE,OAAO,GACjB,IAAI,CAUN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAC7B,IAAI,CA8BN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,SAAS,EAAE,OAAO,GACjB,MAAM,EAAE,GAAG,IAAI,CA+CjB;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CASlF;AA0BD,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAC5B,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,GAC7B,IAAI,CA8EN"}
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/dom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5E;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,EACpC,QAAQ,EAAE,IAAI,GAAG,IAAI,EACrB,SAAS,EAAE,OAAO,GACjB,IAAI,CAYN;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAC7B,IAAI,CA8BN;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,SAAS,EAAE,OAAO,GACjB,MAAM,EAAE,GAAG,IAAI,CAuEjB;AAcD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAQ3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAC5B,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,GAC7B,IAAI,CA0GN"}

package/dist/bindings/list/index.d.ts

@@ -1,2 +1,19 @@
-export {};
+import { EffectObject, ListOptions, ReadonlyAtom } from '../../types';
+import { ListContext } from './context';
+/**
+ * Internal engine for list reconciliation.
+ *
+ * When to use:
+ * - Coordinates the full lifecycle: Empty state -> Diffing -> Rendering -> DOM placement.
+ *
+ * Boundary:
+ * - Uses `untracked` to ensure DOM mutations don't accidentally trigger parent effects.
+ * - Relies on `ListContext` for state persistence across render cycles.
+ *
+ * @internal
+ */
+export declare function applyListBinding<T>(element: HTMLElement, source: ReadonlyAtom<T[]>, options: ListOptions<T>): {
+    fx: EffectObject;
+    ctx: ListContext<T>;
+};
 //# sourceMappingURL=index.d.ts.map

package/dist/bindings/list/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAsB,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE3F,OAAO,EAAuD,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAalG;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EACzB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GACtB;IAAE,EAAE,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;CAAE,CAiD3C"}

package/dist/bindings/list/types.d.ts

@@ -36,42 +36,40 @@ export declare const ItemState: {
     readonly ForceReplace: number;
 };
 export type ItemState = (typeof ItemState)[keyof typeof ItemState];
+/**
+ * Represents a single item's reconciliation state and metadata.
+ *
+ * @internal
+ */
+export interface DiffSlot<T> {
+    /** The unique key for the item. */
+    key: ListKey;
+    /** The current data item. */
+    item: T;
+    /** The assigned reconciliation state. */
+    state: ItemState;
+    /** The index in the previous state, or -1 if new. */
+    oldIndex: number;
+    /** The index in the new state. */
+    targetIndex: number;
+    /** The current DOM handle. */
+    node: Element | JQuery | undefined;
+}
 /**
  * A reconciliation plan generated by the diffing algorithm.
  *
- * Logic: This interface provides index-based buffers and metadata required by
- * the DOM synchronizer to perform atomic mutations with minimal overhead.
+ * Logic: This interface provides a unified table of item slots and metadata
+ * required by the DOM synchronizer to perform atomic mutations.
  *
  * @internal
  */
 export interface PreparedDiff<T> {
-    /** The collection of unique keys for the new item set. */
-    newKeys: ListKey[];
-    /** The collection of data items for the new state. */
-    newItems: T[];
-    /** A set containing all unique keys used for duplicate detection. */
-    newKeySet: Set<ListKey>;
-    /** A map of new indices to their corresponding indices in the previous state. */
-    newIndices: number[];
-    /** The reconciliation state assigned to each item. */
-    newStates: ItemState[];
-    /** The current DOM handles (Element or jQuery) for each item. */
-    newNodes: (Element | JQuery | undefined)[];
+    /** The unified collection of item slots. */
+    slots: DiffSlot<T>[];
     /**
-     * A collection of items that require new DOM construction or HTML parsing
-     * during this rendering cycle.
+     * A collection of slots that require new DOM construction or HTML parsing.
      */
-    toRender: {
-        key: ListKey;
-        item: T;
-        index: number;
-    }[];
-    /** The starting index of the "dirty" middle section after prefix optimization. */
-    startIndex: number;
-    /** The ending index of the "dirty" section relative to the old list state. */
-    oldEndIndex: number;
-    /** The ending index of the "dirty" section relative to the new list state. */
-    newEndIndex: number;
+    toRender: DiffSlot<T>[];
 }
 /**
  * A collection of user-provided lifecycle hooks and event configurations.
@@ -90,4 +88,13 @@ export interface PlaceCallbacks<T> {
     /** Delegated event listeners for the list container. */
     events?: ListOptions<T>['events'] | undefined;
 }
+/**
+ * Normalization table for delegated event listeners.
+ * @internal
+ */
+export interface EventBinding {
+    type: string;
+    selector: string;
+    callback: Function;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/bindings/list/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/D,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;;OAKG;;CAEK,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,sDAAsD;IACtD,QAAQ,EAAE,CAAC,EAAE,CAAC;IACd,qEAAqE;IACrE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,iFAAiF;IACjF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sDAAsD;IACtD,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,iEAAiE;IACjE,QAAQ,EAAE,CAAC,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAE3C;;;OAGG;IACH,QAAQ,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAErD,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,sEAAsE;IACtE,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnE,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrE,8DAA8D;IAC9D,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5C,qFAAqF;IACrF,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAClD,wDAAwD;IACxD,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;CAC/C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/D,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;;OAKG;;CAEK,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,mCAAmC;IACnC,GAAG,EAAE,OAAO,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,CAAC,CAAC;IACR,yCAAyC;IACzC,KAAK,EAAE,SAAS,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,4CAA4C;IAC5C,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,sEAAsE;IACtE,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnE,4DAA4D;IAC5D,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrE,8DAA8D;IAC9D,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5C,qFAAqF;IACrF,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAClD,wDAAwD;IACxD,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB"}

package/dist/bindings/list/utils.d.ts

@@ -1,32 +1,32 @@
 /**
  * Normalizes a raw DOM element or a jQuery collection into a standard jQuery object.
  *
- * @param $el - The element or collection to normalize.
- * @returns A standard jQuery object.
+ * Logic: Polymorphic Input
+ * Supports both raw Element for single operations and JQuery collections for bulk
+ * processing, ensuring consistent API behavior.
+ *
  * @internal
  */
 export declare function wrap($el: Element | JQuery<Element>): JQuery;
 /**
  * Assigns or removes a stable reactive identifier on a DOM node or collection.
  *
- * Logic: The `data-atom-key` attribute serves as the primary stable identifier
- * for DOM nodes within the list reconciliation engine. This allows the diffing
- * algorithm to perform O(N) re-ordering and node reuse, avoiding the overhead
- * of positional comparisons.
- *
- * @param node - The DOM element, Node, or jQuery collection.
- * @param key - The unique string key to assign, or null to remove the identifier.
+ * @param node - The target DOM element or collection.
+ * @param key - Unique string key for identification, or null to remove.
  * @internal
  */
 export declare function setAtomKey(node: Element | Node | JQuery, key: string | null): void;
 /**
  * Performs a deep recursive cleanup of reactive resources associated with a DOM tree.
  *
- * Caution: This method must be executed before an element is permanently detached
- * from the DOM or replaced. Failure to do so may result in "zombie" reactive
- * effects remaining in the registry, leading to significant memory leaks.
+ * Constraint: Teardown Order
+ * Must be executed before an element is permanently detached or replaced.
+ *
+ * Caution: Memory Leak
+ * Failure to call this results in "zombie" reactive effects remaining in the
+ * global registry, leading to significant memory growth over time.
  *
- * @param node - The root element or jQuery collection to clean up.
+ * @param node - The root element or collection to purge from the registry.
  * @internal
  */
 export declare function cleanupNodes(node: Element | JQuery): void;

package/dist/bindings/list/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/utils.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAoBlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAYzD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/bindings/list/utils.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAG3D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAgClF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAczD"}