@eifi1/ui-kit 0.51.7 → 0.53.0

package/dist/components/data-table-fit.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/data-table-fit.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\";\nimport type { DataTableColumn } from \"./data-table\";\n\n// DataTable's fit to its own width (0.48, keksdose live #451: \"On expanded sidebar for\n// desktop the table scrolls horizontally. On collapsed sidebar it fits […] Compute the\n// width selectively\"). Two column options, both opt-in:\n//\n// - `grow`: the column takes what the others leave and ellipsises (`w-full max-w-0` on\n//   its cells: in an auto table layout that is \"the rest of the row\", never its content's\n//   width), so one long title can no longer widen the table.\n// - `fitPriority`: while the table is wider than its scroller — or, with a `grow` column,\n//   while that column would get less than {@link GROW_MIN_REM} — the table leaves out\n//   its `fitPriority` columns, the LOWEST number first (ties: the later column first),\n//   and brings them back in the reverse order as soon as the table, as it is NOW, has\n//   room for them (its need re-measured, plus the column's own header width from when\n//   it was left out), so narrower content (a filter, another page) counts as much as a\n//   wider scroller. The scroller's own width, through a ResizeObserver: a sidebar, a\n//   narrower window, the Columns drawer and Large text all count the same. A column\n//   whose return the very next measure undoes stays out until the table has more room\n//   for it than it had then (0.48.3, keksdose B2: see the bring-back in `measure`). And\n//   the TABLE's own width, through the same observer (0.51.2): anything that widens it\n//   after a measure — rows drawn a frame later, `virtualize` locking its column widths —\n//   is measured again, so the table never stays wider than its scroller.\n\n/** The least a `grow` column keeps before the table starts leaving columns out: about\n *  a sentence of a title. In rem, so Large text asks for more. */\nexport const GROW_MIN_REM = 10;\n\n/** The `<th>`/`<td>` classes of a `grow` column. `truncate-until-large`: one line and an\n *  ellipsis at Normal, a wrap from Large up (text size §10.17), as every kit title. The\n *  header's `min-w-[10rem]` ({@link GROW_MIN_REM}) is the floor once no `fitPriority`\n *  column is left to leave out: the table then scrolls sideways rather than crushing the\n *  column it exists for (Kurvenschmiede S1, 0.48: Subject was 24px at 1100px). */\nexport const GROW_HEAD_CLASS = \"w-full max-w-0 min-w-[10rem]\";\nexport const GROW_CELL_CLASS = \"w-full max-w-0 truncate-until-large\";\n\n/** Every OTHER cell of a table with a `grow` column (kastlan S2, 0.48). A `w-full` column\n *  squeezes the rest to their min-content width, so any text with a space broke in two\n *  even at 1920px (\"CHF 2'568.38\", \"Peter Mueller\", a date with its time). One line at\n *  Normal, so a column is never narrower than its text and `fitPriority` measures what\n *  the columns really need; from Large up the cell wraps as before (§10.17). The headers\n *  are `whitespace-nowrap` already. A column whose prose should wrap anyway passes\n *  `not-large:whitespace-normal` in its `className`. */\nexport const GROW_PEER_CELL_CLASS = \"not-large:whitespace-nowrap\";\n\n// A cell's own flex-wrap row (chips) is left to wrap beside a `grow` column: a row of\n// badges reads as well stacked, and held to one line it widened the user roster's Status\n// until kastlan's admin pane scrolled 21px at 1280px (0.48 build review 2, kastlan S1).\n\n/** The auto-hide order: lowest `fitPriority` first, the later column first on a tie. */\nexport function fitHideOrder<T>(columns: DataTableColumn<T>[]): DataTableColumn<T>[] {\n  return columns\n    .map((col, index) => ({ col, index }))\n    .filter(({ col }) => col.fitPriority != null)\n    .sort((a, b) => a.col.fitPriority! - b.col.fitPriority! || b.index - a.index)\n    .map(({ col }) => col);\n}\n\n/**\n * Which columns the table leaves out for width, and the Columns panel's \"keep it\".\n *\n * A column the user TICKS in the Columns panel is theirs: it is never left out for width\n * again while the table is mounted (`keep`): the table makes room by leaving out the next\n * candidate, and scrolls sideways once none is left — what they asked for. Unticking it hides it as before (the persisted `hiddenCols`) and\n * drops the keep. Keeps are not persisted: on the next visit the table fits again.\n */\nexport function useColumnFit<T>({\n  columns,\n  hiddenCols,\n  headRefs,\n  scroller,\n  enabled,\n  content,\n}: {\n  columns: DataTableColumn<T>[];\n  /** The user's hidden columns: never candidates (they are out already). */\n  hiddenCols: Set<string>;\n  headRefs: Map<string, HTMLTableCellElement>;\n  /** The desktop scroller, read after render (it is declared below the call). */\n  scroller: () => HTMLElement | null;\n  /** The wide layout. On a phone (the card list) nothing is left out for width. */\n  enabled: boolean;\n  /**\n   * What can change the columns' widths besides the scroller (0.48.2): the rows on\n   * screen, the columns, the stored widths, the text size. Compared item by item after\n   * each render, and the table is measured only when one changed — a selection tick no\n   * longer forces a layout of the whole table. Without it, every render measures.\n   */\n  content?: readonly unknown[];\n}): {\n  /** The columns left out for width now — empty while off. */\n  autoHidden: Set<string>;\n  /** The user's choice in the Columns panel: `true` keeps the column in whatever the width. */\n  keep: (key: string, on: boolean) => void;\n} {\n  const [kept, setKept] = useState<ReadonlySet<string>>(() => new Set());\n  const [hidden, setHidden] = useState<string[]>([]);\n  // A column's own header width, written when it is left out: it comes back once the\n  // table's need as it is now, plus this, fits the scroller (keksdose S3, 0.48: not the\n  // whole table's need at hide time, which went stale when the content narrowed).\n  const ownWidth = useRef(new Map<string, number>());\n  // A column whose return the very next measure undid, at the same scroller width: the\n  // room the table had for it when it came back (keksdose B2, 0.48.3). It stays out\n  // until the table has more. Dropped once the column is no longer left out for width.\n  const stuck = useRef(new Map<string, number>());\n  // What the last measure brought back, each column with the room it had then, and at\n  // which scroller width: read (and cleared) by the measure right after it.\n  const lastShown = useRef<{ avail: number; rooms: Map<string, number> } | null>(null);\n\n  const hasFit = columns.some((c) => c.fitPriority != null);\n  const active = enabled && hasFit;\n  const order = useMemo(\n    () => fitHideOrder(columns).filter((c) => !hiddenCols.has(c.key) && !kept.has(c.key)),\n    [columns, hiddenCols, kept],\n  );\n  // Only the candidates still in play, in hide order — a column the user hid or kept\n  // since, or one the app dropped, is no longer \"hidden for width\".\n  const current = useMemo(\n    () => (active ? order.filter((c) => hidden.includes(c.key)).map((c) => c.key) : []),\n    [active, order, hidden],\n  );\n  const growCol = columns.find((c) => c.grow && !hiddenCols.has(c.key));\n  const growKey = growCol?.key;\n  const growMin = growCol?.growMin ?? GROW_MIN_REM;\n\n  // What `measure` reads, refreshed after each render (before the measure below runs):\n  // the ResizeObserver's callback is set up once and must see the current columns.\n  const latest = useRef({ order, current, growKey, growMin, active, scroller });\n  useLayoutEffect(() => {\n    latest.current = { order, current, growKey, growMin, active, scroller };\n  });\n\n  const measure = useCallback(() => {\n    const { order, current, growKey, growMin, active, scroller } = latest.current;\n    // Only the measure right after a bring-back can undo it.\n    const flip = lastShown.current;\n    lastShown.current = null;\n    for (const k of stuck.current.keys()) if (!current.includes(k)) stuck.current.delete(k);\n    const el = scroller();\n    if (!active || !el) return;\n    const table = el.querySelector(\"table\");\n    const avail = el.clientWidth;\n    // Not laid out (display:none, jsdom): nothing to fit to.\n    if (!table || avail <= 0) return;\n    const growTh = growKey ? headRefs.get(growKey) : undefined;\n    const rem = parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;\n    let need = growTh ? table.offsetWidth - growTh.offsetWidth + growMin * rem : table.offsetWidth;\n    if (!growTh && need <= avail + 0.5 && current.length > 0) {\n      // A `w-full` table is at least the scroller's width, which says nothing about how\n      // much room its content leaves: probe its content's width (what it takes once it\n      // overflows) for the bring-back below. Read and put back in one layout pass.\n      const before = table.style.width;\n      table.style.width = \"min-content\";\n      need = table.offsetWidth;\n      table.style.width = before;\n    }\n    if (need > avail + 0.5) {\n      // Leave out, in order, until the rest fits: each column saves its header's width\n      // (the others are at their content's width while a `grow` column takes the rest).\n      const next = [...current];\n      for (const col of order) {\n        if (need <= avail + 0.5) break;\n        if (next.includes(col.key)) continue;\n        const w = headRefs.get(col.key)?.offsetWidth ?? 0;\n        ownWidth.current.set(col.key, w);\n        need -= w;\n        next.push(col.key);\n      }\n      if (next.length === current.length) return;\n      // The last measure brought these back at this same width, and the table cannot\n      // hold them: their header width fell short of what they cost drawn (see below).\n      if (flip && Math.abs(flip.avail - avail) <= 0.5)\n        for (const k of next.slice(current.length)) {\n          const room = flip.rooms.get(k);\n          if (room != null) stuck.current.set(k, room);\n        }\n      setHidden(next);\n      return;\n    }\n    // Bring back, the last left out first, while the table as it is now has room for\n    // them by their recorded header width. A column that costs more drawn than that is\n    // left out again by the next measure, before paint. That alone does not settle it:\n    // the re-hide records its header's width again, and the header can measure the same\n    // while the column costs more (`virtualize`'s locked widths, keksdose B2, 0.48.3: the\n    // drawn column cost the table ~80–110px more than its header), so it came back, went, came back … until React's\n    // update limit (#185). So a column whose return the next measure undid, at the same\n    // scroller width, waits for more room than it had then: a wider scroller or narrower\n    // content. Whatever the error in its width, that is one invisible flip per room it is\n    // tried at.\n    let n = current.length;\n    const rooms = new Map<string, number>();\n    while (n > 0) {\n      const k = current[n - 1];\n      const w = ownWidth.current.get(k);\n      if (w == null || need + w > avail + 0.5) break;\n      const room = stuck.current.get(k);\n      if (room != null && avail - need <= room + 0.5) break;\n      rooms.set(k, avail - need);\n      need += w;\n      n--;\n    }\n    if (n === current.length) return;\n    lastShown.current = { avail, rooms };\n    setHidden(current.slice(0, n));\n  }, [headRefs]);\n\n  // The table the observer below watches, kept to this render's.\n  const observer = useRef<ResizeObserver | null>(null);\n  const watched = useRef<{ table: Element; width: number } | null>(null);\n  const watchTable = useCallback(() => {\n    const ro = observer.current;\n    const table = latest.current.scroller()?.querySelector(\"table\") ?? null;\n    if (!ro || table === (watched.current?.table ?? null)) return;\n    if (watched.current) ro.unobserve(watched.current.table);\n    // Its width now, as the measure that just ran saw it: a report of the same width is\n    // not news, one that differs is (it may come a frame later, rows drawn by then).\n    watched.current = table ? { table, width: (table as HTMLElement).offsetWidth } : null;\n    if (table) ro.observe(table);\n  }, []);\n\n  // After a render that changed what is drawn: rows, a filter or a page can widen a\n  // column as much as a resize. Before paint, so a column the table cannot hold is never\n  // drawn first. A render that changed none of it (a ticked box, a focused row) skips the\n  // measure, which forces a layout of the whole table (0.48.2, keksdose dev #632).\n  const lastContent = useRef<readonly unknown[] | null>(null);\n  useLayoutEffect(() => {\n    // The table the observer watches is this render's (a table drawn after a loading\n    // state, or remounted, is a new element).\n    watchTable();\n    const now = content ? [...content, order, current, growKey, active] : null;\n    const prev = lastContent.current;\n    lastContent.current = now;\n    if (now && prev && prev.length === now.length && prev.every((v, i) => Object.is(v, now[i]))) return;\n    measure();\n  });\n\n  // The scroller, and the table in it (0.51.2, keksdose's register). The fit measured\n  // after a render that changed `content` and when the SCROLLER changed size, but the table\n  // also widens on its own after that: under `virtualize` the rows actually drawn are the\n  // window's, set a frame later, and its column-width lock lands a frame later still —\n  // neither is `content`, and the scroller keeps its size. A load whose first measure saw\n  // the table before its rows were in kept every `fitPriority` column and then overflowed\n  // for good (893px in 757 at 1124, 1058 in 913 at 1280, on 0.50.1 as on 0.51). Watched,\n  // a table that grows past what was measured is measured again. Only a WIDTH change of\n  // the table counts: its height moves with every row the window draws, and each measure\n  // lays the whole table out.\n  useEffect(() => {\n    const el = latest.current.scroller();\n    if (!active || !el || typeof ResizeObserver === \"undefined\") return;\n    const ro = new ResizeObserver((entries) => {\n      let changed = false;\n      for (const entry of entries) {\n        if (entry.target === el) changed = true;\n        else if (watched.current && entry.target === watched.current.table) {\n          // The border box, as `offsetWidth` reads it (the content rect leaves the border out).\n          const width = entry.borderBoxSize?.[0]?.inlineSize ?? entry.contentRect.width;\n          if (Math.abs(width - watched.current.width) > 0.5) {\n            watched.current.width = width;\n            changed = true;\n          }\n        }\n      }\n      if (changed) measure();\n    });\n    ro.observe(el);\n    observer.current = ro;\n    watchTable();\n    return () => {\n      ro.disconnect();\n      observer.current = null;\n      watched.current = null;\n    };\n  }, [active, measure, watchTable]);\n\n  const keep = useCallback((key: string, on: boolean) => {\n    setKept((s) => {\n      if (s.has(key) === on) return s;\n      const next = new Set(s);\n      if (on) next.add(key);\n      else next.delete(key);\n      return next;\n    });\n  }, []);\n\n  const autoHidden = useMemo(() => new Set(current), [current]);\n  return { autoHidden, keep };\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,iBAAiB,SAAS,QAAQ,gBAAgB;AA0B5E,MAAM,eAAe;AAOrB,MAAM,kBAAkB;AACxB,MAAM,kBAAkB;AASxB,MAAM,uBAAuB;AAO7B,SAAS,aAAgB,SAAqD;AACnF,SAAO,QACJ,IAAI,CAAC,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,EACpC,OAAO,CAAC,EAAE,IAAI,MAAM,IAAI,eAAe,IAAI,EAC3C,KAAK,CAAC,GAAG,MAAM,EAAE,IAAI,cAAe,EAAE,IAAI,eAAgB,EAAE,QAAQ,EAAE,KAAK,EAC3E,IAAI,CAAC,EAAE,IAAI,MAAM,GAAG;AACzB;AAUO,SAAS,aAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAqBE;AACA,QAAM,CAAC,MAAM,OAAO,IAAI,SAA8B,MAAM,oBAAI,IAAI,CAAC;AACrE,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAmB,CAAC,CAAC;AAIjD,QAAM,WAAW,OAAO,oBAAI,IAAoB,CAAC;AAIjD,QAAM,QAAQ,OAAO,oBAAI,IAAoB,CAAC;AAG9C,QAAM,YAAY,OAA6D,IAAI;AAEnF,QAAM,SAAS,QAAQ,KAAK,CAAC,MAAM,EAAE,eAAe,IAAI;AACxD,QAAM,SAAS,WAAW;AAC1B,QAAM,QAAQ;AAAA,IACZ,MAAM,aAAa,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,GAAG,CAAC;AAAA,IACpF,CAAC,SAAS,YAAY,IAAI;AAAA,EAC5B;AAGA,QAAM,UAAU;AAAA,IACd,MAAO,SAAS,MAAM,OAAO,CAAC,MAAM,OAAO,SAAS,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;AAAA,IACjF,CAAC,QAAQ,OAAO,MAAM;AAAA,EACxB;AACA,QAAM,UAAU,QAAQ,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE,GAAG,CAAC;AACpE,QAAM,UAAU,SAAS;AACzB,QAAM,UAAU,SAAS,WAAW;AAIpC,QAAM,SAAS,OAAO,EAAE,OAAO,SAAS,SAAS,SAAS,QAAQ,SAAS,CAAC;AAC5E,kBAAgB,MAAM;AACpB,WAAO,UAAU,EAAE,OAAO,SAAS,SAAS,SAAS,QAAQ,SAAS;AAAA,EACxE,CAAC;AAED,QAAM,UAAU,YAAY,MAAM;AAChC,UAAM,EAAE,OAAAA,QAAO,SAAAC,UAAS,SAAAC,UAAS,SAAAC,UAAS,QAAAC,SAAQ,UAAAC,UAAS,IAAI,OAAO;AAEtE,UAAM,OAAO,UAAU;AACvB,cAAU,UAAU;AACpB,eAAW,KAAK,MAAM,QAAQ,KAAK,EAAG,KAAI,CAACJ,SAAQ,SAAS,CAAC,EAAG,OAAM,QAAQ,OAAO,CAAC;AACtF,UAAM,KAAKI,UAAS;AACpB,QAAI,CAACD,WAAU,CAAC,GAAI;AACpB,UAAM,QAAQ,GAAG,cAAc,OAAO;AACtC,UAAM,QAAQ,GAAG;AAEjB,QAAI,CAAC,SAAS,SAAS,EAAG;AAC1B,UAAM,SAASF,WAAU,SAAS,IAAIA,QAAO,IAAI;AACjD,UAAM,MAAM,WAAW,iBAAiB,SAAS,eAAe,EAAE,QAAQ,KAAK;AAC/E,QAAI,OAAO,SAAS,MAAM,cAAc,OAAO,cAAcC,WAAU,MAAM,MAAM;AACnF,QAAI,CAAC,UAAU,QAAQ,QAAQ,OAAOF,SAAQ,SAAS,GAAG;AAIxD,YAAM,SAAS,MAAM,MAAM;AAC3B,YAAM,MAAM,QAAQ;AACpB,aAAO,MAAM;AACb,YAAM,MAAM,QAAQ;AAAA,IACtB;AACA,QAAI,OAAO,QAAQ,KAAK;AAGtB,YAAM,OAAO,CAAC,GAAGA,QAAO;AACxB,iBAAW,OAAOD,QAAO;AACvB,YAAI,QAAQ,QAAQ,IAAK;AACzB,YAAI,KAAK,SAAS,IAAI,GAAG,EAAG;AAC5B,cAAM,IAAI,SAAS,IAAI,IAAI,GAAG,GAAG,eAAe;AAChD,iBAAS,QAAQ,IAAI,IAAI,KAAK,CAAC;AAC/B,gBAAQ;AACR,aAAK,KAAK,IAAI,GAAG;AAAA,MACnB;AACA,UAAI,KAAK,WAAWC,SAAQ,OAAQ;AAGpC,UAAI,QAAQ,KAAK,IAAI,KAAK,QAAQ,KAAK,KAAK;AAC1C,mBAAW,KAAK,KAAK,MAAMA,SAAQ,MAAM,GAAG;AAC1C,gBAAM,OAAO,KAAK,MAAM,IAAI,CAAC;AAC7B,cAAI,QAAQ,KAAM,OAAM,QAAQ,IAAI,GAAG,IAAI;AAAA,QAC7C;AACF,gBAAU,IAAI;AACd;AAAA,IACF;AAWA,QAAI,IAAIA,SAAQ;AAChB,UAAM,QAAQ,oBAAI,IAAoB;AACtC,WAAO,IAAI,GAAG;AACZ,YAAM,IAAIA,SAAQ,IAAI,CAAC;AACvB,YAAM,IAAI,SAAS,QAAQ,IAAI,CAAC;AAChC,UAAI,KAAK,QAAQ,OAAO,IAAI,QAAQ,IAAK;AACzC,YAAM,OAAO,MAAM,QAAQ,IAAI,CAAC;AAChC,UAAI,QAAQ,QAAQ,QAAQ,QAAQ,OAAO,IAAK;AAChD,YAAM,IAAI,GAAG,QAAQ,IAAI;AACzB,cAAQ;AACR;AAAA,IACF;AACA,QAAI,MAAMA,SAAQ,OAAQ;AAC1B,cAAU,UAAU,EAAE,OAAO,MAAM;AACnC,cAAUA,SAAQ,MAAM,GAAG,CAAC,CAAC;AAAA,EAC/B,GAAG,CAAC,QAAQ,CAAC;AAGb,QAAM,WAAW,OAA8B,IAAI;AACnD,QAAM,UAAU,OAAiD,IAAI;AACrE,QAAM,aAAa,YAAY,MAAM;AACnC,UAAM,KAAK,SAAS;AACpB,UAAM,QAAQ,OAAO,QAAQ,SAAS,GAAG,cAAc,OAAO,KAAK;AACnE,QAAI,CAAC,MAAM,WAAW,QAAQ,SAAS,SAAS,MAAO;AACvD,QAAI,QAAQ,QAAS,IAAG,UAAU,QAAQ,QAAQ,KAAK;AAGvD,YAAQ,UAAU,QAAQ,EAAE,OAAO,OAAQ,MAAsB,YAAY,IAAI;AACjF,QAAI,MAAO,IAAG,QAAQ,KAAK;AAAA,EAC7B,GAAG,CAAC,CAAC;AAML,QAAM,cAAc,OAAkC,IAAI;AAC1D,kBAAgB,MAAM;AAGpB,eAAW;AACX,UAAM,MAAM,UAAU,CAAC,GAAG,SAAS,OAAO,SAAS,SAAS,MAAM,IAAI;AACtE,UAAM,OAAO,YAAY;AACzB,gBAAY,UAAU;AACtB,QAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,UAAU,KAAK,MAAM,CAAC,GAAG,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAG;AAC7F,YAAQ;AAAA,EACV,CAAC;AAYD,YAAU,MAAM;AACd,UAAM,KAAK,OAAO,QAAQ,SAAS;AACnC,QAAI,CAAC,UAAU,CAAC,MAAM,OAAO,mBAAmB,YAAa;AAC7D,UAAM,KAAK,IAAI,eAAe,CAAC,YAAY;AACzC,UAAI,UAAU;AACd,iBAAW,SAAS,SAAS;AAC3B,YAAI,MAAM,WAAW,GAAI,WAAU;AAAA,iBAC1B,QAAQ,WAAW,MAAM,WAAW,QAAQ,QAAQ,OAAO;AAElE,gBAAM,QAAQ,MAAM,gBAAgB,CAAC,GAAG,cAAc,MAAM,YAAY;AACxE,cAAI,KAAK,IAAI,QAAQ,QAAQ,QAAQ,KAAK,IAAI,KAAK;AACjD,oBAAQ,QAAQ,QAAQ;AACxB,sBAAU;AAAA,UACZ;AAAA,QACF;AAAA,MACF;AACA,UAAI,QAAS,SAAQ;AAAA,IACvB,CAAC;AACD,OAAG,QAAQ,EAAE;AACb,aAAS,UAAU;AACnB,eAAW;AACX,WAAO,MAAM;AACX,SAAG,WAAW;AACd,eAAS,UAAU;AACnB,cAAQ,UAAU;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,QAAQ,SAAS,UAAU,CAAC;AAEhC,QAAM,OAAO,YAAY,CAAC,KAAa,OAAgB;AACrD,YAAQ,CAAC,MAAM;AACb,UAAI,EAAE,IAAI,GAAG,MAAM,GAAI,QAAO;AAC9B,YAAM,OAAO,IAAI,IAAI,CAAC;AACtB,UAAI,GAAI,MAAK,IAAI,GAAG;AAAA,UACf,MAAK,OAAO,GAAG;AACpB,aAAO;AAAA,IACT,CAAC;AAAA,EACH,GAAG,CAAC,CAAC;AAEL,QAAM,aAAa,QAAQ,MAAM,IAAI,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC;AAC5D,SAAO,EAAE,YAAY,KAAK;AAC5B;","names":["order","current","growKey","growMin","active","scroller"]}
+{"version":3,"sources":["../../src/components/data-table-fit.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\";\nimport type { DataTableColumn } from \"./data-table\";\n\n// DataTable's fit to its own width (0.48, keksdose live #451: \"On expanded sidebar for\n// desktop the table scrolls horizontally. On collapsed sidebar it fits […] Compute the\n// width selectively\"). Two column options, both opt-in:\n//\n// - `grow`: the column takes what the others leave and ellipsises (`w-full max-w-0` on\n//   its cells: in an auto table layout that is \"the rest of the row\", never its content's\n//   width), so one long title can no longer widen the table.\n// - `fitPriority`: while the table is wider than its scroller — or, with a `grow` column,\n//   while that column would get less than {@link GROW_MIN_REM} — the table leaves out\n//   its `fitPriority` columns, the LOWEST number first (ties: the later column first),\n//   and brings them back in the reverse order as soon as the table, as it is NOW, has\n//   room for them (its need re-measured, plus the column's own header width from when\n//   it was left out), so narrower content (a filter, another page) counts as much as a\n//   wider scroller. The scroller's own width, through a ResizeObserver: a sidebar, a\n//   narrower window, the Columns drawer and Large text all count the same. A column\n//   whose return the very next measure undoes stays out until the table has more room\n//   for it than it had then (0.48.3, keksdose B2: see the bring-back in `measure`). And\n//   the TABLE's own width, through the same observer (0.51.2): anything that widens it\n//   after a measure — rows drawn a frame later, `virtualize` locking its column widths —\n//   is measured again, so the table never stays wider than its scroller.\n\n/** The least a `grow` column keeps before the table starts leaving columns out: about\n *  a sentence of a title. In rem, so Large text asks for more. */\nexport const GROW_MIN_REM = 10;\n\n/** The `<th>`/`<td>` classes of a `grow` column. `truncate-until-large`: one line and an\n *  ellipsis at Normal, a wrap from Large up (text size §10.17), as every kit title. The\n *  header's `min-w-[10rem]` ({@link GROW_MIN_REM}) is the floor once no `fitPriority`\n *  column is left to leave out: the table then scrolls sideways rather than crushing the\n *  column it exists for (Kurvenschmiede S1, 0.48: Subject was 24px at 1100px). */\nexport const GROW_HEAD_CLASS = \"w-full max-w-0 min-w-[10rem]\";\nexport const GROW_CELL_CLASS = \"w-full max-w-0 truncate-until-large\";\n\n/** Every OTHER cell of a table with a `grow` column (kastlan S2, 0.48). A `w-full` column\n *  squeezes the rest to their min-content width, so any text with a space broke in two\n *  even at 1920px (\"CHF 2'568.38\", \"Peter Mueller\", a date with its time). One line at\n *  Normal, so a column is never narrower than its text and `fitPriority` measures what\n *  the columns really need; from Large up the cell wraps as before (§10.17). The headers\n *  are `whitespace-nowrap` already. A column whose prose should wrap anyway passes\n *  `not-large:whitespace-normal` in its `className`. */\nexport const GROW_PEER_CELL_CLASS = \"not-large:whitespace-nowrap\";\n\n// A cell's own flex-wrap row (chips) is left to wrap beside a `grow` column: a row of\n// badges reads as well stacked, and held to one line it widened the user roster's Status\n// until kastlan's admin pane scrolled 21px at 1280px (0.48 build review 2, kastlan S1).\n\n/** The auto-hide order: lowest `fitPriority` first, the later column first on a tie. */\nexport function fitHideOrder<T>(columns: readonly DataTableColumn<T>[]): DataTableColumn<T>[] {\n  return columns\n    .map((col, index) => ({ col, index }))\n    .filter(({ col }) => col.fitPriority != null)\n    .sort((a, b) => a.col.fitPriority! - b.col.fitPriority! || b.index - a.index)\n    .map(({ col }) => col);\n}\n\n/**\n * Which columns the table leaves out for width, and the Columns panel's \"keep it\".\n *\n * A column the user TICKS in the Columns panel is theirs: it is never left out for width\n * again while the table is mounted (`keep`): the table makes room by leaving out the next\n * candidate, and scrolls sideways once none is left — what they asked for. Unticking it hides it as before (the persisted `hiddenCols`) and\n * drops the keep. Keeps are not persisted: on the next visit the table fits again.\n */\nexport function useColumnFit<T>({\n  columns,\n  hiddenCols,\n  headRefs,\n  scroller,\n  enabled,\n  content,\n}: {\n  columns: readonly DataTableColumn<T>[];\n  /** The user's hidden columns: never candidates (they are out already). */\n  hiddenCols: Set<string>;\n  headRefs: Map<string, HTMLTableCellElement>;\n  /** The desktop scroller, read after render (it is declared below the call). */\n  scroller: () => HTMLElement | null;\n  /** The wide layout. On a phone (the card list) nothing is left out for width. */\n  enabled: boolean;\n  /**\n   * What can change the columns' widths besides the scroller (0.48.2): the rows on\n   * screen, the columns, the stored widths, the text size. Compared item by item after\n   * each render (`Object.is`), and the table is measured only when one changed — a\n   * selection tick no longer forces a layout of the whole table. Without it, every render\n   * measures. So each item must keep its identity while it means the same: the page's\n   * rows memoised, the columns as their keys (DSP-19).\n   */\n  content?: readonly unknown[];\n}): {\n  /** The columns left out for width now — empty while off. */\n  autoHidden: Set<string>;\n  /** The user's choice in the Columns panel: `true` keeps the column in whatever the width. */\n  keep: (key: string, on: boolean) => void;\n} {\n  const [kept, setKept] = useState<ReadonlySet<string>>(() => new Set());\n  const [hidden, setHidden] = useState<string[]>([]);\n  // A column's own header width, written when it is left out: it comes back once the\n  // table's need as it is now, plus this, fits the scroller (keksdose S3, 0.48: not the\n  // whole table's need at hide time, which went stale when the content narrowed).\n  const ownWidth = useRef(new Map<string, number>());\n  // A column whose return the very next measure undid, at the same scroller width: the\n  // room the table had for it when it came back (keksdose B2, 0.48.3). It stays out\n  // until the table has more. Dropped once the column is no longer left out for width.\n  const stuck = useRef(new Map<string, number>());\n  // What the last measure brought back, each column with the room it had then, and at\n  // which scroller width: read (and cleared) by the measure right after it.\n  const lastShown = useRef<{ avail: number; rooms: Map<string, number> } | null>(null);\n\n  const hasFit = columns.some((c) => c.fitPriority != null);\n  const active = enabled && hasFit;\n  const order = useMemo(\n    () => fitHideOrder(columns).filter((c) => !hiddenCols.has(c.key) && !kept.has(c.key)),\n    [columns, hiddenCols, kept],\n  );\n  // Only the candidates still in play, in hide order — a column the user hid or kept\n  // since, or one the app dropped, is no longer \"hidden for width\".\n  const current = useMemo(\n    () => (active ? order.filter((c) => hidden.includes(c.key)).map((c) => c.key) : []),\n    [active, order, hidden],\n  );\n  const growCol = columns.find((c) => c.grow && !hiddenCols.has(c.key));\n  const growKey = growCol?.key;\n  const growMin = growCol?.growMin ?? GROW_MIN_REM;\n\n  // What `measure` reads, refreshed after each render (before the measure below runs):\n  // the ResizeObserver's callback is set up once and must see the current columns.\n  const latest = useRef({ order, current, growKey, growMin, active, scroller });\n  useLayoutEffect(() => {\n    latest.current = { order, current, growKey, growMin, active, scroller };\n  });\n\n  const measure = useCallback(() => {\n    const { order, current, growKey, growMin, active, scroller } = latest.current;\n    // Only the measure right after a bring-back can undo it.\n    const flip = lastShown.current;\n    lastShown.current = null;\n    for (const k of stuck.current.keys()) if (!current.includes(k)) stuck.current.delete(k);\n    const el = scroller();\n    if (!active || !el) return;\n    const table = el.querySelector(\"table\");\n    const avail = el.clientWidth;\n    // Not laid out (display:none, jsdom): nothing to fit to.\n    if (!table || avail <= 0) return;\n    const growTh = growKey ? headRefs.get(growKey) : undefined;\n    const rem = parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;\n    let need = growTh ? table.offsetWidth - growTh.offsetWidth + growMin * rem : table.offsetWidth;\n    if (!growTh && need <= avail + 0.5 && current.length > 0) {\n      // A `w-full` table is at least the scroller's width, which says nothing about how\n      // much room its content leaves: probe its content's width (what it takes once it\n      // overflows) for the bring-back below. Read and put back in one layout pass.\n      const before = table.style.width;\n      table.style.width = \"min-content\";\n      need = table.offsetWidth;\n      table.style.width = before;\n    }\n    if (need > avail + 0.5) {\n      // Leave out, in order, until the rest fits: each column saves its header's width\n      // (the others are at their content's width while a `grow` column takes the rest).\n      const next = [...current];\n      for (const col of order) {\n        if (need <= avail + 0.5) break;\n        if (next.includes(col.key)) continue;\n        const w = headRefs.get(col.key)?.offsetWidth ?? 0;\n        ownWidth.current.set(col.key, w);\n        need -= w;\n        next.push(col.key);\n      }\n      if (next.length === current.length) return;\n      // The last measure brought these back at this same width, and the table cannot\n      // hold them: their header width fell short of what they cost drawn (see below).\n      if (flip && Math.abs(flip.avail - avail) <= 0.5)\n        for (const k of next.slice(current.length)) {\n          const room = flip.rooms.get(k);\n          if (room != null) stuck.current.set(k, room);\n        }\n      setHidden(next);\n      return;\n    }\n    // Bring back, the last left out first, while the table as it is now has room for\n    // them by their recorded header width. A column that costs more drawn than that is\n    // left out again by the next measure, before paint. That alone does not settle it:\n    // the re-hide records its header's width again, and the header can measure the same\n    // while the column costs more (`virtualize`'s locked widths, keksdose B2, 0.48.3: the\n    // drawn column cost the table ~80–110px more than its header), so it came back, went, came back … until React's\n    // update limit (#185). So a column whose return the next measure undid, at the same\n    // scroller width, waits for more room than it had then: a wider scroller or narrower\n    // content. Whatever the error in its width, that is one invisible flip per room it is\n    // tried at.\n    let n = current.length;\n    const rooms = new Map<string, number>();\n    while (n > 0) {\n      const k = current[n - 1];\n      const w = ownWidth.current.get(k);\n      if (w == null || need + w > avail + 0.5) break;\n      const room = stuck.current.get(k);\n      if (room != null && avail - need <= room + 0.5) break;\n      rooms.set(k, avail - need);\n      need += w;\n      n--;\n    }\n    if (n === current.length) return;\n    lastShown.current = { avail, rooms };\n    setHidden(current.slice(0, n));\n  }, [headRefs]);\n\n  // The table the observer below watches, kept to this render's.\n  const observer = useRef<ResizeObserver | null>(null);\n  const watched = useRef<{ table: Element; width: number } | null>(null);\n  const watchTable = useCallback(() => {\n    const ro = observer.current;\n    const table = latest.current.scroller()?.querySelector(\"table\") ?? null;\n    if (!ro || table === (watched.current?.table ?? null)) return;\n    if (watched.current) ro.unobserve(watched.current.table);\n    // Its width now, as the measure that just ran saw it: a report of the same width is\n    // not news, one that differs is (it may come a frame later, rows drawn by then).\n    watched.current = table ? { table, width: (table as HTMLElement).offsetWidth } : null;\n    if (table) ro.observe(table);\n  }, []);\n\n  // After a render that changed what is drawn: rows, a filter or a page can widen a\n  // column as much as a resize. Before paint, so a column the table cannot hold is never\n  // drawn first. A render that changed none of it (a ticked box, a focused row) skips the\n  // measure, which forces a layout of the whole table (0.48.2, keksdose dev #632).\n  const lastContent = useRef<readonly unknown[] | null>(null);\n  // The candidates by their keys, not by identity (refactor audit 2026-10-30, DSP-19):\n  // both are memoised on `columns`, which a call site writes inline — a new array, and\n  // so a \"change\", on every render of the page around the table.\n  const orderSig = order.map((c) => c.key).join(\"\\u0000\");\n  const currentSig = current.join(\"\\u0000\");\n  useLayoutEffect(() => {\n    // The table the observer watches is this render's (a table drawn after a loading\n    // state, or remounted, is a new element).\n    watchTable();\n    // And what the fit measures under the same keys (0.52 code review, data-table.tsx):\n    // the headers' text as drawn — a locale switch keeps every key and changes every\n    // header, and German → English left out the columns German had no room for, on a\n    // table with room to spare (narrower, a `w-full` table keeps the scroller's width,\n    // which the observer below watches) — and the grow column's floor. Text is read\n    // without a layout.\n    const headText = active ? (scroller()?.querySelector(\"thead\")?.textContent ?? \"\") : \"\";\n    const now = content ? [...content, orderSig, currentSig, growKey, growMin, active, headText] : null;\n    const prev = lastContent.current;\n    lastContent.current = now;\n    if (now && prev && prev.length === now.length && prev.every((v, i) => Object.is(v, now[i]))) return;\n    measure();\n  });\n\n  // The scroller, and the table in it (0.51.2, keksdose's register). The fit measured\n  // after a render that changed `content` and when the SCROLLER changed size, but the table\n  // also widens on its own after that: under `virtualize` the rows actually drawn are the\n  // window's, set a frame later, and its column-width lock lands a frame later still —\n  // neither is `content`, and the scroller keeps its size. A load whose first measure saw\n  // the table before its rows were in kept every `fitPriority` column and then overflowed\n  // for good (893px in 757 at 1124, 1058 in 913 at 1280, on 0.50.1 as on 0.51). Watched,\n  // a table that grows past what was measured is measured again. Only a WIDTH change of\n  // the table counts: its height moves with every row the window draws, and each measure\n  // lays the whole table out.\n  useEffect(() => {\n    const el = latest.current.scroller();\n    if (!active || !el || typeof ResizeObserver === \"undefined\") return;\n    const ro = new ResizeObserver((entries) => {\n      let changed = false;\n      for (const entry of entries) {\n        if (entry.target === el) changed = true;\n        else if (watched.current && entry.target === watched.current.table) {\n          // The border box, as `offsetWidth` reads it (the content rect leaves the border out).\n          const width = entry.borderBoxSize?.[0]?.inlineSize ?? entry.contentRect.width;\n          if (Math.abs(width - watched.current.width) > 0.5) {\n            watched.current.width = width;\n            changed = true;\n          }\n        }\n      }\n      if (changed) measure();\n    });\n    ro.observe(el);\n    observer.current = ro;\n    watchTable();\n    return () => {\n      ro.disconnect();\n      observer.current = null;\n      watched.current = null;\n    };\n  }, [active, measure, watchTable]);\n\n  const keep = useCallback((key: string, on: boolean) => {\n    setKept((s) => {\n      if (s.has(key) === on) return s;\n      const next = new Set(s);\n      if (on) next.add(key);\n      else next.delete(key);\n      return next;\n    });\n  }, []);\n\n  const autoHidden = useMemo(() => new Set(current), [current]);\n  return { autoHidden, keep };\n}\n"],"mappings":"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","names":["order","current","growKey","growMin","active","scroller"]}

