@eifi1/ui-kit 0.51.7 → 0.53.0

package/dist/components/toggle-legend.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/toggle-legend.tsx"],"sourcesContent":["// A legend whose entries are SWITCHES — and the stroke table it shares with\n// `SeriesChart`. Lifted out of lenkbank's measurement plots, where ten legends over\n// thirteen charts took channels on and off the picture.\n//\n// No recharts in this module: a legend of switches is plain buttons, and it is as\n// useful under a chart the consumer drew by hand as under `SeriesChart`.\nimport type { ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { FOCUS_RING } from \"./focus-ring\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_SERIES_CHART_LABELS, type SeriesChartLabels } from \"./series-chart-labels\";\n\n/**\n * The strokes a reader can tell apart, in the order they are handed out.\n *\n * For the charts where the colour is already spoken for: a comparison draws each\n * measurement in its own colour, so a chart carrying several CHANNELS of each has\n * nothing left but the stroke — and \"solid versus dashed\" only gets you two.\n *\n * **Five, and the fifth is the last one.** They are the draughtsman's line types, in\n * the draughtsman's order — continuous, dashed, dotted, dash-dot, dash-dot-dot — the\n * one family of five a century of drawings has already proved legible at a hair's\n * width. A sixth is not distinguishable from one of these at two pixels wide, so a\n * chart needing one is a chart that should be split.\n *\n * Kept here, beside the legend's own mark, and read by `SeriesChart` from here — so\n * the key under a chart and the lines on it cannot disagree.\n */\nexport const STROKE_PATTERNS: readonly (string | undefined)[] = [undefined, \"5 4\", \"1 3\", \"9 3 2 3\", \"9 3 2 3 2 3\"];\n\n/** The dash array for the nth pattern, wrapping past the fifth. */\nexport function strokeDash(order: number): string | undefined {\n  const n = STROKE_PATTERNS.length;\n  return STROKE_PATTERNS[((Math.trunc(order) % n) + n) % n];\n}\n\n/** Which of the patterns a `step` series is drawn in.\n *\n *  A whole-number channel that jumps rather than travels is drawn dashed, and it has\n *  to be one of {@link STROKE_PATTERNS} rather than a dash array written out at the\n *  call site: a legend entry says its pattern by index, so a step line drawn in\n *  anything else would be a legend promising a solid line for a dashed one. */\nexport const STEP_DASH = 1;\n\n/**\n * One key switched, as a new hidden set.\n *\n * Every caller writes `onToggle={(key) => setHidden(toggleHidden(hidden, key))}`. A\n * new set rather than a mutated one, because the state is read during render and a\n * mutation of something a component already holds is invisible to React.\n */\nexport function toggleHidden(hidden: ReadonlySet<string>, key: string): ReadonlySet<string> {\n  const next = new Set(hidden);\n  if (!next.delete(key)) next.add(key);\n  return next;\n}\n\n/**\n * Where a legend that stands BESIDE a chart goes from Large up: UNDER it\n * (docs/text-size-harmonization.md §4). Beside a chart, a legend column takes a third of\n * a row whose plot needs all of it once the text is 25–50 % larger; under it, the row\n * is the plot's and the legend wraps across the width.\n *\n * Pure CSS (`large:`), so a legend moves with the text size alone, whatever drew the\n * row around it:\n * - in a GRID it spans a row of its own (`col-span-full`) after the charts\n *   (`order-last`) — Kurvenschmiede's facing pairs;\n * - in a FLEX row it takes a line of its own (`basis-full`), and its row is allowed to\n *   wrap for it (`[*:has(>&)]:flex-wrap` sets `flex-wrap` on the PARENT — the one rule\n *   here that reaches outside the legend, because a row that may not wrap would squeeze\n *   the chart to nothing beside a full-width legend) — Kurvenschmiede's chart rows.\n *\n * A caller that places its legend itself and wants it kept beside the chart at every\n * size overrides with `large:col-auto large:basis-auto`.\n */\nconst UNDER_THE_CHART_AT_LARGE = \"large:order-last large:col-span-full large:basis-full large:[*:has(>&)]:flex-wrap\";\n\n/** A vertical legend's entries from Large up: across, wrapping — it is under the chart\n *  now (see {@link UNDER_THE_CHART_AT_LARGE}), where a column of entries would be a\n *  screenful of one-word lines. */\nconst VERTICAL_AT_LARGE = \"large:flex-row large:flex-wrap large:items-center large:justify-start\";\n\nexport interface LegendEntry {\n  key: string;\n  label: ReactNode;\n  /** Any CSS colour — `paletteFor(i)` for the kit's own ramp. */\n  color: string;\n  /**\n   * What the entry's mark looks like. `swatch` — a filled square, the default — says\n   * WHICH MEASUREMENT. `stroke` says WHICH QUANTITY, for the charts that carry both at\n   * once and tell them apart by colour and by dash. `dot` is a round mark, for a\n   * MARKER on the chart (a point, an event) rather than a series.\n   */\n  marker?: \"swatch\" | \"stroke\" | \"dot\";\n  /** Which of {@link STROKE_PATTERNS}, when the marker is a stroke — the same index\n   *  `SeriesChartSeries.dash` takes, so a legend cannot promise a dot-dash the plot\n   *  draws dashed. Or the same custom `stroke-dasharray` string the series draws with\n   *  (keksdose's `\"4 3\"`). */\n  dash?: number | string;\n  /**\n   * A mark of the caller's own, drawn in place of {@link marker} — for a key whose\n   * mark is not a colour at all (a fading bar for \"open-ended\", a hairline for\n   * \"today\"). Decorative: it is wrapped `aria-hidden`, and the label is the name.\n   */\n  icon?: ReactNode;\n  /**\n   * `\"end\"`: push this entry to the legend's inline END — the far right in LTR, the far\n   * left in RTL — with everything before it kept at the start. kastlan's lease gantt\n   * (feedback #49) keys its bars at the start and its \"today\" hairline at the end, over\n   * the time axis whose end \"today\" is nearest, and wrote it as\n   * `className=\"[&>li:last-child]:ms-auto\"` — a selector that breaks the moment the\n   * entries are reordered and that reaches into the legend's markup.\n   *\n   * An auto inline-start margin, so it is logical (RTL mirrors it) and it takes only the\n   * row's LEFTOVER space: on a narrow screen where the row wraps, the entry wraps with it\n   * and sits at the end of its own line rather than overflowing. Give it to the LAST\n   * entry — auto margins push everything after them too, so an end entry in the middle\n   * drags the rest over with it (which is also how to end-align a GROUP: mark its first).\n   * In a vertical legend it sits at the column's inline end. Honoured by both\n   * {@link StaticLegend} and {@link ToggleLegend}, which share this entry type.\n   */\n  align?: \"start\" | \"end\";\n}\n\nexport interface ToggleLegendProps {\n  entries: LegendEntry[];\n  /** The keys currently off the chart. */\n  hidden: ReadonlySet<string>;\n  onToggle: (key: string) => void;\n  /** `vertical` is for a legend standing BESIDE the charts rather than under them —\n   *  what a row of charts sharing one legend wants, since under two charts there is\n   *  no \"under\", and putting it under one says it belongs to that one.\n   *\n   *  From Large up a vertical legend moves under the charts and lays its entries\n   *  across (0.32, docs/text-size-harmonization.md §4) — see {@link LegendColumn}. */\n  orientation?: \"horizontal\" | \"vertical\";\n  /**\n   * Draw a legend of ONE entry rather than nothing.\n   *\n   * A single line's legend is usually noise. It is not where the legend is the only\n   * SWITCH that line has — a series that starts hidden and has no entry to bring it\n   * back is gone for good.\n   */\n  showSingle?: boolean;\n  className?: string;\n  /** Per-instance strings over `<UiKitProvider labels={{ seriesChart }}>`. */\n  labels?: LabelOverride<SeriesChartLabels>;\n}\n\n/**\n * A legend whose entries are switches.\n *\n * `ChartLegendContent` with `onItemClick`/`activeKey` is the other kind: clicking an\n * entry HIGHLIGHTS it and dims the rest, which is right when every series belongs on\n * the chart and one of them is momentarily interesting. This is for the opposite —\n * three coordinates on one axis where y runs to 800 and z barely moves, and the only\n * way to see z is to take y off the chart entirely. Any number may be off at once.\n *\n * A hidden entry keeps its mark and its place. Removing it would reflow the legend on\n * every click and lose the one thing it is for: saying what COULD be shown.\n *\n * Each entry is a real `<button>` with `aria-pressed` — pressed means \"on the chart\" —\n * so Tab reaches every switch and Space/Enter flips it.\n */\nexport function ToggleLegend({\n  entries,\n  hidden,\n  onToggle,\n  orientation = \"horizontal\",\n  showSingle = false,\n  className,\n  labels: labelsProp,\n}: ToggleLegendProps) {\n  const labels = useKitLabels(\"seriesChart\", DEFAULT_SERIES_CHART_LABELS, labelsProp);\n  if (entries.length < (showSingle ? 1 : 2)) return null;\n  return (\n    <div\n      role=\"group\"\n      aria-label={labels.legend}\n      className={cn(\n        \"flex gap-x-3 gap-y-1\",\n        orientation === \"vertical\"\n          ? cn(\"flex-col items-start justify-center\", VERTICAL_AT_LARGE, UNDER_THE_CHART_AT_LARGE)\n          : \"mt-2 flex-wrap items-center\",\n        className,\n      )}\n    >\n      {entries.map((entry) => {\n        const off = hidden.has(entry.key);\n        return (\n          <button\n            key={entry.key}\n            type=\"button\"\n            // Pressed rather than a checkbox: it is a control over what the chart\n            // draws, and \"not pressed\" is the same sentence the dimmed mark says.\n            aria-pressed={!off}\n            onClick={() => onToggle(entry.key)}\n            className={cn(\n              \"flex items-center gap-1.5 rounded text-start text-caption text-secondary transition-opacity hover:opacity-80\",\n              FOCUS_RING,\n              off && \"opacity-35\",\n              entry.align === \"end\" && \"ms-auto\",\n            )}\n          >\n            <LegendMark entry={entry} off={off} />\n            {entry.label}\n          </button>\n        );\n      })}\n    </div>\n  );\n}\n\nexport interface StaticLegendProps {\n  entries: LegendEntry[];\n  /** See {@link ToggleLegendProps.orientation}. */\n  orientation?: \"horizontal\" | \"vertical\";\n  /** The list's accessible name. Default: the `seriesChart.legend` label. */\n  \"aria-label\"?: string;\n  /**\n   * `ul` (default): a list — \"list, 4 items\", walked with the list keys. Its entries are\n   * `listitem`s, so a host test that counts `getAllByRole(\"listitem\")` on a page with\n   * the legend on it counts the legend too: scope it (`within(...)`) or use `div`.\n   *\n   * `div`: a named `role=\"group\"` of plain entries, for a legend set inside something\n   * that is already a list or a table row, where a list in a list reads as nesting that\n   * is not there, or where the entries are too few for \"list, 2 items\" to help. The\n   * entries are read in order either way; only the list framing goes.\n   */\n  as?: \"ul\" | \"div\";\n  className?: string;\n  /** Per-instance strings over `<UiKitProvider labels={{ seriesChart }}>`. */\n  labels?: LabelOverride<SeriesChartLabels>;\n}\n\n/**\n * A legend that is a KEY, not a control: the same entries and marks as\n * {@link ToggleLegend} — swatch, stroke (with the chart's own dash), dot, or a mark of\n * the caller's own — but nothing to press.\n *\n * A separate component rather than `ToggleLegend` without `onToggle`, because the two\n * are different things to a screen reader: a group of switches announces a pressed\n * state on every entry, a key is a LIST, read as \"list, 4 items\" and walked with the\n * list keys, and costs no tab stops. The apps drew this by hand under the charts that\n * say what a colour or a dash means without letting you switch it (kastlan's lease\n * timeline, keksdose's cash buffer).\n *\n * Unlike `ToggleLegend` it draws a single entry: a key with one line still says what\n * the one mark on the chart means.\n */\nexport function StaticLegend({\n  entries,\n  orientation = \"horizontal\",\n  \"aria-label\": ariaLabel,\n  as = \"ul\",\n  className,\n  labels: labelsProp,\n}: StaticLegendProps) {\n  const labels = useKitLabels(\"seriesChart\", DEFAULT_SERIES_CHART_LABELS, labelsProp);\n  if (entries.length === 0) return null;\n  const List = as;\n  const Item = as === \"ul\" ? \"li\" : \"div\";\n  return (\n    <List\n      // A `div` takes `group`: a name on a role-less div is one ARIA forbids and\n      // screen readers drop, and the name is what says these marks are a key.\n      role={as === \"div\" ? \"group\" : undefined}\n      aria-label={ariaLabel ?? labels.legend}\n      className={cn(\n        \"m-0 flex list-none gap-x-3 gap-y-1 p-0\",\n        orientation === \"vertical\"\n          ? cn(\"flex-col items-start justify-center\", VERTICAL_AT_LARGE, UNDER_THE_CHART_AT_LARGE)\n          : \"mt-2 flex-wrap items-center\",\n        className,\n      )}\n    >\n      {entries.map((entry) => (\n        <Item\n          key={entry.key}\n          className={cn(\"flex items-center gap-1.5 text-caption text-secondary\", entry.align === \"end\" && \"ms-auto\")}\n        >\n          <LegendMark entry={entry} off={false} />\n          {entry.label}\n        </Item>\n      ))}\n    </List>\n  );\n}\n\n/**\n * The column a vertical legend stands in: beside the charts, on their horizontal\n * centre line. `h-full` + `justify-center`, so it centres in a grid cell or a flex row\n * that stretches it — and stacks whatever it is given, which is what a panel showing\n * two legends at once needs. The width is the caller's: how wide a legend column is\n * is a fact about that screen's layout.\n *\n * **From Large up it goes UNDER the charts** (0.32, docs/text-size-harmonization.md\n * §4): a row of its own in a grid, a line of its own in a flex row (see\n * `UNDER_THE_CHART_AT_LARGE`), with what it holds laid across and wrapping. A\n * caller's own `max-sm:flex-row …` for the phone keeps working; the caller's width\n * (`sm:w-40`) gives way to the full row, because a size wins over a breakpoint.\n */\nexport function LegendColumn({ children, className }: { children: ReactNode; className?: string }) {\n  return (\n    <div\n      className={cn(\n        \"flex h-full flex-col justify-center gap-3\",\n        UNDER_THE_CHART_AT_LARGE,\n        \"large:h-auto large:flex-row large:flex-wrap large:items-start large:justify-start large:gap-x-6\",\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n}\n\n/**\n * A legend and what it is a legend OF, as a headed column.\n *\n * For legends that are several vocabularies at once — which measurement and which\n * channel — so the entries are read down a group and the groups across. Wrapped rows\n * would put the second half of one group on a line under the first half of the next.\n */\nexport function LegendGroup({ title, children }: { title: ReactNode; children: ReactNode }) {\n  return (\n    <div className=\"flex min-w-0 flex-col items-start gap-1\">\n      <span className=\"text-micro font-semibold uppercase tracking-wide text-muted\">{title}</span>\n      <div className=\"flex flex-col items-start gap-y-0.5\">{children}</div>\n    </div>\n  );\n}\n\n/** The entry's mark: a square for a measurement, a stroke for a quantity. A hidden one\n *  keeps its outline — a mark that vanished would leave a line of text with nothing in\n *  front of it.\n *\n *  A stroke is an SVG line with the chart's own `strokeDasharray`, not a CSS gradient\n *  approximating it: a gradient can say \"solid or dashed\" and nothing more.\n *\n *  A hidden stroke is NOT faded here: the button around it already is (`opacity-35`),\n *  and the line used to take its own 0.35 on top — 0.35 × 0.35, about 12 %, a mark\n *  gone rather than dimmed, while the square beside it read at the full 35 %. */\nfunction LegendMark({ entry, off }: { entry: LegendEntry; off: boolean }) {\n  if (entry.icon != null) {\n    return (\n      <span aria-hidden className=\"inline-flex shrink-0 items-center\">\n        {entry.icon}\n      </span>\n    );\n  }\n  if (entry.marker === \"dot\") {\n    return (\n      <span\n        aria-hidden\n        className=\"size-2 shrink-0 rounded-full\"\n        style={{\n          backgroundColor: off ? \"transparent\" : entry.color,\n          boxShadow: `inset 0 0 0 1.5px ${entry.color}`,\n        }}\n      />\n    );\n  }\n  if (entry.marker === \"stroke\") {\n    return (\n      <svg aria-hidden viewBox=\"0 0 20 2\" className=\"h-0.5 w-5 shrink-0 overflow-visible\">\n        <line\n          x1={0}\n          y1={1}\n          x2={20}\n          y2={1}\n          stroke={entry.color}\n          strokeWidth={2}\n          strokeDasharray={typeof entry.dash === \"string\" ? entry.dash : strokeDash(entry.dash ?? 0)}\n        />\n      </svg>\n    );\n  }\n  return (\n    <span\n      aria-hidden\n      className=\"h-2.5 w-2.5 shrink-0 rounded-[3px]\"\n      style={{\n        backgroundColor: off ? \"transparent\" : entry.color,\n        boxShadow: `inset 0 0 0 1.5px ${entry.color}`,\n      }}\n    />\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/toggle-legend.tsx"],"sourcesContent":["// A legend whose entries are SWITCHES — and the stroke table it shares with\n// `SeriesChart`. Lifted out of lenkbank's measurement plots, where ten legends over\n// thirteen charts took channels on and off the picture.\n//\n// No recharts in this module: a legend of switches is plain buttons, and it is as\n// useful under a chart the consumer drew by hand as under `SeriesChart`.\nimport type { ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { FOCUS_RING } from \"./focus-ring\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_SERIES_CHART_LABELS, type SeriesChartLabels } from \"./series-chart-labels\";\n\n/**\n * The strokes a reader can tell apart, in the order they are handed out.\n *\n * For the charts where the colour is already spoken for: a comparison draws each\n * measurement in its own colour, so a chart carrying several CHANNELS of each has\n * nothing left but the stroke — and \"solid versus dashed\" only gets you two.\n *\n * **Five, and the fifth is the last one.** They are the draughtsman's line types, in\n * the draughtsman's order — continuous, dashed, dotted, dash-dot, dash-dot-dot — the\n * one family of five a century of drawings has already proved legible at a hair's\n * width. A sixth is not distinguishable from one of these at two pixels wide, so a\n * chart needing one is a chart that should be split.\n *\n * Kept here, beside the legend's own mark, and read by `SeriesChart` from here — so\n * the key under a chart and the lines on it cannot disagree.\n */\nexport const STROKE_PATTERNS: readonly (string | undefined)[] = [undefined, \"5 4\", \"1 3\", \"9 3 2 3\", \"9 3 2 3 2 3\"];\n\n/** The dash array for the nth pattern, wrapping past the fifth. */\nexport function strokeDash(order: number): string | undefined {\n  const n = STROKE_PATTERNS.length;\n  return STROKE_PATTERNS[((Math.trunc(order) % n) + n) % n];\n}\n\n/** Which of the patterns a `step` series is drawn in.\n *\n *  A whole-number channel that jumps rather than travels is drawn dashed, and it has\n *  to be one of {@link STROKE_PATTERNS} rather than a dash array written out at the\n *  call site: a legend entry says its pattern by index, so a step line drawn in\n *  anything else would be a legend promising a solid line for a dashed one. */\nexport const STEP_DASH = 1;\n\n/**\n * One key switched, as a new hidden set.\n *\n * Every caller writes `onToggle={(key) => setHidden(toggleHidden(hidden, key))}`. A\n * new set rather than a mutated one, because the state is read during render and a\n * mutation of something a component already holds is invisible to React.\n */\nexport function toggleHidden(hidden: ReadonlySet<string>, key: string): ReadonlySet<string> {\n  const next = new Set(hidden);\n  if (!next.delete(key)) next.add(key);\n  return next;\n}\n\n/**\n * Where a legend that stands BESIDE a chart goes from Large up: UNDER it\n * (docs/text-size-harmonization.md §4). Beside a chart, a legend column takes a third of\n * a row whose plot needs all of it once the text is 25–50 % larger; under it, the row\n * is the plot's and the legend wraps across the width.\n *\n * Pure CSS (`large:`), so a legend moves with the text size alone, whatever drew the\n * row around it:\n * - in a GRID it spans a row of its own (`col-span-full`) after the charts\n *   (`order-last`) — Kurvenschmiede's facing pairs;\n * - in a FLEX row it takes a line of its own (`basis-full`), and its row is allowed to\n *   wrap for it (`[*:has(>&)]:flex-wrap` sets `flex-wrap` on the PARENT — the one rule\n *   here that reaches outside the legend, because a row that may not wrap would squeeze\n *   the chart to nothing beside a full-width legend) — Kurvenschmiede's chart rows.\n *\n * A caller that places its legend itself and wants it kept beside the chart at every\n * size overrides with `large:col-auto large:basis-auto`.\n */\nconst UNDER_THE_CHART_AT_LARGE = \"large:order-last large:col-span-full large:basis-full large:[*:has(>&)]:flex-wrap\";\n\n/** A vertical legend's entries from Large up: across, wrapping — it is under the chart\n *  now (see {@link UNDER_THE_CHART_AT_LARGE}), where a column of entries would be a\n *  screenful of one-word lines. */\nconst VERTICAL_AT_LARGE = \"large:flex-row large:flex-wrap large:items-center large:justify-start\";\n\nexport interface LegendEntry {\n  key: string;\n  label: ReactNode;\n  /** Any CSS colour — `paletteFor(i)` for the kit's own ramp. */\n  color: string;\n  /**\n   * What the entry's mark looks like. `swatch` — a filled square, the default — says\n   * WHICH MEASUREMENT. `stroke` says WHICH QUANTITY, for the charts that carry both at\n   * once and tell them apart by colour and by dash. `dot` is a round mark, for a\n   * MARKER on the chart (a point, an event) rather than a series.\n   */\n  marker?: \"swatch\" | \"stroke\" | \"dot\";\n  /** Which of {@link STROKE_PATTERNS}, when the marker is a stroke — the same index\n   *  `SeriesChartSeries.dash` takes, so a legend cannot promise a dot-dash the plot\n   *  draws dashed. Or the same custom `stroke-dasharray` string the series draws with\n   *  (keksdose's `\"4 3\"`). */\n  dash?: number | string;\n  /**\n   * A mark of the caller's own, drawn in place of {@link marker} — for a key whose\n   * mark is not a colour at all (a fading bar for \"open-ended\", a hairline for\n   * \"today\"). Decorative: it is wrapped `aria-hidden`, and the label is the name.\n   */\n  icon?: ReactNode;\n  /**\n   * `\"end\"`: push this entry to the legend's inline END — the far right in LTR, the far\n   * left in RTL — with everything before it kept at the start. kastlan's lease gantt\n   * (feedback #49) keys its bars at the start and its \"today\" hairline at the end, over\n   * the time axis whose end \"today\" is nearest, and wrote it as\n   * `className=\"[&>li:last-child]:ms-auto\"` — a selector that breaks the moment the\n   * entries are reordered and that reaches into the legend's markup.\n   *\n   * An auto inline-start margin, so it is logical (RTL mirrors it) and it takes only the\n   * row's LEFTOVER space: on a narrow screen where the row wraps, the entry wraps with it\n   * and sits at the end of its own line rather than overflowing. Give it to the LAST\n   * entry — auto margins push everything after them too, so an end entry in the middle\n   * drags the rest over with it (which is also how to end-align a GROUP: mark its first).\n   * In a vertical legend it sits at the column's inline end. Honoured by both\n   * {@link StaticLegend} and {@link ToggleLegend}, which share this entry type.\n   */\n  align?: \"start\" | \"end\";\n}\n\nexport interface ToggleLegendProps {\n  entries: readonly LegendEntry[];\n  /** The keys currently off the chart. */\n  hidden: ReadonlySet<string>;\n  onToggle: (key: string) => void;\n  /** `vertical` is for a legend standing BESIDE the charts rather than under them —\n   *  what a row of charts sharing one legend wants, since under two charts there is\n   *  no \"under\", and putting it under one says it belongs to that one.\n   *\n   *  From Large up a vertical legend moves under the charts and lays its entries\n   *  across (0.32, docs/text-size-harmonization.md §4) — see {@link LegendColumn}. */\n  orientation?: \"horizontal\" | \"vertical\";\n  /**\n   * Draw a legend of ONE entry rather than nothing.\n   *\n   * A single line's legend is usually noise. It is not where the legend is the only\n   * SWITCH that line has — a series that starts hidden and has no entry to bring it\n   * back is gone for good.\n   */\n  showSingle?: boolean;\n  className?: string;\n  /** Per-instance strings over `<UiKitProvider labels={{ seriesChart }}>`. */\n  labels?: LabelOverride<SeriesChartLabels>;\n}\n\n/**\n * A legend whose entries are switches.\n *\n * `ChartLegendContent` with `onItemClick`/`activeKey` is the other kind: clicking an\n * entry HIGHLIGHTS it and dims the rest, which is right when every series belongs on\n * the chart and one of them is momentarily interesting. This is for the opposite —\n * three coordinates on one axis where y runs to 800 and z barely moves, and the only\n * way to see z is to take y off the chart entirely. Any number may be off at once.\n *\n * A hidden entry keeps its mark and its place. Removing it would reflow the legend on\n * every click and lose the one thing it is for: saying what COULD be shown.\n *\n * Each entry is a real `<button>` with `aria-pressed` — pressed means \"on the chart\" —\n * so Tab reaches every switch and Space/Enter flips it.\n */\nexport function ToggleLegend({\n  entries,\n  hidden,\n  onToggle,\n  orientation = \"horizontal\",\n  showSingle = false,\n  className,\n  labels: labelsProp,\n}: ToggleLegendProps) {\n  const labels = useKitLabels(\"seriesChart\", DEFAULT_SERIES_CHART_LABELS, labelsProp);\n  if (entries.length < (showSingle ? 1 : 2)) return null;\n  return (\n    <div\n      role=\"group\"\n      aria-label={labels.legend}\n      className={cn(\n        \"flex gap-x-3 gap-y-1\",\n        orientation === \"vertical\"\n          ? cn(\"flex-col items-start justify-center\", VERTICAL_AT_LARGE, UNDER_THE_CHART_AT_LARGE)\n          : \"mt-2 flex-wrap items-center\",\n        className,\n      )}\n    >\n      {entries.map((entry) => {\n        const off = hidden.has(entry.key);\n        return (\n          <button\n            key={entry.key}\n            type=\"button\"\n            // Pressed rather than a checkbox: it is a control over what the chart\n            // draws, and \"not pressed\" is the same sentence the dimmed mark says.\n            aria-pressed={!off}\n            onClick={() => onToggle(entry.key)}\n            className={cn(\n              \"flex items-center gap-1.5 rounded text-start text-caption text-secondary transition-opacity hover:opacity-80\",\n              FOCUS_RING,\n              entry.align === \"end\" && \"ms-auto\",\n            )}\n          >\n            <LegendMark entry={entry} off={off} />\n            {/* Off, the label keeps its ink and is struck through; only the mark fades\n                (0.52, refactor audit 2026-10-30, DSP-9). The whole entry at 35 % put the\n                label at 1.8:1 — on a button that brings the series back, whose label is\n                the only thing saying which one. `aria-pressed` carries the state. */}\n            <span className={cn(off && \"line-through\")}>{entry.label}</span>\n          </button>\n        );\n      })}\n    </div>\n  );\n}\n\nexport interface StaticLegendProps {\n  entries: readonly LegendEntry[];\n  /** See {@link ToggleLegendProps.orientation}. */\n  orientation?: \"horizontal\" | \"vertical\";\n  /** The list's accessible name. Default: the `seriesChart.legend` label. */\n  \"aria-label\"?: string;\n  /**\n   * `ul` (default): a list — \"list, 4 items\", walked with the list keys. Its entries are\n   * `listitem`s, so a host test that counts `getAllByRole(\"listitem\")` on a page with\n   * the legend on it counts the legend too: scope it (`within(...)`) or use `div`.\n   *\n   * `div`: a named `role=\"group\"` of plain entries, for a legend set inside something\n   * that is already a list or a table row, where a list in a list reads as nesting that\n   * is not there, or where the entries are too few for \"list, 2 items\" to help. The\n   * entries are read in order either way; only the list framing goes.\n   */\n  as?: \"ul\" | \"div\";\n  className?: string;\n  /** Per-instance strings over `<UiKitProvider labels={{ seriesChart }}>`. */\n  labels?: LabelOverride<SeriesChartLabels>;\n}\n\n/**\n * A legend that is a KEY, not a control: the same entries and marks as\n * {@link ToggleLegend} — swatch, stroke (with the chart's own dash), dot, or a mark of\n * the caller's own — but nothing to press.\n *\n * A separate component rather than `ToggleLegend` without `onToggle`, because the two\n * are different things to a screen reader: a group of switches announces a pressed\n * state on every entry, a key is a LIST, read as \"list, 4 items\" and walked with the\n * list keys, and costs no tab stops. The apps drew this by hand under the charts that\n * say what a colour or a dash means without letting you switch it (kastlan's lease\n * timeline, keksdose's cash buffer).\n *\n * Unlike `ToggleLegend` it draws a single entry: a key with one line still says what\n * the one mark on the chart means.\n */\nexport function StaticLegend({\n  entries,\n  orientation = \"horizontal\",\n  \"aria-label\": ariaLabel,\n  as = \"ul\",\n  className,\n  labels: labelsProp,\n}: StaticLegendProps) {\n  const labels = useKitLabels(\"seriesChart\", DEFAULT_SERIES_CHART_LABELS, labelsProp);\n  if (entries.length === 0) return null;\n  const List = as;\n  const Item = as === \"ul\" ? \"li\" : \"div\";\n  return (\n    <List\n      // A `div` takes `group`: a name on a role-less div is one ARIA forbids and\n      // screen readers drop, and the name is what says these marks are a key.\n      role={as === \"div\" ? \"group\" : undefined}\n      aria-label={ariaLabel ?? labels.legend}\n      className={cn(\n        \"m-0 flex list-none gap-x-3 gap-y-1 p-0\",\n        orientation === \"vertical\"\n          ? cn(\"flex-col items-start justify-center\", VERTICAL_AT_LARGE, UNDER_THE_CHART_AT_LARGE)\n          : \"mt-2 flex-wrap items-center\",\n        className,\n      )}\n    >\n      {entries.map((entry) => (\n        <Item\n          key={entry.key}\n          className={cn(\"flex items-center gap-1.5 text-caption text-secondary\", entry.align === \"end\" && \"ms-auto\")}\n        >\n          <LegendMark entry={entry} off={false} />\n          {entry.label}\n        </Item>\n      ))}\n    </List>\n  );\n}\n\n/**\n * The column a vertical legend stands in: beside the charts, on their horizontal\n * centre line. `h-full` + `justify-center`, so it centres in a grid cell or a flex row\n * that stretches it — and stacks whatever it is given, which is what a panel showing\n * two legends at once needs. The width is the caller's: how wide a legend column is\n * is a fact about that screen's layout.\n *\n * **From Large up it goes UNDER the charts** (0.32, docs/text-size-harmonization.md\n * §4): a row of its own in a grid, a line of its own in a flex row (see\n * `UNDER_THE_CHART_AT_LARGE`), with what it holds laid across and wrapping. A\n * caller's own `max-sm:flex-row …` for the phone keeps working; the caller's width\n * (`sm:w-40`) gives way to the full row, because a size wins over a breakpoint.\n */\nexport function LegendColumn({ children, className }: { children: ReactNode; className?: string }) {\n  return (\n    <div\n      className={cn(\n        \"flex h-full flex-col justify-center gap-3\",\n        UNDER_THE_CHART_AT_LARGE,\n        \"large:h-auto large:flex-row large:flex-wrap large:items-start large:justify-start large:gap-x-6\",\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n}\n\n/**\n * A legend and what it is a legend OF, as a headed column.\n *\n * For legends that are several vocabularies at once — which measurement and which\n * channel — so the entries are read down a group and the groups across. Wrapped rows\n * would put the second half of one group on a line under the first half of the next.\n */\nexport function LegendGroup({ title, children }: { title: ReactNode; children: ReactNode }) {\n  return (\n    <div className=\"flex min-w-0 flex-col items-start gap-1\">\n      <span className=\"text-micro font-semibold uppercase tracking-wide text-muted\">{title}</span>\n      <div className=\"flex flex-col items-start gap-y-0.5\">{children}</div>\n    </div>\n  );\n}\n\n/** The entry's mark: a square for a measurement, a stroke for a quantity. A hidden one\n *  keeps its outline — a mark that vanished would leave a line of text with nothing in\n *  front of it.\n *\n *  A stroke is an SVG line with the chart's own `strokeDasharray`, not a CSS gradient\n *  approximating it: a gradient can say \"solid or dashed\" and nothing more.\n *\n *  A hidden mark fades ONCE, on its own box (`opacity-35`; since 0.52 the label beside\n *  it keeps its ink, DSP-9). The line used to take its own 0.35 inside a faded button —\n *  0.35 × 0.35, about 12 %, a mark gone rather than dimmed, while the square beside it\n *  read at the full 35 %. */\nfunction LegendMark({ entry, off }: { entry: LegendEntry; off: boolean }) {\n  const fade = off && \"opacity-35\";\n  if (entry.icon != null) {\n    return (\n      <span aria-hidden className={cn(\"inline-flex shrink-0 items-center\", fade)}>\n        {entry.icon}\n      </span>\n    );\n  }\n  if (entry.marker === \"dot\") {\n    return (\n      <span\n        aria-hidden\n        className={cn(\"size-2 shrink-0 rounded-full\", fade)}\n        style={{\n          backgroundColor: off ? \"transparent\" : entry.color,\n          boxShadow: `inset 0 0 0 1.5px ${entry.color}`,\n        }}\n      />\n    );\n  }\n  if (entry.marker === \"stroke\") {\n    return (\n      <svg aria-hidden viewBox=\"0 0 20 2\" className={cn(\"h-0.5 w-5 shrink-0 overflow-visible\", fade)}>\n        <line\n          x1={0}\n          y1={1}\n          x2={20}\n          y2={1}\n          stroke={entry.color}\n          strokeWidth={2}\n          strokeDasharray={typeof entry.dash === \"string\" ? entry.dash : strokeDash(entry.dash ?? 0)}\n        />\n      </svg>\n    );\n  }\n  return (\n    <span\n      aria-hidden\n      className={cn(\"h-2.5 w-2.5 shrink-0 rounded-[3px]\", fade)}\n      style={{\n        backgroundColor: off ? \"transparent\" : entry.color,\n        boxShadow: `inset 0 0 0 1.5px ${entry.color}`,\n      }}\n    />\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/translation-review-editor.d.ts

