@ttt-productions/ui-core 0.11.34 → 0.11.36

package/dist/react/hooks/use-cursor-page.js

@@ -1,47 +1,13 @@
 'use client';
 import { useCallback, useState } from 'react';
-/**
- * Page state for a server-paged (cursor / `hasMore`) list: the 1-based page
- * number, the guarded step controls, and the reset — the pieces each
- * server-paged surface was otherwise re-declaring as a local `useState(1)` plus
- * its own clamped increment/decrement and its own "reset when the filter
- * changed" adjustment (ENG-002, ENG-003).
- *
- * The data stays the caller's, and the two halves bind at different moments:
- *
- * ```tsx
- * const pager = useCursorPage({ resetKey: tag });
- * const { data, isFetching } = useThingsByTag(tag, pager.currentPage);
- * …
- * <ListPagination pagination={pager.paginationFor(data?.hasMore ?? false)} busy={isFetching} />
- * ```
- *
- * The guards live in here, not at the call site: a step that cannot move the
- * page changes nothing and does not fire `onPageChange`.
- *
- * A surface whose data hook ALREADY owns its page state (it returns
- * `page`/`hasNextPage`/`nextPage`/`prevPage` itself) does not need this hook —
- * it maps those fields onto {@link ListPaginationState} directly. The hook
- * exists for the surfaces that would otherwise hand-roll the state.
- */
 export function useCursorPage(options = {}) {
     const { onPageChange, resetKey } = options;
-    // The stored page is only meaningful for the inputs it was reached under, so
-    // the key it belongs to is stored WITH it.
     const [pageState, setPageState] = useState({ page: 1, key: resetKey });
-    // `Object.is`, the same comparison React uses for state and deps: a `NaN` key
-    // must compare equal to itself, or the adjustment below would re-fire forever.
+    // `Object.is`, as React compares: a `NaN` key must equal itself, or the adjustment below re-fires forever.
     const keyMatches = Object.is(pageState.key, resetKey);
-    // React's "adjusting state when a prop changes": a new key retires the stored
-    // page, because page 4 of the old result set is not page 4 of the new one.
-    // Retiring it (rather than only ignoring it) is what makes going BACK to
-    // earlier inputs start at page 1 too, instead of reviving a dead page.
     if (!keyMatches) {
         setPageState({ page: 1, key: resetKey });
     }
-    // Derived as well as adjusted, so even the render that triggers the adjustment
-    // already reports page 1 — the caller's query is never asked for a page of the
-    // new inputs that the user never navigated to.
     const currentPage = keyMatches ? pageState.page : 1;
     const goToPreviousPage = useCallback(() => {
         if (currentPage <= 1)
@@ -55,8 +21,6 @@ export function useCursorPage(options = {}) {
         setPageState({ page: 1, key: resetKey });
         onPageChange?.();
     }, [currentPage, resetKey, onPageChange]);
-    // Memoized on the page state itself, so a consumer may hold it in a dep array
-    // and it changes only when the page (or the callback/inputs) actually change.
     const paginationFor = useCallback((hasMore) => ({
         currentPage,
         canPreviousPage: currentPage > 1,

package/dist/react/hooks/use-cursor-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-cursor-page.js","sourceRoot":"","sources":["../../../src/react/hooks/use-cursor-page.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAwD9C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE3C,6EAA6E;IAC7E,2CAA2C;IAC3C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAGvC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE/B,8EAA8E;IAC9E,+EAA+E;IAC/E,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEtD,8EAA8E;IAC9E,2EAA2E;IAC3E,yEAAyE;IACzE,uEAAuE;IACvE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,+EAA+E;IAC/E,+EAA+E;IAC/E,+CAA+C;IAC/C,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;QACxC,IAAI,WAAW,IAAI,CAAC;YAAE,OAAO;QAC7B,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,YAAY,EAAE,EAAE,CAAC;IACnB,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO;QAC9B,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzC,YAAY,EAAE,EAAE,CAAC;IACnB,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAE1C,8EAA8E;IAC9E,8EAA8E;IAC9E,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,OAAgB,EAAc,EAAE,CAAC,CAAC;QACjC,WAAW;QACX,eAAe,EAAE,WAAW,GAAG,CAAC;QAChC,WAAW,EAAE,OAAO;QACpB,gBAAgB;QAChB,YAAY,EAAE,GAAG,EAAE;YACjB,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,YAAY,EAAE,EAAE,CAAC;QACnB,CAAC;KACF,CAAC,EACF,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,CAAC,CACxD,CAAC;IAEF,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AAC/C,CAAC","sourcesContent":["'use client';\n\nimport { useCallback, useState } from 'react';\nimport type { ListPaginationState } from './use-paged-list.js';\n\n/**\n * Render-time page state for a cursor feed, shaped as {@link ListPaginationState}\n * so it drops straight into the ONE `ListPagination` control. Produced by\n * {@link CursorPager.paginationFor} once the query for `currentPage` has\n * answered with its `hasMore`.\n */\nexport interface CursorPage extends ListPaginationState {\n  /** Never known for cursor pagination — the counter reads \"Page N\". */\n  totalPages?: undefined;\n}\n\nexport interface UseCursorPageOptions {\n  /** Called after the page actually changed. Same contract as `usePagedList`. */\n  onPageChange?: () => void;\n  /**\n   * A snapshot of the query inputs the page number belongs to — a tag, a filter,\n   * a sort. When it changes, the page is 1 again **in the same render**, so the\n   * query never fires for \"page 4\" of inputs whose page 4 may not exist.\n   *\n   * Use this when the input change arrives as a prop (there is no event handler\n   * of yours to hang the reset on); use {@link CursorPager.reset} when your own\n   * handler already owns the change. Compose several inputs into one string\n   * (`` `${type}|${projectId ?? \"\"}` ``) — the type is deliberately narrowed to\n   * primitives so a fresh object literal cannot pin the list to page 1 forever.\n   */\n  resetKey?: string | number | boolean | null;\n}\n\n/**\n * What {@link useCursorPage} owns: the page number, the guarded step controls,\n * and the return-to-page-1 control.\n */\nexport interface CursorPager {\n  /** 1-based page to feed into the paged query. */\n  currentPage: number;\n  /**\n   * Return to page 1 without walking back. Call it from the handler that changes\n   * the query's inputs (a new filter, a new tag, a new sort) — page 4 of the old\n   * result set is not page 4 of the new one. A no-op on page 1, so it never\n   * fires `onPageChange` for nothing.\n   */\n  reset: () => void;\n  /**\n   * Bind the query's answer to the controls: pass the `hasMore` that came back\n   * for {@link currentPage} and render the result as\n   * `<ListPagination pagination={…} />`. `hasMore` binds HERE, after the query,\n   * because that is the only moment it exists — a cursor query needs\n   * `currentPage` as its input, so `hasMore` cannot be an argument to the hook\n   * that produces `currentPage`.\n   */\n  paginationFor: (hasMore: boolean) => CursorPage;\n}\n\n/**\n * Page state for a server-paged (cursor / `hasMore`) list: the 1-based page\n * number, the guarded step controls, and the reset — the pieces each\n * server-paged surface was otherwise re-declaring as a local `useState(1)` plus\n * its own clamped increment/decrement and its own \"reset when the filter\n * changed\" adjustment (ENG-002, ENG-003).\n *\n * The data stays the caller's, and the two halves bind at different moments:\n *\n * ```tsx\n * const pager = useCursorPage({ resetKey: tag });\n * const { data, isFetching } = useThingsByTag(tag, pager.currentPage);\n * …\n * <ListPagination pagination={pager.paginationFor(data?.hasMore ?? false)} busy={isFetching} />\n * ```\n *\n * The guards live in here, not at the call site: a step that cannot move the\n * page changes nothing and does not fire `onPageChange`.\n *\n * A surface whose data hook ALREADY owns its page state (it returns\n * `page`/`hasNextPage`/`nextPage`/`prevPage` itself) does not need this hook —\n * it maps those fields onto {@link ListPaginationState} directly. The hook\n * exists for the surfaces that would otherwise hand-roll the state.\n */\nexport function useCursorPage(options: UseCursorPageOptions = {}): CursorPager {\n  const { onPageChange, resetKey } = options;\n\n  // The stored page is only meaningful for the inputs it was reached under, so\n  // the key it belongs to is stored WITH it.\n  const [pageState, setPageState] = useState<{\n    page: number;\n    key: UseCursorPageOptions['resetKey'];\n  }>({ page: 1, key: resetKey });\n\n  // `Object.is`, the same comparison React uses for state and deps: a `NaN` key\n  // must compare equal to itself, or the adjustment below would re-fire forever.\n  const keyMatches = Object.is(pageState.key, resetKey);\n\n  // React's \"adjusting state when a prop changes\": a new key retires the stored\n  // page, because page 4 of the old result set is not page 4 of the new one.\n  // Retiring it (rather than only ignoring it) is what makes going BACK to\n  // earlier inputs start at page 1 too, instead of reviving a dead page.\n  if (!keyMatches) {\n    setPageState({ page: 1, key: resetKey });\n  }\n  // Derived as well as adjusted, so even the render that triggers the adjustment\n  // already reports page 1 — the caller's query is never asked for a page of the\n  // new inputs that the user never navigated to.\n  const currentPage = keyMatches ? pageState.page : 1;\n\n  const goToPreviousPage = useCallback(() => {\n    if (currentPage <= 1) return;\n    setPageState({ page: currentPage - 1, key: resetKey });\n    onPageChange?.();\n  }, [currentPage, resetKey, onPageChange]);\n\n  const reset = useCallback(() => {\n    if (currentPage === 1) return;\n    setPageState({ page: 1, key: resetKey });\n    onPageChange?.();\n  }, [currentPage, resetKey, onPageChange]);\n\n  // Memoized on the page state itself, so a consumer may hold it in a dep array\n  // and it changes only when the page (or the callback/inputs) actually change.\n  const paginationFor = useCallback(\n    (hasMore: boolean): CursorPage => ({\n      currentPage,\n      canPreviousPage: currentPage > 1,\n      canNextPage: hasMore,\n      goToPreviousPage,\n      goToNextPage: () => {\n        if (!hasMore) return;\n        setPageState({ page: currentPage + 1, key: resetKey });\n        onPageChange?.();\n      },\n    }),\n    [currentPage, resetKey, onPageChange, goToPreviousPage],\n  );\n\n  return { currentPage, reset, paginationFor };\n}\n"]}
+{"version":3,"file":"use-cursor-page.js","sourceRoot":"","sources":["../../../src/react/hooks/use-cursor-page.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAkB9C,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE3C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAGvC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE/B,2GAA2G;IAC3G,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;QACxC,IAAI,WAAW,IAAI,CAAC;YAAE,OAAO;QAC7B,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,YAAY,EAAE,EAAE,CAAC;IACnB,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO;QAC9B,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzC,YAAY,EAAE,EAAE,CAAC;IACnB,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAE1C,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,OAAgB,EAAc,EAAE,CAAC,CAAC;QACjC,WAAW;QACX,eAAe,EAAE,WAAW,GAAG,CAAC;QAChC,WAAW,EAAE,OAAO;QACpB,gBAAgB;QAChB,YAAY,EAAE,GAAG,EAAE;YACjB,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,YAAY,EAAE,EAAE,CAAC;QACnB,CAAC;KACF,CAAC,EACF,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,CAAC,CACxD,CAAC;IAEF,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AAC/C,CAAC","sourcesContent":["'use client';\n\nimport { useCallback, useState } from 'react';\nimport type { ListPaginationState } from './use-paged-list.js';\n\nexport interface CursorPage extends ListPaginationState {\n  totalPages?: undefined;\n}\n\nexport interface UseCursorPageOptions {\n  onPageChange?: () => void;\n  resetKey?: string | number | boolean | null;\n}\n\nexport interface CursorPager {\n  currentPage: number;\n  reset: () => void;\n  paginationFor: (hasMore: boolean) => CursorPage;\n}\n\nexport function useCursorPage(options: UseCursorPageOptions = {}): CursorPager {\n  const { onPageChange, resetKey } = options;\n\n  const [pageState, setPageState] = useState<{\n    page: number;\n    key: UseCursorPageOptions['resetKey'];\n  }>({ page: 1, key: resetKey });\n\n  // `Object.is`, as React compares: a `NaN` key must equal itself, or the adjustment below re-fires forever.\n  const keyMatches = Object.is(pageState.key, resetKey);\n\n  if (!keyMatches) {\n    setPageState({ page: 1, key: resetKey });\n  }\n  const currentPage = keyMatches ? pageState.page : 1;\n\n  const goToPreviousPage = useCallback(() => {\n    if (currentPage <= 1) return;\n    setPageState({ page: currentPage - 1, key: resetKey });\n    onPageChange?.();\n  }, [currentPage, resetKey, onPageChange]);\n\n  const reset = useCallback(() => {\n    if (currentPage === 1) return;\n    setPageState({ page: 1, key: resetKey });\n    onPageChange?.();\n  }, [currentPage, resetKey, onPageChange]);\n\n  const paginationFor = useCallback(\n    (hasMore: boolean): CursorPage => ({\n      currentPage,\n      canPreviousPage: currentPage > 1,\n      canNextPage: hasMore,\n      goToPreviousPage,\n      goToNextPage: () => {\n        if (!hasMore) return;\n        setPageState({ page: currentPage + 1, key: resetKey });\n        onPageChange?.();\n      },\n    }),\n    [currentPage, resetKey, onPageChange, goToPreviousPage],\n  );\n\n  return { currentPage, reset, paginationFor };\n}\n"]}

package/dist/react/hooks/use-paged-list.d.ts

@@ -1,29 +1,5 @@
-/**
- * The control state a paginated list exposes to its paginator UI, rendered by
- * the ONE `ListPagination` component. Nothing else builds
- * Previous / counter / Next controls.
- *
- * `totalPages` is the flavor discriminant, and the ONLY difference between the
- * two flavors:
- *
- * - **Known total** (client-side slice pagination — {@link usePagedList}):
- *   `totalPages` is a number and the counter reads `"2 of 5"`.
- * - **Unknown total** (server/cursor pagination — `useCursorPage().paginationFor(hasMore)`,
- *   or a caller's own query hook): `totalPages` is omitted and the counter reads
- *   `"Page 2"`.
- *
- * Both flavors share one visibility rule, one disabled-edge rule, one live
- * region, and one set of classes because they share one component (ENG-002,
- * FRONTEND-001).
- */
 export interface ListPaginationState {
-    /** 1-based page currently on screen. */
     currentPage: number;
-    /**
-     * Total page count when it is knowable — at least 1, even for an empty list
-     * (an empty list is one empty page). Omitted for cursor/`hasMore` pagination,
-     * where the total is unknown until the last page is reached.
-     */
     totalPages?: number;
     canPreviousPage: boolean;
     canNextPage: boolean;
@@ -31,30 +7,11 @@ export interface ListPaginationState {
     goToNextPage: () => void;
 }
 export interface PagedList<T> extends ListPaginationState {
-    /** Always known for a slice-paginated list. */
     totalPages: number;
-    /** The slice of `items` belonging to `currentPage`. */
     pageItems: T[];
 }
 export interface UsePagedListOptions {
-    /**
-     * Called after the page actually changed. Surfaces that keep a per-page
-     * selection (an open detail row) clear it here — the old selection is not on
-     * the new page.
-     */
     onPageChange?: () => void;
 }
-/**
- * The single owner of client-side slice pagination: local page state, the page
- * math, and the current slice over an ALREADY-FETCHED list.
- *
- * Page size is the caller's — every surface passes its own page-size constant
- * (ENG-005), never a literal. Ordering and filtering stay with the caller: pass
- * the list already sorted and filtered.
- *
- * Not for server-paged lists — a cursor/`hasMore` feed pages through the
- * caller's data layer, not through a slice; use `useCursorPage` (or the query
- * hook's own page state) with the same `ListPagination` control.
- */
 export declare function usePagedList<T>(items: readonly T[], pageSize: number, options?: UsePagedListOptions): PagedList<T>;
 //# sourceMappingURL=use-paged-list.d.ts.map

package/dist/react/hooks/use-paged-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-paged-list.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-paged-list.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,CAAE,SAAQ,mBAAmB;IACvD,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,CAAC,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,GAChC,SAAS,CAAC,CAAC,CAAC,CAoCd"}
+{"version":3,"file":"use-paged-list.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-paged-list.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,CAAE,SAAQ,mBAAmB;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,CAAC,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,GAChC,SAAS,CAAC,CAAC,CAAC,CAiCd"}

package/dist/react/hooks/use-paged-list.js

@@ -1,24 +1,9 @@
 'use client';
 import { useCallback, useMemo, useState } from 'react';
-/**
- * The single owner of client-side slice pagination: local page state, the page
- * math, and the current slice over an ALREADY-FETCHED list.
- *
- * Page size is the caller's — every surface passes its own page-size constant
- * (ENG-005), never a literal. Ordering and filtering stay with the caller: pass
- * the list already sorted and filtered.
- *
- * Not for server-paged lists — a cursor/`hasMore` feed pages through the
- * caller's data layer, not through a slice; use `useCursorPage` (or the query
- * hook's own page state) with the same `ListPagination` control.
- */
 export function usePagedList(items, pageSize, options = {}) {
     const { onPageChange } = options;
     const [requestedPage, setRequestedPage] = useState(1);
     const totalPages = Math.max(1, Math.ceil(items.length / pageSize));
-    // The list can shrink under a page that is already open (an item is deleted,
-    // a filter narrows). Clamping keeps the paginator on a real page instead of
-    // rendering an empty slice under an out-of-range "4 of 2".
     const currentPage = Math.min(Math.max(1, requestedPage), totalPages);
     const pageItems = useMemo(() => {
         const startIndex = (currentPage - 1) * pageSize;

package/dist/react/hooks/use-paged-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-paged-list.js","sourceRoot":"","sources":["../../../src/react/hooks/use-paged-list.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAmDvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAmB,EACnB,QAAgB,EAChB,UAA+B,EAAE;IAEjC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IACnE,6EAA6E;IAC7E,4EAA4E;IAC5E,2DAA2D;IAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,UAAU,CAAC,CAAC;IAErE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,MAAM,UAAU,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QAChD,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;IACxD,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEnC,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;QACxC,IAAI,WAAW,IAAI,CAAC;YAAE,OAAO;QAC7B,gBAAgB,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAClC,YAAY,EAAE,EAAE,CAAC;IACnB,CAAC,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAEhC,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,IAAI,WAAW,IAAI,UAAU;YAAE,OAAO;QACtC,gBAAgB,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAClC,YAAY,EAAE,EAAE,CAAC;IACnB,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAE5C,OAAO;QACL,WAAW;QACX,UAAU;QACV,SAAS;QACT,eAAe,EAAE,WAAW,GAAG,CAAC;QAChC,WAAW,EAAE,WAAW,GAAG,UAAU;QACrC,gBAAgB;QAChB,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport { useCallback, useMemo, useState } from 'react';\n\n/**\n * The control state a paginated list exposes to its paginator UI, rendered by\n * the ONE `ListPagination` component. Nothing else builds\n * Previous / counter / Next controls.\n *\n * `totalPages` is the flavor discriminant, and the ONLY difference between the\n * two flavors:\n *\n * - **Known total** (client-side slice pagination — {@link usePagedList}):\n *   `totalPages` is a number and the counter reads `\"2 of 5\"`.\n * - **Unknown total** (server/cursor pagination — `useCursorPage().paginationFor(hasMore)`,\n *   or a caller's own query hook): `totalPages` is omitted and the counter reads\n *   `\"Page 2\"`.\n *\n * Both flavors share one visibility rule, one disabled-edge rule, one live\n * region, and one set of classes because they share one component (ENG-002,\n * FRONTEND-001).\n */\nexport interface ListPaginationState {\n  /** 1-based page currently on screen. */\n  currentPage: number;\n  /**\n   * Total page count when it is knowable — at least 1, even for an empty list\n   * (an empty list is one empty page). Omitted for cursor/`hasMore` pagination,\n   * where the total is unknown until the last page is reached.\n   */\n  totalPages?: number;\n  canPreviousPage: boolean;\n  canNextPage: boolean;\n  goToPreviousPage: () => void;\n  goToNextPage: () => void;\n}\n\nexport interface PagedList<T> extends ListPaginationState {\n  /** Always known for a slice-paginated list. */\n  totalPages: number;\n  /** The slice of `items` belonging to `currentPage`. */\n  pageItems: T[];\n}\n\nexport interface UsePagedListOptions {\n  /**\n   * Called after the page actually changed. Surfaces that keep a per-page\n   * selection (an open detail row) clear it here — the old selection is not on\n   * the new page.\n   */\n  onPageChange?: () => void;\n}\n\n/**\n * The single owner of client-side slice pagination: local page state, the page\n * math, and the current slice over an ALREADY-FETCHED list.\n *\n * Page size is the caller's — every surface passes its own page-size constant\n * (ENG-005), never a literal. Ordering and filtering stay with the caller: pass\n * the list already sorted and filtered.\n *\n * Not for server-paged lists — a cursor/`hasMore` feed pages through the\n * caller's data layer, not through a slice; use `useCursorPage` (or the query\n * hook's own page state) with the same `ListPagination` control.\n */\nexport function usePagedList<T>(\n  items: readonly T[],\n  pageSize: number,\n  options: UsePagedListOptions = {},\n): PagedList<T> {\n  const { onPageChange } = options;\n  const [requestedPage, setRequestedPage] = useState(1);\n\n  const totalPages = Math.max(1, Math.ceil(items.length / pageSize));\n  // The list can shrink under a page that is already open (an item is deleted,\n  // a filter narrows). Clamping keeps the paginator on a real page instead of\n  // rendering an empty slice under an out-of-range \"4 of 2\".\n  const currentPage = Math.min(Math.max(1, requestedPage), totalPages);\n\n  const pageItems = useMemo(() => {\n    const startIndex = (currentPage - 1) * pageSize;\n    return items.slice(startIndex, startIndex + pageSize);\n  }, [items, currentPage, pageSize]);\n\n  const goToPreviousPage = useCallback(() => {\n    if (currentPage <= 1) return;\n    setRequestedPage(currentPage - 1);\n    onPageChange?.();\n  }, [currentPage, onPageChange]);\n\n  const goToNextPage = useCallback(() => {\n    if (currentPage >= totalPages) return;\n    setRequestedPage(currentPage + 1);\n    onPageChange?.();\n  }, [currentPage, totalPages, onPageChange]);\n\n  return {\n    currentPage,\n    totalPages,\n    pageItems,\n    canPreviousPage: currentPage > 1,\n    canNextPage: currentPage < totalPages,\n    goToPreviousPage,\n    goToNextPage,\n  };\n}\n"]}
+{"version":3,"file":"use-paged-list.js","sourceRoot":"","sources":["../../../src/react/hooks/use-paged-list.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAoBvD,MAAM,UAAU,YAAY,CAC1B,KAAmB,EACnB,QAAgB,EAChB,UAA+B,EAAE;IAEjC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,UAAU,CAAC,CAAC;IAErE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,MAAM,UAAU,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;QAChD,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;IACxD,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEnC,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAG,EAAE;QACxC,IAAI,WAAW,IAAI,CAAC;YAAE,OAAO;QAC7B,gBAAgB,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAClC,YAAY,EAAE,EAAE,CAAC;IACnB,CAAC,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAEhC,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,IAAI,WAAW,IAAI,UAAU;YAAE,OAAO;QACtC,gBAAgB,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAClC,YAAY,EAAE,EAAE,CAAC;IACnB,CAAC,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAE5C,OAAO;QACL,WAAW;QACX,UAAU;QACV,SAAS;QACT,eAAe,EAAE,WAAW,GAAG,CAAC;QAChC,WAAW,EAAE,WAAW,GAAG,UAAU;QACrC,gBAAgB;QAChB,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport { useCallback, useMemo, useState } from 'react';\n\nexport interface ListPaginationState {\n  currentPage: number;\n  totalPages?: number;\n  canPreviousPage: boolean;\n  canNextPage: boolean;\n  goToPreviousPage: () => void;\n  goToNextPage: () => void;\n}\n\nexport interface PagedList<T> extends ListPaginationState {\n  totalPages: number;\n  pageItems: T[];\n}\n\nexport interface UsePagedListOptions {\n  onPageChange?: () => void;\n}\n\nexport function usePagedList<T>(\n  items: readonly T[],\n  pageSize: number,\n  options: UsePagedListOptions = {},\n): PagedList<T> {\n  const { onPageChange } = options;\n  const [requestedPage, setRequestedPage] = useState(1);\n\n  const totalPages = Math.max(1, Math.ceil(items.length / pageSize));\n  const currentPage = Math.min(Math.max(1, requestedPage), totalPages);\n\n  const pageItems = useMemo(() => {\n    const startIndex = (currentPage - 1) * pageSize;\n    return items.slice(startIndex, startIndex + pageSize);\n  }, [items, currentPage, pageSize]);\n\n  const goToPreviousPage = useCallback(() => {\n    if (currentPage <= 1) return;\n    setRequestedPage(currentPage - 1);\n    onPageChange?.();\n  }, [currentPage, onPageChange]);\n\n  const goToNextPage = useCallback(() => {\n    if (currentPage >= totalPages) return;\n    setRequestedPage(currentPage + 1);\n    onPageChange?.();\n  }, [currentPage, totalPages, onPageChange]);\n\n  return {\n    currentPage,\n    totalPages,\n    pageItems,\n    canPreviousPage: currentPage > 1,\n    canNextPage: currentPage < totalPages,\n    goToPreviousPage,\n    goToNextPage,\n  };\n}\n"]}

package/dist/react/hooks/use-return-scroll.d.ts

@@ -1,26 +1,17 @@
 export interface ReturnScrollEntry {
-    /** The saved `window.scrollY`. */
     y: number;
-    /** Epoch ms at save time (diagnostic; the caller decides eligibility, not the hook). */
     savedAt: number;
 }
 export interface UseReturnScrollOptions {
-    /** The caller's CANONICAL list URL — equivalent list states must give the same key. */
     key: string;
-    /** Decided by the caller ONCE at mount (e.g. "the list's data was already cached on first render"). */
     eligible: boolean;
-    /** The list is displayed at its real height: data present, no error surface in its place. */
     ready: boolean;
 }
 export interface UseReturnScrollResult {
-    /** Record the current window offset for `key`. Call right before navigating away. */
     save: () => void;
 }
-/** The stored entry for `key`, or null when absent, unreadable, or malformed. */
 export declare function readReturnScroll(key: string): ReturnScrollEntry | null;
-/** Record `y` (default: the current `window.scrollY`) for `key`. No-op without storage. */
 export declare function saveReturnScroll(key: string, y?: number): void;
-/** Drop the entry for `key` (e.g. the list changed underneath the saved offset). */
 export declare function clearReturnScroll(key: string): void;
 export declare function useReturnScroll({ key, eligible, ready, }: UseReturnScrollOptions): UseReturnScrollResult;
 //# sourceMappingURL=use-return-scroll.d.ts.map

package/dist/react/hooks/use-return-scroll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-return-scroll.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-return-scroll.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,uGAAuG;IACvG,QAAQ,EAAE,OAAO,CAAC;IAClB,6FAA6F;IAC7F,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAeD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CActE;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAU9D;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQnD;AASD,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,QAAQ,EACR,KAAK,GACN,EAAE,sBAAsB,GAAG,qBAAqB,CAuChD"}
+{"version":3,"file":"use-return-scroll.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-return-scroll.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAeD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CActE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAU9D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQnD;AAQD,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,QAAQ,EACR,KAAK,GACN,EAAE,sBAAsB,GAAG,qBAAqB,CAkChD"}

package/dist/react/hooks/use-return-scroll.js

@@ -1,24 +1,4 @@
 'use client';
-// Return-scroll: bring a list back to where the user left it after a REAL route change.
-//
-// A same-page view swap keeps its component mounted and can restore from a ref; a list
-// whose detail pages have their own URLs unmounts, so the offset has to survive in
-// per-tab storage and the restore has to wait until the list is displayed at its real
-// height again. This hook is the ONE owner of that mechanism. It knows nothing about
-// what the list is — the caller supplies a canonical key, decides eligibility once at
-// mount, and reports readiness.
-//
-// Contract (every rule below is tested):
-//   - `save()` writes { y, savedAt } for `key` — call it immediately before navigating
-//     away (inside any guarded-navigation callback, so a cancelled leave writes nothing).
-//   - `eligible` is latched per key the first time the hook sees that key. Not eligible
-//     ⇒ the entry is deleted immediately and permanently for that key; a later flip
-//     of `eligible` or `ready` never re-arms the restore.
-//   - `ready` ⇒ the restore fires ONCE, in a requestAnimationFrame, `behavior: "instant"`,
-//     then consumes the entry. The scheduled frame is cancelled on unmount or key change.
-//     React Strict Mode's mount/unmount/mount cancels and reschedules, so exactly one
-//     scroll happens and the entry is consumed exactly once.
-//   - Blocked, unavailable, or malformed storage is a silent no-op.
 import * as React from 'react';
 const STORAGE_PREFIX = 'return-scroll:';
 function storageKey(key) {
@@ -34,7 +14,6 @@ function sessionStorageOrNull() {
         return null;
     }
 }
-/** The stored entry for `key`, or null when absent, unreadable, or malformed. */
 export function readReturnScroll(key) {
     const storage = sessionStorageOrNull();
     if (!storage)
@@ -55,7 +34,6 @@ export function readReturnScroll(key) {
         return null;
     }
 }
-/** Record `y` (default: the current `window.scrollY`) for `key`. No-op without storage. */
 export function saveReturnScroll(key, y) {
     const storage = sessionStorageOrNull();
     if (!storage)
@@ -66,10 +44,9 @@ export function saveReturnScroll(key, y) {
         storage.setItem(storageKey(key), JSON.stringify(entry));
     }
     catch {
-        /* storage blocked or full — nothing to restore later, which is the honest outcome */
+        // A blocked or full store throws on write; the position is best-effort (RULE-STD-FRONTEND-010).
     }
 }
-/** Drop the entry for `key` (e.g. the list changed underneath the saved offset). */
 export function clearReturnScroll(key) {
     const storage = sessionStorageOrNull();
     if (!storage)
@@ -78,13 +55,11 @@ export function clearReturnScroll(key) {
         storage.removeItem(storageKey(key));
     }
     catch {
-        /* nothing to clear */
+        // A blocked store throws here, and then it holds nothing to clear.
     }
 }
 export function useReturnScroll({ key, eligible, ready, }) {
     const decisionRef = React.useRef(null);
-    // Decide ONCE per key, the first time the hook sees it. Effects may read and write refs;
-    // the decision is latched, so a later `eligible` flip finds it already made and returns.
     React.useEffect(() => {
         if (decisionRef.current?.key === key)
             return;
@@ -94,15 +69,12 @@ export function useReturnScroll({ key, eligible, ready, }) {
             return;
         }
         if (!eligible) {
-            // A cold return: nothing cached to restore against. Discard permanently for this visit.
             clearReturnScroll(key);
             decisionRef.current = { key, y: null, done: true };
             return;
         }
         decisionRef.current = { key, y: entry.y, done: false };
     }, [key, eligible]);
-    // Restore once the list is displayed at its real height. The frame is cancelled on unmount
-    // or key change; Strict Mode's re-run reschedules it, so exactly one scroll happens.
     React.useEffect(() => {
         const decision = decisionRef.current;
         if (!decision || decision.key !== key || decision.y === null || decision.done || !ready)

package/dist/react/hooks/use-return-scroll.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-return-scroll.js","sourceRoot":"","sources":["../../../src/react/hooks/use-return-scroll.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\n// Return-scroll: bring a list back to where the user left it after a REAL route change.\n//\n// A same-page view swap keeps its component mounted and can restore from a ref; a list\n// whose detail pages have their own URLs unmounts, so the offset has to survive in\n// per-tab storage and the restore has to wait until the list is displayed at its real\n// height again. This hook is the ONE owner of that mechanism. It knows nothing about\n// what the list is — the caller supplies a canonical key, decides eligibility once at\n// mount, and reports readiness.\n//\n// Contract (every rule below is tested):\n//   - `save()` writes { y, savedAt } for `key` — call it immediately before navigating\n//     away (inside any guarded-navigation callback, so a cancelled leave writes nothing).\n//   - `eligible` is latched per key the first time the hook sees that key. Not eligible\n//     ⇒ the entry is deleted immediately and permanently for that key; a later flip\n//     of `eligible` or `ready` never re-arms the restore.\n//   - `ready` ⇒ the restore fires ONCE, in a requestAnimationFrame, `behavior: \"instant\"`,\n//     then consumes the entry. The scheduled frame is cancelled on unmount or key change.\n//     React Strict Mode's mount/unmount/mount cancels and reschedules, so exactly one\n//     scroll happens and the entry is consumed exactly once.\n//   - Blocked, unavailable, or malformed storage is a silent no-op.\n\nimport * as React from 'react';\n\nconst STORAGE_PREFIX = 'return-scroll:';\n\nexport interface ReturnScrollEntry {\n  /** The saved `window.scrollY`. */\n  y: number;\n  /** Epoch ms at save time (diagnostic; the caller decides eligibility, not the hook). */\n  savedAt: number;\n}\n\nexport interface UseReturnScrollOptions {\n  /** The caller's CANONICAL list URL — equivalent list states must give the same key. */\n  key: string;\n  /** Decided by the caller ONCE at mount (e.g. \"the list's data was already cached on first render\"). */\n  eligible: boolean;\n  /** The list is displayed at its real height: data present, no error surface in its place. */\n  ready: boolean;\n}\n\nexport interface UseReturnScrollResult {\n  /** Record the current window offset for `key`. Call right before navigating away. */\n  save: () => void;\n}\n\nfunction storageKey(key: string): string {\n  return `${STORAGE_PREFIX}${key}`;\n}\n\nfunction sessionStorageOrNull(): Storage | null {\n  try {\n    if (typeof window === 'undefined') return null;\n    return window.sessionStorage ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/** The stored entry for `key`, or null when absent, unreadable, or malformed. */\nexport function readReturnScroll(key: string): ReturnScrollEntry | null {\n  const storage = sessionStorageOrNull();\n  if (!storage) return null;\n  try {\n    const raw = storage.getItem(storageKey(key));\n    if (!raw) return null;\n    const parsed: unknown = JSON.parse(raw);\n    if (typeof parsed !== 'object' || parsed === null) return null;\n    const { y, savedAt } = parsed as { y?: unknown; savedAt?: unknown };\n    if (typeof y !== 'number' || !Number.isFinite(y) || y < 0) return null;\n    return { y, savedAt: typeof savedAt === 'number' ? savedAt : 0 };\n  } catch {\n    return null;\n  }\n}\n\n/** Record `y` (default: the current `window.scrollY`) for `key`. No-op without storage. */\nexport function saveReturnScroll(key: string, y?: number): void {\n  const storage = sessionStorageOrNull();\n  if (!storage) return;\n  try {\n    const offset = typeof y === 'number' ? y : window.scrollY;\n    const entry: ReturnScrollEntry = { y: offset, savedAt: Date.now() };\n    storage.setItem(storageKey(key), JSON.stringify(entry));\n  } catch {\n    /* storage blocked or full — nothing to restore later, which is the honest outcome */\n  }\n}\n\n/** Drop the entry for `key` (e.g. the list changed underneath the saved offset). */\nexport function clearReturnScroll(key: string): void {\n  const storage = sessionStorageOrNull();\n  if (!storage) return;\n  try {\n    storage.removeItem(storageKey(key));\n  } catch {\n    /* nothing to clear */\n  }\n}\n\ninterface Decision {\n  key: string;\n  /** The offset to restore, or null when this key's return is not restorable. */\n  y: number | null;\n  done: boolean;\n}\n\nexport function useReturnScroll({\n  key,\n  eligible,\n  ready,\n}: UseReturnScrollOptions): UseReturnScrollResult {\n  const decisionRef = React.useRef<Decision | null>(null);\n\n  // Decide ONCE per key, the first time the hook sees it. Effects may read and write refs;\n  // the decision is latched, so a later `eligible` flip finds it already made and returns.\n  React.useEffect(() => {\n    if (decisionRef.current?.key === key) return;\n    const entry = readReturnScroll(key);\n    if (!entry) {\n      decisionRef.current = { key, y: null, done: true };\n      return;\n    }\n    if (!eligible) {\n      // A cold return: nothing cached to restore against. Discard permanently for this visit.\n      clearReturnScroll(key);\n      decisionRef.current = { key, y: null, done: true };\n      return;\n    }\n    decisionRef.current = { key, y: entry.y, done: false };\n  }, [key, eligible]);\n\n  // Restore once the list is displayed at its real height. The frame is cancelled on unmount\n  // or key change; Strict Mode's re-run reschedules it, so exactly one scroll happens.\n  React.useEffect(() => {\n    const decision = decisionRef.current;\n    if (!decision || decision.key !== key || decision.y === null || decision.done || !ready) return;\n    if (typeof window === 'undefined') return;\n    const y = decision.y;\n    const frame = window.requestAnimationFrame(() => {\n      window.scrollTo({ top: y, left: 0, behavior: 'instant' as ScrollBehavior });\n      clearReturnScroll(key);\n      decision.done = true;\n    });\n    return () => window.cancelAnimationFrame(frame);\n  }, [key, ready]);\n\n  const save = React.useCallback(() => saveReturnScroll(key), [key]);\n\n  return { save };\n}\n"]}
+{"version":3,"file":"use-return-scroll.js","sourceRoot":"","sources":["../../../src/react/hooks/use-return-scroll.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport * as React from 'react';\n\nconst STORAGE_PREFIX = 'return-scroll:';\n\nexport interface ReturnScrollEntry {\n  y: number;\n  savedAt: number;\n}\n\nexport interface UseReturnScrollOptions {\n  key: string;\n  eligible: boolean;\n  ready: boolean;\n}\n\nexport interface UseReturnScrollResult {\n  save: () => void;\n}\n\nfunction storageKey(key: string): string {\n  return `${STORAGE_PREFIX}${key}`;\n}\n\nfunction sessionStorageOrNull(): Storage | null {\n  try {\n    if (typeof window === 'undefined') return null;\n    return window.sessionStorage ?? null;\n  } catch {\n    return null;\n  }\n}\n\nexport function readReturnScroll(key: string): ReturnScrollEntry | null {\n  const storage = sessionStorageOrNull();\n  if (!storage) return null;\n  try {\n    const raw = storage.getItem(storageKey(key));\n    if (!raw) return null;\n    const parsed: unknown = JSON.parse(raw);\n    if (typeof parsed !== 'object' || parsed === null) return null;\n    const { y, savedAt } = parsed as { y?: unknown; savedAt?: unknown };\n    if (typeof y !== 'number' || !Number.isFinite(y) || y < 0) return null;\n    return { y, savedAt: typeof savedAt === 'number' ? savedAt : 0 };\n  } catch {\n    return null;\n  }\n}\n\nexport function saveReturnScroll(key: string, y?: number): void {\n  const storage = sessionStorageOrNull();\n  if (!storage) return;\n  try {\n    const offset = typeof y === 'number' ? y : window.scrollY;\n    const entry: ReturnScrollEntry = { y: offset, savedAt: Date.now() };\n    storage.setItem(storageKey(key), JSON.stringify(entry));\n  } catch {\n    // A blocked or full store throws on write; the position is best-effort (RULE-STD-FRONTEND-010).\n  }\n}\n\nexport function clearReturnScroll(key: string): void {\n  const storage = sessionStorageOrNull();\n  if (!storage) return;\n  try {\n    storage.removeItem(storageKey(key));\n  } catch {\n    // A blocked store throws here, and then it holds nothing to clear.\n  }\n}\n\ninterface Decision {\n  key: string;\n  y: number | null;\n  done: boolean;\n}\n\nexport function useReturnScroll({\n  key,\n  eligible,\n  ready,\n}: UseReturnScrollOptions): UseReturnScrollResult {\n  const decisionRef = React.useRef<Decision | null>(null);\n\n  React.useEffect(() => {\n    if (decisionRef.current?.key === key) return;\n    const entry = readReturnScroll(key);\n    if (!entry) {\n      decisionRef.current = { key, y: null, done: true };\n      return;\n    }\n    if (!eligible) {\n      clearReturnScroll(key);\n      decisionRef.current = { key, y: null, done: true };\n      return;\n    }\n    decisionRef.current = { key, y: entry.y, done: false };\n  }, [key, eligible]);\n\n  React.useEffect(() => {\n    const decision = decisionRef.current;\n    if (!decision || decision.key !== key || decision.y === null || decision.done || !ready) return;\n    if (typeof window === 'undefined') return;\n    const y = decision.y;\n    const frame = window.requestAnimationFrame(() => {\n      window.scrollTo({ top: y, left: 0, behavior: 'instant' as ScrollBehavior });\n      clearReturnScroll(key);\n      decision.done = true;\n    });\n    return () => window.cancelAnimationFrame(frame);\n  }, [key, ready]);\n\n  const save = React.useCallback(() => saveReturnScroll(key), [key]);\n\n  return { save };\n}\n"]}

package/dist/react/hooks/use-toast.d.ts

@@ -6,18 +6,10 @@ export type ToasterToast = {
     description?: React.ReactNode;
     action?: React.ReactNode;
     variant?: ToastVariant;
-    /** Radix controlled open state */
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
-    /** ms */
     duration?: number;
-    /** show X button */
     dismissible?: boolean;
-    /**
-     * When `true`, the toast does not auto-dismiss and renders no countdown bar.
-     * `duration` is ignored. The user must click the X (or programmatic `dismiss`)
-     * to remove it.
-     */
     persistent?: boolean;
 };
 type ToastProps = ToasterToast;

package/dist/react/hooks/use-toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-toast.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-toast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAEvC,SAAS;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oBAAoB;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,KAAK,UAAU,GAAG,YAAY,CAAC;AAuF/B,wBAAgB,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;;;oBAQ1B,OAAO,CAAC,UAAU,CAAC;EAyB3C;AAED,wBAAgB,QAAQ;;wBAcA,MAAM;YA/HpB,UAAU,EAAE;EAoIrB"}
+{"version":3,"file":"use-toast.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/use-toast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAEvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,KAAK,UAAU,GAAG,YAAY,CAAC;AAuF/B,wBAAgB,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;;;oBAQ1B,OAAO,CAAC,UAAU,CAAC;EAwB3C;AAED,wBAAgB,QAAQ;;wBAcA,MAAM;YA9HpB,UAAU,EAAE;EAmIrB"}

package/dist/react/hooks/use-toast.js

@@ -1,8 +1,6 @@
 import * as React from 'react';
 const TOAST_LIMIT = 3;
-// Time between Radix flipping `open=false` and the toast actually unmounting.
-// Just long enough for the close animation to finish. Larger values produce a
-// visible dead-air gap after the countdown bar reaches empty.
+// Long enough for the close animation; longer leaves dead air after the countdown bar empties.
 const TOAST_REMOVE_DELAY = 150;
 const toastTimeouts = new Map();
 const listeners = [];
@@ -74,7 +72,6 @@ export function toast(input) {
     };
     const update = (props) => dispatch({ type: 'UPDATE_TOAST', toast: { ...props, id } });
     const variant = input.variant ?? 'default';
-    // Persistent toasts disable auto-dismiss entirely; Radix accepts `Infinity`.
     const duration = input.persistent
         ? Infinity
         : (input.duration ?? defaultDurationForVariant(variant));

package/dist/react/hooks/use-toast.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-toast.js","sourceRoot":"","sources":["../../../src/react/hooks/use-toast.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from 'react';\n\nconst TOAST_LIMIT = 3;\n// Time between Radix flipping `open=false` and the toast actually unmounting.\n// Just long enough for the close animation to finish. Larger values produce a\n// visible dead-air gap after the countdown bar reaches empty.\nconst TOAST_REMOVE_DELAY = 150;\n\nexport type ToastVariant = 'default' | 'destructive' | 'success' | 'warning' | 'error';\n\nexport type ToasterToast = {\n  id: string;\n  title?: React.ReactNode;\n  description?: React.ReactNode;\n  action?: React.ReactNode;\n  variant?: ToastVariant;\n\n  /** Radix controlled open state */\n  open?: boolean;\n  onOpenChange?: (open: boolean) => void;\n\n  /** ms */\n  duration?: number;\n\n  /** show X button */\n  dismissible?: boolean;\n\n  /**\n   * When `true`, the toast does not auto-dismiss and renders no countdown bar.\n   * `duration` is ignored. The user must click the X (or programmatic `dismiss`)\n   * to remove it.\n   */\n  persistent?: boolean;\n};\n\ntype ToastProps = ToasterToast;\n\ntype Action =\n  | { type: 'ADD_TOAST'; toast: ToastProps }\n  | { type: 'UPDATE_TOAST'; toast: Partial<ToastProps> & { id: string } }\n  | { type: 'DISMISS_TOAST'; toastId?: string }\n  | { type: 'REMOVE_TOAST'; toastId?: string };\n\ninterface State {\n  toasts: ToastProps[];\n}\n\nconst toastTimeouts = new Map<string, ReturnType<typeof setTimeout>>();\nconst listeners: Array<(state: State) => void> = [];\n\nlet memoryState: State = { toasts: [] };\n\nconst reducer = (state: State, action: Action): State => {\n  switch (action.type) {\n    case 'ADD_TOAST':\n      return { ...state, toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT) };\n\n    case 'UPDATE_TOAST':\n      return {\n        ...state,\n        toasts: state.toasts.map((t) => (t.id === action.toast.id ? { ...t, ...action.toast } : t)),\n      };\n\n    case 'DISMISS_TOAST': {\n      const { toastId } = action;\n\n      if (toastId) {\n        return {\n          ...state,\n          toasts: state.toasts.map((t) => (t.id === toastId ? { ...t, open: false } : t)),\n        };\n      }\n\n      return { ...state, toasts: state.toasts.map((t) => ({ ...t, open: false })) };\n    }\n\n    case 'REMOVE_TOAST': {\n      const { toastId } = action;\n      if (!toastId) return { ...state, toasts: [] };\n      return { ...state, toasts: state.toasts.filter((t) => t.id !== toastId) };\n    }\n\n    default:\n      return state;\n  }\n};\n\nfunction dispatch(action: Action) {\n  memoryState = reducer(memoryState, action);\n  listeners.forEach((listener) => listener(memoryState));\n}\n\nfunction genId() {\n  return Math.random().toString(36).slice(2, 10);\n}\n\nfunction addToRemoveQueue(toastId: string) {\n  if (toastTimeouts.has(toastId)) return;\n\n  const timeout = setTimeout(() => {\n    toastTimeouts.delete(toastId);\n    dispatch({ type: 'REMOVE_TOAST', toastId });\n  }, TOAST_REMOVE_DELAY);\n\n  toastTimeouts.set(toastId, timeout);\n}\n\nfunction defaultDurationForVariant(variant: ToastVariant | undefined): number {\n  switch (variant) {\n    case 'success':\n      return 3000;\n    case 'destructive':\n    case 'error':\n      return 6000;\n    case 'warning':\n      return 5000;\n    case 'default':\n    default:\n      return 4000;\n  }\n}\n\nexport function toast(input: Omit<ToastProps, 'id'>) {\n  const id = genId();\n\n  const dismiss = () => {\n    dispatch({ type: 'DISMISS_TOAST', toastId: id });\n    addToRemoveQueue(id);\n  };\n\n  const update = (props: Partial<ToastProps>) =>\n    dispatch({ type: 'UPDATE_TOAST', toast: { ...props, id } });\n\n  const variant = input.variant ?? 'default';\n  // Persistent toasts disable auto-dismiss entirely; Radix accepts `Infinity`.\n  const duration = input.persistent\n    ? Infinity\n    : (input.duration ?? defaultDurationForVariant(variant));\n\n  dispatch({\n    type: 'ADD_TOAST',\n    toast: {\n      id,\n      open: true,\n      onOpenChange: (open) => {\n        if (!open) dismiss();\n      },\n      dismissible: true,\n      ...input,\n      variant,\n      duration,\n    },\n  });\n\n  return { id, dismiss, update };\n}\n\nexport function useToast() {\n  const [state, setState] = React.useState<State>(memoryState);\n\n  React.useEffect(() => {\n    listeners.push(setState);\n    return () => {\n      const index = listeners.indexOf(setState);\n      if (index > -1) listeners.splice(index, 1);\n    };\n  }, []);\n\n  return {\n    ...state,\n    toast,\n    dismiss: (toastId?: string) => {\n      dispatch({ type: 'DISMISS_TOAST', toastId });\n      if (toastId) addToRemoveQueue(toastId);\n    },\n  };\n}\n"]}
+{"version":3,"file":"use-toast.js","sourceRoot":"","sources":["../../../src/react/hooks/use-toast.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from 'react';\n\nconst TOAST_LIMIT = 3;\n// Long enough for the close animation; longer leaves dead air after the countdown bar empties.\nconst TOAST_REMOVE_DELAY = 150;\n\nexport type ToastVariant = 'default' | 'destructive' | 'success' | 'warning' | 'error';\n\nexport type ToasterToast = {\n  id: string;\n  title?: React.ReactNode;\n  description?: React.ReactNode;\n  action?: React.ReactNode;\n  variant?: ToastVariant;\n\n  open?: boolean;\n  onOpenChange?: (open: boolean) => void;\n\n  duration?: number;\n\n  dismissible?: boolean;\n\n  persistent?: boolean;\n};\n\ntype ToastProps = ToasterToast;\n\ntype Action =\n  | { type: 'ADD_TOAST'; toast: ToastProps }\n  | { type: 'UPDATE_TOAST'; toast: Partial<ToastProps> & { id: string } }\n  | { type: 'DISMISS_TOAST'; toastId?: string }\n  | { type: 'REMOVE_TOAST'; toastId?: string };\n\ninterface State {\n  toasts: ToastProps[];\n}\n\nconst toastTimeouts = new Map<string, ReturnType<typeof setTimeout>>();\nconst listeners: Array<(state: State) => void> = [];\n\nlet memoryState: State = { toasts: [] };\n\nconst reducer = (state: State, action: Action): State => {\n  switch (action.type) {\n    case 'ADD_TOAST':\n      return { ...state, toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT) };\n\n    case 'UPDATE_TOAST':\n      return {\n        ...state,\n        toasts: state.toasts.map((t) => (t.id === action.toast.id ? { ...t, ...action.toast } : t)),\n      };\n\n    case 'DISMISS_TOAST': {\n      const { toastId } = action;\n\n      if (toastId) {\n        return {\n          ...state,\n          toasts: state.toasts.map((t) => (t.id === toastId ? { ...t, open: false } : t)),\n        };\n      }\n\n      return { ...state, toasts: state.toasts.map((t) => ({ ...t, open: false })) };\n    }\n\n    case 'REMOVE_TOAST': {\n      const { toastId } = action;\n      if (!toastId) return { ...state, toasts: [] };\n      return { ...state, toasts: state.toasts.filter((t) => t.id !== toastId) };\n    }\n\n    default:\n      return state;\n  }\n};\n\nfunction dispatch(action: Action) {\n  memoryState = reducer(memoryState, action);\n  listeners.forEach((listener) => listener(memoryState));\n}\n\nfunction genId() {\n  return Math.random().toString(36).slice(2, 10);\n}\n\nfunction addToRemoveQueue(toastId: string) {\n  if (toastTimeouts.has(toastId)) return;\n\n  const timeout = setTimeout(() => {\n    toastTimeouts.delete(toastId);\n    dispatch({ type: 'REMOVE_TOAST', toastId });\n  }, TOAST_REMOVE_DELAY);\n\n  toastTimeouts.set(toastId, timeout);\n}\n\nfunction defaultDurationForVariant(variant: ToastVariant | undefined): number {\n  switch (variant) {\n    case 'success':\n      return 3000;\n    case 'destructive':\n    case 'error':\n      return 6000;\n    case 'warning':\n      return 5000;\n    case 'default':\n    default:\n      return 4000;\n  }\n}\n\nexport function toast(input: Omit<ToastProps, 'id'>) {\n  const id = genId();\n\n  const dismiss = () => {\n    dispatch({ type: 'DISMISS_TOAST', toastId: id });\n    addToRemoveQueue(id);\n  };\n\n  const update = (props: Partial<ToastProps>) =>\n    dispatch({ type: 'UPDATE_TOAST', toast: { ...props, id } });\n\n  const variant = input.variant ?? 'default';\n  const duration = input.persistent\n    ? Infinity\n    : (input.duration ?? defaultDurationForVariant(variant));\n\n  dispatch({\n    type: 'ADD_TOAST',\n    toast: {\n      id,\n      open: true,\n      onOpenChange: (open) => {\n        if (!open) dismiss();\n      },\n      dismissible: true,\n      ...input,\n      variant,\n      duration,\n    },\n  });\n\n  return { id, dismiss, update };\n}\n\nexport function useToast() {\n  const [state, setState] = React.useState<State>(memoryState);\n\n  React.useEffect(() => {\n    listeners.push(setState);\n    return () => {\n      const index = listeners.indexOf(setState);\n      if (index > -1) listeners.splice(index, 1);\n    };\n  }, []);\n\n  return {\n    ...state,\n    toast,\n    dismiss: (toastId?: string) => {\n      dispatch({ type: 'DISMISS_TOAST', toastId });\n      if (toastId) addToRemoveQueue(toastId);\n    },\n  };\n}\n"]}

package/dist/react/index.d.ts.map

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

package/dist/react/index.js

@@ -39,20 +39,14 @@ export { ConsequenceDialog } from './components/consequence-dialog.js';
 export { ScreenAdaptiveView } from './components/layout/screen-adaptive-view.js';
 export { useMediaQuery } from './hooks/use-media-query.js';
 export { useAsyncAction } from './hooks/use-async-action.js';
-// Shared building blocks
 export { RelativeTime } from './components/relative-time.js';
 export { EndOfListIndicator } from './components/end-of-list-indicator.js';
 export { ScrollToTopButton } from './components/scroll-to-top-button.js';
 export { ActionRow } from './components/action-row.js';
 export { ShowMoreToggle } from './components/show-more-toggle.js';
 export { ReloadRecoveryNotice } from './components/reload-recovery-notice.js';
-// List pagination — the one Previous / counter / Next control plus the page-state
-// hooks for its two flavors (known total, and cursor/`hasMore`).
 export { ListPagination } from './components/list-pagination.js';
 export { usePagedList } from './hooks/use-paged-list.js';
 export { useCursorPage } from './hooks/use-cursor-page.js';
-// Return-scroll: restore a list's window offset when the user comes back to it after a
-// route change (save on leave, restore once on an eligible + ready return, keyed by the
-// caller's canonical list URL).
 export { useReturnScroll, saveReturnScroll, clearReturnScroll, readReturnScroll, } from './hooks/use-return-scroll.js';
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nexport type { ButtonProps } from './components/button.js';\nexport { Button, buttonVariants } from './components/button.js';\nexport type { SpinnerProps, SpinnerSize } from './components/spinner.js';\nexport { Spinner } from './components/spinner.js';\nexport {\n  Card,\n  CardHeader,\n  CardFooter,\n  CardTitle,\n  CardDescription,\n  CardContent,\n} from './components/card.js';\nexport { Label } from './components/label.js';\nexport type {\n  TextareaProps,\n  FreeTextTextareaProps,\n  NonFreeTextTextareaProps,\n  NonFreeTextareaEntry,\n} from './components/textarea.js';\nexport { Textarea } from './components/textarea.js';\nexport { Skeleton } from './components/skeleton.js';\nexport {\n  Dialog,\n  DialogPortal,\n  DialogOverlay,\n  DialogClose,\n  DialogTrigger,\n  DialogContent,\n  DialogHeader,\n  DialogFooter,\n  DialogTitle,\n  DialogDescription,\n} from './components/dialog.js';\nexport { Popover, PopoverTrigger, PopoverContent, PopoverAnchor } from './components/popover.js';\nexport {\n  DropdownMenu,\n  DropdownMenuTrigger,\n  DropdownMenuContent,\n  DropdownMenuItem,\n  DropdownMenuCheckboxItem,\n  DropdownMenuRadioItem,\n  DropdownMenuLabel,\n  DropdownMenuSeparator,\n  DropdownMenuShortcut,\n  DropdownMenuGroup,\n  DropdownMenuPortal,\n  DropdownMenuSub,\n  DropdownMenuSubContent,\n  DropdownMenuSubTrigger,\n  DropdownMenuRadioGroup,\n} from './components/dropdown-menu.js';\nexport {\n  Menubar,\n  MenubarMenu,\n  MenubarTrigger,\n  MenubarContent,\n  MenubarItem,\n  MenubarSeparator,\n  MenubarLabel,\n  MenubarCheckboxItem,\n  MenubarRadioGroup,\n  MenubarRadioItem,\n  MenubarPortal,\n  MenubarSubContent,\n  MenubarSubTrigger,\n  MenubarGroup,\n  MenubarSub,\n  MenubarShortcut,\n} from './components/menubar.js';\nexport {\n  AlertDialog,\n  AlertDialogPortal,\n  AlertDialogOverlay,\n  AlertDialogTrigger,\n  AlertDialogContent,\n  AlertDialogHeader,\n  AlertDialogFooter,\n  AlertDialogTitle,\n  AlertDialogDescription,\n  AlertDialogAction,\n  AlertDialogCancel,\n} from './components/alert-dialog.js';\nexport { Alert, AlertTitle, AlertDescription } from './components/alert.js';\nexport type { ToastProps, ToastActionElement } from './components/toast.js';\nexport {\n  ToastProvider,\n  ToastViewport,\n  Toast,\n  ToastTitle,\n  ToastDescription,\n  ToastClose,\n  ToastAction,\n} from './components/toast.js';\nexport { Toaster } from './components/toaster.js';\nexport type { ToastVariant, ToasterToast } from './hooks/use-toast.js';\nexport { toast, useToast } from './hooks/use-toast.js';\nexport type {\n  InputProps,\n  FreeTextInputProps,\n  NonFreeTextInputProps,\n  NonFreeTextEntry,\n  BuiltInFormatInputProps,\n  BuiltInFormatInputType,\n} from './components/input.js';\nexport { Input } from './components/input.js';\nexport {\n  Select,\n  SelectGroup,\n  SelectValue,\n  SelectTrigger,\n  SelectContent,\n  SelectLabel,\n  SelectItem,\n  SelectSeparator,\n  SelectScrollUpButton,\n  SelectScrollDownButton,\n} from './components/select.js';\nexport { Tabs, TabsList, TabsTrigger, TabsContent } from './components/tabs.js';\nexport { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from './components/tooltip.js';\nexport {\n  useFormField,\n  Form,\n  FormItem,\n  FormLabel,\n  FormControl,\n  FormDescription,\n  FormMessage,\n  FormField,\n} from './components/form.js';\nexport { Checkbox } from './components/checkbox.js';\nexport { Switch } from './components/switch.js';\nexport type { BadgeProps } from './components/badge.js';\nexport { Badge, badgeVariants } from './components/badge.js';\nexport { Avatar, AvatarImage, AvatarFallback } from './components/avatar.js';\nexport { Separator } from './components/separator.js';\nexport {\n  Accordion,\n  AccordionItem,\n  AccordionTrigger,\n  AccordionContent,\n} from './components/accordion.js';\nexport { RadioGroup, RadioGroupItem } from './components/radio-group.js';\nexport { Progress } from './components/progress.js';\nexport { Slider } from './components/slider.js';\nexport type { DatePickerProps } from './components/date-picker.js';\nexport { DatePicker } from './components/date-picker.js';\nexport type { DateTimePickerProps, DateTimePickerTime } from './components/date-time-picker.js';\nexport { DateTimePicker } from './components/date-time-picker.js';\nexport { ScrollArea, ScrollBar } from './components/scroll-area.js';\nexport {\n  Table,\n  TableHeader,\n  TableBody,\n  TableFooter,\n  TableHead,\n  SortableTableHead,\n  TableRow,\n  TableCell,\n  TableCaption,\n} from './components/table.js';\nexport type { SortableTableHeadProps, SortDirection } from './components/table.js';\nexport {\n  Sheet,\n  SheetPortal,\n  SheetOverlay,\n  SheetTrigger,\n  SheetClose,\n  SheetContent,\n  SheetHeader,\n  SheetFooter,\n  SheetTitle,\n  SheetDescription,\n} from './components/sheet.js';\nexport { Collapsible, CollapsibleTrigger, CollapsibleContent } from './components/collapsible.js';\nexport type { SearchDropdownProps } from './components/search-dropdown.js';\nexport { SearchDropdown } from './components/search-dropdown.js';\n\nexport type {\n  ConsequenceDialogProps,\n  ConsequenceDialogReason,\n  ConsequenceDialogTypedConfirmation,\n} from './components/consequence-dialog.js';\nexport { ConsequenceDialog } from './components/consequence-dialog.js';\n\nexport type {\n  MaxWidthOption,\n  ScreenAdaptiveViewProps,\n} from './components/layout/screen-adaptive-view.js';\nexport { ScreenAdaptiveView } from './components/layout/screen-adaptive-view.js';\n\nexport { useMediaQuery } from './hooks/use-media-query.js';\n\nexport { useAsyncAction } from './hooks/use-async-action.js';\nexport type { AsyncAction, UseAsyncActionOptions } from './hooks/use-async-action.js';\n\n// Shared building blocks\nexport { RelativeTime } from './components/relative-time.js';\nexport type { RelativeTimeProps } from './components/relative-time.js';\n\nexport { EndOfListIndicator } from './components/end-of-list-indicator.js';\nexport type { EndOfListIndicatorProps } from './components/end-of-list-indicator.js';\n\nexport { ScrollToTopButton } from './components/scroll-to-top-button.js';\nexport type { ScrollToTopButtonProps } from './components/scroll-to-top-button.js';\n\nexport { ActionRow } from './components/action-row.js';\nexport type {\n  ActionRowProps,\n  ActionRowButtonProps,\n  ActionRowLinkProps,\n  ActionRowLinkTargetProps,\n} from './components/action-row.js';\n\nexport { ShowMoreToggle } from './components/show-more-toggle.js';\nexport type { ShowMoreToggleProps } from './components/show-more-toggle.js';\n\nexport { ReloadRecoveryNotice } from './components/reload-recovery-notice.js';\nexport type { ReloadRecoveryNoticeProps } from './components/reload-recovery-notice.js';\n\n// List pagination — the one Previous / counter / Next control plus the page-state\n// hooks for its two flavors (known total, and cursor/`hasMore`).\nexport { ListPagination } from './components/list-pagination.js';\nexport type { ListPaginationProps } from './components/list-pagination.js';\n\nexport { usePagedList } from './hooks/use-paged-list.js';\nexport type {\n  ListPaginationState,\n  PagedList,\n  UsePagedListOptions,\n} from './hooks/use-paged-list.js';\n\nexport { useCursorPage } from './hooks/use-cursor-page.js';\nexport type { CursorPage, CursorPager, UseCursorPageOptions } from './hooks/use-cursor-page.js';\n\n// Return-scroll: restore a list's window offset when the user comes back to it after a\n// route change (save on leave, restore once on an eligible + ready return, keyed by the\n// caller's canonical list URL).\nexport {\n  useReturnScroll,\n  saveReturnScroll,\n  clearReturnScroll,\n  readReturnScroll,\n} from './hooks/use-return-scroll.js';\nexport type {\n  ReturnScrollEntry,\n  UseReturnScrollOptions,\n  UseReturnScrollResult,\n} from './hooks/use-return-scroll.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nexport type { ButtonProps } from './components/button.js';\nexport { Button, buttonVariants } from './components/button.js';\nexport type { SpinnerProps, SpinnerSize } from './components/spinner.js';\nexport { Spinner } from './components/spinner.js';\nexport {\n  Card,\n  CardHeader,\n  CardFooter,\n  CardTitle,\n  CardDescription,\n  CardContent,\n} from './components/card.js';\nexport { Label } from './components/label.js';\nexport type {\n  TextareaProps,\n  FreeTextTextareaProps,\n  NonFreeTextTextareaProps,\n  NonFreeTextareaEntry,\n} from './components/textarea.js';\nexport { Textarea } from './components/textarea.js';\nexport { Skeleton } from './components/skeleton.js';\nexport {\n  Dialog,\n  DialogPortal,\n  DialogOverlay,\n  DialogClose,\n  DialogTrigger,\n  DialogContent,\n  DialogHeader,\n  DialogFooter,\n  DialogTitle,\n  DialogDescription,\n} from './components/dialog.js';\nexport { Popover, PopoverTrigger, PopoverContent, PopoverAnchor } from './components/popover.js';\nexport {\n  DropdownMenu,\n  DropdownMenuTrigger,\n  DropdownMenuContent,\n  DropdownMenuItem,\n  DropdownMenuCheckboxItem,\n  DropdownMenuRadioItem,\n  DropdownMenuLabel,\n  DropdownMenuSeparator,\n  DropdownMenuShortcut,\n  DropdownMenuGroup,\n  DropdownMenuPortal,\n  DropdownMenuSub,\n  DropdownMenuSubContent,\n  DropdownMenuSubTrigger,\n  DropdownMenuRadioGroup,\n} from './components/dropdown-menu.js';\nexport {\n  Menubar,\n  MenubarMenu,\n  MenubarTrigger,\n  MenubarContent,\n  MenubarItem,\n  MenubarSeparator,\n  MenubarLabel,\n  MenubarCheckboxItem,\n  MenubarRadioGroup,\n  MenubarRadioItem,\n  MenubarPortal,\n  MenubarSubContent,\n  MenubarSubTrigger,\n  MenubarGroup,\n  MenubarSub,\n  MenubarShortcut,\n} from './components/menubar.js';\nexport {\n  AlertDialog,\n  AlertDialogPortal,\n  AlertDialogOverlay,\n  AlertDialogTrigger,\n  AlertDialogContent,\n  AlertDialogHeader,\n  AlertDialogFooter,\n  AlertDialogTitle,\n  AlertDialogDescription,\n  AlertDialogAction,\n  AlertDialogCancel,\n} from './components/alert-dialog.js';\nexport { Alert, AlertTitle, AlertDescription } from './components/alert.js';\nexport type { ToastProps, ToastActionElement } from './components/toast.js';\nexport {\n  ToastProvider,\n  ToastViewport,\n  Toast,\n  ToastTitle,\n  ToastDescription,\n  ToastClose,\n  ToastAction,\n} from './components/toast.js';\nexport { Toaster } from './components/toaster.js';\nexport type { ToastVariant, ToasterToast } from './hooks/use-toast.js';\nexport { toast, useToast } from './hooks/use-toast.js';\nexport type {\n  InputProps,\n  FreeTextInputProps,\n  NonFreeTextInputProps,\n  NonFreeTextEntry,\n  BuiltInFormatInputProps,\n  BuiltInFormatInputType,\n} from './components/input.js';\nexport { Input } from './components/input.js';\nexport {\n  Select,\n  SelectGroup,\n  SelectValue,\n  SelectTrigger,\n  SelectContent,\n  SelectLabel,\n  SelectItem,\n  SelectSeparator,\n  SelectScrollUpButton,\n  SelectScrollDownButton,\n} from './components/select.js';\nexport { Tabs, TabsList, TabsTrigger, TabsContent } from './components/tabs.js';\nexport { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from './components/tooltip.js';\nexport {\n  useFormField,\n  Form,\n  FormItem,\n  FormLabel,\n  FormControl,\n  FormDescription,\n  FormMessage,\n  FormField,\n} from './components/form.js';\nexport { Checkbox } from './components/checkbox.js';\nexport { Switch } from './components/switch.js';\nexport type { BadgeProps } from './components/badge.js';\nexport { Badge, badgeVariants } from './components/badge.js';\nexport { Avatar, AvatarImage, AvatarFallback } from './components/avatar.js';\nexport { Separator } from './components/separator.js';\nexport {\n  Accordion,\n  AccordionItem,\n  AccordionTrigger,\n  AccordionContent,\n} from './components/accordion.js';\nexport { RadioGroup, RadioGroupItem } from './components/radio-group.js';\nexport { Progress } from './components/progress.js';\nexport { Slider } from './components/slider.js';\nexport type { DatePickerProps } from './components/date-picker.js';\nexport { DatePicker } from './components/date-picker.js';\nexport type { DateTimePickerProps, DateTimePickerTime } from './components/date-time-picker.js';\nexport { DateTimePicker } from './components/date-time-picker.js';\nexport { ScrollArea, ScrollBar } from './components/scroll-area.js';\nexport {\n  Table,\n  TableHeader,\n  TableBody,\n  TableFooter,\n  TableHead,\n  SortableTableHead,\n  TableRow,\n  TableCell,\n  TableCaption,\n} from './components/table.js';\nexport type { SortableTableHeadProps, SortDirection } from './components/table.js';\nexport {\n  Sheet,\n  SheetPortal,\n  SheetOverlay,\n  SheetTrigger,\n  SheetClose,\n  SheetContent,\n  SheetHeader,\n  SheetFooter,\n  SheetTitle,\n  SheetDescription,\n} from './components/sheet.js';\nexport { Collapsible, CollapsibleTrigger, CollapsibleContent } from './components/collapsible.js';\nexport type { SearchDropdownProps } from './components/search-dropdown.js';\nexport { SearchDropdown } from './components/search-dropdown.js';\n\nexport type {\n  ConsequenceDialogProps,\n  ConsequenceDialogReason,\n  ConsequenceDialogTypedConfirmation,\n} from './components/consequence-dialog.js';\nexport { ConsequenceDialog } from './components/consequence-dialog.js';\n\nexport type {\n  MaxWidthOption,\n  ScreenAdaptiveViewProps,\n} from './components/layout/screen-adaptive-view.js';\nexport { ScreenAdaptiveView } from './components/layout/screen-adaptive-view.js';\n\nexport { useMediaQuery } from './hooks/use-media-query.js';\n\nexport { useAsyncAction } from './hooks/use-async-action.js';\nexport type { AsyncAction, UseAsyncActionOptions } from './hooks/use-async-action.js';\n\nexport { RelativeTime } from './components/relative-time.js';\nexport type { RelativeTimeProps } from './components/relative-time.js';\n\nexport { EndOfListIndicator } from './components/end-of-list-indicator.js';\nexport type { EndOfListIndicatorProps } from './components/end-of-list-indicator.js';\n\nexport { ScrollToTopButton } from './components/scroll-to-top-button.js';\nexport type { ScrollToTopButtonProps } from './components/scroll-to-top-button.js';\n\nexport { ActionRow } from './components/action-row.js';\nexport type {\n  ActionRowProps,\n  ActionRowButtonProps,\n  ActionRowLinkProps,\n  ActionRowLinkTargetProps,\n} from './components/action-row.js';\n\nexport { ShowMoreToggle } from './components/show-more-toggle.js';\nexport type { ShowMoreToggleProps } from './components/show-more-toggle.js';\n\nexport { ReloadRecoveryNotice } from './components/reload-recovery-notice.js';\nexport type { ReloadRecoveryNoticeProps } from './components/reload-recovery-notice.js';\n\nexport { ListPagination } from './components/list-pagination.js';\nexport type { ListPaginationProps } from './components/list-pagination.js';\n\nexport { usePagedList } from './hooks/use-paged-list.js';\nexport type {\n  ListPaginationState,\n  PagedList,\n  UsePagedListOptions,\n} from './hooks/use-paged-list.js';\n\nexport { useCursorPage } from './hooks/use-cursor-page.js';\nexport type { CursorPage, CursorPager, UseCursorPageOptions } from './hooks/use-cursor-page.js';\n\nexport {\n  useReturnScroll,\n  saveReturnScroll,\n  clearReturnScroll,\n  readReturnScroll,\n} from './hooks/use-return-scroll.js';\nexport type {\n  ReturnScrollEntry,\n  UseReturnScrollOptions,\n  UseReturnScrollResult,\n} from './hooks/use-return-scroll.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/ui-core",
-  "version": "0.11.34",
+  "version": "0.11.36",
   "description": "Shared UI components for TTT Productions projects",
   "repository": {
     "type": "git",
@@ -53,7 +53,7 @@
     "react-dom": ">=19.0.0",
     "react-hook-form": ">=7.0.0",
     "@hookform/resolvers": ">=3.0.0",
-    "@ttt-productions/firebase-helpers": "^0.12.13",
+    "@ttt-productions/firebase-helpers": "^0.12.17",
     "lucide-react": "^1.30.0",
     "date-fns": ">=3.0.0"
   },
@@ -95,7 +95,7 @@
     "@radix-ui/react-tabs": "^1.1.13",
     "@radix-ui/react-toast": "^1.2.15",
     "@radix-ui/react-tooltip": "^1.2.8",
-    "@ttt-productions/input-format-core": "^0.1.2",
+    "@ttt-productions/input-format-core": "^0.1.3",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.1.1",
     "tailwind-merge": "^3.6.0"
@@ -107,7 +107,7 @@
     "react-dom": "^19.2.0",
     "react-hook-form": "^7.69.0",
     "@hookform/resolvers": "^5.2.2",
-    "@ttt-productions/firebase-helpers": "^0.12.13",
+    "@ttt-productions/firebase-helpers": "^0.12.17",
     "lucide-react": "^1.30.0",
     "date-fns": "^4.1.0"
   },