@rocicorp/zero 0.26.0-canary.7 → 0.26.0

package/out/zero-react/src/paging-reducer.js

@@ -1,77 +0,0 @@
-function pagingReducer(state, action) {
-  switch (action.type) {
-    case "UPDATE_ESTIMATED_TOTAL": {
-      const newTotal = Math.max(state.estimatedTotal, action.newTotal);
-      if (newTotal === state.estimatedTotal) {
-        return state;
-      }
-      return {
-        ...state,
-        estimatedTotal: newTotal
-      };
-    }
-    case "REACHED_START":
-      return { ...state, hasReachedStart: true };
-    case "REACHED_END":
-      return { ...state, hasReachedEnd: true };
-    case "UPDATE_ANCHOR":
-      return {
-        ...state,
-        queryAnchor: {
-          ...state.queryAnchor,
-          anchor: action.anchor
-        }
-      };
-    case "SHIFT_ANCHOR_DOWN":
-      return {
-        ...state,
-        queryAnchor: {
-          ...state.queryAnchor,
-          anchor: action.newAnchor
-        },
-        pendingScrollAdjustment: action.offset,
-        pagingPhase: "adjusting"
-      };
-    case "RESET_TO_TOP":
-      return {
-        ...state,
-        queryAnchor: {
-          ...state.queryAnchor,
-          anchor: { index: 0, kind: "forward", startRow: void 0 }
-        },
-        pendingScrollAdjustment: action.offset,
-        pagingPhase: "adjusting"
-      };
-    case "SCROLL_ADJUSTED":
-      return {
-        ...state,
-        estimatedTotal: state.estimatedTotal + state.pendingScrollAdjustment,
-        pendingScrollAdjustment: 0,
-        pagingPhase: "skipping"
-      };
-    case "PAGING_COMPLETE":
-      return {
-        ...state,
-        pagingPhase: "idle"
-      };
-    case "RESET_STATE":
-      return {
-        ...state,
-        estimatedTotal: action.estimatedTotal,
-        hasReachedStart: action.hasReachedStart,
-        hasReachedEnd: action.hasReachedEnd,
-        queryAnchor: {
-          listContextParams: action.listContextParams,
-          anchor: action.anchor
-        },
-        pagingPhase: "skipping"
-      };
-    default: {
-      return state;
-    }
-  }
-}
-export {
-  pagingReducer
-};
-//# sourceMappingURL=paging-reducer.js.map

