@eifi1/ui-kit 0.7.1 → 0.8.1

package/dist/{data-table-filters-noy0Abvi.d.ts → data-table-filters-CF1PXqjQ.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { SortState } from './components/data-table-sort.js';
+import { SortDir, SortState, SortCycle } from './components/data-table-sort.js';
 import { SwipeAction } from './components/swipeable-row.js';
 import { DataTableLabels } from './components/data-table-labels.js';
 
@@ -28,6 +28,14 @@ interface DataTableColumn<T> {
      * see without reaching into React elements it deliberately treats as opaque.
      */
     noRowLink?: boolean;
+    /**
+     * The direction this column sorts in on its FIRST click. `"desc"` for money and
+     * count columns, where the rows worth reading are the large ones and an ascending
+     * first click opens on the zero rows (keksdose's aggregated report tables). The
+     * rest of the cycle follows from it — see {@link DataTableProps.sortCycle}.
+     * Default `"asc"`.
+     */
+    firstSort?: SortDir;
 }
 interface ServerPagination {
     page: number;
@@ -239,7 +247,69 @@ interface DataTableProps<T> {
      * "hide upcoming/scheduled" toggle).
      */
     leadingRow?: ReactNode;
+    /**
+     * Row height. `"compact"` is lenkbank's in-card tables: five `text-xs` tables with
+     * `px-2 py-1` cells sitting inside cards, which at the default padding came out at
+     * twice their height and pushed the card's own content below the fold — the whole
+     * reason they were still hand-rolled `<table>`s. It tightens the header, the cells,
+     * the selection checkboxes, the pager and the phone cards together, so a compact
+     * table is compact everywhere rather than a dense body under a roomy header.
+     *
+     * Defaults to `"comfortable"`, which is the table every caller has today.
+     */
+    density?: DataTableDensity;
+    /**
+     * What a repeated click on a sorted header does. `"tri"` (the default, and the only
+     * behaviour before 0.8.0): first direction → the other → unsorted. `"toggle"`: first
+     * direction ⇄ the other, never unsorted — for a report table that is always ranked
+     * by something. Each column's first direction is its own `firstSort`. `aria-sort`
+     * and the spoken "Sorted by …" follow whatever the click produced, so they are
+     * right under either cycle.
+     */
+    sortCycle?: SortCycle;
+    /**
+     * The desktop table's power-user chrome, as one switch. `"full"` (default) is the
+     * table as it has always been. `"minimal"` is a compact report table in a half-width
+     * card: no column-settings rail, no resize handles, no multi-sort (and so no
+     * "Shift-click to add a sort" tooltip) — the three pieces that cost width and
+     * attention and that a ten-row summary never needs. Each can still be set on its
+     * own below; an explicit boolean wins over the preset.
+     */
+    chrome?: DataTableChrome;
+    /**
+     * The vertical "Columns (n/m)" rail and its show/hide + auto-size panel. Default:
+     * on, unless `chrome="minimal"`. With it off, every column is shown and a hidden
+     * set persisted under `storageKey` is ignored — there would be no way to get a
+     * column back.
+     */
+    columnSettings?: boolean;
+    /**
+     * The drag handles on the header's trailing edges. Default: on, unless
+     * `chrome="minimal"`. With it off, widths persisted under `storageKey` are ignored
+     * for the same reason as above: nothing could reset them.
+     */
+    resizable?: boolean;
+    /**
+     * Shift-click adds a secondary sort criterion. Default: on, unless
+     * `chrome="minimal"`. With it off, a shift-click sorts like a plain click and the
+     * header drops the tooltip that advertises the gesture.
+     */
+    multiSort?: boolean;
+    /**
+     * The card around the table — border, surface, radius, shadow. Set false to sit the
+     * table inside the app's own card, under its own caption and CSV button, without a
+     * frame inside a frame. The table's layout is unchanged; only the chrome goes.
+     * Default true.
+     */
+    frame?: boolean;
+    /** Extra classes for the table's root element (the card, or with `frame={false}`
+     *  the plain wrapper). Merged last, so a caller's margin or width wins. */
+    className?: string;
 }
+/** See {@link DataTableProps.chrome}. */
+type DataTableChrome = "full" | "minimal";
+/** See {@link DataTableProps.density}. */
+type DataTableDensity = "comfortable" | "compact";
 type FilterState = Record<string, FilterValue>;
 
 /** What {@link DataTableProps.mobileSwipeActions} returns for one row. */
@@ -253,7 +323,7 @@ interface MobileSwipeActions {
     /** Committed by dragging physically RIGHT, whatever the direction. */
     right?: SwipeAction[];
 }
-declare function DataTable<T>({ rows, columns, rowKey, defaultPageSize, onRowClick, rowHref, expandedRow, isExpanded, rowClassName, rowAttributes, paginated, empty, storageKey, urlSync, fillHeight, maxBodyHeight, serverPagination, filters: filtersProp, onFiltersChange, sorts: sortsProp, onSortsChange, selection, labels: labelsProp, locale: localeProp, storageKeyPrefix, mobileExpandAsDialog, mobileGroupBy, mobileGroupLabel, mobileCard, mobileSwipeActions, leadingRow, }: DataTableProps<T>): react.JSX.Element;
+declare function DataTable<T>({ rows, columns, rowKey, defaultPageSize, onRowClick, rowHref, expandedRow, isExpanded, rowClassName, rowAttributes, paginated, empty, storageKey, urlSync, fillHeight, maxBodyHeight, serverPagination, filters: filtersProp, onFiltersChange, sorts: sortsProp, onSortsChange, selection, labels: labelsProp, locale: localeProp, storageKeyPrefix, mobileExpandAsDialog, mobileGroupBy, mobileGroupLabel, mobileCard, mobileSwipeActions, leadingRow, density, sortCycle, chrome, columnSettings: columnSettingsProp, resizable: resizableProp, multiSort: multiSortProp, frame, className, }: DataTableProps<T>): react.JSX.Element;
 
 /** How a column is filtered. `text`/`select`/`date`/`number` each read a value
  *  off the row and compare it against the user's {@link FilterValue}. */
@@ -313,4 +383,4 @@ declare function decodeFilterValueOfType(type: FilterValue["type"], raw: string)
 /** Inverse of {@link encodeFilterValue}, typed by the column's filter config. */
 declare function decodeFilterValue<T>(filter: ColumnFilter<T>, raw: string): FilterValue;
 
-export { type ColumnFilter as C, DataTable as D, type FilterState as F, type MobileSwipeActions as M, type ServerPagination as S, type DataTableColumn as a, type DataTableProps as b, type FilterValue as c, decodeFilterValue as d, decodeFilterValueOfType as e, defaultFilterState as f, encodeFilterValue as g, rowMatches as h, isFilterActive as i, resolveFilter as r };
+export { type ColumnFilter as C, DataTable as D, type FilterState as F, type MobileSwipeActions as M, type ServerPagination as S, type DataTableChrome as a, type DataTableColumn as b, type DataTableDensity as c, type DataTableProps as d, type FilterValue as e, decodeFilterValue as f, decodeFilterValueOfType as g, defaultFilterState as h, encodeFilterValue as i, isFilterActive as j, rowMatches as k, resolveFilter as r };

package/dist/data-table.d.ts

@@ -1,6 +1,6 @@
 export { DEFAULT_DATA_TABLE_LABELS, DataTableLabels, missingDataTableLabels, resolveDataTableLabels } from './components/data-table-labels.js';
-export { SortDir, SortState, decodeSorts, encodeSorts, nextSorts, normalizeSorts } from './components/data-table-sort.js';
-export { C as ColumnFilter, D as DataTable, a as DataTableColumn, b as DataTableProps, F as FilterState, c as FilterValue, M as MobileSwipeActions, S as ServerPagination, d as decodeFilterValue, e as decodeFilterValueOfType, f as defaultFilterState, g as encodeFilterValue, i as isFilterActive, r as resolveFilter, h as rowMatches } from './data-table-filters-noy0Abvi.js';
+export { SortCycle, SortDir, SortState, SortStepOptions, decodeSorts, encodeSorts, nextSorts, normalizeSorts } from './components/data-table-sort.js';
+export { C as ColumnFilter, D as DataTable, a as DataTableChrome, b as DataTableColumn, c as DataTableDensity, d as DataTableProps, F as FilterState, e as FilterValue, M as MobileSwipeActions, S as ServerPagination, f as decodeFilterValue, g as decodeFilterValueOfType, h as defaultFilterState, i as encodeFilterValue, j as isFilterActive, r as resolveFilter, k as rowMatches } from './data-table-filters-CF1PXqjQ.js';
 export { PAGE_SIZE_OPTIONS, Pagination } from './components/data-table-pagination.js';
 export { FilterPopover } from './components/data-table-filter-popover.js';
 import 'react';

package/dist/data-table.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/data-table.ts"],"sourcesContent":["// `@eifi1/ui-kit/data-table` — the table suite.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: DataTable calls useSearchParams unconditionally, above any `urlSync`\n// branch, so a Router is needed even with URL sync switched off.\nexport * from \"./components/data-table-labels\";\nexport * from \"./components/data-table-sort\";\nexport * from \"./components/data-table-filters\";\nexport * from \"./components/data-table-pagination\";\nexport { FilterPopover } from \"./components/data-table-filter-popover\";\n// `SortState` comes from data-table-sort above; re-exporting the module wholesale\n// would collide with it, which is why the main barrel names these explicitly too.\nexport { DataTable } from \"./components/data-table\";\nexport type {\n  DataTableColumn,\n  DataTableProps,\n  ServerPagination,\n  FilterState,\n  MobileSwipeActions,\n} from \"./components/data-table\";\n"],"mappings":";AAKA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,qBAAqB;AAG9B,SAAS,iBAAiB;","names":[]}
+{"version":3,"sources":["../src/data-table.ts"],"sourcesContent":["// `@eifi1/ui-kit/data-table` — the table suite.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: DataTable calls useSearchParams unconditionally, above any `urlSync`\n// branch, so a Router is needed even with URL sync switched off.\nexport * from \"./components/data-table-labels\";\nexport * from \"./components/data-table-sort\";\nexport * from \"./components/data-table-filters\";\nexport * from \"./components/data-table-pagination\";\nexport { FilterPopover } from \"./components/data-table-filter-popover\";\n// `SortState` comes from data-table-sort above; re-exporting the module wholesale\n// would collide with it, which is why the main barrel names these explicitly too.\nexport { DataTable } from \"./components/data-table\";\nexport type {\n  DataTableColumn,\n  DataTableProps,\n  ServerPagination,\n  FilterState,\n  MobileSwipeActions,\n  DataTableDensity,\n  DataTableChrome,\n} from \"./components/data-table\";\n"],"mappings":";AAKA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,SAAS,qBAAqB;AAG9B,SAAS,iBAAiB;","names":[]}

package/dist/hooks/use-copy-to-clipboard.d.ts

@@ -0,0 +1,28 @@
+type CopyState = "idle" | "copied" | "failed";
+interface UseCopyToClipboardOptions {
+    /** How long `copied` / `failed` stays up before the state returns to `idle`, in
+     *  ms. `0` keeps it until the next copy or {@link UseCopyToClipboardReturn.reset}. */
+    resetAfter?: number;
+}
+interface UseCopyToClipboardReturn {
+    state: CopyState;
+    /** Copy `text`. Resolves to whether it actually reached the clipboard — the same
+     *  answer `state` gives, for a caller that wants to act on it directly. */
+    copy: (text: string) => Promise<boolean>;
+    reset: () => void;
+}
+/** Copy `text`, by the Clipboard API when there is one and the legacy path when
+ *  there is not — or when the API refuses (a denied permission, a document that is
+ *  not focused). Never throws. */
+declare function copyToClipboard(text: string): Promise<boolean>;
+/**
+ * Copy text and KNOW whether it worked.
+ *
+ * keksdose had two copy buttons that flipped to "Copied" on click and never looked at
+ * the promise — so on the http LAN build, where there is no Clipboard API, they
+ * confirmed a copy that had not happened. The state here is set from the result, and
+ * a failure is a state of its own rather than a quiet return to idle.
+ */
+declare function useCopyToClipboard({ resetAfter }?: UseCopyToClipboardOptions): UseCopyToClipboardReturn;
+
+export { type CopyState, type UseCopyToClipboardOptions, type UseCopyToClipboardReturn, copyToClipboard, useCopyToClipboard };

package/dist/hooks/use-copy-to-clipboard.js

@@ -0,0 +1,81 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+function legacyCopy(text) {
+  if (typeof document === "undefined" || typeof document.execCommand !== "function") return false;
+  const active = document.activeElement;
+  const selection = document.getSelection();
+  const ranges = [];
+  if (selection) for (let i = 0; i < selection.rangeCount; i++) ranges.push(selection.getRangeAt(i));
+  const area = document.createElement("textarea");
+  area.value = text;
+  area.setAttribute("readonly", "");
+  area.style.position = "fixed";
+  area.style.top = "0";
+  area.style.insetInlineStart = "-9999px";
+  area.style.opacity = "0";
+  document.body.appendChild(area);
+  area.select();
+  let ok = false;
+  try {
+    ok = document.execCommand("copy");
+  } catch {
+    ok = false;
+  }
+  area.remove();
+  if (selection) {
+    selection.removeAllRanges();
+    for (const r of ranges) selection.addRange(r);
+  }
+  active?.focus?.();
+  return ok;
+}
+async function copyToClipboard(text) {
+  const clipboard = typeof navigator !== "undefined" ? navigator.clipboard : void 0;
+  if (clipboard && typeof clipboard.writeText === "function") {
+    try {
+      await clipboard.writeText(text);
+      return true;
+    } catch {
+    }
+  }
+  return legacyCopy(text);
+}
+function useCopyToClipboard({ resetAfter = 2e3 } = {}) {
+  const [state, setState] = useState("idle");
+  const timer = useRef(null);
+  const mounted = useRef(true);
+  useEffect(() => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+      if (timer.current) clearTimeout(timer.current);
+    };
+  }, []);
+  const reset = useCallback(() => {
+    if (timer.current) clearTimeout(timer.current);
+    timer.current = null;
+    setState("idle");
+  }, []);
+  const copy = useCallback(
+    async (text) => {
+      if (timer.current) clearTimeout(timer.current);
+      const ok = await copyToClipboard(text);
+      if (!mounted.current) return ok;
+      setState(ok ? "copied" : "failed");
+      if (resetAfter > 0) {
+        timer.current = setTimeout(() => {
+          timer.current = null;
+          setState("idle");
+        }, resetAfter);
+      }
+      return ok;
+    },
+    [resetAfter]
+  );
+  return { state, copy, reset };
+}
+export {
+  copyToClipboard,
+  useCopyToClipboard
+};
+//# sourceMappingURL=use-copy-to-clipboard.js.map

