@eifi1/ui-kit 0.34.0 → 0.35.0

package/README.md

@@ -94,6 +94,12 @@ currency picker and the language menu. It was a 5.6 MB hard dependency through 0
 installed into every consumer and imported by nothing — so it may still be in your tree
 transitively after upgrading. Depend on it explicitly if you render any of the three.
 
+**Shipping only the flags you render.** `@eifi1/ui-kit/currencies` (0.34.1) is the
+currency list as plain data — `CURRENCIES`, and `CURRENCY_COUNTRIES` (code → the lowercase
+country flag-icons names the flag by: `CHF` → `"ch"`, `EUR` → `"eu"`). It imports nothing,
+so a build script or a Vite plugin can import it in Node to generate a flag subset. Read
+it there, never out of a file under `dist/`: those move between versions.
+
 ## Wiring
 
 ### 1. Vite — dedupe shared singletons
@@ -226,8 +232,10 @@ 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, `--status-*`, a ring offset, and a money colour
-that needs a variant (the money classes below are plain and take none). The kit's own
+role with no utility: the chart colours and `--status-*`. 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
 markup follows this rule with no exceptions: `check:tokens` allows no `[var(--role)]` where
 a utility exists.
 
@@ -329,6 +337,35 @@ Theme values: `text-micro` (font size 0.625rem), `text-caption` (font size 0.687
 
 <!-- END GENERATED: styling -->
 
+### Lint: the role utilities in an app
+
+`@eifi1/ui-kit/eslint` (0.35) is `check:tokens`' role rule for an app's own markup: an ESLint
+flat-config plugin whose `role-utilities` rule reports a `[var(--role)]` class wherever that
+property has a utility for the role, and names it. It reads every string literal and
+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.
+
+```js
+// eslint.config.js
+import uiKit from "@eifi1/ui-kit/eslint";
+
+export default defineConfig([ // or tseslint.config(…): either takes it
+  // … the app's own entries, which say which files are linted …
+  uiKit.configs.recommended,
+]);
+```
+
+`configs.recommended` registers the plugin as `@eifi1/ui-kit` and turns
+`@eifi1/ui-kit/role-utilities` on as an error for every linted file except tests
+(`**/__tests__/**`, `*.test.*`, `*.spec.*`), which may name an old class to assert it is gone.
+To scope it yourself, register the plugin and set the rule:
+`{ files: ["src/**/*.tsx"], plugins: { "@eifi1/ui-kit": uiKit }, rules: { "@eifi1/ui-kit/role-utilities": "error" } }`.
+It runs on ESLint 9 and 10 and imports no package of its own.
+
 ### Text size and More contrast
 
 ONE scale on `<html>`: `data-text-size="normal" | "large" | "xlarge"` is 100 / 125 / 150 %
@@ -505,25 +542,27 @@ columns, strings and permissions (see the note at the top of `src/feedback/feedb
 
 <!-- BEGIN GENERATED: exports — node scripts/gen-export-inventory.mjs -->
 
-**1899 names from 302 modules** — 888 values and 1011 types. _Italic_ is a type-only export.
+**1878 names from 302 modules** — 868 values and 1010 types. _Italic_ is a type-only export.
 
 Generated from `dist/index.d.ts` by `node scripts/gen-export-inventory.mjs`; the count
 is pinned by `src/__tests__/public-surface.test.ts`. Do not edit between the markers.
 
 | Entry point | Names |
 |---|---|
-| `@eifi1/ui-kit` | 1899 |
-| `@eifi1/ui-kit/chart` | 105 |
+| `@eifi1/ui-kit` | 1878 |
+| `@eifi1/ui-kit/chart` | 92 |
 | `@eifi1/ui-kit/shell` | 77 |
-| `@eifi1/ui-kit/data-table` | 53 |
-| `@eifi1/ui-kit/wizard` | 25 |
+| `@eifi1/ui-kit/data-table` | 51 |
+| `@eifi1/ui-kit/wizard` | 24 |
 | `@eifi1/ui-kit/tour` | 7 |
-| `@eifi1/ui-kit/feedback` | 165 |
+| `@eifi1/ui-kit/feedback` | 164 |
 | `@eifi1/ui-kit/search` | 23 |
 | `@eifi1/ui-kit/dates` | 22 |
 | `@eifi1/ui-kit/table-text` | 14 |
-| `@eifi1/ui-kit/testing` | 10 |
-| `@eifi1/ui-kit/rhf` | 60 |
+| `@eifi1/ui-kit/currencies` | 3 |
+| `@eifi1/ui-kit/eslint` | 1 |
+| `@eifi1/ui-kit/testing` | 11 |
+| `@eifi1/ui-kit/rhf` | 48 |
 
 Everything below is reachable from the main `@eifi1/ui-kit` barrel. The subpaths are a
 re-slicing of it, never a second API.
@@ -584,7 +623,7 @@ re-slicing of it, never a second API.
 |---|---|
 | `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` | `ALTERNATIVE_PRESETS`, `applyTokenSet`, `DEFAULT_PRESET`, `DERIVED_PRESETS`, `IMPRINT_PRESET`, `PALETTES`, `presetById`, _`PalettePreset`_, _`TokenSet`_ |
+| `theme/palette-presets` | `applyTokenSet`, `DEFAULT_PRESET`, `DERIVED_PRESETS`, `IMPRINT_PRESET`, `PALETTES`, `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`_ |
@@ -608,7 +647,7 @@ re-slicing of it, never a second API.
 | `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`_ |
-| `components/field-base` | `DEFAULT_CHARACTER_COUNT_LABELS`, `DEFAULT_PASSWORD_REVEAL_LABELS`, `FIELD_BASE`, `FIELD_DISPLAY`, `FIELD_FLOATING_PAD`, `FIELD_INVALID`, `FIELD_TOUCH_TEXT`, `FIELD_TRIGGER`, `FIELD_WRITABLE_LOOK`, `FieldChevron`, `FLOATING_INPUT_CLASS`, `FLOATING_LABEL_CLASS`, `FloatingField`, `Label`, `resolvePasswordRevealLabels`, _`CharacterCountLabels`_, _`FieldChevronProps`_, _`FloatingFieldProps`_, _`LabelProps`_, _`PasswordRevealLabels`_ |
+| `components/field-base` | `DEFAULT_CHARACTER_COUNT_LABELS`, `DEFAULT_PASSWORD_REVEAL_LABELS`, `FIELD_BASE`, `FIELD_DISPLAY`, `FIELD_FLOATING_PAD`, `FIELD_INVALID`, `FIELD_TOUCH_TEXT`, `FIELD_TRIGGER`, `FIELD_WRITABLE_LOOK`, `FieldChevron`, `FLOATING_INPUT_CLASS`, `FLOATING_LABEL_CLASS`, `FloatingField`, `Label`, _`CharacterCountLabels`_, _`FieldChevronProps`_, _`FloatingFieldProps`_, _`LabelProps`_, _`PasswordRevealLabels`_ |
 | `components/input` | `Input`, _`InputProps`_ |
 | `components/select` | `Select`, _`SelectProps`_ |
 | `components/textarea` | `Textarea`, _`TextareaProps`_ |
@@ -638,7 +677,7 @@ re-slicing of it, never a second API.
 | `components/tooltip` | `placeTooltip`, `Tooltip`, _`TooltipPlacement`_, _`TooltipProps`_, _`TooltipSide`_, _`TooltipSize`_, _`TooltipTap`_, _`TooltipViewport`_ |
 | `components/user-avatar` | `avatarInitials`, `UserAvatar`, _`UserAvatarBadge`_, _`UserAvatarProps`_ |
 | `components/settings-fields` | `ContrastSetting`, `LanguageSetting`, `TextSizeSetting`, `ThemeSetting`, _`ContrastSettingProps`_, _`LanguageSettingProps`_, _`TextSizeSettingProps`_, _`ThemeSettingProps`_, _`ThemeSettingSelectProps`_, _`ThemeSettingToggleProps`_ |
-| `components/field-sync` | `DEFAULT_FIELD_SYNC_LABELS`, `FIELD_SYNC_FRAME`, `FIELD_SYNC_SAVED_MS`, `FieldSyncIndicator`, `FieldSyncRow`, `resolveFieldSyncLabels`, `useFieldSync`, _`FieldSyncIndicatorProps`_, _`FieldSyncLabels`_, _`FieldSyncRowProps`_, _`FieldSyncState`_, _`UseFieldSyncOptions`_, _`UseFieldSyncReturn`_ |
+| `components/field-sync` | `DEFAULT_FIELD_SYNC_LABELS`, `FIELD_SYNC_FRAME`, `FIELD_SYNC_SAVED_MS`, `FieldSyncIndicator`, `FieldSyncRow`, `useFieldSync`, _`FieldSyncIndicatorProps`_, _`FieldSyncLabels`_, _`FieldSyncRowProps`_, _`FieldSyncState`_, _`UseFieldSyncOptions`_, _`UseFieldSyncReturn`_ |
 | `components/month-picker` | `DEFAULT_MONTH_PICKER_LABELS`, `MonthPicker`, _`MonthPickerLabels`_, _`MonthPickerProps`_ |
 | `components/checkbox` | `Checkbox`, _`CheckboxProps`_ |
 | `components/switch` | `Switch`, _`SwitchProps`_, _`SwitchSize`_ |
@@ -667,7 +706,6 @@ re-slicing of it, never a second API.
 | `components/treemap` | `fitLabel`, `Treemap`, `TreemapCell`, _`TreemapCellProps`_, _`TreemapNode`_, _`TreemapProps`_ |
 | `components/series-chart` | `resolveTooltipPlacement`, `SeriesChart`, `seriesLegendEntries`, `StaticSeriesChart`, _`SeriesChartAxis`_, _`SeriesChartHit`_, _`SeriesChartMarker`_, _`SeriesChartPoint`_, _`SeriesChartProps`_, _`SeriesChartReference`_, _`SeriesChartRow`_, _`SeriesChartSeries`_, _`SeriesChartSpan`_, _`SeriesChartTickValues`_, _`SeriesChartTone`_, _`SeriesChartTooltip`_, _`SeriesChartTooltipPlacement`_, _`SeriesChartType`_, _`SeriesChartX`_, _`SeriesChartXTick`_, _`SeriesChartXValue`_, _`SeriesLegendAxes`_ |
 | `components/chart-height` | _`ChartHeight`_ |
-| `components/chart-zoom` | `axisExtent`, `DEFAULT_Y_AXIS`, `defaultZoomAxes`, `fitXToY`, `fitYToX`, `NO_ZOOM`, `selectionFromDrag`, `withChartZoom`, `ZOOM_MIN_DRAG`, `ZOOM_SQUARE_ENOUGH`, `zoomAfter`, `zoomAxesFor`, `zoomDomains` |
 | `components/chart-zoom-core` | `SharedXZoom`, _`ZoomAxes`_, _`ZoomAxesSetting`_, _`ZoomBinding`_, _`ZoomDrag`_, _`ZoomFitSeries`_, _`ZoomFitSource`_, _`ZoomRow`_, _`ZoomSelection`_, _`ZoomState`_, _`ZoomTarget`_ |
 | `components/toggle-legend` | `LegendColumn`, `LegendGroup`, `StaticLegend`, `STEP_DASH`, `STROKE_PATTERNS`, `strokeDash`, `toggleHidden`, `ToggleLegend`, _`LegendEntry`_, _`StaticLegendProps`_, _`ToggleLegendProps`_ |
 | `components/facing-pair` | `FACING_SIDES`, `facingAxes`, `facingBand`, `facingHeadingPad`, _`FacingSide`_ |
@@ -679,7 +717,7 @@ re-slicing of it, never a second API.
 | `components/toggle-group` | `ToggleGroup`, _`ToggleGroupBaseProps`_, _`ToggleGroupClearableProps`_, _`ToggleGroupProps`_, _`ToggleGroupRequiredProps`_, _`ToggleOption`_ |
 | `components/nav-pills` | `NavPills`, _`NavPillItem`_, _`NavPillLinkProps`_, _`NavPillsCurrent`_, _`NavPillsProps`_ |
 | `components/chip` | `Chip`, _`ChipHue`_, _`ChipLinkProps`_, _`ChipProps`_, _`ChipShape`_, _`ChipSize`_, _`ChipTone`_, _`ChipVariant`_ |
-| `components/chip-input` | `ChipInput`, `DEFAULT_CHIP_INPUT_LABELS`, `resolveChipInputLabels`, _`ChipInputLabels`_, _`ChipInputProps`_ |
+| `components/chip-input` | `ChipInput`, `DEFAULT_CHIP_INPUT_LABELS`, _`ChipInputLabels`_, _`ChipInputProps`_ |
 | `components/wizard-stepper` | `WizardStepper` |
 | `components/hover-menu` | `HoverMenu`, _`HoverMenuProps`_ |
 | `components/modal` | `Modal`, `ModalCloseContext`, `useBackdropClose`, _`ModalProps`_ |
@@ -732,9 +770,9 @@ re-slicing of it, never a second API.
 | `components/country-select` | `CountrySelect`, `DEFAULT_COUNTRY_SELECT_LABELS`, _`CountrySelectLabels`_, _`CountrySelectProps`_ |
 | `components/iban-input` | `DEFAULT_IBAN_INPUT_LABELS`, `IbanInput`, _`IbanInputLabels`_, _`IbanInputProps`_ |
 | `components/phone-input` | `DEFAULT_PHONE_INPUT_LABELS`, `PhoneInput`, _`PhoneInputLabels`_, _`PhoneInputProps`_ |
-| `components/field-strip` | `FieldStrip`, _`FieldStripIds`_, _`FieldStripPad`_, _`FieldStripProps`_ |
+| `components/field-strip` | `FieldStrip`, _`FieldStripIds`_, _`FieldStripProps`_ |
 | `components/column-mapper` | `ColumnMapper`, `ColumnRoleTable`, `DEFAULT_COLUMN_MAPPER_LABELS`, _`ColumnMapperLabels`_, _`ColumnMapperProps`_, _`ColumnRoleTableBodyProps`_, _`ColumnRoleTableProps`_, _`ColumnRoleTableRowProps`_ |
-| `components/data-table-labels` | `DEFAULT_DATA_TABLE_LABELS`, `missingDataTableLabels`, `resolveDataTableLabels`, _`DataTableLabels`_ |
+| `components/data-table-labels` | `DEFAULT_DATA_TABLE_LABELS`, _`DataTableLabels`_ |
 | `components/data-table-sort` | `decodeSorts`, `encodeSorts`, `nextSorts`, `normalizeSorts`, _`SortCycle`_, _`SortDir`_, _`SortState`_, _`SortStepOptions`_ |
 | `components/data-table-filters` | `dateFilter`, `decodeFilterValue`, `decodeFilterValueOfType`, `defaultFilterState`, `encodeFilterValue`, `filterHref`, `isFilterActive`, `numberFilter`, `resolveFilter`, `rowMatches`, `selectFilter`, `textFilter`, _`ColumnFilter`_, _`FilterValue`_ |
 | `components/data-table-pagination` | `PAGE_SIZE_OPTIONS`, `Pagination` |
@@ -801,7 +839,7 @@ re-slicing of it, never a second API.
 | `feedback/feedback-attachment` | `DEFAULT_ATTACHMENT_ACCEPT`, `DEFAULT_FEEDBACK_ATTACHMENT_LABELS`, `DEFAULT_MAX_ATTACHMENT_BYTES`, `DEFAULT_MAX_ATTACHMENTS`, `FeedbackAttachmentField`, `pastedName`, _`FeedbackAttachmentError`_, _`FeedbackAttachmentErrorInfo`_, _`FeedbackAttachmentFieldLabels`_, _`FeedbackAttachmentFieldMultipleProps`_, _`FeedbackAttachmentFieldProps`_, _`FeedbackAttachmentFieldRefsProps`_, _`FeedbackAttachmentFieldSingleProps`_, _`FeedbackAttachmentRef`_, _`FeedbackAttachmentRefsError`_ |
 | `feedback/feedback-dialog` | `DEFAULT_FEEDBACK_DIALOG_LABELS`, `FeedbackDialog`, _`FeedbackAttachmentLabels`_, _`FeedbackCategoryOption`_, _`FeedbackDialogLabels`_, _`FeedbackDialogMultipleProps`_, _`FeedbackDialogProps`_, _`FeedbackDialogSingleProps`_, _`FeedbackDialogTextLabels`_, _`FeedbackMultipleSubmission`_, _`FeedbackSubmission`_, _`FeedbackSubmitHint`_ |
 | `feedback/feedback-inbox` | `FeedbackCategoryBadge`, `FeedbackDetail`, `FeedbackDetailSection`, `FeedbackNoteEditor`, `FeedbackProse`, `FeedbackStatusBadge`, `FeedbackStatusTransitions`, _`FeedbackNoteAttachment`_ |
-| `feedback/feedback-thread` | `ChatComposer`, `DEFAULT_FEEDBACK_COMPOSER_LABELS`, `DEFAULT_FEEDBACK_THREAD_LABELS`, `FeedbackComposer`, `FeedbackThread`, _`ChatComposerHandle`_, _`ChatComposerLabels`_, _`ChatComposerProps`_, _`ChatComposerSlotContext`_, _`FeedbackComposerAttachment`_, _`FeedbackComposerHandle`_, _`FeedbackComposerLabels`_, _`FeedbackComposerProps`_, _`FeedbackComposerSlotContext`_, _`FeedbackThreadAttachment`_, _`FeedbackThreadEvent`_, _`FeedbackThreadItem`_, _`FeedbackThreadLabels`_, _`FeedbackThreadMessage`_, _`FeedbackThreadProps`_ |
+| `feedback/feedback-thread` | `ChatComposer`, `DEFAULT_FEEDBACK_COMPOSER_LABELS`, `DEFAULT_FEEDBACK_THREAD_LABELS`, `FeedbackThread`, _`ChatComposerHandle`_, _`ChatComposerLabels`_, _`ChatComposerProps`_, _`ChatComposerSlotContext`_, _`FeedbackComposerAttachment`_, _`FeedbackComposerHandle`_, _`FeedbackComposerLabels`_, _`FeedbackComposerProps`_, _`FeedbackComposerSlotContext`_, _`FeedbackThreadAttachment`_, _`FeedbackThreadEvent`_, _`FeedbackThreadItem`_, _`FeedbackThreadLabels`_, _`FeedbackThreadMessage`_, _`FeedbackThreadProps`_ |
 | `feedback/feedback-record` | `appendRework`, `attachmentName`, `FEEDBACK_ATTACHMENT_ACCEPT`, `FEEDBACK_AUTHOR_EDITABLE_STATUSES`, `FEEDBACK_AWAITING_STATUSES`, `FEEDBACK_PICKABLE_CATEGORIES`, `FEEDBACK_REWORKABLE_STATUSES`, `feedbackAttachmentLine`, `isImageAttachment`, `replaceDescription`, `reworkCount`, `splitBodyAttachments`, `splitDescription`, _`FeedbackContext`_, _`FeedbackEnvironment`_, _`FeedbackRecord`_ |
 | `feedback/feedback-labels` | `DEFAULT_FEEDBACK_CATEGORY_LABELS`, `DEFAULT_FEEDBACK_STATUS_LABELS`, `DEFAULT_FEEDBACK_TOAST_LABELS`, `useFeedbackCategoryLabels`, `useFeedbackStatusLabels`, `useFeedbackToastLabels`, _`FeedbackCategoryLabels`_, _`FeedbackStatusLabels`_, _`FeedbackToastLabels`_ |
 | `feedback/feedback-status-undo` | `FEEDBACK_UNDO_DURATION`, `useFeedbackStatusUndo`, _`FeedbackStatusChange`_, _`FeedbackStatusMutate`_, _`FeedbackStatusPatch`_, _`FeedbackStatusRow`_, _`FeedbackStatusUndoOptions`_ |
@@ -819,7 +857,7 @@ re-slicing of it, never a second API.
 
 | Module | Exports |
 |---|---|
-| `wizard/types` | `DEFAULT_WIZARD_LABELS`, `resolveWizardLabels`, _`FieldErrors`_, _`StepStatus`_, _`SummaryItem`_, _`SummarySection`_, _`UseWizardOptions`_, _`UseWizardReturn`_, _`ValidateResult`_, _`WizardLabels`_, _`WizardStepConfig`_, _`WizardUrlSync`_ |
+| `wizard/types` | `DEFAULT_WIZARD_LABELS`, _`FieldErrors`_, _`StepStatus`_, _`SummaryItem`_, _`SummarySection`_, _`UseWizardOptions`_, _`UseWizardReturn`_, _`ValidateResult`_, _`WizardLabels`_, _`WizardStepConfig`_, _`WizardUrlSync`_ |
 | `wizard/use-wizard` | `useWizard` |
 | `wizard/wizard-context` | `useOptionalWizardContext`, `useWizardContext`, `useWizardNextGate`, `useWizardStepValidate`, `WizardContextProvider`, _`WizardContextValue`_ |
 | `wizard/validation` | `requiredFieldsValidator`, _`RequiredFieldSpec`_ |
@@ -915,6 +953,12 @@ re-slicing of it, never a second API.
 | `demo/demo-banner` | `DemoBanner`, _`DemoBannerProps`_ |
 | `demo/demo-ended` | `DemoEnded`, _`DemoEndedProps`_ |
 
+### root
+
+| Module | Exports |
+|---|---|
+| `currencies` | `CURRENCY_COUNTRIES` |
+
 <!-- END GENERATED: exports -->
 
 ## Forms / refs
@@ -926,36 +970,36 @@ element that takes focus: the `<input>` of `Input`, `NumberField`, `AmountInput`
 on its checked option. So they work directly with react-hook-form:
 `<Input {...field} />` (from `Controller`/`register`) attaches RHF's ref, giving
 focus-and-scroll-to-error for free. A component that spreads its props onto an element
-(`Card`, `EmptyState`, `PageHeader`, …) takes that element's `ref` too. For the full
-`FormField`/`FormControl` scaffolding, see `@eifi1/ui-kit/rhf` below.
+(`Card`, `EmptyState`, `PageHeader`, …) takes that element's `ref` too. For fields bound
+to a react-hook-form form in one line each, see `@eifi1/ui-kit/rhf` below.
 
 ### react-hook-form — `@eifi1/ui-kit/rhf` (optional)
 
-A thin adapter in shadcn's `form.tsx` shape, and the only entry that needs
-`react-hook-form` (an **optional** peer, `^7.55.0`). The main barrel does not import it,
-so apps without a form library install nothing.
+The react-hook-form adapter: `Form`, the bound fields (`RhfTextField`, `RhfNumberField`,
+`RhfMoneyField`, `RhfDateField`, `RhfSelect`, `RhfCombobox`, `RhfCheckbox`, …) and
+`RhfField` for a control of your own, and the only entry that needs `react-hook-form` (an
+**optional** peer, `^7.55.0`). The main barrel does not import it, so apps without a form
+library install nothing.
 
 ```tsx
-import { Form, FormField, FormItem, FormLabel, FormControl, FormDescription, FormMessage } from "@eifi1/ui-kit/rhf";
+import { Form, RhfField, RhfNumberField, RhfTextField } from "@eifi1/ui-kit/rhf";
 
 <Form {...form}>
-  <FormField control={form.control} name="amount" render={({ field }) => (
-    <FormItem>
-      <FormLabel required>Amount</FormLabel>
-      <FormControl>
-        <NumberField value={field.value} onCommit={field.onChange} />
-      </FormControl>
-      <FormMessage />
-    </FormItem>
+  <RhfTextField name="title" label="Title" required rules={{ required: "Give it a title." }} />
+  <RhfNumberField name="amount" label="Amount" unit="EUR" hint="Net of VAT." />
+  <RhfField name="street" label="Street" render={({ field, invalid }) => (
+    <AddressAutocomplete {...field} invalid={invalid} />
   )} />
 </Form>
 ```
 
-`FormControl` gives its one child `id`, `aria-describedby` (only the description and
-message actually rendered, merged after the child's own) and `aria-invalid` — which every
-kit field now also PAINTS from, so no extra `invalid` prop is needed. `FormMessage` shows
-the form's own message; the kit adds no text. `useFormField()` exposes the ids and field
-state for custom parts.
+Each bound field is a label, the control, a hint and the form's message wired to each
+other: the control's `aria-describedby` names only the hint and message actually rendered
+(merged after the control's own), `aria-invalid` and `invalid` come from the field state,
+and `field.ref` reaches the focusable element, so a failed submit focuses the first field
+in error. The message is the form's own; the kit adds no text. The shadcn scaffold the
+adapter started as (`FormField`, `FormItem`, `FormLabel`, `FormControl`,
+`FormDescription`, `FormMessage`, `useFormField`) left the public surface in 0.35.
 
 ### Pasted and imported tables — `@eifi1/ui-kit/table-text`
 

package/dist/billing/billing-banner.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentPropsWithoutRef } from "react";
+import type { ComponentPropsWithRef } from "react";
 import type { LabelOverride } from "../i18n/kit-labels.js";
 import type { AlertSize, AlertTone } from "../components/alert-banner.js";
 import type { BillingLabels } from "./billing-labels.js";
@@ -15,7 +15,10 @@ import type { BillingLabels } from "./billing-labels.js";
  * - `processing` — back from checkout before the webhook landed (§12.21).
  */
 export type BillingBannerKind = "trial-ending" | "grant-ending" | "payment-failed" | "plan-ended" | "guest" | "processing";
-interface BillingBannerBaseProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "onClick"> {
+/** A `div`'s props, `ref` included since 0.35 (round 0.35 R4, the follow-up to API-2): they
+ *  go on to the {@link AlertBanner}, so the ref is the banner's `<div>` — with an × too,
+ *  since the banner has no `href` or `onClick` that would make its row a link or a button. */
+interface BillingBannerBaseProps extends Omit<ComponentPropsWithRef<"div">, "children" | "onClick"> {
     /**
      * Over the kind's tone: `trial-ending` and `grant-ending` are `info` until the last
      * three days and `warning` in them; `payment-failed` is `danger` (money did not

package/dist/billing/billing-banner.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/billing/billing-banner.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef, ReactNode } from \"react\";\nimport { CreditCard, Hourglass, PencilOff } from \"lucide-react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport type { AlertSize, AlertTone } from \"../components/alert-banner\";\nimport { Button } from \"../components/button\";\nimport { Spinner } from \"../components/spinner\";\nimport { useBillingLabels } from \"./billing-labels\";\nimport type { BillingLabels } from \"./billing-labels\";\n\n/**\n * The billing banners (docs/billing-harmonization.md §3.3, §7, §12.6, §12.21):\n *\n * - `trial-ending` — from 7 days before `trial_ends_at` (§3.3);\n * - `grant-ending` — from 7 days before `comped_until`: a beta user's 12 months, an\n *   operator's grant;\n * - `payment-failed` — from the first failed payment (`past_due`), while the provider\n *   retries;\n * - `plan-ended` — out of good standing: read-only, never locked (§2.3);\n * - `guest` — a guest in someone else's read-only item (§12.6);\n * - `processing` — back from checkout before the webhook landed (§12.21).\n */\nexport type BillingBannerKind =\n  | \"trial-ending\"\n  | \"grant-ending\"\n  | \"payment-failed\"\n  | \"plan-ended\"\n  | \"guest\"\n  | \"processing\";\n\ninterface BillingBannerBaseProps extends Omit<ComponentPropsWithoutRef<\"div\">, \"children\" | \"onClick\"> {\n  /**\n   * Over the kind's tone: `trial-ending` and `grant-ending` are `info` until the last\n   * three days and `warning` in them; `payment-failed` is `danger` (money did not\n   * arrive — kastlan's past-due strip was red); `plan-ended` is `warning`, a state with\n   * everything still there rather than an error; `guest` and `processing` are `info`.\n   */\n  tone?: AlertTone;\n  /** `strip` (default): the band under the top bar, on every page. `box`: the same\n   *  message on the subscription page itself. */\n  variant?: \"strip\" | \"box\";\n  /** Default `sm` for a strip (the demo's banner), `md` for a box. */\n  size?: AlertSize;\n  /**\n   * Where the action goes — the subscription page, say. The app's action, as an `href`\n   * or as {@link onAction}; without either there is no button. Never a write-locked\n   * commit: billing itself always works (§3.3).\n   */\n  actionHref?: string;\n  /** What the action does — the app's portal call (`POST /billing/portal`, then off to\n   *  its `url`): for `payment-failed` with `{target: \"payment_method\"}`, the portal's\n   *  page for the card (§14.5); for `processing`, `useCheckoutProcessing`'s\n   *  `checkAgain`. The kit sends no request. */\n  onAction?: () => void;\n  /**\n   * Over the kind's action words: \"Choose a plan\" (trial, grant, plan ended), \"Update\n   * payment method\" (payment failed), \"Check again\" (processing). The guest banner has\n   * none of its own: an action there needs this.\n   */\n  actionLabel?: string;\n  /** The action is under way: the button's spinner, no second press. */\n  actionPending?: boolean;\n  /** An × that calls this; the app removes the banner and remembers that it did. */\n  onDismiss?: () => void;\n  dismissLabel?: string;\n  /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */\n  labels?: LabelOverride<BillingLabels>;\n}\n\nexport type BillingBannerProps = BillingBannerBaseProps &\n  (\n    | {\n        kind: \"trial-ending\" | \"grant-ending\";\n        /** Calendar days left — `billingDaysLeft(trial_ends_at)`. 0 is today. */\n        daysLeft: number;\n        item?: never;\n      }\n    | {\n        kind: \"guest\";\n        /** The item's own name (\"Household 2026\"), or nothing. NEVER the owner's status:\n         *  the banner says \"for now\" and nothing more (§12.6). */\n        item?: string;\n        daysLeft?: never;\n      }\n    | {\n        kind: \"payment-failed\" | \"plan-ended\" | \"processing\";\n        daysLeft?: never;\n        item?: never;\n      }\n  );\n\n/** The last days, in which an ending trial or grant turns from news into a warning. */\nconst LAST_DAYS = 3;\n\nfunction defaultTone(kind: BillingBannerKind, daysLeft: number | undefined): AlertTone {\n  switch (kind) {\n    case \"trial-ending\":\n    case \"grant-ending\":\n      return (daysLeft ?? 0) > LAST_DAYS ? \"info\" : \"warning\";\n    case \"payment-failed\":\n      return \"danger\";\n    case \"plan-ended\":\n      return \"warning\";\n    default:\n      return \"info\";\n  }\n}\n\n/**\n * One of the billing banners, as a kit `AlertBanner` strip (§7): the kind's sentence, its\n * glyph and tone, and the app's action. Carries `data-billing-banner` with the kind.\n *\n * The app decides WHICH banner shows, from `GET /billing/overview` (and hides all of them\n * while billing is off, §4); the kit only says it. A guest's banner takes no status at\n * all — the type does not let one in — so the owner's payment state cannot leak into it\n * by a wrong prop (§12.6).\n *\n * `processing` is a live region (`role=\"status\"`): it appears when the person comes back\n * from checkout and goes when the overview catches up (§12.21), and a screen reader\n * should hear both. The others are page furniture, role-less as the strip is.\n */\nexport function BillingBanner(props: BillingBannerProps) {\n  const {\n    kind,\n    daysLeft,\n    item,\n    tone,\n    variant = \"strip\",\n    size,\n    actionHref,\n    onAction,\n    actionLabel,\n    actionPending,\n    onDismiss,\n    dismissLabel,\n    labels: labelsProp,\n    role,\n    ...rest\n  } = props;\n  const labels = useBillingLabels(labelsProp);\n  const days = Math.max(0, Math.floor(daysLeft ?? 0));\n\n  let text: string;\n  let icon: ReactNode;\n  let ownAction: string | undefined;\n  switch (kind) {\n    case \"trial-ending\":\n      text = labels.trialEnding(days);\n      icon = <Hourglass />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"grant-ending\":\n      text = labels.grantEnding(days);\n      icon = <Hourglass />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"payment-failed\":\n      text = labels.paymentFailed;\n      icon = <CreditCard />;\n      ownAction = labels.updatePayment;\n      break;\n    case \"plan-ended\":\n      text = labels.planEnded;\n      icon = <PencilOff />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"guest\":\n      text = labels.guestReadOnly(item);\n      icon = <PencilOff />;\n      ownAction = undefined;\n      break;\n    case \"processing\":\n      text = labels.processing;\n      icon = <Spinner label={null} />;\n      ownAction = labels.checkAgain;\n      break;\n  }\n\n  const words = actionLabel ?? ownAction;\n  const action =\n    words === undefined || (actionHref === undefined && onAction === undefined) ? undefined : actionHref !== undefined ? (\n      <Button href={actionHref} variant=\"secondary\" size=\"sm\">\n        {words}\n      </Button>\n    ) : (\n      <Button type=\"button\" variant=\"secondary\" size=\"sm\" onClick={onAction} pending={actionPending}>\n        {words}\n      </Button>\n    );\n\n  return (\n    <AlertBanner\n      {...rest}\n      role={role ?? (kind === \"processing\" ? \"status\" : undefined)}\n      variant={variant}\n      size={size ?? (variant === \"strip\" ? \"sm\" : \"md\")}\n      tone={tone ?? defaultTone(kind, days)}\n      icon={icon}\n      action={action}\n      onDismiss={onDismiss}\n      dismissLabel={dismissLabel}\n      data-billing-banner={kind}\n    >\n      {text}\n    </AlertBanner>\n  );\n}\n"],"mappings":";AAqJa;AApJb,SAAS,YAAY,WAAW,iBAAiB;AAGjD,SAAS,mBAAmB;AAE5B,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,wBAAwB;AAqFjC,MAAM,YAAY;AAElB,SAAS,YAAY,MAAyB,UAAyC;AACrF,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,cAAQ,YAAY,KAAK,YAAY,SAAS;AAAA,IAChD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAeO,SAAS,cAAc,OAA2B;AACvD,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,SAAS,iBAAiB,UAAU;AAC1C,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,YAAY,CAAC,CAAC;AAElD,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,OAAO,YAAY,IAAI;AAC9B,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO,YAAY,IAAI;AAC9B,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,cAAW;AACnB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO,cAAc,IAAI;AAChC,aAAO,oBAAC,aAAU;AAClB,kBAAY;AACZ;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,WAAQ,OAAO,MAAM;AAC7B,kBAAY,OAAO;AACnB;AAAA,EACJ;AAEA,QAAM,QAAQ,eAAe;AAC7B,QAAM,SACJ,UAAU,UAAc,eAAe,UAAa,aAAa,SAAa,SAAY,eAAe,SACvG,oBAAC,UAAO,MAAM,YAAY,SAAQ,aAAY,MAAK,MAChD,iBACH,IAEA,oBAAC,UAAO,MAAK,UAAS,SAAQ,aAAY,MAAK,MAAK,SAAS,UAAU,SAAS,eAC7E,iBACH;AAGJ,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,MAAM,SAAS,SAAS,eAAe,WAAW;AAAA,MAClD;AAAA,MACA,MAAM,SAAS,YAAY,UAAU,OAAO;AAAA,MAC5C,MAAM,QAAQ,YAAY,MAAM,IAAI;AAAA,MACpC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,uBAAqB;AAAA,MAEpB;AAAA;AAAA,EACH;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/billing/billing-banner.tsx"],"sourcesContent":["import type { ComponentPropsWithRef, ReactNode } from \"react\";\nimport { CreditCard, Hourglass, PencilOff } from \"lucide-react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport type { AlertSize, AlertTone } from \"../components/alert-banner\";\nimport { Button } from \"../components/button\";\nimport { Spinner } from \"../components/spinner\";\nimport { useBillingLabels } from \"./billing-labels\";\nimport type { BillingLabels } from \"./billing-labels\";\n\n/**\n * The billing banners (docs/billing-harmonization.md §3.3, §7, §12.6, §12.21):\n *\n * - `trial-ending` — from 7 days before `trial_ends_at` (§3.3);\n * - `grant-ending` — from 7 days before `comped_until`: a beta user's 12 months, an\n *   operator's grant;\n * - `payment-failed` — from the first failed payment (`past_due`), while the provider\n *   retries;\n * - `plan-ended` — out of good standing: read-only, never locked (§2.3);\n * - `guest` — a guest in someone else's read-only item (§12.6);\n * - `processing` — back from checkout before the webhook landed (§12.21).\n */\nexport type BillingBannerKind =\n  | \"trial-ending\"\n  | \"grant-ending\"\n  | \"payment-failed\"\n  | \"plan-ended\"\n  | \"guest\"\n  | \"processing\";\n\n/** A `div`'s props, `ref` included since 0.35 (round 0.35 R4, the follow-up to API-2): they\n *  go on to the {@link AlertBanner}, so the ref is the banner's `<div>` — with an × too,\n *  since the banner has no `href` or `onClick` that would make its row a link or a button. */\ninterface BillingBannerBaseProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"onClick\"> {\n  /**\n   * Over the kind's tone: `trial-ending` and `grant-ending` are `info` until the last\n   * three days and `warning` in them; `payment-failed` is `danger` (money did not\n   * arrive — kastlan's past-due strip was red); `plan-ended` is `warning`, a state with\n   * everything still there rather than an error; `guest` and `processing` are `info`.\n   */\n  tone?: AlertTone;\n  /** `strip` (default): the band under the top bar, on every page. `box`: the same\n   *  message on the subscription page itself. */\n  variant?: \"strip\" | \"box\";\n  /** Default `sm` for a strip (the demo's banner), `md` for a box. */\n  size?: AlertSize;\n  /**\n   * Where the action goes — the subscription page, say. The app's action, as an `href`\n   * or as {@link onAction}; without either there is no button. Never a write-locked\n   * commit: billing itself always works (§3.3).\n   */\n  actionHref?: string;\n  /** What the action does — the app's portal call (`POST /billing/portal`, then off to\n   *  its `url`): for `payment-failed` with `{target: \"payment_method\"}`, the portal's\n   *  page for the card (§14.5); for `processing`, `useCheckoutProcessing`'s\n   *  `checkAgain`. The kit sends no request. */\n  onAction?: () => void;\n  /**\n   * Over the kind's action words: \"Choose a plan\" (trial, grant, plan ended), \"Update\n   * payment method\" (payment failed), \"Check again\" (processing). The guest banner has\n   * none of its own: an action there needs this.\n   */\n  actionLabel?: string;\n  /** The action is under way: the button's spinner, no second press. */\n  actionPending?: boolean;\n  /** An × that calls this; the app removes the banner and remembers that it did. */\n  onDismiss?: () => void;\n  dismissLabel?: string;\n  /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */\n  labels?: LabelOverride<BillingLabels>;\n}\n\nexport type BillingBannerProps = BillingBannerBaseProps &\n  (\n    | {\n        kind: \"trial-ending\" | \"grant-ending\";\n        /** Calendar days left — `billingDaysLeft(trial_ends_at)`. 0 is today. */\n        daysLeft: number;\n        item?: never;\n      }\n    | {\n        kind: \"guest\";\n        /** The item's own name (\"Household 2026\"), or nothing. NEVER the owner's status:\n         *  the banner says \"for now\" and nothing more (§12.6). */\n        item?: string;\n        daysLeft?: never;\n      }\n    | {\n        kind: \"payment-failed\" | \"plan-ended\" | \"processing\";\n        daysLeft?: never;\n        item?: never;\n      }\n  );\n\n/** The last days, in which an ending trial or grant turns from news into a warning. */\nconst LAST_DAYS = 3;\n\nfunction defaultTone(kind: BillingBannerKind, daysLeft: number | undefined): AlertTone {\n  switch (kind) {\n    case \"trial-ending\":\n    case \"grant-ending\":\n      return (daysLeft ?? 0) > LAST_DAYS ? \"info\" : \"warning\";\n    case \"payment-failed\":\n      return \"danger\";\n    case \"plan-ended\":\n      return \"warning\";\n    default:\n      return \"info\";\n  }\n}\n\n/**\n * One of the billing banners, as a kit `AlertBanner` strip (§7): the kind's sentence, its\n * glyph and tone, and the app's action. Carries `data-billing-banner` with the kind.\n *\n * The app decides WHICH banner shows, from `GET /billing/overview` (and hides all of them\n * while billing is off, §4); the kit only says it. A guest's banner takes no status at\n * all — the type does not let one in — so the owner's payment state cannot leak into it\n * by a wrong prop (§12.6).\n *\n * `processing` is a live region (`role=\"status\"`): it appears when the person comes back\n * from checkout and goes when the overview catches up (§12.21), and a screen reader\n * should hear both. The others are page furniture, role-less as the strip is.\n */\nexport function BillingBanner(props: BillingBannerProps) {\n  const {\n    kind,\n    daysLeft,\n    item,\n    tone,\n    variant = \"strip\",\n    size,\n    actionHref,\n    onAction,\n    actionLabel,\n    actionPending,\n    onDismiss,\n    dismissLabel,\n    labels: labelsProp,\n    role,\n    ...rest\n  } = props;\n  const labels = useBillingLabels(labelsProp);\n  const days = Math.max(0, Math.floor(daysLeft ?? 0));\n\n  let text: string;\n  let icon: ReactNode;\n  let ownAction: string | undefined;\n  switch (kind) {\n    case \"trial-ending\":\n      text = labels.trialEnding(days);\n      icon = <Hourglass />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"grant-ending\":\n      text = labels.grantEnding(days);\n      icon = <Hourglass />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"payment-failed\":\n      text = labels.paymentFailed;\n      icon = <CreditCard />;\n      ownAction = labels.updatePayment;\n      break;\n    case \"plan-ended\":\n      text = labels.planEnded;\n      icon = <PencilOff />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"guest\":\n      text = labels.guestReadOnly(item);\n      icon = <PencilOff />;\n      ownAction = undefined;\n      break;\n    case \"processing\":\n      text = labels.processing;\n      icon = <Spinner label={null} />;\n      ownAction = labels.checkAgain;\n      break;\n  }\n\n  const words = actionLabel ?? ownAction;\n  const action =\n    words === undefined || (actionHref === undefined && onAction === undefined) ? undefined : actionHref !== undefined ? (\n      <Button href={actionHref} variant=\"secondary\" size=\"sm\">\n        {words}\n      </Button>\n    ) : (\n      <Button type=\"button\" variant=\"secondary\" size=\"sm\" onClick={onAction} pending={actionPending}>\n        {words}\n      </Button>\n    );\n\n  return (\n    <AlertBanner\n      {...rest}\n      role={role ?? (kind === \"processing\" ? \"status\" : undefined)}\n      variant={variant}\n      size={size ?? (variant === \"strip\" ? \"sm\" : \"md\")}\n      tone={tone ?? defaultTone(kind, days)}\n      icon={icon}\n      action={action}\n      onDismiss={onDismiss}\n      dismissLabel={dismissLabel}\n      data-billing-banner={kind}\n    >\n      {text}\n    </AlertBanner>\n  );\n}\n"],"mappings":";AAwJa;AAvJb,SAAS,YAAY,WAAW,iBAAiB;AAGjD,SAAS,mBAAmB;AAE5B,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,wBAAwB;AAwFjC,MAAM,YAAY;AAElB,SAAS,YAAY,MAAyB,UAAyC;AACrF,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,cAAQ,YAAY,KAAK,YAAY,SAAS;AAAA,IAChD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAeO,SAAS,cAAc,OAA2B;AACvD,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,SAAS,iBAAiB,UAAU;AAC1C,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,YAAY,CAAC,CAAC;AAElD,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,OAAO,YAAY,IAAI;AAC9B,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO,YAAY,IAAI;AAC9B,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,cAAW;AACnB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO,cAAc,IAAI;AAChC,aAAO,oBAAC,aAAU;AAClB,kBAAY;AACZ;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,WAAQ,OAAO,MAAM;AAC7B,kBAAY,OAAO;AACnB;AAAA,EACJ;AAEA,QAAM,QAAQ,eAAe;AAC7B,QAAM,SACJ,UAAU,UAAc,eAAe,UAAa,aAAa,SAAa,SAAY,eAAe,SACvG,oBAAC,UAAO,MAAM,YAAY,SAAQ,aAAY,MAAK,MAChD,iBACH,IAEA,oBAAC,UAAO,MAAK,UAAS,SAAQ,aAAY,MAAK,MAAK,SAAS,UAAU,SAAS,eAC7E,iBACH;AAGJ,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,MAAM,SAAS,SAAS,eAAe,WAAW;AAAA,MAClD;AAAA,MACA,MAAM,SAAS,YAAY,UAAU,OAAO;AAAA,MAC5C,MAAM,QAAQ,YAAY,MAAM,IAAI;AAAA,MACpC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,uBAAqB;AAAA,MAEpB;AAAA;AAAA,EACH;AAEJ;","names":[]}

package/dist/billing/plan-limit-notice.d.ts

@@ -1,10 +1,13 @@
-import type { ComponentPropsWithoutRef } from "react";
+import type { ComponentPropsWithRef } from "react";
 import type { LabelOverride } from "../i18n/kit-labels.js";
 import type { AlertTone } from "../components/alert-banner.js";
 import type { BillingLabels } from "./billing-labels.js";
 /** The `contact` mode's mail: to support, its subject naming the dimension. */
 export declare function planLimitMailto(email: string, subject: string): string;
-interface PlanLimitNoticeBaseProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "onClick"> {
+/** A `div`'s props, `ref` included since 0.35 (round 0.35 R4, the follow-up to API-2): they
+ *  go on to the {@link AlertBanner}, so the ref is the notice's `<div>` — its `href` is the
+ *  action button's, never the banner's, so the frame is never a link. */
+interface PlanLimitNoticeBaseProps extends Omit<ComponentPropsWithRef<"div">, "children" | "onClick"> {
     /** The dimension as the refusal names it (`"budgets"`, `"seats"`) — `isPlanLimit(err)`'s
      *  `dimension`. Carried as `data-dimension`. */
     dimension: string;

package/dist/billing/plan-limit-notice.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/billing/plan-limit-notice.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef } from \"react\";\n\nimport { useKitLocale } from \"../i18n/kit-labels\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { formatNumber } from \"../lib/format\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport type { AlertTone } from \"../components/alert-banner\";\nimport { ProgressBar } from \"../components/progress-bar\";\nimport { Button } from \"../components/button\";\nimport { useBillingLabels } from \"./billing-labels\";\nimport type { BillingLabels } from \"./billing-labels\";\n\n/** RFC 3986 percent-encoding, `!'()*` too — a mail client that splits on `'` is the one\n *  that breaks \"Plan limit: Ada's plots\" (landing/access.ts keeps the same rule). */\nfunction encodeStrict(value: string): string {\n  return encodeURIComponent(value).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);\n}\n\n/** The `contact` mode's mail: to support, its subject naming the dimension. */\nexport function planLimitMailto(email: string, subject: string): string {\n  const to = encodeStrict(email).replace(/%40/g, \"@\");\n  return `mailto:${to}?subject=${encodeStrict(subject)}`;\n}\n\ninterface PlanLimitNoticeBaseProps extends Omit<ComponentPropsWithoutRef<\"div\">, \"children\" | \"onClick\"> {\n  /** The dimension as the refusal names it (`\"budgets\"`, `\"seats\"`) — `isPlanLimit(err)`'s\n   *  `dimension`. Carried as `data-dimension`. */\n  dimension: string;\n  /** The app's name for it, in the reader's language: \"Budgets\". Default: the key. */\n  dimensionLabel?: string;\n  /** How many there are. Left out (keksdose's legacy `plan_budget_limit` body has no\n   *  `used`), it is read as `limit`: the create was refused for being at it. */\n  used?: number;\n  /** The plan's limit for the dimension. Left out — a body without one — the notice says\n   *  its words and draws no meter. */\n  limit?: number;\n  /** The payer's plan code, as `isPlanLimit` reads it — carried as `data-plan`, so the\n   *  refusal can be spread in whole: `<PlanLimitNotice {...isPlanLimit(err)} …/>`. */\n  plan?: string;\n  /** How a figure is written — kastlan's storage limit is bytes (`formatFileSize`).\n   *  Default: a number in the kit's locale. */\n  formatValue?: (value: number) => string;\n  /** Over the provider's locale, for the default figures. */\n  locale?: string;\n  /** Default `warning`. */\n  tone?: AlertTone;\n  /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */\n  labels?: LabelOverride<BillingLabels>;\n}\n\nexport type PlanLimitNoticeProps = PlanLimitNoticeBaseProps &\n  (\n    | {\n        /** Plans are bought: \"Choose a plan\" → the app's subscription page. */\n        mode: \"upgrade\";\n        /** The subscription page. */\n        href: string;\n        email?: never;\n      }\n    | {\n        /** The operator grants plans by hand (keksdose's today): \"Ask for more\" → a mail. */\n        mode: \"contact\";\n        /** The support address: `support@` the app's domain. */\n        email: string;\n        href?: never;\n      }\n  );\n\n/**\n * A create refused at the plan's limit (docs/billing-harmonization.md §3.4): \"Plan limit\n * reached\", what to do, the dimension's meter (\"Budgets — 3 of 3\") and the app's way to\n * more — `upgrade`, a link to the subscription page, or `contact`, a mail to support.\n *\n * A limit gates CREATION only: a downgrade never deletes or hides what is over the new\n * limit (§3.4), so `used` may be past `limit`; the meter then fills and turns red. Feed it\n * the refusal: `const hit = isPlanLimit(err); hit && <PlanLimitNotice {...hit} …/>`. The\n * kit sends nothing — the mail opens the reader's own client.\n */\nexport function PlanLimitNotice(props: PlanLimitNoticeProps) {\n  const {\n    dimension,\n    dimensionLabel,\n    used: usedProp,\n    limit,\n    plan,\n    formatValue,\n    locale: localeProp,\n    tone = \"warning\",\n    labels: labelsProp,\n    mode,\n    href,\n    email,\n    className,\n    ...rest\n  } = props;\n  const labels = useBillingLabels(labelsProp);\n  const locale = useKitLocale(localeProp);\n  const used = usedProp ?? limit ?? 0;\n  const name = dimensionLabel ?? dimension;\n  const figure = (value: number) => (formatValue ? formatValue(value) : formatNumber(value, { locale }));\n\n  const action =\n    mode === \"upgrade\" ? (\n      <Button href={href} variant=\"secondary\" size=\"sm\">\n        {labels.choosePlan}\n      </Button>\n    ) : (\n      <Button href={planLimitMailto(email, labels.contactSubject(name))} variant=\"secondary\" size=\"sm\">\n        {labels.askForMore}\n      </Button>\n    );\n\n  return (\n    <AlertBanner\n      {...rest}\n      tone={tone}\n      action={action}\n      data-plan-limit-mode={mode}\n      data-dimension={dimension}\n      data-plan={plan}\n      className={className}\n    >\n      <span className=\"block font-medium\">{labels.limitReached}</span>\n      <span className=\"block\">{mode === \"upgrade\" ? labels.limitUpgrade : labels.limitContact}</span>\n      {limit !== undefined && (\n        <ProgressBar\n          as=\"span\"\n          variant=\"meter\"\n          size=\"slim\"\n          value={used}\n          max={limit}\n          label={name}\n          showValue\n          // The bar is clamped at `max` and hands its formatter the clamped value; the\n          // figures are the real ones, so \"5 of 3\" after a downgrade says what the bar\n          // cannot draw.\n          formatValue={() => labels.usage(figure(used), figure(limit))}\n          tone={used > limit ? \"danger\" : \"warning\"}\n          className=\"mt-2\"\n          locale={locale}\n        />\n      )}\n    </AlertBanner>\n  );\n}\n"],"mappings":";AAuGM,cAUF,YAVE;AArGN,SAAS,oBAAoB;AAE7B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAE5B,SAAS,mBAAmB;AAC5B,SAAS,cAAc;AACvB,SAAS,wBAAwB;AAKjC,SAAS,aAAa,OAAuB;AAC3C,SAAO,mBAAmB,KAAK,EAAE,QAAQ,YAAY,CAAC,MAAM,IAAI,EAAE,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,YAAY,CAAC,EAAE;AAC9G;AAGO,SAAS,gBAAgB,OAAe,SAAyB;AACtE,QAAM,KAAK,aAAa,KAAK,EAAE,QAAQ,QAAQ,GAAG;AAClD,SAAO,UAAU,EAAE,YAAY,aAAa,OAAO,CAAC;AACtD;AAwDO,SAAS,gBAAgB,OAA6B;AAC3D,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,SAAS,iBAAiB,UAAU;AAC1C,QAAM,SAAS,aAAa,UAAU;AACtC,QAAM,OAAO,YAAY,SAAS;AAClC,QAAM,OAAO,kBAAkB;AAC/B,QAAM,SAAS,CAAC,UAAmB,cAAc,YAAY,KAAK,IAAI,aAAa,OAAO,EAAE,OAAO,CAAC;AAEpG,QAAM,SACJ,SAAS,YACP,oBAAC,UAAO,MAAY,SAAQ,aAAY,MAAK,MAC1C,iBAAO,YACV,IAEA,oBAAC,UAAO,MAAM,gBAAgB,OAAO,OAAO,eAAe,IAAI,CAAC,GAAG,SAAQ,aAAY,MAAK,MACzF,iBAAO,YACV;AAGJ,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ;AAAA,MACA;AAAA,MACA,wBAAsB;AAAA,MACtB,kBAAgB;AAAA,MAChB,aAAW;AAAA,MACX;AAAA,MAEA;AAAA,4BAAC,UAAK,WAAU,qBAAqB,iBAAO,cAAa;AAAA,QACzD,oBAAC,UAAK,WAAU,SAAS,mBAAS,YAAY,OAAO,eAAe,OAAO,cAAa;AAAA,QACvF,UAAU,UACT;AAAA,UAAC;AAAA;AAAA,YACC,IAAG;AAAA,YACH,SAAQ;AAAA,YACR,MAAK;AAAA,YACL,OAAO;AAAA,YACP,KAAK;AAAA,YACL,OAAO;AAAA,YACP,WAAS;AAAA,YAIT,aAAa,MAAM,OAAO,MAAM,OAAO,IAAI,GAAG,OAAO,KAAK,CAAC;AAAA,YAC3D,MAAM,OAAO,QAAQ,WAAW;AAAA,YAChC,WAAU;AAAA,YACV;AAAA;AAAA,QACF;AAAA;AAAA;AAAA,EAEJ;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/billing/plan-limit-notice.tsx"],"sourcesContent":["import type { ComponentPropsWithRef } from \"react\";\n\nimport { useKitLocale } from \"../i18n/kit-labels\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { formatNumber } from \"../lib/format\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport type { AlertTone } from \"../components/alert-banner\";\nimport { ProgressBar } from \"../components/progress-bar\";\nimport { Button } from \"../components/button\";\nimport { useBillingLabels } from \"./billing-labels\";\nimport type { BillingLabels } from \"./billing-labels\";\n\n/** RFC 3986 percent-encoding, `!'()*` too — a mail client that splits on `'` is the one\n *  that breaks \"Plan limit: Ada's plots\" (landing/access.ts keeps the same rule). */\nfunction encodeStrict(value: string): string {\n  return encodeURIComponent(value).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);\n}\n\n/** The `contact` mode's mail: to support, its subject naming the dimension. */\nexport function planLimitMailto(email: string, subject: string): string {\n  const to = encodeStrict(email).replace(/%40/g, \"@\");\n  return `mailto:${to}?subject=${encodeStrict(subject)}`;\n}\n\n/** A `div`'s props, `ref` included since 0.35 (round 0.35 R4, the follow-up to API-2): they\n *  go on to the {@link AlertBanner}, so the ref is the notice's `<div>` — its `href` is the\n *  action button's, never the banner's, so the frame is never a link. */\ninterface PlanLimitNoticeBaseProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"onClick\"> {\n  /** The dimension as the refusal names it (`\"budgets\"`, `\"seats\"`) — `isPlanLimit(err)`'s\n   *  `dimension`. Carried as `data-dimension`. */\n  dimension: string;\n  /** The app's name for it, in the reader's language: \"Budgets\". Default: the key. */\n  dimensionLabel?: string;\n  /** How many there are. Left out (keksdose's legacy `plan_budget_limit` body has no\n   *  `used`), it is read as `limit`: the create was refused for being at it. */\n  used?: number;\n  /** The plan's limit for the dimension. Left out — a body without one — the notice says\n   *  its words and draws no meter. */\n  limit?: number;\n  /** The payer's plan code, as `isPlanLimit` reads it — carried as `data-plan`, so the\n   *  refusal can be spread in whole: `<PlanLimitNotice {...isPlanLimit(err)} …/>`. */\n  plan?: string;\n  /** How a figure is written — kastlan's storage limit is bytes (`formatFileSize`).\n   *  Default: a number in the kit's locale. */\n  formatValue?: (value: number) => string;\n  /** Over the provider's locale, for the default figures. */\n  locale?: string;\n  /** Default `warning`. */\n  tone?: AlertTone;\n  /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */\n  labels?: LabelOverride<BillingLabels>;\n}\n\nexport type PlanLimitNoticeProps = PlanLimitNoticeBaseProps &\n  (\n    | {\n        /** Plans are bought: \"Choose a plan\" → the app's subscription page. */\n        mode: \"upgrade\";\n        /** The subscription page. */\n        href: string;\n        email?: never;\n      }\n    | {\n        /** The operator grants plans by hand (keksdose's today): \"Ask for more\" → a mail. */\n        mode: \"contact\";\n        /** The support address: `support@` the app's domain. */\n        email: string;\n        href?: never;\n      }\n  );\n\n/**\n * A create refused at the plan's limit (docs/billing-harmonization.md §3.4): \"Plan limit\n * reached\", what to do, the dimension's meter (\"Budgets — 3 of 3\") and the app's way to\n * more — `upgrade`, a link to the subscription page, or `contact`, a mail to support.\n *\n * A limit gates CREATION only: a downgrade never deletes or hides what is over the new\n * limit (§3.4), so `used` may be past `limit`; the meter then fills and turns red. Feed it\n * the refusal: `const hit = isPlanLimit(err); hit && <PlanLimitNotice {...hit} …/>`. The\n * kit sends nothing — the mail opens the reader's own client.\n */\nexport function PlanLimitNotice(props: PlanLimitNoticeProps) {\n  const {\n    dimension,\n    dimensionLabel,\n    used: usedProp,\n    limit,\n    plan,\n    formatValue,\n    locale: localeProp,\n    tone = \"warning\",\n    labels: labelsProp,\n    mode,\n    href,\n    email,\n    className,\n    ...rest\n  } = props;\n  const labels = useBillingLabels(labelsProp);\n  const locale = useKitLocale(localeProp);\n  const used = usedProp ?? limit ?? 0;\n  const name = dimensionLabel ?? dimension;\n  const figure = (value: number) => (formatValue ? formatValue(value) : formatNumber(value, { locale }));\n\n  const action =\n    mode === \"upgrade\" ? (\n      <Button href={href} variant=\"secondary\" size=\"sm\">\n        {labels.choosePlan}\n      </Button>\n    ) : (\n      <Button href={planLimitMailto(email, labels.contactSubject(name))} variant=\"secondary\" size=\"sm\">\n        {labels.askForMore}\n      </Button>\n    );\n\n  return (\n    <AlertBanner\n      {...rest}\n      tone={tone}\n      action={action}\n      data-plan-limit-mode={mode}\n      data-dimension={dimension}\n      data-plan={plan}\n      className={className}\n    >\n      <span className=\"block font-medium\">{labels.limitReached}</span>\n      <span className=\"block\">{mode === \"upgrade\" ? labels.limitUpgrade : labels.limitContact}</span>\n      {limit !== undefined && (\n        <ProgressBar\n          as=\"span\"\n          variant=\"meter\"\n          size=\"slim\"\n          value={used}\n          max={limit}\n          label={name}\n          showValue\n          // The bar is clamped at `max` and hands its formatter the clamped value; the\n          // figures are the real ones, so \"5 of 3\" after a downgrade says what the bar\n          // cannot draw.\n          formatValue={() => labels.usage(figure(used), figure(limit))}\n          tone={used > limit ? \"danger\" : \"warning\"}\n          className=\"mt-2\"\n          locale={locale}\n        />\n      )}\n    </AlertBanner>\n  );\n}\n"],"mappings":";AA0GM,cAUF,YAVE;AAxGN,SAAS,oBAAoB;AAE7B,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAE5B,SAAS,mBAAmB;AAC5B,SAAS,cAAc;AACvB,SAAS,wBAAwB;AAKjC,SAAS,aAAa,OAAuB;AAC3C,SAAO,mBAAmB,KAAK,EAAE,QAAQ,YAAY,CAAC,MAAM,IAAI,EAAE,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,YAAY,CAAC,EAAE;AAC9G;AAGO,SAAS,gBAAgB,OAAe,SAAyB;AACtE,QAAM,KAAK,aAAa,KAAK,EAAE,QAAQ,QAAQ,GAAG;AAClD,SAAO,UAAU,EAAE,YAAY,aAAa,OAAO,CAAC;AACtD;AA2DO,SAAS,gBAAgB,OAA6B;AAC3D,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,SAAS,iBAAiB,UAAU;AAC1C,QAAM,SAAS,aAAa,UAAU;AACtC,QAAM,OAAO,YAAY,SAAS;AAClC,QAAM,OAAO,kBAAkB;AAC/B,QAAM,SAAS,CAAC,UAAmB,cAAc,YAAY,KAAK,IAAI,aAAa,OAAO,EAAE,OAAO,CAAC;AAEpG,QAAM,SACJ,SAAS,YACP,oBAAC,UAAO,MAAY,SAAQ,aAAY,MAAK,MAC1C,iBAAO,YACV,IAEA,oBAAC,UAAO,MAAM,gBAAgB,OAAO,OAAO,eAAe,IAAI,CAAC,GAAG,SAAQ,aAAY,MAAK,MACzF,iBAAO,YACV;AAGJ,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ;AAAA,MACA;AAAA,MACA,wBAAsB;AAAA,MACtB,kBAAgB;AAAA,MAChB,aAAW;AAAA,MACX;AAAA,MAEA;AAAA,4BAAC,UAAK,WAAU,qBAAqB,iBAAO,cAAa;AAAA,QACzD,oBAAC,UAAK,WAAU,SAAS,mBAAS,YAAY,OAAO,eAAe,OAAO,cAAa;AAAA,QACvF,UAAU,UACT;AAAA,UAAC;AAAA;AAAA,YACC,IAAG;AAAA,YACH,SAAQ;AAAA,YACR,MAAK;AAAA,YACL,OAAO;AAAA,YACP,KAAK;AAAA,YACL,OAAO;AAAA,YACP,WAAS;AAAA,YAIT,aAAa,MAAM,OAAO,MAAM,OAAO,IAAI,GAAG,OAAO,KAAK,CAAC;AAAA,YAC3D,MAAM,OAAO,QAAQ,WAAW;AAAA,YAChC,WAAU;AAAA,YACV;AAAA;AAAA,QACF;AAAA;AAAA;AAAA,EAEJ;AAEJ;","names":[]}