package/out/zero-react/src/paging-reducer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paging-reducer.js","sources":["../../../../zero-react/src/paging-reducer.ts"],"sourcesContent":["import type {Anchor} from './use-rows.ts';\n\ntype QueryAnchor<TListContextParams, TStartRow> = {\n  readonly anchor: Anchor<TStartRow>;\n  /**\n   * Associates an anchor with list query params to coordinate state during\n   * navigation. When list context params change (e.g., filter/sort changes or\n   * browser back/forward navigation), the anchor and scroll position must be\n   * updated atomically with the new query results.\n   *\n   * When `listContextParams !== queryAnchor.listContextParams`:\n   * - Use history state to restore previous scroll position and anchor if\n   *   navigating back\n   * - Use permalink anchor if loading a specific item\n   * - Otherwise reset to top\n   *\n   * During the transition (while `!isListContextCurrent`), skip paging logic\n   * and count updates to avoid querying with mismatched anchor/params or\n   * calculating counts from inconsistent state.\n   */\n  readonly listContextParams: TListContextParams;\n};\n\nexport type PagingState<TListContextParams, TStartRow> = {\n  estimatedTotal: number;\n  hasReachedStart: boolean;\n  hasReachedEnd: boolean;\n  queryAnchor: QueryAnchor<TListContextParams, TStartRow>;\n  pagingPhase: 'idle' | 'adjusting' | 'skipping';\n  pendingScrollAdjustment: number;\n};\n\nexport function pagingReducer<TListContextParams, TStartRow>(\n  state: PagingState<TListContextParams, TStartRow>,\n  action: PagingAction<TListContextParams, TStartRow>,\n): PagingState<TListContextParams, TStartRow> {\n  switch (action.type) {\n    case 'UPDATE_ESTIMATED_TOTAL': {\n      const newTotal = Math.max(state.estimatedTotal, action.newTotal);\n      if (newTotal === state.estimatedTotal) {\n        return state;\n      }\n      return {\n        ...state,\n        estimatedTotal: newTotal,\n      };\n    }\n\n    case 'REACHED_START':\n      return {...state, hasReachedStart: true};\n\n    case 'REACHED_END':\n      return {...state, hasReachedEnd: true};\n\n    case 'UPDATE_ANCHOR':\n      return {\n        ...state,\n        queryAnchor: {\n          ...state.queryAnchor,\n          anchor: action.anchor,\n        },\n      };\n\n    case 'SHIFT_ANCHOR_DOWN':\n      return {\n        ...state,\n        queryAnchor: {\n          ...state.queryAnchor,\n          anchor: action.newAnchor,\n        },\n        pendingScrollAdjustment: action.offset,\n        pagingPhase: 'adjusting',\n      };\n\n    case 'RESET_TO_TOP':\n      return {\n        ...state,\n        queryAnchor: {\n          ...state.queryAnchor,\n          anchor: {index: 0, kind: 'forward', startRow: undefined},\n        },\n        pendingScrollAdjustment: action.offset,\n        pagingPhase: 'adjusting',\n      };\n\n    case 'SCROLL_ADJUSTED':\n      return {\n        ...state,\n        estimatedTotal: state.estimatedTotal + state.pendingScrollAdjustment,\n        pendingScrollAdjustment: 0,\n        pagingPhase: 'skipping',\n      };\n\n    case 'PAGING_COMPLETE':\n      return {\n        ...state,\n        pagingPhase: 'idle',\n      };\n\n    case 'RESET_STATE':\n      return {\n        ...state,\n        estimatedTotal: action.estimatedTotal,\n        hasReachedStart: action.hasReachedStart,\n        hasReachedEnd: action.hasReachedEnd,\n        queryAnchor: {\n          listContextParams: action.listContextParams,\n          anchor: action.anchor,\n        },\n        pagingPhase: 'skipping',\n      };\n\n    default: {\n      action satisfies never;\n      return state;\n    }\n  }\n}\n\nexport type PagingAction<TListContextParams, TStartRow> =\n  | {type: 'UPDATE_ESTIMATED_TOTAL'; newTotal: number}\n  | {type: 'REACHED_START'}\n  | {type: 'REACHED_END'}\n  | {type: 'UPDATE_ANCHOR'; anchor: Anchor<TStartRow>}\n  | {\n      type: 'SHIFT_ANCHOR_DOWN';\n      offset: number;\n      newAnchor: Anchor<TStartRow>;\n    }\n  | {type: 'RESET_TO_TOP'; offset: number}\n  | {type: 'SCROLL_ADJUSTED'}\n  | {type: 'PAGING_COMPLETE'}\n  | {\n      type: 'RESET_STATE';\n      estimatedTotal: number;\n      hasReachedStart: boolean;\n      hasReachedEnd: boolean;\n      anchor: Anchor<TStartRow>;\n      listContextParams: TListContextParams;\n    };\n"],"names":[],"mappings":"AAgCO,SAAS,cACd,OACA,QAC4C;AAC5C,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,0BAA0B;AAC7B,YAAM,WAAW,KAAK,IAAI,MAAM,gBAAgB,OAAO,QAAQ;AAC/D,UAAI,aAAa,MAAM,gBAAgB;AACrC,eAAO;AAAA,MACT;AACA,aAAO;AAAA,QACL,GAAG;AAAA,QACH,gBAAgB;AAAA,MAAA;AAAA,IAEpB;AAAA,IAEA,KAAK;AACH,aAAO,EAAC,GAAG,OAAO,iBAAiB,KAAA;AAAA,IAErC,KAAK;AACH,aAAO,EAAC,GAAG,OAAO,eAAe,KAAA;AAAA,IAEnC,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,aAAa;AAAA,UACX,GAAG,MAAM;AAAA,UACT,QAAQ,OAAO;AAAA,QAAA;AAAA,MACjB;AAAA,IAGJ,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,aAAa;AAAA,UACX,GAAG,MAAM;AAAA,UACT,QAAQ,OAAO;AAAA,QAAA;AAAA,QAEjB,yBAAyB,OAAO;AAAA,QAChC,aAAa;AAAA,MAAA;AAAA,IAGjB,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,aAAa;AAAA,UACX,GAAG,MAAM;AAAA,UACT,QAAQ,EAAC,OAAO,GAAG,MAAM,WAAW,UAAU,OAAA;AAAA,QAAS;AAAA,QAEzD,yBAAyB,OAAO;AAAA,QAChC,aAAa;AAAA,MAAA;AAAA,IAGjB,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,gBAAgB,MAAM,iBAAiB,MAAM;AAAA,QAC7C,yBAAyB;AAAA,QACzB,aAAa;AAAA,MAAA;AAAA,IAGjB,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,aAAa;AAAA,MAAA;AAAA,IAGjB,KAAK;AACH,aAAO;AAAA,QACL,GAAG;AAAA,QACH,gBAAgB,OAAO;AAAA,QACvB,iBAAiB,OAAO;AAAA,QACxB,eAAe,OAAO;AAAA,QACtB,aAAa;AAAA,UACX,mBAAmB,OAAO;AAAA,UAC1B,QAAQ,OAAO;AAAA,QAAA;AAAA,QAEjB,aAAa;AAAA,MAAA;AAAA,IAGjB,SAAS;AAEP,aAAO;AAAA,IACT;AAAA,EAAA;AAEJ;"}