package/dist/hooks/use-copy-to-clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-copy-to-clipboard.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport type CopyState = \"idle\" | \"copied\" | \"failed\";\n\nexport interface UseCopyToClipboardOptions {\n  /** How long `copied` / `failed` stays up before the state returns to `idle`, in\n   *  ms. `0` keeps it until the next copy or {@link UseCopyToClipboardReturn.reset}. */\n  resetAfter?: number;\n}\n\nexport interface UseCopyToClipboardReturn {\n  state: CopyState;\n  /** Copy `text`. Resolves to whether it actually reached the clipboard — the same\n   *  answer `state` gives, for a caller that wants to act on it directly. */\n  copy: (text: string) => Promise<boolean>;\n  reset: () => void;\n}\n\n/**\n * The legacy path: select a throwaway `<textarea>` and ask the document to copy it.\n *\n * `navigator.clipboard` exists only in a secure context, so an app opened over plain\n * http on a LAN address (how keksdose is tested on a phone) has no Clipboard API at\n * all. `execCommand(\"copy\")` is deprecated but still implemented everywhere, and it\n * answers with a boolean, which is all this needs. Focus and the user's selection are\n * put back afterwards: copying must not move the keyboard.\n */\nfunction legacyCopy(text: string): boolean {\n  if (typeof document === \"undefined\" || typeof document.execCommand !== \"function\") return false;\n  const active = document.activeElement as HTMLElement | null;\n  const selection = document.getSelection();\n  const ranges: Range[] = [];\n  if (selection) for (let i = 0; i < selection.rangeCount; i++) ranges.push(selection.getRangeAt(i));\n\n  const area = document.createElement(\"textarea\");\n  area.value = text;\n  area.setAttribute(\"readonly\", \"\");\n  // Off-screen but rendered: a `display: none` textarea cannot be selected.\n  area.style.position = \"fixed\";\n  area.style.top = \"0\";\n  area.style.insetInlineStart = \"-9999px\";\n  area.style.opacity = \"0\";\n  document.body.appendChild(area);\n  area.select();\n  let ok = false;\n  try {\n    ok = document.execCommand(\"copy\");\n  } catch {\n    ok = false;\n  }\n  area.remove();\n  if (selection) {\n    selection.removeAllRanges();\n    for (const r of ranges) selection.addRange(r);\n  }\n  active?.focus?.();\n  return ok;\n}\n\n/** Copy `text`, by the Clipboard API when there is one and the legacy path when\n *  there is not — or when the API refuses (a denied permission, a document that is\n *  not focused). Never throws. */\nexport async function copyToClipboard(text: string): Promise<boolean> {\n  const clipboard = typeof navigator !== \"undefined\" ? navigator.clipboard : undefined;\n  if (clipboard && typeof clipboard.writeText === \"function\") {\n    try {\n      await clipboard.writeText(text);\n      return true;\n    } catch {\n      // Fall through: the API exists but refused. The legacy path sometimes succeeds\n      // where the permission prompt was dismissed.\n    }\n  }\n  return legacyCopy(text);\n}\n\n/**\n * Copy text and KNOW whether it worked.\n *\n * keksdose had two copy buttons that flipped to \"Copied\" on click and never looked at\n * the promise — so on the http LAN build, where there is no Clipboard API, they\n * confirmed a copy that had not happened. The state here is set from the result, and\n * a failure is a state of its own rather than a quiet return to idle.\n */\nexport function useCopyToClipboard({ resetAfter = 2000 }: UseCopyToClipboardOptions = {}): UseCopyToClipboardReturn {\n  const [state, setState] = useState<CopyState>(\"idle\");\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const mounted = useRef(true);\n\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n      if (timer.current) clearTimeout(timer.current);\n    };\n  }, []);\n\n  const reset = useCallback(() => {\n    if (timer.current) clearTimeout(timer.current);\n    timer.current = null;\n    setState(\"idle\");\n  }, []);\n\n  const copy = useCallback(\n    async (text: string) => {\n      if (timer.current) clearTimeout(timer.current);\n      const ok = await copyToClipboard(text);\n      if (!mounted.current) return ok;\n      setState(ok ? \"copied\" : \"failed\");\n      if (resetAfter > 0) {\n        timer.current = setTimeout(() => {\n          timer.current = null;\n          setState(\"idle\");\n        }, resetAfter);\n      }\n      return ok;\n    },\n    [resetAfter],\n  );\n\n  return { state, copy, reset };\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AA2BzD,SAAS,WAAW,MAAuB;AACzC,MAAI,OAAO,aAAa,eAAe,OAAO,SAAS,gBAAgB,WAAY,QAAO;AAC1F,QAAM,SAAS,SAAS;AACxB,QAAM,YAAY,SAAS,aAAa;AACxC,QAAM,SAAkB,CAAC;AACzB,MAAI,UAAW,UAAS,IAAI,GAAG,IAAI,UAAU,YAAY,IAAK,QAAO,KAAK,UAAU,WAAW,CAAC,CAAC;AAEjG,QAAM,OAAO,SAAS,cAAc,UAAU;AAC9C,OAAK,QAAQ;AACb,OAAK,aAAa,YAAY,EAAE;AAEhC,OAAK,MAAM,WAAW;AACtB,OAAK,MAAM,MAAM;AACjB,OAAK,MAAM,mBAAmB;AAC9B,OAAK,MAAM,UAAU;AACrB,WAAS,KAAK,YAAY,IAAI;AAC9B,OAAK,OAAO;AACZ,MAAI,KAAK;AACT,MAAI;AACF,SAAK,SAAS,YAAY,MAAM;AAAA,EAClC,QAAQ;AACN,SAAK;AAAA,EACP;AACA,OAAK,OAAO;AACZ,MAAI,WAAW;AACb,cAAU,gBAAgB;AAC1B,eAAW,KAAK,OAAQ,WAAU,SAAS,CAAC;AAAA,EAC9C;AACA,UAAQ,QAAQ;AAChB,SAAO;AACT;AAKA,eAAsB,gBAAgB,MAAgC;AACpE,QAAM,YAAY,OAAO,cAAc,cAAc,UAAU,YAAY;AAC3E,MAAI,aAAa,OAAO,UAAU,cAAc,YAAY;AAC1D,QAAI;AACF,YAAM,UAAU,UAAU,IAAI;AAC9B,aAAO;AAAA,IACT,QAAQ;AAAA,IAGR;AAAA,EACF;AACA,SAAO,WAAW,IAAI;AACxB;AAUO,SAAS,mBAAmB,EAAE,aAAa,IAAK,IAA+B,CAAC,GAA6B;AAClH,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAoB,MAAM;AACpD,QAAM,QAAQ,OAA6C,IAAI;AAC/D,QAAM,UAAU,OAAO,IAAI;AAE3B,YAAU,MAAM;AACd,YAAQ,UAAU;AAClB,WAAO,MAAM;AACX,cAAQ,UAAU;AAClB,UAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAAA,IAC/C;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,QAAM,QAAQ,YAAY,MAAM;AAC9B,QAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,UAAM,UAAU;AAChB,aAAS,MAAM;AAAA,EACjB,GAAG,CAAC,CAAC;AAEL,QAAM,OAAO;AAAA,IACX,OAAO,SAAiB;AACtB,UAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,YAAM,KAAK,MAAM,gBAAgB,IAAI;AACrC,UAAI,CAAC,QAAQ,QAAS,QAAO;AAC7B,eAAS,KAAK,WAAW,QAAQ;AACjC,UAAI,aAAa,GAAG;AAClB,cAAM,UAAU,WAAW,MAAM;AAC/B,gBAAM,UAAU;AAChB,mBAAS,MAAM;AAAA,QACjB,GAAG,UAAU;AAAA,MACf;AACA,aAAO;AAAA,IACT;AAAA,IACA,CAAC,UAAU;AAAA,EACb;AAEA,SAAO,EAAE,OAAO,MAAM,MAAM;AAC9B;","names":[]}