package/dist/chart.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/chart.ts"],"sourcesContent":["// `@eifi1/ui-kit/chart` — the chart shell and its colour system.\n//\n// A re-slicing of what the main barrel already exports, not a new API. It exists so a\n// consumer can reach the chart kit WITHOUT the barrel: `import(\"@eifi1/ui-kit/chart\")`\n// is a 31KB chunk, where the same lazy import through the barrel pulls 221KB, because\n// a dynamic import of the barrel cannot be tree-shaken down to one of its members.\n//\n// It is about chunk size, not about the peer: `recharts` is a REQUIRED peer (since 0.5.0),\n// because the main barrel re-exports everything here too, so `import { Button } from\n// \"@eifi1/ui-kit\"` reaches recharts as well (packaging-contract.test.ts asserts it).\nexport * from \"./components/chart\";\nexport * from \"./theme/chart-palette\";\n\n// The tile chart (treemap) the apps share — moved here from keksdose so every consumer\n// derives it from the package rather than from a copy.\nexport * from \"./components/treemap\";\n\n// lenkbank's zoomable series chart, its synced x-zoom, the toggle legend and the\n// mirrored-pair axis geometry — moved here so the apps derive them from the package.\nexport * from \"./components/series-chart\";\n// 0.32.1 (keksdose's 0.32 report): the height every chart takes, for an app's wrappers.\nexport type { ChartHeight } from \"./components/chart-height\";\nexport * from \"./components/chart-zoom\";\n// The zoom's own module since 0.34: SharedXZoom and the drag layer (recharts) live here,\n// ./chart-zoom is their public face. Named, so the arithmetic it also holds stays the\n// kit's (refactor audit 2026-10, API-6b) — the same binding the line above re-exports.\nexport { SharedXZoom } from \"./components/chart-zoom-core\";\nexport * from \"./components/toggle-legend\";\nexport * from \"./components/facing-pair\";\nexport * from \"./components/series-chart-labels\";\n\n// The part-to-whole chart (donut / pie) — moved here from kastlan's dashboard and reports.\nexport * from \"./components/pie-chart\";\nexport * from \"./components/pie-chart-labels\";\n"],"mappings":";AAUA,cAAc;AACd,cAAc;AAId,cAAc;AAId,cAAc;AAGd,cAAc;AAId,SAAS,mBAAmB;AAC5B,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../src/chart.ts"],"sourcesContent":["// `@eifi1/ui-kit/chart` — the chart shell and its colour system.\n//\n// A re-slicing of what the main barrel already exports, not a new API. It exists so a\n// consumer can reach the chart kit WITHOUT the barrel: `import(\"@eifi1/ui-kit/chart\")`\n// is a 31KB chunk, where the same lazy import through the barrel pulls 221KB, because\n// a dynamic import of the barrel cannot be tree-shaken down to one of its members.\n//\n// It is about chunk size, not about the peer: `recharts` is a REQUIRED peer (since 0.5.0),\n// because the main barrel re-exports everything here too, so `import { Button } from\n// \"@eifi1/ui-kit\"` reaches recharts as well (packaging-contract.test.ts asserts it).\nexport * from \"./components/chart\";\nexport * from \"./theme/chart-palette\";\n\n// The tile chart (treemap) the apps share — moved here from keksdose so every consumer\n// derives it from the package rather than from a copy.\nexport * from \"./components/treemap\";\n\n// lenkbank's zoomable series chart, its synced x-zoom, the toggle legend and the\n// mirrored-pair axis geometry — moved here so the apps derive them from the package.\nexport * from \"./components/series-chart\";\n// 0.32.1 (keksdose's 0.32 report): the height every chart takes, for an app's wrappers.\nexport type { ChartHeight } from \"./components/chart-height\";\n// SharedXZoom and the zoom's types: the public face of ./chart-zoom-core, whose arithmetic\n// stays the kit's (refactor audit 2026-10, API-6b; off the surface in 0.35).\nexport * from \"./components/chart-zoom\";\n// The same binding, named from the module that holds it and the drag layer (recharts): the\n// packaging contract reads this entry's own imports to know which modules may import\n// recharts, so chart-zoom-core has to be one of them (MOD-6).\nexport { SharedXZoom } from \"./components/chart-zoom-core\";\nexport * from \"./components/toggle-legend\";\nexport * from \"./components/facing-pair\";\nexport * from \"./components/series-chart-labels\";\n\n// The part-to-whole chart (donut / pie) — moved here from kastlan's dashboard and reports.\nexport * from \"./components/pie-chart\";\nexport * from \"./components/pie-chart-labels\";\n"],"mappings":";AAUA,cAAc;AACd,cAAc;AAId,cAAc;AAId,cAAc;AAKd,cAAc;AAId,SAAS,mBAAmB;AAC5B,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;","names":[]}