package/out/zero-react/src/use-rows.d.ts

@@ -1,39 +0,0 @@
-import type { DefaultContext, DefaultSchema } from '../../zero-types/src/default-types.ts';
-import type { QueryOrQueryRequest } from '../../zql/src/query/query-registry.ts';
-import { type UseQueryOptions } from './use-query.tsx';
-export type Anchor<TStartRow> = Readonly<{
-    index: number;
-    kind: 'forward';
-    startRow?: TStartRow | undefined;
-}> | Readonly<{
-    index: number;
-    kind: 'backward';
-    startRow: TStartRow;
-}> | Readonly<{
-    index: number;
-    kind: 'permalink';
-    id: string;
-}>;
-export type GetPageQuery<TRow, TStartRow> = (limit: number, start: TStartRow | null, dir: 'forward' | 'backward') => GetQueryReturnType<TRow>;
-export type GetSingleQuery<TRow> = (id: string) => GetQueryReturnType<TRow | undefined>;
-export type GetQueryReturnType<TReturn> = QueryOrQueryRequest<keyof DefaultSchema['tables'] & string, any, // input
-any, // output
-DefaultSchema, TReturn, DefaultContext>;
-export declare function useRows<TRow, TStartRow>({ pageSize, anchor, options, getPageQuery, getSingleQuery, toStartRow, }: {
-    pageSize: number;
-    anchor: Anchor<TStartRow>;
-    options?: UseQueryOptions | undefined;
-    getPageQuery: GetPageQuery<TRow, TStartRow>;
-    getSingleQuery: GetSingleQuery<TRow>;
-    toStartRow: (row: TRow) => TStartRow;
-}): {
-    rowAt: (index: number) => TRow | undefined;
-    rowsLength: number;
-    complete: boolean;
-    rowsEmpty: boolean;
-    atStart: boolean;
-    atEnd: boolean;
-    firstRowIndex: number;
-    permalinkNotFound: boolean;
-};
-//# sourceMappingURL=use-rows.d.ts.map