package/dist/hooks/use-debounce.d.ts

@@ -0,0 +1,43 @@
+/**
+ * A value that follows `value`, but only once it has stopped changing for `ms`.
+ *
+ * kastlan asked for the pair in this module because each of its search boxes carried
+ * its own copy of the same six lines — a `useEffect` with a `setTimeout` — and two of
+ * them forgot the cleanup, so a stale query landed AFTER the fresh one and replaced
+ * its results. The cleanup is the whole point of having one implementation.
+ *
+ * The first render returns `value` itself, not `undefined`: a list filtered by the
+ * debounced query must render its initial state immediately, not after `ms`.
+ */
+declare function useDebounce<T>(value: T, ms: number): T;
+interface DebouncedCallbackOptions {
+    /**
+     * The longest a call may be held back, however often it is re-triggered. Without
+     * it a user who never stops typing never saves; with it, a draft autosave still
+     * lands every `maxWait` ms while the typing goes on.
+     */
+    maxWait?: number;
+}
+/** The debounced function, plus the two escapes a caller needs around it. */
+type DebouncedFunction<A extends unknown[]> = ((...args: A) => void) & {
+    /** Drop the pending call, if there is one. */
+    cancel: () => void;
+    /** Run the pending call now, if there is one — e.g. on blur or before navigating
+     *  away, so the last keystrokes of a form are not lost. */
+    flush: () => void;
+    /** Whether a call is waiting. */
+    pending: () => boolean;
+};
+/**
+ * `fn`, called only once calls have stopped arriving for `ms` — with the arguments
+ * of the LAST call.
+ *
+ * The returned function keeps its identity across renders (so it can sit in an
+ * effect's dependency list or be handed to a memoised child) and always calls the
+ * LATEST `fn`, so a handler that closes over current state never runs a stale copy.
+ * A pending call is cancelled on unmount: a debounced save firing into an unmounted
+ * form is the bug kastlan reported, not a feature.
+ */
+declare function useDebouncedCallback<A extends unknown[]>(fn: (...args: A) => void, ms: number, { maxWait }?: DebouncedCallbackOptions): DebouncedFunction<A>;
+
+export { type DebouncedCallbackOptions, type DebouncedFunction, useDebounce, useDebouncedCallback };

package/dist/hooks/use-debounce.js

