zubin-grid 0.4.13 → 0.42.13

package/dist/adaptors/react/index.js

@@ -0,0 +1,249 @@
+import { useCallback, useEffect, useRef, useSyncExternalStore } from "react";
+import { isDimensionGrid, isGrid, resolveDimensionGridIndex, resolveGridCoordinatesFromIndex, } from "../../core/cell.js";
+import { readReactiveTailValue } from "../../core/tail.js";
+const STATIC_CELL_META = {
+    existsInDb: true,
+    isDirty: false,
+};
+export function useGrid(currentGrid, options) {
+    const snapshotRef = useRef({
+        rows: currentGrid.rowHeaders,
+        cols: currentGrid.colHeaders,
+    });
+    const onGridUpdateRef = useRef(options?.onGridUpdate);
+    useEffect(() => {
+        onGridUpdateRef.current = options?.onGridUpdate;
+    }, [options?.onGridUpdate]);
+    useEffect(() => {
+        return currentGrid.subscribeGrid((updatedGrid, diff) => {
+            onGridUpdateRef.current?.(updatedGrid, diff);
+        });
+    }, [currentGrid]);
+    const subscribe = useCallback((callback) => currentGrid.subscribeGrid(() => callback()), [currentGrid]);
+    const getSnapshot = useCallback(() => {
+        const nextRows = currentGrid.rowHeaders;
+        const nextCols = currentGrid.colHeaders;
+        const currentSnapshot = snapshotRef.current;
+        if (currentSnapshot.rows === nextRows && currentSnapshot.cols === nextCols) {
+            return currentSnapshot;
+        }
+        const nextSnapshot = {
+            rows: nextRows,
+            cols: nextCols,
+        };
+        snapshotRef.current = nextSnapshot;
+        return nextSnapshot;
+    }, [currentGrid]);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+export function useRowHead(currentGrid, rowId) {
+    const subscribe = useCallback((callback) => currentGrid.subscribeRowHead(rowId, callback), [currentGrid, rowId]);
+    const getSnapshot = useCallback(() => currentGrid.getRowHead(rowId), [currentGrid, rowId]);
+    const head = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    const setHead = useCallback((nextHead) => {
+        currentGrid.updateRowHead(rowId, nextHead);
+    }, [currentGrid, rowId]);
+    const updateLabel = useCallback((label) => {
+        currentGrid.updateRowHead(rowId, (currentHead) => ({
+            ...currentHead,
+            label,
+        }));
+    }, [currentGrid, rowId]);
+    const updateOrder = useCallback((order) => {
+        currentGrid.updateRowHead(rowId, (currentHead) => ({
+            ...currentHead,
+            order,
+        }));
+    }, [currentGrid, rowId]);
+    return {
+        head,
+        setHead,
+        updateLabel,
+        updateOrder,
+    };
+}
+export function useColumnHead(currentGrid, columnId) {
+    const subscribe = useCallback((callback) => currentGrid.subscribeColumnHead(columnId, callback), [currentGrid, columnId]);
+    const getSnapshot = useCallback(() => currentGrid.getColumnHead(columnId), [currentGrid, columnId]);
+    const head = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    const setHead = useCallback((nextHead) => {
+        currentGrid.updateColumnHead(columnId, nextHead);
+    }, [currentGrid, columnId]);
+    const updateLabel = useCallback((label) => {
+        currentGrid.updateColumnHead(columnId, (currentHead) => ({
+            ...currentHead,
+            label,
+        }));
+    }, [currentGrid, columnId]);
+    const updateOrder = useCallback((order) => {
+        currentGrid.updateColumnHead(columnId, (currentHead) => ({
+            ...currentHead,
+            order,
+        }));
+    }, [currentGrid, columnId]);
+    return {
+        head,
+        setHead,
+        updateLabel,
+        updateOrder,
+    };
+}
+export const useColHead = useColumnHead;
+export function useRowTail(currentGrid, rowId, onRowUpdate) {
+    useEffect(() => {
+        if (!onRowUpdate)
+            return;
+        return currentGrid.registerRowTail(rowId, onRowUpdate);
+    }, [currentGrid, rowId, onRowUpdate]);
+    const subscribe = useCallback((callback) => currentGrid.subscribeRowTail(rowId, callback), [currentGrid, rowId]);
+    const getSnapshot = useCallback(() => readReactiveTailValue(currentGrid.getRowTailState(rowId)), [currentGrid, rowId]);
+    const tail = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    return tail;
+}
+export function useColumnTail(currentGrid, columnId, onColumnUpdate) {
+    useEffect(() => {
+        if (!onColumnUpdate)
+            return;
+        return currentGrid.registerColumnTail(columnId, onColumnUpdate);
+    }, [currentGrid, columnId, onColumnUpdate]);
+    const subscribe = useCallback((callback) => currentGrid.subscribeColumnTail(columnId, callback), [currentGrid, columnId]);
+    const getSnapshot = useCallback(() => readReactiveTailValue(currentGrid.getColumnTailState(columnId)), [currentGrid, columnId]);
+    const tail = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    return tail;
+}
+export function useCell(cellOrGrid, position, options) {
+    const snapshot = useCellStoreSnapshot(cellOrGrid, position, options?.placeholder);
+    const setValue = useResolvedCellSetter(cellOrGrid, position, options?.placeholder);
+    return [snapshot.value, setValue, snapshot.meta];
+}
+export function useCellValue(cellOrGrid, position, options) {
+    return useCellStoreSnapshot(cellOrGrid, position, options?.placeholder).value;
+}
+function useCellStoreSnapshot(cellOrGrid, position, placeholder) {
+    const snapshotRef = useRef();
+    const subscribe = useCallback((callback) => subscribeToCellSource(cellOrGrid, callback), [cellOrGrid]);
+    const getSnapshot = useCallback(() => {
+        const previousSnapshot = snapshotRef.current;
+        const nextSnapshot = readHookCellSnapshot(cellOrGrid, position, placeholder, previousSnapshot);
+        snapshotRef.current = nextSnapshot;
+        return nextSnapshot;
+    }, [cellOrGrid, placeholder, position]);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+function useResolvedCellSetter(cellOrGrid, position, placeholder) {
+    return useCallback((nextValue) => {
+        const currentSnapshot = readHookCellSnapshot(cellOrGrid, position, placeholder);
+        if (isDimensionGrid(cellOrGrid)) {
+            const currentGrid = cellOrGrid;
+            const index = resolveDimensionGridIndex(currentGrid, position);
+            currentGrid.setCell(index, resolveUpdater(nextValue, currentSnapshot.value));
+            return;
+        }
+        if (isGrid(cellOrGrid)) {
+            const currentGrid = cellOrGrid;
+            const { rowId, columnId } = resolveGridCoordinatesFromIndex(currentGrid, position);
+            currentGrid.setCell(rowId, columnId, resolveUpdater(nextValue, currentSnapshot.value));
+            return;
+        }
+        const currentCell = cellOrGrid;
+        currentCell.set(resolveUpdater(nextValue, currentCell.get()));
+    }, [cellOrGrid, placeholder, position]);
+}
+function subscribeToCellSource(cellOrGrid, callback) {
+    if (isDimensionGrid(cellOrGrid) || isGrid(cellOrGrid)) {
+        return cellOrGrid.subscribeGrid(() => callback());
+    }
+    return cellOrGrid.subscribe(callback);
+}
+function readHookCellSnapshot(cellOrGrid, position, placeholder, previousSnapshot) {
+    if (isDimensionGrid(cellOrGrid)) {
+        const currentGrid = cellOrGrid;
+        const index = resolveDimensionGridIndex(currentGrid, position);
+        const storedSnapshot = currentGrid.readCell(index);
+        const placeholderContext = createDimensionPlaceholderContext(currentGrid, index, storedSnapshot.meta);
+        return createHookCellSnapshot(storedSnapshot.value, storedSnapshot.meta, placeholder, placeholderContext, previousSnapshot);
+    }
+    if (isGrid(cellOrGrid)) {
+        const currentGrid = cellOrGrid;
+        const resolvedPosition = position;
+        const { rowId, columnId } = resolveGridCoordinatesFromIndex(currentGrid, resolvedPosition);
+        const storedSnapshot = currentGrid.readCell(rowId, columnId);
+        const placeholderContext = {
+            row: resolvedPosition.row,
+            col: resolvedPosition.col,
+            rowId,
+            columnId,
+            meta: storedSnapshot.meta,
+        };
+        return createHookCellSnapshot(storedSnapshot.value, storedSnapshot.meta, placeholder, placeholderContext, previousSnapshot);
+    }
+    const currentCell = cellOrGrid;
+    const value = currentCell.get();
+    if (previousSnapshot &&
+        previousSnapshot.meta.existsInDb === STATIC_CELL_META.existsInDb &&
+        previousSnapshot.meta.isDirty === STATIC_CELL_META.isDirty &&
+        Object.is(previousSnapshot.value, value)) {
+        return previousSnapshot;
+    }
+    return {
+        value,
+        storedValue: value,
+        meta: STATIC_CELL_META,
+    };
+}
+function createHookCellSnapshot(storedValue, meta, placeholder, placeholderContext, previousSnapshot) {
+    const visibleValue = storedValue !== undefined
+        ? storedValue
+        : resolveVisiblePlaceholder(meta, placeholder, placeholderContext, previousSnapshot);
+    if (previousSnapshot &&
+        sameCellMeta(previousSnapshot.meta, meta) &&
+        Object.is(previousSnapshot.storedValue, storedValue) &&
+        Object.is(previousSnapshot.value, visibleValue)) {
+        return previousSnapshot;
+    }
+    return {
+        value: visibleValue,
+        storedValue,
+        meta,
+    };
+}
+function resolveVisiblePlaceholder(meta, placeholder, placeholderContext, previousSnapshot) {
+    if (placeholder === undefined) {
+        return undefined;
+    }
+    if (previousSnapshot &&
+        previousSnapshot.storedValue === undefined &&
+        sameCellMeta(previousSnapshot.meta, meta)) {
+        return previousSnapshot.value;
+    }
+    return typeof placeholder === "function"
+        ? placeholder(placeholderContext)
+        : placeholder;
+}
+function createDimensionPlaceholderContext(currentGrid, index, meta) {
+    if (currentGrid.dimension === "rows") {
+        return {
+            dimension: currentGrid.dimension,
+            index,
+            row: index,
+            rowId: currentGrid.rowHeaders[index],
+            meta,
+        };
+    }
+    return {
+        dimension: currentGrid.dimension,
+        index,
+        col: index,
+        columnId: currentGrid.colHeaders[index],
+        meta,
+    };
+}
+function resolveUpdater(nextValue, currentValue) {
+    return typeof nextValue === "function"
+        ? nextValue(currentValue)
+        : nextValue;
+}
+function sameCellMeta(leftMeta, rightMeta) {
+    return (leftMeta.existsInDb === rightMeta.existsInDb && leftMeta.isDirty === rightMeta.isDirty);
+}
+//# sourceMappingURL=index.js.map

package/dist/adaptors/react/index.js.map

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

package/dist/core/cell.d.ts

@@ -1,12 +1,21 @@
 import type { Cell, CellInitializer } from "./types/cell.types.js";
-import type { Grid, GridPosition, GridState } from "./types/grid.types.js";
-import type { GridHead } from "./types/head.types.js";
+import type { DimensionGridPosition, GridCellPosition, GridDimension } from "./types/grid.types.js";
+import type { GridId } from "./types/head.types.js";
 export type { Cell, Subscriber, Updater } from "./types/cell.types.js";
+type IndexedGrid<TRowId extends GridId = GridId, TColumnId extends GridId = GridId> = {
+    rowHeaders: readonly TRowId[];
+    colHeaders: readonly TColumnId[];
+};
+type IndexedDimensionGrid<TDimension extends GridDimension = GridDimension> = {
+    dimension: TDimension;
+    size: number;
+};
 export declare function cell<TCell>(initialValue: TCell | CellInitializer<TCell>): Cell<TCell>;
-export declare function useCell<TCell>(currentCell: Cell<TCell>): readonly [TCell, (newValue: TCell) => void];
-export declare function useCell<TCell, TRowId extends string, TColumnId extends string, TRowHead extends GridHead<TRowId>, TColumnHead extends GridHead<TColumnId>, TStateCell, TState extends GridState<TStateCell, TRowHead, TColumnHead>>(currentGrid: Grid<TCell, TRowId, TColumnId, TRowHead, TColumnHead, TStateCell, TState>, position: GridPosition<TColumnId, TRowId>): readonly [TCell, (newValue: TCell) => void];
-export declare function useCell<TCell, TRowId extends string, TColumnId extends string, TRowHead extends GridHead<TRowId>, TColumnHead extends GridHead<TColumnId>, TStateCell, TState extends GridState<TStateCell, TRowHead, TColumnHead>>(currentGrid: Grid<TCell, TRowId, TColumnId, TRowHead, TColumnHead, TStateCell, TState>, rowId: TRowId, columnId: TColumnId): readonly [TCell, (newValue: TCell) => void];
-export declare function useCellValue<TCell>(currentCell: Cell<TCell>): TCell;
-export declare function useCellValue<TCell, TRowId extends string, TColumnId extends string, TRowHead extends GridHead<TRowId>, TColumnHead extends GridHead<TColumnId>, TStateCell, TState extends GridState<TStateCell, TRowHead, TColumnHead>>(currentGrid: Grid<TCell, TRowId, TColumnId, TRowHead, TColumnHead, TStateCell, TState>, position: GridPosition<TColumnId, TRowId>): TCell;
-export declare function useCellValue<TCell, TRowId extends string, TColumnId extends string, TRowHead extends GridHead<TRowId>, TColumnHead extends GridHead<TColumnId>, TStateCell, TState extends GridState<TStateCell, TRowHead, TColumnHead>>(currentGrid: Grid<TCell, TRowId, TColumnId, TRowHead, TColumnHead, TStateCell, TState>, rowId: TRowId, columnId: TColumnId): TCell;
+export declare function isGrid(value: unknown): value is IndexedGrid;
+export declare function isDimensionGrid(value: unknown): value is IndexedDimensionGrid;
+export declare function resolveDimensionGridIndex(currentGrid: IndexedDimensionGrid, position: DimensionGridPosition): number;
+export declare function resolveGridCoordinatesFromIndex<TRowId extends GridId, TColumnId extends GridId>(currentGrid: IndexedGrid<TRowId, TColumnId>, position: GridCellPosition): {
+    rowId: TRowId;
+    columnId: TColumnId;
+};
 //# sourceMappingURL=cell.d.ts.map

package/dist/core/cell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cell.d.ts","sourceRoot":"","sources":["../../core/cell.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAuB,MAAM,uBAAuB,CAAC;AACxF,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAgB,MAAM,uBAAuB,CAAC;AACzF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEvE,wBAAgB,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAiCrF;AAED,wBAAgB,OAAO,CAAC,KAAK,EAC3B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GACvB,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;AAC/C,wBAAgB,OAAO,CACrB,KAAK,EACL,MAAM,SAAS,MAAM,EACrB,SAAS,SAAS,MAAM,EACxB,QAAQ,SAAS,QAAQ,CAAC,MAAM,CAAC,EACjC,WAAW,SAAS,QAAQ,CAAC,SAAS,CAAC,EACvC,UAAU,EACV,MAAM,SAAS,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,EAE3D,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,EACtF,QAAQ,EAAE,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,GACxC,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;AAC/C,wBAAgB,OAAO,CACrB,KAAK,EACL,MAAM,SAAS,MAAM,EACrB,SAAS,SAAS,MAAM,EACxB,QAAQ,SAAS,QAAQ,CAAC,MAAM,CAAC,EACjC,WAAW,SAAS,QAAQ,CAAC,SAAS,CAAC,EACvC,UAAU,EACV,MAAM,SAAS,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,EAE3D,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,EACtF,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,GAClB,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;AAoD/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;AACrE,wBAAgB,YAAY,CAC1B,KAAK,EACL,MAAM,SAAS,MAAM,EACrB,SAAS,SAAS,MAAM,EACxB,QAAQ,SAAS,QAAQ,CAAC,MAAM,CAAC,EACjC,WAAW,SAAS,QAAQ,CAAC,SAAS,CAAC,EACvC,UAAU,EACV,MAAM,SAAS,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,EAE3D,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,EACtF,QAAQ,EAAE,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,GACxC,KAAK,CAAC;AACT,wBAAgB,YAAY,CAC1B,KAAK,EACL,MAAM,SAAS,MAAM,EACrB,SAAS,SAAS,MAAM,EACxB,QAAQ,SAAS,QAAQ,CAAC,MAAM,CAAC,EACjC,WAAW,SAAS,QAAQ,CAAC,SAAS,CAAC,EACvC,UAAU,EACV,MAAM,SAAS,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,EAE3D,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,EACtF,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,GAClB,KAAK,CAAC"}
+{"version":3,"file":"cell.d.ts","sourceRoot":"","sources":["../../core/cell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAc,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEvE,KAAK,WAAW,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IACpF,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;CAClC,CAAC;AAEF,KAAK,oBAAoB,CAAC,UAAU,SAAS,aAAa,GAAG,aAAa,IAAI;IAC5E,SAAS,EAAE,UAAU,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAiCrF;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAQ3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAU7E;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,oBAAoB,EACjC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,CAkCR;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,SAAS,MAAM,EACrB,SAAS,SAAS,MAAM,EACxB,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,gBAAgB;;;EAwBxE"}

package/dist/core/cell.js

@@ -1,4 +1,3 @@
-import { useCallback, useSyncExternalStore } from "react";
 export function cell(initialValue) {
     let value = typeof initialValue === "function" ? null : initialValue;
     const subscribers = new Set();
@@ -27,49 +26,68 @@ export function cell(initialValue) {
         _subscribers: () => subscribers.size,
     };
 }
-export function useCell(cellOrGrid, rowIdOrPosition, columnId) {
-    const { rowId: resolvedRowId, columnId: resolvedColumnId } = Array.isArray(rowIdOrPosition)
-        ? {
-            rowId: rowIdOrPosition[1],
-            columnId: rowIdOrPosition[0],
-        }
-        : {
-            rowId: rowIdOrPosition,
-            columnId,
-        };
-    const currentCell = resolveCell(cellOrGrid, resolvedRowId, resolvedColumnId);
-    const subscribe = useCallback((callback) => currentCell.subscribe(callback), [currentCell]);
-    const getSnapshot = useCallback(() => currentCell.get(), [currentCell]);
-    const setValue = isGrid(cellOrGrid) && resolvedRowId !== undefined && resolvedColumnId !== undefined
-        ? (newValue) => cellOrGrid.__setCellValue(resolvedRowId, resolvedColumnId, newValue)
-        : currentCell.set;
-    return [useSyncExternalStore(subscribe, getSnapshot), setValue];
+export function isGrid(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "getCell" in value &&
+        "getRowHead" in value &&
+        "getColumnHead" in value);
+}
+export function isDimensionGrid(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "dimension" in value &&
+        "size" in value &&
+        "subscribeGrid" in value &&
+        "getCell" in value &&
+        !("getRowHead" in value));
 }
-export function useCellValue(cellOrGrid, rowIdOrPosition, columnId) {
-    const { rowId: resolvedRowId, columnId: resolvedColumnId } = Array.isArray(rowIdOrPosition)
-        ? {
-            rowId: rowIdOrPosition[1],
-            columnId: rowIdOrPosition[0],
+export function resolveDimensionGridIndex(currentGrid, position) {
+    if (currentGrid.dimension === "rows") {
+        const row = position.row;
+        if (typeof row !== "number" || !Number.isInteger(row)) {
+            throw new Error(`Row position must be an integer index. Received ${formatPositionValue(row)}.`);
+        }
+        if (row < 0 || row >= currentGrid.size) {
+            throw new Error(`Row position ${row} is out of range. ${describeAxisIndexRange("row", row, currentGrid.size)}`);
         }
-        : {
-            rowId: rowIdOrPosition,
-            columnId,
-        };
-    const currentCell = resolveCell(cellOrGrid, resolvedRowId, resolvedColumnId);
-    const subscribe = useCallback((callback) => currentCell.subscribe(callback), [currentCell]);
-    const getSnapshot = useCallback(() => currentCell.get(), [currentCell]);
-    return useSyncExternalStore(subscribe, getSnapshot);
+        return row;
+    }
+    const col = position.col;
+    if (typeof col !== "number" || !Number.isInteger(col)) {
+        throw new Error(`Column position must be an integer index. Received ${formatPositionValue(col)}.`);
+    }
+    if (col < 0 || col >= currentGrid.size) {
+        throw new Error(`Column position ${col} is out of range. ${describeAxisIndexRange("column", col, currentGrid.size)}`);
+    }
+    return col;
 }
-function resolveCell(cellOrGrid, rowId, columnId) {
-    if (!isGrid(cellOrGrid)) {
-        return cellOrGrid;
+export function resolveGridCoordinatesFromIndex(currentGrid, position) {
+    if (!Number.isInteger(position.row) || !Number.isInteger(position.col)) {
+        throw new Error(`Grid cell position is invalid. Expected integer indices but received { row: ${formatPositionValue(position.row)}, col: ${formatPositionValue(position.col)} }.`);
+    }
+    const rowId = currentGrid.rowHeaders[position.row];
+    const columnId = currentGrid.colHeaders[position.col];
+    if (rowId === undefined || columnId === undefined) {
+        throw new Error([
+            `Grid cell position { row: ${position.row}, col: ${position.col} } is out of range.`,
+            describeAxisIndexRange("row", position.row, currentGrid.rowHeaders.length),
+            describeAxisIndexRange("column", position.col, currentGrid.colHeaders.length),
+        ].join(" "));
     }
-    if (!rowId || !columnId) {
-        throw new Error("Grid cell hooks require both rowId and columnId.");
+    return {
+        rowId,
+        columnId,
+    };
+}
+function describeAxisIndexRange(axis, index, size) {
+    const label = axis === "row" ? "rows" : "columns";
+    if (size === 0) {
+        return `The grid currently has no ${label}, so index ${index} cannot be selected.`;
     }
-    return cellOrGrid.getCell(rowId, columnId);
+    return `${axis === "row" ? "Row" : "Column"} index ${index} must be between 0 and ${size - 1} (${size} total ${label}).`;
 }
-function isGrid(value) {
-    return "getCell" in value;
+function formatPositionValue(value) {
+    return value === undefined ? "undefined" : JSON.stringify(value);
 }
 //# sourceMappingURL=cell.js.map

package/dist/core/cell.js.map

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

package/dist/core/grid-id.d.ts

@@ -0,0 +1,7 @@
+import type { GridId } from "./types/head.types.js";
+export declare function isGridId(value: unknown): value is GridId;
+export declare function assertGridId(value: unknown, context: string): asserts value is GridId;
+export declare function createGridIdKey(id: GridId): string;
+export declare function areEqualGridIds(left: GridId, right: GridId): boolean;
+export declare function formatGridId(id: GridId): string;
+//# sourceMappingURL=grid-id.d.ts.map

package/dist/core/grid-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-id.d.ts","sourceRoot":"","sources":["../../core/grid-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIpD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOxD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAQrF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,UAkBzC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,WAE1D;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,UAYtC"}

package/dist/core/grid-id.js

@@ -0,0 +1,51 @@
+const GRID_ID_DESCRIPTION = "string, number, boolean, or Date";
+export function isGridId(value) {
+    return (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean" ||
+        value instanceof Date);
+}
+export function assertGridId(value, context) {
+    if (!isGridId(value)) {
+        throw new Error(`${context} must be a ${GRID_ID_DESCRIPTION} id.`);
+    }
+    if (value instanceof Date) {
+        readGridDateValue(value, context);
+    }
+}
+export function createGridIdKey(id) {
+    if (typeof id === "string") {
+        return `string:${encodeURIComponent(id)}`;
+    }
+    if (typeof id === "number") {
+        if (Number.isNaN(id)) {
+            return "number:NaN";
+        }
+        return Object.is(id, -0) ? "number:-0" : `number:${id}`;
+    }
+    if (typeof id === "boolean") {
+        return `boolean:${id}`;
+    }
+    return `date:${readGridDateValue(id, "Grid id")}`;
+}
+export function areEqualGridIds(left, right) {
+    return createGridIdKey(left) === createGridIdKey(right);
+}
+export function formatGridId(id) {
+    if (typeof id === "string") {
+        return id;
+    }
+    if (typeof id === "number" || typeof id === "boolean") {
+        return String(id);
+    }
+    readGridDateValue(id, "Grid id");
+    return id.toISOString();
+}
+function readGridDateValue(id, context) {
+    const time = id.getTime();
+    if (!Number.isNaN(time)) {
+        return time;
+    }
+    throw new Error(`${context} must be a valid Date id.`);
+}
+//# sourceMappingURL=grid-id.js.map

package/dist/core/grid-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-id.js","sourceRoot":"","sources":["../../core/grid-id.ts"],"names":[],"mappings":"AAEA,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAE/D,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS;QAC1B,KAAK,YAAY,IAAI,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,OAAe;IAC1D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,cAAc,mBAAmB,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,UAAU,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,WAAW,EAAE,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,QAAQ,iBAAiB,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAa;IACzD,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IAED,iBAAiB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAEjC,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAQ,EAAE,OAAe;IAClD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAE1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,2BAA2B,CAAC,CAAC;AACzD,CAAC"}

package/dist/core/grid.d.ts

@@ -1,12 +1,12 @@
-import type { AnyGrid, BroadSchemaColumnHead, BroadSchemaRowHead, BroadSchemaSnapshot, Grid, GridAxisIds, GridColumnIdOf, GridPersistOption, GridRecord, GridRowIdOf, GridSchemaOptions, GridState, GridStateCell, ParentSubGrid, ParentSubGridOptions, ParentSubGridState, GridStateInitializer, SchemaCell, SchemaCellValue, SchemaColumn, SchemaColumnHead, SchemaColumnId, SchemaRow, SchemaRowHead, SchemaRowId, SchemaSnapshot, UseGridOptions } from "./types/grid.types.js";
-import type { GridHead } from "./types/head.types.js";
-export type { CreateSubGridOptions, Grid, GridAxisIds, GridPersistAdapter, GridPersistOption, GridPosition, GridRows, GridSchemaOptions, GridSetMode, GridState, GridStateCell, GridStateInitializer, GridSubscriber, GridUpdateAction, GridUpdateDiff, GridUpdateSource, GridUpdateType, GridUpsertHead, SubGrid, SubGridState, UseGridOptions, } from "./types/grid.types.js";
-export declare function grid<TState extends GridState<GridRecord, GridRecord, GridRecord>>(source: GridStateInitializer<TState>, options: GridSchemaOptions<TState, keyof SchemaRow<TState> & string, keyof SchemaColumn<TState> & string, keyof SchemaCell<TState> & string, keyof SchemaCell<TState> & string, BroadSchemaSnapshot<TState>>): Grid<SchemaCell<TState>, string, string, BroadSchemaRowHead<TState>, BroadSchemaColumnHead<TState>, SchemaCell<TState>, BroadSchemaSnapshot<TState>>;
+import type { AnyGrid, BroadSchemaColumnHead, BroadSchemaRowHead, BroadSchemaSnapshot, Grid, GridColumnIdOf, GridDimension, GridRecord, GridRowIdOf, GridSchemaOptions, GridState, GridStateCell, ParentDimensionGrid, ParentDimensionGridOptions, ParentSubGrid, ParentSubGridOptions, GridStateInitializer, SchemaCell, SchemaCellValue, SchemaColumn, SchemaColumnHead, SchemaColumnId, SchemaRow, SchemaRowHead, SchemaRowId, SchemaSnapshot } from "./types/grid.types.js";
+import type { GridId } from "./types/head.types.js";
+export type { CreateSubGridOptions, DimensionGrid, DimensionGridOptions, DimensionGridPosition, DimensionGridState, DimensionGridSubscriber, DimensionGridUpdateDiff, Grid, GridAxisIds, GridCellPosition, GridDimension, GridPersistAdapter, GridPersistOption, ParentDimensionGrid, ParentDimensionGridOptions, GridSchemaOptions, GridSetMode, GridCellMeta, GridCellSnapshot, GridState, GridStateCell, GridStateInitializer, GridSubscriber, GridUpdateAction, GridUpdateDiff, GridUpdateSource, GridUpdateType, GridUpsertHead, SubGrid, SubGridState, } from "./types/grid.types.js";
 export declare function grid<TState extends GridState<GridRecord, GridRecord, GridRecord>, TRowHeadIdKey extends keyof SchemaRow<TState> & string, TColumnHeadIdKey extends keyof SchemaColumn<TState> & string, TRowCellKey extends keyof SchemaCell<TState> & string, TColumnCellKey extends keyof SchemaCell<TState> & string>(source: GridStateInitializer<TState>, options: GridSchemaOptions<TState, TRowHeadIdKey, TColumnHeadIdKey, TRowCellKey, TColumnCellKey, SchemaSnapshot<TState, TRowHeadIdKey, TColumnHeadIdKey, TRowCellKey, TColumnCellKey>>): Grid<SchemaCellValue<TState, TRowHeadIdKey, TColumnHeadIdKey, TRowCellKey, TColumnCellKey>, SchemaRowId<TState, TRowHeadIdKey>, SchemaColumnId<TState, TColumnHeadIdKey>, SchemaRowHead<TState, TRowHeadIdKey>, SchemaColumnHead<TState, TColumnHeadIdKey>, SchemaCellValue<TState, TRowHeadIdKey, TColumnHeadIdKey, TRowCellKey, TColumnCellKey>, SchemaSnapshot<TState, TRowHeadIdKey, TColumnHeadIdKey, TRowCellKey, TColumnCellKey>>;
+export declare function grid<TState extends GridState<GridRecord, GridRecord, GridRecord>>(source: GridStateInitializer<TState>, options: GridSchemaOptions<TState, keyof SchemaRow<TState> & string, keyof SchemaColumn<TState> & string, keyof SchemaCell<TState> & string, keyof SchemaCell<TState> & string, BroadSchemaSnapshot<TState>>): Grid<SchemaCell<TState>, GridId, GridId, BroadSchemaRowHead<TState>, BroadSchemaColumnHead<TState>, SchemaCell<TState>, BroadSchemaSnapshot<TState>>;
+export declare function createDimensionGrid<TCell, TParentGrid extends AnyGrid = AnyGrid>(parentGrid: TParentGrid, initialCells: readonly (TCell | undefined)[], dimension: "rows", options?: ParentDimensionGridOptions<TCell, "rows", TParentGrid>): ParentDimensionGrid<TCell, "rows", TParentGrid>;
+export declare function createDimensionGrid<TCell, TParentGrid extends AnyGrid = AnyGrid>(parentGrid: TParentGrid, initialCells: readonly (TCell | undefined)[], dimension: "columns", options?: ParentDimensionGridOptions<TCell, "columns", TParentGrid>): ParentDimensionGrid<TCell, "columns", TParentGrid>;
+export declare function createDimensionGrid<TCell, TDimension extends GridDimension = GridDimension, TParentGrid extends AnyGrid = AnyGrid>(parentGrid: TParentGrid, initialCells: readonly (TCell | undefined)[], dimension: TDimension, options?: ParentDimensionGridOptions<TCell, TDimension, TParentGrid>): ParentDimensionGrid<TCell, TDimension, TParentGrid>;
 export declare function createSubGrid<TCell, TParentGrid extends AnyGrid = AnyGrid>(parentGrid: TParentGrid): ParentSubGrid<TCell, TParentGrid>;
-export declare function createSubGrid<TCell, TParentGrid extends AnyGrid = AnyGrid>(parentGrid: TParentGrid, initialCells: readonly GridStateCell<TCell, GridRowIdOf<TParentGrid>, GridColumnIdOf<TParentGrid>>[], persist?: GridPersistOption<ParentSubGridState<TCell, TParentGrid>>): ParentSubGrid<TCell, TParentGrid>;
-export declare function createSubGrid<TCell, TParentGrid extends AnyGrid = AnyGrid>(parentGrid: TParentGrid, persist: GridPersistOption<ParentSubGridState<TCell, TParentGrid>>): ParentSubGrid<TCell, TParentGrid>;
-export declare function createSubGrid<TCell, TParentGrid extends AnyGrid = AnyGrid>(parentGrid: TParentGrid, options: ParentSubGridOptions<TCell, TParentGrid>): ParentSubGrid<TCell, TParentGrid>;
-export declare function createGridKey(rowId: string, columnId: string): string;
-export declare function useGrid<TCell, TRowId extends string, TColumnId extends string, TRowHead extends GridHead<TRowId>, TColumnHead extends GridHead<TColumnId>, TStateCell, TState extends GridState<TStateCell, TRowHead, TColumnHead>>(currentGrid: Grid<TCell, TRowId, TColumnId, TRowHead, TColumnHead, TStateCell, TState>, options?: UseGridOptions<TCell, TRowId, TColumnId, TRowHead, TColumnHead, TStateCell, TState>): GridAxisIds<TRowId, TColumnId>;
+export declare function createSubGrid<TCell, TParentGrid extends AnyGrid = AnyGrid>(parentGrid: TParentGrid, initialCells: readonly GridStateCell<TCell, GridRowIdOf<TParentGrid>, GridColumnIdOf<TParentGrid>>[], options?: ParentSubGridOptions<TCell, TParentGrid>): ParentSubGrid<TCell, TParentGrid>;
+export declare function createGridKey(rowId: GridId, columnId: GridId): string;
 //# sourceMappingURL=grid.d.ts.map

package/dist/core/grid.d.ts.map

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