@eifi1/ui-kit 0.24.1 → 0.25.1

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @eifi1/ui-kit — shared design-system barrel.\n//\n// Domain-free UI + theme surface shared across apps (lead app: Keksdose). Consumers import\n// components/theme from \"@eifi1/ui-kit\" and the token stylesheet from \"@eifi1/ui-kit/tokens.css\".\n\n// ── lib ────────────────────────────────────────────────────────────────────\nexport * from \"./lib/calc\";\nexport { cn } from \"./lib/cn\";\nexport { logger, setStoreLog } from \"./lib/logger\";\n// Intl number / money / percent / date / relative-time formatting, and `useKitFormat()`\n// for the same bound to the provider's locale (kastlan's formatters.ts, English \"5m ago\").\nexport * from \"./lib/format\";\n// localStorage that never throws (Safari private mode, blocked site data).\nexport { readStored, writeStored } from \"./lib/safe-storage\";\n// Date helpers are also available via the \"@eifi1/ui-kit/dates\" subpath.\n\n// ── hooks ────────────────────────────────────────────────────────────────────\nexport { useMediaQuery } from \"./hooks/use-media-query\";\nexport { useBodyScrollLock } from \"./hooks/use-body-scroll-lock\";\nexport { useAnchoredRect } from \"./hooks/use-anchored-rect\";\nexport type { AnchorRect } from \"./hooks/use-anchored-rect\";\nexport { useAnchoredPanel, anchoredPanelPlacement, useVisualViewport } from \"./hooks/use-anchored-panel\";\nexport type {\n  AnchoredPanel,\n  AnchoredPanelOptions,\n  ViewportBox,\n} from \"./hooks/use-anchored-panel\";\nexport { useEscapeKey, useOutsideClick } from \"./hooks/use-dismiss\";\n// Focus containment for an overlay, and a live region for a change that moves no focus.\n// Both were extracted from the two components that already did them correctly (Modal and\n// CommandPalette) so the rest of the kit stops being the exception.\nexport { useFocusTrap } from \"./hooks/use-focus-trap\";\nexport type { FocusTrapOptions } from \"./hooks/use-focus-trap\";\nexport { useAnnounce } from \"./hooks/use-announce\";\nexport type { UseAnnounceReturn, UseAnnounceOptions, AnnounceRegionProps } from \"./hooks/use-announce\";\nexport { useOverlayHistory } from \"./hooks/use-overlay-history\";\nexport { useCloseTransition, OVERLAY_EXIT_MS } from \"./hooks/use-close-transition\";\nexport { useRowSwipe } from \"./hooks/use-row-swipe\";\nexport type { SwipeStage, RowSwipeOptions, RowSwipeReturn } from \"./hooks/use-row-swipe\";\n// Any element as a file drop target, screened like FileButton (kastlan).\nexport { useFileDrop, dragHasFiles } from \"./hooks/use-file-drop\";\nexport type { UseFileDropOptions, UseFileDropReturn, FileDropProps } from \"./hooks/use-file-drop\";\n// kastlan's search boxes each carried a hand-rolled copy, two without the cleanup.\nexport { useDebounce, useDebouncedCallback } from \"./hooks/use-debounce\";\nexport type { DebouncedCallbackOptions, DebouncedFunction } from \"./hooks/use-debounce\";\n// One search param as state, the active tab in `?tab=`, and a dialog's open state in the\n// URL (Modal's `urlParam`) — kastlan's and keksdose's use-search-param-state, in the kit.\nexport { useSearchParamState, useTabParam, useDialogParam } from \"./hooks/use-search-param-state\";\nexport type { SearchParamStateOptions, DialogParam } from \"./hooks/use-search-param-state\";\n// Copy that reports whether it worked — keksdose's copy buttons said \"Copied\" when it had not.\nexport { useCopyToClipboard, copyToClipboard } from \"./hooks/use-copy-to-clipboard\";\nexport type { CopyState, UseCopyToClipboardOptions, UseCopyToClipboardReturn } from \"./hooks/use-copy-to-clipboard\";\n// Keyboard shortcuts (\"Mod+K\", \"Ctrl+Shift+F\") that leave typing in fields alone.\nexport { useHotkey, parseHotkey, matchesHotkey } from \"./hooks/use-hotkey\";\nexport type { Hotkey, ParsedHotkey, UseHotkeyOptions } from \"./hooks/use-hotkey\";\n// A protected file as an object URL, fetched with the app's own auth (kastlan's AuthedImage).\nexport { useAuthedSrc } from \"./hooks/use-authed-src\";\nexport type { AuthedFetcher, AuthedSrcStatus, UseAuthedSrcOptions, UseAuthedSrcResult } from \"./hooks/use-authed-src\";\n\n// ── theme / palettes ─────────────────────────────────────────────────────────\nexport * from \"./theme/chart-palette\";\n// Colour maths (sRGB ↔ OKLCH, WCAG contrast, CVD simulation) and the palette deriver\n// that builds a whole, contrast-solved palette from one brand colour plus any colours\n// pinned by hand. `auditPalette` / `auditChartRamp` measure a palette rather than\n// trusting a comment about it.\nexport * from \"./theme/color\";\nexport * from \"./theme/palette-derive\";\nexport * from \"./theme/palette-presets\";\nexport * from \"./theme/theme-store\";\nexport * from \"./theme/palette-store\";\n\n// ── components ───────────────────────────────────────────────────────────────\nexport * from \"./components/ui\";\n// The label-ABOVE field group (label, hint, error, required), inside wizards or out.\nexport * from \"./components/field\";\nexport * from \"./components/search-field\";\nexport * from \"./components/dropdown\";\nexport * from \"./components/popover\";\nexport { SwipeableRow } from \"./components/swipeable-row\";\nexport type { SwipeAction, SwipeableRowProps } from \"./components/swipeable-row\";\nexport * from \"./components/calculator\";\nexport * from \"./components/numpad-sheet\";\nexport * from \"./components/number-input\";\nexport * from \"./components/currency-select\";\nexport * from \"./components/amount-input\";\nexport * from \"./components/money-field\";\nexport * from \"./components/combobox\";\nexport * from \"./components/picker-sheet\";\nexport * from \"./components/entity-combobox\";\nexport * from \"./components/multi-entity-combobox\";\nexport * from \"./components/multi-select\";\nexport * from \"./components/tooltip\";\nexport * from \"./components/user-avatar\";\nexport * from \"./components/settings-fields\";\n// Sync state for a database-backed field: the engine (`useFieldSync`) and the\n// affordance (`FieldSyncIndicator`), kept separate because the state is useful\n// without the dot — a form can gate its submit on any field being `pending`.\nexport * from \"./components/field-sync\";\nexport * from \"./components/month-picker\";\nexport * from \"./components/checkbox\";\nexport * from \"./components/switch\";\nexport * from \"./components/slider\";\nexport * from \"./components/time-input\";\nexport * from \"./components/number-field\";\nexport * from \"./components/sparkline\";\nexport * from \"./components/stat-tile\";\nexport * from \"./components/signature-pad\";\nexport * from \"./components/password-strength\";\nexport * from \"./components/page-contents\";\nexport * from \"./components/disclosure\";\nexport * from \"./components/dialog-frame\";\n// Named, not `*`: danger-confirm also holds the password field and pending hook that\n// ReauthDialog shares with it, which are kit-internal.\nexport {\n  DangerConfirm,\n  DEFAULT_DANGER_CONFIRM_LABELS,\n  typedMatches,\n  // 0.22.0: the typed-confirmation field on its own (keksdose K7) and the current-password\n  // field kastlan wants for sign-in and re-authentication (kastlan 1).\n  TypedConfirmField,\n  CurrentPasswordInput,\n} from \"./components/danger-confirm\";\nexport type {\n  DangerConfirmLabels,\n  DangerConfirmProps,\n  TypedMatch,\n  DangerConsequence,\n  TypedConfirmFieldProps,\n  TypedConfirmFieldLabels,\n  CurrentPasswordInputProps,\n  CurrentPasswordInputLabels,\n  // 0.23.0: onConfirm's second argument — the guards' values (keksdose G4b).\n  DangerConfirmValues,\n} from \"./components/danger-confirm\";\n// 0.18: re-authentication before a sensitive action (Kurvenschmiede 4).\nexport { ReauthDialog, DEFAULT_REAUTH_DIALOG_LABELS } from \"./components/reauth-dialog\";\nexport type { ReauthDialogProps, ReauthDialogLabels } from \"./components/reauth-dialog\";\n// `useConfirm()` — the promise-based replacement for `window.confirm`, one host per app.\nexport * from \"./components/confirm-dialog\";\n// A non-modal corner panel and its round trigger (keksdose's assistant launcher).\nexport * from \"./components/floating-panel\";\n// The count / clear / actions bar a selection brings up (keksdose's three copies).\nexport * from \"./components/bulk-action-bar\";\nexport * from \"./components/swatch-picker\";\nexport * from \"./components/icon-picker\";\nexport * from \"./components/choice-card\";\nexport * from \"./components/autocomplete\";\nexport * from \"./components/measured-grid\";\nexport { useWindowedRows } from \"./hooks/use-windowed-rows\";\nexport type { WindowedRows } from \"./hooks/use-windowed-rows\";\n// Named, not `export *`: file-button.tsx also holds the screening helpers the\n// dropzone shares, which are internal.\nexport { FileButton, useFilePicker, matchesAccept, DEFAULT_FILE_PICKER_LABELS } from \"./components/file-button\";\nexport type {\n  FileButtonProps,\n  UseFilePickerOptions,\n  UseFilePickerReturn,\n  FilePickerLabels,\n  FileRejection,\n  FileRejectionReason,\n  FileScreenOptions,\n} from \"./components/file-button\";\nexport * from \"./components/treemap\";\nexport * from \"./components/series-chart\";\nexport * from \"./components/chart-zoom\";\nexport * from \"./components/toggle-legend\";\nexport * from \"./components/facing-pair\";\nexport * from \"./components/series-chart-labels\";\nexport * from \"./components/pie-chart\";\nexport * from \"./components/pie-chart-labels\";\nexport * from \"./components/account-settings\";\n// 0.12.0: the fourth account section, and the QR code TwoFactorSetting draws its\n// otpauth URI with (encoder in lib/qr-encode.ts — no dependency, see there).\nexport * from \"./components/passkeys-setting\";\nexport * from \"./components/qr-code\";\nexport { encodeQr } from \"./lib/qr-encode\";\nexport type { QrEncodeOptions, QrErrorCorrection, QrMatrix } from \"./lib/qr-encode\";\nexport * from \"./components/alert-banner\";\nexport * from \"./components/toggle-group\";\n// A wrapping set of links/buttons marked `aria-current` — Tabs-like looks, not tabs.\nexport * from \"./components/nav-pills\";\n// A pill carrying one VALUE — inert, a link, or a toggle, depending on which prop it is\n// given — and the list field built from it. Distinct from Button on purpose: a row of\n// buttons reads as \"choose an action\", a row of chips as \"here are the things\".\nexport * from \"./components/chip\";\nexport * from \"./components/wizard-stepper\";\nexport * from \"./components/hover-menu\";\nexport * from \"./components/modal\";\nexport * from \"./components/full-bleed-dialog\";\nexport * from \"./components/grouped-picker\";\nexport * from \"./components/file-dropzone\";\nexport * from \"./components/mini-calendar\";\nexport * from \"./components/calendar-heatmap\";\nexport * from \"./components/date-picker\";\nexport * from \"./components/tree-view\";\nexport * from \"./components/chart\";\n// 0.8.0 layout and feedback primitives the apps hand-rolled or took from shadcn/Radix.\nexport * from \"./components/description-list\";\n// The Save / Cancel row forms and dialogs end in, and the editable line-item repeater\n// (journal lines, lease components, invoice positions). 0.12.0.\nexport * from \"./components/form-actions\";\n// 0.18: lock every opted-in commit under one provider, the reason in its tooltip\n// (Kurvenschmiede 2). `useCommitReason` stays internal.\nexport { WriteLockProvider, useWriteLock, DEFAULT_WRITE_LOCK_LABELS } from \"./components/write-lock\";\nexport type { WriteLock, WriteLockLabels, WriteLockProviderProps } from \"./components/write-lock\";\n// 0.18: the parts both apps' admin rosters repeat (Kurvenschmiede 6).\nexport { RoleChip, AccountStateChip, DateMark, dateColumn, DEFAULT_ACCOUNT_STATE_LABELS, ACCOUNT_STATE_TONES } from \"./components/account-chips\";\nexport type { RoleChipProps, RoleDefinition, RoleVocabulary, AccountState, AccountStateLabels, AccountStateChipProps, DateMarkProps, DateColumnOptions } from \"./components/account-chips\";\n// 0.18: the cold-start notice keksdose built (#199), for every app: a framework-free\n// watchdog over the app's requests and the corner notice that explains the wait.\nexport { createServerWake, serverWake, watchReadsAnd, attachServerWake, wrapFetch } from \"./lib/server-wake\";\nexport type { ServerWakeStage, ServerWakeFilter, ServerWakeOptions, ServerWakeRequest, ServerWakeWatcher, ServerWakeAxiosConfig, AxiosLikeInstance } from \"./lib/server-wake\";\nexport { ServerWakeNotice, useServerWakeStage, DEFAULT_SERVER_WAKE_LABELS } from \"./components/server-wake\";\nexport type { ServerWakeLabels, ServerWakeNoticeProps } from \"./components/server-wake\";\n// 0.18: sharing — grantees, roles, pending grants, candidates (Kurvenschmiede 1).\nexport { ShareCard, ShareDialog, SharePanel, DEFAULT_SHARE_CARD_LABELS } from \"./components/share-card\";\nexport type { ShareCardProps, ShareDialogProps, SharePanelProps, ShareCardLabels, ShareRole, ShareGrantee, SharePendingGrant, ShareCandidate, ShareAddRequest } from \"./components/share-card\";\nexport * from \"./components/line-items\";\nexport * from \"./components/progress-bar\";\n// Named: skeleton.tsx also holds SKELETON_CLASS, the look StatTile shares — internal.\nexport { Skeleton } from \"./components/skeleton\";\nexport type { SkeletonProps, SkeletonShape } from \"./components/skeleton\";\n// 0.12.0: a centred spinner with words, signed figures and deltas, a render-error fallback.\nexport * from \"./components/loading-state\";\nexport * from \"./components/signed-amount\";\nexport * from \"./components/error-boundary\";\nexport * from \"./components/copy-button\";\nexport { AuthedImage, DEFAULT_AUTHED_IMAGE_LABELS } from \"./components/authed-image\";\nexport type { AuthedImageProps, AuthedImageLabels } from \"./components/authed-image\";\nexport * from \"./components/image-grid\";\nexport * from \"./components/lightbox\";\nexport * from \"./components/button-group\";\nexport * from \"./components/table\";\nexport * from \"./components/separator\";\n// Named: scroll-area.tsx also holds the overflow hook and scrollbar class Table shares.\nexport { ScrollArea } from \"./components/scroll-area\";\nexport type { ScrollAreaProps } from \"./components/scroll-area\";\n// 0.10.0 rows, menu rows, text primitives and page chrome the apps drew by hand.\nexport * from \"./components/list\";\nexport * from \"./components/menu-item\";\nexport * from \"./components/text\";\nexport * from \"./components/status-dot\";\nexport * from \"./components/page-header\";\nexport * from \"./components/breadcrumbs\";\n// The one inline link (kastlan's EntityLink / CellLink / legal and source links), through\n// `<UiKitProvider linkComponent>`. Named: the file also holds the kit's internal link picker.\nexport { TextLink } from \"./components/text-link\";\nexport type {\n  TextLinkProps,\n  TextLinkRenderProps,\n  TextLinkTone,\n  TextLinkUnderline,\n  TextLinkCurrent,\n} from \"./components/text-link\";\n// The toast layer over sonner (an OPTIONAL peer, loaded lazily): `toast` mirrors sonner's\n// API so apps migrate by swapping the import; `<Toaster>` carries the placement, theme,\n// tones and z-index both apps had wired by hand.\nexport { toast, Toaster, DEFAULT_TOAST_LABELS, TOAST_ACTION_DURATION } from \"./components/toast\";\nexport type {\n  ToastId,\n  ToastAction,\n  ToastOptions,\n  ToastPromiseOptions,\n  ToastUndoOptions,\n  ToastRedoOptions,\n  ToastLabels,\n  ToastPosition,\n  ToastSwipeDirection,\n  ToasterOffset,\n  ToasterProps,\n} from \"./components/toast\";\n\n// ── data-table suite ─────────────────────────────────────────────────────────\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// data-table re-exports SortState internally; export the rest explicitly to\n// avoid a duplicate SortState star-export (it comes from data-table-sort).\nexport { DataTable, DEFAULT_DATA_TABLE_SORT_LABELS } from \"./components/data-table\";\nexport type {\n  DataTableSortLabels,\n  DataTableColumn,\n  DataTableCellProps,\n  DataTableHeadProps,\n  DataTableProps,\n  ServerPagination,\n  FilterState,\n  MobileSwipeActions,\n  DataTableDensity,\n  DataTableChrome,\n  DataTableRowAction,\n} from \"./components/data-table\";\n// 0.12.0: the yes/no cell, and a server table's state held by its owner, URL-synced.\nexport * from \"./components/data-table-cells\";\nexport { useTableUrlState, readTableUrlState } from \"./components/use-table-state\";\nexport type {\n  TableUrlState,\n  TableUrlSync,\n  TableUrlStateProps,\n  UseTableUrlStateOptions,\n  UseTableUrlStateReturn,\n} from \"./components/use-table-state\";\n\n// ── shell (composable app chrome) ────────────────────────────────────────────\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n\n// ── feedback ─────────────────────────────────────────────────────────────────\n// The form somebody files a report with, and the parts an inbox is built from:\n// the status vocabulary both apps share value for value, the policy about what a\n// row may move to from where it stands, and the look of a status control, a\n// category badge and an opened report. The app still wires its own API, columns\n// and strings — see the note at the top of `feedback-inbox.tsx` for what is\n// deliberately left to it.\nexport * from \"./feedback/feedback-attachment\";\nexport * from \"./feedback/feedback-dialog\";\nexport * from \"./feedback/feedback-inbox\";\nexport * from \"./feedback/feedback-thread\";\n\n// ── multi-step wizard ────────────────────────────────────────────────────────\n// The engine (step machine, validators, collected data), the chrome around it\n// (indicator + nav bar + cancel confirm) and the review step it ends on.\n// `components/wizard-stepper` next door is a different, much smaller thing: a bare\n// step indicator for a two-step import flow, with no engine.\n//\n// Two modules were removed here rather than kept as stock. `wizard-field` held a\n// `WizardField`/`WizardSelectField` pair that had never been rendered in any app —\n// a field group nothing was built from, which this comment used to advertise. And\n// `use-rhf-wizard-step` was the only thing in the package that touched\n// react-hook-form, for a hook neither consumer called: keeping it meant an optional\n// peer, a dev dependency and a type import in every consumer's typecheck, bought\n// for nobody. A design system may carry stock; untested stock nothing has ever\n// rendered is not stock, it is a liability with an export.\nexport * from \"./wizard/types\";\nexport * from \"./wizard/use-wizard\";\nexport * from \"./wizard/wizard-context\";\nexport * from \"./wizard/validation\";\nexport * from \"./wizard/wizard-step\";\nexport * from \"./wizard/wizard-summary\";\nexport * from \"./wizard/stepper-nav\";\n\n// ── guided tours ─────────────────────────────────────────────────────────────\nexport * from \"./tour/tour\";\n\n// ── command palette / global search ──────────────────────────────────────────\nexport * from \"./search/command-palette\";\nexport * from \"./search/search-index\";\nexport * from \"./search/global-search\";\n\n// ── i18n: one label tree, one optional provider ──────────────────────────────\n// `UiKitLabels` names every string the kit renders; `<UiKitProvider labels locale>`\n// hands a translation to every component below it. Precedence: a component's own\n// prop > the provider > the English default. See src/i18n/kit-labels.tsx.\nexport * from \"./i18n/kit-labels\";\nexport * from \"./i18n/defaults\";\n// The kit's words as `key → text` rows for an app's translation review (keksdose).\nexport { kitLabelStrings } from \"./i18n/review\";\n// The seven languages, how an app resolves one, and the kit catalogue loader for it.\nexport * from \"./i18n/languages\";\n// CLDR plural categories for an app's i18next catalogue, filled from `_other`.\nexport { withAllPlurals } from \"./i18n/plurals\";\n// Translation review (0.19): one contract for kastlan's and keksdose's review pages —\n// the pure rows/status/placeholder logic and the presentational page parts.\nexport {\n  REVIEW_STATUSES,\n  fromApiReview,\n  toApiWrite,\n  flattenStrings,\n  keyNamespace,\n  placeholderTokens,\n  placeholderMismatch,\n  reviewStatus,\n  keyInArea,\n  keyInAreas,\n  translationRows,\n  summariseRows,\n  DEFAULT_TRANSLATION_REVIEW_FILTER,\n  filterTranslationRows,\n  reviewWrite,\n  mergeReviews,\n  dropReviews,\n  translationCorrections,\n} from \"./lib/translation-review\";\nexport type {\n  TranslationVerdict,\n  TranslationReview,\n  TranslationReviewWrite,\n  TranslationReviewKey,\n  ReviewStatus,\n  TranslationRow,\n  ApiTranslationReview,\n  ApiTranslationReviewWrite,\n  TranslationRowsInput,\n  TranslationSummary,\n  TranslationReviewFilter,\n  TranslationCorrection,\n} from \"./lib/translation-review\";\nexport {\n  TranslationReviewPanel,\n  TranslationReviewEditor,\n  ReviewStatusChip,\n  TranslationProgress,\n  TranslationLocaleTabs,\n  TranslationExportButton,\n  REVIEW_STATUS_TONES,\n  DEFAULT_TRANSLATION_REVIEW_LABELS,\n} from \"./components/translation-review\";\nexport type {\n  TranslationReviewPanelProps,\n  TranslationReviewEditorProps,\n  ReviewStatusChipProps,\n  TranslationProgressProps,\n  TranslationLocaleTab,\n  TranslationLocaleTabsProps,\n  TranslationExportButtonProps,\n  TranslationReviewLabels,\n} from \"./components/translation-review\";\n// The legal pages' shell (0.19, H10): Imprint, Privacy Policy, Terms in every app.\nexport { LegalLayout, LegalSection, LegalLinks, DEFAULT_LEGAL_LABELS } from \"./components/legal\";\nexport type { LegalLabels, LegalLink, LegalLinksProps, LegalSectionProps, LegalLayoutProps } from \"./components/legal\";\n\n// ── 0.22.0: the inputs round (kastlan's, keksdose's and Kurvenschmiede's audits) ──\nexport * from \"./components/checkbox-group\";\nexport * from \"./components/one-time-code-input\";\nexport * from \"./components/language-select\";\nexport * from \"./components/tile-radio\";\nexport * from \"./components/inline-edit-field\";\nexport * from \"./components/sign-chip\";\nexport * from \"./components/country-select\";\nexport { COUNTRY_CODES, countryName } from \"./lib/countries\";\nexport * from \"./components/iban-input\";\nexport {\n  IBAN_LENGTHS,\n  compactIban,\n  formatIban,\n  ibanCheckDigits,\n  ibanProblem,\n  isValidIban,\n  isQrIban,\n} from \"./lib/iban\";\nexport type { IbanKind, IbanProblem } from \"./lib/iban\";\nexport { formatIsin, isinCheckDigit, isValidIsin } from \"./lib/isin\";\nexport * from \"./components/phone-input\";\nexport {\n  PHONE_DIAL_CODES,\n  PHONE_COUNTRIES,\n  parsePhone,\n  formatNationalPhone,\n  formatPhone,\n  isE164,\n} from \"./lib/phone\";\nexport type { PhoneCountryCode, PhoneCountry, ParsedPhone } from \"./lib/phone\";\n\n// ── 0.23.0: the apps' 0.22 adoption round (kastlan, keksdose, Kurvenschmiede) ──\n// The label strip over custom content (keksdose G8).\nexport * from \"./components/field-strip\";\n// Paste or drop a table, give each column a role (Kurvenschmiede's columns input,\n// keksdose's import map step). The lexer itself stays in `@eifi1/ui-kit/table-text`.\nexport * from \"./components/column-mapper\";\nexport {\n  assignColumnRole,\n  guessMapping,\n  missingRoles,\n  readMappedTable,\n  readTextFile,\n  roleOfColumn,\n} from \"./lib/column-mapping\";\nexport type { ColumnMapperResult, ColumnMapping, ColumnRole } from \"./lib/column-mapping\";\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @eifi1/ui-kit — shared design-system barrel.\n//\n// Domain-free UI + theme surface shared across apps (lead app: Keksdose). Consumers import\n// components/theme from \"@eifi1/ui-kit\" and the token stylesheet from \"@eifi1/ui-kit/tokens.css\".\n\n// ── lib ────────────────────────────────────────────────────────────────────\nexport * from \"./lib/calc\";\nexport { cn } from \"./lib/cn\";\nexport { logger, setStoreLog } from \"./lib/logger\";\n// Intl number / money / percent / date / relative-time formatting, and `useKitFormat()`\n// for the same bound to the provider's locale (kastlan's formatters.ts, English \"5m ago\").\nexport * from \"./lib/format\";\n// localStorage that never throws (Safari private mode, blocked site data).\nexport { readStored, writeStored } from \"./lib/safe-storage\";\n// Date helpers are also available via the \"@eifi1/ui-kit/dates\" subpath.\n\n// ── hooks ────────────────────────────────────────────────────────────────────\nexport { useMediaQuery } from \"./hooks/use-media-query\";\nexport { useBodyScrollLock } from \"./hooks/use-body-scroll-lock\";\nexport { useAnchoredRect } from \"./hooks/use-anchored-rect\";\nexport type { AnchorRect } from \"./hooks/use-anchored-rect\";\nexport { useAnchoredPanel, anchoredPanelPlacement, useVisualViewport } from \"./hooks/use-anchored-panel\";\nexport type {\n  AnchoredPanel,\n  AnchoredPanelOptions,\n  ViewportBox,\n} from \"./hooks/use-anchored-panel\";\nexport { useEscapeKey, useOutsideClick } from \"./hooks/use-dismiss\";\n// Focus containment for an overlay, and a live region for a change that moves no focus.\n// Both were extracted from the two components that already did them correctly (Modal and\n// CommandPalette) so the rest of the kit stops being the exception.\nexport { useFocusTrap } from \"./hooks/use-focus-trap\";\nexport type { FocusTrapOptions } from \"./hooks/use-focus-trap\";\nexport { useAnnounce } from \"./hooks/use-announce\";\nexport type { UseAnnounceReturn, UseAnnounceOptions, AnnounceRegionProps } from \"./hooks/use-announce\";\nexport { useOverlayHistory } from \"./hooks/use-overlay-history\";\nexport { useCloseTransition, OVERLAY_EXIT_MS } from \"./hooks/use-close-transition\";\nexport { useRowSwipe } from \"./hooks/use-row-swipe\";\nexport type { SwipeStage, RowSwipeOptions, RowSwipeReturn } from \"./hooks/use-row-swipe\";\n// Any element as a file drop target, screened like FileButton (kastlan).\nexport { useFileDrop, dragHasFiles } from \"./hooks/use-file-drop\";\nexport type { UseFileDropOptions, UseFileDropReturn, FileDropProps } from \"./hooks/use-file-drop\";\n// kastlan's search boxes each carried a hand-rolled copy, two without the cleanup.\nexport { useDebounce, useDebouncedCallback } from \"./hooks/use-debounce\";\nexport type { DebouncedCallbackOptions, DebouncedFunction } from \"./hooks/use-debounce\";\n// One search param as state, the active tab in `?tab=`, and a dialog's open state in the\n// URL (Modal's `urlParam`) — kastlan's and keksdose's use-search-param-state, in the kit.\nexport { useSearchParamState, useTabParam, useDialogParam } from \"./hooks/use-search-param-state\";\nexport type { SearchParamStateOptions, DialogParam } from \"./hooks/use-search-param-state\";\n// 0.25: several keys, one navigation (keksdose live #378 — four setters in a row clobbered).\nexport { useSearchParamsState } from \"./hooks/use-search-param-state\";\nexport type { SearchParamField, SearchParamFields, SearchParamsUpdate } from \"./hooks/use-search-param-state\";\n// Copy that reports whether it worked — keksdose's copy buttons said \"Copied\" when it had not.\nexport { useCopyToClipboard, copyToClipboard } from \"./hooks/use-copy-to-clipboard\";\nexport type { CopyState, UseCopyToClipboardOptions, UseCopyToClipboardReturn } from \"./hooks/use-copy-to-clipboard\";\n// Keyboard shortcuts (\"Mod+K\", \"Ctrl+Shift+F\") that leave typing in fields alone.\nexport { useHotkey, parseHotkey, matchesHotkey } from \"./hooks/use-hotkey\";\nexport type { Hotkey, ParsedHotkey, UseHotkeyOptions } from \"./hooks/use-hotkey\";\n// A protected file as an object URL, fetched with the app's own auth (kastlan's AuthedImage).\nexport { useAuthedSrc } from \"./hooks/use-authed-src\";\nexport type { AuthedFetcher, AuthedSrcStatus, UseAuthedSrcOptions, UseAuthedSrcResult } from \"./hooks/use-authed-src\";\n\n// ── theme / palettes ─────────────────────────────────────────────────────────\nexport * from \"./theme/chart-palette\";\n// Colour maths (sRGB ↔ OKLCH, WCAG contrast, CVD simulation) and the palette deriver\n// that builds a whole, contrast-solved palette from one brand colour plus any colours\n// pinned by hand. `auditPalette` / `auditChartRamp` measure a palette rather than\n// trusting a comment about it.\nexport * from \"./theme/color\";\nexport * from \"./theme/palette-derive\";\nexport * from \"./theme/palette-presets\";\nexport * from \"./theme/theme-store\";\nexport * from \"./theme/palette-store\";\n\n// ── components ───────────────────────────────────────────────────────────────\nexport * from \"./components/ui\";\n// The label-ABOVE field group (label, hint, error, required), inside wizards or out.\nexport * from \"./components/field\";\nexport * from \"./components/search-field\";\nexport * from \"./components/dropdown\";\nexport * from \"./components/popover\";\nexport { SwipeableRow } from \"./components/swipeable-row\";\nexport type { SwipeAction, SwipeableRowProps } from \"./components/swipeable-row\";\nexport * from \"./components/calculator\";\nexport * from \"./components/numpad-sheet\";\nexport * from \"./components/number-input\";\nexport * from \"./components/currency-select\";\nexport * from \"./components/amount-input\";\nexport * from \"./components/money-field\";\nexport * from \"./components/combobox\";\nexport * from \"./components/picker-sheet\";\nexport * from \"./components/entity-combobox\";\nexport * from \"./components/multi-entity-combobox\";\nexport * from \"./components/multi-select\";\nexport * from \"./components/tooltip\";\nexport * from \"./components/user-avatar\";\nexport * from \"./components/settings-fields\";\n// Sync state for a database-backed field: the engine (`useFieldSync`) and the\n// affordance (`FieldSyncIndicator`), kept separate because the state is useful\n// without the dot — a form can gate its submit on any field being `pending`.\nexport * from \"./components/field-sync\";\nexport * from \"./components/month-picker\";\nexport * from \"./components/checkbox\";\nexport * from \"./components/switch\";\nexport * from \"./components/slider\";\nexport * from \"./components/time-input\";\nexport * from \"./components/number-field\";\nexport * from \"./components/sparkline\";\nexport * from \"./components/stat-tile\";\nexport * from \"./components/signature-pad\";\nexport * from \"./components/password-strength\";\nexport * from \"./components/page-contents\";\nexport * from \"./components/disclosure\";\nexport * from \"./components/dialog-frame\";\n// Named, not `*`: danger-confirm also holds the password field and pending hook that\n// ReauthDialog shares with it, which are kit-internal.\nexport {\n  DangerConfirm,\n  DEFAULT_DANGER_CONFIRM_LABELS,\n  typedMatches,\n  // 0.22.0: the typed-confirmation field on its own (keksdose K7) and the current-password\n  // field kastlan wants for sign-in and re-authentication (kastlan 1).\n  TypedConfirmField,\n  CurrentPasswordInput,\n} from \"./components/danger-confirm\";\nexport type {\n  DangerConfirmLabels,\n  DangerConfirmProps,\n  TypedMatch,\n  DangerConsequence,\n  TypedConfirmFieldProps,\n  TypedConfirmFieldLabels,\n  CurrentPasswordInputProps,\n  CurrentPasswordInputLabels,\n  // 0.23.0: onConfirm's second argument — the guards' values (keksdose G4b).\n  DangerConfirmValues,\n} from \"./components/danger-confirm\";\n// 0.18: re-authentication before a sensitive action (Kurvenschmiede 4).\nexport { ReauthDialog, DEFAULT_REAUTH_DIALOG_LABELS } from \"./components/reauth-dialog\";\nexport type { ReauthDialogProps, ReauthDialogLabels } from \"./components/reauth-dialog\";\n// `useConfirm()` — the promise-based replacement for `window.confirm`, one host per app.\nexport * from \"./components/confirm-dialog\";\n// A non-modal corner panel and its round trigger (keksdose's assistant launcher).\nexport * from \"./components/floating-panel\";\n// The count / clear / actions bar a selection brings up (keksdose's three copies).\nexport * from \"./components/bulk-action-bar\";\nexport * from \"./components/swatch-picker\";\nexport * from \"./components/icon-picker\";\nexport * from \"./components/choice-card\";\nexport * from \"./components/autocomplete\";\nexport * from \"./components/measured-grid\";\nexport { useWindowedRows } from \"./hooks/use-windowed-rows\";\nexport type { WindowedRows } from \"./hooks/use-windowed-rows\";\n// Named, not `export *`: file-button.tsx also holds the screening helpers the\n// dropzone shares, which are internal.\nexport { FileButton, useFilePicker, matchesAccept, DEFAULT_FILE_PICKER_LABELS } from \"./components/file-button\";\nexport type {\n  FileButtonProps,\n  UseFilePickerOptions,\n  UseFilePickerReturn,\n  FilePickerLabels,\n  FileRejection,\n  FileRejectionReason,\n  FileScreenOptions,\n} from \"./components/file-button\";\nexport * from \"./components/treemap\";\nexport * from \"./components/series-chart\";\nexport * from \"./components/chart-zoom\";\nexport * from \"./components/toggle-legend\";\nexport * from \"./components/facing-pair\";\nexport * from \"./components/series-chart-labels\";\nexport * from \"./components/pie-chart\";\nexport * from \"./components/pie-chart-labels\";\nexport * from \"./components/account-settings\";\n// 0.12.0: the fourth account section, and the QR code TwoFactorSetting draws its\n// otpauth URI with (encoder in lib/qr-encode.ts — no dependency, see there).\nexport * from \"./components/passkeys-setting\";\nexport * from \"./components/qr-code\";\nexport { encodeQr } from \"./lib/qr-encode\";\nexport type { QrEncodeOptions, QrErrorCorrection, QrMatrix } from \"./lib/qr-encode\";\nexport * from \"./components/alert-banner\";\nexport * from \"./components/toggle-group\";\n// A wrapping set of links/buttons marked `aria-current` — Tabs-like looks, not tabs.\nexport * from \"./components/nav-pills\";\n// A pill carrying one VALUE — inert, a link, or a toggle, depending on which prop it is\n// given — and the list field built from it. Distinct from Button on purpose: a row of\n// buttons reads as \"choose an action\", a row of chips as \"here are the things\".\nexport * from \"./components/chip\";\nexport * from \"./components/wizard-stepper\";\nexport * from \"./components/hover-menu\";\nexport * from \"./components/modal\";\nexport * from \"./components/full-bleed-dialog\";\nexport * from \"./components/grouped-picker\";\nexport * from \"./components/file-dropzone\";\nexport * from \"./components/mini-calendar\";\nexport * from \"./components/calendar-heatmap\";\nexport * from \"./components/date-picker\";\nexport * from \"./components/tree-view\";\nexport * from \"./components/chart\";\n// 0.8.0 layout and feedback primitives the apps hand-rolled or took from shadcn/Radix.\nexport * from \"./components/description-list\";\n// The Save / Cancel row forms and dialogs end in, and the editable line-item repeater\n// (journal lines, lease components, invoice positions). 0.12.0.\nexport * from \"./components/form-actions\";\n// 0.18: lock every opted-in commit under one provider, the reason in its tooltip\n// (Kurvenschmiede 2). `useCommitReason` stays internal.\nexport { WriteLockProvider, useWriteLock, DEFAULT_WRITE_LOCK_LABELS } from \"./components/write-lock\";\nexport type { WriteLock, WriteLockLabels, WriteLockProviderProps } from \"./components/write-lock\";\n// 0.18: the parts both apps' admin rosters repeat (Kurvenschmiede 6).\nexport { RoleChip, AccountStateChip, DateMark, dateColumn, DEFAULT_ACCOUNT_STATE_LABELS, ACCOUNT_STATE_TONES } from \"./components/account-chips\";\nexport type { RoleChipProps, RoleDefinition, RoleVocabulary, AccountState, AccountStateLabels, AccountStateChipProps, DateMarkProps, DateColumnOptions } from \"./components/account-chips\";\n// 0.18: the cold-start notice keksdose built (#199), for every app: a framework-free\n// watchdog over the app's requests and the corner notice that explains the wait.\nexport { createServerWake, serverWake, watchReadsAnd, attachServerWake, wrapFetch } from \"./lib/server-wake\";\nexport type { ServerWakeStage, ServerWakeFilter, ServerWakeOptions, ServerWakeRequest, ServerWakeWatcher, ServerWakeAxiosConfig, AxiosLikeInstance } from \"./lib/server-wake\";\nexport { ServerWakeNotice, useServerWakeStage, DEFAULT_SERVER_WAKE_LABELS } from \"./components/server-wake\";\nexport type { ServerWakeLabels, ServerWakeNoticeProps } from \"./components/server-wake\";\n// 0.18: sharing — grantees, roles, pending grants, candidates (Kurvenschmiede 1).\nexport { ShareCard, ShareDialog, SharePanel, DEFAULT_SHARE_CARD_LABELS } from \"./components/share-card\";\nexport type { ShareCardProps, ShareDialogProps, SharePanelProps, ShareCardLabels, ShareRole, ShareGrantee, SharePendingGrant, ShareCandidate, ShareAddRequest } from \"./components/share-card\";\nexport * from \"./components/line-items\";\nexport * from \"./components/progress-bar\";\n// Named: skeleton.tsx also holds SKELETON_CLASS, the look StatTile shares — internal.\nexport { Skeleton } from \"./components/skeleton\";\nexport type { SkeletonProps, SkeletonShape } from \"./components/skeleton\";\n// 0.12.0: a centred spinner with words, signed figures and deltas, a render-error fallback.\nexport * from \"./components/loading-state\";\nexport * from \"./components/signed-amount\";\nexport * from \"./components/error-boundary\";\nexport * from \"./components/copy-button\";\nexport { AuthedImage, DEFAULT_AUTHED_IMAGE_LABELS } from \"./components/authed-image\";\nexport type { AuthedImageProps, AuthedImageLabels } from \"./components/authed-image\";\nexport * from \"./components/image-grid\";\nexport * from \"./components/lightbox\";\nexport * from \"./components/button-group\";\nexport * from \"./components/table\";\nexport * from \"./components/separator\";\n// Named: scroll-area.tsx also holds the overflow hook and scrollbar class Table shares.\nexport { ScrollArea } from \"./components/scroll-area\";\nexport type { ScrollAreaProps } from \"./components/scroll-area\";\n// 0.10.0 rows, menu rows, text primitives and page chrome the apps drew by hand.\nexport * from \"./components/list\";\nexport * from \"./components/menu-item\";\nexport * from \"./components/text\";\nexport * from \"./components/status-dot\";\nexport * from \"./components/page-header\";\nexport * from \"./components/breadcrumbs\";\n// The one inline link (kastlan's EntityLink / CellLink / legal and source links), through\n// `<UiKitProvider linkComponent>`. Named: the file also holds the kit's internal link picker.\nexport { TextLink } from \"./components/text-link\";\nexport type {\n  TextLinkProps,\n  TextLinkRenderProps,\n  TextLinkTone,\n  TextLinkUnderline,\n  TextLinkCurrent,\n} from \"./components/text-link\";\n// The toast layer over sonner (an OPTIONAL peer, loaded lazily): `toast` mirrors sonner's\n// API so apps migrate by swapping the import; `<Toaster>` carries the placement, theme,\n// tones and z-index both apps had wired by hand.\nexport { toast, Toaster, DEFAULT_TOAST_LABELS, TOAST_ACTION_DURATION } from \"./components/toast\";\nexport type {\n  ToastId,\n  ToastAction,\n  ToastOptions,\n  ToastPromiseOptions,\n  ToastUndoOptions,\n  ToastRedoOptions,\n  ToastLabels,\n  ToastPosition,\n  ToastSwipeDirection,\n  ToasterOffset,\n  ToasterProps,\n} from \"./components/toast\";\n\n// ── data-table suite ─────────────────────────────────────────────────────────\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// data-table re-exports SortState internally; export the rest explicitly to\n// avoid a duplicate SortState star-export (it comes from data-table-sort).\nexport { DataTable, DEFAULT_DATA_TABLE_SORT_LABELS } from \"./components/data-table\";\nexport type {\n  DataTableSortLabels,\n  DataTableColumn,\n  DataTableCellProps,\n  DataTableHeadProps,\n  DataTableProps,\n  ServerPagination,\n  FilterState,\n  MobileSwipeActions,\n  DataTableDensity,\n  DataTableChrome,\n  DataTableRowAction,\n} from \"./components/data-table\";\n// 0.12.0: the yes/no cell, and a server table's state held by its owner, URL-synced.\nexport * from \"./components/data-table-cells\";\nexport { useTableUrlState, readTableUrlState } from \"./components/use-table-state\";\nexport type {\n  TableUrlState,\n  TableUrlSync,\n  TableUrlStateProps,\n  UseTableUrlStateOptions,\n  UseTableUrlStateReturn,\n} from \"./components/use-table-state\";\n\n// ── shell (composable app chrome) ────────────────────────────────────────────\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n\n// ── feedback ─────────────────────────────────────────────────────────────────\n// The form somebody files a report with, and the parts an inbox is built from:\n// the status vocabulary both apps share value for value, the policy about what a\n// row may move to from where it stands, and the look of a status control, a\n// category badge and an opened report. The app still wires its own API, columns\n// and strings — see the note at the top of `feedback-inbox.tsx` for what is\n// deliberately left to it.\nexport * from \"./feedback/feedback-attachment\";\nexport * from \"./feedback/feedback-dialog\";\nexport * from \"./feedback/feedback-inbox\";\nexport * from \"./feedback/feedback-thread\";\n\n// ── multi-step wizard ────────────────────────────────────────────────────────\n// The engine (step machine, validators, collected data), the chrome around it\n// (indicator + nav bar + cancel confirm) and the review step it ends on.\n// `components/wizard-stepper` next door is a different, much smaller thing: a bare\n// step indicator for a two-step import flow, with no engine.\n//\n// Two modules were removed here rather than kept as stock. `wizard-field` held a\n// `WizardField`/`WizardSelectField` pair that had never been rendered in any app —\n// a field group nothing was built from, which this comment used to advertise. And\n// `use-rhf-wizard-step` was the only thing in the package that touched\n// react-hook-form, for a hook neither consumer called: keeping it meant an optional\n// peer, a dev dependency and a type import in every consumer's typecheck, bought\n// for nobody. A design system may carry stock; untested stock nothing has ever\n// rendered is not stock, it is a liability with an export.\nexport * from \"./wizard/types\";\nexport * from \"./wizard/use-wizard\";\nexport * from \"./wizard/wizard-context\";\nexport * from \"./wizard/validation\";\nexport * from \"./wizard/wizard-step\";\nexport * from \"./wizard/wizard-summary\";\nexport * from \"./wizard/stepper-nav\";\n\n// ── guided tours ─────────────────────────────────────────────────────────────\nexport * from \"./tour/tour\";\n\n// ── command palette / global search ──────────────────────────────────────────\nexport * from \"./search/command-palette\";\nexport * from \"./search/search-index\";\nexport * from \"./search/global-search\";\n\n// ── i18n: one label tree, one optional provider ──────────────────────────────\n// `UiKitLabels` names every string the kit renders; `<UiKitProvider labels locale>`\n// hands a translation to every component below it. Precedence: a component's own\n// prop > the provider > the English default. See src/i18n/kit-labels.tsx.\nexport * from \"./i18n/kit-labels\";\nexport * from \"./i18n/defaults\";\n// The kit's words as `key → text` rows for an app's translation review (keksdose).\nexport { kitLabelStrings } from \"./i18n/review\";\n// The seven languages, how an app resolves one, and the kit catalogue loader for it.\nexport * from \"./i18n/languages\";\n// CLDR plural categories for an app's i18next catalogue, filled from `_other`.\nexport { withAllPlurals } from \"./i18n/plurals\";\n// Translation review (0.19): one contract for kastlan's and keksdose's review pages —\n// the pure rows/status/placeholder logic and the presentational page parts.\nexport {\n  REVIEW_STATUSES,\n  fromApiReview,\n  toApiWrite,\n  flattenStrings,\n  keyNamespace,\n  placeholderTokens,\n  placeholderMismatch,\n  reviewStatus,\n  keyInArea,\n  keyInAreas,\n  translationRows,\n  summariseRows,\n  DEFAULT_TRANSLATION_REVIEW_FILTER,\n  filterTranslationRows,\n  reviewWrite,\n  mergeReviews,\n  dropReviews,\n  translationCorrections,\n  // 0.25: grouping and the approvals' Undo (keksdose live #377).\n  groupTranslationRows,\n  unreviewedRows,\n  reviewUndo,\n} from \"./lib/translation-review\";\nexport type {\n  TranslationVerdict,\n  TranslationReview,\n  TranslationReviewWrite,\n  TranslationReviewKey,\n  ReviewStatus,\n  TranslationRow,\n  ApiTranslationReview,\n  ApiTranslationReviewWrite,\n  TranslationRowsInput,\n  TranslationSummary,\n  TranslationReviewFilter,\n  TranslationCorrection,\n  TranslationRowGroup,\n  TranslationReviewUndo,\n} from \"./lib/translation-review\";\nexport {\n  TranslationReviewPanel,\n  TranslationReviewEditor,\n  ReviewStatusChip,\n  TranslationProgress,\n  TranslationLocaleTabs,\n  TranslationExportButton,\n  REVIEW_STATUS_TONES,\n  DEFAULT_TRANSLATION_REVIEW_LABELS,\n} from \"./components/translation-review\";\nexport type {\n  TranslationReviewPanelProps,\n  TranslationReviewEditorProps,\n  ReviewStatusChipProps,\n  TranslationProgressProps,\n  TranslationLocaleTab,\n  TranslationLocaleTabsProps,\n  TranslationExportButtonProps,\n  TranslationReviewLabels,\n  TranslationReviewSaveInfo,\n  TranslationReviewOrigin,\n  TranslationReviewGroupBy,\n} from \"./components/translation-review\";\n// The legal pages' shell (0.19, H10): Imprint, Privacy Policy, Terms in every app.\nexport { LegalLayout, LegalSection, LegalLinks, DEFAULT_LEGAL_LABELS } from \"./components/legal\";\nexport type { LegalLabels, LegalLink, LegalLinksProps, LegalSectionProps, LegalLayoutProps } from \"./components/legal\";\n\n// ── 0.22.0: the inputs round (kastlan's, keksdose's and Kurvenschmiede's audits) ──\nexport * from \"./components/checkbox-group\";\nexport * from \"./components/one-time-code-input\";\nexport * from \"./components/language-select\";\nexport * from \"./components/tile-radio\";\nexport * from \"./components/inline-edit-field\";\nexport * from \"./components/sign-chip\";\nexport * from \"./components/country-select\";\nexport { COUNTRY_CODES, countryName } from \"./lib/countries\";\nexport * from \"./components/iban-input\";\nexport {\n  IBAN_LENGTHS,\n  compactIban,\n  formatIban,\n  ibanCheckDigits,\n  ibanProblem,\n  isValidIban,\n  isQrIban,\n} from \"./lib/iban\";\nexport type { IbanKind, IbanProblem } from \"./lib/iban\";\nexport { formatIsin, isinCheckDigit, isValidIsin } from \"./lib/isin\";\nexport * from \"./components/phone-input\";\nexport {\n  PHONE_DIAL_CODES,\n  PHONE_COUNTRIES,\n  parsePhone,\n  formatNationalPhone,\n  formatPhone,\n  isE164,\n} from \"./lib/phone\";\nexport type { PhoneCountryCode, PhoneCountry, ParsedPhone } from \"./lib/phone\";\n\n// ── 0.23.0: the apps' 0.22 adoption round (kastlan, keksdose, Kurvenschmiede) ──\n// The label strip over custom content (keksdose G8).\nexport * from \"./components/field-strip\";\n// Paste or drop a table, give each column a role (Kurvenschmiede's columns input,\n// keksdose's import map step). The lexer itself stays in `@eifi1/ui-kit/table-text`.\nexport * from \"./components/column-mapper\";\nexport {\n  assignColumnRole,\n  guessMapping,\n  missingRoles,\n  readMappedTable,\n  readTextFile,\n  roleOfColumn,\n} from \"./lib/column-mapping\";\nexport type { ColumnMapperResult, ColumnMapping, ColumnRole } from \"./lib/column-mapping\";\n"],"mappings":"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","names":[]}