package/dist/components/amount-input.d.ts

@@ -62,9 +62,6 @@ export interface AmountInputProps {
     id?: string;
     /** Names the field when it has no visible `label` (a table cell, the display shape). */
     "aria-label"?: string;
-    /** @deprecated 0.34 — use `aria-label`; removed in 0.35 (refactor audit 2026-10, API-1).
-     *  Names the field only when `aria-label` is absent. */
-    ariaLabel?: string;
     /**
      * Set on the `<input>`, with `id` above. Declared so `Field`'s render-prop spread —
      * `{(ids) => <AmountInput {...ids} … />}` — is typed and reaches the input: the

package/dist/components/amount-input.js

@@ -62,7 +62,7 @@ function isResultOf(previous, text, settle) {
   return n !== null && settle(formatResult(n)) === text.trim();
 }
 function AmountInput(props) {
-  const { ref, value, onChange, currency, onCurrencyChange, placeholder, label, className, inputClassName, id, "aria-label": ariaLabelAttr, ariaLabel: ariaLabelProp, "aria-required": ariaRequired, autoFocus, tone = "neutral", negative = false, onNegativeChange, align = "start", labels, currencyNames, currencyOptions, digits: digitsProp, min, max, onCommit, disabledReasonDisplay } = props;
+  const { ref, value, onChange, currency, onCurrencyChange, placeholder, label, className, inputClassName, id, "aria-label": ariaLabel, "aria-required": ariaRequired, autoFocus, tone = "neutral", negative = false, onNegativeChange, align = "start", labels, currencyNames, currencyOptions, digits: digitsProp, min, max, onCommit, disabledReasonDisplay } = props;
   const generatedId = useId();
   const fieldId = id ?? generatedId;
   const signOwned = onNegativeChange !== void 0;
@@ -135,7 +135,7 @@ function AmountInput(props) {
             {
               ref: setRefs,
               id: fieldId,
-              "aria-label": ariaLabelAttr ?? ariaLabelProp,
+              "aria-label": ariaLabel,
               type: "text",
               autoFocus,
               inputMode: isMobile ? "none" : "decimal",