@eifi1/ui-kit 0.33.1 → 0.35.0

package/dist/components/use-table-state.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/use-table-state.ts"],"sourcesContent":["import { useEffect, useMemo, useRef, useState } from \"react\";\nimport { useLocation, useSearchParams } from \"react-router\";\nimport { readStored, writeStored } from \"../lib/safe-storage\";\nimport {\n  decodeFilterValue,\n  encodeFilterValue,\n  isFilterActive,\n  resolveFilter,\n} from \"./data-table-filters\";\nimport { decodeSorts, encodeSorts, normalizeSorts, type SortState } from \"./data-table-sort\";\nimport type { DataTableColumn, FilterState, ServerPagination } from \"./data-table\";\n\n// ---------- Persisted + URL-encoded view state ----------\n//\n// Moved here with `useTableState` when `DataTable` was split: these are what the hook\n// reads and writes, and nothing else in the table ever called them.\n\ninterface PersistedState {\n  // Multi-sort array; blobs from before the upgrade hold a single {key, dir}\n  // object (or null) — read back through normalizeSorts.\n  sort: SortState[] | { key: string; dir: string } | null;\n  filters: FilterState;\n  pageSize: number | \"all\";\n  widths?: Record<string, number>;\n  hidden?: string[];\n}\n\nexport const DEFAULT_PERSIST_PREFIX = \"hbui-table:\";\n\nfunction loadPersisted(storageKey: string | undefined, prefix: string): Partial<PersistedState> {\n  if (!storageKey) return {};\n  const raw = readStored(prefix + storageKey);\n  if (!raw) return {};\n  try {\n    const parsed = JSON.parse(raw) as Partial<PersistedState>;\n    return parsed && typeof parsed === \"object\" ? parsed : {};\n  } catch {\n    return {}; // corrupt JSON — the storage access itself is guarded by readStored\n  }\n}\n\n/** The blob that would be stored — also the value the effect below compares by, so\n *  the comparison and the write can never disagree about what \"unchanged\" means. */\nfunction serializePersisted(state: PersistedState): string {\n  return JSON.stringify(state);\n}\n\n// ---------- URL sync helpers ----------\n\nconst URL_FILTER_PREFIX = \"f.\";\nconst URL_SORT_KEY = \"sort\";\nconst URL_PAGE_KEY = \"p\";\nconst URL_PAGE_SIZE_KEY = \"ps\";\n/** The free-text search term — managed only by {@link useTableUrlState}, and only when\n *  it is asked to (`search: true`); a plain `urlSync` table leaves a `q` alone. */\nconst URL_SEARCH_KEY = \"q\";\n\n/**\n * How a table is mirrored into the URL: `true`, or `{ prefix }` for a table that shares\n * its page with another URL-synced one. The prefix is put verbatim in front of EVERY key\n * the table writes and reads — `{ prefix: \"inv.\" }` gives `inv.f.<column>`, `inv.sort`,\n * `inv.p`, `inv.ps` (and `inv.q`) — so two tables on one page stop sharing a sort and a\n * page. Without one the keys are unprefixed, as they always were.\n */\nexport type TableUrlSync = boolean | { prefix?: string };\n\n/** The query keys of one table, with its prefix applied. */\ninterface UrlKeys {\n  filter: string;\n  sort: string;\n  page: string;\n  pageSize: string;\n  search: string;\n}\n\nfunction urlKeys(prefix = \"\"): UrlKeys {\n  return {\n    filter: prefix + URL_FILTER_PREFIX,\n    sort: prefix + URL_SORT_KEY,\n    page: prefix + URL_PAGE_KEY,\n    pageSize: prefix + URL_PAGE_SIZE_KEY,\n    search: prefix + URL_SEARCH_KEY,\n  };\n}\n\n/** `urlSync` split into \"is it on\" and \"under which prefix\". */\nfunction resolveTableUrlSync(urlSync: TableUrlSync | undefined): { enabled: boolean; prefix: string } {\n  if (!urlSync) return { enabled: false, prefix: \"\" };\n  return { enabled: true, prefix: urlSync === true ? \"\" : (urlSync.prefix ?? \"\") };\n}\n\n/** What {@link readTableUrlState} found in a query string. */\nexport interface TableUrlState {\n  sorts?: SortState[];\n  filters?: FilterState;\n  /** `Infinity` for `ps=all`. */\n  pageSize?: number;\n  /** 0-based (the URL's `p` is 1-based). */\n  page?: number;\n}\n\n/**\n * What a table's URL says, read out of a query string: the column filters (`f.<key>`),\n * the sort, the page size and the 0-based page. Absent keys are absent here too, so a\n * caller can tell \"not in the link\" from \"the default\". The same reader `urlSync` uses\n * on mount, exported for an owner that keeps the state itself — see\n * {@link useTableUrlState}.\n *\n * Pass the ROUTER's query string — the one `setSearchParams` writes — and the table's\n * `prefix` when it has one (see {@link TableUrlSync}).\n *\n * This read `window.location.search` until 0.7.0, which is the same string only under a\n * BrowserRouter. Under a HashRouter the router's query lives after the `#`\n * (`/#/tx?f.payee=Rewe`) and `window.location.search` is empty: a shared link opened\n * unfiltered, and the table's first write then replaced the link's filter with its own\n * empty state. Reading and writing through `useSearchParams` is one source for both\n * directions under every router, MemoryRouter included.\n */\nexport function readTableUrlState<T>(\n  sp: URLSearchParams,\n  columns: DataTableColumn<T>[],\n  prefix?: string,\n): TableUrlState {\n  const keys = urlKeys(prefix);\n  const out: TableUrlState = {};\n\n  const filters: FilterState = {};\n  for (const col of columns) {\n    const filter = resolveFilter(col);\n    if (!filter) continue;\n    const raw = sp.get(keys.filter + col.key);\n    if (raw == null) continue;\n    filters[col.key] = decodeFilterValue(filter, raw);\n  }\n  if (Object.keys(filters).length) out.filters = filters;\n\n  const sortRaw = sp.get(keys.sort);\n  if (sortRaw) {\n    const decoded = decodeSorts(sortRaw, new Set(columns.map((c) => c.key)));\n    if (decoded.length) out.sorts = decoded;\n  }\n\n  const psRaw = sp.get(keys.pageSize);\n  if (psRaw === \"all\") out.pageSize = Infinity;\n  else if (psRaw && Number(psRaw) > 0) out.pageSize = Number(psRaw);\n\n  const pRaw = sp.get(keys.page);\n  if (pRaw && Number(pRaw) >= 1) out.page = Number(pRaw) - 1;\n\n  return out;\n}\n\n/**\n * The managed part of the query string, as a string, for comparing by VALUE.\n *\n * Everything the table puts in the address and nothing else, in a fixed order.\n * `columns` is walked for its keys only, which is why it can be left out of the\n * effect's dependencies without lying: a new column ARRAY carrying the same keys\n * produces the same signature, and a genuinely different set of filterable columns\n * produces a different one.\n */\nfunction urlSignature<T>(\n  columns: DataTableColumn<T>[],\n  sorts: SortState[],\n  filters: FilterState,\n  pageSize: number,\n  page: number,\n  defaultPageSize: number,\n  keys: UrlKeys,\n): string {\n  const parts: string[] = [];\n  for (const col of columns) {\n    const state = filters[col.key];\n    if (!state || !isFilterActive(state)) continue;\n    const enc = encodeFilterValue(state);\n    if (enc != null) parts.push(`${keys.filter}${col.key}=${enc}`);\n  }\n  parts.push(`${keys.sort}=${encodeSorts(sorts)}`);\n  parts.push(\n    `${keys.pageSize}=${\n      pageSize === Infinity ? \"all\" : pageSize === defaultPageSize ? \"\" : String(pageSize)\n    }`,\n  );\n  parts.push(`${keys.page}=${page > 0 ? String(page + 1) : \"\"}`);\n  return parts.join(\"&\");\n}\n\nfunction writeUrlState<T>(\n  setSearchParams: ReturnType<typeof useSearchParams>[1],\n  columns: DataTableColumn<T>[],\n  sorts: SortState[],\n  filters: FilterState,\n  pageSize: number,\n  page: number,\n  defaultPageSize: number,\n  // `undefined`: the search term is not ours to manage, and a `q` is left as it is.\n  search: string | undefined,\n  // The current entry's route state, carried over the replace. A query rewrite is not\n  // a navigation, and dropping the state would, for one, lose the mark a URL-bound\n  // dialog's opener leaves there (see useDialogParam).\n  state: unknown,\n  keys: UrlKeys,\n): void {\n  setSearchParams(\n    (prev) => {\n      const next = new URLSearchParams(prev);\n      // clear managed keys\n      for (const col of columns) next.delete(keys.filter + col.key);\n      next.delete(keys.sort);\n      next.delete(keys.page);\n      next.delete(keys.pageSize);\n      if (search !== undefined) {\n        next.delete(keys.search);\n        if (search.trim()) next.set(keys.search, search);\n      }\n      // write filters\n      for (const col of columns) {\n        const state = filters[col.key];\n        if (!state || !isFilterActive(state)) continue;\n        const enc = encodeFilterValue(state);\n        if (enc != null) next.set(keys.filter + col.key, enc);\n      }\n      // write sort\n      const sortEnc = encodeSorts(sorts);\n      if (sortEnc) next.set(keys.sort, sortEnc);\n      // write page size if non-default\n      if (pageSize === Infinity) next.set(keys.pageSize, \"all\");\n      else if (pageSize !== defaultPageSize) next.set(keys.pageSize, String(pageSize));\n      // write page if not first\n      if (page > 0) next.set(keys.page, String(page + 1));\n      return next;\n    },\n    { replace: true, state },\n  );\n}\n\n/**\n * Where a table's view lives: what it is sorted and filtered by, which page, how wide\n * the columns are and which are hidden — plus the two places that outlives a render.\n *\n * Lifted out of `DataTable`, which was 984 lines and twenty hooks in one function. This\n * is the part that is genuinely about STATE rather than about drawing, and the three\n * rules it encodes are easy to lose among the markup:\n *\n * * **The URL is read once, on mount.** A shared or deep link populates the initial view;\n *   after that the state is local, or the browser's own history would fight the user's\n *   next click.\n * * **Sorting and filtering are optionally CONTROLLED.** A server-driven table passes\n *   state and a callback and owns them; everything else is self-owned. That is the\n *   `sortsProp ?? internalSorts` pair, and it is why the setters are exposed separately.\n * * **Persistence writes on every change, the URL only when asked.** `storageKey` is the\n *   per-table identity; `urlSync` is opt-in because only some tables want their view in\n *   a shareable address.\n * * **A controlled filter or sort that changes sends the table back to page 1.** See\n *   the note at the reset below.\n */\nexport function useTableState<T>({\n  columns,\n  storageKey,\n  storageKeyPrefix,\n  urlSync: urlSyncOption,\n  defaultPageSize,\n  sortsProp,\n  filtersProp,\n}: {\n  columns: DataTableColumn<T>[];\n  storageKey?: string;\n  storageKeyPrefix: string;\n  urlSync?: TableUrlSync;\n  defaultPageSize: number;\n  sortsProp?: SortState[];\n  filtersProp?: FilterState;\n}) {\n  const { enabled: urlSync, prefix: urlPrefix } = resolveTableUrlSync(urlSyncOption);\n  const keys = useMemo(() => urlKeys(urlPrefix), [urlPrefix]);\n  // Called unconditionally (a Router is required either way — see src/data-table.ts),\n  // and the SAME pair is used to read and to write; see `readTableUrlState`.\n  const [searchParams, setSearchParams] = useSearchParams();\n  const location = useLocation();\n  // Read URL once on mount so URL-encoded views (e.g. shared links, deep links from\n  // other pages) populate initial state. After mount, state is local.\n  const [urlInitial] = useState<TableUrlState>(() =>\n    urlSync ? readTableUrlState(searchParams, columns, urlPrefix) : {},\n  );\n  const initial = useMemo(\n    () => loadPersisted(storageKey, storageKeyPrefix),\n    [storageKey, storageKeyPrefix],\n  );\n  const [internalSorts, setInternalSorts] = useState<SortState[]>(() =>\n    urlInitial.sorts !== undefined ? urlInitial.sorts : normalizeSorts(initial.sort),\n  );\n  const [internalFilters, setInternalFilters] = useState<FilterState>(\n    () => urlInitial.filters ?? initial.filters ?? {},\n  );\n  // Controlled when the owner passes state + callback (server-driven tables);\n  // self-owned otherwise.\n  const sorts = sortsProp ?? internalSorts;\n  const filters = filtersProp ?? internalFilters;\n  const [page, setPage] = useState(() => urlInitial.page ?? 0);\n\n  // ---- Controlled filters/sorts reset the page ----\n  //\n  // A self-owned table resets to page 1 in the filter handlers. A CONTROLLED one could\n  // not: the handlers hand the change to the owner and return, and `page` lives here,\n  // where the owner has no way to reach it — so narrowing a filter from outside (a\n  // saved view, a chip dismissed above the table) left a client-side table on page 4\n  // of what was now two pages, clamped to the last one instead of the first.\n  //\n  // So the table does it: whenever the controlled VALUE changes, back to the first\n  // page. Compared by value, because a controlled prop is a fresh object on every\n  // parent render. Adjusted during render rather than in an effect, so the stale page\n  // is never painted and never written to the URL. Not on mount: a deep link's `p=3`\n  // must survive the owner's first render. (In `serverPagination` mode this state is\n  // unused — the owner's `page` is the page, and resetting it stays the owner's job.)\n  const controlledSig =\n    sortsProp !== undefined || filtersProp !== undefined\n      ? JSON.stringify([sortsProp ?? null, filtersProp ?? null])\n      : null;\n  const [seenControlledSig, setSeenControlledSig] = useState(controlledSig);\n  if (seenControlledSig !== controlledSig) {\n    setSeenControlledSig(controlledSig);\n    setPage(0);\n  }\n  const [pageSize, setPageSize] = useState<number>(() => {\n    if (urlInitial.pageSize !== undefined) return urlInitial.pageSize;\n    if (initial.pageSize === \"all\") return Infinity;\n    if (typeof initial.pageSize === \"number\" && initial.pageSize > 0) return initial.pageSize;\n    return defaultPageSize;\n  });\n  const [widths, setWidths] = useState<Record<string, number>>(() => initial.widths ?? {});\n  const [hiddenCols, setHiddenCols] = useState<Set<string>>(() => new Set(initial.hidden ?? []));\n  const [showSettings, setShowSettings] = useState(false);\n  const headRefs = useMemo(() => new Map<string, HTMLTableCellElement>(), []);\n\n  // ---- Writing out: both of these compare by VALUE ----\n  //\n  // A CONTROLLED table (`sorts`/`filters` props plus callbacks — every server-driven\n  // one) receives a freshly-built object on every render of the page around it, and\n  // `{}` is never `===` the `{}` before it. Keyed on identity, both effects below\n  // therefore fired on every unrelated parent render: persistence wrote the same JSON\n  // into `localStorage` each time — a synchronous main-thread write, on a page whose\n  // other half may be a form being typed into — and the URL one handed react-router a\n  // `replace` it answers with a render, which is the loop the audit records. A `ref`\n  // holding what was last written is what makes \"changed\" mean changed.\n  const lastPersisted = useRef<string | null>(null);\n  const persisted = !storageKey\n    ? \"\"\n    : serializePersisted({\n        sort: sorts,\n        filters,\n        pageSize: pageSize === Infinity ? \"all\" : pageSize,\n        widths,\n        hidden: Array.from(hiddenCols),\n      });\n  useEffect(() => {\n    if (!storageKey) return;\n    // The destination is part of the signature: two tables can hold identical state,\n    // and a table that swaps `storageKey` has to write under the new one even though\n    // nothing about the view changed.\n    const target = storageKeyPrefix + storageKey;\n    const sig = `${target}\\u0000${persisted}`;\n    if (lastPersisted.current === sig) return;\n    lastPersisted.current = sig;\n    writeStored(target, persisted);\n  }, [storageKey, storageKeyPrefix, persisted]);\n\n  const lastUrl = useRef<string | null>(null);\n  const urlSig = urlSync\n    ? urlSignature(columns, sorts, filters, pageSize, page, defaultPageSize, keys)\n    : \"\";\n  useEffect(() => {\n    if (!urlSync) return;\n    if (lastUrl.current === urlSig) return;\n    lastUrl.current = urlSig;\n    // `columns` is deliberately not a dependency and does not need to be: the\n    // signature above is computed from it, so a column set that would produce a\n    // different address produces a different signature first.\n    writeUrlState(setSearchParams, columns, sorts, filters, pageSize, page, defaultPageSize, undefined, location.state, keys);\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [urlSync, urlSig]);\n\n  return {\n    sorts,\n    filters,\n    setInternalSorts,\n    setInternalFilters,\n    page,\n    setPage,\n    pageSize,\n    setPageSize,\n    widths,\n    setWidths,\n    hiddenCols,\n    setHiddenCols,\n    showSettings,\n    setShowSettings,\n    headRefs,\n  };\n}\n\n// ---------- Owner-held table state, mirrored to the URL ----------\n\nexport interface UseTableUrlStateOptions<T> {\n  /** The table's columns — read for their keys and filter types only. */\n  columns: DataTableColumn<T>[];\n  /** Default 25. A page size equal to it is left out of the URL. */\n  defaultPageSize?: number;\n  /** Mirror the state into the URL and seed it from there on mount. Default true.\n   *  `{ prefix }` puts a prefix in front of every key, for a page with two URL-synced\n   *  tables — see {@link TableUrlSync}. */\n  urlSync?: TableUrlSync;\n  /** Shorthand for `urlSync: { prefix }`; wins over a prefix given there. */\n  urlPrefix?: string;\n  /** Also hold a free-text search term, under `q`. Off by default, so a `q` that\n   *  belongs to someone else on the page is never touched. */\n  search?: boolean;\n}\n\n/** The part of {@link DataTableProps} a server-driven table takes from its owner. */\nexport interface TableUrlStateProps {\n  serverPagination: ServerPagination;\n  filters: FilterState;\n  onFiltersChange: (next: FilterState) => void;\n  sorts: SortState[];\n  onSortsChange: (next: SortState[]) => void;\n}\n\nexport interface UseTableUrlStateReturn {\n  /** 0-based. */\n  page: number;\n  setPage: (page: number) => void;\n  pageSize: number;\n  /** Also back to the first page. */\n  setPageSize: (pageSize: number) => void;\n  filters: FilterState;\n  /** Also back to the first page. */\n  setFilters: (next: FilterState) => void;\n  sorts: SortState[];\n  /** Also back to the first page. */\n  setSorts: (next: SortState[]) => void;\n  /** The search term (`\"\"` unless `search: true`). */\n  search: string;\n  /** Also back to the first page. */\n  setSearch: (next: string) => void;\n  /**\n   * Everything the table needs, to spread onto it:\n   * `<DataTable {...table.tableProps(data?.total ?? 0, { isLoading })} rows={…} … />`.\n   */\n  tableProps: (total: number, options?: { isLoading?: boolean }) => TableUrlStateProps;\n}\n\ninterface OwnedState {\n  sorts: SortState[];\n  filters: FilterState;\n  pageSize: number;\n  page: number;\n  search: string;\n}\n\n/**\n * The controlled state of a `serverPagination` table — filters, sorts, page, page size\n * and optionally a search term — kept by the OWNER and mirrored into the URL in the\n * table's own scheme (`f.<key>`, `sort`, `p`, `ps`, and `q`).\n *\n * A server-driven table owns none of this: the owner has to hold it to turn it into\n * the query that fetches `rows`, and until now it also had to restate the table's URL\n * codec to keep the view bookmarkable (kastlan's use-server-table.ts copied\n * `readUrlState` / `writeUrlState` to do it). Same rules as `urlSync`:\n *\n * * **The URL is read once, on mount** — a shared or deep link (see {@link filterHref})\n *   seeds the view; after that the state is local and written out with `replace`.\n * * **Any change but the page itself goes back to page 1** — a narrower filter must not\n *   leave the user on page 7 of 2.\n * * **Written by value**: an unchanged view writes nothing, however often the owner\n *   renders.\n *\n * Mapping the state onto the backend's query parameters stays the owner's: that is the\n * part the kit cannot know.\n */\nexport function useTableUrlState<T>({\n  columns,\n  defaultPageSize = 25,\n  urlSync: urlSyncOption = true,\n  urlPrefix: urlPrefixOption,\n  search: manageSearch = false,\n}: UseTableUrlStateOptions<T>): UseTableUrlStateReturn {\n  const resolved = resolveTableUrlSync(urlSyncOption);\n  const urlSync = resolved.enabled;\n  const urlPrefix = urlPrefixOption ?? resolved.prefix;\n  const keys = useMemo(() => urlKeys(urlPrefix), [urlPrefix]);\n  const [searchParams, setSearchParams] = useSearchParams();\n  const location = useLocation();\n  const [state, setState] = useState<OwnedState>(() => {\n    const url = urlSync ? readTableUrlState(searchParams, columns, urlPrefix) : {};\n    return {\n      sorts: url.sorts ?? [],\n      filters: url.filters ?? {},\n      pageSize: url.pageSize ?? defaultPageSize,\n      page: url.page ?? 0,\n      search: urlSync && manageSearch ? (searchParams.get(keys.search) ?? \"\") : \"\",\n    };\n  });\n\n  const lastUrl = useRef<string | null>(null);\n  const urlSig = urlSync\n    ? urlSignature(columns, state.sorts, state.filters, state.pageSize, state.page, defaultPageSize, keys) +\n      (manageSearch ? `&${keys.search}=${state.search.trim() ? state.search : \"\"}` : \"\")\n    : \"\";\n  useEffect(() => {\n    if (!urlSync) return;\n    // First run included: a link that arrives with `p=1` or a default `ps` is\n    // normalised to the table's own spelling, as `urlSync` does.\n    if (lastUrl.current === urlSig) return;\n    lastUrl.current = urlSig;\n    writeUrlState(\n      setSearchParams,\n      columns,\n      state.sorts,\n      state.filters,\n      state.pageSize,\n      state.page,\n      defaultPageSize,\n      manageSearch ? state.search : undefined,\n      location.state,\n      keys,\n    );\n    // Keyed on the signature, which is computed from everything the write reads — see\n    // the same effect in useTableState.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [urlSync, urlSig]);\n\n  const setPage = (page: number) => setState((s) => ({ ...s, page }));\n  const setPageSize = (pageSize: number) => setState((s) => ({ ...s, pageSize, page: 0 }));\n  const setFilters = (filters: FilterState) => setState((s) => ({ ...s, filters, page: 0 }));\n  const setSorts = (sorts: SortState[]) => setState((s) => ({ ...s, sorts, page: 0 }));\n  const setSearch = (search: string) => setState((s) => ({ ...s, search, page: 0 }));\n\n  return {\n    page: state.page,\n    setPage,\n    pageSize: state.pageSize,\n    setPageSize,\n    filters: state.filters,\n    setFilters,\n    sorts: state.sorts,\n    setSorts,\n    search: state.search,\n    setSearch,\n    tableProps: (total, options) => ({\n      serverPagination: {\n        page: state.page,\n        pageSize: state.pageSize,\n        total,\n        onPageChange: setPage,\n        onPageSizeChange: setPageSize,\n        isLoading: options?.isLoading,\n      },\n      filters: state.filters,\n      onFiltersChange: setFilters,\n      sorts: state.sorts,\n      onSortsChange: setSorts,\n    }),\n  };\n}\n"],"mappings":";AAAA,SAAS,WAAW,SAAS,QAAQ,gBAAgB;AACrD,SAAS,aAAa,uBAAuB;AAC7C,SAAS,YAAY,mBAAmB;AACxC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,aAAa,aAAa,sBAAsC;AAkBlE,MAAM,yBAAyB;AAEtC,SAAS,cAAc,YAAgC,QAAyC;AAC9F,MAAI,CAAC,WAAY,QAAO,CAAC;AACzB,QAAM,MAAM,WAAW,SAAS,UAAU;AAC1C,MAAI,CAAC,IAAK,QAAO,CAAC;AAClB,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,WAAO,UAAU,OAAO,WAAW,WAAW,SAAS,CAAC;AAAA,EAC1D,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAIA,SAAS,mBAAmB,OAA+B;AACzD,SAAO,KAAK,UAAU,KAAK;AAC7B;AAIA,MAAM,oBAAoB;AAC1B,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,oBAAoB;AAG1B,MAAM,iBAAiB;AAoBvB,SAAS,QAAQ,SAAS,IAAa;AACrC,SAAO;AAAA,IACL,QAAQ,SAAS;AAAA,IACjB,MAAM,SAAS;AAAA,IACf,MAAM,SAAS;AAAA,IACf,UAAU,SAAS;AAAA,IACnB,QAAQ,SAAS;AAAA,EACnB;AACF;AAGA,SAAS,oBAAoB,SAAyE;AACpG,MAAI,CAAC,QAAS,QAAO,EAAE,SAAS,OAAO,QAAQ,GAAG;AAClD,SAAO,EAAE,SAAS,MAAM,QAAQ,YAAY,OAAO,KAAM,QAAQ,UAAU,GAAI;AACjF;AA6BO,SAAS,kBACd,IACA,SACA,QACe;AACf,QAAM,OAAO,QAAQ,MAAM;AAC3B,QAAM,MAAqB,CAAC;AAE5B,QAAM,UAAuB,CAAC;AAC9B,aAAW,OAAO,SAAS;AACzB,UAAM,SAAS,cAAc,GAAG;AAChC,QAAI,CAAC,OAAQ;AACb,UAAM,MAAM,GAAG,IAAI,KAAK,SAAS,IAAI,GAAG;AACxC,QAAI,OAAO,KAAM;AACjB,YAAQ,IAAI,GAAG,IAAI,kBAAkB,QAAQ,GAAG;AAAA,EAClD;AACA,MAAI,OAAO,KAAK,OAAO,EAAE,OAAQ,KAAI,UAAU;AAE/C,QAAM,UAAU,GAAG,IAAI,KAAK,IAAI;AAChC,MAAI,SAAS;AACX,UAAM,UAAU,YAAY,SAAS,IAAI,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACvE,QAAI,QAAQ,OAAQ,KAAI,QAAQ;AAAA,EAClC;AAEA,QAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ;AAClC,MAAI,UAAU,MAAO,KAAI,WAAW;AAAA,WAC3B,SAAS,OAAO,KAAK,IAAI,EAAG,KAAI,WAAW,OAAO,KAAK;AAEhE,QAAM,OAAO,GAAG,IAAI,KAAK,IAAI;AAC7B,MAAI,QAAQ,OAAO,IAAI,KAAK,EAAG,KAAI,OAAO,OAAO,IAAI,IAAI;AAEzD,SAAO;AACT;AAWA,SAAS,aACP,SACA,OACA,SACA,UACA,MACA,iBACA,MACQ;AACR,QAAM,QAAkB,CAAC;AACzB,aAAW,OAAO,SAAS;AACzB,UAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,QAAI,CAAC,SAAS,CAAC,eAAe,KAAK,EAAG;AACtC,UAAM,MAAM,kBAAkB,KAAK;AACnC,QAAI,OAAO,KAAM,OAAM,KAAK,GAAG,KAAK,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,EAAE;AAAA,EAC/D;AACA,QAAM,KAAK,GAAG,KAAK,IAAI,IAAI,YAAY,KAAK,CAAC,EAAE;AAC/C,QAAM;AAAA,IACJ,GAAG,KAAK,QAAQ,IACd,aAAa,WAAW,QAAQ,aAAa,kBAAkB,KAAK,OAAO,QAAQ,CACrF;AAAA,EACF;AACA,QAAM,KAAK,GAAG,KAAK,IAAI,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE;AAC7D,SAAO,MAAM,KAAK,GAAG;AACvB;AAEA,SAAS,cACP,iBACA,SACA,OACA,SACA,UACA,MACA,iBAEA,QAIA,OACA,MACM;AACN;AAAA,IACE,CAAC,SAAS;AACR,YAAM,OAAO,IAAI,gBAAgB,IAAI;AAErC,iBAAW,OAAO,QAAS,MAAK,OAAO,KAAK,SAAS,IAAI,GAAG;AAC5D,WAAK,OAAO,KAAK,IAAI;AACrB,WAAK,OAAO,KAAK,IAAI;AACrB,WAAK,OAAO,KAAK,QAAQ;AACzB,UAAI,WAAW,QAAW;AACxB,aAAK,OAAO,KAAK,MAAM;AACvB,YAAI,OAAO,KAAK,EAAG,MAAK,IAAI,KAAK,QAAQ,MAAM;AAAA,MACjD;AAEA,iBAAW,OAAO,SAAS;AACzB,cAAMA,SAAQ,QAAQ,IAAI,GAAG;AAC7B,YAAI,CAACA,UAAS,CAAC,eAAeA,MAAK,EAAG;AACtC,cAAM,MAAM,kBAAkBA,MAAK;AACnC,YAAI,OAAO,KAAM,MAAK,IAAI,KAAK,SAAS,IAAI,KAAK,GAAG;AAAA,MACtD;AAEA,YAAM,UAAU,YAAY,KAAK;AACjC,UAAI,QAAS,MAAK,IAAI,KAAK,MAAM,OAAO;AAExC,UAAI,aAAa,SAAU,MAAK,IAAI,KAAK,UAAU,KAAK;AAAA,eAC/C,aAAa,gBAAiB,MAAK,IAAI,KAAK,UAAU,OAAO,QAAQ,CAAC;AAE/E,UAAI,OAAO,EAAG,MAAK,IAAI,KAAK,MAAM,OAAO,OAAO,CAAC,CAAC;AAClD,aAAO;AAAA,IACT;AAAA,IACA,EAAE,SAAS,MAAM,MAAM;AAAA,EACzB;AACF;AAsBO,SAAS,cAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA;AACF,GAQG;AACD,QAAM,EAAE,SAAS,SAAS,QAAQ,UAAU,IAAI,oBAAoB,aAAa;AACjF,QAAM,OAAO,QAAQ,MAAM,QAAQ,SAAS,GAAG,CAAC,SAAS,CAAC;AAG1D,QAAM,CAAC,cAAc,eAAe,IAAI,gBAAgB;AACxD,QAAM,WAAW,YAAY;AAG7B,QAAM,CAAC,UAAU,IAAI;AAAA,IAAwB,MAC3C,UAAU,kBAAkB,cAAc,SAAS,SAAS,IAAI,CAAC;AAAA,EACnE;AACA,QAAM,UAAU;AAAA,IACd,MAAM,cAAc,YAAY,gBAAgB;AAAA,IAChD,CAAC,YAAY,gBAAgB;AAAA,EAC/B;AACA,QAAM,CAAC,eAAe,gBAAgB,IAAI;AAAA,IAAsB,MAC9D,WAAW,UAAU,SAAY,WAAW,QAAQ,eAAe,QAAQ,IAAI;AAAA,EACjF;AACA,QAAM,CAAC,iBAAiB,kBAAkB,IAAI;AAAA,IAC5C,MAAM,WAAW,WAAW,QAAQ,WAAW,CAAC;AAAA,EAClD;AAGA,QAAM,QAAQ,aAAa;AAC3B,QAAM,UAAU,eAAe;AAC/B,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,MAAM,WAAW,QAAQ,CAAC;AAgB3D,QAAM,gBACJ,cAAc,UAAa,gBAAgB,SACvC,KAAK,UAAU,CAAC,aAAa,MAAM,eAAe,IAAI,CAAC,IACvD;AACN,QAAM,CAAC,mBAAmB,oBAAoB,IAAI,SAAS,aAAa;AACxE,MAAI,sBAAsB,eAAe;AACvC,yBAAqB,aAAa;AAClC,YAAQ,CAAC;AAAA,EACX;AACA,QAAM,CAAC,UAAU,WAAW,IAAI,SAAiB,MAAM;AACrD,QAAI,WAAW,aAAa,OAAW,QAAO,WAAW;AACzD,QAAI,QAAQ,aAAa,MAAO,QAAO;AACvC,QAAI,OAAO,QAAQ,aAAa,YAAY,QAAQ,WAAW,EAAG,QAAO,QAAQ;AACjF,WAAO;AAAA,EACT,CAAC;AACD,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAiC,MAAM,QAAQ,UAAU,CAAC,CAAC;AACvF,QAAM,CAAC,YAAY,aAAa,IAAI,SAAsB,MAAM,IAAI,IAAI,QAAQ,UAAU,CAAC,CAAC,CAAC;AAC7F,QAAM,CAAC,cAAc,eAAe,IAAI,SAAS,KAAK;AACtD,QAAM,WAAW,QAAQ,MAAM,oBAAI,IAAkC,GAAG,CAAC,CAAC;AAY1E,QAAM,gBAAgB,OAAsB,IAAI;AAChD,QAAM,YAAY,CAAC,aACf,KACA,mBAAmB;AAAA,IACjB,MAAM;AAAA,IACN;AAAA,IACA,UAAU,aAAa,WAAW,QAAQ;AAAA,IAC1C;AAAA,IACA,QAAQ,MAAM,KAAK,UAAU;AAAA,EAC/B,CAAC;AACL,YAAU,MAAM;AACd,QAAI,CAAC,WAAY;AAIjB,UAAM,SAAS,mBAAmB;AAClC,UAAM,MAAM,GAAG,MAAM,KAAS,SAAS;AACvC,QAAI,cAAc,YAAY,IAAK;AACnC,kBAAc,UAAU;AACxB,gBAAY,QAAQ,SAAS;AAAA,EAC/B,GAAG,CAAC,YAAY,kBAAkB,SAAS,CAAC;AAE5C,QAAM,UAAU,OAAsB,IAAI;AAC1C,QAAM,SAAS,UACX,aAAa,SAAS,OAAO,SAAS,UAAU,MAAM,iBAAiB,IAAI,IAC3E;AACJ,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AACd,QAAI,QAAQ,YAAY,OAAQ;AAChC,YAAQ,UAAU;AAIlB,kBAAc,iBAAiB,SAAS,OAAO,SAAS,UAAU,MAAM,iBAAiB,QAAW,SAAS,OAAO,IAAI;AAAA,EAE1H,GAAG,CAAC,SAAS,MAAM,CAAC;AAEpB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAiFO,SAAS,iBAAoB;AAAA,EAClC;AAAA,EACA,kBAAkB;AAAA,EAClB,SAAS,gBAAgB;AAAA,EACzB,WAAW;AAAA,EACX,QAAQ,eAAe;AACzB,GAAuD;AACrD,QAAM,WAAW,oBAAoB,aAAa;AAClD,QAAM,UAAU,SAAS;AACzB,QAAM,YAAY,mBAAmB,SAAS;AAC9C,QAAM,OAAO,QAAQ,MAAM,QAAQ,SAAS,GAAG,CAAC,SAAS,CAAC;AAC1D,QAAM,CAAC,cAAc,eAAe,IAAI,gBAAgB;AACxD,QAAM,WAAW,YAAY;AAC7B,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAqB,MAAM;AACnD,UAAM,MAAM,UAAU,kBAAkB,cAAc,SAAS,SAAS,IAAI,CAAC;AAC7E,WAAO;AAAA,MACL,OAAO,IAAI,SAAS,CAAC;AAAA,MACrB,SAAS,IAAI,WAAW,CAAC;AAAA,MACzB,UAAU,IAAI,YAAY;AAAA,MAC1B,MAAM,IAAI,QAAQ;AAAA,MAClB,QAAQ,WAAW,eAAgB,aAAa,IAAI,KAAK,MAAM,KAAK,KAAM;AAAA,IAC5E;AAAA,EACF,CAAC;AAED,QAAM,UAAU,OAAsB,IAAI;AAC1C,QAAM,SAAS,UACX,aAAa,SAAS,MAAM,OAAO,MAAM,SAAS,MAAM,UAAU,MAAM,MAAM,iBAAiB,IAAI,KAClG,eAAe,IAAI,KAAK,MAAM,IAAI,MAAM,OAAO,KAAK,IAAI,MAAM,SAAS,EAAE,KAAK,MAC/E;AACJ,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AAGd,QAAI,QAAQ,YAAY,OAAQ;AAChC,YAAQ,UAAU;AAClB;AAAA,MACE;AAAA,MACA;AAAA,MACA,MAAM;AAAA,MACN,MAAM;AAAA,MACN,MAAM;AAAA,MACN,MAAM;AAAA,MACN;AAAA,MACA,eAAe,MAAM,SAAS;AAAA,MAC9B,SAAS;AAAA,MACT;AAAA,IACF;AAAA,EAIF,GAAG,CAAC,SAAS,MAAM,CAAC;AAEpB,QAAM,UAAU,CAAC,SAAiB,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,KAAK,EAAE;AAClE,QAAM,cAAc,CAAC,aAAqB,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,UAAU,MAAM,EAAE,EAAE;AACvF,QAAM,aAAa,CAAC,YAAyB,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,SAAS,MAAM,EAAE,EAAE;AACzF,QAAM,WAAW,CAAC,UAAuB,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,MAAM,EAAE,EAAE;AACnF,QAAM,YAAY,CAAC,WAAmB,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,QAAQ,MAAM,EAAE,EAAE;AAEjF,SAAO;AAAA,IACL,MAAM,MAAM;AAAA,IACZ;AAAA,IACA,UAAU,MAAM;AAAA,IAChB;AAAA,IACA,SAAS,MAAM;AAAA,IACf;AAAA,IACA,OAAO,MAAM;AAAA,IACb;AAAA,IACA,QAAQ,MAAM;AAAA,IACd;AAAA,IACA,YAAY,CAAC,OAAO,aAAa;AAAA,MAC/B,kBAAkB;AAAA,QAChB,MAAM,MAAM;AAAA,QACZ,UAAU,MAAM;AAAA,QAChB;AAAA,QACA,cAAc;AAAA,QACd,kBAAkB;AAAA,QAClB,WAAW,SAAS;AAAA,MACtB;AAAA,MACA,SAAS,MAAM;AAAA,MACf,iBAAiB;AAAA,MACjB,OAAO,MAAM;AAAA,MACb,eAAe;AAAA,IACjB;AAAA,EACF;AACF;","names":["state"]}
+{"version":3,"sources":["../../src/components/use-table-state.ts"],"sourcesContent":["import { useEffect, useMemo, useRef, useState } from \"react\";\nimport { useLocation, useSearchParams } from \"react-router\";\nimport { useKitTableStorageKeyPrefix } from \"../i18n/kit-labels\";\nimport { readStored, writeStored } from \"../lib/safe-storage\";\nimport {\n  decodeFilterValue,\n  encodeFilterValue,\n  isFilterActive,\n  resolveFilter,\n} from \"./data-table-filters\";\nimport { decodeSorts, encodeSorts, normalizeSorts, type SortState } from \"./data-table-sort\";\nimport type { DataTableColumn, FilterState, ServerPagination } from \"./data-table\";\n\n// ---------- Persisted + URL-encoded view state ----------\n//\n// Moved here with `useTableState` when `DataTable` was split: these are what the hook\n// reads and writes, and nothing else in the table ever called them.\n\ninterface PersistedState {\n  // Multi-sort array; blobs from before the upgrade hold a single {key, dir}\n  // object (or null) — read back through normalizeSorts.\n  sort: SortState[] | { key: string; dir: string } | null;\n  filters: FilterState;\n  pageSize: number | \"all\";\n  widths?: Record<string, number>;\n  hidden?: string[];\n}\n\nexport const DEFAULT_PERSIST_PREFIX = \"hbui-table:\";\n\nfunction loadPersisted(storageKey: string | undefined, prefix: string): Partial<PersistedState> {\n  if (!storageKey) return {};\n  const raw = readStored(prefix + storageKey);\n  if (!raw) return {};\n  try {\n    const parsed = JSON.parse(raw) as Partial<PersistedState>;\n    return parsed && typeof parsed === \"object\" ? parsed : {};\n  } catch {\n    return {}; // corrupt JSON — the storage access itself is guarded by readStored\n  }\n}\n\n/** The blob that would be stored — also the value the effect below compares by, so\n *  the comparison and the write can never disagree about what \"unchanged\" means. */\nfunction serializePersisted(state: PersistedState): string {\n  return JSON.stringify(state);\n}\n\n/** A stored page size as a table holds it — `\"all\"` is `Infinity` — or `fallback`. */\nfunction storedPageSize(stored: Partial<PersistedState>, fallback: number): number {\n  if (stored.pageSize === \"all\") return Infinity;\n  if (typeof stored.pageSize === \"number\" && stored.pageSize > 0) return stored.pageSize;\n  return fallback;\n}\n\n// ---------- URL sync helpers ----------\n\nconst URL_FILTER_PREFIX = \"f.\";\nconst URL_SORT_KEY = \"sort\";\nconst URL_PAGE_KEY = \"p\";\nconst URL_PAGE_SIZE_KEY = \"ps\";\n/** The free-text search term — managed only by {@link useTableUrlState}, and only when\n *  it is asked to (`search: true`); a plain `urlSync` table leaves a `q` alone. */\nconst URL_SEARCH_KEY = \"q\";\n\n/**\n * How a table is mirrored into the URL: `true`, or `{ prefix }` for a table that shares\n * its page with another URL-synced one. The prefix is put verbatim in front of EVERY key\n * the table writes and reads — `{ prefix: \"inv.\" }` gives `inv.f.<column>`, `inv.sort`,\n * `inv.p`, `inv.ps` (and `inv.q`) — so two tables on one page stop sharing a sort and a\n * page. Without one the keys are unprefixed, as they always were.\n */\nexport type TableUrlSync = boolean | { prefix?: string };\n\n/** The query keys of one table, with its prefix applied. */\ninterface UrlKeys {\n  filter: string;\n  sort: string;\n  page: string;\n  pageSize: string;\n  search: string;\n}\n\nfunction urlKeys(prefix = \"\"): UrlKeys {\n  return {\n    filter: prefix + URL_FILTER_PREFIX,\n    sort: prefix + URL_SORT_KEY,\n    page: prefix + URL_PAGE_KEY,\n    pageSize: prefix + URL_PAGE_SIZE_KEY,\n    search: prefix + URL_SEARCH_KEY,\n  };\n}\n\n/** `urlSync` split into \"is it on\" and \"under which prefix\". */\nfunction resolveTableUrlSync(urlSync: TableUrlSync | undefined): { enabled: boolean; prefix: string } {\n  if (!urlSync) return { enabled: false, prefix: \"\" };\n  return { enabled: true, prefix: urlSync === true ? \"\" : (urlSync.prefix ?? \"\") };\n}\n\n/** What {@link readTableUrlState} found in a query string. */\nexport interface TableUrlState {\n  sorts?: SortState[];\n  filters?: FilterState;\n  /** `Infinity` for `ps=all`. */\n  pageSize?: number;\n  /** 0-based (the URL's `p` is 1-based). */\n  page?: number;\n}\n\n/**\n * What a table's URL says, read out of a query string: the column filters (`f.<key>`),\n * the sort, the page size and the 0-based page. Absent keys are absent here too, so a\n * caller can tell \"not in the link\" from \"the default\". The same reader `urlSync` uses\n * on mount, exported for an owner that keeps the state itself — see\n * {@link useTableUrlState}.\n *\n * Pass the ROUTER's query string — the one `setSearchParams` writes — and the table's\n * `prefix` when it has one (see {@link TableUrlSync}).\n *\n * This read `window.location.search` until 0.7.0, which is the same string only under a\n * BrowserRouter. Under a HashRouter the router's query lives after the `#`\n * (`/#/tx?f.payee=Rewe`) and `window.location.search` is empty: a shared link opened\n * unfiltered, and the table's first write then replaced the link's filter with its own\n * empty state. Reading and writing through `useSearchParams` is one source for both\n * directions under every router, MemoryRouter included.\n */\nexport function readTableUrlState<T>(\n  sp: URLSearchParams,\n  columns: DataTableColumn<T>[],\n  prefix?: string,\n): TableUrlState {\n  const keys = urlKeys(prefix);\n  const out: TableUrlState = {};\n\n  const filters: FilterState = {};\n  for (const col of columns) {\n    const filter = resolveFilter(col);\n    if (!filter) continue;\n    const raw = sp.get(keys.filter + col.key);\n    if (raw == null) continue;\n    filters[col.key] = decodeFilterValue(filter, raw);\n  }\n  if (Object.keys(filters).length) out.filters = filters;\n\n  const sortRaw = sp.get(keys.sort);\n  if (sortRaw) {\n    const decoded = decodeSorts(sortRaw, new Set(columns.map((c) => c.key)));\n    if (decoded.length) out.sorts = decoded;\n  }\n\n  const psRaw = sp.get(keys.pageSize);\n  if (psRaw === \"all\") out.pageSize = Infinity;\n  else if (psRaw && Number(psRaw) > 0) out.pageSize = Number(psRaw);\n\n  const pRaw = sp.get(keys.page);\n  if (pRaw && Number(pRaw) >= 1) out.page = Number(pRaw) - 1;\n\n  return out;\n}\n\n/**\n * The managed part of the query string, as a string, for comparing by VALUE.\n *\n * Everything the table puts in the address and nothing else, in a fixed order.\n * `columns` is walked for its keys only, which is why it can be left out of the\n * effect's dependencies without lying: a new column ARRAY carrying the same keys\n * produces the same signature, and a genuinely different set of filterable columns\n * produces a different one.\n */\nfunction urlSignature<T>(\n  columns: DataTableColumn<T>[],\n  sorts: SortState[],\n  filters: FilterState,\n  pageSize: number,\n  page: number,\n  defaultPageSize: number,\n  keys: UrlKeys,\n): string {\n  const parts: string[] = [];\n  for (const col of columns) {\n    const state = filters[col.key];\n    if (!state || !isFilterActive(state)) continue;\n    const enc = encodeFilterValue(state);\n    if (enc != null) parts.push(`${keys.filter}${col.key}=${enc}`);\n  }\n  parts.push(`${keys.sort}=${encodeSorts(sorts)}`);\n  parts.push(\n    `${keys.pageSize}=${\n      pageSize === Infinity ? \"all\" : pageSize === defaultPageSize ? \"\" : String(pageSize)\n    }`,\n  );\n  parts.push(`${keys.page}=${page > 0 ? String(page + 1) : \"\"}`);\n  return parts.join(\"&\");\n}\n\nfunction writeUrlState<T>(\n  setSearchParams: ReturnType<typeof useSearchParams>[1],\n  columns: DataTableColumn<T>[],\n  sorts: SortState[],\n  filters: FilterState,\n  pageSize: number,\n  page: number,\n  defaultPageSize: number,\n  // `undefined`: the search term is not ours to manage, and a `q` is left as it is.\n  search: string | undefined,\n  // The current entry's route state, carried over the replace. A query rewrite is not\n  // a navigation, and dropping the state would, for one, lose the mark a URL-bound\n  // dialog's opener leaves there (see useDialogParam).\n  state: unknown,\n  keys: UrlKeys,\n): void {\n  setSearchParams(\n    (prev) => {\n      const next = new URLSearchParams(prev);\n      // clear managed keys\n      for (const col of columns) next.delete(keys.filter + col.key);\n      next.delete(keys.sort);\n      next.delete(keys.page);\n      next.delete(keys.pageSize);\n      if (search !== undefined) {\n        next.delete(keys.search);\n        if (search.trim()) next.set(keys.search, search);\n      }\n      // write filters\n      for (const col of columns) {\n        const state = filters[col.key];\n        if (!state || !isFilterActive(state)) continue;\n        const enc = encodeFilterValue(state);\n        if (enc != null) next.set(keys.filter + col.key, enc);\n      }\n      // write sort\n      const sortEnc = encodeSorts(sorts);\n      if (sortEnc) next.set(keys.sort, sortEnc);\n      // write page size if non-default\n      if (pageSize === Infinity) next.set(keys.pageSize, \"all\");\n      else if (pageSize !== defaultPageSize) next.set(keys.pageSize, String(pageSize));\n      // write page if not first\n      if (page > 0) next.set(keys.page, String(page + 1));\n      return next;\n    },\n    { replace: true, state },\n  );\n}\n\n/**\n * Where a table's view lives: what it is sorted and filtered by, which page, how wide\n * the columns are and which are hidden — plus the two places that outlives a render.\n *\n * Lifted out of `DataTable`, which was 984 lines and twenty hooks in one function. This\n * is the part that is genuinely about STATE rather than about drawing, and the three\n * rules it encodes are easy to lose among the markup:\n *\n * * **The URL is read once, on mount.** A shared or deep link populates the initial view;\n *   after that the state is local, or the browser's own history would fight the user's\n *   next click.\n * * **Sorting and filtering are optionally CONTROLLED.** A server-driven table passes\n *   state and a callback and owns them; everything else is self-owned. That is the\n *   `sortsProp ?? internalSorts` pair, and it is why the setters are exposed separately.\n * * **Persistence writes on every change, the URL only when asked.** `storageKey` is the\n *   per-table identity; `urlSync` is opt-in because only some tables want their view in\n *   a shareable address.\n * * **A controlled filter, sort or page size that changes sends the table back to page\n *   1.** See the note at the reset below.\n */\nexport function useTableState<T>({\n  columns,\n  storageKey,\n  storageKeyPrefix,\n  urlSync: urlSyncOption,\n  defaultPageSize,\n  sortsProp,\n  filtersProp,\n  pageSizeProp,\n}: {\n  columns: DataTableColumn<T>[];\n  storageKey?: string;\n  storageKeyPrefix: string;\n  urlSync?: TableUrlSync;\n  defaultPageSize: number;\n  sortsProp?: SortState[];\n  filtersProp?: FilterState;\n  pageSizeProp?: number;\n}) {\n  const { enabled: urlSync, prefix: urlPrefix } = resolveTableUrlSync(urlSyncOption);\n  const keys = useMemo(() => urlKeys(urlPrefix), [urlPrefix]);\n  // Called unconditionally (a Router is required either way — see src/data-table.ts),\n  // and the SAME pair is used to read and to write; see `readTableUrlState`.\n  const [searchParams, setSearchParams] = useSearchParams();\n  const location = useLocation();\n  // Read URL once on mount so URL-encoded views (e.g. shared links, deep links from\n  // other pages) populate initial state. After mount, state is local.\n  const [urlInitial] = useState<TableUrlState>(() =>\n    urlSync ? readTableUrlState(searchParams, columns, urlPrefix) : {},\n  );\n  const initial = useMemo(\n    () => loadPersisted(storageKey, storageKeyPrefix),\n    [storageKey, storageKeyPrefix],\n  );\n  const [internalSorts, setInternalSorts] = useState<SortState[]>(() =>\n    urlInitial.sorts !== undefined ? urlInitial.sorts : normalizeSorts(initial.sort),\n  );\n  const [internalFilters, setInternalFilters] = useState<FilterState>(\n    () => urlInitial.filters ?? initial.filters ?? {},\n  );\n  // Controlled when the owner passes state + callback (server-driven tables);\n  // self-owned otherwise.\n  const sorts = sortsProp ?? internalSorts;\n  const filters = filtersProp ?? internalFilters;\n  const [page, setPage] = useState(() => urlInitial.page ?? 0);\n\n  // ---- Controlled filters/sorts reset the page ----\n  //\n  // A self-owned table resets to page 1 in the filter handlers. A CONTROLLED one could\n  // not: the handlers hand the change to the owner and return, and `page` lives here,\n  // where the owner has no way to reach it — so narrowing a filter from outside (a\n  // saved view, a chip dismissed above the table) left a client-side table on page 4\n  // of what was now two pages, clamped to the last one instead of the first.\n  //\n  // So the table does it: whenever the controlled VALUE changes, back to the first\n  // page. Compared by value, because a controlled prop is a fresh object on every\n  // parent render. Adjusted during render rather than in an effect, so the stale page\n  // is never painted and never written to the URL. Not on mount: a deep link's `p=3`\n  // must survive the owner's first render. (In `serverPagination` mode this state is\n  // unused — the owner's `page` is the page, and resetting it stays the owner's job.)\n  // A controlled page size counts too: the groups of `TranslationReviewPanel` share one,\n  // and a group paged deep into its rows starts over when another group's pager changes it.\n  const controlledSig =\n    sortsProp !== undefined || filtersProp !== undefined || pageSizeProp !== undefined\n      ? JSON.stringify([sortsProp ?? null, filtersProp ?? null, String(pageSizeProp)])\n      : null;\n  const [seenControlledSig, setSeenControlledSig] = useState(controlledSig);\n  if (seenControlledSig !== controlledSig) {\n    setSeenControlledSig(controlledSig);\n    setPage(0);\n  }\n  const [internalPageSize, setPageSize] = useState<number>(() =>\n    urlInitial.pageSize !== undefined ? urlInitial.pageSize : storedPageSize(initial, defaultPageSize),\n  );\n  const pageSize = pageSizeProp ?? internalPageSize;\n  const [widths, setWidths] = useState<Record<string, number>>(() => initial.widths ?? {});\n  const [hiddenCols, setHiddenCols] = useState<Set<string>>(() => new Set(initial.hidden ?? []));\n  const [showSettings, setShowSettings] = useState(false);\n  const headRefs = useMemo(() => new Map<string, HTMLTableCellElement>(), []);\n\n  // ---- Writing out: both of these compare by VALUE ----\n  //\n  // A CONTROLLED table (`sorts`/`filters` props plus callbacks — every server-driven\n  // one) receives a freshly-built object on every render of the page around it, and\n  // `{}` is never `===` the `{}` before it. Keyed on identity, both effects below\n  // therefore fired on every unrelated parent render: persistence wrote the same JSON\n  // into `localStorage` each time — a synchronous main-thread write, on a page whose\n  // other half may be a form being typed into — and the URL one handed react-router a\n  // `replace` it answers with a render, which is the loop the audit records. A `ref`\n  // holding what was last written is what makes \"changed\" mean changed.\n  const lastPersisted = useRef<string | null>(null);\n  const persisted = !storageKey\n    ? \"\"\n    : serializePersisted({\n        sort: sorts,\n        filters,\n        pageSize: pageSize === Infinity ? \"all\" : pageSize,\n        widths,\n        hidden: Array.from(hiddenCols),\n      });\n  useEffect(() => {\n    if (!storageKey) return;\n    // The destination is part of the signature: two tables can hold identical state,\n    // and a table that swaps `storageKey` has to write under the new one even though\n    // nothing about the view changed.\n    const target = storageKeyPrefix + storageKey;\n    const sig = `${target}\\u0000${persisted}`;\n    if (lastPersisted.current === sig) return;\n    lastPersisted.current = sig;\n    writeStored(target, persisted);\n  }, [storageKey, storageKeyPrefix, persisted]);\n\n  const lastUrl = useRef<string | null>(null);\n  const urlSig = urlSync\n    ? urlSignature(columns, sorts, filters, pageSize, page, defaultPageSize, keys)\n    : \"\";\n  useEffect(() => {\n    if (!urlSync) return;\n    if (lastUrl.current === urlSig) return;\n    lastUrl.current = urlSig;\n    // `columns` is deliberately not a dependency and does not need to be: the\n    // signature above is computed from it, so a column set that would produce a\n    // different address produces a different signature first.\n    writeUrlState(setSearchParams, columns, sorts, filters, pageSize, page, defaultPageSize, undefined, location.state, keys);\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [urlSync, urlSig]);\n\n  return {\n    sorts,\n    filters,\n    setInternalSorts,\n    setInternalFilters,\n    page,\n    setPage,\n    pageSize,\n    setPageSize,\n    widths,\n    setWidths,\n    hiddenCols,\n    setHiddenCols,\n    showSettings,\n    setShowSettings,\n    headRefs,\n  };\n}\n\n// ---------- One view over several tables ----------\n\n/** What {@link useSharedTableView} keeps. */\nexport interface SharedTableView {\n  sorts: SortState[];\n  setSorts: (next: SortState[]) => void;\n  /** `Infinity` for \"all\", as a table holds it. */\n  pageSize: number;\n  setPageSize: (next: number) => void;\n}\n\n/**\n * One table view — the sort and the page size — for an owner that draws it as SEVERAL\n * tables over one `storageKey`: `TranslationReviewPanel`'s groups, which sort and page\n * alike (0.35, Kurvenschmiede: its grouped review stored no view at all). Pass them to\n * each table as `sorts`/`onSortsChange` and `pageSize`/`onPageSizeChange`.\n *\n * Kept in the very blob a `DataTable` with that `storageKey` keeps, not in a format of\n * its own, so the single table and the groups read each other's view. What the blob\n * holds besides (filters, column widths, hidden columns) is carried over as stored, for\n * the single table to find as it left it. Read when `active` turns on — on mount, or\n * when the owner switches to this view — and written on a change, never on a read. The\n * prefix resolves as DataTable's does: prop > provider > the kit's.\n */\nexport function useSharedTableView({\n  active,\n  storageKey,\n  storageKeyPrefix,\n  defaultPageSize,\n}: {\n  active: boolean;\n  storageKey?: string;\n  storageKeyPrefix?: string;\n  defaultPageSize: number;\n}): SharedTableView {\n  const providerPrefix = useKitTableStorageKeyPrefix();\n  const prefix = storageKeyPrefix ?? providerPrefix ?? DEFAULT_PERSIST_PREFIX;\n  const read = () => {\n    const stored = active ? loadPersisted(storageKey, prefix) : {};\n    return { sorts: normalizeSorts(stored.sort), pageSize: storedPageSize(stored, defaultPageSize) };\n  };\n  const [view, setView] = useState(read);\n  // Adjusted during render when `active` turns on, so the first render of the groups\n  // already has the view the single table left, not a frame of the default.\n  const [wasActive, setWasActive] = useState(active);\n  if (active !== wasActive) {\n    setWasActive(active);\n    if (active) setView(read());\n  }\n  const change = (patch: Partial<typeof view>) => {\n    const next = { ...view, ...patch };\n    setView(next);\n    if (!active || !storageKey) return;\n    const stored = loadPersisted(storageKey, prefix);\n    const blob: PersistedState = {\n      sort: next.sorts,\n      filters: stored.filters ?? {},\n      pageSize: next.pageSize === Infinity ? \"all\" : next.pageSize,\n      widths: stored.widths,\n      hidden: stored.hidden,\n    };\n    writeStored(prefix + storageKey, serializePersisted(blob));\n  };\n  return {\n    sorts: view.sorts,\n    setSorts: (sorts) => change({ sorts }),\n    pageSize: view.pageSize,\n    setPageSize: (pageSize) => change({ pageSize }),\n  };\n}\n\n// ---------- Owner-held table state, mirrored to the URL ----------\n\nexport interface UseTableUrlStateOptions<T> {\n  /** The table's columns — read for their keys and filter types only. */\n  columns: DataTableColumn<T>[];\n  /** Default 25. A page size equal to it is left out of the URL. */\n  defaultPageSize?: number;\n  /** Mirror the state into the URL and seed it from there on mount. Default true.\n   *  `{ prefix }` puts a prefix in front of every key, for a page with two URL-synced\n   *  tables — see {@link TableUrlSync}. */\n  urlSync?: TableUrlSync;\n  /** Shorthand for `urlSync: { prefix }`; wins over a prefix given there. */\n  urlPrefix?: string;\n  /** Also hold a free-text search term, under `q`. Off by default, so a `q` that\n   *  belongs to someone else on the page is never touched. */\n  search?: boolean;\n}\n\n/** The part of {@link DataTableProps} a server-driven table takes from its owner. */\nexport interface TableUrlStateProps {\n  serverPagination: ServerPagination;\n  filters: FilterState;\n  onFiltersChange: (next: FilterState) => void;\n  sorts: SortState[];\n  onSortsChange: (next: SortState[]) => void;\n}\n\nexport interface UseTableUrlStateReturn {\n  /** 0-based. */\n  page: number;\n  setPage: (page: number) => void;\n  pageSize: number;\n  /** Also back to the first page. */\n  setPageSize: (pageSize: number) => void;\n  filters: FilterState;\n  /** Also back to the first page. */\n  setFilters: (next: FilterState) => void;\n  sorts: SortState[];\n  /** Also back to the first page. */\n  setSorts: (next: SortState[]) => void;\n  /** The search term (`\"\"` unless `search: true`). */\n  search: string;\n  /** Also back to the first page. */\n  setSearch: (next: string) => void;\n  /**\n   * Everything the table needs, to spread onto it:\n   * `<DataTable {...table.tableProps(data?.total ?? 0, { isLoading })} rows={…} … />`.\n   */\n  tableProps: (total: number, options?: { isLoading?: boolean }) => TableUrlStateProps;\n}\n\ninterface OwnedState {\n  sorts: SortState[];\n  filters: FilterState;\n  pageSize: number;\n  page: number;\n  search: string;\n}\n\n/**\n * The controlled state of a `serverPagination` table — filters, sorts, page, page size\n * and optionally a search term — kept by the OWNER and mirrored into the URL in the\n * table's own scheme (`f.<key>`, `sort`, `p`, `ps`, and `q`).\n *\n * A server-driven table owns none of this: the owner has to hold it to turn it into\n * the query that fetches `rows`, and until now it also had to restate the table's URL\n * codec to keep the view bookmarkable (kastlan's use-server-table.ts copied\n * `readUrlState` / `writeUrlState` to do it). Same rules as `urlSync`:\n *\n * * **The URL is read once, on mount** — a shared or deep link (see {@link filterHref})\n *   seeds the view; after that the state is local and written out with `replace`.\n * * **Any change but the page itself goes back to page 1** — a narrower filter must not\n *   leave the user on page 7 of 2.\n * * **Written by value**: an unchanged view writes nothing, however often the owner\n *   renders.\n *\n * Mapping the state onto the backend's query parameters stays the owner's: that is the\n * part the kit cannot know.\n */\nexport function useTableUrlState<T>({\n  columns,\n  defaultPageSize = 25,\n  urlSync: urlSyncOption = true,\n  urlPrefix: urlPrefixOption,\n  search: manageSearch = false,\n}: UseTableUrlStateOptions<T>): UseTableUrlStateReturn {\n  const resolved = resolveTableUrlSync(urlSyncOption);\n  const urlSync = resolved.enabled;\n  const urlPrefix = urlPrefixOption ?? resolved.prefix;\n  const keys = useMemo(() => urlKeys(urlPrefix), [urlPrefix]);\n  const [searchParams, setSearchParams] = useSearchParams();\n  const location = useLocation();\n  const [state, setState] = useState<OwnedState>(() => {\n    const url = urlSync ? readTableUrlState(searchParams, columns, urlPrefix) : {};\n    return {\n      sorts: url.sorts ?? [],\n      filters: url.filters ?? {},\n      pageSize: url.pageSize ?? defaultPageSize,\n      page: url.page ?? 0,\n      search: urlSync && manageSearch ? (searchParams.get(keys.search) ?? \"\") : \"\",\n    };\n  });\n\n  const lastUrl = useRef<string | null>(null);\n  const urlSig = urlSync\n    ? urlSignature(columns, state.sorts, state.filters, state.pageSize, state.page, defaultPageSize, keys) +\n      (manageSearch ? `&${keys.search}=${state.search.trim() ? state.search : \"\"}` : \"\")\n    : \"\";\n  useEffect(() => {\n    if (!urlSync) return;\n    // First run included: a link that arrives with `p=1` or a default `ps` is\n    // normalised to the table's own spelling, as `urlSync` does.\n    if (lastUrl.current === urlSig) return;\n    lastUrl.current = urlSig;\n    writeUrlState(\n      setSearchParams,\n      columns,\n      state.sorts,\n      state.filters,\n      state.pageSize,\n      state.page,\n      defaultPageSize,\n      manageSearch ? state.search : undefined,\n      location.state,\n      keys,\n    );\n    // Keyed on the signature, which is computed from everything the write reads — see\n    // the same effect in useTableState.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [urlSync, urlSig]);\n\n  const setPage = (page: number) => setState((s) => ({ ...s, page }));\n  const setPageSize = (pageSize: number) => setState((s) => ({ ...s, pageSize, page: 0 }));\n  const setFilters = (filters: FilterState) => setState((s) => ({ ...s, filters, page: 0 }));\n  const setSorts = (sorts: SortState[]) => setState((s) => ({ ...s, sorts, page: 0 }));\n  const setSearch = (search: string) => setState((s) => ({ ...s, search, page: 0 }));\n\n  return {\n    page: state.page,\n    setPage,\n    pageSize: state.pageSize,\n    setPageSize,\n    filters: state.filters,\n    setFilters,\n    sorts: state.sorts,\n    setSorts,\n    search: state.search,\n    setSearch,\n    tableProps: (total, options) => ({\n      serverPagination: {\n        page: state.page,\n        pageSize: state.pageSize,\n        total,\n        onPageChange: setPage,\n        onPageSizeChange: setPageSize,\n        isLoading: options?.isLoading,\n      },\n      filters: state.filters,\n      onFiltersChange: setFilters,\n      sorts: state.sorts,\n      onSortsChange: setSorts,\n    }),\n  };\n}\n"],"mappings":"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","names":["state"]}