package/dist/lib/strip-fade.d.ts

@@ -1,9 +1,53 @@
-import { RefObject } from 'react';
+import { CSSProperties, FocusEvent, RefObject } from 'react';
 
 declare const TAB_FADE_PX = 24;
 /**
- * Shared by Tabs' strip, AppShell's scrolling phone sub-nav and (0.24) ColumnRoleTable's
- * preview; internal, not part of the package's surface.
+ * What {@link useStripFade} can be asked to do beyond the strip it was written for.
+ */
+interface StripFadeOptions {
+    /**
+     * Keep the strip's own SCROLLBARS out of the fade (0.25, for the kit Table's and
+     * DataTable's `edgeFade`). A `mask-image` masks everything the element paints, and
+     * a classic scrollbar is painted by the element: on a desktop with always-visible
+     * scrollbars, a DataTable's vertical scrollbar sits at the inline end, inside the
+     * very band that fades whenever columns are hidden that way — it all but vanished,
+     * and the horizontal one lost its ends. With this set, the mask is opaque over
+     * each scrollbar (measured: `offsetWidth − clientWidth − borders`, its side read
+     * off `clientLeft`, which is where an RTL scrollbar on the left shows up) and the
+     * fade runs inside it, from the content's own edge. Where scrollbars take no room
+     * — phones, overlay scrollbars, `scrollbar-width: none` — nothing changes: the
+     * mask is the plain one. Off by default, so Tabs and AppShell paint exactly as
+     * they did.
+     */
+    spareScrollbars?: boolean;
+}
+/** The room the classic scrollbars of a strip take, and the borders beside them. */
+interface StripScrollbars {
+    /** Vertical scrollbar on the left (RTL in Chromium and Firefox), in px. */
+    left: number;
+    /** Vertical scrollbar on the right, in px. */
+    right: number;
+    /** Horizontal scrollbar, in px. */
+    bottom: number;
+    /** The border widths outside each of them, in px — the fade still covers a border. */
+    borderLeft: number;
+    borderRight: number;
+    borderBottom: number;
+}
+/**
+ * The `mask-image` for a strip whose `left` and/or `right` (physical) edge has
+ * content behind it, or `undefined` when neither has. Pure, for {@link useStripFade}
+ * and its tests; `scrollbars` (see {@link StripFadeOptions.spareScrollbars}) keeps
+ * those bands opaque and starts the fade at the content's edge instead of the box's.
+ */
+declare function stripFadeMask(edges: {
+    left: boolean;
+    right: boolean;
+}, scrollbars?: StripScrollbars): string | undefined;
+/**
+ * Shared by Tabs' strip, AppShell's scrolling phone sub-nav, (0.24) ColumnRoleTable's
+ * preview and (0.25) Table's and DataTable's `edgeFade`; internal, not part of the
+ * package's surface.
  *
  * Which ends of a sideways-scrolling strip have tabs cut off behind them, as the
  * `mask-image` that fades those ends out — or `undefined` while everything fits.
@@ -17,7 +61,7 @@ declare const TAB_FADE_PX = 24;
  * element, and `scrollLeft` is a magnitude here because an RTL strip counts it
  * negative from the start edge.
  */
