@eifi1/ui-kit 0.52.0 → 0.53.0

package/src/billing/plan-card.tsx

@@ -14,8 +14,6 @@ import { Button } from "../components/button";
 import { DialogFrame } from "../components/dialog-frame";
 import { useBillingLabels } from "./billing-labels";
 import type { BillingLabels } from "./billing-labels";
-import { dialogClose } from "./dialog-close";
-import type { WithDialogClose } from "./dialog-close";
 import { BILLING_INTERVALS, billingCurrencyFor, formatPlanPrice, planPrice } from "./plan-price";
 import type { BillingCurrency, BillingInterval, PlanPrices } from "./plan-price";
 
@@ -502,16 +500,13 @@ export function PlanPicker({
   );
 }
 
-/** {@link GrantWarningConfirmProps} before one of its two close props is required. */
-interface GrantWarningConfirmFields {
+export interface GrantWarningConfirmProps {
   /** Shown, controlled. */
   open: boolean;
   /** "Back", Escape, the backdrop — and after "Buy anyway". 0.52: every other kit
-   *  dialog's `onClose` (CONTRIBUTING §4; refactor audit 2026-10-30, API-5). */
-  onClose?: () => void;
-  /** @deprecated 0.52 — `onClose`, as every other kit dialog; removed in 0.53. Called with
-   *  `false` when there is no `onClose`. */
-  onOpenChange?: (open: boolean) => void;
+   *  dialog's `onClose` (CONTRIBUTING §4; refactor audit 2026-10-30, API-5); required
+   *  since 0.53 removed `onOpenChange` (deprecated in 0.52). */
+  onClose: () => void;
   /** "Buy anyway": the app opens its checkout. The dialog closes itself after it. */
   onConfirm: () => void;
   /** Prop > `<UiKitProvider labels={{ billing }}>` > English: `grantWarningTitle`,
@@ -519,11 +514,6 @@ interface GrantWarningConfirmFields {
   labels?: LabelOverride<BillingLabels>;
 }
 
-/** What {@link GrantWarningConfirm} takes: `onClose`, or alone the deprecated
- *  `onOpenChange`, is required (0.52 code review: with neither it compiled, and nothing
- *  could dismiss it). */
-export type GrantWarningConfirmProps = WithDialogClose<GrantWarningConfirmFields>;
-
 /**
  * 0.42 (§16.8 B): the permanent-grant warning before a checkout — `grantWarningTitle`,
  * `grantWarningBody`, "Back" and "Buy anyway" (`grantWarningAction`). {@link PlanPicker}
@@ -533,22 +523,15 @@ export type GrantWarningConfirmProps = WithDialogClose<GrantWarningConfirmFields
  * to a checkout — show this before that checkout, so a permanent-grant holder is still
  * warned. Carries `data-grant-warning`.
  */
-export function GrantWarningConfirm({
-  open,
-  onClose,
-  onOpenChange,
-  onConfirm,
-  labels: labelsProp,
-}: GrantWarningConfirmProps) {
+export function GrantWarningConfirm({ open, onClose, onConfirm, labels: labelsProp }: GrantWarningConfirmProps) {
   const labels = useBillingLabels(labelsProp);
   const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
-  const close = dialogClose({ onClose, onOpenChange });
   return (
     <DialogFrame
       open={open}
       title={labels.grantWarningTitle}
       description={labels.grantWarningBody}
-      onClose={close}
+      onClose={onClose}
       data-grant-warning=""
       actions={(lower) => (
         <>
@@ -567,7 +550,7 @@ export function GrantWarningConfirm({
               // and the lowering panel is not inert: a double click on "Buy anyway" opened
               // the checkout twice (0.52 code review, plan-card.tsx). The caller's `open`
               // turning false still plays the exit.
-              close();
+              onClose();
             }}
           >
             {labels.grantWarningAction}

package/src/billing/plan-switch.tsx

@@ -13,8 +13,6 @@ import { COMMIT_EXCEPT_BILLING } from "../components/write-lock";
 import { DEFAULT_PLAN_CHANGE_LABELS } from "./plan-change-labels";
 import { useBillingLabels } from "./billing-labels";
 import type { BillingLabels } from "./billing-labels";
-import { dialogClose } from "./dialog-close";
-import type { WithDialogClose } from "./dialog-close";
 import type { PlanSwitchPreview } from "./billing-overview";
 import { minorToMajor } from "./plan-price";
 import type { BillingInterval } from "./plan-price";
@@ -39,16 +37,13 @@ export interface PlanSwitchSide {
   interval: BillingInterval;
 }
 
-/** {@link PlanSwitchConfirmProps} before one of its two close props is required. */
-interface PlanSwitchConfirmFields {
+export interface PlanSwitchConfirmProps {
   open: boolean;
   /** The payer dismissed it — Cancel, Escape, the backdrop. Confirm leaves it open: close
    *  it once the switch answers. 0.52: every other kit dialog's `onClose` (CONTRIBUTING
-   *  §4; refactor audit 2026-10-30, API-5). */
-  onClose?: () => void;
-  /** @deprecated 0.52 — `onClose`, as every other kit dialog; removed in 0.53. Called with
-   *  `false` when there is no `onClose`. */
-  onOpenChange?: (open: boolean) => void;
+   *  §4; refactor audit 2026-10-30, API-5); required since 0.53 removed `onOpenChange`
+   *  (deprecated in 0.52). */
+  onClose: () => void;
   /** What the payer pays now: the overview's `paid`. */
   from: PlanSwitchSide;
   /** The pick. */
@@ -88,11 +83,6 @@ interface PlanSwitchConfirmFields {
   labels?: LabelOverride<BillingLabels>;
 }
 
-/** What {@link PlanSwitchConfirm} takes: `onClose`, or alone the deprecated
- *  `onOpenChange`, is required (0.52 code review: with neither it compiled, and nothing
- *  could dismiss it). */
-export type PlanSwitchConfirmProps = WithDialogClose<PlanSwitchConfirmFields>;
-
 /**
  * The confirm for a plan switch (§15.2.10): from → to, each with its billing period;
  * Paddle's preview — "Charged now" (an upgrade) or "Credited towards your next charges"
@@ -118,7 +108,6 @@ export type PlanSwitchConfirmProps = WithDialogClose<PlanSwitchConfirmFields>;
 export function PlanSwitchConfirm({
   open,
   onClose,
-  onOpenChange,
   from,
   to,
   preview,
@@ -165,7 +154,7 @@ export function PlanSwitchConfirm({
       open={open}
       title={labels.switchTitle}
       description={labels.switchFromTo(side(from), side(to))}
-      onClose={dialogClose({ onClose, onOpenChange })}
+      onClose={onClose}
       busy={pending}
       // A preview that loads is busy too, but holds nothing: Cancel stays a way out.
       aria-busy={preview === undefined || undefined}

package/src/chart.ts

@@ -10,14 +10,24 @@
 // because the main barrel re-exports everything here too, so `import { Button } from
 // "@eifi1/ui-kit"` reaches recharts as well (packaging-contract.test.ts asserts it).
 export * from "./components/chart";
-export * from "./theme/chart-palette";
-// 0.52: the slice's share of the 55 names no app reads (refactor audit 2026-10-30, API-4,
-// decision 4), tagged on their specifiers as the barrel's are — the modules keep them.
+// Named, not `*`, for chart-palette, series-chart and toggle-legend: 0.53 took the slice's
+// share of the 55 names no app reads off the surface (deprecated in 0.52, refactor audit
+// 2026-10-30, API-4) — `EDGE_MIN_CONTRAST`, `resolveTooltipPlacement`, `STROKE_PATTERNS`,
+// which their modules keep for the kit's own use.
 export {
-  /** @deprecated 0.52 — `chartEdge`, which measures a fill against it (API-4); removed in 0.53 */
-  EDGE_MIN_CONTRAST,
-  /** @deprecated 0.52 — `--chart-ink` (`CHART_ROLES.outline`), the same ink as a token (API-4); removed in 0.53 */
-  CHART_INK_HEX,
+  PALETTE_SIZE,
+  CVD_ORDER,
+  paletteFor,
+  CHART_COLORS,
+  CHART_ROLES,
+  CHART_MUTED_HEX,
+  chartEdge,
+  PALETTE_HEX,
+  HEATMAP_HEX,
+  lerpHex,
+  textOn,
+  type PaletteForOptions,
+  type HeatStops,
 } from "./theme/chart-palette";
 
 // The tile chart (treemap) the apps share — moved here from keksdose so every consumer
@@ -27,10 +37,42 @@ export * from "./components/treemap-labels";
 
 // lenkbank's zoomable series chart, its synced x-zoom, the toggle legend and the
 // mirrored-pair axis geometry — moved here so the apps derive them from the package.
-export * from "./components/series-chart";
 export {
-  /** @deprecated 0.52 — `SeriesChart`, which places its tooltip with it (API-4); removed in 0.53 */
-  resolveTooltipPlacement,
+  AXIS_TICK_WIDTH,
+  AXIS_TITLE_STRIP,
+  anchoredBand,
+  axisBandWidth,
+  mergeSeries,
+  oneAxis,
+  padBand,
+  paddedDomain,
+  seriesKey,
+  soleSeriesColor,
+  visibleSeries,
+  seriesLegendEntries,
+  StaticSeriesChart,
+  SeriesChart,
+  type TimeTickUnit,
+  type SeriesChartAxisBudget,
+  type SeriesSource,
+  type SeriesChartSeries,
+  type SeriesChartType,
+  type SeriesChartPoint,
+  type SeriesChartRow,
+  type SeriesChartXValue,
+  type SeriesChartTickValues,
+  type SeriesChartAxis,
+  type SeriesChartXTick,
+  type SeriesChartX,
+  type SeriesChartTooltipPlacement,
+  type SeriesChartTooltip,
+  type SeriesChartSpan,
+  type SeriesChartTone,
+  type SeriesChartReference,
+  type SeriesChartMarker,
+  type SeriesChartHit,
+  type SeriesChartProps,
+  type SeriesLegendAxes,
 } from "./components/series-chart";
 // 0.32.1 (keksdose's 0.32 report): the height every chart takes, for an app's wrappers.
 export type { ChartHeight } from "./components/chart-height";
@@ -41,10 +83,17 @@ export * from "./components/chart-zoom";
 // packaging contract reads this entry's own imports to know which modules may import
 // recharts, so chart-zoom-core has to be one of them (MOD-6).
 export { SharedXZoom } from "./components/chart-zoom-core";
-export * from "./components/toggle-legend";
 export {
-  /** @deprecated 0.52 — `strokeDash`, which picks a series' pattern from it (API-4); removed in 0.53 */
-  STROKE_PATTERNS,
+  strokeDash,
+  STEP_DASH,
+  toggleHidden,
+  ToggleLegend,
+  StaticLegend,
+  LegendColumn,
+  LegendGroup,
+  type LegendEntry,
+  type ToggleLegendProps,
+  type StaticLegendProps,
 } from "./components/toggle-legend";
 export * from "./components/facing-pair";
 export * from "./components/series-chart-labels";

package/src/components/date-field.tsx

@@ -137,7 +137,7 @@ export interface DatePickerBaseProps extends Omit<ComponentPropsWithoutRef<"div"
    *
    * Off by default: the caption becomes one more stop in the panel's tab order, which a
    * 0.x minor does not spring on a form. Works in the popover and in
-   * `DateRangePicker`'s phone sheet alike, beside presets and in `commit="apply"`
+   * `DateRangePicker`'s phone sheet alike, beside presets and with `apply`
    * (a preset picked while the months are open goes back to the days, on its start).
    *
    * Why not a two-month panel (`months={2}`) instead, or beside it: for a twelve-month

package/src/components/date-picker.tsx

@@ -16,7 +16,6 @@ import { PanelCalendar } from "./jump-calendar";
 export type { DateTriggerAttributes } from "./date-field";
 export { DateRangePicker } from "./date-range-picker";
 export type {
-  DateRangeCommit,
   DateRangeDraftSummary,
   DateRangePickerPreset,
   DateRangePickerProps,

package/src/components/date-range-picker.tsx

@@ -40,17 +40,6 @@ export interface DateRangePickerPreset {
   to: string;
 }
 
-/**
- * The 0.x values of DateRangePicker's `commit`, when it was the panel's mode:
- * `"immediate"` is `apply` left out, `"apply"` is `apply`. See
- * {@link DateRangePickerProps.apply}.
- *
- * @deprecated 0.52 — DateRangePicker's `apply` (`commit="apply"` → `apply`, `"immediate"`
- * → nothing); removed in 0.53. `commit` is the write lock's opt-in on every other kit
- * control, and since 0.52 on this one too (refactor audit 2026-10-30, API-3).
- */
-export type DateRangeCommit = "immediate" | "apply";
-
 export interface DateRangePickerProps extends DatePickerBaseProps {
   from: string;
   to: string;
@@ -89,8 +78,7 @@ export interface DateRangePickerProps extends DatePickerBaseProps {
    *    must never escape the panel.
    *
    * `commit="apply"` until 0.52 (refactor audit 2026-10-30, API-3): `commit` is the write
-   * lock's prop on every other kit control. The old spelling still works for 0.52 and
-   * goes in 0.53 ({@link DateRangeCommit}); `apply` wins where both are given.
+   * lock's prop on every other kit control. The old spelling went in 0.53.
    */
   apply?: boolean;
   /**
@@ -100,12 +88,10 @@ export interface DateRangePickerProps extends DatePickerBaseProps {
    * kit control since 0.33, and on this one since 0.52 (API-3). A range inside a form with
    * its own Save stays editable under the lock — leave this off there.
    *
-   * The strings `"immediate"` and `"apply"` are the panel's mode, the 0.x meaning of this
-   * prop: deprecated, read as `apply` for one minor, removed in 0.53 — see
-   * {@link DateRangeCommit}. They cannot be taken for a scope, which is a boolean or an
-   * object.
+   * The strings `"immediate"` and `"apply"`, the panel's mode in 0.x, went in 0.53
+   * (deprecated in 0.52): `apply` is the mode.
    */
-  commit?: CommitScope | DateRangeCommit;
+  commit?: CommitScope;
   /**
    * Draw the trigger yourself. keksdose's report range field
    * (reports/report-range-field.tsx, "Why this is app-level") is why: its trigger
@@ -428,10 +414,8 @@ export function DateRangePicker(props: DateRangePickerProps) {
   const locale = useKitLocale(localeProp);
   const text = useDatePickerLabels(clearLabel, undefined, undefined);
   const render = useTriggerFormat("dateRangePicker", locale, formatOptions, formatValue);
-  // `commit` is two props until 0.53: a string is the deprecated mode, anything else
-  // the write lock's scope (API-3).
-  const drafting = apply ?? commit === "apply";
-  const lock = useLockReason(typeof commit === "string" ? undefined : commit, disabledReason);
+  const drafting = apply ?? false;
+  const lock = useLockReason(commit, disabledReason);
   const locked = lock.locked;
   const messages = useFieldMessages({
     hint,

package/src/components/nav-pills.tsx

@@ -59,7 +59,7 @@ export interface NavPillsProps<T extends string> extends Omit<
    * 0.49: `wrap` (default) puts the pills on as many rows as they need. `scroll` keeps
    * them on ONE row that scrolls sideways — faded at a cut edge, the current pill
    * scrolled into view (the row only, never the page) — for a strip that must stay one
-   * line high, as {@link SectionNav} under a page title on a phone.
+   * line high, as a section's pages under a page title on a phone.
    */
   layout?: "wrap" | "scroll";
   /** The `<nav>` (or the `<div role="group">`) — hence `HTMLElement` (0.34, API-2,

package/src/components/series-chart-axes.ts

@@ -212,7 +212,12 @@ export function anchoredBand(extent: readonly [number, number] | undefined): [nu
  * it in its neighbour's colour on each click. Resolving the colours on the full list
  * and filtering after keeps each series in the colour its legend entry shows.
  */
-export function visibleSeries(series: readonly SeriesChartSeries[], hidden: ReadonlySet<string>): SeriesChartSeries[] {
+// Generic so a typed list comes back typed (0.53): a chart of `Month` rows takes it, and
+// its `dot`s still read `point.row` as a `Month`.
+export function visibleSeries<TRow extends object>(
+  series: readonly SeriesChartSeries<TRow>[],
+  hidden: ReadonlySet<string>,
+): SeriesChartSeries<TRow>[] {
   return series
     .map((entry, index) => ({ ...entry, color: entry.color ?? paletteFor(index) }))
     .filter((entry) => !hidden.has(entry.key));

package/src/components/series-chart.tsx

@@ -129,7 +129,14 @@ import { useChartEdge, useEdgesInForce } from "./chart-edge";
 import { cn } from "../lib/cn";
 import { formatWithMinus } from "../lib/minus";
 
-export interface SeriesChartSeries {
+/**
+ * One line, area or bar run of a {@link SeriesChart}.
+ *
+ * `TRow` is the chart's row type (0.53, keksdose after 0.52), and only `dot` reads it: its
+ * `point.row` is that type. Without a type argument a series is what it was, and a chart
+ * of typed rows still takes it — see {@link SeriesChartProps}.
+ */
+export interface SeriesChartSeries<TRow extends object = object> {
   /** The row key this line reads — and the `--color-<key>` it is painted with, so it
    *  must be a CSS identifier. Build keys out of data with {@link seriesKey}. */
   key: string;
@@ -177,8 +184,9 @@ export interface SeriesChartSeries {
    * point: `true` for the default dot, `false`/`null` for none, or any SVG node drawn
    * as-is at `point.cx`/`point.cy` — a buy/sell marker on keksdose's paper price.
    * Never called for a point with no value. Bars have no points, and ignore it.
+   * `point.row` is the caller's own row, typed as the chart's rows are (0.53).
    */
-  dot?: boolean | ((point: SeriesChartPoint) => ReactNode);
+  dot?: boolean | ((point: SeriesChartPoint<TRow>) => ReactNode);
   /** Line (or area outline) weight in px. Default 2, or 1.5 for a `step`. keksdose
    *  draws the subject of a chart at 2.5 and the reference it is read against at 1.5. */
   strokeWidth?: number;
@@ -213,14 +221,16 @@ export interface SeriesChartSeries {
 /** What a series draws. See {@link SeriesChartSeries.type}. */
 export type SeriesChartType = "line" | "bar" | "area";
 
-/** One point of a series, as a `dot` function is handed it. */
-export interface SeriesChartPoint {
+/** One point of a series, as a `dot` function is handed it. `TRow` is the chart's row
+ *  type (0.53); without one, `row` is a {@link SeriesChartRow}, as before. */
+export interface SeriesChartPoint<TRow extends object = object> {
   /** The series' key. */
   key: string;
   /** The row's position in `rows`. */
   index: number;
-  /** The caller's own row, with everything the chart did not plot still in it. */
-  row: SeriesChartRow;
+  /** The caller's own row, with everything the chart did not plot still in it: the very
+   *  object in `rows`, typed as `rows` is. */
+  row: SeriesChartRowOf<TRow>;
   /** The abscissa in the caller's terms: the number, the category, or (time) a Date. */
   x: SeriesChartXValue;
   value: number;
@@ -233,9 +243,32 @@ export interface SeriesChartPoint {
 
 /** A row of a series chart: one abscissa value and the series' values at it. Anything
  *  else in it (a raw ISO period for a drilldown) rides along untouched and is handed
- *  back in {@link SeriesChartPoint.row} and {@link SeriesChartHit.row}. */
+ *  back in {@link SeriesChartPoint.row} and {@link SeriesChartHit.row} — typed as the
+ *  caller's rows are since 0.53, and as this where their type names no keys. */
 export type SeriesChartRow = Readonly<Record<string, unknown>>;
 
+/**
+ * The row a hit or a point hands back, for a chart whose rows are `TRow[]` (0.53, keksdose
+ * after 0.52): `TRow` itself, so a drilldown reads `hit.row.rawPeriod` as the string it
+ * is. A {@link SeriesChartRow} where `TRow` names no keys — `object`, the default, which
+ * keeps `SeriesChartHit` and `SeriesChartPoint` without a type argument what they were, and
+ * the `object[]` rows an app passes today; `{}`; and `any` or `never` (`rows={[]}`), which
+ * are both assignable to `null` while no object type is.
+ *
+ * Both tests take `TRow` in the CHECKED position, never in the `extends` one, so TypeScript
+ * measures every type below as covariant in it (`SeriesChartSeries`, through `dot`'s
+ * parameter, contravariant) and relates two of them by their type arguments alone: a
+ * `SeriesChartHit<Month>` is a `SeriesChartHit`, and a handler or a series typed without an
+ * argument fits a chart of `Month` rows, though an interface has no index signature and is
+ * not, field by field, a `SeriesChartRow`. Written `object extends TRow ?`, the type is
+ * invariant and both of those stop type-checking.
+ */
+type SeriesChartRowOf<TRow> = [TRow] extends [null]
+  ? SeriesChartRow
+  : [keyof TRow] extends [never]
+    ? SeriesChartRow
+    : TRow;
+
 /** An abscissa value: a number (`x.type: "number"`), a category (a string, a number or
  *  a Date standing for a period), or a time (a Date, epoch ms or an ISO string). */
 export type SeriesChartXValue = number | string | Date;
@@ -551,29 +584,42 @@ export interface SeriesChartMarker {
   r?: number;
 }
 
-/** What a click on the plot picked. */
-export interface SeriesChartHit {
+/** What a click on the plot picked. `TRow` is the chart's row type (0.53); without one,
+ *  `row` is a {@link SeriesChartRow}, as before. */
+export interface SeriesChartHit<TRow extends object = object> {
   /** The row's position in `rows`. */
   index: number;
-  /** The caller's own row — with its `rawPeriod`, id or whatever the drilldown needs. */
-  row: SeriesChartRow;
+  /** The caller's own row — with its `rawPeriod`, id or whatever the drilldown needs: the
+   *  very object in `rows`, typed as `rows` is, so it is read without a cast. */
+  row: SeriesChartRowOf<TRow>;
   x: SeriesChartXValue;
   /** The series, when the click landed ON a bar. A click anywhere else picks the slot
    *  (the period), not a series. */
   key?: string;
 }
 
-export interface SeriesChartProps {
+/**
+ * The props of {@link SeriesChart} and {@link StaticSeriesChart}, for rows of type `TRow`.
+ *
+ * `TRow` is inferred from `rows` (0.53, keksdose after 0.52), and what the chart hands back
+ * — `hit.row` in `onPointClick`, `point.row` in a series' `dot` — is that type, so a
+ * drilldown reads its own fields without narrowing an `unknown`. Without a type argument,
+ * `SeriesChartProps` is what it was: any object is a row, and a row comes back as a
+ * {@link SeriesChartRow}. So is `ComponentProps<typeof SeriesChart>`, which reads the
+ * constraint, `object`. A series, a handler or a `dot` typed without an argument fits a
+ * chart of typed rows too.
+ */
+export interface SeriesChartProps<TRow extends object = object> {
   /**
    * One row per abscissa value. A missing key is a hole (see `connectNulls`).
    *
    * Any object (0.52, refactor audit 2026-10-30, API-2): an `interface` has no index
    * signature, so a typed sweep did not fit `SeriesChartRow` and Kurvenschmiede cast its
    * Ackermann rows `as unknown as Record<string, number>[]`. The chart reads the keys
-   * `series` and `x` name, and hands the row back as {@link SeriesChartRow}.
+   * `series` and `x` name, and hands the row back typed as these are (0.53).
    */
-  rows: readonly object[];
-  series: readonly SeriesChartSeries[];
+  rows: readonly TRow[];
+  series: readonly SeriesChartSeries<TRow>[];
   /** Default: one untitled axis, `"y"`. */
   axes?: readonly SeriesChartAxis[];
   x?: SeriesChartX;
@@ -628,7 +674,7 @@ export interface SeriesChartProps {
    * a chart without bars, named "period — series: value", behind ONE tab stop. With this
    * they are buttons that Enter and Space activate; without, images to read.
    */
-  onPointClick?: (hit: SeriesChartHit) => void;
+  onPointClick?: (hit: SeriesChartHit<TRow>) => void;
   /** Where the tooltip may go: for a chart inside a scroll wrapper. See
    *  {@link SeriesChartTooltip}. */
   tooltip?: SeriesChartTooltip;
@@ -760,8 +806,10 @@ export interface SeriesLegendAxes {
  * series whose axis is not drawn says the unit that axis would have: "Velocity (mm/s)"
  * — see {@link SeriesChartAxis.unit}. Without them, the labels are as given.
  */
-export function seriesLegendEntries(
-  series: readonly SeriesChartSeries[],
+export function seriesLegendEntries<TRow extends object>(
+  // Generic only so a typed list fits (0.53): `SeriesChartSeries<Month>` is not a
+  // `SeriesChartSeries`, whose `dot` would be handed rows that are not `Month`s.
+  series: readonly SeriesChartSeries<TRow>[],
   { axes, budgeted }: SeriesLegendAxes = {},
 ): LegendEntry[] {
   const undrawn = new Map<string, string | undefined>();
@@ -1819,7 +1867,12 @@ const ZoomablePlot = withChartZoom(SeriesPlot);
  * category or time chart otherwise re-maps every row on every render, and `maxRows`'
  * envelope would be worked out again with it.
  */
-function usePlotProps(props: SeriesChartProps): PlotProps {
+function usePlotProps<TRow extends object>(typed: SeriesChartProps<TRow>): PlotProps {
+  // `TRow` types only what the caller is handed back, and that is its own row objects,
+  // untouched (0.53): the plot reads them as the `object` rows they are. Through `unknown`
+  // because the two are not comparable for an unresolved `TRow`: `SeriesChartSeries` is
+  // contravariant in it (its `dot` is handed rows) and `rows` covariant.
+  const props = typed as unknown as SeriesChartProps;
   const x = props.x ?? {};
   const { rows } = props;
   const { type, key } = x;
@@ -1833,7 +1886,7 @@ function usePlotProps(props: SeriesChartProps): PlotProps {
  * button. For a thumbnail, a print view, or a chart the consumer wraps in its own
  * interaction.
  */
-export function StaticSeriesChart(props: SeriesChartProps) {
+export function StaticSeriesChart<TRow extends object = object>(props: SeriesChartProps<TRow>) {
   return <SeriesPlot {...usePlotProps(props)} />;
 }
 
@@ -1842,8 +1895,12 @@ export function StaticSeriesChart(props: SeriesChartProps) {
  * axes), double-click or press the reset button to go back; wrap several in
  * `SharedXZoom` to move their x windows together. Which axes zoom depends on the marks
  * — see {@link SeriesChartProps.zoomAxes}.
+ *
+ * Generic in its rows (0.53): `hit.row` and a `dot`'s `point.row` are typed as `rows` is —
+ * see {@link SeriesChartProps}. A plain function, so the generic survives: a `memo` or a
+ * `forwardRef` around it would read `TRow` as its constraint.
  */
-export function SeriesChart(props: SeriesChartProps) {
+export function SeriesChart<TRow extends object = object>(props: SeriesChartProps<TRow>) {
   // The zoom fits the PLOTTED rows — slot indices and epoch ms, not the caller's labels.
   return <ZoomablePlot {...usePlotProps(props)} />;
 }

package/src/components/treemap-labels.ts

@@ -13,13 +13,18 @@ export interface TreemapLabels {
    * `valueFormatter` when that returns text, else as the number in the provider's
    * locale; `share` is the tile's share of what is drawn, already a formatted percent
    * ("60 %" in German, "60%" in English) — the function only arranges them.
+   *
+   * `share` is `""` when the map's `shareInValue` says the formatter's text already holds
+   * it (0.53): leave out whatever frames it, as every catalogue drops its " (share)" —
+   * "Migros: CHF 412.30 · 12%", not "… · 12% ()".
    */
   tile: (name: string, value: string, share: string) => string;
   /**
    * A group's accessible name (0.52, `TreemapNode.children`): its frame is a stop of the
    * map's keyboard before its tiles, so a reader hears the group and its total once, on the
    * way in. `value` and `share` as for {@link TreemapLabels.tile}, of the group's tiles
-   * together; the word "group" tells it from a tile of the same shape.
+   * together, the share `""` under `shareInValue` as there; the word "group" tells it from
+   * a tile of the same shape.
    */
   group: (name: string, value: string, share: string) => string;
   /**
@@ -32,8 +37,11 @@ export interface TreemapLabels {
   inGroup: (name: string, group: string) => string;
 }
 
+// The share in brackets only when there is one: `""` under the map's `shareInValue` (0.53,
+// keksdose after 0.52), which the catalogues in src/i18n/locales follow, each in its own
+// typography.
 export const DEFAULT_TREEMAP_LABELS: TreemapLabels = {
-  tile: (name, value, share) => `${name}: ${value} (${share})`,
-  group: (name, value, share) => `${name}, group: ${value} (${share})`,
+  tile: (name, value, share) => `${name}: ${value}${share ? ` (${share})` : ""}`,
+  group: (name, value, share) => `${name}, group: ${value}${share ? ` (${share})` : ""}`,
   inGroup: (name, group) => `${name}, in ${group}`,
 };