package/dist/components/user-avatar.d.ts

@@ -1,18 +1,6 @@
-import * as react from 'react';
-import { ComponentPropsWithoutRef, ReactNode } from 'react';
-import { PersonName } from '../lib/person-name.js';
-import { StatusDotTone } from './status-dot.js';
-import './progress-bar.js';
-import './signed-amount.js';
-import './stat-tile.js';
-import './chip.js';
-import 'lucide-react';
-import './field-parts.js';
-import './tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-import './write-lock.js';
-
+import type { ComponentPropsWithRef, ReactNode } from "react";
+import type { PersonName } from "../lib/person-name.js";
+import type { StatusDotTone } from "./status-dot.js";
 /** Initials from a display name (first + last) or, failing that, an email —
  *  e.g. "Marcel Eifert" → "ME", "marcel@x.com" → "MA". App-agnostic.
  *
@@ -24,14 +12,14 @@ import './write-lock.js';
  *  app-agnostic, and any consumer whose profile name is optional free text got a wall
  *  of "?" chips. The guard is what shows the empty case was foreseen; it just
  *  answered it at the wrong end. */
-declare function avatarInitials(name?: string | null, email?: string | null): string;
+export declare function avatarInitials(name?: string | null, email?: string | null): string;
 declare const AVATAR_SIZES: {
     readonly sm: "size-7 text-caption";
     readonly md: "size-8 text-xs";
     readonly lg: "size-12 text-base";
 };
 /** A status dot in the avatar's top corner — an unread count, presence. */