@@ -0,0 +1,56 @@
+"use client";
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+function useDebounce(value, ms) {
+  const [debounced, setDebounced] = useState(value);
+  useEffect(() => {
+    const timer = setTimeout(() => setDebounced(value), ms);
+    return () => clearTimeout(timer);
+  }, [value, ms]);
+  return debounced;
+}
+function useDebouncedCallback(fn, ms, { maxWait } = {}) {
+  const fnRef = useRef(fn);
+  useLayoutEffect(() => {
+    fnRef.current = fn;
+  });
+  const timer = useRef(null);
+  const maxTimer = useRef(null);
+  const lastArgs = useRef(null);
+  const clear = useCallback(() => {
+    if (timer.current) clearTimeout(timer.current);
+    if (maxTimer.current) clearTimeout(maxTimer.current);
+    timer.current = null;
+    maxTimer.current = null;
+  }, []);
+  const invoke = useCallback(() => {
+    const args = lastArgs.current;
+    clear();
+    lastArgs.current = null;
+    if (args) fnRef.current(...args);
+  }, [clear]);
+  useEffect(() => clear, [clear]);
+  return useMemo(() => {
+    const debounced = ((...args) => {
+      lastArgs.current = args;
+      if (timer.current) clearTimeout(timer.current);
+      timer.current = setTimeout(invoke, ms);
+      if (maxWait !== void 0 && !maxTimer.current) {
+        maxTimer.current = setTimeout(invoke, maxWait);
+      }
+    });
+    debounced.cancel = () => {
+      clear();
+      lastArgs.current = null;
+    };
+    debounced.flush = () => {
+      if (lastArgs.current) invoke();
+    };
+    debounced.pending = () => lastArgs.current !== null;
+    return debounced;
+  }, [ms, maxWait, invoke, clear]);
+}
+export {
+  useDebounce,
+  useDebouncedCallback
+};
+//# sourceMappingURL=use-debounce.js.map

package/dist/hooks/use-debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-debounce.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\";\n\n/**\n * A value that follows `value`, but only once it has stopped changing for `ms`.\n *\n * kastlan asked for the pair in this module because each of its search boxes carried\n * its own copy of the same six lines — a `useEffect` with a `setTimeout` — and two of\n * them forgot the cleanup, so a stale query landed AFTER the fresh one and replaced\n * its results. The cleanup is the whole point of having one implementation.\n *\n * The first render returns `value` itself, not `undefined`: a list filtered by the\n * debounced query must render its initial state immediately, not after `ms`.\n */\nexport function useDebounce<T>(value: T, ms: number): T {\n  const [debounced, setDebounced] = useState(value);\n  useEffect(() => {\n    const timer = setTimeout(() => setDebounced(value), ms);\n    return () => clearTimeout(timer);\n  }, [value, ms]);\n  return debounced;\n}\n\nexport interface DebouncedCallbackOptions {\n  /**\n   * The longest a call may be held back, however often it is re-triggered. Without\n   * it a user who never stops typing never saves; with it, a draft autosave still\n   * lands every `maxWait` ms while the typing goes on.\n   */\n  maxWait?: number;\n}\n\n/** The debounced function, plus the two escapes a caller needs around it. */\nexport type DebouncedFunction<A extends unknown[]> = ((...args: A) => void) & {\n  /** Drop the pending call, if there is one. */\n  cancel: () => void;\n  /** Run the pending call now, if there is one — e.g. on blur or before navigating\n   *  away, so the last keystrokes of a form are not lost. */\n  flush: () => void;\n  /** Whether a call is waiting. */\n  pending: () => boolean;\n};\n\n/**\n * `fn`, called only once calls have stopped arriving for `ms` — with the arguments\n * of the LAST call.\n *\n * The returned function keeps its identity across renders (so it can sit in an\n * effect's dependency list or be handed to a memoised child) and always calls the\n * LATEST `fn`, so a handler that closes over current state never runs a stale copy.\n * A pending call is cancelled on unmount: a debounced save firing into an unmounted\n * form is the bug kastlan reported, not a feature.\n */\nexport function useDebouncedCallback<A extends unknown[]>(\n  fn: (...args: A) => void,\n  ms: number,\n  { maxWait }: DebouncedCallbackOptions = {},\n): DebouncedFunction<A> {\n  const fnRef = useRef(fn);\n  // Layout effect, not render-time assignment: a ref written during render is a\n  // side effect React may replay or discard. Nothing can call the debounced function\n  // between this commit and the layout effect, so it is never one render behind.\n  useLayoutEffect(() => {\n    fnRef.current = fn;\n  });\n\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const maxTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const lastArgs = useRef<A | null>(null);\n\n  const clear = useCallback(() => {\n    if (timer.current) clearTimeout(timer.current);\n    if (maxTimer.current) clearTimeout(maxTimer.current);\n    timer.current = null;\n    maxTimer.current = null;\n  }, []);\n\n  const invoke = useCallback(() => {\n    const args = lastArgs.current;\n    clear();\n    lastArgs.current = null;\n    if (args) fnRef.current(...args);\n  }, [clear]);\n\n  useEffect(() => clear, [clear]);\n\n  return useMemo(() => {\n    const debounced = ((...args: A) => {\n      lastArgs.current = args;\n      if (timer.current) clearTimeout(timer.current);\n      timer.current = setTimeout(invoke, ms);\n      if (maxWait !== undefined && !maxTimer.current) {\n        maxTimer.current = setTimeout(invoke, maxWait);\n      }\n    }) as DebouncedFunction<A>;\n    debounced.cancel = () => {\n      clear();\n      lastArgs.current = null;\n    };\n    debounced.flush = () => {\n      if (lastArgs.current) invoke();\n    };\n    debounced.pending = () => lastArgs.current !== null;\n    return debounced;\n  }, [ms, maxWait, invoke, clear]);\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,iBAAiB,SAAS,QAAQ,gBAAgB;AAa5E,SAAS,YAAe,OAAU,IAAe;AACtD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,KAAK;AAChD,YAAU,MAAM;AACd,UAAM,QAAQ,WAAW,MAAM,aAAa,KAAK,GAAG,EAAE;AACtD,WAAO,MAAM,aAAa,KAAK;AAAA,EACjC,GAAG,CAAC,OAAO,EAAE,CAAC;AACd,SAAO;AACT;AAgCO,SAAS,qBACd,IACA,IACA,EAAE,QAAQ,IAA8B,CAAC,GACnB;AACtB,QAAM,QAAQ,OAAO,EAAE;AAIvB,kBAAgB,MAAM;AACpB,UAAM,UAAU;AAAA,EAClB,CAAC;AAED,QAAM,QAAQ,OAA6C,IAAI;AAC/D,QAAM,WAAW,OAA6C,IAAI;AAClE,QAAM,WAAW,OAAiB,IAAI;AAEtC,QAAM,QAAQ,YAAY,MAAM;AAC9B,QAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,QAAI,SAAS,QAAS,cAAa,SAAS,OAAO;AACnD,UAAM,UAAU;AAChB,aAAS,UAAU;AAAA,EACrB,GAAG,CAAC,CAAC;AAEL,QAAM,SAAS,YAAY,MAAM;AAC/B,UAAM,OAAO,SAAS;AACtB,UAAM;AACN,aAAS,UAAU;AACnB,QAAI,KAAM,OAAM,QAAQ,GAAG,IAAI;AAAA,EACjC,GAAG,CAAC,KAAK,CAAC;AAEV,YAAU,MAAM,OAAO,CAAC,KAAK,CAAC;AAE9B,SAAO,QAAQ,MAAM;AACnB,UAAM,aAAa,IAAI,SAAY;AACjC,eAAS,UAAU;AACnB,UAAI,MAAM,QAAS,cAAa,MAAM,OAAO;AAC7C,YAAM,UAAU,WAAW,QAAQ,EAAE;AACrC,UAAI,YAAY,UAAa,CAAC,SAAS,SAAS;AAC9C,iBAAS,UAAU,WAAW,QAAQ,OAAO;AAAA,MAC/C;AAAA,IACF;AACA,cAAU,SAAS,MAAM;AACvB,YAAM;AACN,eAAS,UAAU;AAAA,IACrB;AACA,cAAU,QAAQ,MAAM;AACtB,UAAI,SAAS,QAAS,QAAO;AAAA,IAC/B;AACA,cAAU,UAAU,MAAM,SAAS,YAAY;AAC/C,WAAO;AAAA,EACT,GAAG,CAAC,IAAI,SAAS,QAAQ,KAAK,CAAC;AACjC;","names":[]}

package/dist/hooks/use-file-drop.d.ts