@@ -30,8 +30,10 @@ export interface TranslationReviewEditorProps {
      * opened by a tap — that one may only be opened to read.
      */
     focusWording?: boolean;
-    /** How the verdict's date reads. Default: the kit's `formatDate`, medium, in the
-     *  provider's locale. */
+    /** How the verdict's date reads. Default (0.52): the `<UiKitProvider formatDate>` when
+     *  the app set one (its date preference; the day sits in a sentence, so no weekday), else
+     *  the kit's `formatDate`, medium, in the provider's locale and `timeZone`. An empty
+     *  answer falls back to the kit's. */
     formatDate?: (iso: string) => string;
     /** Turns a rejection into words. Default {@link TranslationReviewLabels.failed}. */
     formatError?: (error: unknown) => ReactNode;

package/dist/components/translation-review-editor.js

@@ -3,7 +3,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
 import { useKitLabels } from "../i18n/kit-labels.js";
 import { cn } from "../lib/cn.js";
-import { useKitFormat } from "../lib/format.js";
+import { useDayFormatter } from "../lib/day-format.js";
 import { placeholderTokens, reviewWrite } from "../lib/translation-review.js";
 import { AlertBanner } from "./alert-banner.js";
 import { Caption, SectionLabel } from "./text.js";
@@ -32,7 +32,7 @@ function TranslationReviewEditor({
   labels: labelsProp
 }) {
   const labels = useKitLabels("translationReview", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);
-  const { formatDate } = useKitFormat();
+  const date = useDayFormatter(formatDateProp);
   const review = row.review;
   const missing = row.text === "";
   const editable = !readOnly && onSave !== void 0;
@@ -50,7 +50,6 @@ function TranslationReviewEditor({
   }, []);
   const canFlag = note.trim() !== "" || suggestion.trim() !== row.text.trim();
   const changed = row.status === "changed" ? review : null;
-  const date = (iso) => formatDateProp ? formatDateProp(iso) : formatDate(iso, "medium");
   const run = async (kind, action) => {
     setBusy(kind);
     setFailure(null);

package/dist/components/translation-review-editor.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/translation-review-editor.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { useKitFormat } from \"../lib/format\";\nimport { placeholderTokens, reviewWrite } from \"../lib/translation-review\";\nimport type {\n  TranslationReviewKey,\n  TranslationReviewWrite,\n  TranslationRow,\n  TranslationVerdict,\n} from \"../lib/translation-review\";\nimport { AlertBanner } from \"./alert-banner\";\nimport { Caption, SectionLabel } from \"./text\";\nimport { DEFAULT_TRANSLATION_REVIEW_LABELS } from \"./translation-review-labels\";\nimport type { TranslationReviewLabels } from \"./translation-review-labels\";\nimport { Button } from \"./button\";\nimport { Textarea } from \"./textarea\";\nimport { COMMIT_EXCEPT_BILLING } from \"./write-lock\";\n\n/** A callback may return a promise: resolve and the editor closes, reject and it stays\n *  open with the error. */\ntype MaybePromise = void | Promise<unknown>;\n\nexport interface TranslationReviewEditorProps {\n  row: TranslationRow;\n  /** The reference language's own name (\"English\", \"Deutsch\") — the app's choice of\n   *  reference, so the app's word for it. */\n  referenceLabel: ReactNode;\n  /** The reviewed language's own name (\"Français\"). */\n  localeLabel: ReactNode;\n  /** Store a verdict. Left out (or `readOnly`): the editor shows the row and its last\n   *  verdict, with no fields and no actions. */\n  onSave?: (write: TranslationReviewWrite) => MaybePromise;\n  /** Clear the verdict — back to unreviewed. Left out: no reset button. */\n  onClear?: (key: TranslationReviewKey) => MaybePromise;\n  /** The Cancel button — and called after a save or a reset resolves, so the panel\n   *  that opened the editor closes it. */\n  onClose?: () => void;\n  /** Look, do not touch: a locale the viewer may read but not review. */\n  readOnly?: boolean;\n  /**\n   * 0.25: put the cursor in the wording field when the editor opens, at the end of the\n   * text. The panel sets it when a phone card is swiped toward \"Needs a change\" (keksdose\n   * live #377): that swipe opens the editor to be written in, and a reviewer who has just\n   * said \"this is wrong\" should not have to find the field first. Not for an editor\n   * opened by a tap — that one may only be opened to read.\n   */\n  focusWording?: boolean;\n  /** How the verdict's date reads. Default: the kit's `formatDate`, medium, in the\n   *  provider's locale. */\n  formatDate?: (iso: string) => string;\n  /** Turns a rejection into words. Default {@link TranslationReviewLabels.failed}. */\n  formatError?: (error: unknown) => ReactNode;\n  className?: string;\n  labels?: LabelOverride<TranslationReviewLabels>;\n}\n\n/** The wording a verdict was given on, under the line that says it changed. */\nfunction Then({ label, text }: { label: string; text: string }) {\n  return (\n    <div className=\"mt-1.5 min-w-0\">\n      <span className=\"text-xs font-medium\">{label}</span>\n      <p className=\"whitespace-pre-line break-words text-secondary\">{text}</p>\n    </div>\n  );\n}\n\n/**\n * One string, opened: the reference beside the translation, what changed since the last\n * verdict, what a machine can see is wrong (the placeholders), and the two things a\n * reviewer can say about it — keksdose's and kastlan's `translation-review-editor.tsx`.\n *\n * \"Better wording\" opens on the CURRENT text rather than empty, because the usual\n * correction is a word or an ending, and retyping a sentence to change one word is how\n * new mistakes get in. It is sent only with \"Needs a change\" — approving says the text is\n * fine as it stands. A \"Needs a change\" with neither a note nor a different wording tells\n * whoever fixes it nothing, so it takes one of the two.\n *\n * A MISSING string (kastlan: the locale lacks the key) cannot be approved — there is\n * nothing to approve. Its field starts empty and is the translation to add; the verdict\n * is NEEDS_CHANGE on the empty text, which the export hands a developer as the string to\n * add.\n *\n * Every action waits for its callback: the buttons hold while the promise is out, a\n * resolution closes the editor through `onClose`, and a rejection keeps it open with what\n * was typed and the error under the buttons.\n *\n * Each verdict is a `commit` exempt from billing (`COMMIT_EXCEPT_BILLING`, 0.33): a review\n * is an admin route, which a lapsed plan never locks (docs/billing-harmonization.md\n * §12.13, §12.36); a demo's lock still holds it.\n */\nexport function TranslationReviewEditor({\n  row,\n  referenceLabel,\n  localeLabel,\n  onSave,\n  onClear,\n  onClose,\n  readOnly = false,\n  focusWording = false,\n  formatDate: formatDateProp,\n  formatError,\n  className,\n  labels: labelsProp,\n}: TranslationReviewEditorProps) {\n  const labels = useKitLabels(\"translationReview\", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);\n  const { formatDate } = useKitFormat();\n  const review = row.review;\n  const missing = row.text === \"\";\n  const editable = !readOnly && onSave !== undefined;\n  const [suggestion, setSuggestion] = useState(review?.suggestion ?? row.text);\n  const [note, setNote] = useState(review?.note ?? \"\");\n  const [busy, setBusy] = useState<\"approve\" | \"flag\" | \"clear\" | null>(null);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const wordingRef = useRef<HTMLTextAreaElement>(null);\n  // On mount only: the prop says how the editor was OPENED, not where focus belongs\n  // for the rest of its life.\n  const focusOnOpen = useRef(focusWording && editable);\n  useEffect(() => {\n    const field = wordingRef.current;\n    if (!focusOnOpen.current || !field) return;\n    field.focus();\n    field.setSelectionRange(field.value.length, field.value.length);\n  }, []);\n\n  const canFlag = note.trim() !== \"\" || suggestion.trim() !== row.text.trim();\n  const changed = row.status === \"changed\" ? review : null;\n  const date = (iso: string) => (formatDateProp ? formatDateProp(iso) : formatDate(iso, \"medium\"));\n\n  const run = async (kind: \"approve\" | \"flag\" | \"clear\", action: () => MaybePromise) => {\n    setBusy(kind);\n    setFailure(null);\n    try {\n      await action();\n      onClose?.();\n    } catch (caught) {\n      setFailure(formatError ? formatError(caught) : labels.failed);\n    } finally {\n      setBusy(null);\n    }\n  };\n\n  const save = (verdict: TranslationVerdict) => {\n    if (!onSave) return;\n    const trimmedNote = note.trim() || null;\n    // Approving says the text is right as it stands: there is no wording to suggest.\n    const sent = verdict === \"APPROVED\" ? null : suggestion.trim() || null;\n    void run(verdict === \"APPROVED\" ? \"approve\" : \"flag\", () => onSave(reviewWrite(row, verdict, trimmedNote, sent)));\n  };\n\n  return (\n    <div className={cn(\"min-w-0 space-y-3 text-sm\", className)}>\n      <code className=\"block break-all text-xs text-muted\">{row.key}</code>\n\n      <div className=\"grid grid-cols-1 gap-3 md:grid-cols-2\">\n        <div className=\"min-w-0\">\n          <SectionLabel as=\"span\" size=\"xs\">\n            {referenceLabel}\n          </SectionLabel>\n          <p className=\"mt-1 whitespace-pre-line break-words text-secondary\">{row.reference}</p>\n        </div>\n        <div className=\"min-w-0\">\n          <SectionLabel as=\"span\" size=\"xs\">\n            {localeLabel}\n          </SectionLabel>\n          {missing ? (\n            <p className=\"mt-1 italic text-muted\">{labels.missingText}</p>\n          ) : (\n            <p lang={row.locale} className=\"mt-1 whitespace-pre-line break-words\">\n              {row.text}\n            </p>\n          )}\n        </div>\n      </div>\n\n      {changed && (\n        <AlertBanner tone=\"warning\" variant=\"inline\" size=\"sm\" block live={false}>\n          <div className=\"min-w-0\">\n            <p>{labels.changedSince}</p>\n            {changed.text !== row.text && <Then label={labels.reviewedWording} text={changed.text || \"—\"} />}\n            {changed.referenceText != null && changed.referenceText !== row.reference && (\n              <Then label={labels.reviewedReference} text={changed.referenceText} />\n            )}\n          </div>\n        </AlertBanner>\n      )}\n\n      {row.placeholderMismatch && (\n        <AlertBanner tone=\"danger\" variant=\"inline\" size=\"sm\" block live={false}>\n          <span className=\"min-w-0 break-words\">\n            {labels.placeholderMismatch(\n              placeholderTokens(row.reference).join(\" \") || \"—\",\n              placeholderTokens(row.text).join(\" \") || \"—\",\n            )}\n          </span>\n        </AlertBanner>\n      )}\n\n      {review && (\n        <Caption>\n          {(review.verdict === \"APPROVED\" ? labels.lastApproved : labels.lastFlagged)(\n            review.reviewerName ?? labels.erasedReviewer,\n            date(review.reviewedAt),\n          )}\n        </Caption>\n      )}\n\n      {/* Read-only: what the reviewer said, as text — the fields are for saying it. */}\n      {!editable && review?.verdict === \"NEEDS_CHANGE\" && (review.suggestion || review.note) && (\n        <div className=\"space-y-2\">\n          {review.suggestion && (\n            <Then label={missing ? labels.translation : labels.suggestion} text={review.suggestion} />\n          )}\n          {review.note && <Then label={labels.note} text={review.note} />}\n        </div>\n      )}\n\n      {editable && (\n        <>\n          <Textarea\n            ref={wordingRef}\n            // The panel's \"Needs a change\" swipe on an already open row finds it here (#416).\n            data-review-wording=\"\"\n            label={missing ? labels.translation : labels.suggestion}\n            lang={row.locale}\n            rows={Math.min(8, Math.max(2, Math.ceil(Math.max(row.text.length, row.reference.length) / 80)))}\n            value={suggestion}\n            disabled={busy !== null}\n            onChange={(e) => setSuggestion(e.target.value)}\n          />\n          <Textarea\n            label={labels.note}\n            rows={2}\n            value={note}\n            placeholder={labels.notePlaceholder}\n            disabled={busy !== null}\n            onChange={(e) => setNote(e.target.value)}\n          />\n          <div className=\"flex flex-wrap gap-2\">\n            {!missing && (\n              <Button\n                variant=\"default\"\n                commit={COMMIT_EXCEPT_BILLING}\n                pending={busy === \"approve\"}\n                disabled={busy !== null}\n                onClick={() => save(\"APPROVED\")}\n              >\n                {labels.approve}\n              </Button>\n            )}\n            <Button\n              variant={missing ? \"default\" : \"danger\"}\n              commit={COMMIT_EXCEPT_BILLING}\n              pending={busy === \"flag\"}\n              disabled={busy !== null || !canFlag}\n              onClick={() => save(\"NEEDS_CHANGE\")}\n            >\n              {missing ? labels.suggest : labels.flag}\n            </Button>\n            {review && onClear && (\n              <Button\n                variant=\"ghost\"\n                commit={COMMIT_EXCEPT_BILLING}\n                pending={busy === \"clear\"}\n                disabled={busy !== null}\n                onClick={() => void run(\"clear\", () => onClear({ locale: row.locale, key: row.key }))}\n              >\n                {labels.reset}\n              </Button>\n            )}\n            {onClose && (\n              <Button variant=\"ghost\" disabled={busy !== null} onClick={onClose}>\n                {labels.cancel}\n              </Button>\n            )}\n          </div>\n        </>\n      )}\n\n      {failure && (\n        <AlertBanner tone=\"danger\" size=\"sm\" role=\"alert\">\n          {failure}\n        </AlertBanner>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/translation-review-editor.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { useDayFormatter } from \"../lib/day-format\";\nimport { placeholderTokens, reviewWrite } from \"../lib/translation-review\";\nimport type {\n  TranslationReviewKey,\n  TranslationReviewWrite,\n  TranslationRow,\n  TranslationVerdict,\n} from \"../lib/translation-review\";\nimport { AlertBanner } from \"./alert-banner\";\nimport { Caption, SectionLabel } from \"./text\";\nimport { DEFAULT_TRANSLATION_REVIEW_LABELS } from \"./translation-review-labels\";\nimport type { TranslationReviewLabels } from \"./translation-review-labels\";\nimport { Button } from \"./button\";\nimport { Textarea } from \"./textarea\";\nimport { COMMIT_EXCEPT_BILLING } from \"./write-lock\";\n\n/** A callback may return a promise: resolve and the editor closes, reject and it stays\n *  open with the error. */\ntype MaybePromise = void | Promise<unknown>;\n\nexport interface TranslationReviewEditorProps {\n  row: TranslationRow;\n  /** The reference language's own name (\"English\", \"Deutsch\") — the app's choice of\n   *  reference, so the app's word for it. */\n  referenceLabel: ReactNode;\n  /** The reviewed language's own name (\"Français\"). */\n  localeLabel: ReactNode;\n  /** Store a verdict. Left out (or `readOnly`): the editor shows the row and its last\n   *  verdict, with no fields and no actions. */\n  onSave?: (write: TranslationReviewWrite) => MaybePromise;\n  /** Clear the verdict — back to unreviewed. Left out: no reset button. */\n  onClear?: (key: TranslationReviewKey) => MaybePromise;\n  /** The Cancel button — and called after a save or a reset resolves, so the panel\n   *  that opened the editor closes it. */\n  onClose?: () => void;\n  /** Look, do not touch: a locale the viewer may read but not review. */\n  readOnly?: boolean;\n  /**\n   * 0.25: put the cursor in the wording field when the editor opens, at the end of the\n   * text. The panel sets it when a phone card is swiped toward \"Needs a change\" (keksdose\n   * live #377): that swipe opens the editor to be written in, and a reviewer who has just\n   * said \"this is wrong\" should not have to find the field first. Not for an editor\n   * opened by a tap — that one may only be opened to read.\n   */\n  focusWording?: boolean;\n  /** How the verdict's date reads. Default (0.52): the `<UiKitProvider formatDate>` when\n   *  the app set one (its date preference; the day sits in a sentence, so no weekday), else\n   *  the kit's `formatDate`, medium, in the provider's locale and `timeZone`. An empty\n   *  answer falls back to the kit's. */\n  formatDate?: (iso: string) => string;\n  /** Turns a rejection into words. Default {@link TranslationReviewLabels.failed}. */\n  formatError?: (error: unknown) => ReactNode;\n  className?: string;\n  labels?: LabelOverride<TranslationReviewLabels>;\n}\n\n/** The wording a verdict was given on, under the line that says it changed. */\nfunction Then({ label, text }: { label: string; text: string }) {\n  return (\n    <div className=\"mt-1.5 min-w-0\">\n      <span className=\"text-xs font-medium\">{label}</span>\n      <p className=\"whitespace-pre-line break-words text-secondary\">{text}</p>\n    </div>\n  );\n}\n\n/**\n * One string, opened: the reference beside the translation, what changed since the last\n * verdict, what a machine can see is wrong (the placeholders), and the two things a\n * reviewer can say about it — keksdose's and kastlan's `translation-review-editor.tsx`.\n *\n * \"Better wording\" opens on the CURRENT text rather than empty, because the usual\n * correction is a word or an ending, and retyping a sentence to change one word is how\n * new mistakes get in. It is sent only with \"Needs a change\" — approving says the text is\n * fine as it stands. A \"Needs a change\" with neither a note nor a different wording tells\n * whoever fixes it nothing, so it takes one of the two.\n *\n * A MISSING string (kastlan: the locale lacks the key) cannot be approved — there is\n * nothing to approve. Its field starts empty and is the translation to add; the verdict\n * is NEEDS_CHANGE on the empty text, which the export hands a developer as the string to\n * add.\n *\n * Every action waits for its callback: the buttons hold while the promise is out, a\n * resolution closes the editor through `onClose`, and a rejection keeps it open with what\n * was typed and the error under the buttons.\n *\n * Each verdict is a `commit` exempt from billing (`COMMIT_EXCEPT_BILLING`, 0.33): a review\n * is an admin route, which a lapsed plan never locks (docs/billing-harmonization.md\n * §12.13, §12.36); a demo's lock still holds it.\n */\nexport function TranslationReviewEditor({\n  row,\n  referenceLabel,\n  localeLabel,\n  onSave,\n  onClear,\n  onClose,\n  readOnly = false,\n  focusWording = false,\n  formatDate: formatDateProp,\n  formatError,\n  className,\n  labels: labelsProp,\n}: TranslationReviewEditorProps) {\n  const labels = useKitLabels(\"translationReview\", DEFAULT_TRANSLATION_REVIEW_LABELS, labelsProp);\n  const date = useDayFormatter(formatDateProp);\n  const review = row.review;\n  const missing = row.text === \"\";\n  const editable = !readOnly && onSave !== undefined;\n  const [suggestion, setSuggestion] = useState(review?.suggestion ?? row.text);\n  const [note, setNote] = useState(review?.note ?? \"\");\n  const [busy, setBusy] = useState<\"approve\" | \"flag\" | \"clear\" | null>(null);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const wordingRef = useRef<HTMLTextAreaElement>(null);\n  // On mount only: the prop says how the editor was OPENED, not where focus belongs\n  // for the rest of its life.\n  const focusOnOpen = useRef(focusWording && editable);\n  useEffect(() => {\n    const field = wordingRef.current;\n    if (!focusOnOpen.current || !field) return;\n    field.focus();\n    field.setSelectionRange(field.value.length, field.value.length);\n  }, []);\n\n  const canFlag = note.trim() !== \"\" || suggestion.trim() !== row.text.trim();\n  const changed = row.status === \"changed\" ? review : null;\n\n  const run = async (kind: \"approve\" | \"flag\" | \"clear\", action: () => MaybePromise) => {\n    setBusy(kind);\n    setFailure(null);\n    try {\n      await action();\n      onClose?.();\n    } catch (caught) {\n      setFailure(formatError ? formatError(caught) : labels.failed);\n    } finally {\n      setBusy(null);\n    }\n  };\n\n  const save = (verdict: TranslationVerdict) => {\n    if (!onSave) return;\n    const trimmedNote = note.trim() || null;\n    // Approving says the text is right as it stands: there is no wording to suggest.\n    const sent = verdict === \"APPROVED\" ? null : suggestion.trim() || null;\n    void run(verdict === \"APPROVED\" ? \"approve\" : \"flag\", () => onSave(reviewWrite(row, verdict, trimmedNote, sent)));\n  };\n\n  return (\n    <div className={cn(\"min-w-0 space-y-3 text-sm\", className)}>\n      <code className=\"block break-all text-xs text-muted\">{row.key}</code>\n\n      <div className=\"grid grid-cols-1 gap-3 md:grid-cols-2\">\n        <div className=\"min-w-0\">\n          <SectionLabel as=\"span\" size=\"xs\">\n            {referenceLabel}\n          </SectionLabel>\n          <p className=\"mt-1 whitespace-pre-line break-words text-secondary\">{row.reference}</p>\n        </div>\n        <div className=\"min-w-0\">\n          <SectionLabel as=\"span\" size=\"xs\">\n            {localeLabel}\n          </SectionLabel>\n          {missing ? (\n            <p className=\"mt-1 italic text-muted\">{labels.missingText}</p>\n          ) : (\n            <p lang={row.locale} className=\"mt-1 whitespace-pre-line break-words\">\n              {row.text}\n            </p>\n          )}\n        </div>\n      </div>\n\n      {changed && (\n        <AlertBanner tone=\"warning\" variant=\"inline\" size=\"sm\" block live={false}>\n          <div className=\"min-w-0\">\n            <p>{labels.changedSince}</p>\n            {changed.text !== row.text && <Then label={labels.reviewedWording} text={changed.text || \"—\"} />}\n            {changed.referenceText != null && changed.referenceText !== row.reference && (\n              <Then label={labels.reviewedReference} text={changed.referenceText} />\n            )}\n          </div>\n        </AlertBanner>\n      )}\n\n      {row.placeholderMismatch && (\n        <AlertBanner tone=\"danger\" variant=\"inline\" size=\"sm\" block live={false}>\n          <span className=\"min-w-0 break-words\">\n            {labels.placeholderMismatch(\n              placeholderTokens(row.reference).join(\" \") || \"—\",\n              placeholderTokens(row.text).join(\" \") || \"—\",\n            )}\n          </span>\n        </AlertBanner>\n      )}\n\n      {review && (\n        <Caption>\n          {(review.verdict === \"APPROVED\" ? labels.lastApproved : labels.lastFlagged)(\n            review.reviewerName ?? labels.erasedReviewer,\n            date(review.reviewedAt),\n          )}\n        </Caption>\n      )}\n\n      {/* Read-only: what the reviewer said, as text — the fields are for saying it. */}\n      {!editable && review?.verdict === \"NEEDS_CHANGE\" && (review.suggestion || review.note) && (\n        <div className=\"space-y-2\">\n          {review.suggestion && (\n            <Then label={missing ? labels.translation : labels.suggestion} text={review.suggestion} />\n          )}\n          {review.note && <Then label={labels.note} text={review.note} />}\n        </div>\n      )}\n\n      {editable && (\n        <>\n          <Textarea\n            ref={wordingRef}\n            // The panel's \"Needs a change\" swipe on an already open row finds it here (#416).\n            data-review-wording=\"\"\n            label={missing ? labels.translation : labels.suggestion}\n            lang={row.locale}\n            rows={Math.min(8, Math.max(2, Math.ceil(Math.max(row.text.length, row.reference.length) / 80)))}\n            value={suggestion}\n            disabled={busy !== null}\n            onChange={(e) => setSuggestion(e.target.value)}\n          />\n          <Textarea\n            label={labels.note}\n            rows={2}\n            value={note}\n            placeholder={labels.notePlaceholder}\n            disabled={busy !== null}\n            onChange={(e) => setNote(e.target.value)}\n          />\n          <div className=\"flex flex-wrap gap-2\">\n            {!missing && (\n              <Button\n                variant=\"default\"\n                commit={COMMIT_EXCEPT_BILLING}\n                pending={busy === \"approve\"}\n                disabled={busy !== null}\n                onClick={() => save(\"APPROVED\")}\n              >\n                {labels.approve}\n              </Button>\n            )}\n            <Button\n              variant={missing ? \"default\" : \"danger\"}\n              commit={COMMIT_EXCEPT_BILLING}\n              pending={busy === \"flag\"}\n              disabled={busy !== null || !canFlag}\n              onClick={() => save(\"NEEDS_CHANGE\")}\n            >\n              {missing ? labels.suggest : labels.flag}\n            </Button>\n            {review && onClear && (\n              <Button\n                variant=\"ghost\"\n                commit={COMMIT_EXCEPT_BILLING}\n                pending={busy === \"clear\"}\n                disabled={busy !== null}\n                onClick={() => void run(\"clear\", () => onClear({ locale: row.locale, key: row.key }))}\n              >\n                {labels.reset}\n              </Button>\n            )}\n            {onClose && (\n              <Button variant=\"ghost\" disabled={busy !== null} onClick={onClose}>\n                {labels.cancel}\n              </Button>\n            )}\n          </div>\n        </>\n      )}\n\n      {failure && (\n        <AlertBanner tone=\"danger\" size=\"sm\" role=\"alert\">\n          {failure}\n        </AlertBanner>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}

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

@@ -115,7 +115,8 @@ export interface TranslationReviewPanelProps {
      * kit's, which an app listing what it stores had to list as its own (KS U4).
      */
     storageKeyPrefix?: string;
-    /** How a verdict's date reads in the editor. */
+    /** How a verdict's date reads in the editor. Default: the editor's — the
+     *  `<UiKitProvider formatDate>`, else the kit's medium date (0.52). */
     formatDate?: (iso: string) => string;
     /** Turns a callback's rejection into words. Default {@link TranslationReviewLabels.failed}. */
     formatError?: (error: unknown) => ReactNode;

package/dist/components/translation-review.js

@@ -184,8 +184,8 @@ function TranslationReviewPanel({
   const mismatches = useMemo(() => rows.filter((r) => r.placeholderMismatch).length, [rows]);
   const { status, query, placeholdersOnly } = filter;
   const visible = useMemo(
-    () => filterTranslationRows(rows, { status, source, namespace, query, placeholdersOnly }),
-    [rows, status, source, namespace, query, placeholdersOnly]
+    () => filterTranslationRows(rows, { status, source, namespace, query, placeholdersOnly }, locale),
+    [rows, status, source, namespace, query, placeholdersOnly, locale]
   );
   const groups = useMemo(() => {
     if (groupBy === void 0) return null;