package/out/zero-react/src/use-rows.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-rows.d.ts","sourceRoot":"","sources":["../../../../zero-react/src/use-rows.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAW,KAAK,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAE/D,MAAM,MAAM,MAAM,CAAC,SAAS,IACxB,QAAQ,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAClC,CAAC,GACF,QAAQ,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC,GACF,QAAQ,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC,CAAC;AAEP,MAAM,MAAM,YAAY,CAAC,IAAI,EAAE,SAAS,IAAI,CAC1C,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,GAAG,IAAI,EACvB,GAAG,EAAE,SAAS,GAAG,UAAU,KACxB,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAE9B,MAAM,MAAM,cAAc,CAAC,IAAI,IAAI,CACjC,EAAE,EAAE,MAAM,KACP,kBAAkB,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;AAE1C,MAAM,MAAM,kBAAkB,CAAC,OAAO,IAAI,mBAAmB,CAC3D,MAAM,aAAa,CAAC,QAAQ,CAAC,GAAG,MAAM,EAEtC,GAAG,EAAE,QAAQ;AAEb,GAAG,EAAE,SAAS;AACd,aAAa,EACb,OAAO,EACP,cAAc,CACf,CAAC;AAEF,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,EACvC,QAAQ,EACR,MAAM,EACN,OAAO,EACP,YAAY,EACZ,cAAc,EACd,UAAU,GACX,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAEtC,YAAY,EAAE,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5C,cAAc,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;IACrC,UAAU,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,SAAS,CAAC;CACtC,GAAG;IACF,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAoJA"}

package/out/zero-react/src/use-rows.js

@@ -1,130 +0,0 @@
-import { assert } from "../../shared/src/asserts.js";
-import { useQuery } from "./use-query.js";
-function useRows({
-  pageSize,
-  anchor,
-  options,
-  getPageQuery,
-  getSingleQuery,
-  toStartRow
-}) {
-  const { kind, index: anchorIndex } = anchor;
-  let permalinkNotFound = false;
-  if (kind === "permalink") {
-    const { id } = anchor;
-    assert(id);
-    assert(pageSize % 2 === 0);
-    const halfPageSize = pageSize / 2;
-    const qItem = getSingleQuery(id);
-    const [row, resultRow] = useQuery(qItem, options);
-    const completeRow = resultRow.type === "complete";
-    const typedRow = row;
-    if (completeRow && typedRow === void 0) {
-      void useQuery(null, options);
-      void useQuery(null, options);
-      return {
-        rowAt: () => void 0,
-        rowsLength: 0,
-        complete: true,
-        rowsEmpty: true,
-        atStart: true,
-        atEnd: true,
-        firstRowIndex: anchorIndex,
-        permalinkNotFound: true
-      };
-    }
-    const start2 = typedRow && toStartRow(typedRow);
-    const qBefore = start2 && getPageQuery(halfPageSize + 1, start2, "backward");
-    const qAfter = start2 && getPageQuery(halfPageSize, start2, "forward");
-    const [rowsBefore, resultBefore] = useQuery(qBefore, options);
-    const [rowsAfter, resultAfter] = useQuery(qAfter, options);
-    const completeBefore = resultBefore.type === "complete";
-    const completeAfter = resultAfter.type === "complete";
-    const typedRowsBefore = rowsBefore;
-    const typedRowsAfter = rowsAfter;
-    const rowsBeforeLength = typedRowsBefore?.length ?? 0;
-    const rowsAfterLength = typedRowsAfter?.length ?? 0;
-    const rowsBeforeSize = Math.min(rowsBeforeLength, halfPageSize);
-    const rowsAfterSize = Math.min(rowsAfterLength, halfPageSize - 1);
-    const firstRowIndex = anchorIndex - rowsBeforeSize;
-    return {
-      rowAt: (index) => {
-        if (index === anchorIndex) {
-          return typedRow;
-        }
-        if (index > anchorIndex) {
-          if (typedRowsAfter === void 0) {
-            return void 0;
-          }
-          const i2 = index - anchorIndex - 1;
-          if (i2 >= rowsAfterSize) {
-            return void 0;
-          }
-          return typedRowsAfter[i2];
-        }
-        assert(index < anchorIndex);
-        if (typedRowsBefore === void 0) {
-          return void 0;
-        }
-        const i = anchorIndex - index - 1;
-        if (i >= rowsBeforeSize) {
-          return void 0;
-        }
-        return typedRowsBefore[i];
-      },
-      rowsLength: rowsBeforeSize + rowsAfterSize + (typedRow ? 1 : 0),
-      complete: completeRow && (typedRow === void 0 || completeBefore && completeAfter),
-      rowsEmpty: typedRow === void 0 || rowsBeforeSize === 0 && rowsAfterSize === 0,
-      atStart: completeBefore && rowsBeforeLength <= halfPageSize,
-      atEnd: completeAfter && rowsAfterLength <= halfPageSize - 1,
-      firstRowIndex,
-      permalinkNotFound
-    };
-  }
-  const { startRow: start = null } = anchor;
-  const q = getPageQuery(pageSize + 1, start, kind);
-  const [rows, result] = useQuery(q, options);
-  void useQuery(null, options);
-  void useQuery(null, options);
-  const typedRows = rows;
-  const complete = result.type === "complete";
-  const hasMoreRows = typedRows.length > pageSize;
-  const rowsLength = hasMoreRows ? pageSize : typedRows.length;
-  const rowsEmpty = typedRows.length === 0;
-  if (kind === "forward") {
-    return {
-      rowAt: (index) => index - anchorIndex < rowsLength ? typedRows[index - anchorIndex] : void 0,
-      rowsLength,
-      complete,
-      rowsEmpty,
-      atStart: start === null || anchorIndex === 0,
-      atEnd: complete && !hasMoreRows,
-      firstRowIndex: anchorIndex,
-      permalinkNotFound
-    };
-  }
-  assert(start !== null);
-  return {
-    rowAt: (index) => {
-      if (index >= anchorIndex) {
-        return void 0;
-      }
-      const i = anchorIndex - index - 1;
-      if (i < 0 || i >= rowsLength) {
-        return void 0;
-      }
-      return typedRows[i];
-    },
-    rowsLength,
-    complete,
-    rowsEmpty,
-    atStart: complete && !hasMoreRows,
-    atEnd: false,
-    firstRowIndex: anchorIndex - rowsLength,
-    permalinkNotFound
-  };
-}
-export {
-  useRows
-};
-//# sourceMappingURL=use-rows.js.map