@@ -0,0 +1,72 @@
+import { DragEvent, ReactElement } from 'react';
+import { UseFilePickerOptions } from '../components/file-button.js';
+import '../components/ui.js';
+import '../components/tooltip.js';
+import './use-anchored-rect.js';
+
+/**
+ * Turn ANY element into a file drop target — kastlan's ask, for the document list of
+ * a booking and the rows of its gantt, which are drop targets without being a
+ * `FileDropzone` (a dashed box with a Browse button inside would be the wrong thing
+ * to draw over a list).
+ *
+ * ```tsx
+ * const { dropProps, isOver, element } = useFileDrop({ accept: ".pdf", multiple: true,
+ *   maxSize: 10_000_000, onFiles: attach, onReject: ([r]) => setError(r.message) });
+ * return <>{element}<ul {...dropProps} data-drop-over={isOver || undefined}>…</ul></>;
+ * ```
+ *
+ * The screening is `useFilePicker`'s own — `accept` re-checked (a drop ignores the
+ * dialog's filter), `maxSize`, `maxFiles`, `isValid`, `onPick` — so a file refused by
+ * `FileButton` is refused here in the same words. It comes with `open()` as well, so
+ * the same options can also back a "choose a file" menu item beside the drop target.
+ */
+/** `useFilePicker`'s options, minus `capture` (a camera does not take drops). */
+type UseFileDropOptions = Omit<UseFilePickerOptions, "capture">;
+/** Spread onto the drop target. Four handlers, nothing else: the element keeps its
+ *  own role, name and focus behaviour. */
+interface FileDropProps<E extends Element = Element> {
+    onDragEnter: (e: DragEvent<E>) => void;
+    onDragOver: (e: DragEvent<E>) => void;
+    onDragLeave: (e: DragEvent<E>) => void;
+    onDrop: (e: DragEvent<E>) => void;
+}
+interface UseFileDropReturn<E extends Element = Element> {
+    dropProps: FileDropProps<E>;
+    /** A FILE drag is over the target (and it is not `disabled`). Style from this. */
+    isOver: boolean;
+    /** Open the system picker with the same options — from a click handler only. */
+    open: () => void;
+    /** Screen and deliver files that arrived another way (a paste). */
+    take: (files: ArrayLike<File> | null | undefined) => void;
+    /** The live region that speaks a refusal (and the picker's hidden input). Render it
+     *  once, anywhere; without it a refusal reaches `onReject` but is not announced. */
+    element: ReactElement;
+}
+/** Whether a drag carries files — a dragged link, text or a row of the page does not,
+ *  and must not light the target up or be swallowed by it. */
+declare function dragHasFiles(e: DragEvent): boolean;
+/**
+ * @internal The drag half on its own, shared with `FileDropzone`.
+ *
+ * `dragenter`/`dragleave` fire for every CHILD the pointer crosses: moving from the
+ * target onto a label inside it is a leave of the target followed by an enter of the
+ * label, which bubbles. A boolean flipped by each one flickers off and on across
+ * every child, and `relatedTarget` — the usual fix — is `null` in Safari's drag
+ * events. So this counts: +1 per enter, -1 per leave, over while above zero, and a
+ * drop resets it (the drop replaces the leave that would have balanced the enter).
+ *
+ * A file drag stops propagating here, so a target nested in another (a row inside a
+ * page-wide drop area) takes its own drop, and the outer one's count falls back to
+ * zero while the pointer is over the inner one — only one of them lights up.
+ */
+declare function useDragTarget<E extends Element = Element>({ disabled, onDropFiles, }: {
+    disabled?: boolean;
+    onDropFiles: (files: FileList | File[]) => void;
+}): {
+    dropProps: FileDropProps<E>;
+    isOver: boolean;
+};
+declare function useFileDrop<E extends Element = Element>(options: UseFileDropOptions): UseFileDropReturn<E>;
+
+export { type FileDropProps, type UseFileDropOptions, type UseFileDropReturn, dragHasFiles, useDragTarget, useFileDrop };

package/dist/hooks/use-file-drop.js

@@ -0,0 +1,57 @@
+"use client";
+import { useRef, useState } from "react";
+import { useFilePicker } from "../components/file-button.js";
+function dragHasFiles(e) {
+  return Array.from(e.dataTransfer?.types ?? []).includes("Files");
+}
+function useDragTarget({
+  disabled,
+  onDropFiles
+}) {
+  const depth = useRef(0);
+  const [over, setOver] = useState(false);
+  const dropProps = {
+    onDragEnter: (e) => {
+      if (!dragHasFiles(e)) return;
+      e.stopPropagation();
+      e.preventDefault();
+      depth.current += 1;
+      if (!disabled) setOver(true);
+    },
+    onDragOver: (e) => {
+      if (!dragHasFiles(e)) return;
+      e.stopPropagation();
+      e.preventDefault();
+      e.dataTransfer.dropEffect = disabled ? "none" : "copy";
+    },
+    onDragLeave: (e) => {
+      if (!dragHasFiles(e)) return;
+      e.stopPropagation();
+      depth.current = Math.max(0, depth.current - 1);
+      if (depth.current === 0) setOver(false);
+    },
+    onDrop: (e) => {
+      if (!dragHasFiles(e)) return;
+      e.stopPropagation();
+      e.preventDefault();
+      depth.current = 0;
+      setOver(false);
+      if (!disabled) onDropFiles(e.dataTransfer.files);
+    }
+  };
+  return { dropProps, isOver: over && !disabled };
+}
+function useFileDrop(options) {
+  const picker = useFilePicker(options);
+  const { dropProps, isOver } = useDragTarget({
+    disabled: options.disabled,
+    onDropFiles: picker.take
+  });
+  return { dropProps, isOver, open: picker.open, take: picker.take, element: picker.element };
+}
+export {
+  dragHasFiles,
+  useDragTarget,
+  useFileDrop
+};
+//# sourceMappingURL=use-file-drop.js.map

