@eifi1/ui-kit 0.51.4 → 0.51.6

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/use-table-state.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { SetStateAction } from \"react\";\nimport * as ReactRouter from \"react-router\";\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  /** 0.48: the `defaultHidden` columns the user ticked back on — an entry that beats the\n   *  default. Written only when non-empty, so a table without such columns stores what\n   *  it always did. */\n  shown?: string[];\n}\n\n/** The hidden set as drawn: the stored one plus every `defaultHidden` column the view\n *  holds no entry for (neither hidden nor `shown`). */\nfunction withDefaultHidden(view: { hidden: Set<string>; shown: Set<string> }, defaults: string[]): Set<string> {\n  const extra = defaults.filter((k) => !view.hidden.has(k) && !view.shown.has(k));\n  return extra.length === 0 ? view.hidden : new Set([...view.hidden, ...extra]);\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/** What a table reads and writes the URL through: react-router's, or none. */\ninterface TableSearch {\n  searchParams: URLSearchParams;\n  setSearchParams: ReturnType<typeof useSearchParams>[1];\n  locationState: unknown;\n}\n\nfunction useRouterSearch(): TableSearch {\n  const [searchParams, setSearchParams] = useSearchParams();\n  const location = useLocation();\n  return { searchParams, setSearchParams, locationState: location.state };\n}\n\nconst NO_ROUTER_SEARCH: TableSearch = {\n  searchParams: new URLSearchParams(),\n  setSearchParams: () => {},\n  locationState: null,\n};\nfunction useNoRouterSearch(): TableSearch {\n  return NO_ROUTER_SEARCH;\n}\n\n/**\n * `useInRouterContext`, read off the namespace inside a `try` like\n * use-search-param-state's probe: a test's `vi.mock(\"react-router\", () => ({ … }))`\n * without it throws on the read. Missing, a table assumes a Router, as before 0.49.\n */\nfunction readInRouterContext(): () => boolean {\n  try {\n    return (ReactRouter as unknown as { useInRouterContext?: () => boolean }).useInRouterContext ?? (() => true);\n  } catch {\n    return () => true;\n  }\n}\nconst useInRouterContext = readInRouterContext();\n\n/**\n * The URL access a table needs (0.49, KIT-3). Without `urlSync` a table needs no Router:\n * before 0.49 it called `useSearchParams()` unconditionally and threw outside one even\n * with URL sync off. With `urlSync` and no Router, a development build throws a message\n * that names the fix; a production build keeps the view in local state rather than\n * crash the page. Whether a Router is around does not change during a table's life, so\n * which hook runs is stable from render to render.\n */\nfunction useTableSearch(urlSync: boolean, owner: string): TableSearch {\n  const inRouter = useInRouterContext();\n  if (!inRouter && urlSync && import.meta.env?.DEV) {\n    throw new Error(\n      `${owner} urlSync requires a Router: render it inside a react-router Router ` +\n        \"(BrowserRouter, a data router or a MemoryRouter), or leave urlSync off.\",\n    );\n  }\n  const useSearch = inRouter ? useRouterSearch : useNoRouterSearch;\n  return useSearch();\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  // The SAME pair is used to read and to write; see `readTableUrlState`. No Router is\n  // needed without `urlSync` (0.49, KIT-3; see `useTableSearch`).\n  const { searchParams, setSearchParams, locationState } = useTableSearch(urlSync, \"DataTable\");\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  // Hidden columns (0.48, keksdose #617): what the user chose — `hidden`, and `shown`\n  // for a `defaultHidden` column ticked back on — kept apart from the defaults, which\n  // are applied on read and never stored. Keyed on the default keys as a string: every\n  // call site builds `columns` inline, so the array is new on every render.\n  const [view, setView] = useState(() => ({\n    hidden: new Set<string>(initial.hidden ?? []),\n    shown: new Set<string>(initial.shown ?? []),\n  }));\n  const defaultHiddenSig = columns\n    .filter((c) => c.defaultHidden)\n    .map((c) => c.key)\n    .join(\"\\u0000\");\n  const hiddenCols = useMemo(\n    () => withDefaultHidden(view, defaultHiddenSig ? defaultHiddenSig.split(\"\\u0000\") : []),\n    [view, defaultHiddenSig],\n  );\n  // The panel hands over the next DRAWN set; what changed is recorded as a choice.\n  const setHiddenCols = useCallback(\n    (action: SetStateAction<Set<string>>) =>\n      setView((v) => {\n        const defaults = defaultHiddenSig ? defaultHiddenSig.split(\"\\u0000\") : [];\n        const prev = withDefaultHidden(v, defaults);\n        const next = typeof action === \"function\" ? action(prev) : action;\n        const hidden = new Set(v.hidden);\n        const shown = new Set(v.shown);\n        for (const k of next) {\n          if (prev.has(k)) continue;\n          hidden.add(k);\n          shown.delete(k);\n        }\n        for (const k of prev) {\n          if (next.has(k)) continue;\n          hidden.delete(k);\n          if (defaults.includes(k)) shown.add(k);\n        }\n        return { hidden, shown };\n      }),\n    [defaultHiddenSig],\n  );\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(view.hidden),\n        ...(view.shown.size > 0 ? { shown: Array.from(view.shown) } : {}),\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, locationState, 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, locationState } = useTableSearch(urlSync, \"useTableUrlState\");\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      locationState,\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"]}
+{"version":3,"sources":["../../src/components/use-table-state.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { SetStateAction } from \"react\";\nimport * as ReactRouter from \"react-router\";\nimport { useLocation, useSearchParams } from \"react-router\";\nimport { useKitTableStorageKeyPrefix } from \"../i18n/kit-labels\";\nimport { readStored, writeStored } from \"../lib/safe-storage\";\nimport { decodeFilterValue, encodeFilterValue, isFilterActive, resolveFilter } 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  /** 0.48: the `defaultHidden` columns the user ticked back on — an entry that beats the\n   *  default. Written only when non-empty, so a table without such columns stores what\n   *  it always did. */\n  shown?: string[];\n}\n\n/** The hidden set as drawn: the stored one plus every `defaultHidden` column the view\n *  holds no entry for (neither hidden nor `shown`). */\nfunction withDefaultHidden(view: { hidden: Set<string>; shown: Set<string> }, defaults: string[]): Set<string> {\n  const extra = defaults.filter((k) => !view.hidden.has(k) && !view.shown.has(k));\n  return extra.length === 0 ? view.hidden : new Set([...view.hidden, ...extra]);\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/** What a table reads and writes the URL through: react-router's, or none. */\ninterface TableSearch {\n  searchParams: URLSearchParams;\n  setSearchParams: ReturnType<typeof useSearchParams>[1];\n  locationState: unknown;\n}\n\nfunction useRouterSearch(): TableSearch {\n  const [searchParams, setSearchParams] = useSearchParams();\n  const location = useLocation();\n  return { searchParams, setSearchParams, locationState: location.state };\n}\n\nconst NO_ROUTER_SEARCH: TableSearch = {\n  searchParams: new URLSearchParams(),\n  setSearchParams: () => {},\n  locationState: null,\n};\nfunction useNoRouterSearch(): TableSearch {\n  return NO_ROUTER_SEARCH;\n}\n\n/**\n * `useInRouterContext`, read off the namespace inside a `try` like\n * use-search-param-state's probe: a test's `vi.mock(\"react-router\", () => ({ … }))`\n * without it throws on the read. Missing, a table assumes a Router, as before 0.49.\n */\nfunction readInRouterContext(): () => boolean {\n  try {\n    return (ReactRouter as unknown as { useInRouterContext?: () => boolean }).useInRouterContext ?? (() => true);\n  } catch {\n    return () => true;\n  }\n}\nconst useInRouterContext = readInRouterContext();\n\n/**\n * The URL access a table needs (0.49, KIT-3). Without `urlSync` a table needs no Router:\n * before 0.49 it called `useSearchParams()` unconditionally and threw outside one even\n * with URL sync off. With `urlSync` and no Router, a development build throws a message\n * that names the fix; a production build keeps the view in local state rather than\n * crash the page. Whether a Router is around does not change during a table's life, so\n * which hook runs is stable from render to render.\n */\nfunction useTableSearch(urlSync: boolean, owner: string): TableSearch {\n  const inRouter = useInRouterContext();\n  if (!inRouter && urlSync && import.meta.env?.DEV) {\n    throw new Error(\n      `${owner} urlSync requires a Router: render it inside a react-router Router ` +\n        \"(BrowserRouter, a data router or a MemoryRouter), or leave urlSync off.\",\n    );\n  }\n  const useSearch = inRouter ? useRouterSearch : useNoRouterSearch;\n  return useSearch();\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}=${pageSize === Infinity ? \"all\" : pageSize === defaultPageSize ? \"\" : String(pageSize)}`,\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  // The SAME pair is used to read and to write; see `readTableUrlState`. No Router is\n  // needed without `urlSync` (0.49, KIT-3; see `useTableSearch`).\n  const { searchParams, setSearchParams, locationState } = useTableSearch(urlSync, \"DataTable\");\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(() => loadPersisted(storageKey, storageKeyPrefix), [storageKey, storageKeyPrefix]);\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  // Hidden columns (0.48, keksdose #617): what the user chose — `hidden`, and `shown`\n  // for a `defaultHidden` column ticked back on — kept apart from the defaults, which\n  // are applied on read and never stored. Keyed on the default keys as a string: every\n  // call site builds `columns` inline, so the array is new on every render.\n  const [view, setView] = useState(() => ({\n    hidden: new Set<string>(initial.hidden ?? []),\n    shown: new Set<string>(initial.shown ?? []),\n  }));\n  const defaultHiddenSig = columns\n    .filter((c) => c.defaultHidden)\n    .map((c) => c.key)\n    .join(\"\\u0000\");\n  const hiddenCols = useMemo(\n    () => withDefaultHidden(view, defaultHiddenSig ? defaultHiddenSig.split(\"\\u0000\") : []),\n    [view, defaultHiddenSig],\n  );\n  // The panel hands over the next DRAWN set; what changed is recorded as a choice.\n  const setHiddenCols = useCallback(\n    (action: SetStateAction<Set<string>>) =>\n      setView((v) => {\n        const defaults = defaultHiddenSig ? defaultHiddenSig.split(\"\\u0000\") : [];\n        const prev = withDefaultHidden(v, defaults);\n        const next = typeof action === \"function\" ? action(prev) : action;\n        const hidden = new Set(v.hidden);\n        const shown = new Set(v.shown);\n        for (const k of next) {\n          if (prev.has(k)) continue;\n          hidden.add(k);\n          shown.delete(k);\n        }\n        for (const k of prev) {\n          if (next.has(k)) continue;\n          hidden.delete(k);\n          if (defaults.includes(k)) shown.add(k);\n        }\n        return { hidden, shown };\n      }),\n    [defaultHiddenSig],\n  );\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(view.hidden),\n        ...(view.shown.size > 0 ? { shown: Array.from(view.shown) } : {}),\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 ? urlSignature(columns, sorts, filters, pageSize, page, defaultPageSize, keys) : \"\";\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(\n      setSearchParams,\n      columns,\n      sorts,\n      filters,\n      pageSize,\n      page,\n      defaultPageSize,\n      undefined,\n      locationState,\n      keys,\n    );\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, locationState } = useTableSearch(urlSync, \"useTableUrlState\");\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      locationState,\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.js

@@ -22,27 +22,8 @@ function UserAvatar({ name, email, person, size = "md", badge, className, ...res
   const initials = (person ? personInitials(person, locale) : "") || avatarInitials(name, email);
   if (badge) {
     return /* @__PURE__ */ jsxs("span", { ...rest, className: "relative inline-flex shrink-0", children: [
-      /* @__PURE__ */ jsx(
-        "span",
-        {
-          "aria-hidden": true,
-          className: cn(
-            CHIP,
-            AVATAR_SIZES[size],
-            className
-          ),
-          children: initials
-        }
-      ),
-      /* @__PURE__ */ jsx(
-        StatusDot,
-        {
-          ring: true,
-          tone: badge.tone ?? "danger",
-          size: BADGE_SIZES[size],
-          className: "absolute -end-0.5 -top-0.5"
-        }
-      ),
+      /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: cn(CHIP, AVATAR_SIZES[size], className), children: initials }),
+      /* @__PURE__ */ jsx(StatusDot, { ring: true, tone: badge.tone ?? "danger", size: BADGE_SIZES[size], className: "absolute -end-0.5 -top-0.5" }),
       /* @__PURE__ */ jsx("span", { className: "sr-only", children: badge.label })
     ] });
   }
@@ -51,11 +32,7 @@ function UserAvatar({ name, email, person, size = "md", badge, className, ...res
     {
       "aria-hidden": true,
       ...rest,
-      className: cn(
-        CHIP,
-        AVATAR_SIZES[size],
-        className
-      ),
+      className: cn(CHIP, AVATAR_SIZES[size], className),
       children: initials
     }
   );

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

@@ -1 +1 @@
-{"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":[]}
+{"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 = \"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 aria-hidden className={cn(CHIP, AVATAR_SIZES[size], className)}>\n          {initials}\n        </span>\n        <StatusDot ring tone={badge.tone ?? \"danger\"} size={BADGE_SIZES[size]} className=\"absolute -end-0.5 -top-0.5\" />\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(CHIP, AVATAR_SIZES[size], className)}\n    >\n      {initials}\n    </span>\n  );\n}\n"],"mappings":";AA0FM,SACE,KADF;AAzFN,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,OAAO;AAGb,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,0BAAC,UAAK,eAAW,MAAC,WAAW,GAAG,MAAM,aAAa,IAAI,GAAG,SAAS,GAChE,oBACH;AAAA,MACA,oBAAC,aAAU,MAAI,MAAC,MAAM,MAAM,QAAQ,UAAU,MAAM,YAAY,IAAI,GAAG,WAAU,8BAA6B;AAAA,MAC9G,oBAAC,UAAK,WAAU,WAAW,gBAAM,OAAM;AAAA,OACzC;AAAA,EAEJ;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MAQC,eAAW;AAAA,MACV,GAAG;AAAA,MACJ,WAAW,GAAG,MAAM,aAAa,IAAI,GAAG,SAAS;AAAA,MAEhD;AAAA;AAAA,EACH;AAEJ;","names":[]}

package/dist/demo/demo-start.js

@@ -48,10 +48,14 @@ function DemoStart({
   const accessLink = useAccessAction(access, landingLabels);
   const [refusal, setRefusal] = useState(null);
   useNoIndex(noIndex);
-  useOncePerKey(ONCE, () => start(), (_key, result) => {
-    if (result.ok) onStarted(result.value);
-    else setRefusal(refusalOf(result.error));
-  });
+  useOncePerKey(
+    ONCE,
+    () => start(),
+    (_key, result) => {
+      if (result.ok) onStarted(result.value);
+      else setRefusal(refusalOf(result.error));
+    }
+  );
   return /* @__PURE__ */ jsxs("div", { ...rest, className: cn("flex flex-col items-center gap-4 py-4 text-center", className), children: [
     /* @__PURE__ */ jsx("div", { role: "status", "aria-live": "polite", className: "w-full", children: refusal === null ? /* @__PURE__ */ jsxs("p", { className: "flex items-center justify-center gap-2 text-sm text-secondary", children: [
       /* @__PURE__ */ jsx(Spinner, { label: null, className: "size-5" }),

package/dist/demo/demo-start.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/demo/demo-start.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ComponentPropsWithRef } from \"react\";\n\nimport { cn } from \"../lib/cn\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport { Button } from \"../components/button\";\nimport { Spinner } from \"../components/spinner\";\nimport { useNoIndex } from \"../hooks/use-noindex\";\nimport { authErrorCode, isRateLimited, retryAfterSeconds } from \"../auth/auth-errors\";\nimport { useOncePerKey } from \"../auth/status-parts\";\nimport { useAccessAction } from \"../landing/access\";\nimport type { AccessChoice } from \"../landing/access\";\nimport type { LandingLabels } from \"../landing/landing-labels\";\nimport { useDemoLabels } from \"./demo-labels\";\nimport type { DemoLabels } from \"./demo-labels\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\n\n/** Why a start was refused, in the page's terms (§5.2). */\ntype Refusal =\n  | { reason: \"rateLimited\"; minutes?: number }\n  | { reason: \"capacity\" }\n  | { reason: \"unavailable\" }\n  | { reason: \"failed\" };\n\n/**\n * The server's answer to `POST /auth/demo-session`, read as a refusal (§5.1, §6.2):\n * `demo_rate_limited` (429, with `Retry-After`), `demo_capacity` (429, without),\n * `demo_disabled` (404) and `demo_not_ready` (503) by their codes; a bare 429 as the\n * per-IP window too; anything else is a plain failure.\n */\nfunction refusalOf(error: unknown): Refusal {\n  const code = authErrorCode(error);\n  if (code === \"demo_capacity\") return { reason: \"capacity\" };\n  if (code === \"demo_disabled\" || code === \"demo_not_ready\") return { reason: \"unavailable\" };\n  if (code === \"demo_rate_limited\" || (code === undefined && isRateLimited(error))) {\n    const seconds = retryAfterSeconds(error);\n    return { reason: \"rateLimited\", minutes: seconds ? Math.ceil(seconds / 60) : undefined };\n  }\n  return { reason: \"failed\" };\n}\n\nfunction messageOf(refusal: Refusal, labels: DemoLabels): string {\n  switch (refusal.reason) {\n    case \"rateLimited\":\n      return labels.rateLimited(refusal.minutes);\n    case \"capacity\":\n      return labels.capacity;\n    case \"unavailable\":\n      return labels.unavailable;\n    case \"failed\":\n      return labels.failed;\n  }\n}\n\n/** The one start a mount makes. */\nconst ONCE = \"demo\";\n\nexport interface DemoStartProps<T> extends Omit<ComponentPropsWithRef<\"div\">, \"children\"> {\n  /**\n   * Create the demo: the app's `POST /auth/demo-session {locale}`. Resolve with what it\n   * answered (the `TokenResponse`, `refresh_token: null`, `expires_at`); reject with the\n   * client's error — the codes are read out of it. Called once per mount.\n   */\n  start: () => Promise<T>;\n  /** The demo exists: store the session (and, for kastlan, `kastlan.demoSession`) and\n   *  replace to the app's home. The page keeps saying \"Starting the demo…\" meanwhile. */\n  onStarted: (session: T) => void;\n  /** \"Request access\" beside a refusal. */\n  access: AccessChoice;\n  /** \"Back to the start page\". Default `/`. */\n  backHref?: string;\n  /** `false` adds no `noindex` — for a preview. Default `true`: `/demo` is never indexed\n   *  (§4.3). */\n  noIndex?: boolean;\n  labels?: LabelOverride<DemoLabels>;\n  /** The access words (`landing` namespace) for this instance. */\n  landingLabels?: Partial<LandingLabels>;\n}\n\n/**\n * The `/demo` page's content (docs/landing-demo-harmonization.md §5.2): it starts the\n * demo ONCE — StrictMode's double mount included, keksdose's ref guard — and says\n * \"Starting the demo…\" until the app has the session and has moved on.\n *\n * A refusal says why, in the visitor's words, and offers \"Request access\" and \"Back to\n * the start page\":\n *\n * | code | says |\n * |---|---|\n * | `demo_rate_limited` (429) | \"Too many demos from this network. Try again in N min.\" — N from `Retry-After` |\n * | `demo_capacity` (429) | \"The demo is full right now. Try again later.\" |\n * | `demo_disabled` (404), `demo_not_ready` (503) | \"The demo isn't available right now.\" |\n * | anything else | \"The demo could not be started. Please try again.\" |\n *\n * keksdose fell back to `/register` with a toast; registration is invitation-only now,\n * so the way on is the access mail.\n *\n * Put it in the app's `AuthLayout`. A live demo session never reaches it: the `/demo`\n * route sits in `RedirectIfAuthed` WITHOUT `allowDemo`, which continues the live demo at\n * its resume target instead of starting a second one. A cold start is the kit's\n * `ServerWakeNotice`'s, once the app's watcher counts this POST\n * (`watchReadsAnd(/\\/auth\\/demo-session\\b/)`).\n */\nexport function DemoStart<T>({\n  start,\n  onStarted,\n  access,\n  backHref = \"/\",\n  noIndex = true,\n  labels: labelsProp,\n  landingLabels,\n  className,\n  ...rest\n}: DemoStartProps<T>) {\n  const labels = useDemoLabels(labelsProp);\n  const accessLink = useAccessAction(access, landingLabels);\n  const [refusal, setRefusal] = useState<Refusal | null>(null);\n  useNoIndex(noIndex);\n  useOncePerKey<T>(ONCE, () => start(), (_key, result) => {\n    if (result.ok) onStarted(result.value);\n    else setRefusal(refusalOf(result.error));\n  });\n\n  return (\n    <div {...rest} className={cn(\"flex flex-col items-center gap-4 py-4 text-center\", className)}>\n      {/* One live region, there from the start, so the refusal that replaces the\n          progress line is announced (a region inserted with its text often is not). */}\n      <div role=\"status\" aria-live=\"polite\" className=\"w-full\">\n        {refusal === null ? (\n          <p className=\"flex items-center justify-center gap-2 text-sm text-secondary\">\n            <Spinner label={null} className=\"size-5\" />\n            {labels.starting}\n          </p>\n        ) : (\n          <AlertBanner tone={refusal.reason === \"failed\" ? \"danger\" : \"warning\"} className=\"text-start\">\n            {messageOf(refusal, labels)}\n          </AlertBanner>\n        )}\n      </div>\n      {refusal !== null && (\n        <div className=\"flex flex-wrap justify-center gap-3\">\n          <Button href={accessLink.href} variant=\"accent\">\n            {accessLink.label}\n          </Button>\n          <Button href={backHref} variant=\"secondary\">\n            {labels.backToStart}\n          </Button>\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":";AAiIU,SACE,KADF;AAjIV,SAAS,gBAAgB;AAGzB,SAAS,UAAU;AACnB,SAAS,mBAAmB;AAC5B,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,kBAAkB;AAC3B,SAAS,eAAe,eAAe,yBAAyB;AAChE,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAGhC,SAAS,qBAAqB;AAiB9B,SAAS,UAAU,OAAyB;AAC1C,QAAM,OAAO,cAAc,KAAK;AAChC,MAAI,SAAS,gBAAiB,QAAO,EAAE,QAAQ,WAAW;AAC1D,MAAI,SAAS,mBAAmB,SAAS,iBAAkB,QAAO,EAAE,QAAQ,cAAc;AAC1F,MAAI,SAAS,uBAAwB,SAAS,UAAa,cAAc,KAAK,GAAI;AAChF,UAAM,UAAU,kBAAkB,KAAK;AACvC,WAAO,EAAE,QAAQ,eAAe,SAAS,UAAU,KAAK,KAAK,UAAU,EAAE,IAAI,OAAU;AAAA,EACzF;AACA,SAAO,EAAE,QAAQ,SAAS;AAC5B;AAEA,SAAS,UAAU,SAAkB,QAA4B;AAC/D,UAAQ,QAAQ,QAAQ;AAAA,IACtB,KAAK;AACH,aAAO,OAAO,YAAY,QAAQ,OAAO;AAAA,IAC3C,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,EAClB;AACF;AAGA,MAAM,OAAO;AAgDN,SAAS,UAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,UAAU;AAAA,EACV,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAsB;AACpB,QAAM,SAAS,cAAc,UAAU;AACvC,QAAM,aAAa,gBAAgB,QAAQ,aAAa;AACxD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAyB,IAAI;AAC3D,aAAW,OAAO;AAClB,gBAAiB,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,WAAW;AACtD,QAAI,OAAO,GAAI,WAAU,OAAO,KAAK;AAAA,QAChC,YAAW,UAAU,OAAO,KAAK,CAAC;AAAA,EACzC,CAAC;AAED,SACE,qBAAC,SAAK,GAAG,MAAM,WAAW,GAAG,qDAAqD,SAAS,GAGzF;AAAA,wBAAC,SAAI,MAAK,UAAS,aAAU,UAAS,WAAU,UAC7C,sBAAY,OACX,qBAAC,OAAE,WAAU,iEACX;AAAA,0BAAC,WAAQ,OAAO,MAAM,WAAU,UAAS;AAAA,MACxC,OAAO;AAAA,OACV,IAEA,oBAAC,eAAY,MAAM,QAAQ,WAAW,WAAW,WAAW,WAAW,WAAU,cAC9E,oBAAU,SAAS,MAAM,GAC5B,GAEJ;AAAA,IACC,YAAY,QACX,qBAAC,SAAI,WAAU,uCACb;AAAA,0BAAC,UAAO,MAAM,WAAW,MAAM,SAAQ,UACpC,qBAAW,OACd;AAAA,MACA,oBAAC,UAAO,MAAM,UAAU,SAAQ,aAC7B,iBAAO,aACV;AAAA,OACF;AAAA,KAEJ;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/demo/demo-start.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ComponentPropsWithRef } from \"react\";\n\nimport { cn } from \"../lib/cn\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport { Button } from \"../components/button\";\nimport { Spinner } from \"../components/spinner\";\nimport { useNoIndex } from \"../hooks/use-noindex\";\nimport { authErrorCode, isRateLimited, retryAfterSeconds } from \"../auth/auth-errors\";\nimport { useOncePerKey } from \"../auth/status-parts\";\nimport { useAccessAction } from \"../landing/access\";\nimport type { AccessChoice } from \"../landing/access\";\nimport type { LandingLabels } from \"../landing/landing-labels\";\nimport { useDemoLabels } from \"./demo-labels\";\nimport type { DemoLabels } from \"./demo-labels\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\n\n/** Why a start was refused, in the page's terms (§5.2). */\ntype Refusal =\n  | { reason: \"rateLimited\"; minutes?: number }\n  | { reason: \"capacity\" }\n  | { reason: \"unavailable\" }\n  | { reason: \"failed\" };\n\n/**\n * The server's answer to `POST /auth/demo-session`, read as a refusal (§5.1, §6.2):\n * `demo_rate_limited` (429, with `Retry-After`), `demo_capacity` (429, without),\n * `demo_disabled` (404) and `demo_not_ready` (503) by their codes; a bare 429 as the\n * per-IP window too; anything else is a plain failure.\n */\nfunction refusalOf(error: unknown): Refusal {\n  const code = authErrorCode(error);\n  if (code === \"demo_capacity\") return { reason: \"capacity\" };\n  if (code === \"demo_disabled\" || code === \"demo_not_ready\") return { reason: \"unavailable\" };\n  if (code === \"demo_rate_limited\" || (code === undefined && isRateLimited(error))) {\n    const seconds = retryAfterSeconds(error);\n    return { reason: \"rateLimited\", minutes: seconds ? Math.ceil(seconds / 60) : undefined };\n  }\n  return { reason: \"failed\" };\n}\n\nfunction messageOf(refusal: Refusal, labels: DemoLabels): string {\n  switch (refusal.reason) {\n    case \"rateLimited\":\n      return labels.rateLimited(refusal.minutes);\n    case \"capacity\":\n      return labels.capacity;\n    case \"unavailable\":\n      return labels.unavailable;\n    case \"failed\":\n      return labels.failed;\n  }\n}\n\n/** The one start a mount makes. */\nconst ONCE = \"demo\";\n\nexport interface DemoStartProps<T> extends Omit<ComponentPropsWithRef<\"div\">, \"children\"> {\n  /**\n   * Create the demo: the app's `POST /auth/demo-session {locale}`. Resolve with what it\n   * answered (the `TokenResponse`, `refresh_token: null`, `expires_at`); reject with the\n   * client's error — the codes are read out of it. Called once per mount.\n   */\n  start: () => Promise<T>;\n  /** The demo exists: store the session (and, for kastlan, `kastlan.demoSession`) and\n   *  replace to the app's home. The page keeps saying \"Starting the demo…\" meanwhile. */\n  onStarted: (session: T) => void;\n  /** \"Request access\" beside a refusal. */\n  access: AccessChoice;\n  /** \"Back to the start page\". Default `/`. */\n  backHref?: string;\n  /** `false` adds no `noindex` — for a preview. Default `true`: `/demo` is never indexed\n   *  (§4.3). */\n  noIndex?: boolean;\n  labels?: LabelOverride<DemoLabels>;\n  /** The access words (`landing` namespace) for this instance. */\n  landingLabels?: Partial<LandingLabels>;\n}\n\n/**\n * The `/demo` page's content (docs/landing-demo-harmonization.md §5.2): it starts the\n * demo ONCE — StrictMode's double mount included, keksdose's ref guard — and says\n * \"Starting the demo…\" until the app has the session and has moved on.\n *\n * A refusal says why, in the visitor's words, and offers \"Request access\" and \"Back to\n * the start page\":\n *\n * | code | says |\n * |---|---|\n * | `demo_rate_limited` (429) | \"Too many demos from this network. Try again in N min.\" — N from `Retry-After` |\n * | `demo_capacity` (429) | \"The demo is full right now. Try again later.\" |\n * | `demo_disabled` (404), `demo_not_ready` (503) | \"The demo isn't available right now.\" |\n * | anything else | \"The demo could not be started. Please try again.\" |\n *\n * keksdose fell back to `/register` with a toast; registration is invitation-only now,\n * so the way on is the access mail.\n *\n * Put it in the app's `AuthLayout`. A live demo session never reaches it: the `/demo`\n * route sits in `RedirectIfAuthed` WITHOUT `allowDemo`, which continues the live demo at\n * its resume target instead of starting a second one. A cold start is the kit's\n * `ServerWakeNotice`'s, once the app's watcher counts this POST\n * (`watchReadsAnd(/\\/auth\\/demo-session\\b/)`).\n */\nexport function DemoStart<T>({\n  start,\n  onStarted,\n  access,\n  backHref = \"/\",\n  noIndex = true,\n  labels: labelsProp,\n  landingLabels,\n  className,\n  ...rest\n}: DemoStartProps<T>) {\n  const labels = useDemoLabels(labelsProp);\n  const accessLink = useAccessAction(access, landingLabels);\n  const [refusal, setRefusal] = useState<Refusal | null>(null);\n  useNoIndex(noIndex);\n  useOncePerKey<T>(\n    ONCE,\n    () => start(),\n    (_key, result) => {\n      if (result.ok) onStarted(result.value);\n      else setRefusal(refusalOf(result.error));\n    },\n  );\n\n  return (\n    <div {...rest} className={cn(\"flex flex-col items-center gap-4 py-4 text-center\", className)}>\n      {/* One live region, there from the start, so the refusal that replaces the\n          progress line is announced (a region inserted with its text often is not). */}\n      <div role=\"status\" aria-live=\"polite\" className=\"w-full\">\n        {refusal === null ? (\n          <p className=\"flex items-center justify-center gap-2 text-sm text-secondary\">\n            <Spinner label={null} className=\"size-5\" />\n            {labels.starting}\n          </p>\n        ) : (\n          <AlertBanner tone={refusal.reason === \"failed\" ? \"danger\" : \"warning\"} className=\"text-start\">\n            {messageOf(refusal, labels)}\n          </AlertBanner>\n        )}\n      </div>\n      {refusal !== null && (\n        <div className=\"flex flex-wrap justify-center gap-3\">\n          <Button href={accessLink.href} variant=\"accent\">\n            {accessLink.label}\n          </Button>\n          <Button href={backHref} variant=\"secondary\">\n            {labels.backToStart}\n          </Button>\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":";AAqIU,SACE,KADF;AArIV,SAAS,gBAAgB;AAGzB,SAAS,UAAU;AACnB,SAAS,mBAAmB;AAC5B,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,kBAAkB;AAC3B,SAAS,eAAe,eAAe,yBAAyB;AAChE,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAGhC,SAAS,qBAAqB;AAiB9B,SAAS,UAAU,OAAyB;AAC1C,QAAM,OAAO,cAAc,KAAK;AAChC,MAAI,SAAS,gBAAiB,QAAO,EAAE,QAAQ,WAAW;AAC1D,MAAI,SAAS,mBAAmB,SAAS,iBAAkB,QAAO,EAAE,QAAQ,cAAc;AAC1F,MAAI,SAAS,uBAAwB,SAAS,UAAa,cAAc,KAAK,GAAI;AAChF,UAAM,UAAU,kBAAkB,KAAK;AACvC,WAAO,EAAE,QAAQ,eAAe,SAAS,UAAU,KAAK,KAAK,UAAU,EAAE,IAAI,OAAU;AAAA,EACzF;AACA,SAAO,EAAE,QAAQ,SAAS;AAC5B;AAEA,SAAS,UAAU,SAAkB,QAA4B;AAC/D,UAAQ,QAAQ,QAAQ;AAAA,IACtB,KAAK;AACH,aAAO,OAAO,YAAY,QAAQ,OAAO;AAAA,IAC3C,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,EAClB;AACF;AAGA,MAAM,OAAO;AAgDN,SAAS,UAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,UAAU;AAAA,EACV,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAsB;AACpB,QAAM,SAAS,cAAc,UAAU;AACvC,QAAM,aAAa,gBAAgB,QAAQ,aAAa;AACxD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAyB,IAAI;AAC3D,aAAW,OAAO;AAClB;AAAA,IACE;AAAA,IACA,MAAM,MAAM;AAAA,IACZ,CAAC,MAAM,WAAW;AAChB,UAAI,OAAO,GAAI,WAAU,OAAO,KAAK;AAAA,UAChC,YAAW,UAAU,OAAO,KAAK,CAAC;AAAA,IACzC;AAAA,EACF;AAEA,SACE,qBAAC,SAAK,GAAG,MAAM,WAAW,GAAG,qDAAqD,SAAS,GAGzF;AAAA,wBAAC,SAAI,MAAK,UAAS,aAAU,UAAS,WAAU,UAC7C,sBAAY,OACX,qBAAC,OAAE,WAAU,iEACX;AAAA,0BAAC,WAAQ,OAAO,MAAM,WAAU,UAAS;AAAA,MACxC,OAAO;AAAA,OACV,IAEA,oBAAC,eAAY,MAAM,QAAQ,WAAW,WAAW,WAAW,WAAW,WAAU,cAC9E,oBAAU,SAAS,MAAM,GAC5B,GAEJ;AAAA,IACC,YAAY,QACX,qBAAC,SAAI,WAAU,uCACb;AAAA,0BAAC,UAAO,MAAM,WAAW,MAAM,SAAQ,UACpC,qBAAW,OACd;AAAA,MACA,oBAAC,UAAO,MAAM,UAAU,SAAQ,aAC7B,iBAAO,aACV;AAAA,OACF;AAAA,KAEJ;AAEJ;","names":[]}

package/dist/eslint/index.js

@@ -47,7 +47,7 @@ const roleUtilities = {
     };
   }
 };
-const VERSION = true ? "0.51.4" : "0.0.0-source";
+const VERSION = true ? "0.51.6" : "0.0.0-source";
 const recommended = {
   name: "@eifi1/ui-kit/recommended",
   // Not the tests, as check:tokens skips the kit's: a test names the old class to assert it

package/dist/feedback/feedback-attachment-labels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feedback/feedback-attachment-labels.ts"],"sourcesContent":["// The English words of ./feedback-attachment, in a module with no component code: the\n// English catalogue (src/i18n/defaults.ts) imports them without the component, so `en`\n// loads as one chunk like the other languages (0.34, KS U8). ./feedback-attachment\n// re-exports them.\n\nimport type { FeedbackAttachmentFieldLabels } from \"./feedback-attachment\";\n\n/**\n * English, in the feedback contract's wording since 0.27.0 (docs/feedback-harmonization.md\n * §4.2: keksdose's `feedback.*` keys are the canon, and the kit owns them now). Three\n * strings moved with it:\n *\n * - `attachmentAdd` \"Attach image\" → **\"Add attachment\"**: the field takes a PDF or a text\n *   log as well wherever the app passes `FEEDBACK_ATTACHMENT_ACCEPT` (keksdose feedback\n *   #87), and a button that says \"image\" over a picker that offers a PDF is wrong in one\n *   of the two places.\n * - `attachmentPaste` → keksdose's longer line, which says WHY one would paste — a region\n *   snip shows one corner rather than the whole page (Steering Design feedback #39).\n * - `attachmentLimit` for one: \"remove **it**\", as keksdose's `attachments_full_one`;\n *   \"remove one\" of a single file read oddly.\n */\nexport const DEFAULT_FEEDBACK_ATTACHMENT_LABELS: FeedbackAttachmentFieldLabels = {\n  attachmentAdd: \"Add attachment\",\n  attachmentCapture: \"Capture screenshot\",\n  attachmentPaste: \"…or paste a screenshot straight from the clipboard, so you can show one corner rather than the whole page.\",\n  attachmentRemove: \"Remove attachment\",\n  attachmentList: \"Attachments\",\n  attachmentScreenshot: \"Screenshot\",\n  attachmentRemoveFile: (name) => `Remove ${name}`,\n  attachmentLimit: (max) =>\n    max === 1\n      ? \"Up to 1 attachment — remove it to add another.\"\n      : `Up to ${max} attachments — remove one to add another.`,\n  attachmentUploading: \"Uploading…\",\n  attachmentUploadFailed: (name) => `“${name}” could not be uploaded`,\n};\n"],"mappings":";AAqBO,MAAM,qCAAoE;AAAA,EAC/E,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,sBAAsB;AAAA,EACtB,sBAAsB,CAAC,SAAS,UAAU,IAAI;AAAA,EAC9C,iBAAiB,CAAC,QAChB,QAAQ,IACJ,wDACA,SAAS,GAAG;AAAA,EAClB,qBAAqB;AAAA,EACrB,wBAAwB,CAAC,SAAS,SAAI,IAAI;AAC5C;","names":[]}
+{"version":3,"sources":["../../src/feedback/feedback-attachment-labels.ts"],"sourcesContent":["// The English words of ./feedback-attachment, in a module with no component code: the\n// English catalogue (src/i18n/defaults.ts) imports them without the component, so `en`\n// loads as one chunk like the other languages (0.34, KS U8). ./feedback-attachment\n// re-exports them.\n\nimport type { FeedbackAttachmentFieldLabels } from \"./feedback-attachment\";\n\n/**\n * English, in the feedback contract's wording since 0.27.0 (docs/feedback-harmonization.md\n * §4.2: keksdose's `feedback.*` keys are the canon, and the kit owns them now). Three\n * strings moved with it:\n *\n * - `attachmentAdd` \"Attach image\" → **\"Add attachment\"**: the field takes a PDF or a text\n *   log as well wherever the app passes `FEEDBACK_ATTACHMENT_ACCEPT` (keksdose feedback\n *   #87), and a button that says \"image\" over a picker that offers a PDF is wrong in one\n *   of the two places.\n * - `attachmentPaste` → keksdose's longer line, which says WHY one would paste — a region\n *   snip shows one corner rather than the whole page (Steering Design feedback #39).\n * - `attachmentLimit` for one: \"remove **it**\", as keksdose's `attachments_full_one`;\n *   \"remove one\" of a single file read oddly.\n */\nexport const DEFAULT_FEEDBACK_ATTACHMENT_LABELS: FeedbackAttachmentFieldLabels = {\n  attachmentAdd: \"Add attachment\",\n  attachmentCapture: \"Capture screenshot\",\n  attachmentPaste:\n    \"…or paste a screenshot straight from the clipboard, so you can show one corner rather than the whole page.\",\n  attachmentRemove: \"Remove attachment\",\n  attachmentList: \"Attachments\",\n  attachmentScreenshot: \"Screenshot\",\n  attachmentRemoveFile: (name) => `Remove ${name}`,\n  attachmentLimit: (max) =>\n    max === 1\n      ? \"Up to 1 attachment — remove it to add another.\"\n      : `Up to ${max} attachments — remove one to add another.`,\n  attachmentUploading: \"Uploading…\",\n  attachmentUploadFailed: (name) => `“${name}” could not be uploaded`,\n};\n"],"mappings":";AAqBO,MAAM,qCAAoE;AAAA,EAC/E,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,iBACE;AAAA,EACF,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,sBAAsB;AAAA,EACtB,sBAAsB,CAAC,SAAS,UAAU,IAAI;AAAA,EAC9C,iBAAiB,CAAC,QAChB,QAAQ,IACJ,wDACA,SAAS,GAAG;AAAA,EAClB,qBAAqB;AAAA,EACrB,wBAAwB,CAAC,SAAS,SAAI,IAAI;AAC5C;","names":[]}

package/dist/feedback/feedback-attachment.js

@@ -76,14 +76,7 @@ function SingleField({
       children: [
         /* @__PURE__ */ jsx(Heading, { text: labelsProp?.attachment }),
         value ? /* @__PURE__ */ jsxs("div", { className: "flex items-start gap-2", children: [
-          value.type.startsWith("image/") && preview ? /* @__PURE__ */ jsx(
-            "img",
-            {
-              src: preview,
-              alt: value.name,
-              className: "h-20 w-20 rounded border border-subtle object-cover"
-            }
-          ) : (
+          value.type.startsWith("image/") && preview ? /* @__PURE__ */ jsx("img", { src: preview, alt: value.name, className: "h-20 w-20 rounded border border-subtle object-cover" }) : (
             // Non-image attachments (PDF, text) can't preview as an <img>, so
             // show a neutral file tile with the name/size beside it instead.
             /* @__PURE__ */ jsx("div", { className: "flex h-20 w-20 items-center justify-center rounded border border-subtle text-placeholder", children: /* @__PURE__ */ jsx(FileText, { className: "size-8" }) })