@jarenjs/collection 0.83.2

package/ARCHITECTURE.md

@@ -0,0 +1,10 @@
+# Collection architecture
+
+`@jarenjs/core/virtual` owns DOM-free range and sparse measurement math.
+The collection engine owns vnode projection and key-based interaction, importing
+only core/view. The component entry owns elements, frames and observers and maps
+`dispose` to the view renderer's existing `unmount` hook.
+
+The app range coordinator receives a structural provider from the host. Storage
+adapters in linq/db never import app; neither core nor the collection engine
+imports storage or workers. Source resources stay private to the coordinator.

package/README.md

@@ -0,0 +1,31 @@
+# @jarenjs/collection
+
+For a complete storage-to-view application, follow the [public adoption composition](../../docs/ADOPTION-EVIDENCE.md). The injected coordinator owns bounded pages while complete membership and exports belong to the source; AT, physical devices and native OS IME remain separate qualifications.
+
+Virtual lists and grids with bounded viewport work, sparse measurements and stable keys.
+The headless engine uses `@jarenjs/core/virtual`; `./component` adapts it to the
+existing view widget lifecycle. Applications inject row access and rendering.
+
+```js
+import { createCollection } from '@jarenjs/collection';
+const collection = createCollection({
+  count: 1000, keyAt: String, getItem: (index) => ({ label: `Row ${index}` }),
+  renderCell: (row) => row.label
+});
+collection.viewport({ width: 320, height: 440 });
+const vnode = collection.view();
+collection.dispose();
+```
+
+See [architecture](ARCHITECTURE.md) and [the collection contract](docs/COLLECTION.md).
+
+## Public exports
+
+<!--fact:exports.collection-->
+| Import | Kind | Declarations |
+|---|---|---|
+| `@jarenjs/collection` | JavaScript | declared |
+| `@jarenjs/collection/component` | JavaScript | declared |
+| `@jarenjs/collection/package.json` | metadata | — |
+| `@jarenjs/collection/styles/collection.css` | asset | — |
+<!--/fact-->

package/dist/types/collection.d.ts