-interface UserAvatarBadge {
+export interface UserAvatarBadge {
     /** What the dot MEANS, for a screen reader ("3 unread"). Required: a coloured circle
      *  says nothing to someone who cannot see it. */
     label: ReactNode;
@@ -40,7 +28,7 @@ interface UserAvatarBadge {
 }
 /** A `<span>`'s props, minus `children`: the content is the initials this computes
  *  from `person`/`name`/`email`, so there is nothing for a caller to put inside. */
-interface UserAvatarProps extends Omit<ComponentPropsWithoutRef<"span">, "children"> {
+export interface UserAvatarProps extends Omit<ComponentPropsWithRef<"span">, "children"> {
     name?: string | null;
     email?: string | null;
     /**
@@ -62,9 +50,9 @@ interface UserAvatarProps extends Omit<ComponentPropsWithoutRef<"span">, "childr
      * in the surface colour so it reads as its own mark (keksdose account-menu ~385,
      * top-bar :152). Its `label` is read as text where the dot sits — inside a button
      * named by its content it joins that name. In `TopBarActionMenu`'s `trigger` the
-     * button is named by the menu's `ariaLabel` followed by this label: "Account menu
+     * button is named by the menu's `aria-label` followed by this label: "Account menu
      * 3 unread". The initials stay hidden either way, so the person's name is NOT part
-     * of it — put it in `ariaLabel` ("Marcel Eifert, account menu") if it should be.
+     * of it — put it in `aria-label` ("Marcel Eifert, account menu") if it should be.
      */
     badge?: UserAvatarBadge | null;
 }
@@ -72,6 +60,5 @@ interface UserAvatarProps extends Omit<ComponentPropsWithoutRef<"span">, "childr
  * A round initials avatar — the common user chip shared across apps (feedback
  * #333). Purely presentational; wrap it in a button for the account menu trigger.
  */
-declare function UserAvatar({ name, email, person, size, badge, className, ...rest }: UserAvatarProps): react.JSX.Element;
-
-export { UserAvatar, type UserAvatarBadge, type UserAvatarProps, avatarInitials };
+export declare function UserAvatar({ name, email, person, size, badge, className, ...rest }: UserAvatarProps): import("react").JSX.Element;
+export {};

package/dist/components/user-avatar.js

@@ -15,7 +15,7 @@ const AVATAR_SIZES = {
   md: "size-8 text-xs",
   lg: "size-12 text-base"
 };
-const CHIP = "inline-flex shrink-0 items-center justify-center rounded-full bg-[var(--bg-inverse)] font-semibold text-[var(--text-inverse)]";
+const CHIP = "inline-flex shrink-0 items-center justify-center rounded-full bg-inverse font-semibold text-inverse";
 const BADGE_SIZES = { sm: "sm", md: "md", lg: "lg" };
 function UserAvatar({ name, email, person, size = "md", badge, className, ...rest }) {
   const locale = useKitLocale();

package/dist/components/user-avatar.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/user-avatar.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef, ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { personInitials } from \"../lib/person-name\";\nimport type { PersonName } from \"../lib/person-name\";\nimport { useKitLocale } from \"../i18n/kit-labels\";\nimport { StatusDot } from \"./status-dot\";\nimport type { StatusDotSize, StatusDotTone } from \"./status-dot\";\n\n/** Initials from a display name (first + last) or, failing that, an email —\n *  e.g. \"Marcel Eifert\" → \"ME\", \"marcel@x.com\" → \"MA\". App-agnostic.\n *\n *  \"Failing that\" means BLANK, not merely absent. This was `name ?? email ?? \"?\"`,\n *  and `??` falls through on null/undefined alone — so an empty or whitespace-only\n *  display name short-circuited the email it had in hand and landed on the guard\n *  below, returning \"?\" for a user whose address says \"MA\" perfectly well. Keksdose\n *  cannot reach it (its `display_name` has `min_length=1`), but this is exported as\n *  app-agnostic, and any consumer whose profile name is optional free text got a wall\n *  of \"?\" chips. The guard is what shows the empty case was foreseen; it just\n *  answered it at the wrong end. */\nexport function avatarInitials(name?: string | null, email?: string | null): string {\n  const source = [name, email].map((s) => s?.trim()).find(Boolean) ?? \"?\";\n  const parts = source.split(/\\s+/).filter(Boolean);\n  if (parts.length >= 2) return (parts[0][0] + parts[1][0]).toUpperCase();\n  return source.slice(0, 2).toUpperCase();\n}\n\nconst AVATAR_SIZES = {\n  sm: \"size-7 text-caption\",\n  md: \"size-8 text-xs\",\n  lg: \"size-12 text-base\",\n} as const;\n\nconst CHIP =\n  \"inline-flex shrink-0 items-center justify-center rounded-full bg-[var(--bg-inverse)] font-semibold text-[var(--text-inverse)]\";\n\n/** The dot grows with the avatar: 8px on `sm`, 10px on `md` (keksdose's), 12px on `lg`. */\nconst BADGE_SIZES: Record<keyof typeof AVATAR_SIZES, StatusDotSize> = { sm: \"sm\", md: \"md\", lg: \"lg\" };\n\n/** A status dot in the avatar's top corner — an unread count, presence. */\nexport interface UserAvatarBadge {\n  /** What the dot MEANS, for a screen reader (\"3 unread\"). Required: a coloured circle\n   *  says nothing to someone who cannot see it. */\n  label: ReactNode;\n  /** Default `danger`, the unread dot both apps draw by hand. */\n  tone?: StatusDotTone;\n}\n\n/** A `<span>`'s props, minus `children`: the content is the initials this computes\n *  from `person`/`name`/`email`, so there is nothing for a caller to put inside. */\nexport interface UserAvatarProps extends Omit<ComponentPropsWithoutRef<\"span\">, \"children\"> {\n  name?: string | null;\n  email?: string | null;\n  /**\n   * The person's first and last name (0.29.0, docs/auth-harmonization.md §3.2) —\n   * preferred over `name` whenever either part is filled in. The initials follow the\n   * READER's language, the provider's `locale`: \"AE\" for Ada Example, \"EA\" in Hungarian\n   * (family name first), the family name's first character alone in Chinese. See\n   * {@link personInitials}.\n   *\n   * `name` stays the fallback for an API that still sends only `display_name`, and\n   * `email` after it: a person whose two parts are both blank falls through to them.\n   * A migrated user (the whole old display name in `first`, no `last`, §3.3) keeps the\n   * initials they had.\n   */\n  person?: PersonName | null;\n  size?: keyof typeof AVATAR_SIZES;\n  /**\n   * A status dot in the top-end corner (the top-right in LTR, top-left in RTL), ringed\n   * in the surface colour so it reads as its own mark (keksdose account-menu ~385,\n   * top-bar :152). Its `label` is read as text where the dot sits — inside a button\n   * named by its content it joins that name. In `TopBarActionMenu`'s `trigger` the\n   * button is named by the menu's `ariaLabel` followed by this label: \"Account menu\n   * 3 unread\". The initials stay hidden either way, so the person's name is NOT part\n   * of it — put it in `ariaLabel` (\"Marcel Eifert, account menu\") if it should be.\n   */\n  badge?: UserAvatarBadge | null;\n}\n\n/**\n * A round initials avatar — the common user chip shared across apps (feedback\n * #333). Purely presentational; wrap it in a button for the account menu trigger.\n */\nexport function UserAvatar({ name, email, person, size = \"md\", badge, className, ...rest }: UserAvatarProps) {\n  const locale = useKitLocale();\n  const initials = (person ? personInitials(person, locale) : \"\") || avatarInitials(name, email);\n  if (badge) {\n    // A wrapper, because the chip itself is `aria-hidden` and the badge label must not\n    // be. `className` stays on the chip (a size override still sizes the circle); the\n    // other attributes go on the wrapper, which is what a caller addresses. `relative`\n    // also contains the sr-only text.\n    return (\n      <span {...rest} className=\"relative inline-flex shrink-0\">\n        <span\n          aria-hidden\n          className={cn(\n            CHIP,\n            AVATAR_SIZES[size],\n            className,\n          )}\n        >\n          {initials}\n        </span>\n        <StatusDot\n          ring\n          tone={badge.tone ?? \"danger\"}\n          size={BADGE_SIZES[size]}\n          className=\"absolute -end-0.5 -top-0.5\"\n        />\n        <span className=\"sr-only\">{badge.label}</span>\n      </span>\n    );\n  }\n  return (\n    <span\n      // `aria-hidden` sits BEFORE the spread, unlike the structural attributes on the\n      // other components here, because it is a DEFAULT rather than an invariant. The\n      // avatar is decorative next to the name it belongs to — which is where all three\n      // apps render it — so hiding it stops a screen reader saying \"ME\" after the word\n      // \"Marcel Eifert\". A caller who renders one ALONE (an assignee column, a\n      // presence dot) needs the opposite, and now has it: `aria-hidden={false}` plus an\n      // `aria-label` arrives through `...rest` and wins.\n      aria-hidden\n      {...rest}\n      className={cn(\n        CHIP,\n        AVATAR_SIZES[size],\n        className,\n      )}\n    >\n      {initials}\n    </span>\n  );\n}\n"],"mappings":";AA2FM,SACE,KADF;AA1FN,SAAS,UAAU;AACnB,SAAS,sBAAsB;AAE/B,SAAS,oBAAoB;AAC7B,SAAS,iBAAiB;AAcnB,SAAS,eAAe,MAAsB,OAA+B;AAClF,QAAM,SAAS,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,OAAO,KAAK;AACpE,QAAM,QAAQ,OAAO,MAAM,KAAK,EAAE,OAAO,OAAO;AAChD,MAAI,MAAM,UAAU,EAAG,SAAQ,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,YAAY;AACtE,SAAO,OAAO,MAAM,GAAG,CAAC,EAAE,YAAY;AACxC;AAEA,MAAM,eAAe;AAAA,EACnB,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;AAEA,MAAM,OACJ;AAGF,MAAM,cAAgE,EAAE,IAAI,MAAM,IAAI,MAAM,IAAI,KAAK;AA8C9F,SAAS,WAAW,EAAE,MAAM,OAAO,QAAQ,OAAO,MAAM,OAAO,WAAW,GAAG,KAAK,GAAoB;AAC3G,QAAM,SAAS,aAAa;AAC5B,QAAM,YAAY,SAAS,eAAe,QAAQ,MAAM,IAAI,OAAO,eAAe,MAAM,KAAK;AAC7F,MAAI,OAAO;AAKT,WACE,qBAAC,UAAM,GAAG,MAAM,WAAU,iCACxB;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,eAAW;AAAA,UACX,WAAW;AAAA,YACT;AAAA,YACA,aAAa,IAAI;AAAA,YACjB;AAAA,UACF;AAAA,UAEC;AAAA;AAAA,MACH;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,MAAI;AAAA,UACJ,MAAM,MAAM,QAAQ;AAAA,UACpB,MAAM,YAAY,IAAI;AAAA,UACtB,WAAU;AAAA;AAAA,MACZ;AAAA,MACA,oBAAC,UAAK,WAAU,WAAW,gBAAM,OAAM;AAAA,OACzC;AAAA,EAEJ;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MAQC,eAAW;AAAA,MACV,GAAG;AAAA,MACJ,WAAW;AAAA,QACT;AAAA,QACA,aAAa,IAAI;AAAA,QACjB;AAAA,MACF;AAAA,MAEC;AAAA;AAAA,EACH;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/components/user-avatar.tsx"],"sourcesContent":["import type { ComponentPropsWithRef, ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { personInitials } from \"../lib/person-name\";\nimport type { PersonName } from \"../lib/person-name\";\nimport { useKitLocale } from \"../i18n/kit-labels\";\nimport { StatusDot } from \"./status-dot\";\nimport type { StatusDotSize, StatusDotTone } from \"./status-dot\";\n\n/** Initials from a display name (first + last) or, failing that, an email —\n *  e.g. \"Marcel Eifert\" → \"ME\", \"marcel@x.com\" → \"MA\". App-agnostic.\n *\n *  \"Failing that\" means BLANK, not merely absent. This was `name ?? email ?? \"?\"`,\n *  and `??` falls through on null/undefined alone — so an empty or whitespace-only\n *  display name short-circuited the email it had in hand and landed on the guard\n *  below, returning \"?\" for a user whose address says \"MA\" perfectly well. Keksdose\n *  cannot reach it (its `display_name` has `min_length=1`), but this is exported as\n *  app-agnostic, and any consumer whose profile name is optional free text got a wall\n *  of \"?\" chips. The guard is what shows the empty case was foreseen; it just\n *  answered it at the wrong end. */\nexport function avatarInitials(name?: string | null, email?: string | null): string {\n  const source = [name, email].map((s) => s?.trim()).find(Boolean) ?? \"?\";\n  const parts = source.split(/\\s+/).filter(Boolean);\n  if (parts.length >= 2) return (parts[0][0] + parts[1][0]).toUpperCase();\n  return source.slice(0, 2).toUpperCase();\n}\n\nconst AVATAR_SIZES = {\n  sm: \"size-7 text-caption\",\n  md: \"size-8 text-xs\",\n  lg: \"size-12 text-base\",\n} as const;\n\nconst CHIP =\n  \"inline-flex shrink-0 items-center justify-center rounded-full bg-inverse font-semibold text-inverse\";\n\n/** The dot grows with the avatar: 8px on `sm`, 10px on `md` (keksdose's), 12px on `lg`. */\nconst BADGE_SIZES: Record<keyof typeof AVATAR_SIZES, StatusDotSize> = { sm: \"sm\", md: \"md\", lg: \"lg\" };\n\n/** A status dot in the avatar's top corner — an unread count, presence. */\nexport interface UserAvatarBadge {\n  /** What the dot MEANS, for a screen reader (\"3 unread\"). Required: a coloured circle\n   *  says nothing to someone who cannot see it. */\n  label: ReactNode;\n  /** Default `danger`, the unread dot both apps draw by hand. */\n  tone?: StatusDotTone;\n}\n\n/** A `<span>`'s props, minus `children`: the content is the initials this computes\n *  from `person`/`name`/`email`, so there is nothing for a caller to put inside. */\nexport interface UserAvatarProps extends Omit<ComponentPropsWithRef<\"span\">, \"children\"> {\n  name?: string | null;\n  email?: string | null;\n  /**\n   * The person's first and last name (0.29.0, docs/auth-harmonization.md §3.2) —\n   * preferred over `name` whenever either part is filled in. The initials follow the\n   * READER's language, the provider's `locale`: \"AE\" for Ada Example, \"EA\" in Hungarian\n   * (family name first), the family name's first character alone in Chinese. See\n   * {@link personInitials}.\n   *\n   * `name` stays the fallback for an API that still sends only `display_name`, and\n   * `email` after it: a person whose two parts are both blank falls through to them.\n   * A migrated user (the whole old display name in `first`, no `last`, §3.3) keeps the\n   * initials they had.\n   */\n  person?: PersonName | null;\n  size?: keyof typeof AVATAR_SIZES;\n  /**\n   * A status dot in the top-end corner (the top-right in LTR, top-left in RTL), ringed\n   * in the surface colour so it reads as its own mark (keksdose account-menu ~385,\n   * top-bar :152). Its `label` is read as text where the dot sits — inside a button\n   * named by its content it joins that name. In `TopBarActionMenu`'s `trigger` the\n   * button is named by the menu's `aria-label` followed by this label: \"Account menu\n   * 3 unread\". The initials stay hidden either way, so the person's name is NOT part\n   * of it — put it in `aria-label` (\"Marcel Eifert, account menu\") if it should be.\n   */\n  badge?: UserAvatarBadge | null;\n}\n\n/**\n * A round initials avatar — the common user chip shared across apps (feedback\n * #333). Purely presentational; wrap it in a button for the account menu trigger.\n */\nexport function UserAvatar({ name, email, person, size = \"md\", badge, className, ...rest }: UserAvatarProps) {\n  const locale = useKitLocale();\n  const initials = (person ? personInitials(person, locale) : \"\") || avatarInitials(name, email);\n  if (badge) {\n    // A wrapper, because the chip itself is `aria-hidden` and the badge label must not\n    // be. `className` stays on the chip (a size override still sizes the circle); the\n    // other attributes go on the wrapper, which is what a caller addresses. `relative`\n    // also contains the sr-only text.\n    return (\n      <span {...rest} className=\"relative inline-flex shrink-0\">\n        <span\n          aria-hidden\n          className={cn(\n            CHIP,\n            AVATAR_SIZES[size],\n            className,\n          )}\n        >\n          {initials}\n        </span>\n        <StatusDot\n          ring\n          tone={badge.tone ?? \"danger\"}\n          size={BADGE_SIZES[size]}\n          className=\"absolute -end-0.5 -top-0.5\"\n        />\n        <span className=\"sr-only\">{badge.label}</span>\n      </span>\n    );\n  }\n  return (\n    <span\n      // `aria-hidden` sits BEFORE the spread, unlike the structural attributes on the\n      // other components here, because it is a DEFAULT rather than an invariant. The\n      // avatar is decorative next to the name it belongs to — which is where all three\n      // apps render it — so hiding it stops a screen reader saying \"ME\" after the word\n      // \"Marcel Eifert\". A caller who renders one ALONE (an assignee column, a\n      // presence dot) needs the opposite, and now has it: `aria-hidden={false}` plus an\n      // `aria-label` arrives through `...rest` and wins.\n      aria-hidden\n      {...rest}\n      className={cn(\n        CHIP,\n        AVATAR_SIZES[size],\n        className,\n      )}\n    >\n      {initials}\n    </span>\n  );\n}\n"],"mappings":";AA2FM,SACE,KADF;AA1FN,SAAS,UAAU;AACnB,SAAS,sBAAsB;AAE/B,SAAS,oBAAoB;AAC7B,SAAS,iBAAiB;AAcnB,SAAS,eAAe,MAAsB,OAA+B;AAClF,QAAM,SAAS,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,OAAO,KAAK;AACpE,QAAM,QAAQ,OAAO,MAAM,KAAK,EAAE,OAAO,OAAO;AAChD,MAAI,MAAM,UAAU,EAAG,SAAQ,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,GAAG,YAAY;AACtE,SAAO,OAAO,MAAM,GAAG,CAAC,EAAE,YAAY;AACxC;AAEA,MAAM,eAAe;AAAA,EACnB,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;AAEA,MAAM,OACJ;AAGF,MAAM,cAAgE,EAAE,IAAI,MAAM,IAAI,MAAM,IAAI,KAAK;AA8C9F,SAAS,WAAW,EAAE,MAAM,OAAO,QAAQ,OAAO,MAAM,OAAO,WAAW,GAAG,KAAK,GAAoB;AAC3G,QAAM,SAAS,aAAa;AAC5B,QAAM,YAAY,SAAS,eAAe,QAAQ,MAAM,IAAI,OAAO,eAAe,MAAM,KAAK;AAC7F,MAAI,OAAO;AAKT,WACE,qBAAC,UAAM,GAAG,MAAM,WAAU,iCACxB;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,eAAW;AAAA,UACX,WAAW;AAAA,YACT;AAAA,YACA,aAAa,IAAI;AAAA,YACjB;AAAA,UACF;AAAA,UAEC;AAAA;AAAA,MACH;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,MAAI;AAAA,UACJ,MAAM,MAAM,QAAQ;AAAA,UACpB,MAAM,YAAY,IAAI;AAAA,UACtB,WAAU;AAAA;AAAA,MACZ;AAAA,MACA,oBAAC,UAAK,WAAU,WAAW,gBAAM,OAAM;AAAA,OACzC;AAAA,EAEJ;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MAQC,eAAW;AAAA,MACV,GAAG;AAAA,MACJ,WAAW;AAAA,QACT;AAAA,QACA,aAAa,IAAI;AAAA,QACjB;AAAA,MACF;AAAA,MAEC;AAAA;AAAA,EACH;AAEJ;","names":[]}

package/dist/components/wizard-stepper.d.ts

@@ -1,14 +1,11 @@
-import * as react from 'react';
-
 /** Compact step indicator for the import wizards. Past steps are plain, the
  * current one is highlighted, future ones muted. */
-declare function WizardStepper({ steps, current, ariaLabel, }: {
+export declare function WizardStepper({ steps, current, "aria-label": ariaLabel, }: {
     steps: {
         key: string;
         label: string;
     }[];
     current: string;
-    ariaLabel?: string;
-}): react.JSX.Element;
-
-export { WizardStepper };
+    /** Names the list of steps ("Import steps"). */
+    "aria-label"?: string;
+}): import("react").JSX.Element;

package/dist/components/wizard-stepper.js

@@ -4,7 +4,7 @@ import { cn } from "../lib/cn.js";
 function WizardStepper({
   steps,
   current,
-  ariaLabel
+  "aria-label": ariaLabel
 }) {
   const currentIndex = steps.findIndex((s) => s.key === current);
   return (
@@ -13,14 +13,14 @@ function WizardStepper({
     // "Upload — Map columns — Confirm" ran 22 px past a 360 px phone at Extra large.
     // Where the steps fit, they stay one row.
     /* @__PURE__ */ jsx("ol", { className: "flex flex-wrap items-center gap-1 text-xs", "aria-label": ariaLabel, children: steps.map((step, i) => /* @__PURE__ */ jsxs("li", { className: "flex items-center gap-1", children: [
-      i > 0 && /* @__PURE__ */ jsx("span", { className: "w-4 border-t border-[var(--border)]" }),
+      i > 0 && /* @__PURE__ */ jsx("span", { className: "w-4 border-t border-subtle" }),
       /* @__PURE__ */ jsx(
         "span",
         {
           "aria-current": step.key === current ? "step" : void 0,
           className: cn(
             "rounded-full px-2 py-0.5",
-            i === currentIndex ? "bg-[var(--bg-inverse)] text-[var(--text-inverse)] font-medium" : i < currentIndex ? "text-[var(--text-secondary)]" : "text-[var(--text-placeholder)]"
+            i === currentIndex ? "bg-inverse text-inverse font-medium" : i < currentIndex ? "text-secondary" : "text-placeholder"
           ),
           children: step.label
         }

package/dist/components/wizard-stepper.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/wizard-stepper.tsx"],"sourcesContent":["import { cn } from \"../lib/cn\";\n\n/** Compact step indicator for the import wizards. Past steps are plain, the\n * current one is highlighted, future ones muted. */\nexport function WizardStepper({\n  steps,\n  current,\n  ariaLabel,\n}: {\n  steps: { key: string; label: string }[];\n  current: string;\n  ariaLabel?: string;\n}) {\n  const currentIndex = steps.findIndex((s) => s.key === current);\n  return (\n    // `flex-wrap`: the steps flow onto a second line rather than past the screen\n    // (0.32.1, the 360 px Extra-large sweep; docs/text-size-harmonization.md §4).\n    // \"Upload — Map columns — Confirm\" ran 22 px past a 360 px phone at Extra large.\n    // Where the steps fit, they stay one row.\n    <ol className=\"flex flex-wrap items-center gap-1 text-xs\" aria-label={ariaLabel}>\n      {steps.map((step, i) => (\n        <li key={step.key} className=\"flex items-center gap-1\">\n          {i > 0 && <span className=\"w-4 border-t border-[var(--border)]\" />}\n          <span\n            aria-current={step.key === current ? \"step\" : undefined}\n            className={cn(\n              \"rounded-full px-2 py-0.5\",\n              i === currentIndex\n                ? \"bg-[var(--bg-inverse)] text-[var(--text-inverse)] font-medium\"\n                : i < currentIndex\n                  ? \"text-[var(--text-secondary)]\"\n                  : \"text-[var(--text-placeholder)]\",\n            )}\n          >\n            {step.label}\n          </span>\n        </li>\n      ))}\n    </ol>\n  );\n}\n"],"mappings":";AAqBQ,SACY,KADZ;AArBR,SAAS,UAAU;AAIZ,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,eAAe,MAAM,UAAU,CAAC,MAAM,EAAE,QAAQ,OAAO;AAC7D;AAAA;AAAA;AAAA;AAAA;AAAA,IAKE,oBAAC,QAAG,WAAU,6CAA4C,cAAY,WACnE,gBAAM,IAAI,CAAC,MAAM,MAChB,qBAAC,QAAkB,WAAU,2BAC1B;AAAA,UAAI,KAAK,oBAAC,UAAK,WAAU,uCAAsC;AAAA,MAChE;AAAA,QAAC;AAAA;AAAA,UACC,gBAAc,KAAK,QAAQ,UAAU,SAAS;AAAA,UAC9C,WAAW;AAAA,YACT;AAAA,YACA,MAAM,eACF,kEACA,IAAI,eACF,iCACA;AAAA,UACR;AAAA,UAEC,eAAK;AAAA;AAAA,MACR;AAAA,SAdO,KAAK,GAed,CACD,GACH;AAAA;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/components/wizard-stepper.tsx"],"sourcesContent":["import { cn } from \"../lib/cn\";\n\n/** Compact step indicator for the import wizards. Past steps are plain, the\n * current one is highlighted, future ones muted. */\nexport function WizardStepper({\n  steps,\n  current,\n  \"aria-label\": ariaLabel,\n}: {\n  steps: { key: string; label: string }[];\n  current: string;\n  /** Names the list of steps (\"Import steps\"). */\n  \"aria-label\"?: string;\n}) {\n  const currentIndex = steps.findIndex((s) => s.key === current);\n  return (\n    // `flex-wrap`: the steps flow onto a second line rather than past the screen\n    // (0.32.1, the 360 px Extra-large sweep; docs/text-size-harmonization.md §4).\n    // \"Upload — Map columns — Confirm\" ran 22 px past a 360 px phone at Extra large.\n    // Where the steps fit, they stay one row.\n    <ol className=\"flex flex-wrap items-center gap-1 text-xs\" aria-label={ariaLabel}>\n      {steps.map((step, i) => (\n        <li key={step.key} className=\"flex items-center gap-1\">\n          {i > 0 && <span className=\"w-4 border-t border-subtle\" />}\n          <span\n            aria-current={step.key === current ? \"step\" : undefined}\n            className={cn(\n              \"rounded-full px-2 py-0.5\",\n              i === currentIndex\n                ? \"bg-inverse text-inverse font-medium\"\n                : i < currentIndex\n                  ? \"text-secondary\"\n                  : \"text-placeholder\",\n            )}\n          >\n            {step.label}\n          </span>\n        </li>\n      ))}\n    </ol>\n  );\n}\n"],"mappings":";AAsBQ,SACY,KADZ;AAtBR,SAAS,UAAU;AAIZ,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,cAAc;AAChB,GAKG;AACD,QAAM,eAAe,MAAM,UAAU,CAAC,MAAM,EAAE,QAAQ,OAAO;AAC7D;AAAA;AAAA;AAAA;AAAA;AAAA,IAKE,oBAAC,QAAG,WAAU,6CAA4C,cAAY,WACnE,gBAAM,IAAI,CAAC,MAAM,MAChB,qBAAC,QAAkB,WAAU,2BAC1B;AAAA,UAAI,KAAK,oBAAC,UAAK,WAAU,8BAA6B;AAAA,MACvD;AAAA,QAAC;AAAA;AAAA,UACC,gBAAc,KAAK,QAAQ,UAAU,SAAS;AAAA,UAC9C,WAAW;AAAA,YACT;AAAA,YACA,MAAM,eACF,wCACA,IAAI,eACF,mBACA;AAAA,UACR;AAAA,UAEC,eAAK;AAAA;AAAA,MACR;AAAA,SAdO,KAAK,GAed,CACD,GACH;AAAA;AAEJ;","names":[]}

package/dist/components/write-lock-labels.d.ts

@@ -0,0 +1,2 @@
+import type { WriteLockLabels } from "./write-lock.js";
+export declare const DEFAULT_WRITE_LOCK_LABELS: WriteLockLabels;

package/dist/components/write-lock-labels.js

@@ -0,0 +1,8 @@
+"use client";
+const DEFAULT_WRITE_LOCK_LABELS = {
+  reason: "You can view this but not change it."
+};
+export {
+  DEFAULT_WRITE_LOCK_LABELS
+};
+//# sourceMappingURL=write-lock-labels.js.map

package/dist/components/write-lock-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/write-lock-labels.ts"],"sourcesContent":["// The English words of ./write-lock, in a module with no component code: the English\n// catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one\n// chunk like the other languages (0.34, KS U8). ./write-lock re-exports them.\n\nimport type { WriteLockLabels } from \"./write-lock\";\n\nexport const DEFAULT_WRITE_LOCK_LABELS: WriteLockLabels = {\n  reason: \"You can view this but not change it.\",\n};\n"],"mappings":";AAMO,MAAM,4BAA6C;AAAA,EACxD,QAAQ;AACV;","names":[]}

package/dist/components/write-lock.d.ts

@@ -1,12 +1,12 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-
+import type { ReactNode } from "react";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import { DEFAULT_WRITE_LOCK_LABELS } from "./write-lock-labels.js";
 /** The words {@link WriteLockProvider} renders on its own behalf. */
-interface WriteLockLabels {
+export interface WriteLockLabels {
     /** The tooltip of a locked commit when the provider gives no `reason`. */
     reason: string;
 }
-declare const DEFAULT_WRITE_LOCK_LABELS: WriteLockLabels;
+export { DEFAULT_WRITE_LOCK_LABELS };
 /**
  * What kind of lock a source is (docs/billing-harmonization.md §12.36, ui-kit 0.33).
  * `"demo"` (the read-only demo, `demo.writeLocked`) and `"billing"` (a lapsed plan,
@@ -15,9 +15,9 @@ declare const DEFAULT_WRITE_LOCK_LABELS: WriteLockLabels;
  * A control exempts itself from a kind with {@link CommitScope}; a source without a
  * kind is never exempted.
  */
-type WriteLockKind = "demo" | "billing" | (string & {});
+export type WriteLockKind = "demo" | "billing" | (string & {});
 /** One locked source, as the provider holds it: its kind and its one sentence. */
-interface WriteLockHold {
+export interface WriteLockHold {
     kind: WriteLockKind | undefined;
     reason: ReactNode;
 }
@@ -35,20 +35,20 @@ interface WriteLockHold {
  * Under a demo lock and a billing lock together, a control exempt from billing is
  * still refused, with the demo's reason.
  */
-type CommitScope = boolean | {
+export type CommitScope = boolean | {
     readonly except: readonly WriteLockKind[];
 };
 /** Every lock but billing's: the scope of an action a lapsed plan still allows — removing
  *  access, the account's own settings, an operator's admin route (§12.13). One constant,
  *  so the call sites read alike. */
-declare const COMMIT_EXCEPT_BILLING: {
+export declare const COMMIT_EXCEPT_BILLING: {
     readonly except: readonly ["billing"];
 };
 /**
  * What {@link useWriteLock} returns: whether commits are locked here as a control with
  * the scope asked for sees it, and why.
  */
-interface WriteLock {
+export interface WriteLock {
     locked: boolean;
     /** The one sentence a locked commit shows in its tooltip: the first hold in scope's.
      *  Always set while `locked`; `undefined` when not. */
@@ -64,7 +64,7 @@ interface WriteLock {
      */
     holds: readonly WriteLockHold[];
 }
-interface WriteLockProviderProps {
+export interface WriteLockProviderProps {
     /** Commits below are locked. `false` unlocks a subtree under an outer lock. */
     locked: boolean;
     /**
@@ -84,7 +84,7 @@ interface WriteLockProviderProps {
      * `labels.reason`.
      */
     holds?: readonly WriteLockHold[];
-    labels?: Partial<WriteLockLabels>;
+    labels?: LabelOverride<WriteLockLabels>;
     children?: ReactNode;
 }
 /**
@@ -124,7 +124,7 @@ interface WriteLockProviderProps {
  * once — and an inner lock with its own reason (Kurvenschmiede's owner lock beside the
  * viewer lock) overrides the outer one's sentence and its holds.
  */
-declare function WriteLockProvider({ locked, reason, kind, holds, labels, children }: WriteLockProviderProps): react.JSX.Element;
+export declare function WriteLockProvider({ locked, reason, kind, holds, labels, children }: WriteLockProviderProps): import("react").JSX.Element;
 /**
  * The lock as a control with `scope` sees it — {@link useWriteLock}'s answer, pure, for
  * a scope known only at call time: `useConfirm` reads the CALLER's lock when it is
@@ -134,7 +134,7 @@ declare function WriteLockProvider({ locked, reason, kind, holds, labels, childr
  * lock as it is; `{ except }` sees the first hold of another kind, with its reason
  * and kind. `holds` is passed on unfiltered.
  */
-declare function writeLockFor(lock: WriteLock, scope: CommitScope | undefined): WriteLock;
+export declare function writeLockFor(lock: WriteLock, scope: CommitScope | undefined): WriteLock;
 /**
  * The nearest {@link WriteLockProvider}'s lock, as a control with `scope` sees it —
  * unlocked with no provider. Left out, the scope is `true`: every lock.
@@ -144,13 +144,11 @@ declare function writeLockFor(lock: WriteLock, scope: CommitScope | undefined):
  * `useWriteLock(COMMIT_EXCEPT_BILLING)` answers "would a lapsed plan's lock refuse me?"
  * as a removal sees it — what keksdose's `useWriteLockKind() !== "billing"` asked.
  */
-declare function useWriteLock(scope?: CommitScope): WriteLock;
+export declare function useWriteLock(scope?: CommitScope): WriteLock;
 /**
  * The `disabledReason` a control with `commit` should use: the lock's reason while
  * the lock refuses this scope — it wins over the control's own, since it is the answer
  * to the question the hover is asking — else the control's own. Internal to the kit's
  * commit controls.
  */
-declare function useCommitReason(commit: CommitScope | undefined, own: ReactNode): ReactNode;
-
-export { COMMIT_EXCEPT_BILLING, type CommitScope, DEFAULT_WRITE_LOCK_LABELS, type WriteLock, type WriteLockHold, type WriteLockKind, type WriteLockLabels, WriteLockProvider, type WriteLockProviderProps, useCommitReason, useWriteLock, writeLockFor };
+export declare function useCommitReason(commit: CommitScope | undefined, own: ReactNode): ReactNode;

package/dist/components/write-lock.js

@@ -2,26 +2,22 @@
 import { jsx } from "react/jsx-runtime";
 import { createContext, useContext, useMemo } from "react";
 import { useKitLabels } from "../i18n/kit-labels.js";
-const DEFAULT_WRITE_LOCK_LABELS = {
-  reason: "You can view this but not change it."
-};
+import { hasContent } from "../lib/presence.js";
+import { DEFAULT_WRITE_LOCK_LABELS } from "./write-lock-labels.js";
 const COMMIT_EXCEPT_BILLING = { except: ["billing"] };
 const NO_HOLDS = [];
 const UNLOCKED = { locked: false, reason: void 0, kind: void 0, holds: NO_HOLDS };
 const WriteLockContext = createContext(UNLOCKED);
-function given(reason) {
-  return reason !== void 0 && reason !== null && reason !== false && reason !== "";
-}
 function WriteLockProvider({ locked, reason, kind, holds, labels, children }) {
   const fallback = useKitLabels("writeLock", DEFAULT_WRITE_LOCK_LABELS, labels).reason;
   const several = locked && holds !== void 0 && holds.length > 0 ? holds : void 0;
   const firstKind = several ? several[0].kind : kind;
   const firstGiven = several ? several[0].reason : reason;
-  const firstReason = given(firstGiven) ? firstGiven : fallback;
+  const firstReason = hasContent(firstGiven) ? firstGiven : fallback;
   const many = several && several.length > 1 ? several : void 0;
   const value = useMemo(() => {
     if (!locked) return UNLOCKED;
-    const all = many ? many.map((hold) => ({ kind: hold.kind, reason: given(hold.reason) ? hold.reason : fallback })) : [{ kind: firstKind, reason: firstReason }];
+    const all = many ? many.map((hold) => ({ kind: hold.kind, reason: hasContent(hold.reason) ? hold.reason : fallback })) : [{ kind: firstKind, reason: firstReason }];
     return { locked: true, reason: firstReason, kind: firstKind, holds: all };
   }, [locked, many, firstKind, firstReason, fallback]);
   return /* @__PURE__ */ jsx(WriteLockContext.Provider, { value, children });

package/dist/components/write-lock.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/write-lock.tsx"],"sourcesContent":["import { createContext, useContext, useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\n\n/** The words {@link WriteLockProvider} renders on its own behalf. */\nexport interface WriteLockLabels {\n  /** The tooltip of a locked commit when the provider gives no `reason`. */\n  reason: string;\n}\n\nexport const DEFAULT_WRITE_LOCK_LABELS: WriteLockLabels = {\n  reason: \"You can view this but not change it.\",\n};\n\n/**\n * What kind of lock a source is (docs/billing-harmonization.md §12.36, ui-kit 0.33).\n * `\"demo\"` (the read-only demo, `demo.writeLocked`) and `\"billing\"` (a lapsed plan,\n * `billing.lockReason`) are the kit's; an app names its own — Kurvenschmiede's\n * `\"access\"` (a curve shared to view) and `\"customer\"` (an account that owns nothing).\n * A control exempts itself from a kind with {@link CommitScope}; a source without a\n * kind is never exempted.\n */\nexport type WriteLockKind = \"demo\" | \"billing\" | (string & {});\n\n/** One locked source, as the provider holds it: its kind and its one sentence. */\nexport interface WriteLockHold {\n  kind: WriteLockKind | undefined;\n  reason: ReactNode;\n}\n\n/**\n * A control's opt-in to the lock — the type of every `commit` prop in the kit.\n *\n * - `true`: every lock refuses the control (a save, an add, an invite).\n * - `{ except: [kinds] }`: every lock but those kinds. A billing lock leaves the\n *   reader able to remove access, revoke sessions, delete the account and change their\n *   own settings (§3.3, §12.13), so the kit's parts for those take\n *   {@link COMMIT_EXCEPT_BILLING} built in, and an app's own controls of that sort do\n *   too.\n * - `false` or left out: no lock reaches it.\n *\n * Under a demo lock and a billing lock together, a control exempt from billing is\n * still refused, with the demo's reason.\n */\nexport type CommitScope = boolean | { readonly except: readonly WriteLockKind[] };\n\n/** Every lock but billing's: the scope of an action a lapsed plan still allows — removing\n *  access, the account's own settings, an operator's admin route (§12.13). One constant,\n *  so the call sites read alike. */\nexport const COMMIT_EXCEPT_BILLING = { except: [\"billing\"] } as const;\n\n/**\n * What {@link useWriteLock} returns: whether commits are locked here as a control with\n * the scope asked for sees it, and why.\n */\nexport interface WriteLock {\n  locked: boolean;\n  /** The one sentence a locked commit shows in its tooltip: the first hold in scope's.\n   *  Always set while `locked`; `undefined` when not. */\n  reason: ReactNode | undefined;\n  /** The first hold in scope's kind; `undefined` while unlocked, or for a source that\n   *  names none. */\n  kind: WriteLockKind | undefined;\n  /**\n   * EVERY locked source the provider holds, in the order the server refuses them\n   * (§12.3: the demo's 403 before billing's 402) — unfiltered by the scope, for code\n   * that must know what else locks (a toast that names the plan, a swipe plan). Empty\n   * while the provider is unlocked.\n   */\n  holds: readonly WriteLockHold[];\n}\n\nconst NO_HOLDS: readonly WriteLockHold[] = [];\n\nconst UNLOCKED: WriteLock = { locked: false, reason: undefined, kind: undefined, holds: NO_HOLDS };\n\nconst WriteLockContext = createContext<WriteLock>(UNLOCKED);\n\nexport interface WriteLockProviderProps {\n  /** Commits below are locked. `false` unlocks a subtree under an outer lock. */\n  locked: boolean;\n  /**\n   * The one sentence that says why — \"Shared with you to read\", \"Read-only demo —\n   * saving is disabled\", \"A customer account cannot create curves\". The app's policy,\n   * already translated. Left out: `labels.reason`.\n   */\n  reason?: ReactNode;\n  /** What kind of lock this is — `\"demo\"`, `\"billing\"` or the app's own (see\n   *  {@link WriteLockKind}), for a provider of one source. Left out, no control can be\n   *  exempt from it. */\n  kind?: WriteLockKind;\n  /**\n   * Every locked source, in refusal order — what `combineWriteLocks` answers, so\n   * `<WriteLockProvider {...combineWriteLocks([...])}>` carries them. Given while\n   * `locked`, it wins over `kind` and `reason`; a hold without a reason takes\n   * `labels.reason`.\n   */\n  holds?: readonly WriteLockHold[];\n  labels?: Partial<WriteLockLabels>;\n  children?: ReactNode;\n}\n\n// `null`/`\"\"`/`false` count as \"no reason given\": a lock whose tooltip is empty would be\n// a disabled button that cannot say why, the thing this replaces.\nfunction given(reason: ReactNode): boolean {\n  return reason !== undefined && reason !== null && reason !== false && reason !== \"\";\n}\n\n/**\n * The read-only lock — **everything renders; only the commit is locked.**\n *\n * keksdose (features/budgets/write-lock.tsx, the read-only demo budget) and\n * Kurvenschmiede (features/sharing/write-lock.tsx, a curve shared to view, a customer\n * account that owns nothing) each built the same `SaveGuard`: the page, its tabs,\n * forms and dialogs render exactly as for an owner, because a viewer looking at half\n * a page is not looking at what they were sent; what changes is that the control\n * that SAVES is off and says why on hover or focus. Both wrapped each Save in a\n * Tooltip and forced a native `disabled` on it — out of the tab order, so the reason\n * never reached a keyboard — and both had to remember it at thirty call sites.\n *\n * Here the page mounts one provider and each commit control opts in with `commit`\n * ({@link Button}, {@link IconButton}, {@link FormActions}): under a lock it takes the\n * kit's `disabledReason` path with this reason — `aria-disabled` and focusable,\n * every activation swallowed, the reason in the kit Tooltip and its description.\n *\n * Who is locked is the app's: the provider takes a boolean, never a role. Fields stay\n * editable — nothing in them reaches the server until the commit is pressed, and a\n * form you cannot fill in is not a demo of the form (keksdose accounts-page). A\n * control that IS its own commit (a toggle that saves on change) reads\n * {@link useWriteLock} and disables itself. The lock is a courtesy, not a guard: the\n * server still refuses the write.\n *\n * **A lock says its source** (0.33, docs/billing-harmonization.md §12.36). A lapsed\n * plan locks creating and changing, but not removing access or the account's own\n * settings (§3.3, §12.13), and the kit's parts for those hard-coded `commit` — so\n * kastlan's app-wide lock locked a member's own sign-out everywhere. Each source now\n * has a kind, the provider holds every locked one in order (`holds`, from\n * `combineWriteLocks`), and a control's `commit` may name the kinds it is exempt from\n * ({@link CommitScope}). The kit's parts follow §3.3 and §12.13 by themselves.\n *\n * Nested providers: the nearest wins, so an inner `locked={false}` reopens a section\n * the caller may write (a viewer's own notes on a shared curve) — every source at\n * once — and an inner lock with its own reason (Kurvenschmiede's owner lock beside the\n * viewer lock) overrides the outer one's sentence and its holds.\n */\nexport function WriteLockProvider({ locked, reason, kind, holds, labels, children }: WriteLockProviderProps) {\n  // The `writeLock` namespace: prop > `<UiKitProvider labels>` > English.\n  const fallback = useKitLabels(\"writeLock\", DEFAULT_WRITE_LOCK_LABELS, labels).reason;\n  // `holds` wins while it has any; otherwise this provider is one source of its own.\n  const several = locked && holds !== undefined && holds.length > 0 ? holds : undefined;\n  const firstKind = several ? several[0].kind : kind;\n  const firstGiven = several ? several[0].reason : reason;\n  const firstReason = given(firstGiven) ? firstGiven : fallback;\n  // Memoised on the first hold's kind and sentence — the strings an app passes — so a\n  // one-source lock keeps one context value across renders; a list of several is\n  // memoised on its own identity.\n  const many = several && several.length > 1 ? several : undefined;\n  const value = useMemo<WriteLock>(() => {\n    if (!locked) return UNLOCKED;\n    const all = many\n      ? many.map((hold) => ({ kind: hold.kind, reason: given(hold.reason) ? hold.reason : fallback }))\n      : [{ kind: firstKind, reason: firstReason }];\n    return { locked: true, reason: firstReason, kind: firstKind, holds: all };\n  }, [locked, many, firstKind, firstReason, fallback]);\n  return <WriteLockContext.Provider value={value}>{children}</WriteLockContext.Provider>;\n}\n\n/**\n * Whether a hold refuses a control with this scope: `true` refuses with every hold,\n * `{ except }` with every hold whose kind it does not name. A hold with no kind is\n * never exempted — an app that forgot to name its source must not reopen by accident.\n */\nfunction inScope(hold: WriteLockHold, scope: CommitScope): boolean {\n  if (scope === true) return true;\n  if (scope === false) return false;\n  return hold.kind === undefined || !scope.except.includes(hold.kind);\n}\n\n/**\n * The lock as a control with `scope` sees it — {@link useWriteLock}'s answer, pure, for\n * a scope known only at call time: `useConfirm` reads the CALLER's lock when it is\n * called, and applies each `confirm({ commit })`'s own scope to it when it runs.\n *\n * `undefined` and `false` see no lock (a control without `commit`); `true` sees the\n * lock as it is; `{ except }` sees the first hold of another kind, with its reason\n * and kind. `holds` is passed on unfiltered.\n */\nexport function writeLockFor(lock: WriteLock, scope: CommitScope | undefined): WriteLock {\n  if (!lock.locked || scope === true) return lock;\n  // A lock built by hand (a test's, an app's own context) may carry no holds: it is\n  // then the one source it describes.\n  const holds = lock.holds.length > 0 ? lock.holds : [{ kind: lock.kind, reason: lock.reason }];\n  const first = scope === undefined ? undefined : holds.find((hold) => inScope(hold, scope));\n  if (!first) return { ...UNLOCKED, holds: lock.holds };\n  // The first in scope is the provider's own first: the lock as it is, same object.\n  if (first === holds[0]) return lock;\n  return { locked: true, reason: first.reason, kind: first.kind, holds: lock.holds };\n}\n\n/**\n * The nearest {@link WriteLockProvider}'s lock, as a control with `scope` sees it —\n * unlocked with no provider. Left out, the scope is `true`: every lock.\n *\n * For code that must KNOW rather than a control that opts in: a toast that says why,\n * a swipe plan that leaves an action out, a hand-rolled toggle that disables itself.\n * `useWriteLock(COMMIT_EXCEPT_BILLING)` answers \"would a lapsed plan's lock refuse me?\"\n * as a removal sees it — what keksdose's `useWriteLockKind() !== \"billing\"` asked.\n */\nexport function useWriteLock(scope: CommitScope = true): WriteLock {\n  return writeLockFor(useContext(WriteLockContext), scope);\n}\n\n/**\n * The `disabledReason` a control with `commit` should use: the lock's reason while\n * the lock refuses this scope — it wins over the control's own, since it is the answer\n * to the question the hover is asking — else the control's own. Internal to the kit's\n * commit controls.\n */\nexport function useCommitReason(commit: CommitScope | undefined, own: ReactNode): ReactNode {\n  const lock = writeLockFor(useContext(WriteLockContext), commit);\n  return lock.locked ? lock.reason : own;\n}\n"],"mappings":";AAoKS;AApKT,SAAS,eAAe,YAAY,eAAe;AAEnD,SAAS,oBAAoB;AAQtB,MAAM,4BAA6C;AAAA,EACxD,QAAQ;AACV;AAqCO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,SAAS,EAAE;AAuB3D,MAAM,WAAqC,CAAC;AAE5C,MAAM,WAAsB,EAAE,QAAQ,OAAO,QAAQ,QAAW,MAAM,QAAW,OAAO,SAAS;AAEjG,MAAM,mBAAmB,cAAyB,QAAQ;AA4B1D,SAAS,MAAM,QAA4B;AACzC,SAAO,WAAW,UAAa,WAAW,QAAQ,WAAW,SAAS,WAAW;AACnF;AAuCO,SAAS,kBAAkB,EAAE,QAAQ,QAAQ,MAAM,OAAO,QAAQ,SAAS,GAA2B;AAE3G,QAAM,WAAW,aAAa,aAAa,2BAA2B,MAAM,EAAE;AAE9E,QAAM,UAAU,UAAU,UAAU,UAAa,MAAM,SAAS,IAAI,QAAQ;AAC5E,QAAM,YAAY,UAAU,QAAQ,CAAC,EAAE,OAAO;AAC9C,QAAM,aAAa,UAAU,QAAQ,CAAC,EAAE,SAAS;AACjD,QAAM,cAAc,MAAM,UAAU,IAAI,aAAa;AAIrD,QAAM,OAAO,WAAW,QAAQ,SAAS,IAAI,UAAU;AACvD,QAAM,QAAQ,QAAmB,MAAM;AACrC,QAAI,CAAC,OAAQ,QAAO;AACpB,UAAM,MAAM,OACR,KAAK,IAAI,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,QAAQ,MAAM,KAAK,MAAM,IAAI,KAAK,SAAS,SAAS,EAAE,IAC7F,CAAC,EAAE,MAAM,WAAW,QAAQ,YAAY,CAAC;AAC7C,WAAO,EAAE,QAAQ,MAAM,QAAQ,aAAa,MAAM,WAAW,OAAO,IAAI;AAAA,EAC1E,GAAG,CAAC,QAAQ,MAAM,WAAW,aAAa,QAAQ,CAAC;AACnD,SAAO,oBAAC,iBAAiB,UAAjB,EAA0B,OAAe,UAAS;AAC5D;AAOA,SAAS,QAAQ,MAAqB,OAA6B;AACjE,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,UAAU,MAAO,QAAO;AAC5B,SAAO,KAAK,SAAS,UAAa,CAAC,MAAM,OAAO,SAAS,KAAK,IAAI;AACpE;AAWO,SAAS,aAAa,MAAiB,OAA2C;AACvF,MAAI,CAAC,KAAK,UAAU,UAAU,KAAM,QAAO;AAG3C,QAAM,QAAQ,KAAK,MAAM,SAAS,IAAI,KAAK,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,QAAQ,KAAK,OAAO,CAAC;AAC5F,QAAM,QAAQ,UAAU,SAAY,SAAY,MAAM,KAAK,CAAC,SAAS,QAAQ,MAAM,KAAK,CAAC;AACzF,MAAI,CAAC,MAAO,QAAO,EAAE,GAAG,UAAU,OAAO,KAAK,MAAM;AAEpD,MAAI,UAAU,MAAM,CAAC,EAAG,QAAO;AAC/B,SAAO,EAAE,QAAQ,MAAM,QAAQ,MAAM,QAAQ,MAAM,MAAM,MAAM,OAAO,KAAK,MAAM;AACnF;AAWO,SAAS,aAAa,QAAqB,MAAiB;AACjE,SAAO,aAAa,WAAW,gBAAgB,GAAG,KAAK;AACzD;AAQO,SAAS,gBAAgB,QAAiC,KAA2B;AAC1F,QAAM,OAAO,aAAa,WAAW,gBAAgB,GAAG,MAAM;AAC9D,SAAO,KAAK,SAAS,KAAK,SAAS;AACrC;","names":[]}
+{"version":3,"sources":["../../src/components/write-lock.tsx"],"sourcesContent":["import { createContext, useContext, useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { hasContent } from \"../lib/presence\";\nimport { DEFAULT_WRITE_LOCK_LABELS } from \"./write-lock-labels\";\n\n/** The words {@link WriteLockProvider} renders on its own behalf. */\nexport interface WriteLockLabels {\n  /** The tooltip of a locked commit when the provider gives no `reason`. */\n  reason: string;\n}\n\n// Defined in ./write-lock-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_WRITE_LOCK_LABELS };\n\n/**\n * What kind of lock a source is (docs/billing-harmonization.md §12.36, ui-kit 0.33).\n * `\"demo\"` (the read-only demo, `demo.writeLocked`) and `\"billing\"` (a lapsed plan,\n * `billing.lockReason`) are the kit's; an app names its own — Kurvenschmiede's\n * `\"access\"` (a curve shared to view) and `\"customer\"` (an account that owns nothing).\n * A control exempts itself from a kind with {@link CommitScope}; a source without a\n * kind is never exempted.\n */\nexport type WriteLockKind = \"demo\" | \"billing\" | (string & {});\n\n/** One locked source, as the provider holds it: its kind and its one sentence. */\nexport interface WriteLockHold {\n  kind: WriteLockKind | undefined;\n  reason: ReactNode;\n}\n\n/**\n * A control's opt-in to the lock — the type of every `commit` prop in the kit.\n *\n * - `true`: every lock refuses the control (a save, an add, an invite).\n * - `{ except: [kinds] }`: every lock but those kinds. A billing lock leaves the\n *   reader able to remove access, revoke sessions, delete the account and change their\n *   own settings (§3.3, §12.13), so the kit's parts for those take\n *   {@link COMMIT_EXCEPT_BILLING} built in, and an app's own controls of that sort do\n *   too.\n * - `false` or left out: no lock reaches it.\n *\n * Under a demo lock and a billing lock together, a control exempt from billing is\n * still refused, with the demo's reason.\n */\nexport type CommitScope = boolean | { readonly except: readonly WriteLockKind[] };\n\n/** Every lock but billing's: the scope of an action a lapsed plan still allows — removing\n *  access, the account's own settings, an operator's admin route (§12.13). One constant,\n *  so the call sites read alike. */\nexport const COMMIT_EXCEPT_BILLING = { except: [\"billing\"] } as const;\n\n/**\n * What {@link useWriteLock} returns: whether commits are locked here as a control with\n * the scope asked for sees it, and why.\n */\nexport interface WriteLock {\n  locked: boolean;\n  /** The one sentence a locked commit shows in its tooltip: the first hold in scope's.\n   *  Always set while `locked`; `undefined` when not. */\n  reason: ReactNode | undefined;\n  /** The first hold in scope's kind; `undefined` while unlocked, or for a source that\n   *  names none. */\n  kind: WriteLockKind | undefined;\n  /**\n   * EVERY locked source the provider holds, in the order the server refuses them\n   * (§12.3: the demo's 403 before billing's 402) — unfiltered by the scope, for code\n   * that must know what else locks (a toast that names the plan, a swipe plan). Empty\n   * while the provider is unlocked.\n   */\n  holds: readonly WriteLockHold[];\n}\n\nconst NO_HOLDS: readonly WriteLockHold[] = [];\n\nconst UNLOCKED: WriteLock = { locked: false, reason: undefined, kind: undefined, holds: NO_HOLDS };\n\nconst WriteLockContext = createContext<WriteLock>(UNLOCKED);\n\nexport interface WriteLockProviderProps {\n  /** Commits below are locked. `false` unlocks a subtree under an outer lock. */\n  locked: boolean;\n  /**\n   * The one sentence that says why — \"Shared with you to read\", \"Read-only demo —\n   * saving is disabled\", \"A customer account cannot create curves\". The app's policy,\n   * already translated. Left out: `labels.reason`.\n   */\n  reason?: ReactNode;\n  /** What kind of lock this is — `\"demo\"`, `\"billing\"` or the app's own (see\n   *  {@link WriteLockKind}), for a provider of one source. Left out, no control can be\n   *  exempt from it. */\n  kind?: WriteLockKind;\n  /**\n   * Every locked source, in refusal order — what `combineWriteLocks` answers, so\n   * `<WriteLockProvider {...combineWriteLocks([...])}>` carries them. Given while\n   * `locked`, it wins over `kind` and `reason`; a hold without a reason takes\n   * `labels.reason`.\n   */\n  holds?: readonly WriteLockHold[];\n  labels?: LabelOverride<WriteLockLabels>;\n  children?: ReactNode;\n}\n\n// `null`/`\"\"`/`false` count as \"no reason given\" (`hasContent`): a lock whose tooltip is\n// empty would be a disabled button that cannot say why, the thing this replaces.\n\n/**\n * The read-only lock — **everything renders; only the commit is locked.**\n *\n * keksdose (features/budgets/write-lock.tsx, the read-only demo budget) and\n * Kurvenschmiede (features/sharing/write-lock.tsx, a curve shared to view, a customer\n * account that owns nothing) each built the same `SaveGuard`: the page, its tabs,\n * forms and dialogs render exactly as for an owner, because a viewer looking at half\n * a page is not looking at what they were sent; what changes is that the control\n * that SAVES is off and says why on hover or focus. Both wrapped each Save in a\n * Tooltip and forced a native `disabled` on it — out of the tab order, so the reason\n * never reached a keyboard — and both had to remember it at thirty call sites.\n *\n * Here the page mounts one provider and each commit control opts in with `commit`\n * ({@link Button}, {@link IconButton}, {@link FormActions}): under a lock it takes the\n * kit's `disabledReason` path with this reason — `aria-disabled` and focusable,\n * every activation swallowed, the reason in the kit Tooltip and its description.\n *\n * Who is locked is the app's: the provider takes a boolean, never a role. Fields stay\n * editable — nothing in them reaches the server until the commit is pressed, and a\n * form you cannot fill in is not a demo of the form (keksdose accounts-page). A\n * control that IS its own commit (a toggle that saves on change) reads\n * {@link useWriteLock} and disables itself. The lock is a courtesy, not a guard: the\n * server still refuses the write.\n *\n * **A lock says its source** (0.33, docs/billing-harmonization.md §12.36). A lapsed\n * plan locks creating and changing, but not removing access or the account's own\n * settings (§3.3, §12.13), and the kit's parts for those hard-coded `commit` — so\n * kastlan's app-wide lock locked a member's own sign-out everywhere. Each source now\n * has a kind, the provider holds every locked one in order (`holds`, from\n * `combineWriteLocks`), and a control's `commit` may name the kinds it is exempt from\n * ({@link CommitScope}). The kit's parts follow §3.3 and §12.13 by themselves.\n *\n * Nested providers: the nearest wins, so an inner `locked={false}` reopens a section\n * the caller may write (a viewer's own notes on a shared curve) — every source at\n * once — and an inner lock with its own reason (Kurvenschmiede's owner lock beside the\n * viewer lock) overrides the outer one's sentence and its holds.\n */\nexport function WriteLockProvider({ locked, reason, kind, holds, labels, children }: WriteLockProviderProps) {\n  // The `writeLock` namespace: prop > `<UiKitProvider labels>` > English.\n  const fallback = useKitLabels(\"writeLock\", DEFAULT_WRITE_LOCK_LABELS, labels).reason;\n  // `holds` wins while it has any; otherwise this provider is one source of its own.\n  const several = locked && holds !== undefined && holds.length > 0 ? holds : undefined;\n  const firstKind = several ? several[0].kind : kind;\n  const firstGiven = several ? several[0].reason : reason;\n  const firstReason = hasContent(firstGiven) ? firstGiven : fallback;\n  // Memoised on the first hold's kind and sentence — the strings an app passes — so a\n  // one-source lock keeps one context value across renders; a list of several is\n  // memoised on its own identity.\n  const many = several && several.length > 1 ? several : undefined;\n  const value = useMemo<WriteLock>(() => {\n    if (!locked) return UNLOCKED;\n    const all = many\n      ? many.map((hold) => ({ kind: hold.kind, reason: hasContent(hold.reason) ? hold.reason : fallback }))\n      : [{ kind: firstKind, reason: firstReason }];\n    return { locked: true, reason: firstReason, kind: firstKind, holds: all };\n  }, [locked, many, firstKind, firstReason, fallback]);\n  return <WriteLockContext.Provider value={value}>{children}</WriteLockContext.Provider>;\n}\n\n/**\n * Whether a hold refuses a control with this scope: `true` refuses with every hold,\n * `{ except }` with every hold whose kind it does not name. A hold with no kind is\n * never exempted — an app that forgot to name its source must not reopen by accident.\n */\nfunction inScope(hold: WriteLockHold, scope: CommitScope): boolean {\n  if (scope === true) return true;\n  if (scope === false) return false;\n  return hold.kind === undefined || !scope.except.includes(hold.kind);\n}\n\n/**\n * The lock as a control with `scope` sees it — {@link useWriteLock}'s answer, pure, for\n * a scope known only at call time: `useConfirm` reads the CALLER's lock when it is\n * called, and applies each `confirm({ commit })`'s own scope to it when it runs.\n *\n * `undefined` and `false` see no lock (a control without `commit`); `true` sees the\n * lock as it is; `{ except }` sees the first hold of another kind, with its reason\n * and kind. `holds` is passed on unfiltered.\n */\nexport function writeLockFor(lock: WriteLock, scope: CommitScope | undefined): WriteLock {\n  if (!lock.locked || scope === true) return lock;\n  // A lock built by hand (a test's, an app's own context) may carry no holds: it is\n  // then the one source it describes.\n  const holds = lock.holds.length > 0 ? lock.holds : [{ kind: lock.kind, reason: lock.reason }];\n  const first = scope === undefined ? undefined : holds.find((hold) => inScope(hold, scope));\n  if (!first) return { ...UNLOCKED, holds: lock.holds };\n  // The first in scope is the provider's own first: the lock as it is, same object.\n  if (first === holds[0]) return lock;\n  return { locked: true, reason: first.reason, kind: first.kind, holds: lock.holds };\n}\n\n/**\n * The nearest {@link WriteLockProvider}'s lock, as a control with `scope` sees it —\n * unlocked with no provider. Left out, the scope is `true`: every lock.\n *\n * For code that must KNOW rather than a control that opts in: a toast that says why,\n * a swipe plan that leaves an action out, a hand-rolled toggle that disables itself.\n * `useWriteLock(COMMIT_EXCEPT_BILLING)` answers \"would a lapsed plan's lock refuse me?\"\n * as a removal sees it — what keksdose's `useWriteLockKind() !== \"billing\"` asked.\n */\nexport function useWriteLock(scope: CommitScope = true): WriteLock {\n  return writeLockFor(useContext(WriteLockContext), scope);\n}\n\n/**\n * The `disabledReason` a control with `commit` should use: the lock's reason while\n * the lock refuses this scope — it wins over the control's own, since it is the answer\n * to the question the hover is asking — else the control's own. Internal to the kit's\n * commit controls.\n */\nexport function useCommitReason(commit: CommitScope | undefined, own: ReactNode): ReactNode {\n  const lock = writeLockFor(useContext(WriteLockContext), commit);\n  return lock.locked ? lock.reason : own;\n}\n"],"mappings":";AAkKS;AAlKT,SAAS,eAAe,YAAY,eAAe;AAEnD,SAAS,oBAAwC;AACjD,SAAS,kBAAkB;AAC3B,SAAS,iCAAiC;AA8CnC,MAAM,wBAAwB,EAAE,QAAQ,CAAC,SAAS,EAAE;AAuB3D,MAAM,WAAqC,CAAC;AAE5C,MAAM,WAAsB,EAAE,QAAQ,OAAO,QAAQ,QAAW,MAAM,QAAW,OAAO,SAAS;AAEjG,MAAM,mBAAmB,cAAyB,QAAQ;AAkEnD,SAAS,kBAAkB,EAAE,QAAQ,QAAQ,MAAM,OAAO,QAAQ,SAAS,GAA2B;AAE3G,QAAM,WAAW,aAAa,aAAa,2BAA2B,MAAM,EAAE;AAE9E,QAAM,UAAU,UAAU,UAAU,UAAa,MAAM,SAAS,IAAI,QAAQ;AAC5E,QAAM,YAAY,UAAU,QAAQ,CAAC,EAAE,OAAO;AAC9C,QAAM,aAAa,UAAU,QAAQ,CAAC,EAAE,SAAS;AACjD,QAAM,cAAc,WAAW,UAAU,IAAI,aAAa;AAI1D,QAAM,OAAO,WAAW,QAAQ,SAAS,IAAI,UAAU;AACvD,QAAM,QAAQ,QAAmB,MAAM;AACrC,QAAI,CAAC,OAAQ,QAAO;AACpB,UAAM,MAAM,OACR,KAAK,IAAI,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,QAAQ,WAAW,KAAK,MAAM,IAAI,KAAK,SAAS,SAAS,EAAE,IAClG,CAAC,EAAE,MAAM,WAAW,QAAQ,YAAY,CAAC;AAC7C,WAAO,EAAE,QAAQ,MAAM,QAAQ,aAAa,MAAM,WAAW,OAAO,IAAI;AAAA,EAC1E,GAAG,CAAC,QAAQ,MAAM,WAAW,aAAa,QAAQ,CAAC;AACnD,SAAO,oBAAC,iBAAiB,UAAjB,EAA0B,OAAe,UAAS;AAC5D;AAOA,SAAS,QAAQ,MAAqB,OAA6B;AACjE,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,UAAU,MAAO,QAAO;AAC5B,SAAO,KAAK,SAAS,UAAa,CAAC,MAAM,OAAO,SAAS,KAAK,IAAI;AACpE;AAWO,SAAS,aAAa,MAAiB,OAA2C;AACvF,MAAI,CAAC,KAAK,UAAU,UAAU,KAAM,QAAO;AAG3C,QAAM,QAAQ,KAAK,MAAM,SAAS,IAAI,KAAK,QAAQ,CAAC,EAAE,MAAM,KAAK,MAAM,QAAQ,KAAK,OAAO,CAAC;AAC5F,QAAM,QAAQ,UAAU,SAAY,SAAY,MAAM,KAAK,CAAC,SAAS,QAAQ,MAAM,KAAK,CAAC;AACzF,MAAI,CAAC,MAAO,QAAO,EAAE,GAAG,UAAU,OAAO,KAAK,MAAM;AAEpD,MAAI,UAAU,MAAM,CAAC,EAAG,QAAO;AAC/B,SAAO,EAAE,QAAQ,MAAM,QAAQ,MAAM,QAAQ,MAAM,MAAM,MAAM,OAAO,KAAK,MAAM;AACnF;AAWO,SAAS,aAAa,QAAqB,MAAiB;AACjE,SAAO,aAAa,WAAW,gBAAgB,GAAG,KAAK;AACzD;AAQO,SAAS,gBAAgB,QAAiC,KAA2B;AAC1F,QAAM,OAAO,aAAa,WAAW,gBAAgB,GAAG,MAAM;AAC9D,SAAO,KAAK,SAAS,KAAK,SAAS;AACrC;","names":[]}

package/dist/currencies.d.ts

@@ -0,0 +1,23 @@
+export interface CurrencyOption {
+    code: string;
+    name: string;
+    symbol: string;
+    /** ISO 3166-1 alpha-2 country code (lowercase) used by flag-icons. */
+    country: string;
+}
+export declare const CURRENCIES: CurrencyOption[];
+/**
+ * Each currency code → the flag the kit paints for it: the lowercase ISO 3166-1 alpha-2
+ * code flag-icons names it by (`fi-ch`, `flags/4x3/ch.svg`). `CHF` → `"ch"`, `EUR` →
+ * `"eu"` (flag-icons has the EU's flag under that code).
+ *
+ * Derived from {@link CURRENCIES}, so a currency the pickers gain is a flag here too. An
+ * app that ships only the flags it renders builds its subset from these values:
+ *
+ * ```ts
+ * // vite.config.ts — plain Node, no DOM
+ * import { CURRENCY_COUNTRIES } from "@eifi1/ui-kit/currencies";
+ * const flags = new Set(Object.values(CURRENCY_COUNTRIES));
+ * ```
+ */
+export declare const CURRENCY_COUNTRIES: Record<string, string>;