package/dist/hooks/use-file-drop.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-file-drop.ts"],"sourcesContent":["import { useRef, useState } from \"react\";\nimport type { DragEvent, ReactElement } from \"react\";\nimport { useFilePicker } from \"../components/file-button\";\nimport type { UseFilePickerOptions } from \"../components/file-button\";\n\n/**\n * Turn ANY element into a file drop target — kastlan's ask, for the document list of\n * a booking and the rows of its gantt, which are drop targets without being a\n * `FileDropzone` (a dashed box with a Browse button inside would be the wrong thing\n * to draw over a list).\n *\n * ```tsx\n * const { dropProps, isOver, element } = useFileDrop({ accept: \".pdf\", multiple: true,\n *   maxSize: 10_000_000, onFiles: attach, onReject: ([r]) => setError(r.message) });\n * return <>{element}<ul {...dropProps} data-drop-over={isOver || undefined}>…</ul></>;\n * ```\n *\n * The screening is `useFilePicker`'s own — `accept` re-checked (a drop ignores the\n * dialog's filter), `maxSize`, `maxFiles`, `isValid`, `onPick` — so a file refused by\n * `FileButton` is refused here in the same words. It comes with `open()` as well, so\n * the same options can also back a \"choose a file\" menu item beside the drop target.\n */\n\n/** `useFilePicker`'s options, minus `capture` (a camera does not take drops). */\nexport type UseFileDropOptions = Omit<UseFilePickerOptions, \"capture\">;\n\n/** Spread onto the drop target. Four handlers, nothing else: the element keeps its\n *  own role, name and focus behaviour. */\nexport interface FileDropProps<E extends Element = Element> {\n  onDragEnter: (e: DragEvent<E>) => void;\n  onDragOver: (e: DragEvent<E>) => void;\n  onDragLeave: (e: DragEvent<E>) => void;\n  onDrop: (e: DragEvent<E>) => void;\n}\n\nexport interface UseFileDropReturn<E extends Element = Element> {\n  dropProps: FileDropProps<E>;\n  /** A FILE drag is over the target (and it is not `disabled`). Style from this. */\n  isOver: boolean;\n  /** Open the system picker with the same options — from a click handler only. */\n  open: () => void;\n  /** Screen and deliver files that arrived another way (a paste). */\n  take: (files: ArrayLike<File> | null | undefined) => void;\n  /** The live region that speaks a refusal (and the picker's hidden input). Render it\n   *  once, anywhere; without it a refusal reaches `onReject` but is not announced. */\n  element: ReactElement;\n}\n\n/** Whether a drag carries files — a dragged link, text or a row of the page does not,\n *  and must not light the target up or be swallowed by it. */\nexport function dragHasFiles(e: DragEvent): boolean {\n  return Array.from(e.dataTransfer?.types ?? []).includes(\"Files\");\n}\n\n/**\n * @internal The drag half on its own, shared with `FileDropzone`.\n *\n * `dragenter`/`dragleave` fire for every CHILD the pointer crosses: moving from the\n * target onto a label inside it is a leave of the target followed by an enter of the\n * label, which bubbles. A boolean flipped by each one flickers off and on across\n * every child, and `relatedTarget` — the usual fix — is `null` in Safari's drag\n * events. So this counts: +1 per enter, -1 per leave, over while above zero, and a\n * drop resets it (the drop replaces the leave that would have balanced the enter).\n *\n * A file drag stops propagating here, so a target nested in another (a row inside a\n * page-wide drop area) takes its own drop, and the outer one's count falls back to\n * zero while the pointer is over the inner one — only one of them lights up.\n */\nexport function useDragTarget<E extends Element = Element>({\n  disabled,\n  onDropFiles,\n}: {\n  disabled?: boolean;\n  onDropFiles: (files: FileList | File[]) => void;\n}): { dropProps: FileDropProps<E>; isOver: boolean } {\n  const depth = useRef(0);\n  const [over, setOver] = useState(false);\n\n  const dropProps: FileDropProps<E> = {\n    onDragEnter: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      e.preventDefault();\n      depth.current += 1;\n      if (!disabled) setOver(true);\n    },\n    onDragOver: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      // Always cancelled for a file drag, disabled or not: an uncancelled drop makes\n      // the browser NAVIGATE to the file, which loses the page.\n      e.preventDefault();\n      e.dataTransfer.dropEffect = disabled ? \"none\" : \"copy\";\n    },\n    onDragLeave: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      depth.current = Math.max(0, depth.current - 1);\n      if (depth.current === 0) setOver(false);\n    },\n    onDrop: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      e.preventDefault();\n      depth.current = 0;\n      setOver(false);\n      if (!disabled) onDropFiles(e.dataTransfer.files);\n    },\n  };\n\n  return { dropProps, isOver: over && !disabled };\n}\n\nexport function useFileDrop<E extends Element = Element>(\n  options: UseFileDropOptions,\n): UseFileDropReturn<E> {\n  const picker = useFilePicker(options);\n  const { dropProps, isOver } = useDragTarget<E>({\n    disabled: options.disabled,\n    onDropFiles: picker.take,\n  });\n  return { dropProps, isOver, open: picker.open, take: picker.take, element: picker.element };\n}\n"],"mappings":";AAAA,SAAS,QAAQ,gBAAgB;AAEjC,SAAS,qBAAqB;AAgDvB,SAAS,aAAa,GAAuB;AAClD,SAAO,MAAM,KAAK,EAAE,cAAc,SAAS,CAAC,CAAC,EAAE,SAAS,OAAO;AACjE;AAgBO,SAAS,cAA2C;AAAA,EACzD;AAAA,EACA;AACF,GAGqD;AACnD,QAAM,QAAQ,OAAO,CAAC;AACtB,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AAEtC,QAAM,YAA8B;AAAA,IAClC,aAAa,CAAC,MAAM;AAClB,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAClB,QAAE,eAAe;AACjB,YAAM,WAAW;AACjB,UAAI,CAAC,SAAU,SAAQ,IAAI;AAAA,IAC7B;AAAA,IACA,YAAY,CAAC,MAAM;AACjB,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAGlB,QAAE,eAAe;AACjB,QAAE,aAAa,aAAa,WAAW,SAAS;AAAA,IAClD;AAAA,IACA,aAAa,CAAC,MAAM;AAClB,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAClB,YAAM,UAAU,KAAK,IAAI,GAAG,MAAM,UAAU,CAAC;AAC7C,UAAI,MAAM,YAAY,EAAG,SAAQ,KAAK;AAAA,IACxC;AAAA,IACA,QAAQ,CAAC,MAAM;AACb,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAClB,QAAE,eAAe;AACjB,YAAM,UAAU;AAChB,cAAQ,KAAK;AACb,UAAI,CAAC,SAAU,aAAY,EAAE,aAAa,KAAK;AAAA,IACjD;AAAA,EACF;AAEA,SAAO,EAAE,WAAW,QAAQ,QAAQ,CAAC,SAAS;AAChD;AAEO,SAAS,YACd,SACsB;AACtB,QAAM,SAAS,cAAc,OAAO;AACpC,QAAM,EAAE,WAAW,OAAO,IAAI,cAAiB;AAAA,IAC7C,UAAU,QAAQ;AAAA,IAClB,aAAa,OAAO;AAAA,EACtB,CAAC;AACD,SAAO,EAAE,WAAW,QAAQ,MAAM,OAAO,MAAM,MAAM,OAAO,MAAM,SAAS,OAAO,QAAQ;AAC5F;","names":[]}

package/dist/i18n/defaults.d.ts

@@ -29,6 +29,9 @@ import '../components/file-button.js';
 import '../components/measured-grid.js';
 import '../feedback/feedback-attachment.js';
 import '../feedback/feedback-dialog.js';