package/dist/components/data-table-groups.d.ts

@@ -49,7 +49,7 @@ export interface RowGroup<T> {
     children: RowGroup<T>[] | null;
 }
 /** Consecutive runs by `level.key`, nested once for a second level. */
-export declare function groupRows<T>(rows: T[], levels: readonly DataTableGroupBy<T>[], offset?: number): RowGroup<T>[];
+export declare function groupRows<T>(rows: readonly T[], levels: readonly DataTableGroupBy<T>[], offset?: number): RowGroup<T>[];
 /** `groupBy` as a list of at most two levels. */
 export declare function groupLevels<T>(groupBy: DataTableGroupBy<T> | readonly [DataTableGroupBy<T>, DataTableGroupBy<T>?] | undefined): DataTableGroupBy<T>[];
 /**

package/dist/components/data-table-groups.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/data-table-groups.tsx"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport type { ReactNode, RefObject } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { Button } from \"./button\";\nimport { Spinner } from \"./spinner\";\n\n/**\n * One level of {@link DataTableProps.groupBy} (0.48, keksdose dev #605): the rows are cut\n * into consecutive runs of equal `key` — the rows must already be ordered so equal keys\n * are contiguous, as for `mobileGroupBy` — and each run is headed by a full-width band.\n *\n * The same object drives the phone: `mobileGroupBy` takes a level too, so\n * `groupBy={[period, day]} mobileGroupBy={period}` is one definition for both layouts.\n */\nexport interface DataTableGroupBy<T> {\n  /** The group a row belongs to. */\n  key: (row: T) => string;\n  /** The band's label. Default: the key itself. */\n  label?: (key: string, rows: T[]) => ReactNode;\n  /**\n   * The band's end slot — a count, a total (\"176 · +8'782.30 · −3'200.10\"). `rows` are\n   * the group's rows the table holds; an app whose total covers rows not yet loaded\n   * looks it up by `key` instead.\n   */\n  end?: (key: string, rows: T[]) => ReactNode;\n}\n\n/**\n * {@link DataTableProps.loadMore} (0.48, keksdose dev #605): a footer in place of the\n * pager that loads the next slice of rows — on its own as it scrolls into view (an\n * IntersectionObserver), and through a button that is always there for the keyboard and\n * the screen reader. The owner appends the rows; the table renders every row it is given.\n */\nexport interface DataTableLoadMore {\n  /** Whether there is anything left to load. False draws the end state. */\n  hasMore: boolean;\n  /** Load the next slice. Called at most once per row count while `loading` is false. */\n  onLoadMore: () => void;\n  /** A load is in flight: the button says \"Loading…\" and ignores presses. */\n  loading?: boolean;\n  /** The button's words — what it loads (\"Load August 2026\"). Default: the kit's \"Load more\". */\n  label?: ReactNode;\n  /** What the footer says once `hasMore` is false. Default: the kit's \"All rows loaded\";\n   *  `null` draws nothing. */\n  endLabel?: ReactNode;\n  /** Load as the footer scrolls into view. Default true; false leaves only the button. */\n  auto?: boolean;\n}\n\n/** A run of rows under one band; `start` is its first row's index in the slice. */\nexport interface RowGroup<T> {\n  key: string;\n  rows: T[];\n  start: number;\n  /** The second level's runs inside this one, or null with one level. */\n  children: RowGroup<T>[] | null;\n}\n\n/** Consecutive runs by `level.key`, nested once for a second level. */\nexport function groupRows<T>(rows: T[], levels: readonly DataTableGroupBy<T>[], offset = 0): RowGroup<T>[] {\n  const [level, ...rest] = levels;\n  if (!level) return [];\n  const out: RowGroup<T>[] = [];\n  rows.forEach((row, i) => {\n    const key = level.key(row);\n    const last = out[out.length - 1];\n    if (last && last.key === key) last.rows.push(row);\n    else out.push({ key, rows: [row], start: offset + i, children: null });\n  });\n  if (rest.length > 0) for (const g of out) g.children = groupRows(g.rows, rest.slice(0, 1), g.start);\n  return out;\n}\n\n/** `groupBy` as a list of at most two levels. */\nexport function groupLevels<T>(\n  groupBy: DataTableGroupBy<T> | readonly [DataTableGroupBy<T>, DataTableGroupBy<T>?] | undefined,\n): DataTableGroupBy<T>[] {\n  if (!groupBy) return [];\n  const list = \"key\" in groupBy ? [groupBy] : (groupBy as readonly (DataTableGroupBy<T> | undefined)[]);\n  return list.filter((l): l is DataTableGroupBy<T> => !!l).slice(0, 2);\n}\n\n/**\n * The bands' sticky offsets: the first level under the header (and under a sticky\n * `leadingRow`), the second under the first. Measured — the header grows at Large text,\n * a band's end slot can wrap — and followed with a ResizeObserver.\n */\nexport function useGroupBandTops(\n  tableRef: RefObject<HTMLTableElement | null>,\n  enabled: boolean,\n  signature: string,\n): [number, number] {\n  const [tops, setTops] = useState<[number, number]>([0, 0]);\n  useLayoutEffect(() => {\n    const table = tableRef.current;\n    if (!enabled || !table) return;\n    // Looked up afresh on each measure: under `virtualize` (0.48.2) the first band can\n    // leave the DOM as the rows scroll, and a detached cell measures 0 — the bands would\n    // stack on one another. A band missing for now keeps the height it had.\n    const parts = () => [\n      table.tHead,\n      table.querySelector<HTMLElement>(\"[data-leading-row='sticky']\"),\n      table.querySelector<HTMLElement>(\"th[data-group-band='1']\"),\n    ];\n    let bandHeight = 0;\n    const measure = () => {\n      const [headEl, leadEl, bandEl] = parts();\n      const head = headEl ? headEl.getBoundingClientRect().height : 0;\n      const lead = leadEl ? leadEl.getBoundingClientRect().height : 0;\n      if (bandEl) bandHeight = bandEl.getBoundingClientRect().height;\n      const band = bandHeight;\n      setTops((prev) =>\n        prev[0] === head + lead && prev[1] === head + lead + band ? prev : [head + lead, head + lead + band],\n      );\n    };\n    measure();\n    if (typeof ResizeObserver === \"undefined\") return;\n    const observer = new ResizeObserver(measure);\n    for (const el of parts()) if (el) observer.observe(el);\n    return () => observer.disconnect();\n  }, [tableRef, enabled, signature]);\n  return tops;\n}\n\n/**\n * A band row. A `<th scope=\"rowgroup\">` spanning the row — the header of the `<tbody>` it\n * opens, which a screen reader announces as the reader enters the group — and sticky on\n * the cell, not the `<tr>`, as the header's and the leading row's are. Opaque, under the\n * sticky leading row's `z-[5]`: the first level `z-[4]` over the second's `z-[3]`, so a\n * period arriving from below covers the day still pinned under the one before. The line\n * over it is the cell's own `::before`, which moves with the stuck cell.\n */\nexport function DataTableGroupBand({\n  level,\n  colSpan,\n  top,\n  compact,\n  label,\n  end,\n  ariaRowIndex,\n}: {\n  level: 1 | 2;\n  colSpan: number;\n  top: number;\n  compact: boolean;\n  label: ReactNode;\n  end: ReactNode;\n  /** Under `virtualize` (0.48.2). */\n  ariaRowIndex?: number;\n}) {\n  return (\n    <tr data-group-row={level} aria-rowindex={ariaRowIndex}>\n      <th\n        scope=\"rowgroup\"\n        colSpan={colSpan}\n        data-group-band={level}\n        style={{ top }}\n        className={cn(\n          \"sticky p-0 text-start align-middle\",\n          \"before:pointer-events-none before:absolute before:inset-x-0 before:top-0 before:z-[1] before:h-px before:bg-[var(--border)] before:content-['']\",\n          level === 1 ? \"z-[4] bg-surface-2 font-semibold text-primary\" : \"z-[3] bg-surface font-medium text-secondary\",\n          level === 1 ? (compact ? \"text-xs\" : \"text-sm\") : \"text-xs\",\n        )}\n      >\n        {/* Pinned to what the scroller shows, as the expansion row's panel is: the end\n            slot stays at the visible end of a table wider than its scroller. */}\n        <div className=\"w-0 min-w-full\">\n          <div\n            className={cn(\n              \"sticky start-0 flex w-[var(--dt-visible-w,100%)] max-w-full flex-wrap items-baseline justify-between gap-x-3\",\n              compact ? \"px-2 py-1\" : level === 1 ? \"px-3 py-2\" : \"px-3 py-1.5\",\n            )}\n          >\n            <span className=\"min-w-0\">{label}</span>\n            {end != null && end !== false && <span className=\"ms-auto tabular-nums\">{end}</span>}\n          </div>\n        </div>\n      </th>\n    </tr>\n  );\n}\n\n/**\n * The load-more footer. Observed against the viewport (an implicit root sees through the\n * clipping scroller, so it works in a bounded body, under `fillHeight`, and in a page that\n * scrolls), and guarded: one call per row count, none while `loading`, so an observer\n * that reports twice — or a footer still in view while the owner sets `loading` — loads\n * once. When the rows arrive and the footer is still in view (a short slice), it loads\n * again, until the scroller is full.\n */\nexport function DataTableLoadMoreFooter({\n  loadMore,\n  rowCount,\n  labels,\n  compact,\n  as: Tag = \"div\",\n}: {\n  loadMore: DataTableLoadMore;\n  rowCount: number;\n  labels: { loadMore: string; allLoaded: string; loading: string };\n  compact: boolean;\n  as?: \"div\" | \"li\";\n}) {\n  const { hasMore, onLoadMore, loading = false, auto = true, label, endLabel } = loadMore;\n  const rootRef = useRef<HTMLElement | null>(null);\n  const endRef = useRef<HTMLParagraphElement | null>(null);\n  const firedAt = useRef<number | null>(null);\n  const buttonFocused = useRef(false);\n  // What the observer's callback acts on: the latest props, not the ones it was made with.\n  const latest = useRef({ onLoadMore, loading, rowCount });\n  useEffect(() => {\n    latest.current = { onLoadMore, loading, rowCount };\n  });\n\n  // A fresh observer whenever the rows or the in-flight flag change: its first report is\n  // the footer's position AFTER the new rows are laid out. Acting on a remembered \"in\n  // view\" instead fired a second load the moment the rows arrived, while the footer was\n  // still where the old last row had been (headless Chromium caught it).\n  useEffect(() => {\n    const el = rootRef.current;\n    if (!auto || !hasMore || loading || !el || typeof IntersectionObserver === \"undefined\") return;\n    const io = new IntersectionObserver(\n      (entries) => {\n        const now = latest.current;\n        if (!entries.some((e) => e.isIntersecting) || now.loading || firedAt.current === now.rowCount) return;\n        firedAt.current = now.rowCount;\n        now.onLoadMore();\n      },\n      { rootMargin: \"200px\" },\n    );\n    io.observe(el);\n    return () => io.disconnect();\n  }, [auto, hasMore, loading, rowCount]);\n\n  // A focused button that goes away (nothing left) hands its focus to the end line.\n  useEffect(() => {\n    if (!hasMore && buttonFocused.current) {\n      buttonFocused.current = false;\n      endRef.current?.focus();\n    }\n  }, [hasMore]);\n\n  const end = endLabel === undefined ? labels.allLoaded : endLabel;\n  return (\n    <Tag\n      ref={(el: HTMLElement | null) => {\n        rootRef.current = el;\n      }}\n      data-table-load-more=\"\"\n      className={cn(\n        \"sticky start-0 flex w-[var(--dt-visible-w,100%)] max-w-full flex-col items-center border-t border-subtle text-center\",\n        compact ? \"px-2 py-2\" : \"px-3 py-3\",\n      )}\n    >\n      {hasMore ? (\n        <Button\n          variant=\"secondary\"\n          size=\"sm\"\n          aria-busy={loading || undefined}\n          onFocus={() => (buttonFocused.current = true)}\n          onBlur={() => (buttonFocused.current = false)}\n          onClick={() => {\n            if (loading) return;\n            firedAt.current = rowCount;\n            onLoadMore();\n          }}\n        >\n          {loading ? (\n            <span className=\"inline-flex items-center gap-2\">\n              <Spinner label={null} className=\"size-4\" />\n              <bdi>{labels.loading}</bdi>\n            </span>\n          ) : (\n            (label ?? labels.loadMore)\n          )}\n        </Button>\n      ) : end != null && end !== false ? (\n        <p ref={endRef} tabIndex={-1} className=\"text-xs text-muted outline-none\">\n          {end}\n        </p>\n      ) : null}\n      {/* Mounted throughout, so a screen reader hears the load start. */}\n      <span role=\"status\" className=\"sr-only\">\n        {loading ? labels.loading : \"\"}\n      </span>\n    </Tag>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/data-table-groups.tsx"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport type { ReactNode, RefObject } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { Button } from \"./button\";\nimport { Spinner } from \"./spinner\";\n\n/**\n * One level of {@link DataTableProps.groupBy} (0.48, keksdose dev #605): the rows are cut\n * into consecutive runs of equal `key` — the rows must already be ordered so equal keys\n * are contiguous, as for `mobileGroupBy` — and each run is headed by a full-width band.\n *\n * The same object drives the phone: `mobileGroupBy` takes a level too, so\n * `groupBy={[period, day]} mobileGroupBy={period}` is one definition for both layouts.\n */\nexport interface DataTableGroupBy<T> {\n  /** The group a row belongs to. */\n  key: (row: T) => string;\n  /** The band's label. Default: the key itself. */\n  label?: (key: string, rows: T[]) => ReactNode;\n  /**\n   * The band's end slot — a count, a total (\"176 · +8'782.30 · −3'200.10\"). `rows` are\n   * the group's rows the table holds; an app whose total covers rows not yet loaded\n   * looks it up by `key` instead.\n   */\n  end?: (key: string, rows: T[]) => ReactNode;\n}\n\n/**\n * {@link DataTableProps.loadMore} (0.48, keksdose dev #605): a footer in place of the\n * pager that loads the next slice of rows — on its own as it scrolls into view (an\n * IntersectionObserver), and through a button that is always there for the keyboard and\n * the screen reader. The owner appends the rows; the table renders every row it is given.\n */\nexport interface DataTableLoadMore {\n  /** Whether there is anything left to load. False draws the end state. */\n  hasMore: boolean;\n  /** Load the next slice. Called at most once per row count while `loading` is false. */\n  onLoadMore: () => void;\n  /** A load is in flight: the button says \"Loading…\" and ignores presses. */\n  loading?: boolean;\n  /** The button's words — what it loads (\"Load August 2026\"). Default: the kit's \"Load more\". */\n  label?: ReactNode;\n  /** What the footer says once `hasMore` is false. Default: the kit's \"All rows loaded\";\n   *  `null` draws nothing. */\n  endLabel?: ReactNode;\n  /** Load as the footer scrolls into view. Default true; false leaves only the button. */\n  auto?: boolean;\n}\n\n/** A run of rows under one band; `start` is its first row's index in the slice. */\nexport interface RowGroup<T> {\n  key: string;\n  rows: T[];\n  start: number;\n  /** The second level's runs inside this one, or null with one level. */\n  children: RowGroup<T>[] | null;\n}\n\n/** Consecutive runs by `level.key`, nested once for a second level. */\nexport function groupRows<T>(rows: readonly T[], levels: readonly DataTableGroupBy<T>[], offset = 0): RowGroup<T>[] {\n  const [level, ...rest] = levels;\n  if (!level) return [];\n  const out: RowGroup<T>[] = [];\n  rows.forEach((row, i) => {\n    const key = level.key(row);\n    const last = out[out.length - 1];\n    if (last && last.key === key) last.rows.push(row);\n    else out.push({ key, rows: [row], start: offset + i, children: null });\n  });\n  if (rest.length > 0) for (const g of out) g.children = groupRows(g.rows, rest.slice(0, 1), g.start);\n  return out;\n}\n\n/** `groupBy` as a list of at most two levels. */\nexport function groupLevels<T>(\n  groupBy: DataTableGroupBy<T> | readonly [DataTableGroupBy<T>, DataTableGroupBy<T>?] | undefined,\n): DataTableGroupBy<T>[] {\n  if (!groupBy) return [];\n  const list = \"key\" in groupBy ? [groupBy] : (groupBy as readonly (DataTableGroupBy<T> | undefined)[]);\n  return list.filter((l): l is DataTableGroupBy<T> => !!l).slice(0, 2);\n}\n\n/**\n * The bands' sticky offsets: the first level under the header (and under a sticky\n * `leadingRow`), the second under the first. Measured — the header grows at Large text,\n * a band's end slot can wrap — and followed with a ResizeObserver.\n */\nexport function useGroupBandTops(\n  tableRef: RefObject<HTMLTableElement | null>,\n  enabled: boolean,\n  signature: string,\n): [number, number] {\n  const [tops, setTops] = useState<[number, number]>([0, 0]);\n  useLayoutEffect(() => {\n    const table = tableRef.current;\n    if (!enabled || !table) return;\n    // Looked up afresh on each measure: under `virtualize` (0.48.2) the first band can\n    // leave the DOM as the rows scroll, and a detached cell measures 0 — the bands would\n    // stack on one another. A band missing for now keeps the height it had.\n    const parts = () => [\n      table.tHead,\n      table.querySelector<HTMLElement>(\"[data-leading-row='sticky']\"),\n      table.querySelector<HTMLElement>(\"th[data-group-band='1']\"),\n    ];\n    let bandHeight = 0;\n    const measure = () => {\n      const [headEl, leadEl, bandEl] = parts();\n      const head = headEl ? headEl.getBoundingClientRect().height : 0;\n      const lead = leadEl ? leadEl.getBoundingClientRect().height : 0;\n      if (bandEl) bandHeight = bandEl.getBoundingClientRect().height;\n      const band = bandHeight;\n      setTops((prev) =>\n        prev[0] === head + lead && prev[1] === head + lead + band ? prev : [head + lead, head + lead + band],\n      );\n    };\n    measure();\n    if (typeof ResizeObserver === \"undefined\") return;\n    const observer = new ResizeObserver(measure);\n    for (const el of parts()) if (el) observer.observe(el);\n    return () => observer.disconnect();\n  }, [tableRef, enabled, signature]);\n  return tops;\n}\n\n/**\n * A band row. A `<th scope=\"rowgroup\">` spanning the row — the header of the `<tbody>` it\n * opens, which a screen reader announces as the reader enters the group — and sticky on\n * the cell, not the `<tr>`, as the header's and the leading row's are. Opaque, under the\n * sticky leading row's `z-[5]`: the first level `z-[4]` over the second's `z-[3]`, so a\n * period arriving from below covers the day still pinned under the one before. The line\n * over it is the cell's own `::before`, which moves with the stuck cell.\n */\nexport function DataTableGroupBand({\n  level,\n  colSpan,\n  top,\n  compact,\n  label,\n  end,\n  ariaRowIndex,\n}: {\n  level: 1 | 2;\n  colSpan: number;\n  top: number;\n  compact: boolean;\n  label: ReactNode;\n  end: ReactNode;\n  /** Under `virtualize` (0.48.2). */\n  ariaRowIndex?: number;\n}) {\n  return (\n    <tr data-group-row={level} aria-rowindex={ariaRowIndex}>\n      <th\n        scope=\"rowgroup\"\n        colSpan={colSpan}\n        data-group-band={level}\n        style={{ top }}\n        className={cn(\n          \"sticky p-0 text-start align-middle\",\n          \"before:pointer-events-none before:absolute before:inset-x-0 before:top-0 before:z-[1] before:h-px before:bg-[var(--border)] before:content-['']\",\n          level === 1 ? \"z-[4] bg-surface-2 font-semibold text-primary\" : \"z-[3] bg-surface font-medium text-secondary\",\n          level === 1 ? (compact ? \"text-xs\" : \"text-sm\") : \"text-xs\",\n        )}\n      >\n        {/* Pinned to what the scroller shows, as the expansion row's panel is: the end\n            slot stays at the visible end of a table wider than its scroller. */}\n        <div className=\"w-0 min-w-full\">\n          <div\n            className={cn(\n              \"sticky start-0 flex w-[var(--dt-visible-w,100%)] max-w-full flex-wrap items-baseline justify-between gap-x-3\",\n              compact ? \"px-2 py-1\" : level === 1 ? \"px-3 py-2\" : \"px-3 py-1.5\",\n            )}\n          >\n            <span className=\"min-w-0\">{label}</span>\n            {end != null && end !== false && <span className=\"ms-auto tabular-nums\">{end}</span>}\n          </div>\n        </div>\n      </th>\n    </tr>\n  );\n}\n\n/**\n * The load-more footer. Observed against the viewport (an implicit root sees through the\n * clipping scroller, so it works in a bounded body, under `fillHeight`, and in a page that\n * scrolls), and guarded: one call per row count, none while `loading`, so an observer\n * that reports twice — or a footer still in view while the owner sets `loading` — loads\n * once. When the rows arrive and the footer is still in view (a short slice), it loads\n * again, until the scroller is full.\n */\nexport function DataTableLoadMoreFooter({\n  loadMore,\n  rowCount,\n  labels,\n  compact,\n  as: Tag = \"div\",\n}: {\n  loadMore: DataTableLoadMore;\n  rowCount: number;\n  labels: { loadMore: string; allLoaded: string; loading: string };\n  compact: boolean;\n  as?: \"div\" | \"li\";\n}) {\n  const { hasMore, onLoadMore, loading = false, auto = true, label, endLabel } = loadMore;\n  const rootRef = useRef<HTMLElement | null>(null);\n  const endRef = useRef<HTMLParagraphElement | null>(null);\n  const firedAt = useRef<number | null>(null);\n  const buttonFocused = useRef(false);\n  // What the observer's callback acts on: the latest props, not the ones it was made with.\n  const latest = useRef({ onLoadMore, loading, rowCount });\n  useEffect(() => {\n    latest.current = { onLoadMore, loading, rowCount };\n  });\n\n  // A fresh observer whenever the rows or the in-flight flag change: its first report is\n  // the footer's position AFTER the new rows are laid out. Acting on a remembered \"in\n  // view\" instead fired a second load the moment the rows arrived, while the footer was\n  // still where the old last row had been (headless Chromium caught it).\n  useEffect(() => {\n    const el = rootRef.current;\n    if (!auto || !hasMore || loading || !el || typeof IntersectionObserver === \"undefined\") return;\n    const io = new IntersectionObserver(\n      (entries) => {\n        const now = latest.current;\n        if (!entries.some((e) => e.isIntersecting) || now.loading || firedAt.current === now.rowCount) return;\n        firedAt.current = now.rowCount;\n        now.onLoadMore();\n      },\n      { rootMargin: \"200px\" },\n    );\n    io.observe(el);\n    return () => io.disconnect();\n  }, [auto, hasMore, loading, rowCount]);\n\n  // A focused button that goes away (nothing left) hands its focus to the end line.\n  useEffect(() => {\n    if (!hasMore && buttonFocused.current) {\n      buttonFocused.current = false;\n      endRef.current?.focus();\n    }\n  }, [hasMore]);\n\n  const end = endLabel === undefined ? labels.allLoaded : endLabel;\n  return (\n    <Tag\n      ref={(el: HTMLElement | null) => {\n        rootRef.current = el;\n      }}\n      data-table-load-more=\"\"\n      className={cn(\n        \"sticky start-0 flex w-[var(--dt-visible-w,100%)] max-w-full flex-col items-center border-t border-subtle text-center\",\n        compact ? \"px-2 py-2\" : \"px-3 py-3\",\n      )}\n    >\n      {hasMore ? (\n        <Button\n          variant=\"secondary\"\n          size=\"sm\"\n          aria-busy={loading || undefined}\n          onFocus={() => (buttonFocused.current = true)}\n          onBlur={() => (buttonFocused.current = false)}\n          onClick={() => {\n            if (loading) return;\n            firedAt.current = rowCount;\n            onLoadMore();\n          }}\n        >\n          {loading ? (\n            <span className=\"inline-flex items-center gap-2\">\n              <Spinner label={null} className=\"size-4\" />\n              <bdi>{labels.loading}</bdi>\n            </span>\n          ) : (\n            (label ?? labels.loadMore)\n          )}\n        </Button>\n      ) : end != null && end !== false ? (\n        <p ref={endRef} tabIndex={-1} className=\"text-xs text-muted outline-none\">\n          {end}\n        </p>\n      ) : null}\n      {/* Mounted throughout, so a screen reader hears the load start. */}\n      <span role=\"status\" className=\"sr-only\">\n        {loading ? labels.loading : \"\"}\n      </span>\n    </Tag>\n  );\n}\n"],"mappings":";AAuKU,SAME,KANF;AAvKV,SAAS,WAAW,iBAAiB,QAAQ,gBAAgB;AAE7D,SAAS,UAAU;AACnB,SAAS,cAAc;AACvB,SAAS,eAAe;AAuDjB,SAAS,UAAa,MAAoB,QAAwC,SAAS,GAAkB;AAClH,QAAM,CAAC,OAAO,GAAG,IAAI,IAAI;AACzB,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,QAAM,MAAqB,CAAC;AAC5B,OAAK,QAAQ,CAAC,KAAK,MAAM;AACvB,UAAM,MAAM,MAAM,IAAI,GAAG;AACzB,UAAM,OAAO,IAAI,IAAI,SAAS,CAAC;AAC/B,QAAI,QAAQ,KAAK,QAAQ,IAAK,MAAK,KAAK,KAAK,GAAG;AAAA,QAC3C,KAAI,KAAK,EAAE,KAAK,MAAM,CAAC,GAAG,GAAG,OAAO,SAAS,GAAG,UAAU,KAAK,CAAC;AAAA,EACvE,CAAC;AACD,MAAI,KAAK,SAAS,EAAG,YAAW,KAAK,IAAK,GAAE,WAAW,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,KAAK;AAClG,SAAO;AACT;AAGO,SAAS,YACd,SACuB;AACvB,MAAI,CAAC,QAAS,QAAO,CAAC;AACtB,QAAM,OAAO,SAAS,UAAU,CAAC,OAAO,IAAK;AAC7C,SAAO,KAAK,OAAO,CAAC,MAAgC,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC;AACrE;AAOO,SAAS,iBACd,UACA,SACA,WACkB;AAClB,QAAM,CAAC,MAAM,OAAO,IAAI,SAA2B,CAAC,GAAG,CAAC,CAAC;AACzD,kBAAgB,MAAM;AACpB,UAAM,QAAQ,SAAS;AACvB,QAAI,CAAC,WAAW,CAAC,MAAO;AAIxB,UAAM,QAAQ,MAAM;AAAA,MAClB,MAAM;AAAA,MACN,MAAM,cAA2B,6BAA6B;AAAA,MAC9D,MAAM,cAA2B,yBAAyB;AAAA,IAC5D;AACA,QAAI,aAAa;AACjB,UAAM,UAAU,MAAM;AACpB,YAAM,CAAC,QAAQ,QAAQ,MAAM,IAAI,MAAM;AACvC,YAAM,OAAO,SAAS,OAAO,sBAAsB,EAAE,SAAS;AAC9D,YAAM,OAAO,SAAS,OAAO,sBAAsB,EAAE,SAAS;AAC9D,UAAI,OAAQ,cAAa,OAAO,sBAAsB,EAAE;AACxD,YAAM,OAAO;AACb;AAAA,QAAQ,CAAC,SACP,KAAK,CAAC,MAAM,OAAO,QAAQ,KAAK,CAAC,MAAM,OAAO,OAAO,OAAO,OAAO,CAAC,OAAO,MAAM,OAAO,OAAO,IAAI;AAAA,MACrG;AAAA,IACF;AACA,YAAQ;AACR,QAAI,OAAO,mBAAmB,YAAa;AAC3C,UAAM,WAAW,IAAI,eAAe,OAAO;AAC3C,eAAW,MAAM,MAAM,EAAG,KAAI,GAAI,UAAS,QAAQ,EAAE;AACrD,WAAO,MAAM,SAAS,WAAW;AAAA,EACnC,GAAG,CAAC,UAAU,SAAS,SAAS,CAAC;AACjC,SAAO;AACT;AAUO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GASG;AACD,SACE,oBAAC,QAAG,kBAAgB,OAAO,iBAAe,cACxC;AAAA,IAAC;AAAA;AAAA,MACC,OAAM;AAAA,MACN;AAAA,MACA,mBAAiB;AAAA,MACjB,OAAO,EAAE,IAAI;AAAA,MACb,WAAW;AAAA,QACT;AAAA,QACA;AAAA,QACA,UAAU,IAAI,kDAAkD;AAAA,QAChE,UAAU,IAAK,UAAU,YAAY,YAAa;AAAA,MACpD;AAAA,MAIA,8BAAC,SAAI,WAAU,kBACb;AAAA,QAAC;AAAA;AAAA,UACC,WAAW;AAAA,YACT;AAAA,YACA,UAAU,cAAc,UAAU,IAAI,cAAc;AAAA,UACtD;AAAA,UAEA;AAAA,gCAAC,UAAK,WAAU,WAAW,iBAAM;AAAA,YAChC,OAAO,QAAQ,QAAQ,SAAS,oBAAC,UAAK,WAAU,wBAAwB,eAAI;AAAA;AAAA;AAAA,MAC/E,GACF;AAAA;AAAA,EACF,GACF;AAEJ;AAUO,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,IAAI,MAAM;AACZ,GAMG;AACD,QAAM,EAAE,SAAS,YAAY,UAAU,OAAO,OAAO,MAAM,OAAO,SAAS,IAAI;AAC/E,QAAM,UAAU,OAA2B,IAAI;AAC/C,QAAM,SAAS,OAAoC,IAAI;AACvD,QAAM,UAAU,OAAsB,IAAI;AAC1C,QAAM,gBAAgB,OAAO,KAAK;AAElC,QAAM,SAAS,OAAO,EAAE,YAAY,SAAS,SAAS,CAAC;AACvD,YAAU,MAAM;AACd,WAAO,UAAU,EAAE,YAAY,SAAS,SAAS;AAAA,EACnD,CAAC;AAMD,YAAU,MAAM;AACd,UAAM,KAAK,QAAQ;AACnB,QAAI,CAAC,QAAQ,CAAC,WAAW,WAAW,CAAC,MAAM,OAAO,yBAAyB,YAAa;AACxF,UAAM,KAAK,IAAI;AAAA,MACb,CAAC,YAAY;AACX,cAAM,MAAM,OAAO;AACnB,YAAI,CAAC,QAAQ,KAAK,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,WAAW,QAAQ,YAAY,IAAI,SAAU;AAC/F,gBAAQ,UAAU,IAAI;AACtB,YAAI,WAAW;AAAA,MACjB;AAAA,MACA,EAAE,YAAY,QAAQ;AAAA,IACxB;AACA,OAAG,QAAQ,EAAE;AACb,WAAO,MAAM,GAAG,WAAW;AAAA,EAC7B,GAAG,CAAC,MAAM,SAAS,SAAS,QAAQ,CAAC;AAGrC,YAAU,MAAM;AACd,QAAI,CAAC,WAAW,cAAc,SAAS;AACrC,oBAAc,UAAU;AACxB,aAAO,SAAS,MAAM;AAAA,IACxB;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AAEZ,QAAM,MAAM,aAAa,SAAY,OAAO,YAAY;AACxD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK,CAAC,OAA2B;AAC/B,gBAAQ,UAAU;AAAA,MACpB;AAAA,MACA,wBAAqB;AAAA,MACrB,WAAW;AAAA,QACT;AAAA,QACA,UAAU,cAAc;AAAA,MAC1B;AAAA,MAEC;AAAA,kBACC;AAAA,UAAC;AAAA;AAAA,YACC,SAAQ;AAAA,YACR,MAAK;AAAA,YACL,aAAW,WAAW;AAAA,YACtB,SAAS,MAAO,cAAc,UAAU;AAAA,YACxC,QAAQ,MAAO,cAAc,UAAU;AAAA,YACvC,SAAS,MAAM;AACb,kBAAI,QAAS;AACb,sBAAQ,UAAU;AAClB,yBAAW;AAAA,YACb;AAAA,YAEC,oBACC,qBAAC,UAAK,WAAU,kCACd;AAAA,kCAAC,WAAQ,OAAO,MAAM,WAAU,UAAS;AAAA,cACzC,oBAAC,SAAK,iBAAO,SAAQ;AAAA,eACvB,IAEC,SAAS,OAAO;AAAA;AAAA,QAErB,IACE,OAAO,QAAQ,QAAQ,QACzB,oBAAC,OAAE,KAAK,QAAQ,UAAU,IAAI,WAAU,mCACrC,eACH,IACE;AAAA,QAEJ,oBAAC,UAAK,MAAK,UAAS,WAAU,WAC3B,oBAAU,OAAO,UAAU,IAC9B;AAAA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/components/data-table-head.d.ts

