@eifi1/ui-kit 0.54.0 → 0.56.0

package/README.md

@@ -28,8 +28,8 @@ with its own Tailwind config.
 ## Compatibility with server-kit
 
 The backend half, [`eifi1-server-kit`](https://github.com/Eifi1/server-kit), is a separate
-package with its own version and changelog. **ui-kit 0.51 ↔ server-kit 0.20**: this release
-is tested against server-kit 0.20.0's API export (the showcase's Server kit pages and the
+package with its own version and changelog. **ui-kit 0.55 ↔ server-kit 0.21**: this release
+is tested against server-kit 0.21.0's API export (the showcase's Server kit pages and the
 vocabulary test, `showcase/src/__tests__/server-kit-vocabularies.test.ts`).
 
 ## Documentation
@@ -44,8 +44,8 @@ vocabulary test, `showcase/src/__tests__/server-kit-vocabularies.test.ts`).
 | [Issues](https://github.com/Eifi1/ui-kit/issues) | Bugs and requests |
 
 The links are absolute because only this README is in the npm tarball — `files` ships
-`dist`, `src`, `tokens.css` and `LICENSE`, so a reader who arrived from npmjs.com has none
-of the others on disk and a relative link would be a 404.
+`dist`, `tokens.css` and `LICENSE`, so a reader who arrived from npmjs.com has none of the
+others on disk and a relative link would be a 404.
 
 Kurvenschmiede was called **lenkbank** until 2026-10-01 (repository `Eifi1/kurvenschmiede`,
 formerly `Eifi1/lenkbank`). The changelog, older adoption notes and code comments that cite
@@ -159,8 +159,9 @@ and 216,056 B (−181 rules, −11 KB), exactly what the `.js` files give on the
 `.js` holds every class a component renders. **A glob such as `dist/**/*.js` does not
 narrow the scan**: an explicit `@source` into an ignored folder un-ignores the folder, and
 Tailwind's root detection then walks every file in it, so the stylesheet comes out
-byte-identical to the directory line. Exclude with `@source not` instead. Don't scan the
-tarball's `src` either: it is the commented source, with the same extra rules.
+byte-identical to the directory line. Exclude with `@source not` instead. The tarball has
+shipped no `src` since 0.55 (the source maps carry the source): an `@source` still pointing
+there scans nothing, silently: replace it with the pair above.
 
 ### 3. Appearance stores (own persistence keys)
 
@@ -221,7 +222,7 @@ re-skins the kit by changing values rather than by forking components. The famil
 |---|---|---|
 | **Palette** | `--bg-page` `--bg-surface` `--bg-surface-2` `--border` `--text-primary` `--text-secondary` `--text-muted` `--brand` `--brand-hover` `--brand-contrast` `--money-income` `--money-expense` `--money-net` `--money-neutral` `--chart-1…9` | `applyTokenSet()`, written inline on `<html>` from the active `PalettePreset` (More contrast steps four of them; in light also the well and the four money colours) |
 | **Derived** | `--text-placeholder` `--bg-hover` `--bg-active` `--bg-inverse` `--text-inverse` `--border-strong` `--brand-bg` `--brand-bg-hover` `--brand-muted`, and `--neutral` (`--text-muted` as a fill) | `color-mix()` or `var()` in `tokens.css`, from the layer above — so they follow the preset with no preset having to list them |
-| **Semantic** | `--danger*` `--warning*` `--info*` `--success*` — each the colour, `-contrast`, `-border` and `-bg`; danger and warning also `-border-strong`, danger `-hover` — and `--status-synced/-pending/-edited/-error` | literals in `tokens.css`, per theme; in light under More contrast the four colours and `--status-edited` deepen for the darker well |
+| **Semantic** | `--danger*` `--warning*` `--info*` `--success*` — each the colour, `-contrast`, `-border` and `-bg`; danger and warning also `-border-strong`, danger `-hover` | literals in `tokens.css`, per theme; in light under More contrast the four colours deepen for the darker well |
 | **Categorical hues** | `--hue-blue` `--hue-indigo` `--hue-purple` `--hue-teal` `--hue-orange`, each with `-contrast`, `-border` and `-bg` | literals in `tokens.css`, per theme — values that mean only "a different value" (a status enum), at the semantic family's weight |
 | **Fill foregrounds** | `<fill>-contrast`: the text ON a fill — `--brand-contrast`, `--money-income-contrast` … `--money-neutral-contrast`, `--neutral-contrast`, and each tone's and hue's `-contrast` | with their family; money is white in light and the page in dark |
 | **Media** | `--media-ink` `--media-scrim` `--media-scrim-hover` | literals, the SAME in both themes: controls drawn on a photo or a camera picture, whose background is the picture, not the page |
@@ -263,7 +264,7 @@ name with the property's own prefix dropped (`--bg-surface` → `bg-surface`,
 The names are **property-scoped**: a text role makes a `text-*` utility and nothing else,
 so `bg-muted` does not exist and a role cannot land on the wrong property by accident. An
 app's own `--color-*` names (shadcn-style) do not collide with them. Keep `[var(--…)]` for a
-role with no utility: the chart colours and `--status-*`. The ring offsets
+role with no utility: the chart colours. The ring offsets
 (`ring-offset-surface`, `ring-offset-page`) and the money colours (`text-money-income`,
 `bg-money-expense` …, the table below) are utilities since 0.34 and take variants, unlike
 the plain money classes further down. The kit's own
@@ -376,9 +377,9 @@ property has a utility for the role, and names it. It reads every string literal
 template-literal part, so a JSX `className`, a `cn()` / `clsx()` argument and a class constant
 alike. Where one utility fits, `eslint --fix` writes it and keeps the variants and the opacity:
 `hover:text-[var(--text-muted)]/70` → `hover:text-muted/70`. A token with no utility on that
-property is left alone (`text-[var(--chart-1)]`, `--status-*`, `bg-[var(--border)]` as a
-divider), and so are comments. The rule reads the table above, so a role that gains a utility is
-flagged from the release that adds it.
+property is left alone (`text-[var(--chart-1)]`, `bg-[var(--border)]` as a divider), and so
+are comments. The rule reads the table above, so a role that gains a utility is flagged from
+the release that adds it.
 
 ```js
 // eslint.config.js
@@ -405,8 +406,8 @@ and everything sized in rem (Tailwind's spacing and type) grows with it.
 `data-contrast="more"` is More contrast, from the setting or from `prefers-contrast: more`
 on "System"; it steps the colour tokens in JavaScript and widens `--focus-ring-width`. In
 light it also darkens the well (`--bg-surface-2`, 10 % ink into the card) and deepens the
-money, status, teal, orange and `--status-edited` colours and `--bg-active` so they keep
-their contrast on it; dark keeps its well. A link button's and TextLink's brand reads
+money, status, teal and orange colours and `--bg-active` so they keep their contrast on it;
+dark keeps its well. A link button's and TextLink's brand reads
 `--brand-muted` (the brand as text) under it, in both modes. The
 stores in [Wiring](#wiring) put both attributes there; the attribute names are frozen.
 
@@ -461,7 +462,7 @@ because they answer different questions.
 
 | System | Tokens | The question it answers |
 |---|---|---|
-| **Semantic UI** | `--danger*` `--warning*` `--info*` `--success*`, `--status-*` | *What does this mean?* Danger is red because every other interface the reader has used made it red. Fixed meanings, so they live in `tokens.css` and are **not** part of `TokenSet` — a destructive action must not change colour because somebody picked a different preset. |
+| **Semantic UI** | `--danger*` `--warning*` `--info*` `--success*` | *What does this mean?* Danger is red because every other interface the reader has used made it red. Fixed meanings, so they live in `tokens.css` and are **not** part of `TokenSet` — a destructive action must not change colour because somebody picked a different preset. |
 | **Semantic data** | `--money-income` `--money-expense` `--money-net` `--money-neutral` | *Which direction is this number?* Never red/green: that pair is exactly the axis dichromacy collapses. Always paired with a `+`/`−` or an arrow at the call site, so colour is never the only signal. |
 | **Categorical chart** | `--chart-1` … `--chart-8` (`--chart-9` repeats slot 1) | *Which series is this?* No meaning and no order — eight hues that must stay separable from each other: anyplot's "Imprint" set (0.49; Paul Tol's "Muted" is the `paul-tol` preset), the same in light and dark, CVD-safe across protan/deutan/tritan. `paletteFor(i)` returns the CSS var (cycling eight, series 1 always the green; `{ order: "cvd" }` for anyplot's CVD order), so a Recharts series is theme-aware for free. A hue under 3:1 on the ground gets a 1px ink edge on bars, areas and treemap tiles (`chartEdge`) under More contrast; at Standard contrast no mark gets a per-hue edge (`edges="auto"`, Treemap 0.51.6, SeriesChart 0.52). A Treemap node with `children` is a group, drawn as a labelled frame round its tiles (0.52): its `fill` is its tiles' default, `shade` mixes a hue into the surface as a measured hex, `onGroupClick` makes the frames buttons, and a group's name band shows once the group is 44px wide and 61px tall at Normal text. A group's frame is given area of its own, so a tile's area is its share of the whole in any group. |
 | **Chart inks** | `--chart-ink` `--chart-muted` | The only chart colours that change with the theme. `CHART_ROLES`: total / baseline / outline in ink; other / rest / disabled and confidence bands in muted ink. |
@@ -578,7 +579,7 @@ columns, strings and permissions (see the note at the top of `src/feedback/feedb
 
 <!-- BEGIN GENERATED: exports — node scripts/gen-export-inventory.mjs -->
 
-**2137 names from 358 modules** in the main barrel — 966 values and 1171 types — and 187 more in 16 standalone entries. _Italic_ is a type-only export.
+**2199 names from 371 modules** in the main barrel — 992 values and 1207 types — and 191 more in 16 standalone entries. _Italic_ is a type-only export.
 
 Generated from `dist/index.d.ts` and each standalone entry's own `.d.ts` by
 `node scripts/gen-export-inventory.mjs`; the counts are pinned by
@@ -586,15 +587,15 @@ Generated from `dist/index.d.ts` and each standalone entry's own `.d.ts` by
 
 | Entry point | Names |
 |---|---|
-| `@eifi1/ui-kit` | 2137 |
-| `@eifi1/ui-kit/chart` | 99 |
-| `@eifi1/ui-kit/shell` | 106 |
+| `@eifi1/ui-kit` | 2199 |
+| `@eifi1/ui-kit/chart` | 102 |
+| `@eifi1/ui-kit/shell` | 110 |
 | `@eifi1/ui-kit/data-table` | 56 |
 | `@eifi1/ui-kit/wizard` | 25 |
 | `@eifi1/ui-kit/tour` | 49 |
-| `@eifi1/ui-kit/feedback` | 195 |
+| `@eifi1/ui-kit/feedback` | 203 |
 | `@eifi1/ui-kit/search` | 20 |
-| `@eifi1/ui-kit/dates` | 22 |
+| `@eifi1/ui-kit/dates` | 26 |
 | `@eifi1/ui-kit/table-text` | 14 |
 | `@eifi1/ui-kit/currencies` | 3 |
 | `@eifi1/ui-kit/eslint` | 1 |
@@ -629,8 +630,9 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `lib/download` | `filenameFromDisposition`, `saveBlob` |
 | `lib/text-match` | `foldForSearch`, `matchesSearch`, `rankMatch`, `searchWords`, _`MatchRank`_ |
 | `lib/qr-encode` | `encodeQr`, _`QrEncodeOptions`_, _`QrErrorCorrection`_, _`QrMatrix`_ |
-| `lib/server-wake` | `attachServerWake`, `createServerWake`, `serverWake`, `watchReadsAnd`, `wrapFetch`, _`AxiosLikeInstance`_, _`ServerWakeAxiosConfig`_, _`ServerWakeFilter`_, _`ServerWakeOptions`_, _`ServerWakeRequest`_, _`ServerWakeStage`_, _`ServerWakeWatcher`_ |
-| `lib/session-refresh` | `attachSessionRefresh`, `createSessionRefresh`, `isSignedOutStep`, `isTransientRefreshFailure`, _`SessionRefresh`_, _`SessionRefreshOptions`_, _`SessionRefreshOutcome`_, _`SessionRenewal`_ |
+| `lib/server-wake` | `attachServerWake`, `createServerWake`, `serverWake`, `watchReadsAnd`, `wrapFetch`, _`AxiosLikeInstance`_, _`ServerWakeAxiosConfig`_, _`ServerWakeFilter`_, _`ServerWakeOptions`_, _`ServerWakeRequest`_, _`ServerWakeStage`_, _`ServerWakeToken`_, _`ServerWakeWatcher`_ |
+| `lib/session-refresh` | `attachSessionRefresh`, `createSessionRefresh`, `isSignedOutStep`, `isTransientRefreshFailure`, `watchSessionElsewhere`, _`SessionElsewhereOptions`_, _`SessionRefresh`_, _`SessionRefreshOptions`_, _`SessionRefreshOutcome`_, _`SessionRenewal`_ |
+| `lib/changelog` | `changelogSectionKey`, `groupByScope`, `parseChangelog`, `parseChangelogItem`, _`ChangelogItem`_, _`ChangelogRelease`_, _`ChangelogScopeGroup`_, _`ChangelogSection`_, _`ChangelogSectionKey`_ |
 | `lib/person-name` | `formatPersonName`, `personInitials`, _`PersonName`_ |
 | `lib/translation-review` | `clearReviewsInChunks`, `DEFAULT_TRANSLATION_REVIEW_FILTER`, `DEFAULT_TRANSLATION_REVIEW_SWIPE`, `dropReviews`, `filterTranslationRows`, `flattenStrings`, `fromApiReview`, `groupTranslationRows`, `keyInArea`, `keyInAreas`, `keyNamespace`, `mergeReviews`, `placeholderMismatch`, `placeholderTokens`, `REVIEW_STATUSES`, `reviewAreaOf`, `reviewStatus`, `reviewUndo`, `reviewWrite`, `saveReviewsInChunks`, `summariseRows`, `toApiWrite`, `TRANSLATION_REVIEW_SWIPE_ACTIONS`, `translationCorrections`, `translationReviewSwipePlan`, `translationRows`, `unreviewedRows`, _`ApiTranslationReview`_, _`ApiTranslationReviewsResponse`_, _`ApiTranslationReviewWrite`_, _`ReviewStatus`_, _`TranslationCorrection`_, _`TranslationReview`_, _`TranslationReviewFilter`_, _`TranslationReviewKey`_, _`TranslationReviewSwipeAction`_, _`TranslationReviewSwipeBinding`_, _`TranslationReviewUndo`_, _`TranslationReviewWrite`_, _`TranslationRow`_, _`TranslationRowGroup`_, _`TranslationRowsInput`_, _`TranslationSummary`_, _`TranslationVerdict`_ |
 | `lib/countries` | `COUNTRY_CODES`, `countryName` |
@@ -645,61 +647,11 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `lib/clipping` | `CLIPS_ATTRIBUTE` |
 | `lib/chip-edge-snap` | `refreshChipEdges` |
 
-### hooks
-
-| Module | Exports |
-|---|---|
-| `hooks/use-media-query` | `useMediaQuery` |
-| `hooks/use-body-scroll-lock` | `useBodyScrollLock` |
-| `hooks/use-anchored-rect` | `useAnchoredRect`, _`AnchorRect`_ |
-| `hooks/use-anchored-panel` | `anchoredPanelPlacement`, `readKeyboardInset`, `useAnchoredPanel`, `useVisualViewport`, _`AnchoredPanel`_, _`AnchoredPanelOptions`_, _`KeyboardInsetOptions`_, _`ViewportBox`_ |
-| `hooks/use-dismiss` | `useEscapeKey`, `useOutsideClick` |
-| `hooks/use-focus-trap` | `useFocusTrap`, _`FocusTrapOptions`_ |
-| `hooks/use-announce` | `useAnnounce`, _`AnnounceRegionProps`_, _`UseAnnounceOptions`_, _`UseAnnounceReturn`_ |
-| `hooks/use-overlay-history` | `useOverlayHistory` |
-| `hooks/use-close-transition` | `OVERLAY_EXIT_MS`, `useCloseTransition` |
-| `hooks/use-row-swipe` | `useRowSwipe`, _`RowSwipeOptions`_, _`RowSwipeReturn`_, _`SwipeStage`_ |
-| `hooks/use-long-press` | `useLongPress`, _`LongPressOptions`_, _`LongPressResult`_ |
-| `hooks/use-noindex` | `useNoIndex` |
-| `hooks/use-document-title` | `useDocumentTitle` |
-| `hooks/use-file-drop` | `dragHasFiles`, `useFileDrop`, _`FileDropProps`_, _`UseFileDropOptions`_, _`UseFileDropReturn`_ |
-| `hooks/use-debounce` | `useDebounce`, `useDebouncedCallback`, _`DebouncedCallbackOptions`_, _`DebouncedFunction`_ |
-| `hooks/use-search-param-state` | `useDialogParam`, `useSearchParamsState`, `useSearchParamState`, `useTabParam`, _`DialogParam`_, _`SearchParamField`_, _`SearchParamFields`_, _`SearchParamStateOptions`_, _`SearchParamsUpdate`_ |
-| `hooks/use-copy-to-clipboard` | `copyToClipboard`, `useCopyToClipboard`, _`CopyState`_, _`UseCopyToClipboardOptions`_, _`UseCopyToClipboardReturn`_ |
-| `hooks/use-hotkey` | `matchesHotkey`, `parseHotkey`, `useHotkey`, _`Hotkey`_, _`ParsedHotkey`_, _`UseHotkeyOptions`_ |
-| `hooks/use-authed-src` | `useAuthedSrc`, _`AuthedFetcher`_, _`AuthedSrcStatus`_, _`UseAuthedSrcOptions`_, _`UseAuthedSrcResult`_ |
-| `hooks/use-windowed-rows` | `useWindowedRows`, `WINDOWED_ROW_INDEX`, _`WindowedRows`_ |
-| `hooks/use-breakpoint` | `BREAKPOINT_REM`, `breakpointQuery`, `remPx`, `useBreakpoint`, `usePhoneLayout`, `useRemPx`, _`Breakpoint`_, _`BreakpointVariant`_, _`RemLength`_ |
-| `hooks/use-large-text` | `useCoarsePointer`, `useInlineFacts`, `useLargeText` |
-| `hooks/use-file-picker` | `matchesAccept`, `useFilePicker`, _`FilePickerLabels`_, _`FileRejection`_, _`FileRejectionReason`_, _`FileScreenOptions`_, _`UseFilePickerOptions`_, _`UseFilePickerReturn`_ |
-
-### theme, palettes, colour
-
-| Module | Exports |
-|---|---|
-| `theme/color` | `contrast`, `deltaE`, `hexToOklch`, `luminance`, `oklchToHex`, `oklchToRgb`, `parseHex`, `rgbToOklch`, `simulateCvd`, `solveLightness`, `toHex`, _`CvdType`_, _`Oklch`_, _`Rgb`_ |
-| `theme/palette-derive` | `auditChartRamp`, `auditPalette`, `deriveChartRamp`, `derivePalette`, `describe`, _`AnchorRole`_, _`ChartRampReport`_, _`ContrastCheck`_, _`ContrastReport`_, _`DerivedPalette`_, _`DeriveOptions`_, _`PaletteAnchors`_, _`SemanticTokens`_ |
-| `theme/palette-presets` | `applyTokenSet`, `DEFAULT_PRESET`, `DERIVED_PRESETS`, `PALETTES`, `PAUL_TOL_PRESET`, `presetById`, _`PalettePreset`_, _`TokenSet`_ |
-| `theme/theme-store` | `applyPersistedTheme`, `createThemeStore`, _`ThemeMode`_, _`ThemePreference`_, _`ThemeState`_, _`ThemeStore`_ |
-| `theme/palette-store` | `applyPersistedPalette`, `createPaletteStore`, _`PaletteStore`_ |
-| `theme/text-size` | `applyPersistedTextSize`, `applyTextSize`, `createTextSizeStore`, `isTextSize`, `readPersistedTextSize`, `readTextSize`, `resolveTextSize`, `TEXT_SCALE`, `TEXT_SIZE_INLINE_SCRIPT`, `TEXT_SIZES`, `useTextSize`, _`ApplyTextSizeOptions`_, _`PersistedAppearanceOptions`_, _`PersistedTextSize`_, _`TextSize`_, _`TextSizeInfo`_, _`TextSizeState`_, _`TextSizeStore`_ |
-| `theme/contrast` | `applyContrast`, `applyPersistedContrast`, `CONTRAST_MODES`, `contrastLevel`, `createContrastStore`, `isContrastMode`, `prefersMoreContrast`, `readContrastLevel`, `readPersistedContrast`, `resolveContrastMode`, _`ApplyContrastOptions`_, _`ContrastLevel`_, _`ContrastMode`_, _`ContrastState`_, _`ContrastStore`_, _`PersistedContrast`_ |
-| `theme/chart-palette` | `CHART_COLORS`, `CHART_MUTED_HEX`, `CHART_ROLES`, `chartEdge`, `CVD_ORDER`, `HEATMAP_HEX`, `lerpHex`, `PALETTE_HEX`, `PALETTE_SIZE`, `paletteFor`, `textOn`, _`HeatStops`_, _`PaletteForOptions`_ |
-
-### i18n
-
-| Module | Exports |
-|---|---|
-| `i18n/kit-labels` | `DEFAULT_APP_SHELL_LABELS`, `DEFAULT_CALCULATOR_LABELS`, `DEFAULT_COMBOBOX_LABELS`, `DEFAULT_COMMON_LABELS`, `DEFAULT_CURRENCY_LABELS`, `DEFAULT_DATE_PICKER_LABELS`, `DEFAULT_FILE_LABELS`, `DEFAULT_MULTI_SELECT_LABELS`, `DEFAULT_PICKER_SHEET_LABELS`, `DEFAULT_SWIPEABLE_ROW_LABELS`, `DEFAULT_TOP_BAR_LABELS`, `formatFileSize`, `missingKitLabels`, `UiKitProvider`, `useKitChartTooltipPlacement`, `useKitDateFormatter`, `useKitDocumentTitle`, `useKitFileLabels`, `useKitLabelOverrides`, `useKitLabels`, `useKitLink`, `useKitLocale`, `useKitTableStorageKeyPrefix`, `useKitTimeZone`, `useKitWeekStart`, _`AppShellLabels`_, _`CalculatorLabels`_, _`ChartTooltipPlacement`_, _`ComboboxLabels`_, _`CommonLabels`_, _`CurrencyLabels`_, _`DatePickerLabels`_, _`FileLabels`_, _`KitDateFormatContext`_, _`KitDateFormatter`_, _`KitLinkComponent`_, _`KitLinkProps`_, _`LabelOverride`_, _`MultiSelectLabels`_, _`PickerSheetLabels`_, _`SwipeableRowLabels`_, _`TopBarLabels`_, _`UiKitLabelOverrides`_, _`UiKitLabels`_, _`UiKitProviderProps`_ |
-| `i18n/defaults` | `DEFAULT_UI_KIT_LABELS` |
-| `i18n/review` | `kitLabelStrings`, _`KitLabelStringsOptions`_ |
-| `i18n/languages` | `formatLocaleOf`, `KIT_LANGUAGES`, `languageOptions`, `loadUiKitLabels`, `peekUiKitLabels`, `resolveLanguage`, `useUiKitLabels`, _`KitLanguage`_, _`KitLanguageCode`_ |
-| `i18n/plurals` | `withAllPlurals`, _`PluralForms`_ |
-
 ### components
 
 | Module | Exports |
 |---|---|
+| `components/release-notes` | `DEFAULT_RELEASE_NOTES_LABELS`, `ReleaseNotes`, _`ReleaseNotesLabels`_, _`ReleaseNotesProps`_, _`ReleaseNotesRelease`_, _`ReleaseNotesSection`_ |
 | `components/button` | `Button`, _`ButtonLinkProps`_, _`ButtonProps`_ |
 | `components/button-look` | `buttonClasses`, `TOUCH_TARGET_LARGE`, _`ButtonClassesOptions`_, _`ButtonSize`_, _`ButtonTone`_, _`ButtonVariant`_ |
 | `components/icon-button` | `IconButton`, _`IconButtonGlyphSize`_, _`IconButtonLinkProps`_, _`IconButtonProps`_, _`IconButtonSize`_, _`IconButtonTone`_, _`IconButtonToneColor`_, _`IconButtonVariant`_ |
@@ -711,7 +663,7 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `components/spinner` | `Spinner`, _`SpinnerProps`_ |
 | `components/empty-state` | `EmptyState`, _`EmptyStateProps`_ |
 | `components/tabs` | `DEFAULT_TABS_LABELS`, `Tabs`, _`TabItem`_, _`TabsLabels`_, _`TabsProps`_ |
-| `components/field-parts` | `CompactControls`, `DISABLED_REASON_LINE_CLASS`, `DisabledReasonLine`, `FieldHint`, `FieldLabel`, `FLOATING_LABEL_STATIC`, `useDisabledReasonLine`, _`DisabledReasonDisplay`_, _`FieldHintProps`_, _`FieldLabelProps`_ |
+| `components/field-parts` | `CompactControls`, `DEFAULT_FIELD_SUGGESTION_LABELS`, `DISABLED_REASON_LINE_CLASS`, `DisabledReasonLine`, `FieldHint`, `FieldLabel`, `FieldSuggestion`, `FLOATING_LABEL_STATIC`, `useDisabledReasonLine`, _`DisabledReasonDisplay`_, _`FieldHintProps`_, _`FieldLabelProps`_, _`FieldSuggestionLabels`_, _`FieldSuggestionProps`_ |
 | `components/focus-ring` | `FOCUS_RING`, `FOCUS_RING_WIDTH` |
 | `components/field` | `Field`, _`FieldControlProps`_, _`FieldLabelVisibility`_, _`FieldProps`_, _`FieldRenderMeta`_ |
 | `components/search-field` | `SearchField`, _`SearchFieldProps`_ |
@@ -757,10 +709,13 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `components/autocomplete` | `Autocomplete`, _`AutocompleteProps`_ |
 | `components/measured-grid` | `DEFAULT_MEASURED_GRID_LABELS`, `MeasuredGrid`, `useMeasuredRows`, _`MeasuredGridColumn`_, _`MeasuredGridLabels`_, _`MeasuredGridProps`_, _`MeasuredGridView`_, _`MeasuredRows`_, _`UseMeasuredRowsOptions`_ |
 | `components/file-button` | `DEFAULT_FILE_PICKER_LABELS`, `FileButton`, _`FileButtonProps`_ |
+| `components/camera-button` | `CameraButton`, _`CameraButtonProps`_ |
+| `components/camera-capture` | `CameraCapture`, _`CameraCaptureProps`_, _`CameraFacing`_ |
 | `components/chart` | `ChartContainer`, `ChartLegend`, `ChartLegendContent`, `ChartTooltip`, `ChartTooltipContent`, `useChart`, _`ChartConfig`_, _`ChartSeriesConfig`_ |
 | `components/treemap` | `fitLabel`, `Treemap`, `TreemapCell`, _`TreemapCellProps`_, _`TreemapEdges`_, _`TreemapNode`_, _`TreemapProps`_ |
 | `components/treemap-labels` | `DEFAULT_TREEMAP_LABELS`, _`TreemapLabels`_ |
 | `components/series-chart` | `SeriesChart`, `seriesLegendEntries`, `StaticSeriesChart`, _`SeriesChartAxis`_, _`SeriesChartHit`_, _`SeriesChartMarker`_, _`SeriesChartPoint`_, _`SeriesChartProps`_, _`SeriesChartReference`_, _`SeriesChartRow`_, _`SeriesChartSeries`_, _`SeriesChartSpan`_, _`SeriesChartTickValues`_, _`SeriesChartTone`_, _`SeriesChartTooltip`_, _`SeriesChartTooltipPlacement`_, _`SeriesChartType`_, _`SeriesChartX`_, _`SeriesChartXTick`_, _`SeriesChartXValue`_, _`SeriesLegendAxes`_ |
+| `components/legended-series-chart` | `LegendedSeriesChart`, _`LegendedSeriesChartLegend`_, _`LegendedSeriesChartProps`_ |
 | `components/chart-height` | _`ChartHeight`_ |
 | `components/chart-zoom-core` | `SharedXZoom`, _`ZoomAxes`_, _`ZoomAxesSetting`_, _`ZoomBinding`_, _`ZoomDrag`_, _`ZoomFitSeries`_, _`ZoomFitSource`_, _`ZoomRow`_, _`ZoomSelection`_, _`ZoomState`_, _`ZoomTarget`_ |
 | `components/toggle-legend` | `LegendColumn`, `LegendGroup`, `StaticLegend`, `STEP_DASH`, `strokeDash`, `toggleHidden`, `ToggleLegend`, _`LegendEntry`_, _`StaticLegendProps`_, _`ToggleLegendProps`_ |
@@ -794,6 +749,7 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `components/progress-bar` | `DEFAULT_PROGRESS_BAR_LABELS`, `ProgressBar`, _`ProgressBarLabels`_, _`ProgressBarProps`_, _`ProgressBarSegment`_, _`ProgressBarSize`_, _`ProgressBarTone`_ |
 | `components/skeleton` | `Skeleton`, _`SkeletonProps`_, _`SkeletonShape`_ |
 | `components/table-skeleton` | `TableSkeleton`, _`TableSkeletonProps`_ |
+| `components/page-header-skeleton` | `PageHeaderSkeleton`, _`PageHeaderSkeletonProps`_ |
 | `components/loading-state` | `LoadingState`, _`LoadingStateLabelVisibility`_, _`LoadingStateProps`_, _`LoadingStateSize`_ |
 | `components/signed-amount` | `DEFAULT_SIGNED_AMOUNT_LABELS`, `Delta`, `SignedAmount`, `Tone`, `toneTextClass`, _`DeltaProps`_, _`GoodDirection`_, _`SignedAmountLabels`_, _`SignedAmountProps`_, _`SignedAmountTone`_, _`TextTone`_, _`ToneProps`_, _`VerdictPalette`_ |
 | `components/error-boundary` | `crashFingerprint`, `DEFAULT_ERROR_BOUNDARY_LABELS`, `describeThrown`, `ErrorBoundary`, `formatCrashReport`, `isChunkLoadError`, _`CrashReport`_, _`CrashReportResult`_, _`ErrorBoundaryDetails`_, _`ErrorBoundaryFallbackProps`_, _`ErrorBoundaryLabels`_, _`ErrorBoundaryProps`_ |
@@ -816,6 +772,7 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `components/translation-review` | `TranslationReviewPanel`, _`TranslationReviewGroupBy`_, _`TranslationReviewOrigin`_, _`TranslationReviewPanelProps`_, _`TranslationReviewSaveInfo`_ |
 | `components/legal` | `DEFAULT_LEGAL_LABELS`, `LEGAL_HREFS`, `LegalFooter`, `LegalLayout`, `LegalLinks`, `legalOperatorText`, `LegalSection`, `useLegalLabels`, _`LegalDisclaimerSectionLabels`_, _`LegalFooterProps`_, _`LegalFramedSectionLabels`_, _`LegalInfoPageKey`_, _`LegalLabels`_, _`LegalLayoutProps`_, _`LegalLink`_, _`LegalLinksProps`_, _`LegalOperator`_, _`LegalOperatorSectionLabels`_, _`LegalOperatorText`_, _`LegalPageKey`_, _`LegalSectionProps`_, _`LegalTextSectionLabels`_ |
 | `components/legal-page` | `LEGAL_SKELETON`, `LegalAcceptCheckbox`, `LegalKitSection`, `LegalPage`, _`LegalAcceptCheckboxProps`_, _`LegalDisclaimerVariant`_, _`LegalKitSectionKey`_, _`LegalKitSectionProps`_, _`LegalPageProps`_, _`LegalSectionOwner`_, _`LegalSkeletonEntry`_, _`LegalSkeletonPage`_ |
+| `components/consent-again-notice` | `ConsentAgainNotice`, `DEFAULT_CONSENT_AGAIN_LABELS`, _`ConsentAgainBannerProps`_, _`ConsentAgainCardProps`_, _`ConsentAgainLabels`_, _`ConsentAgainNoticeProps`_ |
 | `components/appearance-labels` | `DEFAULT_APPEARANCE_LABELS`, `useAppearanceLabels`, _`AppearanceLabels`_ |
 | `components/date-format-setting` | `DateFormatSetting`, _`DateFormatSettingProps`_ |
 | `components/row-actions` | `DEFAULT_ROW_ACTIONS_LABELS`, `ROW_ACTIONS_CELL_CLASS`, `RowActions`, `rowActionsColumn`, `RowActionsHead`, _`RowAction`_, _`RowActionConfirm`_, _`RowActionList`_, _`RowActionsCollapse`_, _`RowActionsColumnOptions`_, _`RowActionsHeadProps`_, _`RowActionsLabels`_, _`RowActionsProps`_, _`RowActionsSize`_, _`RowActionTone`_ |
@@ -839,6 +796,7 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `components/data-table-virtual` | _`DataTableVirtualize`_ |
 | `components/data-table-cells` | `booleanColumn`, `BooleanMark`, _`BooleanColumnOptions`_, _`BooleanMarkProps`_ |
 | `components/use-table-state` | `useTableUrlState`, _`TableUrlState`_, _`TableUrlStateProps`_, _`TableUrlSync`_, _`UseTableUrlStateOptions`_, _`UseTableUrlStateReturn`_ |
+| `components/camera-labels` | `DEFAULT_CAMERA_LABELS`, _`CameraLabels`_ |
 | `components/translation-review-editor` | `TranslationReviewEditor`, _`TranslationReviewEditorProps`_ |
 | `components/translation-review-parts` | `REVIEW_STATUS_TONES`, `ReviewStatusChip`, `TranslationExportButton`, `TranslationLocaleTabs`, `TranslationProgress`, _`ReviewStatusChipProps`_, _`TranslationExportButtonProps`_, _`TranslationLocaleTab`_, _`TranslationLocaleTabsProps`_, _`TranslationProgressProps`_ |
 | `components/translation-review-labels` | `DEFAULT_TRANSLATION_REVIEW_LABELS`, _`TranslationReviewLabels`_ |
@@ -850,6 +808,58 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `components/date-field` | _`DateTriggerAttributes`_ |
 | `components/date-range-picker` | `DateRangePicker`, _`DateRangeDraftSummary`_, _`DateRangePickerPreset`_, _`DateRangePickerProps`_, _`DateRangeTriggerRenderProps`_ |
 
+### hooks
+
+| Module | Exports |
+|---|---|
+| `hooks/use-media-query` | `useMediaQuery` |
+| `hooks/use-body-scroll-lock` | `useBodyScrollLock` |
+| `hooks/use-anchored-rect` | `useAnchoredRect`, _`AnchorRect`_ |
+| `hooks/use-anchored-panel` | `anchoredPanelPlacement`, `readKeyboardInset`, `useAnchoredPanel`, `useVisualViewport`, _`AnchoredPanel`_, _`AnchoredPanelOptions`_, _`KeyboardInsetOptions`_, _`ViewportBox`_ |
+| `hooks/use-dismiss` | `useEscapeKey`, `useOutsideClick` |
+| `hooks/use-focus-trap` | `useFocusTrap`, _`FocusTrapOptions`_ |
+| `hooks/use-announce` | `useAnnounce`, _`AnnounceRegionProps`_, _`UseAnnounceOptions`_, _`UseAnnounceReturn`_ |
+| `hooks/use-overlay-history` | `useOverlayHistory` |
+| `hooks/use-close-transition` | `OVERLAY_EXIT_MS`, `useCloseTransition` |
+| `hooks/use-row-swipe` | `useRowSwipe`, _`RowSwipeOptions`_, _`RowSwipeReturn`_, _`SwipeStage`_ |
+| `hooks/use-long-press` | `useLongPress`, _`LongPressOptions`_, _`LongPressResult`_ |
+| `hooks/use-noindex` | `useNoIndex` |
+| `hooks/use-document-title` | `useDocumentTitle` |
+| `hooks/use-file-drop` | `dragHasFiles`, `useFileDrop`, _`FileDropProps`_, _`UseFileDropOptions`_, _`UseFileDropReturn`_ |
+| `hooks/use-debounce` | `useDebounce`, `useDebouncedCallback`, _`DebouncedCallbackOptions`_, _`DebouncedFunction`_, _`DebounceOptions`_ |
+| `hooks/use-search-param-state` | `useDialogParam`, `useSearchParamsState`, `useSearchParamState`, `useTabParam`, _`DialogParam`_, _`SearchParamField`_, _`SearchParamFields`_, _`SearchParamStateOptions`_, _`SearchParamsUpdate`_ |
+| `hooks/use-copy-to-clipboard` | `copyToClipboard`, `useCopyToClipboard`, _`CopyState`_, _`UseCopyToClipboardOptions`_, _`UseCopyToClipboardReturn`_ |
+| `hooks/use-hotkey` | `matchesHotkey`, `parseHotkey`, `useHotkey`, _`Hotkey`_, _`ParsedHotkey`_, _`UseHotkeyOptions`_ |
+| `hooks/use-authed-src` | `useAuthedSrc`, _`AuthedFetcher`_, _`AuthedSrcStatus`_, _`UseAuthedSrcOptions`_, _`UseAuthedSrcResult`_ |
+| `hooks/use-windowed-rows` | `useWindowedRows`, `WINDOWED_ROW_INDEX`, _`WindowedRows`_ |
+| `hooks/use-breakpoint` | `BREAKPOINT_REM`, `breakpointQuery`, `remPx`, `useBreakpoint`, `usePhoneLayout`, `useRemPx`, _`Breakpoint`_, _`BreakpointVariant`_, _`RemLength`_ |
+| `hooks/use-large-text` | `useCoarsePointer`, `useInlineFacts`, `useLargeText` |
+| `hooks/use-has-camera` | `useHasCamera` |
+| `hooks/use-file-picker` | `matchesAccept`, `useFilePicker`, _`FilePickerLabels`_, _`FileRejection`_, _`FileRejectionReason`_, _`FileScreenOptions`_, _`UseFilePickerOptions`_, _`UseFilePickerReturn`_ |
+
+### theme, palettes, colour
+
+| Module | Exports |
+|---|---|
+| `theme/color` | `contrast`, `deltaE`, `hexToOklch`, `luminance`, `oklchToHex`, `oklchToRgb`, `parseHex`, `rgbToOklch`, `simulateCvd`, `solveLightness`, `toHex`, _`CvdType`_, _`Oklch`_, _`Rgb`_ |
+| `theme/palette-derive` | `auditChartRamp`, `auditPalette`, `deriveChartRamp`, `derivePalette`, `describe`, _`AnchorRole`_, _`ChartRampReport`_, _`ContrastCheck`_, _`ContrastReport`_, _`DerivedPalette`_, _`DeriveOptions`_, _`PaletteAnchors`_, _`SemanticTokens`_ |
+| `theme/palette-presets` | `applyTokenSet`, `DEFAULT_PRESET`, `DERIVED_PRESETS`, `PALETTES`, `PAUL_TOL_PRESET`, `presetById`, _`PalettePreset`_, _`TokenSet`_ |
+| `theme/theme-store` | `applyPersistedTheme`, `createThemeStore`, _`ThemeMode`_, _`ThemePreference`_, _`ThemeState`_, _`ThemeStore`_ |
+| `theme/palette-store` | `applyPersistedPalette`, `createPaletteStore`, _`PaletteStore`_ |
+| `theme/text-size` | `applyPersistedTextSize`, `applyTextSize`, `createTextSizeStore`, `isTextSize`, `readPersistedTextSize`, `readTextSize`, `resolveTextSize`, `TEXT_SCALE`, `TEXT_SIZE_INLINE_SCRIPT`, `TEXT_SIZES`, `useTextSize`, _`ApplyTextSizeOptions`_, _`PersistedAppearanceOptions`_, _`PersistedTextSize`_, _`TextSize`_, _`TextSizeInfo`_, _`TextSizeState`_, _`TextSizeStore`_ |
+| `theme/contrast` | `applyContrast`, `applyPersistedContrast`, `CONTRAST_MODES`, `contrastLevel`, `createContrastStore`, `isContrastMode`, `prefersMoreContrast`, `readContrastLevel`, `readPersistedContrast`, `resolveContrastMode`, _`ApplyContrastOptions`_, _`ContrastLevel`_, _`ContrastMode`_, _`ContrastState`_, _`ContrastStore`_, _`PersistedContrast`_ |
+| `theme/chart-palette` | `CHART_COLORS`, `CHART_MUTED_HEX`, `CHART_ROLES`, `chartEdge`, `CVD_ORDER`, `HEATMAP_HEX`, `lerpHex`, `PALETTE_HEX`, `PALETTE_SIZE`, `paletteFor`, `textOn`, _`HeatStops`_, _`PaletteForOptions`_ |
+
+### i18n
+
+| Module | Exports |
+|---|---|
+| `i18n/kit-labels` | `DEFAULT_APP_SHELL_LABELS`, `DEFAULT_CALCULATOR_LABELS`, `DEFAULT_COMBOBOX_LABELS`, `DEFAULT_COMMON_LABELS`, `DEFAULT_CURRENCY_LABELS`, `DEFAULT_DATE_PICKER_LABELS`, `DEFAULT_FILE_LABELS`, `DEFAULT_MULTI_SELECT_LABELS`, `DEFAULT_PICKER_SHEET_LABELS`, `DEFAULT_SWIPEABLE_ROW_LABELS`, `DEFAULT_TOP_BAR_LABELS`, `formatFileSize`, `missingKitLabels`, `UiKitProvider`, `useKitChartTooltipPlacement`, `useKitDateFormatter`, `useKitDocumentTitle`, `useKitFileLabels`, `useKitLabelOverrides`, `useKitLabels`, `useKitLink`, `useKitLocale`, `useKitTableStorageKeyPrefix`, `useKitTimeZone`, `useKitWeekStart`, _`AppShellLabels`_, _`CalculatorLabels`_, _`ChartTooltipPlacement`_, _`ComboboxLabels`_, _`CommonLabels`_, _`CurrencyLabels`_, _`DatePickerLabels`_, _`FileLabels`_, _`KitDateFormatContext`_, _`KitDateFormatter`_, _`KitLinkComponent`_, _`KitLinkProps`_, _`LabelOverride`_, _`MultiSelectLabels`_, _`PickerSheetLabels`_, _`SwipeableRowLabels`_, _`TopBarLabels`_, _`UiKitLabelOverrides`_, _`UiKitLabels`_, _`UiKitProviderProps`_ |
+| `i18n/defaults` | `DEFAULT_UI_KIT_LABELS` |
+| `i18n/review` | `kitLabelStrings`, _`KitLabelStringsOptions`_ |
+| `i18n/languages` | `formatLocaleOf`, `KIT_LANGUAGES`, `languageOptions`, `loadUiKitLabels`, `peekUiKitLabels`, `resolveLanguage`, `useUiKitLabels`, _`KitLanguage`_, _`KitLanguageCode`_ |
+| `i18n/plurals` | `withAllPlurals`, _`PluralForms`_ |
+
 ### shell
 
 | Module | Exports |
@@ -868,6 +878,7 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `shell/account-menu-text-size` | `AccountMenuTextSize`, _`AccountMenuTextSizeProps`_ |
 | `shell/tour-menu` | `TourMenu`, _`TourMenuProps`_, _`TourMenuTour`_ |
 | `shell/sync-status-indicator` | `SyncStatusIndicator`, _`SyncState`_, _`SyncStatus`_, _`SyncStatusIndicatorProps`_, _`SyncStatusScope`_ |
+| `shell/held-changes-banner` | `DEFAULT_HELD_CHANGES_BANNER_LABELS`, `HeldChangesBanner`, _`HeldChangesBannerLabels`_, _`HeldChangesBannerProps`_ |
 | `shell/dev-menu` | `DevMenu`, _`DevMenuProps`_, _`DevMenuSection`_ |
 | `shell/top-bar-parts-labels` | `DEFAULT_TOP_BAR_PARTS_LABELS`, `useTopBarPartsLabels`, _`DevSwitchersLabels`_, _`SyncStatusLabels`_, _`TopBarPartsLabels`_, _`TourMenuLabels`_ |
 | `shell/company-switcher` | `CompanySwitcher`, `DEFAULT_COMPANY_SWITCHER_LABELS`, _`CompanySwitcherCompany`_, _`CompanySwitcherLabels`_, _`CompanySwitcherProps`_ |
@@ -927,6 +938,7 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `feedback/feedback-comment-thread` | `DEFAULT_FEEDBACK_COMMENTS_LABELS`, `FeedbackCommentThread`, _`FeedbackCommentsLabels`_, _`FeedbackCommentThreadProps`_ |
 | `feedback/feedback-replies` | `DEFAULT_FEEDBACK_REPLIES_LABELS`, `FeedbackReplyComposer`, `feedbackReplyNudge`, `FeedbackReplyTimeline`, `useFeedbackRepliesLabels`, _`FeedbackRepliesLabels`_, _`FeedbackReplyComposerProps`_, _`FeedbackReplyTimelineProps`_ |
 | `feedback/feedback-entry-file` | `FeedbackEntryFile`, `useFeedbackEntryUpload`, _`FeedbackEntryFileProps`_, _`FeedbackEntryUpload`_, _`FeedbackEntryUploadOptions`_, _`FeedbackEntryUploadState`_ |
+| `feedback/feedback-inbox-page` | `FeedbackInbox`, `useFeedbackInbox`, _`FeedbackInboxMutation`_, _`FeedbackInboxProps`_, _`FeedbackInboxState`_, _`FeedbackReplyPost`_, _`FeedbackReworkPost`_, _`UseFeedbackInboxOptions`_ |
 | `feedback/feedback-vocabulary` | `FEEDBACK_CATEGORY_META`, `FEEDBACK_CATEGORY_ORDER`, `FEEDBACK_STATUS_META`, `FEEDBACK_STATUS_ORDER`, `feedbackCategoryRank`, `nextFeedbackStatus`, `selectableFeedbackStatuses`, `visibleFeedbackStatuses`, _`FeedbackCategory`_, _`FeedbackStatus`_ |
 
 ### wizard
@@ -994,7 +1006,7 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 
 | Module | Exports |
 |---|---|
-| `admin/user-roster` | `DEFAULT_USER_ROSTER_LABELS`, `USER_ROSTER_SORT_KEYS`, `UserIdentityCell`, `userRosterSort`, `UserRowActions`, `useUserRosterColumns`, _`AdminUserStateFields`_, _`RoleEditing`_, _`RosterState`_, _`UserIdentityCellProps`_, _`UserRosterColumnsOptions`_, _`UserRosterLabels`_, _`UserRosterRow`_, _`UserRosterSortKey`_, _`UserRowAction`_, _`UserRowActionList`_, _`UserRowActionsProps`_ |
+| `admin/user-roster` | `DEFAULT_USER_ROSTER_LABELS`, `USER_ROSTER_MAX_PAGE_SIZE`, `USER_ROSTER_PAGE_SIZE`, `USER_ROSTER_SORT_KEYS`, `UserIdentityCell`, `userRosterSort`, `UserRowActions`, `useUserRosterColumns`, _`AdminUserStateFields`_, _`RoleEditing`_, _`RosterState`_, _`UserIdentityCellProps`_, _`UserRosterColumnsOptions`_, _`UserRosterLabels`_, _`UserRosterRow`_, _`UserRosterSortKey`_, _`UserRowAction`_, _`UserRowActionList`_, _`UserRowActionsProps`_ |
 | `admin/role-select` | `DEFAULT_ROLE_SELECT_LABELS`, `RolesEditor`, `RoleSelect`, _`RoleLock`_, _`RoleLockCode`_, _`RolesEditorProps`_, _`RoleSelectLabels`_, _`RoleSelectProps`_ |
 | `admin/reviewer-scope-editor` | `DEFAULT_REVIEWER_SCOPE_LABELS`, `ReviewerScopeEditor`, _`ReviewerScope`_, _`ReviewerScopeArea`_, _`ReviewerScopeEditorProps`_, _`ReviewerScopeLabels`_, _`ReviewerScopeLanguage`_ |
 | `admin/admin-action-confirm` | `AdminActionConfirm`, `DEFAULT_ADMIN_ACTION_LABELS`, _`AdminActionConfirmProps`_, _`AdminActionConfirmValues`_, _`AdminActionLabels`_, _`AdminActionTarget`_, _`AdminConfirmLevel`_ |
@@ -1033,6 +1045,8 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 | `billing/cancel-subscription` | `CancelSubscriptionConfirm`, _`CancelSubscriptionConfirmProps`_ |
 | `billing/provider-page` | `openProviderPage`, _`OpenProviderPageOptions`_, _`ProviderPageWay`_ |
 | `billing/cancel-request` | `useCancelRequest`, _`CancelRequest`_, _`CancelRequested`_, _`CancelRequestView`_ |
+| `billing/subscription-standing` | `subscriptionStanding`, `SubscriptionStanding`, _`SubscriptionStandingOverview`_, _`SubscriptionStandingProps`_ |
+| `billing/usage-meter` | `UsageMeter`, _`UsageMeterProps`_ |
 
 ### notifications
 
@@ -1073,7 +1087,7 @@ Every other subpath is a re-slicing of the barrel, never a second API.
 
 | Module | Exports |
 |---|---|
-| `lib/dates` | `addDaysIso`, `addMonthsClamped`, `calendarMonthPresets`, `dateRangePresets`, `endOfMonthIso`, `endOfYearIso`, `formatIsoDate`, `lastFullMonthsRange`, `lastFullYearsRange`, `localeWeekStart`, `monthKey`, `pad`, `parseIsoDate`, `sameYmd`, `shiftIso`, `startOfMonthIso`, `startOfWeekIso`, `startOfYearIso`, `todayIso`, `toLocalIso`, _`CalendarMonthPresetOptions`_, _`DateRangePreset`_ |
+| `lib/dates` | `addDaysIso`, `addMonthsClamped`, `calendarMonthPresets`, `currentDate`, `dateRangePresets`, `endOfMonthIso`, `endOfYearIso`, `formatIsoDate`, `lastFullMonthsRange`, `lastFullYearsRange`, `localeWeekStart`, `monthKey`, `pad`, `parseIsoDate`, `sameYmd`, `setToday`, `shiftIso`, `startOfMonthIso`, `startOfWeekIso`, `startOfYearIso`, `subscribeToday`, `todayIso`, `todayOverride`, `toLocalIso`, _`CalendarMonthPresetOptions`_, _`DateRangePreset`_ |
 
 ### @eifi1/ui-kit/table-text (standalone)
 

package/dist/admin/plan-change.js

@@ -4,7 +4,7 @@ import { isValidElement, useCallback, useMemo, useState } from "react";
 import { useKitLabels, useKitLocale } from "../i18n/kit-labels.js";
 import { pluralForm } from "../i18n/plurals.js";
 import { formatNumber, EMPTY_FORMATTED_VALUE } from "../lib/format.js";
-import { toLocalIso } from "../lib/dates.js";
+import { todayIso } from "../lib/dates.js";
 import { DatePicker } from "../components/date-picker.js";
 import { Tooltip } from "../components/tooltip.js";
 import { Select } from "../components/select.js";
@@ -108,7 +108,7 @@ function PlanChangeConfirm({
   const current = codeOf(currentProp);
   const [plan, setPlan] = useState(current ?? "");
   const [until, setUntil] = useState("");
-  const [today] = useState(() => toLocalIso(/* @__PURE__ */ new Date()));
+  const [today] = useState(todayIso);
   const options = plans.map((p) => ({ code: codeOf(p.code) ?? p.code, name: p.name }));
   const nameOf = (code) => options.find((p) => p.code === code)?.name ?? code;
   if (current && !options.some((p) => p.code === current)) options.unshift({ code: current, name: current });

package/dist/admin/plan-change.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/admin/plan-change.tsx"],"sourcesContent":["import { isValidElement, useCallback, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport { useKitLabels, useKitLocale, type LabelOverride } from \"../i18n/kit-labels\";\nimport { pluralForm } from \"../i18n/plurals\";\nimport type { PluralForms } from \"../i18n/plurals\";\nimport { formatNumber, EMPTY_FORMATTED_VALUE } from \"../lib/format\";\nimport { toLocalIso } from \"../lib/dates\";\nimport type { DataTableColumn } from \"../components/data-table\";\nimport { DatePicker } from \"../components/date-picker\";\nimport { Tooltip } from \"../components/tooltip\";\nimport { Select } from \"../components/select\";\nimport { COMMIT_EXCEPT_BILLING } from \"../components/write-lock\";\nimport { useBillingLabels } from \"../billing/billing-labels\";\nimport type { SubscriptionStatus } from \"../billing/billing-labels\";\nimport { SubscriptionStatusChip } from \"../billing/subscription-status-chip\";\nimport { AdminActionConfirm } from \"./admin-action-confirm\";\nimport type { AdminActionConfirmValues } from \"./admin-action-confirm\";\nimport { personLabel, useDayText } from \"./admin-parts\";\nimport type { AdminPerson, MaybePromise } from \"./admin-parts\";\nimport { DEFAULT_PLAN_CHANGE_LABELS } from \"../billing/plan-change-labels\";\nimport type { PlanChangeLabels } from \"../billing/plan-change-labels\";\n\n/**\n * The operator's plan parts (docs/billing-harmonization.md §14.12, decision 27):\n * {@link planColumn} for the roster or the companies list, {@link PlanChangeConfirm}\n * for the grant, and {@link usePlanChangeResult} for what the answer says.\n *\n * All three apps have the route (`POST /admin/users/{id}/plan`, kastlan's\n * `POST /platform/companies/{id}/plan`) and server-kit's `PlanChangeRequest` /\n * `PlanChangeResponse`; only keksdose had a UI (`users-panel.tsx`, `PlanConfirm` in\n * `user-admin-confirm.tsx`), and these are its parts, lifted. The plan names are the\n * app's (§3.1): every part takes `planName` or the plans with their names. The plan\n * codes come from `GET /admin/plans` (kastlan `GET /platform/plans`), which answers\n * whatever the billing switch says.\n */\n\n// The words and their type live in billing/plan-change-labels, which holds no component\n// code (0.34, KS U8): PlanSwitchConfirm reads them too, and billing importing admin while\n// this module imports billing made the two folders import each other (refactor audit\n// 2026-10-30, MOD-6).\nexport type { PlanChangeLabels };\nexport { DEFAULT_PLAN_CHANGE_LABELS };\n\n/** A plan code as the parts compare it: lowercase (§12.16 — an older row's \"FREE\" is\n *  the same plan as \"free\"), and no code at all as null. */\nfunction codeOf(raw: string | null | undefined): string | null {\n  const code = (raw ?? \"\").trim().toLowerCase();\n  return code === \"\" ? null : code;\n}\n\n/* ── The column ────────────────────────────────────────────────────────────── */\n\n/** What a row's usage is, for the line under its plan: \"1/5\" — and since 0.34 what\n *  {@link PlanChangeConfirm}'s `usage` takes, for the same sentence in the dialog. */\nexport interface PlanColumnUsage {\n  used: number;\n  /** The plan's limit for it; `null` (unlimited, or none known): no line. */\n  limit: number | null;\n  /**\n   * The app's word for what is counted, as it reads after a number: \"budgets\" in \"1 of 5\n   * budgets\" — the word in a sentence, not a heading's \"Budgets\".\n   *\n   * Its plural forms (0.33.1, keksdose): `{ one: \"budget\", other: \"budgets\" }` — your\n   * catalogue's `_one` / `_other` pair, any CLDR category allowed, `other` for the rest\n   * ({@link PluralForms}). The column picks the form for the limit in the provider's\n   * locale, so a plan of one reads \"1 of 1 budget\". A plain string is used as it is,\n   * whatever the count.\n   */\n  label: string | PluralForms;\n}\n\nexport interface PlanColumnOptions<T> {\n  /** The column's key. Default `\"plan\"`. */\n  key?: string;\n  /** The row's plan code, read without case (§12.16); null for none. */\n  plan: (row: T) => string | null;\n  /** The plan's display name, the app's (§3.1). Gets the lowercase code. */\n  planName: (code: string) => string;\n  /** The row's standing, as a `SubscriptionStatusChip` beside the name. Left out, or\n   *  undefined for a row: no chip — billing off, where a status says nothing. */\n  status?: (row: T) => SubscriptionStatus | undefined;\n  /** The row's usage of its plan's limit: \"1/5\" under the name, \"1 of 5 budgets\" in\n   *  the tooltip (`planChange.usageOf`, with the label's form for the limit). Undefined\n   *  for a row, or a `null` limit: no line. */\n  usage?: (row: T) => PlanColumnUsage | undefined;\n  /** A select filter over these codes, each named by `planName`. Left out: none. */\n  filterPlans?: readonly string[];\n  /**\n   * The sort. Default: by the plan code (keksdose's, `users-panel.tsx:739`). A function:\n   * by its value — the catalogue's `sort` for rank order. `false`: not sortable.\n   *\n   * Client-side only, as every column's `sortBy`: a `DataTable` with `serverPagination`\n   * holds one page, so it sorts nothing itself — with `onSortsChange` it reports the\n   * column's `key` (default `\"plan\"`), and your server orders the rows by it.\n   */\n  sortBy?: false | ((row: T) => string | number | null | undefined);\n  /** The header's text. Default `planChange.column`. */\n  headerText?: string;\n  /** The words, already resolved. Default English; {@link usePlanColumn} reads the\n   *  provider's `planChange` namespace. */\n  labels?: LabelOverride<PlanChangeLabels>;\n}\n\n/**\n * A usage spelled out — `planChange.usageOf` with the figures in `locale` and the word in\n * the form the limit takes: \"1 of 1 budget\", \"Budgets: 1 von 5\". The column's tooltip\n * and the grant dialog's line both read it, so the rule lives once (round 0.34 C15).\n */\nfunction usageSentence(\n  usage: PlanColumnUsage & { limit: number },\n  usageOf: PlanChangeLabels[\"usageOf\"],\n  locale: string | undefined,\n): string {\n  const figure = (value: number) => formatNumber(value, { locale });\n  const word = typeof usage.label === \"string\" ? usage.label : pluralForm(usage.limit, usage.label, locale);\n  return usageOf(figure(usage.used), figure(usage.limit), word);\n}\n\n/** The cell: a component, so the figures follow the provider's locale. */\nfunction PlanCell({\n  code,\n  name,\n  status,\n  usage,\n  usageOf,\n}: {\n  code: string | null;\n  name: string;\n  status: SubscriptionStatus | undefined;\n  usage: PlanColumnUsage | undefined;\n  usageOf: PlanChangeLabels[\"usageOf\"];\n}) {\n  const locale = useKitLocale();\n  const figure = (value: number) => formatNumber(value, { locale });\n  return (\n    <div className=\"whitespace-nowrap\" data-plan={code ?? undefined}>\n      <div className=\"flex items-center gap-1.5\">\n        <span className={code ? \"font-medium\" : \"text-muted\"}>{name}</span>\n        {/* The standing at a glance (§6): the kit's word and tone, never colour alone. */}\n        {status !== undefined && <SubscriptionStatusChip status={status} size=\"xs\" />}\n      </div>\n      {usage && usage.limit !== null && (\n        // \"1/5\" under the plan, \"1 of 5 budgets\" in the tooltip: the sentence spelled out\n        // inline was the widest thing in keksdose's table.\n        <Tooltip label={usageSentence({ ...usage, limit: usage.limit }, usageOf, locale)}>\n          <span className=\"block text-xs tabular-nums text-muted\">\n            {figure(usage.used)}/{figure(usage.limit)}\n          </span>\n        </Tooltip>\n      )}\n    </div>\n  );\n}\n\n/**\n * The roster's (or the companies list's) plan column: the plan's display name, the\n * standing chip beside it while billing is on, and the usage under it — keksdose's\n * column, `users-panel.tsx:706-745`. Pass it in `userRosterColumns`' `extra`, or in\n * any `DataTable`'s columns:\n *\n *     extra: [planColumn<AdminUserRow>({\n *       plan: (u) => u.plan,\n *       planName,\n *       status: billingOn ? (u) => u.subscription?.status : undefined,\n *       usage: (u) => ({\n *         used: u.budgets_owned,\n *         limit: u.limits.budgets,\n *         label: { one: t(\"planUsage.budget_one\"), other: t(\"planUsage.budget_other\") },\n *       }),\n *       filterPlans: plans.map((p) => p.code),\n *     })]\n *\n * Pure: hand it resolved words, or use {@link usePlanColumn}.\n */\nexport function planColumn<T>(options: PlanColumnOptions<T>): DataTableColumn<T> {\n  const { key = \"plan\", plan, planName, status, usage, filterPlans, sortBy, headerText, labels: labelsProp } = options;\n  const labels: PlanChangeLabels = { ...DEFAULT_PLAN_CHANGE_LABELS, ...labelsProp };\n  const header = headerText ?? labels.column;\n  const nameOf = (code: string | null) => (code ? planName(code) : EMPTY_FORMATTED_VALUE);\n  return {\n    key,\n    header,\n    headerText: header,\n    cell: (row) => {\n      const code = codeOf(plan(row));\n      return (\n        <PlanCell\n          code={code}\n          name={nameOf(code)}\n          status={status?.(row)}\n          usage={usage?.(row)}\n          usageOf={labels.usageOf}\n        />\n      );\n    },\n    sortBy: sortBy === false ? undefined : (sortBy ?? ((row) => codeOf(plan(row)) ?? \"\")),\n    filter: filterPlans\n      ? {\n          type: \"select\",\n          getValue: (row) => codeOf(plan(row)) ?? \"\",\n          options: [...new Set(filterPlans.map((code) => codeOf(code)).filter((code) => code !== null))].map(\n            (code) => ({ value: code, label: planName(code) }),\n          ),\n        }\n      : undefined,\n  };\n}\n\n/**\n * {@link planColumn} with the `planChange` words from the provider, memoised on the\n * options — pass stable callbacks (`useCallback`), or the column is rebuilt on every\n * render.\n */\nexport function usePlanColumn<T>(options: PlanColumnOptions<T>): DataTableColumn<T> {\n  const { key, plan, planName, status, usage, filterPlans, sortBy, headerText, labels: labelsProp } = options;\n  const labels = useKitLabels(\"planChange\", DEFAULT_PLAN_CHANGE_LABELS, labelsProp);\n  return useMemo(\n    () => planColumn<T>({ key, plan, planName, status, usage, filterPlans, sortBy, headerText, labels }),\n    [key, plan, planName, status, usage, filterPlans, sortBy, headerText, labels],\n  );\n}\n\n/* ── The grant ─────────────────────────────────────────────────────────────── */\n\n/** What {@link PlanChangeConfirmProps.onConfirm} sends: server-kit's\n *  `PlanChangeRequest` without its `acknowledged`, which comes in `values`. */\nexport interface PlanChange {\n  /** The picked plan's code. */\n  plan: string;\n  /** The end of the free grant, as ISO UTC — only when one was picked. */\n  comped_until?: string;\n}\n\nexport interface PlanChangeConfirmProps {\n  /**\n   * Whom it is about — a user (`AdminActionTarget`), or kastlan's company, which has no\n   * address: its name is said instead (the level is `acknowledge`, so nothing is typed).\n   */\n  target: AdminPerson & { email?: string | null };\n  /** The plans to offer, in the catalogue's order, by their display names (§3.1) — from\n   *  `GET /admin/plans`. */\n  plans: readonly { code: string; name: string }[];\n  /** The account's plan now; null for none. The select opens on it. */\n  current: string | null;\n  /**\n   * What the account uses. The column's shape (0.34, keksdose N1) — `{ used, limit, label }`,\n   * the label a word or its plural forms — is spelled out as the column's tooltip is\n   * (`planChange.usageOf`, the word in the limit's form: \"1 of 1 budget\"); a `null` limit\n   * gives no line. Or the app's own sentence, as it is: \"3 of 5 budgets\".\n   */\n  usage?: PlanColumnUsage | ReactNode;\n  /** Offer \"Free until\" — only meaningful while billing is on, where a grant's end\n   *  means something to the payer. */\n  grantEnd?: boolean;\n  /**\n   * Sends it: `{plan}`, and `comped_until` only when an end was picked — the END of the\n   * picked day in the operator's time zone, as ISO UTC (a grant \"until 31 January\" lasts\n   * through it). No end: a grant without one, or on a running beta only the plan moves\n   * and the beta keeps its own end (§12.34). `values.acknowledged` is the body's\n   * `acknowledged`. A promise is handled as `AdminActionConfirm`'s.\n   */\n  onConfirm: (change: PlanChange, values: AdminActionConfirmValues) => MaybePromise;\n  onClose: (done: boolean) => void;\n  /** The app's words for a failure the kit has no code for. */\n  describeError?: (error: unknown) => ReactNode | undefined;\n  labels?: LabelOverride<PlanChangeLabels>;\n}\n\n/** The column's usage shape, told from a node: a plain object with the three fields. */\nfunction isPlanUsage(value: PlanChangeConfirmProps[\"usage\"]): value is PlanColumnUsage {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    !isValidElement(value) &&\n    \"used\" in value &&\n    \"limit\" in value &&\n    \"label\" in value\n  );\n}\n\n/** The end of the day `date` (YYYY-MM-DD) names, in this device's time zone, as ISO\n *  UTC — keksdose's `endOfDay` (`user-admin-confirm.tsx:44-46`). */\nfunction endOfDay(date: string): string {\n  return new Date(`${date}T23:59:59`).toISOString();\n}\n\n/**\n * An operator's plan change (§14.12): `AdminActionConfirm` at `acknowledge`, the line\n * with the current plan and the app's usage sentence, a plan select, and — with\n * `grantEnd` — the end of a free grant. The confirm is held while nothing would change.\n *\n * Exempt from a BILLING lock, built in (`COMMIT_EXCEPT_BILLING`, §12.36): a plan change\n * is an admin route (§12.13), and the operator's own account or company may be lapsed —\n * kastlan's review. A demo lock still holds it.\n */\nexport function PlanChangeConfirm({\n  target,\n  plans,\n  current: currentProp,\n  usage,\n  grantEnd = false,\n  onConfirm,\n  onClose,\n  describeError,\n  labels: labelsProp,\n}: PlanChangeConfirmProps) {\n  const labels = useKitLabels(\"planChange\", DEFAULT_PLAN_CHANGE_LABELS, labelsProp);\n  const locale = useKitLocale();\n  // Seeded from the account, so the picker opens on the truth and confirming without\n  // touching it is held rather than a silent free → free in the audit.\n  const current = codeOf(currentProp);\n  const [plan, setPlan] = useState(current ?? \"\");\n  const [until, setUntil] = useState(\"\");\n  // A grant ends today at the earliest; read once, not on every render.\n  const [today] = useState(() => toLocalIso(new Date()));\n  const options = plans.map((p) => ({ code: codeOf(p.code) ?? p.code, name: p.name }));\n  const nameOf = (code: string) => options.find((p) => p.code === code)?.name ?? code;\n  // An account on a plan the catalogue no longer lists still opens on it.\n  if (current && !options.some((p) => p.code === current)) options.unshift({ code: current, name: current });\n  const unchanged = plan === \"\" || (plan === current && !until);\n  // A company has no address: the dialog says its name in the address's place.\n  const who = { ...target, email: target.email || personLabel(target, locale) };\n  // The column's shape in the column's sentence; the app's own sentence as it is.\n  const usageLine: ReactNode | undefined = isPlanUsage(usage)\n    ? usage.limit === null\n      ? undefined\n      : usageSentence({ ...usage, limit: usage.limit }, labels.usageOf, locale)\n    : usage;\n\n  return (\n    <AdminActionConfirm\n      level=\"acknowledge\"\n      tone=\"warning\"\n      target={who}\n      title={labels.title}\n      confirmLabel={labels.confirm}\n      confirmDisabledReason={unchanged ? labels.needsChange : undefined}\n      describeError={describeError}\n      commit={COMMIT_EXCEPT_BILLING}\n      onConfirm={(values) => onConfirm({ plan, ...(until ? { comped_until: endOfDay(until) } : {}) }, values)}\n      onClose={onClose}\n    >\n      {(current !== null || usageLine !== undefined) && (\n        <div className=\"space-y-0.5 text-xs text-muted\" data-plan-current={current ?? undefined}>\n          {current !== null && <p>{labels.current(nameOf(current))}</p>}\n          {usageLine !== undefined && <p>{usageLine}</p>}\n        </div>\n      )}\n      <Select label={labels.plan} hint={labels.keepsItems} value={plan} onChange={(e) => setPlan(e.target.value)}>\n        {plan === \"\" && (\n          <option value=\"\" disabled>\n            {EMPTY_FORMATTED_VALUE}\n          </option>\n        )}\n        {options.map((option) => (\n          <option key={option.code} value={option.code}>\n            {option.name}\n          </option>\n        ))}\n      </Select>\n      {grantEnd && (\n        <DatePicker\n          label={labels.until}\n          hint={labels.untilHint}\n          value={until}\n          onChange={setUntil}\n          min={today}\n          clearable\n        />\n      )}\n    </AdminActionConfirm>\n  );\n}\n\n/* ── The answer ────────────────────────────────────────────────────────────── */\n\n/**\n * A `PlanChangeResponse` as the page reads it — server-kit 0.7's (§14.12), which gained\n * `previous_plan` nullable, `usage`, `kept_beta` and `comped_until`.\n */\nexport interface PlanChangeOutcome {\n  /** null: the account had no subscription. */\n  previous_plan: string | null;\n  plan: string;\n  over_limit: boolean;\n  /** The new plan's limits; null for unlimited. */\n  limits: Readonly<Record<string, number | null>>;\n  /** What the payer has, per dimension — the figures for the over-limit lines:\n   *  `{ budgets: 7 }`. */\n  usage: Readonly<Record<string, number>>;\n  /** A running beta kept its own end (§12.34). */\n  kept_beta?: boolean;\n  /** The grant's end as the change wrote it; null: no end, or no grant. */\n  comped_until?: string | null;\n}\n\n/** A line's tone: the app's toast kind. */\nexport type PlanChangeTone = \"success\" | \"info\" | \"warning\";\n\nexport interface PlanChangeLine {\n  tone: PlanChangeTone;\n  text: string;\n}\n\nexport interface PlanChangeResultOptions {\n  /** The app's word per dimension, for the over-limit figures: `{ budgets: \"Budgets\" }`.\n   *  A dimension without one is named by its key. */\n  dimensionLabels?: Readonly<Record<string, string>>;\n  /** How a figure is written. Default: a number in the kit's locale. */\n  formatValue?: (dimension: string, value: number) => string;\n}\n\n/**\n * The lines for a plan change's answer, each with its tone, for the app's toasts —\n * echoing the SERVER's before and after, not what was picked: a toast that reported the\n * request would say \"done\" to a write that landed differently (keksdose's rule).\n *\n *     const lines = usePlanChangeResult();\n *     for (const line of lines(res, planName)) toast[line.tone](line.text);\n *\n * - `changed(from, to)`, or `set(to)` with no previous plan (or the same one): success;\n * - a running beta that kept its end: `keptBeta`, info; else a grant's end:\n *   `untilDone(date)`, success;\n * - over the new limit: `overLimit`, then one figure line per dimension over it (\"Budgets:\n *   7 of 5\", `billing.limitUsageLine`), from `usage` and `limits`: warning. A `null`\n *   limit gives no figure line.\n */\nexport function usePlanChangeResult(): (\n  res: PlanChangeOutcome,\n  planName: (code: string) => string,\n  options?: PlanChangeResultOptions,\n) => PlanChangeLine[] {\n  const labels = useKitLabels(\"planChange\", DEFAULT_PLAN_CHANGE_LABELS);\n  const billing = useBillingLabels();\n  const locale = useKitLocale();\n  const dayText = useDayText();\n  return useCallback(\n    (res, planName, options = {}) => {\n      const { dimensionLabels, formatValue } = options;\n      const name = (raw: string) => planName(codeOf(raw) ?? raw);\n      const to = name(res.plan);\n      const from = codeOf(res.previous_plan);\n      const lines: PlanChangeLine[] = [\n        {\n          tone: \"success\",\n          text: from !== null && from !== codeOf(res.plan) ? labels.changed(name(from), to) : labels.set(to),\n        },\n      ];\n      if (res.kept_beta) lines.push({ tone: \"info\", text: labels.keptBeta });\n      else if (res.comped_until) lines.push({ tone: \"success\", text: labels.untilDone(dayText(res.comped_until)) });\n      if (res.over_limit) {\n        lines.push({ tone: \"warning\", text: labels.overLimit });\n        const figure = (dimension: string, value: number) =>\n          formatValue ? formatValue(dimension, value) : formatNumber(value, { locale });\n        // Read defensively: an app's server from before 0.7 sent neither.\n        for (const [dimension, limit] of Object.entries(res.limits ?? {})) {\n          const used = res.usage?.[dimension];\n          if (limit === null || used === undefined || used <= limit) continue;\n          lines.push({\n            tone: \"warning\",\n            text: billing.limitUsageLine(\n              dimensionLabels?.[dimension] ?? dimension,\n              figure(dimension, used),\n              figure(dimension, limit),\n            ),\n          });\n        }\n      }\n      return lines;\n    },\n    [labels, billing, locale, dayText],\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/admin/plan-change.tsx"],"sourcesContent":["import { isValidElement, useCallback, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport { useKitLabels, useKitLocale, type LabelOverride } from \"../i18n/kit-labels\";\nimport { pluralForm } from \"../i18n/plurals\";\nimport type { PluralForms } from \"../i18n/plurals\";\nimport { formatNumber, EMPTY_FORMATTED_VALUE } from \"../lib/format\";\nimport { todayIso } from \"../lib/dates\";\nimport type { DataTableColumn } from \"../components/data-table\";\nimport { DatePicker } from \"../components/date-picker\";\nimport { Tooltip } from \"../components/tooltip\";\nimport { Select } from \"../components/select\";\nimport { COMMIT_EXCEPT_BILLING } from \"../components/write-lock\";\nimport { useBillingLabels } from \"../billing/billing-labels\";\nimport type { SubscriptionStatus } from \"../billing/billing-labels\";\nimport { SubscriptionStatusChip } from \"../billing/subscription-status-chip\";\nimport { AdminActionConfirm } from \"./admin-action-confirm\";\nimport type { AdminActionConfirmValues } from \"./admin-action-confirm\";\nimport { personLabel, useDayText } from \"./admin-parts\";\nimport type { AdminPerson, MaybePromise } from \"./admin-parts\";\nimport { DEFAULT_PLAN_CHANGE_LABELS } from \"../billing/plan-change-labels\";\nimport type { PlanChangeLabels } from \"../billing/plan-change-labels\";\n\n/**\n * The operator's plan parts (docs/billing-harmonization.md §14.12, decision 27):\n * {@link planColumn} for the roster or the companies list, {@link PlanChangeConfirm}\n * for the grant, and {@link usePlanChangeResult} for what the answer says.\n *\n * All three apps have the route (`POST /admin/users/{id}/plan`, kastlan's\n * `POST /platform/companies/{id}/plan`) and server-kit's `PlanChangeRequest` /\n * `PlanChangeResponse`; only keksdose had a UI (`users-panel.tsx`, `PlanConfirm` in\n * `user-admin-confirm.tsx`), and these are its parts, lifted. The plan names are the\n * app's (§3.1): every part takes `planName` or the plans with their names. The plan\n * codes come from `GET /admin/plans` (kastlan `GET /platform/plans`), which answers\n * whatever the billing switch says.\n */\n\n// The words and their type live in billing/plan-change-labels, which holds no component\n// code (0.34, KS U8): PlanSwitchConfirm reads them too, and billing importing admin while\n// this module imports billing made the two folders import each other (refactor audit\n// 2026-10-30, MOD-6).\nexport type { PlanChangeLabels };\nexport { DEFAULT_PLAN_CHANGE_LABELS };\n\n/** A plan code as the parts compare it: lowercase (§12.16 — an older row's \"FREE\" is\n *  the same plan as \"free\"), and no code at all as null. */\nfunction codeOf(raw: string | null | undefined): string | null {\n  const code = (raw ?? \"\").trim().toLowerCase();\n  return code === \"\" ? null : code;\n}\n\n/* ── The column ────────────────────────────────────────────────────────────── */\n\n/** What a row's usage is, for the line under its plan: \"1/5\" — and since 0.34 what\n *  {@link PlanChangeConfirm}'s `usage` takes, for the same sentence in the dialog. */\nexport interface PlanColumnUsage {\n  used: number;\n  /** The plan's limit for it; `null` (unlimited, or none known): no line. */\n  limit: number | null;\n  /**\n   * The app's word for what is counted, as it reads after a number: \"budgets\" in \"1 of 5\n   * budgets\" — the word in a sentence, not a heading's \"Budgets\".\n   *\n   * Its plural forms (0.33.1, keksdose): `{ one: \"budget\", other: \"budgets\" }` — your\n   * catalogue's `_one` / `_other` pair, any CLDR category allowed, `other` for the rest\n   * ({@link PluralForms}). The column picks the form for the limit in the provider's\n   * locale, so a plan of one reads \"1 of 1 budget\". A plain string is used as it is,\n   * whatever the count.\n   */\n  label: string | PluralForms;\n}\n\nexport interface PlanColumnOptions<T> {\n  /** The column's key. Default `\"plan\"`. */\n  key?: string;\n  /** The row's plan code, read without case (§12.16); null for none. */\n  plan: (row: T) => string | null;\n  /** The plan's display name, the app's (§3.1). Gets the lowercase code. */\n  planName: (code: string) => string;\n  /** The row's standing, as a `SubscriptionStatusChip` beside the name. Left out, or\n   *  undefined for a row: no chip — billing off, where a status says nothing. */\n  status?: (row: T) => SubscriptionStatus | undefined;\n  /** The row's usage of its plan's limit: \"1/5\" under the name, \"1 of 5 budgets\" in\n   *  the tooltip (`planChange.usageOf`, with the label's form for the limit). Undefined\n   *  for a row, or a `null` limit: no line. */\n  usage?: (row: T) => PlanColumnUsage | undefined;\n  /** A select filter over these codes, each named by `planName`. Left out: none. */\n  filterPlans?: readonly string[];\n  /**\n   * The sort. Default: by the plan code (keksdose's, `users-panel.tsx:739`). A function:\n   * by its value — the catalogue's `sort` for rank order. `false`: not sortable.\n   *\n   * Client-side only, as every column's `sortBy`: a `DataTable` with `serverPagination`\n   * holds one page, so it sorts nothing itself — with `onSortsChange` it reports the\n   * column's `key` (default `\"plan\"`), and your server orders the rows by it.\n   */\n  sortBy?: false | ((row: T) => string | number | null | undefined);\n  /** The header's text. Default `planChange.column`. */\n  headerText?: string;\n  /** The words, already resolved. Default English; {@link usePlanColumn} reads the\n   *  provider's `planChange` namespace. */\n  labels?: LabelOverride<PlanChangeLabels>;\n}\n\n/**\n * A usage spelled out — `planChange.usageOf` with the figures in `locale` and the word in\n * the form the limit takes: \"1 of 1 budget\", \"Budgets: 1 von 5\". The column's tooltip\n * and the grant dialog's line both read it, so the rule lives once (round 0.34 C15).\n */\nfunction usageSentence(\n  usage: PlanColumnUsage & { limit: number },\n  usageOf: PlanChangeLabels[\"usageOf\"],\n  locale: string | undefined,\n): string {\n  const figure = (value: number) => formatNumber(value, { locale });\n  const word = typeof usage.label === \"string\" ? usage.label : pluralForm(usage.limit, usage.label, locale);\n  return usageOf(figure(usage.used), figure(usage.limit), word);\n}\n\n/** The cell: a component, so the figures follow the provider's locale. */\nfunction PlanCell({\n  code,\n  name,\n  status,\n  usage,\n  usageOf,\n}: {\n  code: string | null;\n  name: string;\n  status: SubscriptionStatus | undefined;\n  usage: PlanColumnUsage | undefined;\n  usageOf: PlanChangeLabels[\"usageOf\"];\n}) {\n  const locale = useKitLocale();\n  const figure = (value: number) => formatNumber(value, { locale });\n  return (\n    <div className=\"whitespace-nowrap\" data-plan={code ?? undefined}>\n      <div className=\"flex items-center gap-1.5\">\n        <span className={code ? \"font-medium\" : \"text-muted\"}>{name}</span>\n        {/* The standing at a glance (§6): the kit's word and tone, never colour alone. */}\n        {status !== undefined && <SubscriptionStatusChip status={status} size=\"xs\" />}\n      </div>\n      {usage && usage.limit !== null && (\n        // \"1/5\" under the plan, \"1 of 5 budgets\" in the tooltip: the sentence spelled out\n        // inline was the widest thing in keksdose's table.\n        <Tooltip label={usageSentence({ ...usage, limit: usage.limit }, usageOf, locale)}>\n          <span className=\"block text-xs tabular-nums text-muted\">\n            {figure(usage.used)}/{figure(usage.limit)}\n          </span>\n        </Tooltip>\n      )}\n    </div>\n  );\n}\n\n/**\n * The roster's (or the companies list's) plan column: the plan's display name, the\n * standing chip beside it while billing is on, and the usage under it — keksdose's\n * column, `users-panel.tsx:706-745`. Pass it in `userRosterColumns`' `extra`, or in\n * any `DataTable`'s columns:\n *\n *     extra: [planColumn<AdminUserRow>({\n *       plan: (u) => u.plan,\n *       planName,\n *       status: billingOn ? (u) => u.subscription?.status : undefined,\n *       usage: (u) => ({\n *         used: u.budgets_owned,\n *         limit: u.limits.budgets,\n *         label: { one: t(\"planUsage.budget_one\"), other: t(\"planUsage.budget_other\") },\n *       }),\n *       filterPlans: plans.map((p) => p.code),\n *     })]\n *\n * Pure: hand it resolved words, or use {@link usePlanColumn}.\n */\nexport function planColumn<T>(options: PlanColumnOptions<T>): DataTableColumn<T> {\n  const { key = \"plan\", plan, planName, status, usage, filterPlans, sortBy, headerText, labels: labelsProp } = options;\n  const labels: PlanChangeLabels = { ...DEFAULT_PLAN_CHANGE_LABELS, ...labelsProp };\n  const header = headerText ?? labels.column;\n  const nameOf = (code: string | null) => (code ? planName(code) : EMPTY_FORMATTED_VALUE);\n  return {\n    key,\n    header,\n    headerText: header,\n    cell: (row) => {\n      const code = codeOf(plan(row));\n      return (\n        <PlanCell\n          code={code}\n          name={nameOf(code)}\n          status={status?.(row)}\n          usage={usage?.(row)}\n          usageOf={labels.usageOf}\n        />\n      );\n    },\n    sortBy: sortBy === false ? undefined : (sortBy ?? ((row) => codeOf(plan(row)) ?? \"\")),\n    filter: filterPlans\n      ? {\n          type: \"select\",\n          getValue: (row) => codeOf(plan(row)) ?? \"\",\n          options: [...new Set(filterPlans.map((code) => codeOf(code)).filter((code) => code !== null))].map(\n            (code) => ({ value: code, label: planName(code) }),\n          ),\n        }\n      : undefined,\n  };\n}\n\n/**\n * {@link planColumn} with the `planChange` words from the provider, memoised on the\n * options — pass stable callbacks (`useCallback`), or the column is rebuilt on every\n * render.\n */\nexport function usePlanColumn<T>(options: PlanColumnOptions<T>): DataTableColumn<T> {\n  const { key, plan, planName, status, usage, filterPlans, sortBy, headerText, labels: labelsProp } = options;\n  const labels = useKitLabels(\"planChange\", DEFAULT_PLAN_CHANGE_LABELS, labelsProp);\n  return useMemo(\n    () => planColumn<T>({ key, plan, planName, status, usage, filterPlans, sortBy, headerText, labels }),\n    [key, plan, planName, status, usage, filterPlans, sortBy, headerText, labels],\n  );\n}\n\n/* ── The grant ─────────────────────────────────────────────────────────────── */\n\n/** What {@link PlanChangeConfirmProps.onConfirm} sends: server-kit's\n *  `PlanChangeRequest` without its `acknowledged`, which comes in `values`. */\nexport interface PlanChange {\n  /** The picked plan's code. */\n  plan: string;\n  /** The end of the free grant, as ISO UTC — only when one was picked. */\n  comped_until?: string;\n}\n\nexport interface PlanChangeConfirmProps {\n  /**\n   * Whom it is about — a user (`AdminActionTarget`), or kastlan's company, which has no\n   * address: its name is said instead (the level is `acknowledge`, so nothing is typed).\n   */\n  target: AdminPerson & { email?: string | null };\n  /** The plans to offer, in the catalogue's order, by their display names (§3.1) — from\n   *  `GET /admin/plans`. */\n  plans: readonly { code: string; name: string }[];\n  /** The account's plan now; null for none. The select opens on it. */\n  current: string | null;\n  /**\n   * What the account uses. The column's shape (0.34, keksdose N1) — `{ used, limit, label }`,\n   * the label a word or its plural forms — is spelled out as the column's tooltip is\n   * (`planChange.usageOf`, the word in the limit's form: \"1 of 1 budget\"); a `null` limit\n   * gives no line. Or the app's own sentence, as it is: \"3 of 5 budgets\".\n   */\n  usage?: PlanColumnUsage | ReactNode;\n  /** Offer \"Free until\" — only meaningful while billing is on, where a grant's end\n   *  means something to the payer. */\n  grantEnd?: boolean;\n  /**\n   * Sends it: `{plan}`, and `comped_until` only when an end was picked — the END of the\n   * picked day in the operator's time zone, as ISO UTC (a grant \"until 31 January\" lasts\n   * through it). No end: a grant without one, or on a running beta only the plan moves\n   * and the beta keeps its own end (§12.34). `values.acknowledged` is the body's\n   * `acknowledged`. A promise is handled as `AdminActionConfirm`'s.\n   */\n  onConfirm: (change: PlanChange, values: AdminActionConfirmValues) => MaybePromise;\n  onClose: (done: boolean) => void;\n  /** The app's words for a failure the kit has no code for. */\n  describeError?: (error: unknown) => ReactNode | undefined;\n  labels?: LabelOverride<PlanChangeLabels>;\n}\n\n/** The column's usage shape, told from a node: a plain object with the three fields. */\nfunction isPlanUsage(value: PlanChangeConfirmProps[\"usage\"]): value is PlanColumnUsage {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    !isValidElement(value) &&\n    \"used\" in value &&\n    \"limit\" in value &&\n    \"label\" in value\n  );\n}\n\n/** The end of the day `date` (YYYY-MM-DD) names, in this device's time zone, as ISO\n *  UTC — keksdose's `endOfDay` (`user-admin-confirm.tsx:44-46`). */\nfunction endOfDay(date: string): string {\n  return new Date(`${date}T23:59:59`).toISOString();\n}\n\n/**\n * An operator's plan change (§14.12): `AdminActionConfirm` at `acknowledge`, the line\n * with the current plan and the app's usage sentence, a plan select, and — with\n * `grantEnd` — the end of a free grant. The confirm is held while nothing would change.\n *\n * Exempt from a BILLING lock, built in (`COMMIT_EXCEPT_BILLING`, §12.36): a plan change\n * is an admin route (§12.13), and the operator's own account or company may be lapsed —\n * kastlan's review. A demo lock still holds it.\n */\nexport function PlanChangeConfirm({\n  target,\n  plans,\n  current: currentProp,\n  usage,\n  grantEnd = false,\n  onConfirm,\n  onClose,\n  describeError,\n  labels: labelsProp,\n}: PlanChangeConfirmProps) {\n  const labels = useKitLabels(\"planChange\", DEFAULT_PLAN_CHANGE_LABELS, labelsProp);\n  const locale = useKitLocale();\n  // Seeded from the account, so the picker opens on the truth and confirming without\n  // touching it is held rather than a silent free → free in the audit.\n  const current = codeOf(currentProp);\n  const [plan, setPlan] = useState(current ?? \"\");\n  const [until, setUntil] = useState(\"\");\n  // A grant ends today at the earliest; read once, not on every render. The kit's today,\n  // so it agrees with a server whose dev clock moved it (0.55).\n  const [today] = useState(todayIso);\n  const options = plans.map((p) => ({ code: codeOf(p.code) ?? p.code, name: p.name }));\n  const nameOf = (code: string) => options.find((p) => p.code === code)?.name ?? code;\n  // An account on a plan the catalogue no longer lists still opens on it.\n  if (current && !options.some((p) => p.code === current)) options.unshift({ code: current, name: current });\n  const unchanged = plan === \"\" || (plan === current && !until);\n  // A company has no address: the dialog says its name in the address's place.\n  const who = { ...target, email: target.email || personLabel(target, locale) };\n  // The column's shape in the column's sentence; the app's own sentence as it is.\n  const usageLine: ReactNode | undefined = isPlanUsage(usage)\n    ? usage.limit === null\n      ? undefined\n      : usageSentence({ ...usage, limit: usage.limit }, labels.usageOf, locale)\n    : usage;\n\n  return (\n    <AdminActionConfirm\n      level=\"acknowledge\"\n      tone=\"warning\"\n      target={who}\n      title={labels.title}\n      confirmLabel={labels.confirm}\n      confirmDisabledReason={unchanged ? labels.needsChange : undefined}\n      describeError={describeError}\n      commit={COMMIT_EXCEPT_BILLING}\n      onConfirm={(values) => onConfirm({ plan, ...(until ? { comped_until: endOfDay(until) } : {}) }, values)}\n      onClose={onClose}\n    >\n      {(current !== null || usageLine !== undefined) && (\n        <div className=\"space-y-0.5 text-xs text-muted\" data-plan-current={current ?? undefined}>\n          {current !== null && <p>{labels.current(nameOf(current))}</p>}\n          {usageLine !== undefined && <p>{usageLine}</p>}\n        </div>\n      )}\n      <Select label={labels.plan} hint={labels.keepsItems} value={plan} onChange={(e) => setPlan(e.target.value)}>\n        {plan === \"\" && (\n          <option value=\"\" disabled>\n            {EMPTY_FORMATTED_VALUE}\n          </option>\n        )}\n        {options.map((option) => (\n          <option key={option.code} value={option.code}>\n            {option.name}\n          </option>\n        ))}\n      </Select>\n      {grantEnd && (\n        <DatePicker\n          label={labels.until}\n          hint={labels.untilHint}\n          value={until}\n          onChange={setUntil}\n          min={today}\n          clearable\n        />\n      )}\n    </AdminActionConfirm>\n  );\n}\n\n/* ── The answer ────────────────────────────────────────────────────────────── */\n\n/**\n * A `PlanChangeResponse` as the page reads it — server-kit 0.7's (§14.12), which gained\n * `previous_plan` nullable, `usage`, `kept_beta` and `comped_until`.\n */\nexport interface PlanChangeOutcome {\n  /** null: the account had no subscription. */\n  previous_plan: string | null;\n  plan: string;\n  over_limit: boolean;\n  /** The new plan's limits; null for unlimited. */\n  limits: Readonly<Record<string, number | null>>;\n  /** What the payer has, per dimension — the figures for the over-limit lines:\n   *  `{ budgets: 7 }`. */\n  usage: Readonly<Record<string, number>>;\n  /** A running beta kept its own end (§12.34). */\n  kept_beta?: boolean;\n  /** The grant's end as the change wrote it; null: no end, or no grant. */\n  comped_until?: string | null;\n}\n\n/** A line's tone: the app's toast kind. */\nexport type PlanChangeTone = \"success\" | \"info\" | \"warning\";\n\nexport interface PlanChangeLine {\n  tone: PlanChangeTone;\n  text: string;\n}\n\nexport interface PlanChangeResultOptions {\n  /** The app's word per dimension, for the over-limit figures: `{ budgets: \"Budgets\" }`.\n   *  A dimension without one is named by its key. */\n  dimensionLabels?: Readonly<Record<string, string>>;\n  /** How a figure is written. Default: a number in the kit's locale. */\n  formatValue?: (dimension: string, value: number) => string;\n}\n\n/**\n * The lines for a plan change's answer, each with its tone, for the app's toasts —\n * echoing the SERVER's before and after, not what was picked: a toast that reported the\n * request would say \"done\" to a write that landed differently (keksdose's rule).\n *\n *     const lines = usePlanChangeResult();\n *     for (const line of lines(res, planName)) toast[line.tone](line.text);\n *\n * - `changed(from, to)`, or `set(to)` with no previous plan (or the same one): success;\n * - a running beta that kept its end: `keptBeta`, info; else a grant's end:\n *   `untilDone(date)`, success;\n * - over the new limit: `overLimit`, then one figure line per dimension over it (\"Budgets:\n *   7 of 5\", `billing.limitUsageLine`), from `usage` and `limits`: warning. A `null`\n *   limit gives no figure line.\n */\nexport function usePlanChangeResult(): (\n  res: PlanChangeOutcome,\n  planName: (code: string) => string,\n  options?: PlanChangeResultOptions,\n) => PlanChangeLine[] {\n  const labels = useKitLabels(\"planChange\", DEFAULT_PLAN_CHANGE_LABELS);\n  const billing = useBillingLabels();\n  const locale = useKitLocale();\n  const dayText = useDayText();\n  return useCallback(\n    (res, planName, options = {}) => {\n      const { dimensionLabels, formatValue } = options;\n      const name = (raw: string) => planName(codeOf(raw) ?? raw);\n      const to = name(res.plan);\n      const from = codeOf(res.previous_plan);\n      const lines: PlanChangeLine[] = [\n        {\n          tone: \"success\",\n          text: from !== null && from !== codeOf(res.plan) ? labels.changed(name(from), to) : labels.set(to),\n        },\n      ];\n      if (res.kept_beta) lines.push({ tone: \"info\", text: labels.keptBeta });\n      else if (res.comped_until) lines.push({ tone: \"success\", text: labels.untilDone(dayText(res.comped_until)) });\n      if (res.over_limit) {\n        lines.push({ tone: \"warning\", text: labels.overLimit });\n        const figure = (dimension: string, value: number) =>\n          formatValue ? formatValue(dimension, value) : formatNumber(value, { locale });\n        // Read defensively: an app's server from before 0.7 sent neither.\n        for (const [dimension, limit] of Object.entries(res.limits ?? {})) {\n          const used = res.usage?.[dimension];\n          if (limit === null || used === undefined || used <= limit) continue;\n          lines.push({\n            tone: \"warning\",\n            text: billing.limitUsageLine(\n              dimensionLabels?.[dimension] ?? dimension,\n              figure(dimension, used),\n              figure(dimension, limit),\n            ),\n          });\n        }\n      }\n      return lines;\n    },\n    [labels, billing, locale, dayText],\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/admin/user-roster.d.ts

@@ -85,6 +85,12 @@ export declare function adminUserStates(row: AdminUserStateFields): RosterState[
 /** The server's sort keys, which are the preset's column keys (§3.1). */
 export declare const USER_ROSTER_SORT_KEYS: readonly ["name", "email", "role", "created", "last_login"];
 export type UserRosterSortKey = (typeof USER_ROSTER_SORT_KEYS)[number];
+/** server-kit's `user_admin.DEFAULT_PAGE_SIZE`: the rows `GET /admin/users` answers when the
+ *  query names no `page_size` (keksdose audit F-63, which copied it into its users panel). */
+export declare const USER_ROSTER_PAGE_SIZE = 25;
+/** server-kit's `user_admin.MAX_PAGE_SIZE`: the most rows one page may ask for, which a
+ *  pager's "All" resolves to; a larger `page_size` is refused. */
+export declare const USER_ROSTER_MAX_PAGE_SIZE = 200;
 /**
  * The table's sort state as the `sort` query parameter of `GET /admin/users` (§3.1), in
  * the DataTable's own encoding ({@link encodeSorts}: `"last_login.desc"`), which

package/dist/admin/user-roster.js

@@ -23,6 +23,8 @@ function adminUserStates(row) {
   return out;
 }
 const USER_ROSTER_SORT_KEYS = ["name", "email", "role", "created", "last_login"];
+const USER_ROSTER_PAGE_SIZE = 25;
+const USER_ROSTER_MAX_PAGE_SIZE = 200;
 function userRosterSort(sorts) {
   const first = sorts.find((s) => USER_ROSTER_SORT_KEYS.includes(s.key));
   return first ? encodeSorts([first]) ?? void 0 : void 0;
@@ -255,6 +257,8 @@ function useUserRosterColumns({
 }
 export {
   DEFAULT_USER_ROSTER_LABELS,
+  USER_ROSTER_MAX_PAGE_SIZE,
+  USER_ROSTER_PAGE_SIZE,
   USER_ROSTER_SORT_KEYS,
   UserIdentityCell,
   UserRowActions,