-declare function useStripFade(ref: RefObject<HTMLElement | null>): {
+declare function useStripFade(ref: RefObject<HTMLElement | null>, options?: StripFadeOptions): {
     mask: string | undefined;
     overflow: "start" | "end" | "both" | undefined;
 };
@@ -25,7 +69,42 @@ declare function useStripFade(ref: RefObject<HTMLElement | null>): {
  * Scroll `item` into view inside `strip` — the strip only (`scrollBy` on it, never
  * `scrollIntoView`, which would scroll the page too) — far enough to clear the fade.
  * A no-op when the strip fits or the item is already clear of both edges.
+ *
+ * The edges are the strip's CONTENT edges (0.25: `clientLeft` + `clientWidth`), not
+ * its box's: a vertical scrollbar or a side border takes room the item can never be
+ * scrolled into, and {@link StripFadeOptions.spareScrollbars} starts the fade inside
+ * the scrollbar. A Tabs strip has neither, so its edges are where they were.
  */
 declare function scrollIntoStrip(strip: HTMLElement, item: HTMLElement): void;
+/**
+ * Focus landed on `focused` inside a faded table's scroller (0.25, Table and
+ * DataTable `edgeFade`): bring it clear of the fade. The browser's own focus scroll
+ * stops at the scroller's edge — under the fade, where a focused control is a few
+ * faint pixels. Its whole CELL is brought clear when the cell fits between the two
+ * fades (a select that fills its header, as ColumnRoleTable's do, then keeps the
+ * cell's padding round it too); a cell wider than that — a long note with a link at
+ * its end — would be brought in by its start and leave the link out, so then the
+ * focused element itself is what is scrolled clear.
+ */
+declare function scrollFocusIntoStrip(strip: HTMLElement, focused: HTMLElement): void;
+/** What {@link useEdgeFade} puts on the scroller; every field `undefined` while off. */
+interface EdgeFadeProps {
+    "data-overflow": "start" | "end" | "both" | undefined;
+    style: CSSProperties | undefined;
+    onFocus: ((event: FocusEvent<HTMLElement>) => void) | undefined;
+    onBlur: ((event: FocusEvent<HTMLElement>) => void) | undefined;
+}
+/**
+ * Table's and DataTable's `edgeFade` on their scroller (0.25; internal, like the rest
+ * of this file): the measured fade with the scroller's own scrollbars spared, its
+ * `data-overflow`, focus inside brought clear of it ({@link scrollFocusIntoStrip}),
+ * and — on a scroller that is itself a tab stop, as Table's is while it overflows —
+ * the fade lifted while the scroller shows the keyboard's focus outline: an inset
+ * outline lies exactly in the faded band, and its sides would fade out with the
+ * columns. Inert while `on` is false: no measuring, no listeners, no attributes.
+ *
+ * `style` is the mask alone; a caller with a style of its own spreads it over that.
+ */
+declare function useEdgeFade(scroller: RefObject<HTMLElement | null>, on: boolean): EdgeFadeProps;
 
-export { TAB_FADE_PX, scrollIntoStrip, useStripFade };
+export { type EdgeFadeProps, type StripFadeOptions, type StripScrollbars, TAB_FADE_PX, scrollFocusIntoStrip, scrollIntoStrip, stripFadeMask, useEdgeFade, useStripFade };

package/dist/lib/strip-fade.js

@@ -1,21 +1,76 @@
 "use client";
-import { useLayoutEffect, useState } from "react";
+import { useCallback, useLayoutEffect, useState } from "react";
 const TAB_FADE_PX = 24;
-function useStripFade(ref) {
-  const [edges, setEdges] = useState({ left: false, right: false, rtl: false });
+const NO_SCROLLBARS = {
+  left: 0,
+  right: 0,
+  bottom: 0,
+  borderLeft: 0,
+  borderRight: 0,
+  borderBottom: 0
+};
+const MIN_SCROLLBAR_PX = 2;
+function measureScrollbars(el, style) {
+  const px = (value) => parseFloat(value) || 0;
+  const borderLeft = px(style.borderLeftWidth);
+  const borderRight = px(style.borderRightWidth);
+  const borderTop = px(style.borderTopWidth);
+  const borderBottom = px(style.borderBottomWidth);
+  const vertical = el.offsetWidth - el.clientWidth - borderLeft - borderRight;
+  const horizontal = el.offsetHeight - el.clientHeight - borderTop - borderBottom;
+  const onLeft = el.clientLeft - borderLeft >= MIN_SCROLLBAR_PX;
+  const v = vertical >= MIN_SCROLLBAR_PX ? Math.round(vertical) : 0;
+  return {
+    left: onLeft ? v : 0,
+    right: onLeft ? 0 : v,
+    bottom: horizontal >= MIN_SCROLLBAR_PX ? Math.round(horizontal) : 0,
+    borderLeft,
+    borderRight,
+    borderBottom
+  };
+}
+const sameScrollbars = (a, b) => a.left === b.left && a.right === b.right && a.bottom === b.bottom && a.borderLeft === b.borderLeft && a.borderRight === b.borderRight && a.borderBottom === b.borderBottom;
+function stripFadeMask(edges, scrollbars = NO_SCROLLBARS) {
+  if (!edges.left && !edges.right) return void 0;
+  const F = TAB_FADE_PX;
+  const sb = scrollbars;
+  let l = edges.left ? `transparent, #000 ${F}px` : "#000";
+  let r = edges.right ? `#000 calc(100% - ${F}px), transparent` : "#000";
+  const fromRight = (px) => px === 0 ? "100%" : `calc(100% - ${px}px)`;
+  if (edges.left && sb.left > 0) {
+    const inner = sb.borderLeft + sb.left;
+    const border2 = sb.borderLeft > 0 ? `transparent ${sb.borderLeft}px, ` : "";
+    l = `${border2}#000 ${sb.borderLeft}px, #000 ${inner}px, transparent ${inner}px, #000 ${inner + F}px`;
+  }
+  if (edges.right && sb.right > 0) {
+    const inner = sb.borderRight + sb.right;
+    const border2 = sb.borderRight > 0 ? `, #000 ${fromRight(sb.borderRight)}, transparent ${fromRight(sb.borderRight)}` : "";
+    r = `#000 ${fromRight(inner + F)}, transparent ${fromRight(inner)}, #000 ${fromRight(inner)}${border2}`;
+  }
+  const across = `linear-gradient(to right, ${l}, ${r})`;
+  if (sb.bottom <= 0) return across;
+  const top = sb.borderBottom + sb.bottom;
+  const border = sb.borderBottom > 0 ? `transparent ${sb.borderBottom}px, ` : "";
+  return `${across}, linear-gradient(to top, ${border}#000 ${sb.borderBottom}px, #000 ${top}px, transparent ${top}px)`;
+}
+function useStripFade(ref, options) {
+  const spare = options?.spareScrollbars === true;
+  const [edges, setEdges] = useState({ left: false, right: false, rtl: false, scrollbars: NO_SCROLLBARS });
   useLayoutEffect(() => {
     const el = ref.current;
     if (!el) return;
     const measure = () => {
       const hidden = el.scrollWidth - el.clientWidth;
       const scrolled = Math.abs(el.scrollLeft);
-      const rtl2 = getComputedStyle(el).direction === "rtl";
+      const style = getComputedStyle(el);
+      const rtl2 = style.direction === "rtl";
       const atStart = scrolled > 1;
       const atEnd = hidden - scrolled > 1;
       const left = rtl2 ? atEnd : atStart;
       const right = rtl2 ? atStart : atEnd;
+      const scrollbars = spare && (left || right) ? measureScrollbars(el, style) : NO_SCROLLBARS;
       setEdges(
-        (prev) => prev.left === left && prev.right === right && prev.rtl === rtl2 ? prev : { left, right, rtl: rtl2 }
+        (prev) => prev.left === left && prev.right === right && prev.rtl === rtl2 && sameScrollbars(prev.scrollbars, scrollbars) ? prev : { left, right, rtl: rtl2, scrollbars }
       );
     };
     measure();
@@ -28,27 +83,70 @@ function useStripFade(ref) {
       observer?.disconnect();
     };
   });
-  if (!edges.left && !edges.right) return { mask: void 0, overflow: void 0 };
-  const l = edges.left ? `transparent, #000 ${TAB_FADE_PX}px` : "#000";
-  const r = edges.right ? `#000 calc(100% - ${TAB_FADE_PX}px), transparent` : "#000";
+  const mask = stripFadeMask(edges, edges.scrollbars);
+  if (mask === void 0) return { mask: void 0, overflow: void 0 };
   const rtl = edges.rtl;
   const start = rtl ? edges.right : edges.left;
   const end = rtl ? edges.left : edges.right;
   return {
-    mask: `linear-gradient(to right, ${l}, ${r})`,
+    mask,
     overflow: start && end ? "both" : start ? "start" : "end"
   };
 }
 function scrollIntoStrip(strip, item) {
   if (strip.scrollWidth <= strip.clientWidth) return;
-  const s = strip.getBoundingClientRect();
+  const box = strip.getBoundingClientRect();
+  const left = box.left + strip.clientLeft;
+  const right = left + strip.clientWidth;
   const t = item.getBoundingClientRect();
-  const delta = t.left < s.left + TAB_FADE_PX ? t.left - s.left - TAB_FADE_PX : t.right > s.right - TAB_FADE_PX ? t.right - s.right + TAB_FADE_PX : 0;
+  const delta = t.left < left + TAB_FADE_PX ? t.left - left - TAB_FADE_PX : t.right > right - TAB_FADE_PX ? t.right - right + TAB_FADE_PX : 0;
   if (delta !== 0) strip.scrollBy({ left: delta });
 }
+function scrollFocusIntoStrip(strip, focused) {
+  if (focused === strip || !strip.contains(focused)) return;
+  const cell = focused.closest("td, th");
+  const rect = cell && strip.contains(cell) ? cell.getBoundingClientRect() : null;
+  const fits = rect !== null && rect.right - rect.left <= strip.clientWidth - 2 * TAB_FADE_PX;
+  scrollIntoStrip(strip, fits && cell ? cell : focused);
+}
+const NO_ELEMENT = { current: null };
+const SPARE_SCROLLBARS = { spareScrollbars: true };
+function focusVisible(el) {
+  try {
+    return el.matches(":focus-visible");
+  } catch {
+    return false;
+  }
+}
+function useEdgeFade(scroller, on) {
+  const fade = useStripFade(on ? scroller : NO_ELEMENT, SPARE_SCROLLBARS);
+  const [selfFocused, setSelfFocused] = useState(false);
+  const onFocus = useCallback((event) => {
+    const box = event.currentTarget;
+    if (event.target === box) {
+      if (focusVisible(box)) setSelfFocused(true);
+      return;
+    }
+    if (event.target instanceof HTMLElement) scrollFocusIntoStrip(box, event.target);
+  }, []);
+  const onBlur = useCallback((event) => {
+    if (event.target === event.currentTarget) setSelfFocused(false);
+  }, []);
+  if (!on) return { "data-overflow": void 0, style: void 0, onFocus: void 0, onBlur: void 0 };
+  const mask = selfFocused ? void 0 : fade.mask;
+  return {
+    "data-overflow": fade.overflow,
+    style: mask ? { maskImage: mask, WebkitMaskImage: mask } : void 0,
+    onFocus,
+    onBlur
+  };
+}
 export {
   TAB_FADE_PX,
+  scrollFocusIntoStrip,
   scrollIntoStrip,
+  stripFadeMask,
+  useEdgeFade,
   useStripFade
 };
 //# sourceMappingURL=strip-fade.js.map

package/dist/lib/strip-fade.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/strip-fade.ts"],"sourcesContent":["import { useLayoutEffect, useState, type RefObject } from \"react\";\n\n// How far the fade at a scrolled strip's cut edge reaches, and how much room a tab\n// brought into view keeps from that edge so the fade never lies on top of it.\nexport const TAB_FADE_PX = 24;\n\n/**\n * Shared by Tabs' strip, AppShell's scrolling phone sub-nav and (0.24) ColumnRoleTable's\n * preview; internal, not part of the package's surface.\n *\n * Which ends of a sideways-scrolling strip have tabs cut off behind them, as the\n * `mask-image` that fades those ends out — or `undefined` while everything fits.\n *\n * A strip that overflowed used to stop dead at its edge: the last tab sliced through\n * mid-word, and nothing on a phone (whose scrollbars are overlays that only show\n * while you drag) said there was more to reach. A fade is the cue — the letters\n * thin out rather than end — and it is measured, not assumed, so a strip that fits\n * is painted exactly as before. Physical `left`/`right` in the gradient, because\n * `mask-image` has no logical directions; the reading direction is read from the\n * element, and `scrollLeft` is a magnitude here because an RTL strip counts it\n * negative from the start edge.\n */\nexport function useStripFade(\n  ref: RefObject<HTMLElement | null>,\n): { mask: string | undefined; overflow: \"start\" | \"end\" | \"both\" | undefined } {\n  const [edges, setEdges] = useState({ left: false, right: false, rtl: false });\n  useLayoutEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const measure = () => {\n      const hidden = el.scrollWidth - el.clientWidth;\n      const scrolled = Math.abs(el.scrollLeft);\n      const rtl = getComputedStyle(el).direction === \"rtl\";\n      const atStart = scrolled > 1;\n      const atEnd = hidden - scrolled > 1;\n      const left = rtl ? atEnd : atStart;\n      const right = rtl ? atStart : atEnd;\n      setEdges((prev) =>\n        prev.left === left && prev.right === right && prev.rtl === rtl ? prev : { left, right, rtl },\n      );\n    };\n    measure();\n    el.addEventListener(\"scroll\", measure, { passive: true });\n    const observer = typeof ResizeObserver === \"undefined\" ? null : new ResizeObserver(measure);\n    observer?.observe(el);\n    // The tabs, too: a label or a badge that grows changes the overflow without\n    // resizing the strip's own box.\n    for (const child of Array.from(el.children)) observer?.observe(child);\n    return () => {\n      el.removeEventListener(\"scroll\", measure);\n      observer?.disconnect();\n    };\n  });\n  if (!edges.left && !edges.right) return { mask: undefined, overflow: undefined };\n  const l = edges.left ? `transparent, #000 ${TAB_FADE_PX}px` : \"#000\";\n  const r = edges.right ? `#000 calc(100% - ${TAB_FADE_PX}px), transparent` : \"#000\";\n  const rtl = edges.rtl;\n  const start = rtl ? edges.right : edges.left;\n  const end = rtl ? edges.left : edges.right;\n  return {\n    mask: `linear-gradient(to right, ${l}, ${r})`,\n    overflow: start && end ? \"both\" : start ? \"start\" : \"end\",\n  };\n}\n\n/**\n * Scroll `item` into view inside `strip` — the strip only (`scrollBy` on it, never\n * `scrollIntoView`, which would scroll the page too) — far enough to clear the fade.\n * A no-op when the strip fits or the item is already clear of both edges.\n */\nexport function scrollIntoStrip(strip: HTMLElement, item: HTMLElement): void {\n  if (strip.scrollWidth <= strip.clientWidth) return;\n  const s = strip.getBoundingClientRect();\n  const t = item.getBoundingClientRect();\n  const delta =\n    t.left < s.left + TAB_FADE_PX\n      ? t.left - s.left - TAB_FADE_PX\n      : t.right > s.right - TAB_FADE_PX\n        ? t.right - s.right + TAB_FADE_PX\n        : 0;\n  if (delta !== 0) strip.scrollBy({ left: delta });\n}\n"],"mappings":";AAAA,SAAS,iBAAiB,gBAAgC;AAInD,MAAM,cAAc;AAkBpB,SAAS,aACd,KAC8E;AAC9E,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,EAAE,MAAM,OAAO,OAAO,OAAO,KAAK,MAAM,CAAC;AAC5E,kBAAgB,MAAM;AACpB,UAAM,KAAK,IAAI;AACf,QAAI,CAAC,GAAI;AACT,UAAM,UAAU,MAAM;AACpB,YAAM,SAAS,GAAG,cAAc,GAAG;AACnC,YAAM,WAAW,KAAK,IAAI,GAAG,UAAU;AACvC,YAAMA,OAAM,iBAAiB,EAAE,EAAE,cAAc;AAC/C,YAAM,UAAU,WAAW;AAC3B,YAAM,QAAQ,SAAS,WAAW;AAClC,YAAM,OAAOA,OAAM,QAAQ;AAC3B,YAAM,QAAQA,OAAM,UAAU;AAC9B;AAAA,QAAS,CAAC,SACR,KAAK,SAAS,QAAQ,KAAK,UAAU,SAAS,KAAK,QAAQA,OAAM,OAAO,EAAE,MAAM,OAAO,KAAAA,KAAI;AAAA,MAC7F;AAAA,IACF;AACA,YAAQ;AACR,OAAG,iBAAiB,UAAU,SAAS,EAAE,SAAS,KAAK,CAAC;AACxD,UAAM,WAAW,OAAO,mBAAmB,cAAc,OAAO,IAAI,eAAe,OAAO;AAC1F,cAAU,QAAQ,EAAE;AAGpB,eAAW,SAAS,MAAM,KAAK,GAAG,QAAQ,EAAG,WAAU,QAAQ,KAAK;AACpE,WAAO,MAAM;AACX,SAAG,oBAAoB,UAAU,OAAO;AACxC,gBAAU,WAAW;AAAA,IACvB;AAAA,EACF,CAAC;AACD,MAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,MAAO,QAAO,EAAE,MAAM,QAAW,UAAU,OAAU;AAC/E,QAAM,IAAI,MAAM,OAAO,qBAAqB,WAAW,OAAO;AAC9D,QAAM,IAAI,MAAM,QAAQ,oBAAoB,WAAW,qBAAqB;AAC5E,QAAM,MAAM,MAAM;AAClB,QAAM,QAAQ,MAAM,MAAM,QAAQ,MAAM;AACxC,QAAM,MAAM,MAAM,MAAM,OAAO,MAAM;AACrC,SAAO;AAAA,IACL,MAAM,6BAA6B,CAAC,KAAK,CAAC;AAAA,IAC1C,UAAU,SAAS,MAAM,SAAS,QAAQ,UAAU;AAAA,EACtD;AACF;AAOO,SAAS,gBAAgB,OAAoB,MAAyB;AAC3E,MAAI,MAAM,eAAe,MAAM,YAAa;AAC5C,QAAM,IAAI,MAAM,sBAAsB;AACtC,QAAM,IAAI,KAAK,sBAAsB;AACrC,QAAM,QACJ,EAAE,OAAO,EAAE,OAAO,cACd,EAAE,OAAO,EAAE,OAAO,cAClB,EAAE,QAAQ,EAAE,QAAQ,cAClB,EAAE,QAAQ,EAAE,QAAQ,cACpB;AACR,MAAI,UAAU,EAAG,OAAM,SAAS,EAAE,MAAM,MAAM,CAAC;AACjD;","names":["rtl"]}
+{"version":3,"sources":["../../src/lib/strip-fade.ts"],"sourcesContent":["import { useCallback, useLayoutEffect, useState } from \"react\";\nimport type { CSSProperties, FocusEvent, RefObject } from \"react\";\n\n// How far the fade at a scrolled strip's cut edge reaches, and how much room a tab\n// brought into view keeps from that edge so the fade never lies on top of it.\nexport const TAB_FADE_PX = 24;\n\n/**\n * What {@link useStripFade} can be asked to do beyond the strip it was written for.\n */\nexport interface StripFadeOptions {\n  /**\n   * Keep the strip's own SCROLLBARS out of the fade (0.25, for the kit Table's and\n   * DataTable's `edgeFade`). A `mask-image` masks everything the element paints, and\n   * a classic scrollbar is painted by the element: on a desktop with always-visible\n   * scrollbars, a DataTable's vertical scrollbar sits at the inline end, inside the\n   * very band that fades whenever columns are hidden that way — it all but vanished,\n   * and the horizontal one lost its ends. With this set, the mask is opaque over\n   * each scrollbar (measured: `offsetWidth − clientWidth − borders`, its side read\n   * off `clientLeft`, which is where an RTL scrollbar on the left shows up) and the\n   * fade runs inside it, from the content's own edge. Where scrollbars take no room\n   * — phones, overlay scrollbars, `scrollbar-width: none` — nothing changes: the\n   * mask is the plain one. Off by default, so Tabs and AppShell paint exactly as\n   * they did.\n   */\n  spareScrollbars?: boolean;\n}\n\n/** The room the classic scrollbars of a strip take, and the borders beside them. */\nexport interface StripScrollbars {\n  /** Vertical scrollbar on the left (RTL in Chromium and Firefox), in px. */\n  left: number;\n  /** Vertical scrollbar on the right, in px. */\n  right: number;\n  /** Horizontal scrollbar, in px. */\n  bottom: number;\n  /** The border widths outside each of them, in px — the fade still covers a border. */\n  borderLeft: number;\n  borderRight: number;\n  borderBottom: number;\n}\n\nconst NO_SCROLLBARS: StripScrollbars = {\n  left: 0,\n  right: 0,\n  bottom: 0,\n  borderLeft: 0,\n  borderRight: 0,\n  borderBottom: 0,\n};\n\n// A scrollbar is never this thin; anything under it is sub-pixel rounding between\n// `offsetWidth` and `clientWidth`, not a scrollbar.\nconst MIN_SCROLLBAR_PX = 2;\n\nfunction measureScrollbars(el: HTMLElement, style: CSSStyleDeclaration): StripScrollbars {\n  const px = (value: string) => parseFloat(value) || 0;\n  const borderLeft = px(style.borderLeftWidth);\n  const borderRight = px(style.borderRightWidth);\n  const borderTop = px(style.borderTopWidth);\n  const borderBottom = px(style.borderBottomWidth);\n  const vertical = el.offsetWidth - el.clientWidth - borderLeft - borderRight;\n  const horizontal = el.offsetHeight - el.clientHeight - borderTop - borderBottom;\n  const onLeft = el.clientLeft - borderLeft >= MIN_SCROLLBAR_PX;\n  const v = vertical >= MIN_SCROLLBAR_PX ? Math.round(vertical) : 0;\n  return {\n    left: onLeft ? v : 0,\n    right: onLeft ? 0 : v,\n    bottom: horizontal >= MIN_SCROLLBAR_PX ? Math.round(horizontal) : 0,\n    borderLeft,\n    borderRight,\n    borderBottom,\n  };\n}\n\nconst sameScrollbars = (a: StripScrollbars, b: StripScrollbars) =>\n  a.left === b.left &&\n  a.right === b.right &&\n  a.bottom === b.bottom &&\n  a.borderLeft === b.borderLeft &&\n  a.borderRight === b.borderRight &&\n  a.borderBottom === b.borderBottom;\n\n/**\n * The `mask-image` for a strip whose `left` and/or `right` (physical) edge has\n * content behind it, or `undefined` when neither has. Pure, for {@link useStripFade}\n * and its tests; `scrollbars` (see {@link StripFadeOptions.spareScrollbars}) keeps\n * those bands opaque and starts the fade at the content's edge instead of the box's.\n */\nexport function stripFadeMask(\n  edges: { left: boolean; right: boolean },\n  scrollbars: StripScrollbars = NO_SCROLLBARS,\n): string | undefined {\n  if (!edges.left && !edges.right) return undefined;\n  const F = TAB_FADE_PX;\n  const sb = scrollbars;\n  // The plain mask, as Tabs and AppShell have always drawn it.\n  let l = edges.left ? `transparent, #000 ${F}px` : \"#000\";\n  let r = edges.right ? `#000 calc(100% - ${F}px), transparent` : \"#000\";\n  const fromRight = (px: number) => (px === 0 ? \"100%\" : `calc(100% - ${px}px)`);\n  // A vertical scrollbar on a FADED side: the border outside it fades with the rest\n  // of that edge, the scrollbar itself stays whole, and the fade starts inside it.\n  if (edges.left && sb.left > 0) {\n    const inner = sb.borderLeft + sb.left;\n    const border = sb.borderLeft > 0 ? `transparent ${sb.borderLeft}px, ` : \"\";\n    l = `${border}#000 ${sb.borderLeft}px, #000 ${inner}px, transparent ${inner}px, #000 ${inner + F}px`;\n  }\n  if (edges.right && sb.right > 0) {\n    const inner = sb.borderRight + sb.right;\n    const border =\n      sb.borderRight > 0 ? `, #000 ${fromRight(sb.borderRight)}, transparent ${fromRight(sb.borderRight)}` : \"\";\n    r = `#000 ${fromRight(inner + F)}, transparent ${fromRight(inner)}, #000 ${fromRight(inner)}${border}`;\n  }\n  const across = `linear-gradient(to right, ${l}, ${r})`;\n  if (sb.bottom <= 0) return across;\n  // The horizontal scrollbar, as a second layer: layers ADD, so this band is opaque\n  // over its whole width whatever the first layer says there.\n  const top = sb.borderBottom + sb.bottom;\n  const border = sb.borderBottom > 0 ? `transparent ${sb.borderBottom}px, ` : \"\";\n  return `${across}, linear-gradient(to top, ${border}#000 ${sb.borderBottom}px, #000 ${top}px, transparent ${top}px)`;\n}\n\n/**\n * Shared by Tabs' strip, AppShell's scrolling phone sub-nav, (0.24) ColumnRoleTable's\n * preview and (0.25) Table's and DataTable's `edgeFade`; internal, not part of the\n * package's surface.\n *\n * Which ends of a sideways-scrolling strip have tabs cut off behind them, as the\n * `mask-image` that fades those ends out — or `undefined` while everything fits.\n *\n * A strip that overflowed used to stop dead at its edge: the last tab sliced through\n * mid-word, and nothing on a phone (whose scrollbars are overlays that only show\n * while you drag) said there was more to reach. A fade is the cue — the letters\n * thin out rather than end — and it is measured, not assumed, so a strip that fits\n * is painted exactly as before. Physical `left`/`right` in the gradient, because\n * `mask-image` has no logical directions; the reading direction is read from the\n * element, and `scrollLeft` is a magnitude here because an RTL strip counts it\n * negative from the start edge.\n */\nexport function useStripFade(\n  ref: RefObject<HTMLElement | null>,\n  options?: StripFadeOptions,\n): { mask: string | undefined; overflow: \"start\" | \"end\" | \"both\" | undefined } {\n  const spare = options?.spareScrollbars === true;\n  const [edges, setEdges] = useState({ left: false, right: false, rtl: false, scrollbars: NO_SCROLLBARS });\n  useLayoutEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const measure = () => {\n      const hidden = el.scrollWidth - el.clientWidth;\n      const scrolled = Math.abs(el.scrollLeft);\n      const style = getComputedStyle(el);\n      const rtl = style.direction === \"rtl\";\n      const atStart = scrolled > 1;\n      const atEnd = hidden - scrolled > 1;\n      const left = rtl ? atEnd : atStart;\n      const right = rtl ? atStart : atEnd;\n      const scrollbars = spare && (left || right) ? measureScrollbars(el, style) : NO_SCROLLBARS;\n      setEdges((prev) =>\n        prev.left === left && prev.right === right && prev.rtl === rtl && sameScrollbars(prev.scrollbars, scrollbars)\n          ? prev\n          : { left, right, rtl, scrollbars },\n      );\n    };\n    measure();\n    el.addEventListener(\"scroll\", measure, { passive: true });\n    const observer = typeof ResizeObserver === \"undefined\" ? null : new ResizeObserver(measure);\n    observer?.observe(el);\n    // The tabs, too: a label or a badge that grows changes the overflow without\n    // resizing the strip's own box.\n    for (const child of Array.from(el.children)) observer?.observe(child);\n    return () => {\n      el.removeEventListener(\"scroll\", measure);\n      observer?.disconnect();\n    };\n  });\n  const mask = stripFadeMask(edges, edges.scrollbars);\n  if (mask === undefined) return { mask: undefined, overflow: undefined };\n  const rtl = edges.rtl;\n  const start = rtl ? edges.right : edges.left;\n  const end = rtl ? edges.left : edges.right;\n  return {\n    mask,\n    overflow: start && end ? \"both\" : start ? \"start\" : \"end\",\n  };\n}\n\n/**\n * Scroll `item` into view inside `strip` — the strip only (`scrollBy` on it, never\n * `scrollIntoView`, which would scroll the page too) — far enough to clear the fade.\n * A no-op when the strip fits or the item is already clear of both edges.\n *\n * The edges are the strip's CONTENT edges (0.25: `clientLeft` + `clientWidth`), not\n * its box's: a vertical scrollbar or a side border takes room the item can never be\n * scrolled into, and {@link StripFadeOptions.spareScrollbars} starts the fade inside\n * the scrollbar. A Tabs strip has neither, so its edges are where they were.\n */\nexport function scrollIntoStrip(strip: HTMLElement, item: HTMLElement): void {\n  if (strip.scrollWidth <= strip.clientWidth) return;\n  const box = strip.getBoundingClientRect();\n  const left = box.left + strip.clientLeft;\n  const right = left + strip.clientWidth;\n  const t = item.getBoundingClientRect();\n  const delta =\n    t.left < left + TAB_FADE_PX\n      ? t.left - left - TAB_FADE_PX\n      : t.right > right - TAB_FADE_PX\n        ? t.right - right + TAB_FADE_PX\n        : 0;\n  if (delta !== 0) strip.scrollBy({ left: delta });\n}\n\n/**\n * Focus landed on `focused` inside a faded table's scroller (0.25, Table and\n * DataTable `edgeFade`): bring it clear of the fade. The browser's own focus scroll\n * stops at the scroller's edge — under the fade, where a focused control is a few\n * faint pixels. Its whole CELL is brought clear when the cell fits between the two\n * fades (a select that fills its header, as ColumnRoleTable's do, then keeps the\n * cell's padding round it too); a cell wider than that — a long note with a link at\n * its end — would be brought in by its start and leave the link out, so then the\n * focused element itself is what is scrolled clear.\n */\nexport function scrollFocusIntoStrip(strip: HTMLElement, focused: HTMLElement): void {\n  if (focused === strip || !strip.contains(focused)) return;\n  const cell = focused.closest<HTMLElement>(\"td, th\");\n  const rect = cell && strip.contains(cell) ? cell.getBoundingClientRect() : null;\n  const fits = rect !== null && rect.right - rect.left <= strip.clientWidth - 2 * TAB_FADE_PX;\n  scrollIntoStrip(strip, fits && cell ? cell : focused);\n}\n\n/** `edgeFade` off: {@link useStripFade} gets no element and measures nothing. */\nconst NO_ELEMENT: RefObject<HTMLElement | null> = { current: null };\nconst SPARE_SCROLLBARS: StripFadeOptions = { spareScrollbars: true };\n\n/** `:focus-visible`, or `false` where the engine cannot say. */\nfunction focusVisible(el: Element): boolean {\n  try {\n    return el.matches(\":focus-visible\");\n  } catch {\n    return false;\n  }\n}\n\n/** What {@link useEdgeFade} puts on the scroller; every field `undefined` while off. */\nexport interface EdgeFadeProps {\n  \"data-overflow\": \"start\" | \"end\" | \"both\" | undefined;\n  style: CSSProperties | undefined;\n  onFocus: ((event: FocusEvent<HTMLElement>) => void) | undefined;\n  onBlur: ((event: FocusEvent<HTMLElement>) => void) | undefined;\n}\n\n/**\n * Table's and DataTable's `edgeFade` on their scroller (0.25; internal, like the rest\n * of this file): the measured fade with the scroller's own scrollbars spared, its\n * `data-overflow`, focus inside brought clear of it ({@link scrollFocusIntoStrip}),\n * and — on a scroller that is itself a tab stop, as Table's is while it overflows —\n * the fade lifted while the scroller shows the keyboard's focus outline: an inset\n * outline lies exactly in the faded band, and its sides would fade out with the\n * columns. Inert while `on` is false: no measuring, no listeners, no attributes.\n *\n * `style` is the mask alone; a caller with a style of its own spreads it over that.\n */\nexport function useEdgeFade(scroller: RefObject<HTMLElement | null>, on: boolean): EdgeFadeProps {\n  const fade = useStripFade(on ? scroller : NO_ELEMENT, SPARE_SCROLLBARS);\n  const [selfFocused, setSelfFocused] = useState(false);\n  const onFocus = useCallback((event: FocusEvent<HTMLElement>) => {\n    const box = event.currentTarget;\n    if (event.target === box) {\n      // A click in the table's text focuses the scroller too (it is the nearest tab\n      // stop); only the keyboard's focus draws an outline worth lifting the fade for.\n      if (focusVisible(box)) setSelfFocused(true);\n      return;\n    }\n    if (event.target instanceof HTMLElement) scrollFocusIntoStrip(box, event.target);\n  }, []);\n  const onBlur = useCallback((event: FocusEvent<HTMLElement>) => {\n    if (event.target === event.currentTarget) setSelfFocused(false);\n  }, []);\n  if (!on) return { \"data-overflow\": undefined, style: undefined, onFocus: undefined, onBlur: undefined };\n  const mask = selfFocused ? undefined : fade.mask;\n  return {\n    \"data-overflow\": fade.overflow,\n    style: mask ? { maskImage: mask, WebkitMaskImage: mask } : undefined,\n    onFocus,\n    onBlur,\n  };\n}\n"],"mappings":"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","names":["border","rtl"]}

package/dist/lib/translation-review.d.ts

@@ -199,9 +199,53 @@ interface TranslationReviewFilter {
 }
 declare const DEFAULT_TRANSLATION_REVIEW_FILTER: TranslationReviewFilter;
 declare function filterTranslationRows(rows: readonly TranslationRow[], filter: Partial<TranslationReviewFilter>): TranslationRow[];
+/** One group of rows — an area, a source — and how they stand. */
+interface TranslationRowGroup {
+    key: string;
+    rows: TranslationRow[];
+    summary: TranslationSummary;
+}
+/**
+ * Rows in groups, each group where its first row is — the reference's order, so the areas
+ * read the way the app's authors wrote the bundle — and each group's rows in their own
+ * order. keksdose live #377: a reviewer on a phone works area by area ("the budget
+ * strings, then the legal ones"), and a flat list of 3859 rows is not a way to see
+ * where an area stands.
+ *
+ * `groupOf` names a row's group: `(row) => row.namespace` for the areas,
+ * `(row) => row.source` for kastlan's screen texts and documents.
+ */
+declare function groupTranslationRows(rows: readonly TranslationRow[], groupOf: (row: TranslationRow) => string): TranslationRowGroup[];
+/**
+ * The rows a group's "Approve the unreviewed" takes: the ones nobody has given a verdict
+ * and that have a text. Not `changed` — a string that moved since it was judged asks to
+ * be READ again, which a bulk action is the opposite of — and not `missing`, which has
+ * nothing to approve.
+ */
+declare function unreviewedRows(rows: readonly TranslationRow[]): TranslationRow[];
 /** What gets stored for a verdict: the wording it was given on, so a later change of the
  *  string (or of its reference) shows up as `changed`. */
 declare function reviewWrite(row: TranslationRow, verdict: TranslationVerdict, note?: string | null, suggestion?: string | null): TranslationReviewWrite;
+/** What takes a set of verdicts back: see {@link reviewUndo}. */
+interface TranslationReviewUndo {
+    /** The verdicts the rows had before, to store again — each on the wording it was
+     *  given on, so a row that was `changed` reads `changed` again. */
+    writes: TranslationReviewWrite[];
+    /** The rows that had no verdict before: back to unreviewed. */
+    clears: TranslationReviewKey[];
+}
+/**
+ * How to take back what was just said about `rows` — the rows AS THEY WERE before the
+ * write, with the verdicts they carried then. The panel's Undo toast (0.25, keksdose live
+ * #377) runs it: a swipe on a phone approves in one movement, and a movement can be a
+ * mistake.
+ *
+ * A row that had a verdict gets it stored again (its note, its suggestion, the wording it
+ * was judged on); one that had none is cleared. The server stamps the restored verdict
+ * with the person undoing and the time, as it stamps every write — the contract has no
+ * way to write a verdict in somebody else's name, and should not.
+ */
+declare function reviewUndo(rows: readonly TranslationRow[]): TranslationReviewUndo;
 /** The app's cached verdict list with `written` in place of what was said before — a
  *  save answers with the rows it wrote, so a page patches its copy instead of
  *  downloading every verdict again after each click. Any spelling with `locale` and
@@ -229,4 +273,4 @@ interface TranslationCorrection {
  *  string included), as the export file lists them. */
 declare function translationCorrections(rows: readonly TranslationRow[]): TranslationCorrection[];
 
-export { type ApiTranslationReview, type ApiTranslationReviewWrite, DEFAULT_TRANSLATION_REVIEW_FILTER, REVIEW_STATUSES, type ReviewStatus, type TranslationCorrection, type TranslationReview, type TranslationReviewFilter, type TranslationReviewKey, type TranslationReviewWrite, type TranslationRow, type TranslationRowsInput, type TranslationSummary, type TranslationVerdict, dropReviews, filterTranslationRows, flattenStrings, fromApiReview, keyInArea, keyInAreas, keyNamespace, mergeReviews, placeholderMismatch, placeholderTokens, reviewStatus, reviewWrite, summariseRows, toApiWrite, translationCorrections, translationRows };
+export { type ApiTranslationReview, type ApiTranslationReviewWrite, DEFAULT_TRANSLATION_REVIEW_FILTER, REVIEW_STATUSES, type ReviewStatus, type TranslationCorrection, type TranslationReview, type TranslationReviewFilter, type TranslationReviewKey, type TranslationReviewUndo, type TranslationReviewWrite, type TranslationRow, type TranslationRowGroup, type TranslationRowsInput, type TranslationSummary, type TranslationVerdict, dropReviews, filterTranslationRows, flattenStrings, fromApiReview, groupTranslationRows, keyInArea, keyInAreas, keyNamespace, mergeReviews, placeholderMismatch, placeholderTokens, reviewStatus, reviewUndo, reviewWrite, summariseRows, toApiWrite, translationCorrections, translationRows, unreviewedRows };

package/dist/lib/translation-review.js

@@ -138,6 +138,19 @@ function filterTranslationRows(rows, filter) {
     (row) => (f.status === "all" || row.status === f.status) && (f.source === "all" || row.source === f.source) && (f.namespace === "all" || row.namespace === f.namespace) && (!f.placeholdersOnly || row.placeholderMismatch) && (!q || row.key.toLowerCase().includes(q) || row.text.toLowerCase().includes(q) || row.reference.toLowerCase().includes(q))
   );
 }