@@ -0,0 +1,474 @@
+/** Stable DOM identity; JSON escaping also supports lone surrogate code units in JSON keys.
+ * @param {string} id @param {string} key @param {number} [column] */
+export declare function collectionItemId(id: string, key: string, column?: number): string;
+/**
+ * Create a source-independent collection. Accessors run only for credited mounted rows.
+ * Measurements and pins have their own finite credits. Oversized DOM extents refuse explicitly.
+ * @param {any} options
+ */
+export declare function createCollection(options: any): {
+    rowAxis: {
+        position: (index: any) => any;
+        size: (index: any) => any;
+        indexAt: (offset: any) => number;
+        extent(): any;
+        range({ offset, viewport, overscan }?: {
+            offset?: number | undefined;
+            overscan?: number | undefined;
+            viewport?: number | undefined;
+        }): {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        measure(index: any, key: any, value: any): {
+            state: string;
+            reason: string;
+        } | {
+            reason?: undefined;
+            state: string;
+        };
+        anchor(offset: any, keyAt: any, query?: string): {
+            key: string;
+            index: number;
+            offset: number;
+            query: string;
+        } | null;
+        restore(anchor: any, indexOf: any, query?: string): {
+            state: string;
+            offset: any;
+            fallback: boolean;
+        };
+        update(next: any): void;
+        clear(): void;
+        stats(): {
+            measurements: number;
+            bytes: number;
+            summaries: number;
+        };
+        dispose(): void;
+    };
+    columnAxis: {
+        position: (index: any) => any;
+        size: (index: any) => any;
+        indexAt: (offset: any) => number;
+        extent(): any;
+        range({ offset, viewport, overscan }?: {
+            offset?: number | undefined;
+            overscan?: number | undefined;
+            viewport?: number | undefined;
+        }): {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        measure(index: any, key: any, value: any): {
+            state: string;
+            reason: string;
+        } | {
+            reason?: undefined;
+            state: string;
+        };
+        anchor(offset: any, keyAt: any, query?: string): {
+            key: string;
+            index: number;
+            offset: number;
+            query: string;
+        } | null;
+        restore(anchor: any, indexOf: any, query?: string): {
+            state: string;
+            offset: any;
+            fallback: boolean;
+        };
+        update(next: any): void;
+        clear(): void;
+        stats(): {
+            measurements: number;
+            bytes: number;
+            summaries: number;
+        };
+        dispose(): void;
+    };
+    layout: () => {
+        state: any;
+        reason: any;
+        rows: never[];
+        columns: never[];
+    } | {
+        state: string;
+        rowRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        columnRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        rows: {
+            index: number;
+            key: any;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+        columns: {
+            index: number;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+    };
+    options(): any;
+    position(): {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+    viewport(next: any): {
+        state: any;
+        reason: any;
+        rows: never[];
+        columns: never[];
+    } | {
+        state: string;
+        rowRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        columnRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        rows: {
+            index: number;
+            key: any;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+        columns: {
+            index: number;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+    };
+    update(next: any): {
+        state: any;
+        reason: any;
+        rows: never[];
+        columns: never[];
+    } | {
+        state: string;
+        rowRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        columnRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        rows: {
+            index: number;
+            key: any;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+        columns: {
+            index: number;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+    };
+    measure(index: any, key: any, size: any, axis?: string): {
+        state: string;
+        reason: string;
+        offset: number;
+    } | {
+        reason?: undefined;
+        state: string;
+        offset: number;
+    };
+    pin(rows?: any[], columns?: any[]): {
+        state: any;
+        reason: any;
+        rows: never[];
+        columns: never[];
+    } | {
+        state: string;
+        rowRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        columnRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        rows: {
+            index: number;
+            key: any;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+        columns: {
+            index: number;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+    };
+    restore(value: any): {
+        state: any;
+        reason: any;
+        rows: never[];
+        columns: never[];
+    } | {
+        state: string;
+        rowRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        columnRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        rows: {
+            index: number;
+            key: any;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+        columns: {
+            index: number;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+    } | {
+        state: string;
+        reason: string;
+        offset?: undefined;
+        left?: undefined;
+    } | {
+        reason?: undefined;
+        state: string;
+        offset: number;
+        left: number;
+    };
+    snapshot(): any;
+    scrollToOffset: (offset: any) => {
+        state: any;
+        reason: any;
+        rows: never[];
+        columns: never[];
+    } | {
+        state: string;
+        rowRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        columnRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        rows: {
+            index: number;
+            key: any;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+        columns: {
+            index: number;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+    } | {
+        state: string;
+        reason: string;
+        offset?: undefined;
+        left?: undefined;
+    } | {
+        reason?: undefined;
+        state: string;
+        offset: number;
+        left: number;
+    };
+    /** @param {number} index @param {number} [column] */
+    scrollToIndex(index: number, column?: number): {
+        state: any;
+        reason: any;
+        rows: never[];
+        columns: never[];
+    } | {
+        state: string;
+        rowRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        columnRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        rows: {
+            index: number;
+            key: any;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+        columns: {
+            index: number;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+    } | {
+        state: string;
+        reason: string;
+        offset?: undefined;
+        left?: undefined;
+    } | {
+        reason?: undefined;
+        state: string;
+        offset: number;
+        left: number;
+    };
+    scrollToKey(key: any): {
+        state: any;
+        reason: any;
+        rows: never[];
+        columns: never[];
+    } | {
+        state: string;
+        rowRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        columnRange: {
+            start: number;
+            end: number;
+            offset: number;
+            extent: any;
+        };
+        rows: {
+            index: number;
+            key: any;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+        columns: {
+            index: number;
+            start: any;
+            size: any;
+            pinned: any;
+        }[];
+    } | {
+        state: string;
+        reason: string;
+        offset?: undefined;
+        left?: undefined;
+    } | {
+        reason?: undefined;
+        state: string;
+        offset: number;
+        left: number;
+    };
+    view(interaction?: null, id?: string): (string | (string | (string | any[] | {
+        key: number;
+        class: string;
+        role: string | undefined;
+        id: string | undefined;
+        'data-column': number;
+        'aria-colindex': number | undefined;
+        'aria-selected': any;
+        'data-active': boolean;
+        style: {
+            [x: string]: string | number;
+            position: string;
+            width: string;
+            height: string;
+            zIndex: number;
+        };
+    })[] | {
+        key: string;
+        'data-row': number;
+        'data-key': any;
+        role: string;
+        id: string | undefined;
+        'aria-rowindex': number | undefined;
+        'aria-posinset': number | undefined;
+        'aria-setsize': any;
+        'aria-selected': any;
+        class: string;
+        style: {
+            position: string;
+            top: string;
+            height: string;
+            width: string;
+            zIndex: number;
+        };
+    })[] | {
+        class: string;
+        style: {
+            position: string;
+            height: string;
+            width: string;
+        };
+    })[];
+    stats(): {
+        rows: number;
+        columns: number;
+        cells: number;
+        rowMeasurements: {
+            measurements: number;
+            bytes: number;
+            summaries: number;
+        };
+        columnMeasurements: {
+            measurements: number;
+            bytes: number;
+            summaries: number;
+        };
+    };
+    dispose(): void;
+};