@@ -15,7 +15,7 @@ export declare function DataTableHead<T>({ visibleColumns, selection, compact, l
     hasSortCallback: boolean;
     /** The caller owns the filters (`onFiltersChange`), likewise. */
     hasFilterCallback: boolean;
-    sorts: SortState[];
+    sorts: readonly SortState[];
     filters: FilterState;
     selectOptionsByKey: Record<string, {
         value: string;

package/dist/components/data-table-head.js

@@ -7,6 +7,7 @@ import { defaultFilterState, isFilterActive, resolveFilter } from "./data-table-
 import { FilterPopover } from "./data-table-filter-popover.js";
 import { Popover } from "./popover.js";
 import { Tooltip } from "./tooltip.js";
+import { Checkbox } from "./checkbox.js";
 import { isTableOwnColumn } from "./data-table-row-actions.js";
 import { columnLabel, logicalAlign, splitCellProps } from "./data-table-shared.js";
 import { GROW_HEAD_CLASS } from "./data-table-fit.js";
@@ -49,14 +50,12 @@ function DataTableHead({
           compact ? "w-8 px-2 py-1" : "w-10 px-3 py-2"
         ),
         children: /* @__PURE__ */ jsx(
-          "input",
+          Checkbox,
           {
-            type: "checkbox",
-            className: cn("align-middle accent-indigo-600", compact ? "size-3.5" : "size-4"),
+            className: "align-middle",
+            inputClassName: compact ? "size-3.5" : void 0,
             checked: selection.allSelected,
-            ref: (el) => {
-              if (el) el.indeterminate = selection.someSelected && !selection.allSelected;
-            },
+            indeterminate: selection.someSelected && !selection.allSelected,
             onChange: (e) => selection.onToggleAll(e.target.checked),
             "aria-label": labels.selectAllRows
           }
@@ -109,20 +108,24 @@ function DataTableHead({
           )
         },
         /* @__PURE__ */ jsxs("div", { className: cn("flex items-center gap-1", isEndAligned && "flex-row-reverse"), children: [
-          /* @__PURE__ */ jsx(Tooltip, { label: sortable && multiSort ? labels.sortHint : void 0, portal: true, children: /* @__PURE__ */ jsxs(
+          sortable ? /* @__PURE__ */ jsx(Tooltip, { label: multiSort ? labels.sortHint : void 0, portal: true, children: /* @__PURE__ */ jsxs(
             "button",
             {
               type: "button",
-              onClick: (e) => sortable && toggleSort(col.key, e.shiftKey),
-              disabled: !sortable,
-              className: cn("flex items-center gap-1 text-start", sortable && "hover:text-primary"),
+              onClick: (e) => toggleSort(col.key, e.shiftKey),
+              className: "flex items-center gap-1 text-start hover:text-primary",
               children: [
                 /* @__PURE__ */ jsx("span", { children: col.header }),
-                sortable && /* @__PURE__ */ jsx(Icon, { className: cn("size-3", active ? "opacity-100" : "opacity-40") }),
+                /* @__PURE__ */ jsx(Icon, { className: cn("size-3", active ? "opacity-100" : "opacity-40") }),
                 active && sorts.length > 1 && /* @__PURE__ */ jsx("span", { className: "text-micro font-semibold leading-none text-brand", children: sortIdx + 1 })
               ]
             }
-          ) }),
+          ) }) : (
+            // Plain text (refactor audit 2026-10-30, DSP-23 a): a `<button disabled>`
+            // round it was read out as a dimmed button on every column that cannot
+            // be sorted — a control that is not there.
+            /* @__PURE__ */ jsx("span", { className: "text-start", children: col.header })
+          ),
           filter && /* @__PURE__ */ jsx(
             Popover,
             {

package/dist/components/data-table-head.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/data-table-head.tsx"],"sourcesContent":["import type { Dispatch, SetStateAction } from \"react\";\nimport { ArrowDown, ArrowUp, ArrowUpDown, Filter } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { defaultFilterState, isFilterActive, resolveFilter } from \"./data-table-filters\";\nimport type { FilterValue } from \"./data-table-filters\";\nimport type { SortState } from \"./data-table-sort\";\nimport { FilterPopover } from \"./data-table-filter-popover\";\nimport { Popover } from \"./popover\";\nimport { Tooltip } from \"./tooltip\";\nimport type { DataTableLabels } from \"./data-table-labels\";\nimport { isTableOwnColumn } from \"./data-table-row-actions\";\nimport { columnLabel, logicalAlign, splitCellProps } from \"./data-table-shared\";\nimport { GROW_HEAD_CLASS } from \"./data-table-fit\";\nimport type { DataTableColumn, DataTableProps, FilterState } from \"./data-table\";\n\n// DataTable's `<thead>` on a wide screen: the select-all box, and per column the sort\n// button, the filter popover and the resize handle. Moved out of data-table.tsx whole\n// (refactor audit 2026-10, MOD-3 step 5); the state it shows and changes stays the\n// table's.\n\n/** Whether a column is end-aligned — the header then puts its filter button first. */\nconst END_ALIGN = /(^|\\s)text-end(?=\\s|$)/;\n\n/** The wide-screen table's header row. */\nexport function DataTableHead<T>({\n  visibleColumns,\n  selection,\n  compact,\n  labels,\n  locale,\n  isServer,\n  hasSortCallback,\n  hasFilterCallback,\n  sorts,\n  filters,\n  selectOptionsByKey,\n  multiSort,\n  resizable,\n  widths,\n  setWidths,\n  headRefs,\n  toggleSort,\n  setFilterValue,\n  clearFilter,\n  startResize,\n  moveResize,\n  finishResize,\n  ariaRowIndex,\n  lockedWidths,\n  selectionLockKey,\n}: {\n  visibleColumns: DataTableColumn<T>[];\n  selection: DataTableProps<T>[\"selection\"];\n  compact: boolean;\n  labels: DataTableLabels;\n  locale?: string;\n  isServer: boolean;\n  /** The caller owns the sort (`onSortsChange`), so a server table can offer it. */\n  hasSortCallback: boolean;\n  /** The caller owns the filters (`onFiltersChange`), likewise. */\n  hasFilterCallback: boolean;\n  sorts: SortState[];\n  filters: FilterState;\n  selectOptionsByKey: Record<string, { value: string; label: string }[]>;\n  multiSort: boolean;\n  resizable: boolean;\n  widths: Record<string, number>;\n  setWidths: Dispatch<SetStateAction<Record<string, number>>>;\n  /** Filled here, one `<th>` per column — what a resize and \"Auto-size\" measure. */\n  headRefs: Map<string, HTMLTableCellElement>;\n  toggleSort: (key: string, shiftKey: boolean) => void;\n  setFilterValue: (key: string, value: FilterValue) => void;\n  clearFilter: (key: string) => void;\n  startResize: (e: React.PointerEvent<HTMLElement>, key: string) => void;\n  moveResize: (e: React.PointerEvent<HTMLElement>) => void;\n  finishResize: (e: React.PointerEvent<HTMLElement>, commit: boolean) => void;\n  /** Under `virtualize` (0.48.2): 1. */\n  ariaRowIndex?: number;\n  /** Under `virtualize` (0.48.2): each column's locked width, as the header cell's\n   *  `min-width` — a `<col>` width alone gave way to a `grow` column's 100%. */\n  lockedWidths?: Record<string, number> | null;\n  /** The selection column's key in `lockedWidths`. */\n  selectionLockKey?: string;\n}) {\n  return (\n    <thead className=\"bg-surface-2 text-secondary\">\n      <tr className=\"text-start\" aria-rowindex={ariaRowIndex}>\n        {selection && (\n          <th\n            scope=\"col\"\n            style={\n              selectionLockKey && lockedWidths?.[selectionLockKey] !== undefined\n                ? { minWidth: lockedWidths[selectionLockKey] }\n                : undefined\n            }\n            className={cn(\n              \"sticky top-0 z-10 bg-surface-2 align-middle backdrop-blur-sm\",\n              compact ? \"w-8 px-2 py-1\" : \"w-10 px-3 py-2\",\n            )}\n          >\n            <input\n              type=\"checkbox\"\n              className={cn(\"align-middle accent-indigo-600\", compact ? \"size-3.5\" : \"size-4\")}\n              checked={selection.allSelected}\n              ref={(el) => {\n                if (el) el.indeterminate = selection.someSelected && !selection.allSelected;\n              }}\n              onChange={(e) => selection.onToggleAll(e.target.checked)}\n              aria-label={labels.selectAllRows}\n            />\n          </th>\n        )}\n        {visibleColumns.map((col) => {\n          // In server mode the utilities stay hidden unless the caller\n          // takes them over and feeds them back into the server query.\n          const sortable = (!isServer || hasSortCallback) && !!col.sortBy;\n          const filter = !isServer || hasFilterCallback ? resolveFilter(col) : null;\n          const filterState = filters[col.key] ?? (filter ? defaultFilterState(filter) : undefined);\n          const sortIdx = sorts.findIndex((s) => s.key === col.key);\n          const active = sortIdx !== -1;\n          const Icon = active ? (sorts[sortIdx].dir === \"asc\" ? ArrowUp : ArrowDown) : ArrowUpDown;\n          const filterActive = filterState && isFilterActive(filterState);\n          // Logical, and a legacy `text-right` still counts — see `logicalAlign`.\n          const headClass = logicalAlign(col.headClassName);\n          const isEndAligned = !!headClass && END_ALIGN.test(headClass);\n          const width = widths[col.key];\n          const ownHead = splitCellProps(col.headProps);\n          const growFloor = col.grow && col.growMin != null ? `${col.growMin}rem` : undefined;\n          const pinnedHead = width ? { width, minWidth: width, maxWidth: width } : undefined;\n          return (\n            <th\n              {...ownHead.attrs}\n              key={col.key}\n              ref={(el) => {\n                if (el) headRefs.set(col.key, el);\n                else headRefs.delete(col.key);\n              }}\n              scope=\"col\"\n              // Only a header the user can actually sort says anything: an\n              // `aria-sort` on a plain column is a control that is not there,\n              // and a persisted or URL sort can name a column with no `sortBy`\n              // (the sort chain drops it silently) — which would otherwise\n              // claim a sort the table is not applying.\n              //\n              // \"none\" on the rest is the half that was missing. Without it a\n              // sortable header is indistinguishable from a plain one until the\n              // user presses it. Secondary criteria read \"none\" too: ARIA allows\n              // exactly one sorted column, and the priority is carried by the\n              // badge and by what the header button announces on press.\n              aria-sort={\n                sortable ? (sortIdx === 0 ? (sorts[0].dir === \"asc\" ? \"ascending\" : \"descending\") : \"none\") : undefined\n              }\n              style={\n                ownHead.style || pinnedHead || lockedWidths?.[col.key] !== undefined || growFloor\n                  ? {\n                      // A `grow` column's own floor (0.51.4), over the class's 10rem; a\n                      // locked width below wins, as it does over the class.\n                      ...(growFloor ? { minWidth: growFloor } : null),\n                      ...ownHead.style,\n                      ...(lockedWidths?.[col.key] !== undefined ? { minWidth: lockedWidths[col.key] } : null),\n                      ...pinnedHead,\n                    }\n                  : undefined\n              }\n              className={cn(\n                \"relative font-medium align-middle whitespace-nowrap\",\n                compact ? \"px-2 py-1\" : \"px-3 py-2\",\n                // Keep the header visible while the user scrolls the page.\n                // Each <th> carries its own bg so the row doesn't render\n                // transparent over the data rows underneath.\n                \"sticky top-0 z-10 bg-surface-2 backdrop-blur-sm\",\n                col.grow && GROW_HEAD_CLASS,\n                logicalAlign(ownHead.className),\n                headClass,\n              )}\n            >\n              <div className={cn(\"flex items-center gap-1\", isEndAligned && \"flex-row-reverse\")}>\n                <Tooltip label={sortable && multiSort ? labels.sortHint : undefined} portal>\n                  <button\n                    type=\"button\"\n                    onClick={(e) => sortable && toggleSort(col.key, e.shiftKey)}\n                    disabled={!sortable}\n                    className={cn(\"flex items-center gap-1 text-start\", sortable && \"hover:text-primary\")}\n                  >\n                    <span>{col.header}</span>\n                    {sortable && <Icon className={cn(\"size-3\", active ? \"opacity-100\" : \"opacity-40\")} />}\n                    {/* Priority badge, only meaningful with 2+ sort keys */}\n                    {active && sorts.length > 1 && (\n                      <span className=\"text-micro font-semibold leading-none text-brand\">{sortIdx + 1}</span>\n                    )}\n                  </button>\n                </Tooltip>\n                {filter && (\n                  <Popover\n                    // 420 px at Normal, in rem so the calendar grows with its\n                    // text (§3.2); Popover caps it at the viewport.\n                    width={filter.type === \"date\" ? \"26.25rem\" : undefined}\n                    // The panel is THIS column's filter, and says so. Unnamed it was\n                    // announced as the kit-wide fallback, \"Popover\"; then as \"Filter\"\n                    // in every column alike (round 0.34 Wave 2, BUG-7c).\n                    labels={{ panel: labels.filterColumn(columnLabel(col, labels), false) }}\n                    trigger={({ open, toggle, ref }) => (\n                      <button\n                        type=\"button\"\n                        ref={ref}\n                        onClick={toggle}\n                        // Named for its column, and for being filtered: the tint\n                        // alone said that to nobody who cannot see it (BUG-7c).\n                        aria-label={labels.filterColumn(columnLabel(col, labels), Boolean(filterActive))}\n                        aria-haspopup=\"dialog\"\n                        aria-expanded={open}\n                        className={cn(\n                          \"rounded p-1 transition-colors\",\n                          filterActive\n                            ? \"bg-brand-soft text-brand-muted\"\n                            : \"text-placeholder hover:text-secondary hover:bg-hover\",\n                        )}\n                      >\n                        <Filter className=\"size-3\" />\n                      </button>\n                    )}\n                  >\n                    {() => (\n                      <FilterPopover\n                        column={col}\n                        state={filterState ?? defaultFilterState(filter)}\n                        onChange={(next) => setFilterValue(col.key, next)}\n                        onClear={() => clearFilter(col.key)}\n                        selectOptions={selectOptionsByKey[col.key] ?? []}\n                        labels={labels}\n                        locale={locale}\n                      />\n                    )}\n                  </Popover>\n                )}\n              </div>\n              {/* A `grow` column takes the rest: no width of its own to drag (0.48, KS N2). */}\n              {resizable && !isTableOwnColumn(col.key) && !col.grow && (\n                /* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- a\n                 pointer-only drag handle for a visual preference (column width); it is\n                 deliberately not a tab stop, and no content or action depends on it. */\n                <span\n                  role=\"separator\"\n                  aria-orientation=\"vertical\"\n                  onPointerDown={(e) => startResize(e, col.key)}\n                  onPointerMove={moveResize}\n                  onPointerUp={(e) => finishResize(e, true)}\n                  onPointerCancel={(e) => finishResize(e, false)}\n                  onDoubleClick={(e) => {\n                    e.preventDefault();\n                    setWidths((w) => {\n                      const next = { ...w };\n                      delete next[col.key];\n                      return next;\n                    });\n                  }}\n                  // `touch-none`: without it the browser claims a finger drag for\n                  // scrolling before the first `pointermove` ever arrives.\n                  // `end-0` and a translate that flips with it: the handle sits on the column's\n                  // trailing edge, which is its left one in a right-to-left table.\n                  className=\"absolute end-0 top-0 z-10 h-full w-1.5 -translate-x-1/2 rtl:translate-x-1/2 cursor-col-resize select-none touch-none hover:bg-brand-soft-hover\"\n                />\n              )}\n            </th>\n          );\n        })}\n      </tr>\n    </thead>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/data-table-head.tsx"],"sourcesContent":["import type { Dispatch, SetStateAction } from \"react\";\nimport { ArrowDown, ArrowUp, ArrowUpDown, Filter } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { defaultFilterState, isFilterActive, resolveFilter } from \"./data-table-filters\";\nimport type { FilterValue } from \"./data-table-filters\";\nimport type { SortState } from \"./data-table-sort\";\nimport { FilterPopover } from \"./data-table-filter-popover\";\nimport { Popover } from \"./popover\";\nimport { Tooltip } from \"./tooltip\";\nimport { Checkbox } from \"./checkbox\";\nimport type { DataTableLabels } from \"./data-table-labels\";\nimport { isTableOwnColumn } from \"./data-table-row-actions\";\nimport { columnLabel, logicalAlign, splitCellProps } from \"./data-table-shared\";\nimport { GROW_HEAD_CLASS } from \"./data-table-fit\";\nimport type { DataTableColumn, DataTableProps, FilterState } from \"./data-table\";\n\n// DataTable's `<thead>` on a wide screen: the select-all box, and per column the sort\n// button, the filter popover and the resize handle. Moved out of data-table.tsx whole\n// (refactor audit 2026-10, MOD-3 step 5); the state it shows and changes stays the\n// table's.\n\n/** Whether a column is end-aligned — the header then puts its filter button first. */\nconst END_ALIGN = /(^|\\s)text-end(?=\\s|$)/;\n\n/** The wide-screen table's header row. */\nexport function DataTableHead<T>({\n  visibleColumns,\n  selection,\n  compact,\n  labels,\n  locale,\n  isServer,\n  hasSortCallback,\n  hasFilterCallback,\n  sorts,\n  filters,\n  selectOptionsByKey,\n  multiSort,\n  resizable,\n  widths,\n  setWidths,\n  headRefs,\n  toggleSort,\n  setFilterValue,\n  clearFilter,\n  startResize,\n  moveResize,\n  finishResize,\n  ariaRowIndex,\n  lockedWidths,\n  selectionLockKey,\n}: {\n  visibleColumns: DataTableColumn<T>[];\n  selection: DataTableProps<T>[\"selection\"];\n  compact: boolean;\n  labels: DataTableLabels;\n  locale?: string;\n  isServer: boolean;\n  /** The caller owns the sort (`onSortsChange`), so a server table can offer it. */\n  hasSortCallback: boolean;\n  /** The caller owns the filters (`onFiltersChange`), likewise. */\n  hasFilterCallback: boolean;\n  sorts: readonly SortState[];\n  filters: FilterState;\n  selectOptionsByKey: Record<string, { value: string; label: string }[]>;\n  multiSort: boolean;\n  resizable: boolean;\n  widths: Record<string, number>;\n  setWidths: Dispatch<SetStateAction<Record<string, number>>>;\n  /** Filled here, one `<th>` per column — what a resize and \"Auto-size\" measure. */\n  headRefs: Map<string, HTMLTableCellElement>;\n  toggleSort: (key: string, shiftKey: boolean) => void;\n  setFilterValue: (key: string, value: FilterValue) => void;\n  clearFilter: (key: string) => void;\n  startResize: (e: React.PointerEvent<HTMLElement>, key: string) => void;\n  moveResize: (e: React.PointerEvent<HTMLElement>) => void;\n  finishResize: (e: React.PointerEvent<HTMLElement>, commit: boolean) => void;\n  /** Under `virtualize` (0.48.2): 1. */\n  ariaRowIndex?: number;\n  /** Under `virtualize` (0.48.2): each column's locked width, as the header cell's\n   *  `min-width` — a `<col>` width alone gave way to a `grow` column's 100%. */\n  lockedWidths?: Record<string, number> | null;\n  /** The selection column's key in `lockedWidths`. */\n  selectionLockKey?: string;\n}) {\n  return (\n    <thead className=\"bg-surface-2 text-secondary\">\n      <tr className=\"text-start\" aria-rowindex={ariaRowIndex}>\n        {selection && (\n          <th\n            scope=\"col\"\n            style={\n              selectionLockKey && lockedWidths?.[selectionLockKey] !== undefined\n                ? { minWidth: lockedWidths[selectionLockKey] }\n                : undefined\n            }\n            className={cn(\n              \"sticky top-0 z-10 bg-surface-2 align-middle backdrop-blur-sm\",\n              compact ? \"w-8 px-2 py-1\" : \"w-10 px-3 py-2\",\n            )}\n          >\n            {/* The kit's Checkbox, as the phone card's (refactor audit 2026-10-30, DSP-14): the\n                native box wore `accent-indigo-600` over the kit's `--brand` accent, indigo on\n                every palette and, in dark mode, a checked box that read as unchecked. \"Some\"\n                is its `indeterminate` dash, set on the element after every render as the\n                ref here did. */}\n            <Checkbox\n              className=\"align-middle\"\n              inputClassName={compact ? \"size-3.5\" : undefined}\n              checked={selection.allSelected}\n              indeterminate={selection.someSelected && !selection.allSelected}\n              onChange={(e) => selection.onToggleAll(e.target.checked)}\n              aria-label={labels.selectAllRows}\n            />\n          </th>\n        )}\n        {visibleColumns.map((col) => {\n          // In server mode the utilities stay hidden unless the caller\n          // takes them over and feeds them back into the server query.\n          const sortable = (!isServer || hasSortCallback) && !!col.sortBy;\n          const filter = !isServer || hasFilterCallback ? resolveFilter(col) : null;\n          const filterState = filters[col.key] ?? (filter ? defaultFilterState(filter) : undefined);\n          const sortIdx = sorts.findIndex((s) => s.key === col.key);\n          const active = sortIdx !== -1;\n          const Icon = active ? (sorts[sortIdx].dir === \"asc\" ? ArrowUp : ArrowDown) : ArrowUpDown;\n          const filterActive = filterState && isFilterActive(filterState);\n          // Logical, and a legacy `text-right` still counts — see `logicalAlign`.\n          const headClass = logicalAlign(col.headClassName);\n          const isEndAligned = !!headClass && END_ALIGN.test(headClass);\n          const width = widths[col.key];\n          const ownHead = splitCellProps(col.headProps);\n          const growFloor = col.grow && col.growMin != null ? `${col.growMin}rem` : undefined;\n          const pinnedHead = width ? { width, minWidth: width, maxWidth: width } : undefined;\n          return (\n            <th\n              {...ownHead.attrs}\n              key={col.key}\n              ref={(el) => {\n                if (el) headRefs.set(col.key, el);\n                else headRefs.delete(col.key);\n              }}\n              scope=\"col\"\n              // Only a header the user can actually sort says anything: an\n              // `aria-sort` on a plain column is a control that is not there,\n              // and a persisted or URL sort can name a column with no `sortBy`\n              // (the sort chain drops it silently) — which would otherwise\n              // claim a sort the table is not applying.\n              //\n              // \"none\" on the rest is the half that was missing. Without it a\n              // sortable header is indistinguishable from a plain one until the\n              // user presses it. Secondary criteria read \"none\" too: ARIA allows\n              // exactly one sorted column, and the priority is carried by the\n              // badge and by what the header button announces on press.\n              aria-sort={\n                sortable ? (sortIdx === 0 ? (sorts[0].dir === \"asc\" ? \"ascending\" : \"descending\") : \"none\") : undefined\n              }\n              style={\n                ownHead.style || pinnedHead || lockedWidths?.[col.key] !== undefined || growFloor\n                  ? {\n                      // A `grow` column's own floor (0.51.4), over the class's 10rem; a\n                      // locked width below wins, as it does over the class.\n                      ...(growFloor ? { minWidth: growFloor } : null),\n                      ...ownHead.style,\n                      ...(lockedWidths?.[col.key] !== undefined ? { minWidth: lockedWidths[col.key] } : null),\n                      ...pinnedHead,\n                    }\n                  : undefined\n              }\n              className={cn(\n                \"relative font-medium align-middle whitespace-nowrap\",\n                compact ? \"px-2 py-1\" : \"px-3 py-2\",\n                // Keep the header visible while the user scrolls the page.\n                // Each <th> carries its own bg so the row doesn't render\n                // transparent over the data rows underneath.\n                \"sticky top-0 z-10 bg-surface-2 backdrop-blur-sm\",\n                col.grow && GROW_HEAD_CLASS,\n                logicalAlign(ownHead.className),\n                headClass,\n              )}\n            >\n              <div className={cn(\"flex items-center gap-1\", isEndAligned && \"flex-row-reverse\")}>\n                {sortable ? (\n                  <Tooltip label={multiSort ? labels.sortHint : undefined} portal>\n                    <button\n                      type=\"button\"\n                      onClick={(e) => toggleSort(col.key, e.shiftKey)}\n                      className=\"flex items-center gap-1 text-start hover:text-primary\"\n                    >\n                      <span>{col.header}</span>\n                      <Icon className={cn(\"size-3\", active ? \"opacity-100\" : \"opacity-40\")} />\n                      {/* Priority badge, only meaningful with 2+ sort keys */}\n                      {active && sorts.length > 1 && (\n                        <span className=\"text-micro font-semibold leading-none text-brand\">{sortIdx + 1}</span>\n                      )}\n                    </button>\n                  </Tooltip>\n                ) : (\n                  // Plain text (refactor audit 2026-10-30, DSP-23 a): a `<button disabled>`\n                  // round it was read out as a dimmed button on every column that cannot\n                  // be sorted — a control that is not there.\n                  <span className=\"text-start\">{col.header}</span>\n                )}\n                {filter && (\n                  <Popover\n                    // 420 px at Normal, in rem so the calendar grows with its\n                    // text (§3.2); Popover caps it at the viewport.\n                    width={filter.type === \"date\" ? \"26.25rem\" : undefined}\n                    // The panel is THIS column's filter, and says so. Unnamed it was\n                    // announced as the kit-wide fallback, \"Popover\"; then as \"Filter\"\n                    // in every column alike (round 0.34 Wave 2, BUG-7c).\n                    labels={{ panel: labels.filterColumn(columnLabel(col, labels), false) }}\n                    trigger={({ open, toggle, ref }) => (\n                      <button\n                        type=\"button\"\n                        ref={ref}\n                        onClick={toggle}\n                        // Named for its column, and for being filtered: the tint\n                        // alone said that to nobody who cannot see it (BUG-7c).\n                        aria-label={labels.filterColumn(columnLabel(col, labels), Boolean(filterActive))}\n                        aria-haspopup=\"dialog\"\n                        aria-expanded={open}\n                        className={cn(\n                          \"rounded p-1 transition-colors\",\n                          filterActive\n                            ? \"bg-brand-soft text-brand-muted\"\n                            : \"text-placeholder hover:text-secondary hover:bg-hover\",\n                        )}\n                      >\n                        <Filter className=\"size-3\" />\n                      </button>\n                    )}\n                  >\n                    {() => (\n                      <FilterPopover\n                        column={col}\n                        state={filterState ?? defaultFilterState(filter)}\n                        onChange={(next) => setFilterValue(col.key, next)}\n                        onClear={() => clearFilter(col.key)}\n                        selectOptions={selectOptionsByKey[col.key] ?? []}\n                        labels={labels}\n                        locale={locale}\n                      />\n                    )}\n                  </Popover>\n                )}\n              </div>\n              {/* A `grow` column takes the rest: no width of its own to drag (0.48, KS N2). */}\n              {resizable && !isTableOwnColumn(col.key) && !col.grow && (\n                /* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- a\n                 pointer-only drag handle for a visual preference (column width); it is\n                 deliberately not a tab stop, and no content or action depends on it. */\n                <span\n                  role=\"separator\"\n                  aria-orientation=\"vertical\"\n                  onPointerDown={(e) => startResize(e, col.key)}\n                  onPointerMove={moveResize}\n                  onPointerUp={(e) => finishResize(e, true)}\n                  onPointerCancel={(e) => finishResize(e, false)}\n                  onDoubleClick={(e) => {\n                    e.preventDefault();\n                    setWidths((w) => {\n                      const next = { ...w };\n                      delete next[col.key];\n                      return next;\n                    });\n                  }}\n                  // `touch-none`: without it the browser claims a finger drag for\n                  // scrolling before the first `pointermove` ever arrives.\n                  // `end-0` and a translate that flips with it: the handle sits on the column's\n                  // trailing edge, which is its left one in a right-to-left table.\n                  className=\"absolute end-0 top-0 z-10 h-full w-1.5 -translate-x-1/2 rtl:translate-x-1/2 cursor-col-resize select-none touch-none hover:bg-brand-soft-hover\"\n                />\n              )}\n            </th>\n          );\n        })}\n      </tr>\n    </thead>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/data-table-mobile.d.ts

@@ -12,7 +12,7 @@ import type { DataTableColumn, DataTableProps, FilterState, MobileSwipeActions }
  * header's `sr-only` text (an actions column's), as every kit container must.
  */
 export declare function StackedFields<T>({ columns, row, compact, liftOwnClicks, }: {
-    columns: DataTableColumn<T>[];
+    columns: readonly DataTableColumn<T>[];
     row: T;
     compact: boolean;
     /** On a stretched card (0.50 K4): lift the own-click fields above its title link. */
@@ -30,7 +30,7 @@ export declare const MOBILE_CARD_FIELDS = 3;
  * fields and the marks leave it on the card; only `mobileHidden` / `mobile: "hidden"`
  * (which keep it out of `columns`) remove it.
  */
-export declare function mobileCardColumns<T>(columns: DataTableColumn<T>[]): {
+export declare function mobileCardColumns<T>(columns: readonly DataTableColumn<T>[]): {
     primary: DataTableColumn<T> | null;
     status: DataTableColumn<T>[];
     fields: DataTableColumn<T>[];
@@ -51,7 +51,7 @@ export declare function keepsOwnClicks<T>(col: DataTableColumn<T>): boolean;
  * (the table's `storageKey` or `urlSync` prefix) says which table, else its title
  * column does.
  */
-export declare function useCardColumnWarnings<T>(columns: DataTableColumn<T>[], enabled: boolean, name?: string): void;
+export declare function useCardColumnWarnings<T>(columns: readonly DataTableColumn<T>[], enabled: boolean, name?: string): void;
 /**
  * Whether a rendered cell shows nothing worth a line (0.49 KIT-7): `null`, `undefined`,
  * a boolean (React draws neither), `""` or blank text, and the formatters' empty value
@@ -81,8 +81,8 @@ export declare function isEmptyCell(value: ReactNode): boolean;
  * open the select.
  */
 export declare function MobileSort<T>({ columns, sorts, sortCycle, compact, labels, onPick, onFlip, }: {
-    columns: DataTableColumn<T>[];
-    sorts: SortState[];
+    columns: readonly DataTableColumn<T>[];
+    sorts: readonly SortState[];
     sortCycle: SortCycle;
     compact: boolean;
     labels: DataTableLabels;
@@ -127,6 +127,11 @@ export interface MobileRowProps<T> {
     large: boolean;
     /** Phone selection (0.40, keksdose live #421); null without DataTable's `selection`. */
     select: MobileRowSelect | null;
+    /** The card's place in the list, on its `<li>` — where the table finds the card that
+     *  takes the focus when a focused one leaves (refactor audit 2026-10-30, DSP-4). */
+    rowIndex?: number;
+    /** The focus came into the card, or into anything it opened (a portal included). */
+    onFocusIn?: () => void;
 }
 /** A phone card's part in DataTable's `selection` (0.40, keksdose live #421). */
 export interface MobileRowSelect {
@@ -141,7 +146,7 @@ export interface MobileRowSelect {
 }
 /** One mobile card. Shared by the flat list and the grouped list, so both draw
  *  identical row markup. */
-export declare function MobileRow<T>({ row, isExpanded, openedRowContent, opensRow, rowClassName, rowAttributes, onRowClick, rowHref, swipeActionsFor, mobileDir, mobileCardLinkable, mobileCardStretched, mobileCard, mobilePrimaryCol, mobileStatusColumns, mobileSecondaryColumns, mobileActionColumns, mobileExpandAsDialog, compact, large, select, }: MobileRowProps<T>): import("react").JSX.Element;
+export declare function MobileRow<T>({ row, isExpanded, openedRowContent, opensRow, rowClassName, rowAttributes, onRowClick, rowHref, swipeActionsFor, mobileDir, mobileCardLinkable, mobileCardStretched, mobileCard, mobilePrimaryCol, mobileStatusColumns, mobileSecondaryColumns, mobileActionColumns, mobileExpandAsDialog, compact, large, select, rowIndex, onFocusIn, }: MobileRowProps<T>): import("react").JSX.Element;
 /**
  * DataTable's `leadingRow` on a phone: the card list's first item. It was desktop-only
  * and the card list dropped it without a word — kastlan's inline "Add meter" editor
@@ -204,7 +209,7 @@ export declare function MobileSelectBar({ active, allSelected, someSelected, com
  * of that, and the exit motion, from the one place every other dialog gets it.
  */
 export declare function MobileFilters<T>({ columns, filters, selectOptionsByKey, isServer, hasFilterCallback, onSetFilter, onClearFilter, onClearAll, labels, locale, }: {
-    columns: DataTableColumn<T>[];
+    columns: readonly DataTableColumn<T>[];
     filters: FilterState;
     selectOptionsByKey: Record<string, {
         value: string;

package/dist/components/data-table-mobile.js

@@ -195,7 +195,9 @@ function MobileRow({
   mobileExpandAsDialog,
   compact,
   large,
-  select
+  select,
+  rowIndex,
+  onFocusIn
 }) {
   const expanded = isExpanded?.(row) ?? false;
   const selecting = !!select?.active;
@@ -204,12 +206,15 @@ function MobileRow({
   const expansion = expanded ? openedRowContent(row) : null;
   const tint = rowClassName?.(row);
   const interactive = !!onRowClick;
+  const rowUrl = rowHref?.(row);
+  const linkOnly = !interactive && rowUrl !== void 0;
   const opensDetail = interactive && opensRow;
   const swipeActions = swipeActionsFor?.(row);
   const swipe = swipeActions ? physicalSwipe(swipeActions, mobileDir) : null;
   const swipeEnabled = !!swipe && !selecting;
-  const stretched = mobileCardStretched && interactive && !selecting && !mobileCard && !!mobilePrimaryCol;
-  const href = mobileCardLinkable || stretched ? rowHref?.(row) : void 0;
+  const stretched = mobileCardStretched && (interactive || linkOnly) && !selecting && !mobileCard && !!mobilePrimaryCol;
+  const href = mobileCardLinkable || stretched ? rowUrl : void 0;
+  const opens = interactive || linkOnly && href !== void 0;
   const cardClass = cn(
     "w-full text-start flex items-center",
     // §4: more room per row at Large — a taller row is a bigger tap target too.
@@ -221,14 +226,14 @@ function MobileRow({
     // on every row of a long list, so anything larger becomes the list's personality
     // rather than feedback. `transition-transform` alone, so the existing background
     // flip stays instant.
-    interactive && "cursor-pointer transition-transform duration-100 active:scale-[0.995] active:bg-active motion-reduce:transition-none motion-reduce:active:scale-100",
+    opens && "cursor-pointer transition-transform duration-100 active:scale-[0.995] active:bg-active motion-reduce:transition-none motion-reduce:active:scale-100",
     // The keyboard's frame drawn INSIDE the card, as the desktop row's is (keksdose live
     // #394): the browser's own ring and tap highlight sit on the card's outer edge, and
     // three ancestors clip it — SwipeableRow's `overflow-hidden`, the card list, and
     // AppShell main's `overflow-x-clip` — so the frame went missing on one side. A press
     // keeps the fill and the squeeze above; an outline on every tap of a long list would
     // be louder than the acknowledgement it replaces.
-    (interactive || selecting) && !stretched && cn("[-webkit-tap-highlight-color:transparent] focus-visible:ring-inset", FOCUS_RING),
+    (opens || selecting) && !stretched && cn("[-webkit-tap-highlight-color:transparent] focus-visible:ring-inset", FOCUS_RING),
     // A stretched card (0.50 K4) draws the same frame, inside the card, while its TITLE
     // control has the keyboard: the ring outlines the whole tap target, as on every other
     // card, not the title's line alone. The own-click cells draw their own.
@@ -247,14 +252,15 @@ function MobileRow({
       href,
       "data-card-link": "",
       "data-row-link": "",
-      onActivate: () => onRowClick(row),
-      "aria-expanded": opensRow ? expanded : void 0,
+      navigate: linkOnly,
+      onActivate: interactive ? () => onRowClick(row) : void 0,
+      "aria-expanded": opensRow && interactive ? expanded : void 0,
       className: stretchedClass,
-      onKeyDown: (e) => {
+      onKeyDown: interactive ? (e) => {
         if (e.key !== " ") return;
         e.preventDefault();
         onRowClick(row);
-      },
+      } : void 0,
       children: title
     }
   ) : /* @__PURE__ */ jsx(
@@ -417,7 +423,7 @@ function MobileRow({
   ) : stretched ? (
     // The stretched card (0.50 K4): a plain box; its title is the control (above).
     /* @__PURE__ */ jsx("div", { ...press, "data-card-stretched": "", className: cardClass, children: cardInner })
-  ) : interactive && href ? (
+  ) : opens && href ? (
     // A card with a URL of its own is a LINK, not a div wearing role="button"
     // (feedback #451): the phone's long-press "open in new tab" and a screen
     // reader's link semantics both come free, and the fake role goes away.
@@ -426,14 +432,15 @@ function MobileRow({
       {
         href,
         ...press,
-        onActivate: () => onRowClick(row),
-        "aria-expanded": opensRow ? expanded : void 0,
+        navigate: linkOnly,
+        onActivate: interactive ? () => onRowClick(row) : void 0,
+        "aria-expanded": opensRow && interactive ? expanded : void 0,
         className: cardClass,
-        onKeyDown: (e) => {
+        onKeyDown: interactive ? (e) => {
           if (e.key !== " ") return;
           e.preventDefault();
           onRowClick(row);
-        },
+        } : void 0,
         children: cardInner
       }
     )
@@ -465,22 +472,28 @@ function MobileRow({
       }
     )
   );
-  return /* @__PURE__ */ jsxs(
-    "li",
-    {
-      className: cn(tint),
-      ...cleanAttrs(rowAttributes?.(row)),
-      "data-selected": selecting && select.selected ? "" : void 0,
-      onClickCapture: select ? (e) => {
-        if (!longPress.consumeClick()) return;
-        e.preventDefault();
-        e.stopPropagation();
-      } : void 0,
-      children: [
-        swipeEnabled ? /* @__PURE__ */ jsx(SwipeableRow, { enabled: true, left: swipe.left, right: swipe.right, children: body }) : body,
-        expansion && !mobileExpandAsDialog && /* @__PURE__ */ jsx("div", { className: cn("bg-surface-2 border-t border-subtle", compact ? "px-3 py-2" : "px-4 py-3"), children: expansion })
-      ]
-    }
+  return (
+    /* eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- `onFocus`
+       only notes that the focus is in this card (DSP-4); the card inside is the control. */
+    /* @__PURE__ */ jsxs(
+      "li",
+      {
+        className: cn(tint),
+        ...cleanAttrs(rowAttributes?.(row)),
+        "data-row-index": rowIndex,
+        onFocus: onFocusIn,
+        "data-selected": selecting && select.selected ? "" : void 0,
+        onClickCapture: select ? (e) => {
+          if (!longPress.consumeClick()) return;
+          e.preventDefault();
+          e.stopPropagation();
+        } : void 0,
+        children: [
+          swipeEnabled ? /* @__PURE__ */ jsx(SwipeableRow, { enabled: true, left: swipe.left, right: swipe.right, children: body }) : body,
+          expansion && !mobileExpandAsDialog && /* @__PURE__ */ jsx("div", { className: cn("bg-surface-2 border-t border-subtle", compact ? "px-3 py-2" : "px-4 py-3"), children: expansion })
+        ]
+      }
+    )
   );
 }
 function MobileLeadingRow({