+function groupTranslationRows(rows, groupOf) {
+  const byKey = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const key = groupOf(row);
+    const list = byKey.get(key);
+    if (list) list.push(row);
+    else byKey.set(key, [row]);
+  }
+  return [...byKey].map(([key, list]) => ({ key, rows: list, summary: summariseRows(list) }));
+}
+function unreviewedRows(rows) {
+  return rows.filter((row) => row.status === "unreviewed" && row.text !== "");
+}
 function reviewWrite(row, verdict, note = null, suggestion = null) {
   return {
     locale: row.locale,
@@ -149,6 +162,27 @@ function reviewWrite(row, verdict, note = null, suggestion = null) {
     suggestion
   };
 }
+function reviewUndo(rows) {
+  const writes = [];
+  const clears = [];
+  for (const row of rows) {
+    const before = row.review;
+    if (!before) {
+      clears.push({ locale: row.locale, key: row.key });
+      continue;
+    }
+    writes.push({
+      locale: row.locale,
+      key: row.key,
+      text: before.text,
+      referenceText: before.referenceText,
+      verdict: before.verdict,
+      note: before.note,
+      suggestion: before.suggestion
+    });
+  }
+  return { writes, clears };
+}
 function mergeReviews(prev, written) {
   const id = (r) => `${r.locale}|${r.key}`;
   const replaced = new Set(written.map(id));
@@ -178,6 +212,7 @@ export {
   filterTranslationRows,
   flattenStrings,
   fromApiReview,
+  groupTranslationRows,
   keyInArea,
   keyInAreas,
   keyNamespace,
@@ -185,10 +220,12 @@ export {
   placeholderMismatch,
   placeholderTokens,
   reviewStatus,
+  reviewUndo,
   reviewWrite,
   summariseRows,
   toApiWrite,
   translationCorrections,
-  translationRows
+  translationRows,
+  unreviewedRows
 };
 //# sourceMappingURL=translation-review.js.map