package/out/zero-react/src/use-rows.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-rows.js","sources":["../../../../zero-react/src/use-rows.ts"],"sourcesContent":["import {assert} from 'shared/src/asserts.ts';\nimport type {\n  DefaultContext,\n  DefaultSchema,\n} from '../../zero-types/src/default-types.ts';\nimport type {QueryOrQueryRequest} from '../../zql/src/query/query-registry.ts';\nimport {useQuery, type UseQueryOptions} from './use-query.tsx';\n\nexport type Anchor<TStartRow> =\n  | Readonly<{\n      index: number;\n      kind: 'forward';\n      startRow?: TStartRow | undefined;\n    }>\n  | Readonly<{\n      index: number;\n      kind: 'backward';\n      startRow: TStartRow;\n    }>\n  | Readonly<{\n      index: number;\n      kind: 'permalink';\n      id: string;\n    }>;\n\nexport type GetPageQuery<TRow, TStartRow> = (\n  limit: number,\n  start: TStartRow | null,\n  dir: 'forward' | 'backward',\n) => GetQueryReturnType<TRow>;\n\nexport type GetSingleQuery<TRow> = (\n  id: string,\n) => GetQueryReturnType<TRow | undefined>;\n\nexport type GetQueryReturnType<TReturn> = QueryOrQueryRequest<\n  keyof DefaultSchema['tables'] & string,\n  // oxlint-disable-next-line no-explicit-any\n  any, // input\n  // oxlint-disable-next-line no-explicit-any\n  any, // output\n  DefaultSchema,\n  TReturn,\n  DefaultContext\n>;\n\nexport function useRows<TRow, TStartRow>({\n  pageSize,\n  anchor,\n  options,\n  getPageQuery,\n  getSingleQuery,\n  toStartRow,\n}: {\n  pageSize: number;\n  anchor: Anchor<TStartRow>;\n  options?: UseQueryOptions | undefined;\n\n  getPageQuery: GetPageQuery<TRow, TStartRow>;\n  getSingleQuery: GetSingleQuery<TRow>;\n  toStartRow: (row: TRow) => TStartRow;\n}): {\n  rowAt: (index: number) => TRow | undefined;\n  rowsLength: number;\n  complete: boolean;\n  rowsEmpty: boolean;\n  atStart: boolean;\n  atEnd: boolean;\n  firstRowIndex: number;\n  permalinkNotFound: boolean;\n} {\n  const {kind, index: anchorIndex} = anchor;\n  let permalinkNotFound = false;\n\n  if (kind === 'permalink') {\n    const {id} = anchor;\n    assert(id);\n    assert(pageSize % 2 === 0);\n\n    const halfPageSize = pageSize / 2;\n\n    const qItem = getSingleQuery(id);\n\n    const [row, resultRow] = useQuery(qItem, options);\n    const completeRow = resultRow.type === 'complete';\n\n    const typedRow = row as TRow | undefined;\n\n    // Early return if permalink not found to skip unnecessary queries\n    if (completeRow && typedRow === undefined) {\n      // Call dummy useQuery to maintain hooks call order\n      void useQuery(null, options);\n      void useQuery(null, options);\n\n      return {\n        rowAt: () => undefined,\n        rowsLength: 0,\n        complete: true,\n        rowsEmpty: true,\n        atStart: true,\n        atEnd: true,\n        firstRowIndex: anchorIndex,\n        permalinkNotFound: true,\n      };\n    }\n\n    const start = typedRow && toStartRow(typedRow);\n\n    const qBefore = start && getPageQuery(halfPageSize + 1, start, 'backward');\n    const qAfter = start && getPageQuery(halfPageSize, start, 'forward');\n\n    const [rowsBefore, resultBefore] = useQuery(qBefore, options);\n    const [rowsAfter, resultAfter] = useQuery(qAfter, options);\n    const completeBefore = resultBefore.type === 'complete';\n    const completeAfter = resultAfter.type === 'complete';\n\n    const typedRowsBefore = rowsBefore as unknown as TRow[] | undefined;\n    const typedRowsAfter = rowsAfter as unknown as TRow[] | undefined;\n    const rowsBeforeLength = typedRowsBefore?.length ?? 0;\n    const rowsAfterLength = typedRowsAfter?.length ?? 0;\n    const rowsBeforeSize = Math.min(rowsBeforeLength, halfPageSize);\n    const rowsAfterSize = Math.min(rowsAfterLength, halfPageSize - 1);\n\n    const firstRowIndex = anchorIndex - rowsBeforeSize;\n\n    return {\n      rowAt: (index: number) => {\n        if (index === anchorIndex) {\n          return typedRow;\n        }\n        if (index > anchorIndex) {\n          if (typedRowsAfter === undefined) {\n            return undefined;\n          }\n          const i = index - anchorIndex - 1;\n          if (i >= rowsAfterSize) {\n            return undefined;\n          }\n          return typedRowsAfter[i];\n        }\n        assert(index < anchorIndex);\n        if (typedRowsBefore === undefined) {\n          return undefined;\n        }\n        const i = anchorIndex - index - 1;\n        if (i >= rowsBeforeSize) {\n          return undefined;\n        }\n        return typedRowsBefore[i];\n      },\n      rowsLength: rowsBeforeSize + rowsAfterSize + (typedRow ? 1 : 0),\n      complete:\n        completeRow &&\n        (typedRow === undefined || (completeBefore && completeAfter)),\n      rowsEmpty:\n        typedRow === undefined || (rowsBeforeSize === 0 && rowsAfterSize === 0),\n      atStart: completeBefore && rowsBeforeLength <= halfPageSize,\n      atEnd: completeAfter && rowsAfterLength <= halfPageSize - 1,\n      firstRowIndex: firstRowIndex,\n      permalinkNotFound,\n    };\n  }\n\n  kind satisfies 'forward' | 'backward';\n\n  const {startRow: start = null} = anchor;\n\n  const q = getPageQuery(pageSize + 1, start, kind);\n\n  const [rows, result] = useQuery(q, options);\n  // not used but needed to follow rules of hooks\n  void useQuery(null, options);\n  void useQuery(null, options);\n\n  const typedRows = rows as unknown as TRow[];\n  const complete = result.type === 'complete';\n  const hasMoreRows = typedRows.length > pageSize;\n  const rowsLength = hasMoreRows ? pageSize : typedRows.length;\n  const rowsEmpty = typedRows.length === 0;\n\n  if (kind === 'forward') {\n    return {\n      rowAt: (index: number) =>\n        index - anchorIndex < rowsLength\n          ? typedRows[index - anchorIndex]\n          : undefined,\n      rowsLength: rowsLength,\n      complete,\n      rowsEmpty: rowsEmpty,\n      atStart: start === null || anchorIndex === 0,\n      atEnd: complete && !hasMoreRows,\n      firstRowIndex: anchorIndex,\n      permalinkNotFound,\n    };\n  }\n\n  kind satisfies 'backward';\n  assert(start !== null);\n\n  return {\n    rowAt: (index: number) => {\n      if (index >= anchorIndex) {\n        return undefined;\n      }\n      const i = anchorIndex - index - 1;\n      if (i < 0 || i >= rowsLength) {\n        return undefined;\n      }\n      return typedRows[i];\n    },\n    rowsLength: rowsLength,\n    complete,\n    rowsEmpty: rowsEmpty,\n    atStart: complete && !hasMoreRows,\n    atEnd: false,\n    firstRowIndex: anchorIndex - rowsLength,\n    permalinkNotFound,\n  };\n}\n"],"names":["start","i"],"mappings":"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"}