+import '../components/confirm-dialog.js';
+import '../components/floating-panel.js';
+import '../components/copy-button.js';
 
 /**
  * The whole English tree in one object: what a translation is written against, and

package/dist/i18n/defaults.js

@@ -21,7 +21,10 @@ import { DEFAULT_ICON_PICKER_LABELS } from "../components/icon-picker.js";
 import { DEFAULT_DIALOG_FRAME_LABELS } from "../components/dialog-frame.js";
 import { DEFAULT_FILE_PICKER_LABELS } from "../components/file-button.js";
 import { DEFAULT_MEASURED_GRID_LABELS } from "../components/measured-grid.js";
+import { DEFAULT_CONFIRM_DIALOG_LABELS } from "../components/confirm-dialog.js";
+import { DEFAULT_FLOATING_PANEL_LABELS } from "../components/floating-panel.js";
 import { DEFAULT_FEEDBACK_ATTACHMENT_LABELS } from "../feedback/feedback-attachment.js";
+import { DEFAULT_COPY_BUTTON_LABELS } from "../components/copy-button.js";
 import {
   DEFAULT_APP_SHELL_LABELS,
   DEFAULT_CALCULATOR_LABELS,
@@ -70,7 +73,10 @@ const DEFAULT_UI_KIT_LABELS = {
   dialogFrame: DEFAULT_DIALOG_FRAME_LABELS,
   filePicker: DEFAULT_FILE_PICKER_LABELS,
   measuredGrid: DEFAULT_MEASURED_GRID_LABELS,
-  feedbackAttachment: DEFAULT_FEEDBACK_ATTACHMENT_LABELS
+  feedbackAttachment: DEFAULT_FEEDBACK_ATTACHMENT_LABELS,
+  confirmDialog: DEFAULT_CONFIRM_DIALOG_LABELS,
+  floatingPanel: DEFAULT_FLOATING_PANEL_LABELS,
+  copyButton: DEFAULT_COPY_BUTTON_LABELS
 };
 export {
   DEFAULT_UI_KIT_LABELS

package/dist/i18n/defaults.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/i18n/defaults.ts"],"sourcesContent":["import { DEFAULT_DATA_TABLE_LABELS } from \"../components/data-table-labels\";\nimport { DEFAULT_MINI_CALENDAR_LABELS } from \"../components/mini-calendar\";\nimport { DEFAULT_MONTH_PICKER_LABELS } from \"../components/month-picker\";\nimport { DEFAULT_PAGE_CONTENTS_LABELS } from \"../components/page-contents\";\nimport { DEFAULT_POPOVER_LABELS } from \"../components/popover\";\nimport { DEFAULT_CHIP_INPUT_LABELS } from \"../components/chip\";\nimport { DEFAULT_FIELD_SYNC_LABELS } from \"../components/field-sync\";\nimport { DEFAULT_PASSWORD_REVEAL_LABELS, DEFAULT_TABS_LABELS } from \"../components/ui\";\nimport { DEFAULT_WIZARD_LABELS } from \"../wizard/types\";\nimport { DEFAULT_TOUR_LABELS } from \"../tour/tour\";\nimport { DEFAULT_COMMAND_PALETTE_LABELS } from \"../search/command-palette\";\nimport { DEFAULT_SERIES_CHART_LABELS } from \"../components/series-chart-labels\";\nimport { DEFAULT_SPARKLINE_LABELS } from \"../components/sparkline\";\nimport { DEFAULT_STAT_TILE_LABELS } from \"../components/stat-tile\";\nimport { DEFAULT_SIGNATURE_PAD_LABELS } from \"../components/signature-pad\";\nimport { DEFAULT_PASSWORD_STRENGTH_LABELS } from \"../components/password-strength\";\nimport { DEFAULT_DANGER_CONFIRM_LABELS } from \"../components/danger-confirm\";\nimport { DEFAULT_SWATCH_PICKER_LABELS } from \"../components/swatch-picker\";\nimport { DEFAULT_ICON_PICKER_LABELS } from \"../components/icon-picker\";\nimport { DEFAULT_DIALOG_FRAME_LABELS } from \"../components/dialog-frame\";\nimport { DEFAULT_FILE_PICKER_LABELS } from \"../components/file-button\";\nimport { DEFAULT_MEASURED_GRID_LABELS } from \"../components/measured-grid\";\nimport { DEFAULT_FEEDBACK_ATTACHMENT_LABELS } from \"../feedback/feedback-attachment\";\nimport {\n  DEFAULT_APP_SHELL_LABELS,\n  DEFAULT_CALCULATOR_LABELS,\n  DEFAULT_COMBOBOX_LABELS,\n  DEFAULT_COMMON_LABELS,\n  DEFAULT_CURRENCY_LABELS,\n  DEFAULT_DATE_PICKER_LABELS,\n  DEFAULT_FILE_LABELS,\n  DEFAULT_MULTI_SELECT_LABELS,\n  DEFAULT_PICKER_SHEET_LABELS,\n  DEFAULT_SWIPEABLE_ROW_LABELS,\n  DEFAULT_TOP_BAR_LABELS,\n} from \"./kit-labels\";\nimport type { UiKitLabels } from \"./kit-labels\";\n\n/**\n * The whole English tree in one object: what a translation is written against, and\n * the `reference` for {@link missingKitLabels}.\n *\n * A separate module from the provider on purpose. Components import the provider's\n * hooks; this file imports the components' defaults. Kept together they would be an\n * import cycle through every component in the kit.\n */\nexport const DEFAULT_UI_KIT_LABELS: UiKitLabels = {\n  common: DEFAULT_COMMON_LABELS,\n  dataTable: DEFAULT_DATA_TABLE_LABELS,\n  miniCalendar: DEFAULT_MINI_CALENDAR_LABELS,\n  datePicker: DEFAULT_DATE_PICKER_LABELS,\n  monthPicker: DEFAULT_MONTH_PICKER_LABELS,\n  popover: DEFAULT_POPOVER_LABELS,\n  combobox: DEFAULT_COMBOBOX_LABELS,\n  multiSelect: DEFAULT_MULTI_SELECT_LABELS,\n  calculator: DEFAULT_CALCULATOR_LABELS,\n  currency: DEFAULT_CURRENCY_LABELS,\n  chipInput: DEFAULT_CHIP_INPUT_LABELS,\n  fieldSync: DEFAULT_FIELD_SYNC_LABELS,\n  passwordReveal: DEFAULT_PASSWORD_REVEAL_LABELS,\n  tabs: DEFAULT_TABS_LABELS,\n  appShell: DEFAULT_APP_SHELL_LABELS,\n  pageContents: DEFAULT_PAGE_CONTENTS_LABELS,\n  topBar: DEFAULT_TOP_BAR_LABELS,\n  pickerSheet: DEFAULT_PICKER_SHEET_LABELS,\n  swipeableRow: DEFAULT_SWIPEABLE_ROW_LABELS,\n  file: DEFAULT_FILE_LABELS,\n  wizard: DEFAULT_WIZARD_LABELS,\n  tour: DEFAULT_TOUR_LABELS,\n  commandPalette: DEFAULT_COMMAND_PALETTE_LABELS,\n  seriesChart: DEFAULT_SERIES_CHART_LABELS,\n  sparkline: DEFAULT_SPARKLINE_LABELS,\n  statTile: DEFAULT_STAT_TILE_LABELS,\n  signaturePad: DEFAULT_SIGNATURE_PAD_LABELS,\n  passwordStrength: DEFAULT_PASSWORD_STRENGTH_LABELS,\n  dangerConfirm: DEFAULT_DANGER_CONFIRM_LABELS,\n  swatchPicker: DEFAULT_SWATCH_PICKER_LABELS,\n  iconPicker: DEFAULT_ICON_PICKER_LABELS,\n  dialogFrame: DEFAULT_DIALOG_FRAME_LABELS,\n  filePicker: DEFAULT_FILE_PICKER_LABELS,\n  measuredGrid: DEFAULT_MEASURED_GRID_LABELS,\n  feedbackAttachment: DEFAULT_FEEDBACK_ATTACHMENT_LABELS,\n};\n"],"mappings":";AAAA,SAAS,iCAAiC;AAC1C,SAAS,oCAAoC;AAC7C,SAAS,mCAAmC;AAC5C,SAAS,oCAAoC;AAC7C,SAAS,8BAA8B;AACvC,SAAS,iCAAiC;AAC1C,SAAS,iCAAiC;AAC1C,SAAS,gCAAgC,2BAA2B;AACpE,SAAS,6BAA6B;AACtC,SAAS,2BAA2B;AACpC,SAAS,sCAAsC;AAC/C,SAAS,mCAAmC;AAC5C,SAAS,gCAAgC;AACzC,SAAS,gCAAgC;AACzC,SAAS,oCAAoC;AAC7C,SAAS,wCAAwC;AACjD,SAAS,qCAAqC;AAC9C,SAAS,oCAAoC;AAC7C,SAAS,kCAAkC;AAC3C,SAAS,mCAAmC;AAC5C,SAAS,kCAAkC;AAC3C,SAAS,oCAAoC;AAC7C,SAAS,0CAA0C;AACnD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWA,MAAM,wBAAqC;AAAA,EAChD,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,SAAS;AAAA,EACT,UAAU;AAAA,EACV,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,WAAW;AAAA,EACX,WAAW;AAAA,EACX,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,UAAU;AAAA,EACV,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,cAAc;AAAA,EACd,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,WAAW;AAAA,EACX,UAAU;AAAA,EACV,cAAc;AAAA,EACd,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,oBAAoB;AACtB;","names":[]}
+{"version":3,"sources":["../../src/i18n/defaults.ts"],"sourcesContent":["import { DEFAULT_DATA_TABLE_LABELS } from \"../components/data-table-labels\";\nimport { DEFAULT_MINI_CALENDAR_LABELS } from \"../components/mini-calendar\";\nimport { DEFAULT_MONTH_PICKER_LABELS } from \"../components/month-picker\";\nimport { DEFAULT_PAGE_CONTENTS_LABELS } from \"../components/page-contents\";\nimport { DEFAULT_POPOVER_LABELS } from \"../components/popover\";\nimport { DEFAULT_CHIP_INPUT_LABELS } from \"../components/chip\";\nimport { DEFAULT_FIELD_SYNC_LABELS } from \"../components/field-sync\";\nimport { DEFAULT_PASSWORD_REVEAL_LABELS, DEFAULT_TABS_LABELS } from \"../components/ui\";\nimport { DEFAULT_WIZARD_LABELS } from \"../wizard/types\";\nimport { DEFAULT_TOUR_LABELS } from \"../tour/tour\";\nimport { DEFAULT_COMMAND_PALETTE_LABELS } from \"../search/command-palette\";\nimport { DEFAULT_SERIES_CHART_LABELS } from \"../components/series-chart-labels\";\nimport { DEFAULT_SPARKLINE_LABELS } from \"../components/sparkline\";\nimport { DEFAULT_STAT_TILE_LABELS } from \"../components/stat-tile\";\nimport { DEFAULT_SIGNATURE_PAD_LABELS } from \"../components/signature-pad\";\nimport { DEFAULT_PASSWORD_STRENGTH_LABELS } from \"../components/password-strength\";\nimport { DEFAULT_DANGER_CONFIRM_LABELS } from \"../components/danger-confirm\";\nimport { DEFAULT_SWATCH_PICKER_LABELS } from \"../components/swatch-picker\";\nimport { DEFAULT_ICON_PICKER_LABELS } from \"../components/icon-picker\";\nimport { DEFAULT_DIALOG_FRAME_LABELS } from \"../components/dialog-frame\";\nimport { DEFAULT_FILE_PICKER_LABELS } from \"../components/file-button\";\nimport { DEFAULT_MEASURED_GRID_LABELS } from \"../components/measured-grid\";\nimport { DEFAULT_CONFIRM_DIALOG_LABELS } from \"../components/confirm-dialog\";\nimport { DEFAULT_FLOATING_PANEL_LABELS } from \"../components/floating-panel\";\nimport { DEFAULT_FEEDBACK_ATTACHMENT_LABELS } from \"../feedback/feedback-attachment\";\nimport { DEFAULT_COPY_BUTTON_LABELS } from \"../components/copy-button\";\nimport {\n  DEFAULT_APP_SHELL_LABELS,\n  DEFAULT_CALCULATOR_LABELS,\n  DEFAULT_COMBOBOX_LABELS,\n  DEFAULT_COMMON_LABELS,\n  DEFAULT_CURRENCY_LABELS,\n  DEFAULT_DATE_PICKER_LABELS,\n  DEFAULT_FILE_LABELS,\n  DEFAULT_MULTI_SELECT_LABELS,\n  DEFAULT_PICKER_SHEET_LABELS,\n  DEFAULT_SWIPEABLE_ROW_LABELS,\n  DEFAULT_TOP_BAR_LABELS,\n} from \"./kit-labels\";\nimport type { UiKitLabels } from \"./kit-labels\";\n\n/**\n * The whole English tree in one object: what a translation is written against, and\n * the `reference` for {@link missingKitLabels}.\n *\n * A separate module from the provider on purpose. Components import the provider's\n * hooks; this file imports the components' defaults. Kept together they would be an\n * import cycle through every component in the kit.\n */\nexport const DEFAULT_UI_KIT_LABELS: UiKitLabels = {\n  common: DEFAULT_COMMON_LABELS,\n  dataTable: DEFAULT_DATA_TABLE_LABELS,\n  miniCalendar: DEFAULT_MINI_CALENDAR_LABELS,\n  datePicker: DEFAULT_DATE_PICKER_LABELS,\n  monthPicker: DEFAULT_MONTH_PICKER_LABELS,\n  popover: DEFAULT_POPOVER_LABELS,\n  combobox: DEFAULT_COMBOBOX_LABELS,\n  multiSelect: DEFAULT_MULTI_SELECT_LABELS,\n  calculator: DEFAULT_CALCULATOR_LABELS,\n  currency: DEFAULT_CURRENCY_LABELS,\n  chipInput: DEFAULT_CHIP_INPUT_LABELS,\n  fieldSync: DEFAULT_FIELD_SYNC_LABELS,\n  passwordReveal: DEFAULT_PASSWORD_REVEAL_LABELS,\n  tabs: DEFAULT_TABS_LABELS,\n  appShell: DEFAULT_APP_SHELL_LABELS,\n  pageContents: DEFAULT_PAGE_CONTENTS_LABELS,\n  topBar: DEFAULT_TOP_BAR_LABELS,\n  pickerSheet: DEFAULT_PICKER_SHEET_LABELS,\n  swipeableRow: DEFAULT_SWIPEABLE_ROW_LABELS,\n  file: DEFAULT_FILE_LABELS,\n  wizard: DEFAULT_WIZARD_LABELS,\n  tour: DEFAULT_TOUR_LABELS,\n  commandPalette: DEFAULT_COMMAND_PALETTE_LABELS,\n  seriesChart: DEFAULT_SERIES_CHART_LABELS,\n  sparkline: DEFAULT_SPARKLINE_LABELS,\n  statTile: DEFAULT_STAT_TILE_LABELS,\n  signaturePad: DEFAULT_SIGNATURE_PAD_LABELS,\n  passwordStrength: DEFAULT_PASSWORD_STRENGTH_LABELS,\n  dangerConfirm: DEFAULT_DANGER_CONFIRM_LABELS,\n  swatchPicker: DEFAULT_SWATCH_PICKER_LABELS,\n  iconPicker: DEFAULT_ICON_PICKER_LABELS,\n  dialogFrame: DEFAULT_DIALOG_FRAME_LABELS,\n  filePicker: DEFAULT_FILE_PICKER_LABELS,\n  measuredGrid: DEFAULT_MEASURED_GRID_LABELS,\n  feedbackAttachment: DEFAULT_FEEDBACK_ATTACHMENT_LABELS,\n  confirmDialog: DEFAULT_CONFIRM_DIALOG_LABELS,\n  floatingPanel: DEFAULT_FLOATING_PANEL_LABELS,\n  copyButton: DEFAULT_COPY_BUTTON_LABELS,\n};\n"],"mappings":";AAAA,SAAS,iCAAiC;AAC1C,SAAS,oCAAoC;AAC7C,SAAS,mCAAmC;AAC5C,SAAS,oCAAoC;AAC7C,SAAS,8BAA8B;AACvC,SAAS,iCAAiC;AAC1C,SAAS,iCAAiC;AAC1C,SAAS,gCAAgC,2BAA2B;AACpE,SAAS,6BAA6B;AACtC,SAAS,2BAA2B;AACpC,SAAS,sCAAsC;AAC/C,SAAS,mCAAmC;AAC5C,SAAS,gCAAgC;AACzC,SAAS,gCAAgC;AACzC,SAAS,oCAAoC;AAC7C,SAAS,wCAAwC;AACjD,SAAS,qCAAqC;AAC9C,SAAS,oCAAoC;AAC7C,SAAS,kCAAkC;AAC3C,SAAS,mCAAmC;AAC5C,SAAS,kCAAkC;AAC3C,SAAS,oCAAoC;AAC7C,SAAS,qCAAqC;AAC9C,SAAS,qCAAqC;AAC9C,SAAS,0CAA0C;AACnD,SAAS,kCAAkC;AAC3C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWA,MAAM,wBAAqC;AAAA,EAChD,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,SAAS;AAAA,EACT,UAAU;AAAA,EACV,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,WAAW;AAAA,EACX,WAAW;AAAA,EACX,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,UAAU;AAAA,EACV,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,cAAc;AAAA,EACd,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,WAAW;AAAA,EACX,UAAU;AAAA,EACV,cAAc;AAAA,EACd,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,oBAAoB;AAAA,EACpB,eAAe;AAAA,EACf,eAAe;AAAA,EACf,YAAY;AACd;","names":[]}