package/out/zero-react/src/use-zero-virtualizer.d.ts

@@ -1,122 +0,0 @@
-import { useVirtualizer, type Virtualizer } from '@tanstack/react-virtual';
-import { type Key } from 'react';
-import type { UseQueryOptions } from './use-query.tsx';
-import { type Anchor, type GetPageQuery, type GetSingleQuery } from './use-rows.ts';
-/**
- * State object that captures the virtualizer's scroll position and pagination state.
- * Used for persisting and restoring the virtualizer state across navigation or page reloads.
- *
- * @typeParam TStartRow - The type of the start row data used for pagination anchoring
- */
-export type PermalinkHistoryState<TStartRow> = Readonly<{
-    /** The anchor point for pagination (includes position, direction, and start row data) */
-    anchor: Anchor<TStartRow>;
-    /** The scroll position in pixels from the top of the scrollable container */
-    scrollTop: number;
-    /** The estimated total number of rows in the list */
-    estimatedTotal: number;
-    /** Whether the virtualizer has reached the start of the list */
-    hasReachedStart: boolean;
-    /** Whether the virtualizer has reached the end of the list */
-    hasReachedEnd: boolean;
-}>;
-type TanstackUseVirtualizerOptions<TScrollElement extends Element, TItemElement extends Element> = Parameters<typeof useVirtualizer<TScrollElement, TItemElement>>[0];
-/**
- * Options for configuring the Zero virtualizer.
- * Extends Tanstack Virtual's options with Zero-specific pagination and state management.
- *
- * @typeParam TScrollElement - The type of the scrollable container element
- * @typeParam TItemElement - The type of the individual item elements
- * @typeParam TListContextParams - The type of parameters that define the list's query context
- * @typeParam TRow - The type of row data returned from queries
- * @typeParam TStartRow - The type of data needed to anchor pagination (typically a subset of TRow)
- */
-export type UseZeroVirtualizerOptions<TScrollElement extends Element, TItemElement extends Element, TListContextParams, TRow, TStartRow> = Omit<TanstackUseVirtualizerOptions<TScrollElement, TItemElement>, 'count' | 'initialOffset' | 'horizontal'> & {
-    /** Parameters that define the list's query context (filters, sort order, etc.) */
-    listContextParams: TListContextParams;
-    /** Optional ID to highlight/scroll to a specific row (permalink functionality) */
-    permalinkID?: string | null | undefined;
-    /** Function that returns a query for fetching a page of rows */
-    getPageQuery: GetPageQuery<TRow, TStartRow>;
-    /** Function that returns a query for fetching a single row by ID */
-    getSingleQuery: GetSingleQuery<TRow>;
-    /** Optional query options */
-    options?: UseQueryOptions | undefined;
-    /** Function to extract the start row data from a full row (for pagination anchoring) */
-    toStartRow: (row: TRow) => TStartRow;
-    /**
-     * Function to extract a unique key from a row, used for stable item identification.
-     * If provided, this will override {@linkcode TanstackUseVirtualizerOptions.getItemKey}
-     */
-    getRowKey?: ((row: TRow) => Key) | undefined;
-    /**
-     * Optional current permalink state for restoring virtualizer position.
-     * If provided along with `onPermalinkStateChange`, enables state persistence.
-     * If not provided, virtualizer operates in uncontrolled mode.
-     */
-    permalinkState?: PermalinkHistoryState<TStartRow> | null | undefined;
-    /**
-     * Optional callback invoked when the virtualizer state changes.
-     * Use this to persist state (e.g., to browser history, local storage, etc.).
-     * Called with the new state approximately 100ms after scroll/pagination changes.
-     */
-    onPermalinkStateChange?: (state: PermalinkHistoryState<TStartRow>) => void;
-};
-/**
- * Result object returned by the useZeroVirtualizer hook.
- *
- * @typeParam TScrollElement - The type of the scrollable container element
- * @typeParam TItemElement - The type of the individual item elements
- * @typeParam TRow - The type of row data returned from queries
- */
-export type ZeroVirtualizerResult<TScrollElement extends Element, TItemElement extends Element, TRow> = {
-    /** The Tanstack Virtual virtualizer instance for rendering virtual items */
-    virtualizer: Virtualizer<TScrollElement, TItemElement>;
-    /** Function to get the row data at a specific index, or undefined if not loaded */
-    rowAt: (index: number) => TRow | undefined;
-    /** Whether all initially requested data has finished loading */
-    complete: boolean;
-    /** Whether the list is empty (no rows exist matching the query) */
-    rowsEmpty: boolean;
-    /** Whether the specified permalinkID was not found in the query results */
-    permalinkNotFound: boolean;
-    /** Estimated total number of rows (may be inexact until both ends are reached) */
-    estimatedTotal: number;
-    /** Exact total number of rows, or undefined if not yet known (requires reaching both ends) */
-    total: number | undefined;
-};
-/**
- * Hook that creates a virtualized list with bidirectional pagination and state persistence.
- *
- * This hook combines Tanstack Virtual's efficient virtualization with Zero's reactive queries
- * to create infinitely scrolling lists that load data on demand. It supports:
- * - Bidirectional scrolling (load more items at top or bottom)
- * - Permalink functionality (jump to and highlight specific items)
- * - State persistence (restore scroll position across navigation)
- * - Dynamic page sizing based on viewport
- *
- * @typeParam TScrollElement - The type of the scrollable container element
- * @typeParam TItemElement - The type of the individual item elements
- * @typeParam TListContextParams - The type of parameters that define the list's query context
- * @typeParam TRow - The type of row data returned from queries
- * @typeParam TStartRow - The type of data needed to anchor pagination
- *
- * @param options - Configuration options including query functions, sizing, and state management
- * @returns An object containing the virtualizer instance, row accessor, and state flags
- *
- * @example
- * ```tsx
- * const {virtualizer, rowAt, complete} = useZeroVirtualizer({
- *   estimateSize: () => 50,
- *   getScrollElement: () => scrollRef.current,
- *   listContextParams: {projectId: 'abc'},
- *   getPageQuery: (limit, start, dir) => z.query.issues.where(...).limit(limit),
- *   getSingleQuery: (id) => z.query.issues.where('id', id),
- *   toStartRow: (row) => ({id: row.id, created: row.created}),
- * });
- * ```
- */
-export declare function useZeroVirtualizer<TScrollElement extends Element, TItemElement extends Element, TListContextParams, TRow, TStartRow>({ estimateSize, overscan, // Virtualizer defaults to 1.
-getScrollElement, getItemKey, listContextParams, permalinkID, getPageQuery, getSingleQuery, options, toStartRow, getRowKey, permalinkState, onPermalinkStateChange, ...restVirtualizerOptions }: UseZeroVirtualizerOptions<TScrollElement, TItemElement, TListContextParams, TRow, TStartRow>): ZeroVirtualizerResult<TScrollElement, TItemElement, TRow>;
-export {};
-//# sourceMappingURL=use-zero-virtualizer.d.ts.map

package/out/zero-react/src/use-zero-virtualizer.d.ts.map

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