package/dist/i18n/kit-labels.d.ts

@@ -23,6 +23,9 @@ import { DialogFrameLabels } from '../components/dialog-frame.js';
 import { FilePickerLabels } from '../components/file-button.js';
 import { MeasuredGridLabels } from '../components/measured-grid.js';
 import { FeedbackAttachmentFieldLabels } from '../feedback/feedback-attachment.js';
+import { ConfirmDialogLabels } from '../components/confirm-dialog.js';
+import { FloatingPanelLabels } from '../components/floating-panel.js';
+import { CopyButtonLabels } from '../components/copy-button.js';
 import 'lucide-react';
 import '../components/tooltip.js';
 import '../hooks/use-anchored-rect.js';
@@ -75,6 +78,9 @@ interface CommonLabels {
      *  A colon-and-space is not universal punctuation (French puts a space before
      *  the colon, Chinese uses a full-width one). */
     fieldValue: (field: string, value: string) => string;
+    /** The × that puts away a banner or a notice (`AlertBanner onDismiss`). Not `close`:
+     *  nothing opened, and "Close" on a banner reads as closing the page it sits on. */
+    dismiss: string;
 }
 /** `DatePicker` / `DateRangePicker` chrome. The calendar inside has its own
  *  namespace, `miniCalendar`. */
@@ -87,6 +93,12 @@ interface DatePickerLabels {
     previousDay: string;
     nextDay: string;
     today: string;
+    /** `DateRangePicker commit="apply"`: the button that commits the drafted range. */
+    apply: string;
+    /** …and the one that discards it. */
+    cancel: string;
+    /** Accessible name of `DateRangePicker`'s preset column. */
+    presets: string;
 }
 /** The whole combobox family: `Combobox`, `EntityCombobox`,
  *  `MultiEntityCombobox`, `InlineEntityCombobox`, `Autocomplete`. */
@@ -204,6 +216,9 @@ interface UiKitLabels {
     filePicker: FilePickerLabels;
     measuredGrid: MeasuredGridLabels;
     feedbackAttachment: FeedbackAttachmentFieldLabels;
+    confirmDialog: ConfirmDialogLabels;
+    floatingPanel: FloatingPanelLabels;
+    copyButton: CopyButtonLabels;
 }
 /** Any subset of the tree, one level deep — each namespace may be partial, and a
  *  namespace that holds a record (`dataTable.presets`) is merged key by key. */