@eifi1/ui-kit 0.54.0 → 0.55.0

package/dist/components/toggle-group.js

@@ -13,6 +13,7 @@ import {
   FIELD_CAPTION_CLASS,
   FIELD_ERROR_CLASS,
   fieldHelpMark,
+  isSuggestionHint,
   isTextHint,
   LabelStrip,
   useDisabledReasonLine,
@@ -68,8 +69,8 @@ function ToggleGroup(props) {
   const reasonLine = useDisabledReasonLine(disabledReasonDisplay) && locked;
   const helpMark = fieldHelpMark(hasContent(label) ? help : void 0, label);
   const withHelp = helpMark !== void 0;
-  const inlineHint = useInlineHint(hint, withHelp);
-  const hintAsCaption = withHelp ? hasContent(inlineHint) ? inlineHint : void 0 : isTextHint(hint) ? hint : inlineHint !== hint ? inlineHint : void 0;
+  const inlineHint = useInlineHint(hint, withHelp, label);
+  const hintAsCaption = withHelp ? hasContent(inlineHint) ? inlineHint : void 0 : isTextHint(hint) ? hint : isSuggestionHint(hint) || inlineHint !== hint ? inlineHint : void 0;
   const labelHint = helpMark ?? (hintAsCaption === void 0 ? hint : void 0);
   const dimmed = disabled || locked;
   const labelled = hasContent(label);

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/toggle-group.tsx"],"sourcesContent":["import { useCallback, useId } from \"react\";\nimport type { ComponentPropsWithoutRef, KeyboardEvent, ReactElement, ReactNode, Ref } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { horizontalStep } from \"../lib/direction\";\nimport { FIELD_INVALID, FloatingField, Label } from \"./field-base\";\nimport { Tooltip } from \"./tooltip\";\nimport { useCommitReason, type CommitScope } from \"./write-lock\";\nimport { hasContent } from \"../lib/presence\";\nimport {\n  assignRef,\n  DISABLED_REASON_LINE_CLASS,\n  FIELD_CAPTION_CLASS,\n  FIELD_ERROR_CLASS,\n  fieldHelpMark,\n  isTextHint,\n  LabelStrip,\n  useDisabledReasonLine,\n  useInlineHint,\n  type DisabledReasonDisplay,\n  type FieldHelpProps,\n} from \"./field-parts\";\nimport { FOCUS_RING_WIDTH } from \"./focus-ring\";\n\nexport interface ToggleOption<T extends string> {\n  value: T;\n  label: string;\n  className?: string;\n}\n\n/**\n * `onChange` is the group's own — the chosen VALUE, not a DOM event — so the div's\n * `onChange` is omitted rather than shadowed: leaving both in scope would give the\n * prop two incompatible meanings depending on which overload TypeScript picked.\n *\n * `children` is omitted too: this renders its `options` and nothing else, so a `children` the type\n * accepted and the component ignored would be a prop that silently does nothing —\n * worse than one that does not compile.\n */\nexport interface ToggleGroupBaseProps<T extends string>\n  extends Omit<ComponentPropsWithoutRef<\"div\">, \"onChange\" | \"children\">, FieldHelpProps {\n  options: ToggleOption<T>[];\n  className?: string;\n  /** Applied to every option button (e.g. to tune height/rounding to match\n   *  adjacent fields). Per-option `className` still wins over this. */\n  optionClassName?: string;\n  /**\n   * What happens when the options do not fit the group's width. `\"truncate\"`\n   * (default): one row, and the labels that do not fit end in an ellipsis — the height\n   * never changes. `\"wrap\"`: the segments flow onto a second row and every label stays\n   * whole (\"Bewegung\", not \"Beweg…\"), at the price of a taller group on a narrow\n   * screen (lenkbank L4: five signal types on a 390px control page). From the width\n   * where they fit, both look the same.\n   *\n   * Since 0.32 a group in the field chrome (`label`, the default placement) with four or\n   * more options wraps at Large and Extra large under `\"truncate\"` too, inside its frame:\n   * the type is bigger there and the field would otherwise run past a phone's edge\n   * (docs/text-size-harmonization.md §4). The keyboard is the same either way.\n   */\n  overflow?: \"truncate\" | \"wrap\";\n  /**\n   * Show, refuse the change (Keksdose live #288: a payment dated in the future has no\n   * state to set).\n   *\n   * Whatever `value` says stays pressed and keeps its own fill rather than going grey\n   * with the rest — a reader who cannot see WHICH option is chosen has been told less\n   * than before it was disabled. A caller with nothing to show passes no value, and\n   * the group renders dimmed with nothing pressed, which is the shape Keksdose's\n   * status picker uses for a row whose status does not exist yet.\n   *\n   * On the whole GROUP, not per option: a segmented control where some segments are\n   * live and others are not is a menu with holes in it, and no caller here wants one.\n   */\n  disabled?: boolean;\n  /**\n   * `sm`: 12px options with `px-2 py-1` — the compact group keksdose's rule editor\n   * (rule-editor:204) writes as `optionClassName=\"px-2 py-1 text-xs\"` beside a small\n   * caption. `md` (default) is the size every other group has.\n   *\n   * Honoured inside the field chrome and the strip too (keksdose K1): the 12px type\n   * stays, and the field is still 42px — see `CHROME_PAD`.\n   */\n  size?: \"sm\" | \"md\";\n  /**\n   * Stand in a form row as a FIELD: with a label the group wears the field's chrome —\n   * border, surface, the top strip with a small static label in it, a labelled\n   * {@link Select}'s height — so beside an Input or a Select it reads as one of them\n   * rather than as a control with a caption over it. lenkbank builds exactly this by\n   * hand as `ToggleField` (features/gear/common.tsx:97, feedback #69), and its notes\n   * are why the chrome STRETCHES to its row as well as matching the select's padding:\n   * a native select's height is the browser's, so a toggle a few pixels short of it\n   * is levelled up by the row rather than by arithmetic.\n   *\n   * The label names the group (`aria-labelledby`), so `aria-label` is not needed. With\n   * a label, `className` styles the field's wrapper — as on {@link Select} — and the\n   * group's own box is dropped: two nested borders read as a control in a control.\n   */\n  label?: ReactNode;\n  /**\n   * Where `label` goes. `\"field\"` (default): the field chrome described under `label`.\n   * `\"above\"`: the kit's {@link Label} over the bare group — the shape of a {@link Field}\n   * — with `hint` beside the label and `error` under the group, for a form that sets\n   * its labels above its fields (kastlan's international-rent-calculator.tsx, whose DE\n   * cap pair sits in a `Field` column between two labelled-above inputs, where the\n   * chrome's inner label would be the only one of its kind).\n   *\n   * `\"strip\"`: the 11px static label (and `hint`) in a strip OVER the bare group, for a\n   * group that stands in a row of fields but is not one (keksdose K2 — the transaction\n   * row's cleared-status picker, live #288 / #431 / dev#468). No field border: the group\n   * keeps its own box, and its segments drop their vertical padding and set a 16px line,\n   * so the 20px strip plus the 22px group is exactly a labelled {@link Input}'s 42px,\n   * the label on the same line as theirs and clear of the group's border (keksdose\n   * dev#593 — see `STRIP_SEGMENT`). `error` and `caption` go under the group, as in the\n   * other two.\n   *\n   * Inside a `Field`, pass no `label` at all and spread the render-prop instead —\n   * `{(ids, { labelId }) => <ToggleGroup {...ids} aria-labelledby={labelId} … />}` —\n   * so the Field's label names the group and its hint and error describe it.\n   */\n  labelPlacement?: \"field\" | \"above\" | \"strip\";\n  /**\n   * Classes for the field chrome's own box — the bordered, padded box round the\n   * segments — merged last, so they win. `className` styles the wrapper the chrome sits\n   * in; this reaches the box itself. Only with `label` in the `\"field\"` placement.\n   *\n   * For a field JOINED flush to a neighbour (keksdose K1): reports-filters.tsx joins its\n   * \"group by\" field to the range select on its start edge from `md` up, and squares the\n   * shared corners by hand chrome today — here that is\n   * `chromeClassName=\"md:rounded-s-none\"` with `className=\"md:-ms-px\"` (the wrapper\n   * overlaps the neighbour by the one border they share). A class rather than a\n   * `joined=\"start\"` because every such join keksdose has is responsive: on a phone the\n   * two stack and both keep their corners.\n   */\n  chromeClassName?: string;\n  /**\n   * As on a labelled {@link Select}: a {@link FieldHint} \"?\" on the label line, and plain\n   * text (a string) as a caption under the group. Only with `label`.\n   *\n   * 0.32.1 (keksdose's 0.32 report): text went on the label line in every placement, so\n   * `TextSizeSetting`'s hint with `labelPlacement=\"above\"` sat beside the label in body\n   * type, and at Extra large became a column one word wide — on the setting a reader who\n   * needs large text opens first. The label line holds the \"?\" only (`isTextHint`).\n   */\n  hint?: ReactNode;\n  /** The message under the field when it is wrong: paints the field's border with\n   *  `--danger`, marks the group `aria-invalid` and describes it with the message, as\n   *  {@link Select}'s `error` does. Only with `label`. */\n  error?: ReactNode;\n  /**\n   * Why the group cannot be changed right now — {@link Button}'s `disabledReason`, for\n   * a group that saves itself on change (keksdose K3: the last `SaveGuard` sites are\n   * self-committing controls like this one, and SaveGuard's native `disabled` took\n   * them out of the tab order so the reason never reached a keyboard).\n   *\n   * The group stays reachable — its segments are `aria-disabled`, not `disabled`, and\n   * a radio group's arrow keys still walk them — but nothing reaches `onChange`, and\n   * the reason shows in the kit {@link Tooltip} over the segments on hover or focus and\n   * describes each segment. The chosen option keeps its fill, as under `disabled`.\n   * Wins over `disabled`, as on Button: passing both keeps the group reachable.\n   */\n  disabledReason?: ReactNode;\n  /**\n   * Where `disabledReason` shows (0.32, §4 \"No fact only in a tooltip\"): by default, at\n   * Large and on a touch screen, as a line under the group (where its caption goes), and\n   * in the tooltip over the segments otherwise. See {@link DisabledReasonDisplay}.\n   */\n  disabledReasonDisplay?: DisabledReasonDisplay;\n  /**\n   * This group COMMITS — choosing an option saves it. Under a locked\n   * {@link WriteLockProvider} it takes the `disabledReason` path with the lock's\n   * reason (which wins over a `disabledReason` of its own): *\"everything renders; only\n   * the commit is locked\"* (keksdose dev#496/#497), and a control that is its own commit\n   * must render refused, never live-and-discarding. No provider, or an unlocked one:\n   * no effect.\n   */\n  commit?: CommitScope;\n  /**\n   * The group — the `radiogroup` (or the pressed shape's `group`) the rest of the props go\n   * on — as a React 19 ref prop (0.34, API-3, refactor audit 2026-10). The group itself\n   * takes no focus, so its `focus()` lands where a keyboard would: the radio shape's one\n   * tab stop (the checked option, else the first), or in the pressed shape the pressed\n   * button, else the first. That is react-hook-form's focus-on-error, which /rhf's\n   * adapter reached by an id lookup carrying this same rule until now.\n   */\n  ref?: Ref<HTMLDivElement>;\n}\n\n/**\n * The field chrome's vertical geometry — keksdose K1, the kit reintroducing feedback\n * #117 that keksdose's hand-built chrome had fixed.\n *\n * In px at Normal, as measured; since 0.32 every term but the two borders is rem\n * (§3.2), so the sum stays a labelled Select's at 125 and 150 % too — the Select's own\n * `pt-4 pb-1` and 1.25rem line grow by the same factor (52 px at Large, 62 at Extra\n * large). The md line was `leading-[18px]` and is `leading-[1.125rem]`.\n *\n * The label is the field's static label: `top-1` and 11px in a `leading-tight` line, so\n * its line box runs from 4px to 17.75px. Until 0.22 the chrome was `pt-4` over a 20px\n * (`leading-5`) segment, so the ACTIVE segment's fill — painted from the top of the\n * segment — started at 17px (1px border + 16px), 0.75px INSIDE the label's line box:\n * the highlight touched the word above it, exactly what #117's rework had measured and\n * cured with `pt-5`.\n *\n * Now the strip is `pt-5` and the fill starts at 21px, 3.25px clear, and the segment\n * gives the 4px back so the field stays a labelled Select's 42px: `md` sets its 14px\n * text in an 18px line with a 2px moat under it (the bare group's own `p-0.5` moat),\n * `sm` sets 12px text in a 16px line over `pb-1` — keksdose's measured chrome\n * (price-level-picker, reports-filters: `pt-5 pb-1`, `text-xs md:py-0`), byte for byte.\n * Before, `size=\"sm\"` inside the chrome was overridden to the md 20px line.\n *\n *     md: 1 + 20 + 18 + 2 + 1 = 42        sm: 1 + 20 + 16 + 4 + 1 = 42\n */\n// At Large the chrome's label stands above it (0.33, §10.17): no strip, the same moat top\n// and bottom.\nconst CHROME_PAD: Record<\"sm\" | \"md\", string> = { md: \"pt-5 pb-0.5 large:pt-0.5\", sm: \"pt-5 pb-1 large:pt-1\" };\nconst CHROME_SEGMENT: Record<\"sm\" | \"md\", string> = { md: \"py-0 leading-[1.125rem]\", sm: \"py-0 leading-4\" };\n\n/**\n * A group at Large and Extra large (0.32,\n * docs/text-size-harmonization.md §4 \"nothing truncates\", §3.3): the segments flow onto a\n * second row inside the group's frame instead of overflowing it. At 125 % a 390 px phone\n * is 312 px of Normal type, and \"Month / Quarter / Half-year / Year\" in one row of the\n * field ran 7 px past it: a one-row flex group is as wide as all its labels end to end\n * when a grid or a stretched column asks how small it can get, however its segments\n * truncate. Wrapped, it is as wide as its longest label.\n *\n * Wrap, not a stacked select-like list: a wrapped radio group is the same radio group —\n * one Tab stop, and the arrow keys walk the options in reading order whichever row\n * they are on (←/↑ back, →/↓ on, Home/End) — so nothing about the keyboard changes with\n * the text size. A list in its place would be a second widget with its own keys.\n *\n * Only where it has to: `flex-wrap` breaks a row only when the segments do not fit, so\n * a wide field at Large stays one row, and a segment shares out what its row leaves\n * (`flex-1`); a label wider than the whole row still truncates as the last resort.\n * A `large:` class, so it costs no render and is right on the first paint.\n * `overflow=\"wrap\"` wraps at every size already.\n *\n * 0.32.1 (Kurvenschmiede's 0.32 report): every count and every placement, not only a\n * field of four or more. Since a row breaks only where its labels do not fit, a wrap\n * only ever replaces a truncation — and three options in a card at Extra large on a\n * 360 px phone read \"Syst… Li… D…\".\n *\n * 0.34 (round 0.34 T1, text size §10.17): the strip too, which 0.32.1 kept to one row so\n * its 26 px group lined up with the 42 px fields beside it (`STRIP_SEGMENT`). The size\n * sweep read \"Op…\" in its segments at 360 px / Extra large — the same \"Syst… Li… D…\" —\n * and a row of fields that grows to a taller cell (keksdose's status strip sits in an\n * `items-start` grid) is the smaller loss. At Normal, and wherever it fits, it is the\n * one row it was.\n */\nconst WRAP_AT_LARGE = \"large:flex-wrap\";\n\n/**\n * The strip placement's segments (keksdose dev#593, kk K4): a 22px group under the 20px\n * strip, which is a labelled Input's 42px at Normal —\n *\n *     strip 20 + group (1 + 2 + 16 + 2 + 1) 22 = 42 = Input (1 + 16 + 20 + 4 + 1)\n *\n * — both sizes setting their text in a 16px line with no padding (`md`'s 14px, `sm`'s\n * 12px). Until 0.34 the strip was 16px over a 26px group (a 20px line), and the label\n * row, which ends 18px down, crossed the group's top border by 2px; see\n * `LABEL_STRIP_PAD` in field-parts.tsx for the label row's sum. keksdose had the same\n * fix locally: `pt-5` and `@3xl:leading-4`.\n *\n * At Large and Extra large the label stands above the group and there is no strip to\n * share out, so the segments keep the line they had: `md` its text-sm line\n * (`large:leading-5` — a label that wraps there, WRAP_AT_LARGE, needs it), `sm` its 2px\n * either side.\n */\nconst STRIP_SEGMENT: Record<\"sm\" | \"md\", string> = {\n  md: \"py-0 leading-4 large:leading-5\",\n  sm: \"py-0 leading-4 large:py-0.5\",\n};\n\n/**\n * The strip placement's group is BLOCK-level (keksdose dev#593). Drawn `inline-flex`, it\n * sat on a line box of the strip's own line height, and a 22px box on a taller line\n * gained a pixel of leading above and below — 44px, not 42. Block-level, the group is\n * exactly its box. keksdose wrote it as `[&>[role=radiogroup]]:flex` on the strip.\n */\nconst STRIP_GROUP = \"flex\";\n\n/**\n * Where the group's `focus()` lands (see {@link ToggleGroupBaseProps.ref}): the radio\n * shape's one tab stop, or the pressed shape's pressed button — else the first option a\n * keyboard can reach. The rule /rhf's ToggleGroup adapter applied by id until 0.34.\n */\nfunction groupFocusTarget(group: HTMLElement): HTMLElement | null {\n  return (\n    group.querySelector<HTMLElement>('button[tabindex=\"0\"], button[aria-pressed=\"true\"]') ??\n    group.querySelector<HTMLElement>(\"button:not(:disabled)\")\n  );\n}\n\n/**\n * A line under the group saying what the CHOSEN option means — lenkbank's ToggleField\n * `hint` (features/gear/common.tsx:97): not help behind a \"?\" but a caption, and one\n * that changes as the choice does. Pass a function of the value for that; it is\n * attached with `aria-describedby`, and a function caption is also a polite live\n * region, because a description is read when the group is entered and not again when\n * an arrow key changes the choice underneath it.\n *\n * In muted caption-size text under the field (or the bare group), above an `error`.\n */\ntype ToggleGroupCaption<V> = ReactNode | ((value: V) => ReactNode);\n\n/** The group as it has always been: one option is always the answer. */\nexport interface ToggleGroupRequiredProps<T extends string> extends ToggleGroupBaseProps<T> {\n  allowEmpty?: false;\n  /**\n   * What the options ARE to a screen reader, separately from whether the group can be\n   * emptied (kastlan feedback #47).\n   *\n   *  - `\"radio\"` (default) — a `radiogroup` of radios: one Tab stop, arrow keys MOVE the\n   *    choice. Right for a choice between answers (\"Monthly / Yearly\").\n   *  - `\"pressed\"` — a `group` of toggle buttons (`aria-pressed`), each its own Tab stop,\n   *    Space/Enter to press; still one option always pressed. Right for a row that reads\n   *    as a set of switches — a view mode, a toolbar-like filter — where arrows moving the\n   *    selection on focus would be a surprise.\n   *\n   * Before this the only way to `aria-pressed` was `allowEmpty`, which also let a second\n   * press clear the choice — so kastlan took the clearable shape and threw the `null`\n   * away in `onChange` (`(v) => v && setMode(v)`), a group announcing that a press would\n   * unpress what it would not. Here a press on the pressed option re-sends its value, as\n   * the radio shape does, and nothing is ever unpressed. A clearable group\n   * (`allowEmpty`) is always `\"pressed\"`: a radio cannot be unchecked by activating it.\n   */\n  semantics?: \"radio\" | \"pressed\";\n  value: T;\n  onChange: (value: T) => void;\n  /** See {@link ToggleGroupCaption}. */\n  caption?: ToggleGroupCaption<T>;\n}\n\n/**\n * A group that can be emptied: clicking the active option clears it, and `onChange`\n * receives `null` (Keksdose's support-panel filters, where \"no filter\" is reached by\n * clicking the filter that is on).\n *\n * The options become TOGGLE BUTTONS (`aria-pressed`, in a `role=\"group\"`) rather than\n * radios. A radio cannot be unchecked by activating it — no screen reader user expects\n * a second press on \"Open, radio, checked\" to leave nothing checked, and nothing would\n * tell them it had. \"Open, toggle button, pressed\" says exactly what a press will do.\n */\nexport interface ToggleGroupClearableProps<T extends string> extends ToggleGroupBaseProps<T> {\n  allowEmpty: true;\n  /** Always toggle buttons — see {@link ToggleGroupRequiredProps.semantics}. Accepted so\n   *  a wrapper can forward one `semantics` to either shape. */\n  semantics?: \"pressed\";\n  value: T | null;\n  onChange: (value: T | null) => void;\n  /** See {@link ToggleGroupCaption}. `null` while nothing is chosen. */\n  caption?: ToggleGroupCaption<T | null>;\n}\n\n/** `allowEmpty` picks the shape, so `onChange` is typed `(T) => void` unless the group\n *  can actually emit `null` — no existing caller has a `null` to handle. */\nexport type ToggleGroupProps<T extends string> = ToggleGroupRequiredProps<T> | ToggleGroupClearableProps<T>;\n\n/**\n * Overloaded rather than typed by the union alone (keksdose, \"Gaps found adopting\n * 0.6.0\" #7). Inferring `T` through a union of prop shapes let TypeScript settle on\n * `string`, so `<ToggleGroup allowEmpty value={filter} onChange={setFilter} />` over a\n * `useState<Status | null>` did not compile unless the caller spelled\n * `<ToggleGroup<Status>>`. One signature per mode lets each infer `T` from its own\n * `value`/`onChange`/`options`; the third keeps a caller that forwards a\n * {@link ToggleGroupProps} union (a wrapper component) compiling.\n */\nexport function ToggleGroup<T extends string>(props: ToggleGroupClearableProps<T>): ReactElement;\nexport function ToggleGroup<T extends string>(props: ToggleGroupRequiredProps<T>): ReactElement;\nexport function ToggleGroup<T extends string>(props: ToggleGroupProps<T>): ReactElement;\nexport function ToggleGroup<T extends string>(props: ToggleGroupProps<T>): ReactElement {\n  const {\n    value,\n    options,\n    className,\n    optionClassName,\n    overflow = \"truncate\",\n    disabled = false,\n    size = \"md\",\n    label,\n    labelPlacement = \"field\",\n    chromeClassName,\n    hint,\n    help,\n    error,\n    disabledReason: ownDisabledReason,\n    disabledReasonDisplay,\n    commit,\n    \"aria-label\": ariaLabelAttr,\n    ref,\n    ...restWithMode\n  } = props;\n  const labelId = useId();\n  const errorId = useId();\n  const reasonId = useId();\n  const hintCaptionId = useId();\n  // The group's `focus()` is a no-op on a div with no tabindex; the caller's ref gets one\n  // that lands where the keyboard would (see `ref`).\n  const setGroup = useCallback(\n    (el: HTMLDivElement | null) => {\n      if (el) el.focus = (options?: FocusOptions) => groupFocusTarget(el)?.focus(options);\n      assignRef(ref, el);\n    },\n    [ref],\n  );\n  // The lock's reason under a locked provider (with `commit`), else the group's own.\n  const disabledReason = useCommitReason(commit, ownDisabledReason);\n  const locked = hasContent(disabledReason);\n  // §4: at Large and on touch the reason is a line under the group, not a bubble.\n  const reasonLine = useDisabledReasonLine(disabledReasonDisplay) && locked;\n  // §4: likewise a FieldHint \"?\" on the label line becomes a caption under the group at\n  // Large and on touch; text is a caption at every size, as Select's (see `hint`). With\n  // a `help` (0.36, only with `label`, as `hint`), its \"?\" is the label line's only one,\n  // and the hint — a FieldHint's words included — is the caption at every size.\n  const helpMark = fieldHelpMark(hasContent(label) ? help : undefined, label);\n  const withHelp = helpMark !== undefined;\n  const inlineHint = useInlineHint(hint, withHelp);\n  const hintAsCaption = withHelp\n    ? hasContent(inlineHint)\n      ? inlineHint\n      : undefined\n    : isTextHint(hint)\n      ? hint\n      : inlineHint !== hint\n        ? inlineHint\n        : undefined;\n  const labelHint = helpMark ?? (hintAsCaption === undefined ? hint : undefined);\n  // Locked looks disabled — the dimmed group, the not-allowed cursor, no hover offer —\n  // but stays focusable; `disabled` alone also takes the segments out of the tab order.\n  const dimmed = disabled || locked;\n  const labelled = hasContent(label);\n  // `field` is the chrome; a label placed above or in a strip keeps the bare group's\n  // own box.\n  const field = labelled && labelPlacement === \"field\";\n  const above = labelled && labelPlacement === \"above\";\n  const strip = labelled && labelPlacement === \"strip\";\n  // At Large and Extra large a truncating group wraps instead, the strip too since 0.34\n  // (see WRAP_AT_LARGE).\n  const wrapAtLarge = overflow === \"truncate\";\n  const hasError = labelled && hasContent(error);\n  // Taken off the rest so neither reaches the DOM; `props` keeps them paired, which is\n  // what lets the `onChange` below be called with `null` only in the mode that allows it.\n  const { allowEmpty: _allowEmpty, onChange: _onChange, caption, semantics: _semantics, ...rest } = restWithMode;\n  // Invalid from outside too: a `Field` hands the bare group `aria-invalid`, and the\n  // border has to say what the attribute says.\n  const outsideInvalid = rest[\"aria-invalid\"] === true || rest[\"aria-invalid\"] === \"true\";\n  const captionId = useId();\n  const captionIsLive = typeof caption === \"function\";\n  const captionNode = captionIsLive ? (caption as (v: T | null) => ReactNode)(value) : caption;\n  const hasCaption = hasContent(captionNode);\n  const choose = (next: T) => {\n    // A locked group swallows the change: it saves on change, and a lock that let the\n    // value move and then discarded it would show a state that was never stored.\n    if (locked) return;\n    if (props.allowEmpty) props.onChange(next === value ? null : next);\n    else props.onChange(next);\n  };\n  // `pressed`: toggle buttons. Every clearable group is; a required one is when it asks\n  // (kastlan #47) — the role, and not whether a second press clears, is what this flag\n  // decides from here on, so `choose` above still keys off `allowEmpty` alone.\n  const pressed = props.allowEmpty === true || props.semantics === \"pressed\";\n  // A radio group is ONE tab stop (the checked radio, else the first) and arrows move\n  // the choice — the pattern `role=\"radiogroup\"` promises a screen-reader user. Before\n  // 0.7.0 each segment was its own tab stop with no arrow keys. The toggle-button shape\n  // is a row of buttons, where separate tab stops are the pattern.\n  const tabStop = options.some((o) => o.value === value) ? value : options[0]?.value;\n  const onRadioKey = (e: KeyboardEvent<HTMLButtonElement>, index: number) => {\n    const last = options.length - 1;\n    let next: number | null = null;\n    const step = horizontalStep(e.key, e.currentTarget);\n    if (step !== 0) next = index + step;\n    else if (e.key === \"ArrowDown\") next = index + 1;\n    else if (e.key === \"ArrowUp\") next = index - 1;\n    else if (e.key === \"Home\") next = 0;\n    else if (e.key === \"End\") next = last;\n    if (next === null) return;\n    e.preventDefault();\n    next = next < 0 ? last : next > last ? 0 : next;\n    // The segments' own parent: the group, or under a lock the tooltip's row inside it.\n    const buttons = e.currentTarget.parentElement?.querySelectorAll<HTMLButtonElement>(\":scope > button\");\n    buttons?.[next]?.focus();\n    // Locked: the focus walks (each segment says why on arrival), the choice does not.\n    choose(options[next].value);\n  };\n  const segments = options.map((opt, index) => {\n    const active = opt.value === value;\n    return (\n      <button\n        key={opt.value}\n        type=\"button\"\n        role={pressed ? undefined : \"radio\"}\n        aria-checked={pressed ? undefined : active}\n        aria-pressed={pressed ? active : undefined}\n        // A reason wins over `disabled` (as on Button): reachable, and refusing.\n        disabled={disabled && !locked}\n        aria-disabled={locked || undefined}\n        // On each segment rather than the group: the segment is what takes focus, and\n        // a group's description is not read reliably when focus lands inside it.\n        aria-describedby={locked ? reasonId : undefined}\n        tabIndex={pressed ? undefined : opt.value === tabStop ? 0 : -1}\n        onKeyDown={pressed ? undefined : (e) => onRadioKey(e, index)}\n        onClick={() => choose(opt.value)}\n        className={cn(\n          // `truncate` (which carries whitespace-nowrap) rather than letting a\n          // label wrap: a segmented control sizes its whole row to the tallest\n          // option, so one two-word option — Keksdose feedback #147's \"Where I\n          // am\" — silently doubles the height of every segment beside it.\n          //\n          // `basis-auto` is what keeps that ellipsis a LAST resort rather than\n          // the normal state (Keksdose dev#475). With flex-1's `basis-0`, a\n          // shrink-to-fit group (`w-auto`) still resolves to the sum of the\n          // labels' widths — and then splits it EQUALLY, so the short option\n          // got 66px it did not need and \"Where I am\" got 66 of the 81 it did:\n          // truncated at 1778px of free screen. Basing each segment on its own\n          // content and sharing only the LEFTOVER space keeps a full-width\n          // group's segments near-equal and an auto-width group's exact.\n          //\n          // `focus-visible` + `ring-inset`, not `focus` + an outset ring. A ring\n          // is a box-shadow that spreads OUTWARD, so on a flush group it painted\n          // 2px of ring over both neighbours and over the container's own border\n          // — and on a phone it appeared on every TAP, because a tap focuses the\n          // button. That is the other half of what live #268's rework saw\n          // overlaying the selected segment's boundary. Inset keeps the ring\n          // inside the segment it belongs to; focus-visible keeps it for the\n          // keyboard, which is the only input that needs it.\n          //\n          // The ring is the kit's focus frame (0.32, §5): `--focus-ring-width` wide.\n          //\n          // From Large up the group wraps its ROW first (WRAP_AT_LARGE), so a segment's\n          // own text breaks only when one label is wider than a whole row — and then it\n          // wraps rather than ending in an ellipsis (`truncate-until-large`, text size\n          // §10.17; round 0.34 T1: the sweep read 'confirmVariant=\"da…' at 360 px).\n          overflow === \"wrap\" ? \"whitespace-nowrap\" : \"min-w-0 truncate-until-large\",\n          \"flex-1 basis-auto rounded px-3 py-1.5 text-sm font-medium transition-colors focus:outline-none focus-visible:ring-inset focus-visible:ring-strong\",\n          FOCUS_RING_WIDTH,\n          size === \"sm\" && \"px-2 py-1 text-xs\",\n          // In the field chrome: no vertical padding, and the line that makes the\n          // field 42px under a strip that clears the label — see CHROME_PAD. `sm`\n          // keeps its 12px type here (it used to be overridden to the md line).\n          field && CHROME_SEGMENT[size],\n          // In the strip placement: a 22px group under a 20px strip — STRIP_SEGMENT.\n          strip && STRIP_SEGMENT[size],\n          active ? \"bg-inverse text-inverse\" : \"text-secondary hover:bg-hover\",\n          // No hover fill on a group that cannot be changed — a segment that\n          // lights up under the pointer is an offer, and there is none here. Not on\n          // the chosen segment: its fill IS its state, and its inverse text would\n          // vanish on a transparent hover.\n          dimmed && \"cursor-not-allowed\",\n          dimmed && !active && \"hover:bg-transparent dark:hover:bg-transparent\",\n          optionClassName,\n          opt.className,\n        )}\n      >\n        {opt.label}\n      </button>\n    );\n  });\n  const group = (\n    <div\n      // The audit's named example of a closed prop list (§\"Public API design\"): the\n      // tour locates a step by CSS SELECTOR, so a component that drops every attribute\n      // it was not expecting cannot be spotlighted at all — and Keksdose's rule editor\n      // carries a comment explaining that it wraps this group in a bare <div> for\n      // exactly that reason.\n      //\n      // `...rest` first, then the attributes the group cannot do without: a caller\n      // hanging an anchor or a test id on the group must not be able to overwrite the\n      // radiogroup role or the disabled state by accident. `className` is destructured\n      // out entirely and merged through `cn`, so it is never in here.\n      {...rest}\n      ref={setGroup}\n      role={pressed ? \"group\" : \"radiogroup\"}\n      aria-label={ariaLabelAttr}\n      aria-labelledby={labelled && ariaLabelAttr === undefined ? labelId : rest[\"aria-labelledby\"]}\n      aria-invalid={hasError || rest[\"aria-invalid\"] || undefined}\n      aria-describedby={\n        [\n          rest[\"aria-describedby\"],\n          hintAsCaption !== undefined && hintCaptionId,\n          hasCaption && captionId,\n          hasError && errorId,\n        ]\n          .filter(Boolean)\n          .join(\" \") || undefined\n      }\n      // `aria-disabled` on the group as well as on (or `disabled` on) each button: a\n      // radio group is what the user is being refused, and a screen reader announcing\n      // three separately-disabled radios does not say that.\n      aria-disabled={dimmed || undefined}\n      className={cn(\n        // `gap-0.5` — the same 2px as the container's own padding, so EVERY segment\n        // sits in a uniform 2px moat and no two fills ever touch. Flush segments were\n        // Keksdose live #268's rework: the pressed segment wears a saturated fill and\n        // an unpressed neighbour wears a pale hover fill, and with a shared edge the\n        // two rectangles read as one smeared shape — *\"the boundary of the selected\n        // option and hovering next to it overlays the boundary of the selected\n        // button\"*. A gap is what makes each segment its own chip; it cannot be\n        // undone by a caller's per-option colour, which a hover-only fix could.\n        //\n        // (The hover fill is the DESKTOP half of that report: Tailwind v4 wraps every\n        // `hover:` in `@media (hover: hover)`, so a phone never paints it. The half a\n        // phone does see is the focus ring — see the segment's own note below.)\n        \"inline-flex w-full gap-0.5 rounded-md border border-strong bg-surface p-0.5 shadow-sm\",\n        // Block-level under the strip, so it adds no line box's leading — STRIP_GROUP.\n        strip && STRIP_GROUP,\n        overflow === \"wrap\" && \"flex-wrap\",\n        wrapAtLarge && WRAP_AT_LARGE,\n        // The whole group fades, the way every other disabled control in this\n        // package does; `cursor-not-allowed` is on the buttons, which is what a\n        // pointer is actually over.\n        dimmed && \"opacity-60\",\n        // The bare group (no chrome to paint) wears the invalid border itself.\n        !field && (outsideInvalid || ((above || strip) && hasError)) && FIELD_INVALID,\n        // Inside the field's chrome the group is only a row of segments: no border, no\n        // surface, no padding of its own, and the field (not the group) is what dims.\n        field && \"border-0 bg-transparent p-0 shadow-none opacity-100\",\n        !labelled && className,\n      )}\n    >\n      {locked && !reasonLine ? (\n        // The reason's bubble wraps the SEGMENTS, inside the group, not the group: a\n        // wrapper outside it would become the flex or grid item in the caller's row in\n        // the group's place, and a `w-full` / `md:w-auto` on the group would size the\n        // wrong box. This row inherits the group's gap and wrap, so the segments lay out\n        // exactly as they do unlocked, and `:scope > button` above still finds them. A\n        // fragment child, so the Tooltip describes nothing itself — each segment points\n        // at the hidden copy, the way a locked Button does.\n        <Tooltip label={disabledReason} className=\"flex min-w-0 flex-1 gap-[inherit] [flex-wrap:inherit]\">\n          <>\n            {segments}\n            <span id={reasonId} hidden>\n              {disabledReason}\n            </span>\n          </>\n        </Tooltip>\n      ) : (\n        segments\n      )}\n    </div>\n  );\n  // Rendered whenever the caption is — `aria-live` must be on the element BEFORE its\n  // text changes, or the change is not announced — but empty (no height, no margin)\n  // when there is nothing to say, so a function caption that returns null for some\n  // options leaves no gap. Empty rather than `hidden`: some readers do not announce\n  // text that appears inside an element coming back from `display: none`.\n  const captionEl =\n    hasCaption || captionIsLive ? (\n      <p\n        id={captionId}\n        aria-live={captionIsLive ? \"polite\" : undefined}\n        className={cn(\"text-caption leading-snug text-muted\", hasCaption && \"mt-1\")}\n      >\n        {hasCaption ? captionNode : null}\n      </p>\n    ) : null;\n  const errorEl = hasError ? (\n    <p id={errorId} className={FIELD_ERROR_CLASS}>\n      {error}\n    </p>\n  ) : null;\n  // §4: the FieldHint's words and the lock's reason, under the group, before the caption\n  // (standing advice first) and the error (the news). The reason line IS what each\n  // segment's `aria-describedby` names.\n  const belowEl =\n    hintAsCaption !== undefined || reasonLine ? (\n      <>\n        {hintAsCaption !== undefined && (\n          <p id={hintCaptionId} className={FIELD_CAPTION_CLASS}>\n            {hintAsCaption}\n          </p>\n        )}\n        {reasonLine && (\n          <p id={reasonId} className={DISABLED_REASON_LINE_CLASS}>\n            {disabledReason}\n          </p>\n        )}\n      </>\n    ) : null;\n  if (above) {\n    // `relative` so a caller's `sr-only` label cannot escape (sr-only-containment).\n    return (\n      <div className={cn(\"relative grid min-w-0 gap-1.5\", className)}>\n        <div className=\"flex items-center gap-1\">\n          {/* A `<label>` with no `htmlFor`: a group is not labelable, so it is named\n              by `aria-labelledby` on the group; the element keeps the Field look. */}\n          <Label\n            id={labelId}\n            disabled={dimmed}\n            data-error={hasError || undefined}\n            className=\"data-[error=true]:text-danger\"\n          >\n            {label}\n          </Label>\n          {labelHint}\n        </div>\n        <div className=\"min-w-0\">\n          {group}\n          {belowEl}\n          {captionEl}\n          {errorEl}\n        </div>\n      </div>\n    );\n  }\n  if (strip) {\n    return (\n      <LabelStrip labelId={labelId} label={label} hint={labelHint} disabled={dimmed} className={className}>\n        {group}\n        {belowEl}\n        {captionEl}\n        {errorEl}\n      </LabelStrip>\n    );\n  }\n  if (!field) {\n    if (!captionEl && !belowEl) return group;\n    // The group keeps its `className`, as without a caption; the wrapper only stacks.\n    return (\n      <div className=\"min-w-0\">\n        {group}\n        {belowEl}\n        {captionEl}\n      </div>\n    );\n  }\n  return (\n    // `h-full` + `flex-1`: the chrome fills a grid or stretched flex row, which is what\n    // levels it with a select beside it whatever the browser makes of the select.\n    <div className={cn(\"flex h-full flex-col\", className)}>\n      <FloatingField\n        className=\"flex flex-1 flex-col\"\n        label={<span id={labelId}>{label}</span>}\n        staticLabel\n        hint={labelHint}\n      >\n        <div\n          className={cn(\n            \"flex flex-1 flex-col justify-center rounded-md border border-subtle bg-surface px-1 shadow-sm\",\n            CHROME_PAD[size],\n            dimmed && \"bg-surface-2 opacity-60\",\n            hasError && FIELD_INVALID,\n            chromeClassName,\n          )}\n        >\n          {group}\n        </div>\n      </FloatingField>\n      {belowEl}\n      {captionEl}\n      {errorEl}\n    </div>\n  );\n}\n"],"mappings":"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","names":["options"]}
+{"version":3,"sources":["../../src/components/toggle-group.tsx"],"sourcesContent":["import { useCallback, useId } from \"react\";\nimport type { ComponentPropsWithoutRef, KeyboardEvent, ReactElement, ReactNode, Ref } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { horizontalStep } from \"../lib/direction\";\nimport { FIELD_INVALID, FloatingField, Label } from \"./field-base\";\nimport { Tooltip } from \"./tooltip\";\nimport { useCommitReason, type CommitScope } from \"./write-lock\";\nimport { hasContent } from \"../lib/presence\";\nimport {\n  assignRef,\n  DISABLED_REASON_LINE_CLASS,\n  FIELD_CAPTION_CLASS,\n  FIELD_ERROR_CLASS,\n  fieldHelpMark,\n  isSuggestionHint,\n  isTextHint,\n  LabelStrip,\n  useDisabledReasonLine,\n  useInlineHint,\n  type DisabledReasonDisplay,\n  type FieldHelpProps,\n} from \"./field-parts\";\nimport { FOCUS_RING_WIDTH } from \"./focus-ring\";\n\nexport interface ToggleOption<T extends string> {\n  value: T;\n  label: string;\n  className?: string;\n}\n\n/**\n * `onChange` is the group's own — the chosen VALUE, not a DOM event — so the div's\n * `onChange` is omitted rather than shadowed: leaving both in scope would give the\n * prop two incompatible meanings depending on which overload TypeScript picked.\n *\n * `children` is omitted too: this renders its `options` and nothing else, so a `children` the type\n * accepted and the component ignored would be a prop that silently does nothing —\n * worse than one that does not compile.\n */\nexport interface ToggleGroupBaseProps<T extends string>\n  extends Omit<ComponentPropsWithoutRef<\"div\">, \"onChange\" | \"children\">, FieldHelpProps {\n  options: ToggleOption<T>[];\n  className?: string;\n  /** Applied to every option button (e.g. to tune height/rounding to match\n   *  adjacent fields). Per-option `className` still wins over this. */\n  optionClassName?: string;\n  /**\n   * What happens when the options do not fit the group's width. `\"truncate\"`\n   * (default): one row, and the labels that do not fit end in an ellipsis — the height\n   * never changes. `\"wrap\"`: the segments flow onto a second row and every label stays\n   * whole (\"Bewegung\", not \"Beweg…\"), at the price of a taller group on a narrow\n   * screen (lenkbank L4: five signal types on a 390px control page). From the width\n   * where they fit, both look the same.\n   *\n   * Since 0.32 a group in the field chrome (`label`, the default placement) with four or\n   * more options wraps at Large and Extra large under `\"truncate\"` too, inside its frame:\n   * the type is bigger there and the field would otherwise run past a phone's edge\n   * (docs/text-size-harmonization.md §4). The keyboard is the same either way.\n   */\n  overflow?: \"truncate\" | \"wrap\";\n  /**\n   * Show, refuse the change (Keksdose live #288: a payment dated in the future has no\n   * state to set).\n   *\n   * Whatever `value` says stays pressed and keeps its own fill rather than going grey\n   * with the rest — a reader who cannot see WHICH option is chosen has been told less\n   * than before it was disabled. A caller with nothing to show passes no value, and\n   * the group renders dimmed with nothing pressed, which is the shape Keksdose's\n   * status picker uses for a row whose status does not exist yet.\n   *\n   * On the whole GROUP, not per option: a segmented control where some segments are\n   * live and others are not is a menu with holes in it, and no caller here wants one.\n   */\n  disabled?: boolean;\n  /**\n   * `sm`: 12px options with `px-2 py-1` — the compact group keksdose's rule editor\n   * (rule-editor:204) writes as `optionClassName=\"px-2 py-1 text-xs\"` beside a small\n   * caption. `md` (default) is the size every other group has.\n   *\n   * Honoured inside the field chrome and the strip too (keksdose K1): the 12px type\n   * stays, and the field is still 42px — see `CHROME_PAD`.\n   */\n  size?: \"sm\" | \"md\";\n  /**\n   * Stand in a form row as a FIELD: with a label the group wears the field's chrome —\n   * border, surface, the top strip with a small static label in it, a labelled\n   * {@link Select}'s height — so beside an Input or a Select it reads as one of them\n   * rather than as a control with a caption over it. lenkbank builds exactly this by\n   * hand as `ToggleField` (features/gear/common.tsx:97, feedback #69), and its notes\n   * are why the chrome STRETCHES to its row as well as matching the select's padding:\n   * a native select's height is the browser's, so a toggle a few pixels short of it\n   * is levelled up by the row rather than by arithmetic.\n   *\n   * The label names the group (`aria-labelledby`), so `aria-label` is not needed. With\n   * a label, `className` styles the field's wrapper — as on {@link Select} — and the\n   * group's own box is dropped: two nested borders read as a control in a control.\n   */\n  label?: ReactNode;\n  /**\n   * Where `label` goes. `\"field\"` (default): the field chrome described under `label`.\n   * `\"above\"`: the kit's {@link Label} over the bare group — the shape of a {@link Field}\n   * — with `hint` beside the label and `error` under the group, for a form that sets\n   * its labels above its fields (kastlan's international-rent-calculator.tsx, whose DE\n   * cap pair sits in a `Field` column between two labelled-above inputs, where the\n   * chrome's inner label would be the only one of its kind).\n   *\n   * `\"strip\"`: the 11px static label (and `hint`) in a strip OVER the bare group, for a\n   * group that stands in a row of fields but is not one (keksdose K2 — the transaction\n   * row's cleared-status picker, live #288 / #431 / dev#468). No field border: the group\n   * keeps its own box, and its segments drop their vertical padding and set a 16px line,\n   * so the 20px strip plus the 22px group is exactly a labelled {@link Input}'s 42px,\n   * the label on the same line as theirs and clear of the group's border (keksdose\n   * dev#593 — see `STRIP_SEGMENT`). `error` and `caption` go under the group, as in the\n   * other two.\n   *\n   * Inside a `Field`, pass no `label` at all and spread the render-prop instead —\n   * `{(ids, { labelId }) => <ToggleGroup {...ids} aria-labelledby={labelId} … />}` —\n   * so the Field's label names the group and its hint and error describe it.\n   */\n  labelPlacement?: \"field\" | \"above\" | \"strip\";\n  /**\n   * Classes for the field chrome's own box — the bordered, padded box round the\n   * segments — merged last, so they win. `className` styles the wrapper the chrome sits\n   * in; this reaches the box itself. Only with `label` in the `\"field\"` placement.\n   *\n   * For a field JOINED flush to a neighbour (keksdose K1): reports-filters.tsx joins its\n   * \"group by\" field to the range select on its start edge from `md` up, and squares the\n   * shared corners by hand chrome today — here that is\n   * `chromeClassName=\"md:rounded-s-none\"` with `className=\"md:-ms-px\"` (the wrapper\n   * overlaps the neighbour by the one border they share). A class rather than a\n   * `joined=\"start\"` because every such join keksdose has is responsive: on a phone the\n   * two stack and both keep their corners.\n   */\n  chromeClassName?: string;\n  /**\n   * As on a labelled {@link Select}: a {@link FieldHint} \"?\" on the label line, and plain\n   * text (a string) as a caption under the group. Only with `label`.\n   *\n   * 0.32.1 (keksdose's 0.32 report): text went on the label line in every placement, so\n   * `TextSizeSetting`'s hint with `labelPlacement=\"above\"` sat beside the label in body\n   * type, and at Extra large became a column one word wide — on the setting a reader who\n   * needs large text opens first. The label line holds the \"?\" only (`isTextHint`).\n   */\n  hint?: ReactNode;\n  /** The message under the field when it is wrong: paints the field's border with\n   *  `--danger`, marks the group `aria-invalid` and describes it with the message, as\n   *  {@link Select}'s `error` does. Only with `label`. */\n  error?: ReactNode;\n  /**\n   * Why the group cannot be changed right now — {@link Button}'s `disabledReason`, for\n   * a group that saves itself on change (keksdose K3: the last `SaveGuard` sites are\n   * self-committing controls like this one, and SaveGuard's native `disabled` took\n   * them out of the tab order so the reason never reached a keyboard).\n   *\n   * The group stays reachable — its segments are `aria-disabled`, not `disabled`, and\n   * a radio group's arrow keys still walk them — but nothing reaches `onChange`, and\n   * the reason shows in the kit {@link Tooltip} over the segments on hover or focus and\n   * describes each segment. The chosen option keeps its fill, as under `disabled`.\n   * Wins over `disabled`, as on Button: passing both keeps the group reachable.\n   */\n  disabledReason?: ReactNode;\n  /**\n   * Where `disabledReason` shows (0.32, §4 \"No fact only in a tooltip\"): by default, at\n   * Large and on a touch screen, as a line under the group (where its caption goes), and\n   * in the tooltip over the segments otherwise. See {@link DisabledReasonDisplay}.\n   */\n  disabledReasonDisplay?: DisabledReasonDisplay;\n  /**\n   * This group COMMITS — choosing an option saves it. Under a locked\n   * {@link WriteLockProvider} it takes the `disabledReason` path with the lock's\n   * reason (which wins over a `disabledReason` of its own): *\"everything renders; only\n   * the commit is locked\"* (keksdose dev#496/#497), and a control that is its own commit\n   * must render refused, never live-and-discarding. No provider, or an unlocked one:\n   * no effect.\n   */\n  commit?: CommitScope;\n  /**\n   * The group — the `radiogroup` (or the pressed shape's `group`) the rest of the props go\n   * on — as a React 19 ref prop (0.34, API-3, refactor audit 2026-10). The group itself\n   * takes no focus, so its `focus()` lands where a keyboard would: the radio shape's one\n   * tab stop (the checked option, else the first), or in the pressed shape the pressed\n   * button, else the first. That is react-hook-form's focus-on-error, which /rhf's\n   * adapter reached by an id lookup carrying this same rule until now.\n   */\n  ref?: Ref<HTMLDivElement>;\n}\n\n/**\n * The field chrome's vertical geometry — keksdose K1, the kit reintroducing feedback\n * #117 that keksdose's hand-built chrome had fixed.\n *\n * In px at Normal, as measured; since 0.32 every term but the two borders is rem\n * (§3.2), so the sum stays a labelled Select's at 125 and 150 % too — the Select's own\n * `pt-4 pb-1` and 1.25rem line grow by the same factor (52 px at Large, 62 at Extra\n * large). The md line was `leading-[18px]` and is `leading-[1.125rem]`.\n *\n * The label is the field's static label: `top-1` and 11px in a `leading-tight` line, so\n * its line box runs from 4px to 17.75px. Until 0.22 the chrome was `pt-4` over a 20px\n * (`leading-5`) segment, so the ACTIVE segment's fill — painted from the top of the\n * segment — started at 17px (1px border + 16px), 0.75px INSIDE the label's line box:\n * the highlight touched the word above it, exactly what #117's rework had measured and\n * cured with `pt-5`.\n *\n * Now the strip is `pt-5` and the fill starts at 21px, 3.25px clear, and the segment\n * gives the 4px back so the field stays a labelled Select's 42px: `md` sets its 14px\n * text in an 18px line with a 2px moat under it (the bare group's own `p-0.5` moat),\n * `sm` sets 12px text in a 16px line over `pb-1` — keksdose's measured chrome\n * (price-level-picker, reports-filters: `pt-5 pb-1`, `text-xs md:py-0`), byte for byte.\n * Before, `size=\"sm\"` inside the chrome was overridden to the md 20px line.\n *\n *     md: 1 + 20 + 18 + 2 + 1 = 42        sm: 1 + 20 + 16 + 4 + 1 = 42\n */\n// At Large the chrome's label stands above it (0.33, §10.17): no strip, the same moat top\n// and bottom.\nconst CHROME_PAD: Record<\"sm\" | \"md\", string> = { md: \"pt-5 pb-0.5 large:pt-0.5\", sm: \"pt-5 pb-1 large:pt-1\" };\nconst CHROME_SEGMENT: Record<\"sm\" | \"md\", string> = { md: \"py-0 leading-[1.125rem]\", sm: \"py-0 leading-4\" };\n\n/**\n * A group at Large and Extra large (0.32,\n * docs/text-size-harmonization.md §4 \"nothing truncates\", §3.3): the segments flow onto a\n * second row inside the group's frame instead of overflowing it. At 125 % a 390 px phone\n * is 312 px of Normal type, and \"Month / Quarter / Half-year / Year\" in one row of the\n * field ran 7 px past it: a one-row flex group is as wide as all its labels end to end\n * when a grid or a stretched column asks how small it can get, however its segments\n * truncate. Wrapped, it is as wide as its longest label.\n *\n * Wrap, not a stacked select-like list: a wrapped radio group is the same radio group —\n * one Tab stop, and the arrow keys walk the options in reading order whichever row\n * they are on (←/↑ back, →/↓ on, Home/End) — so nothing about the keyboard changes with\n * the text size. A list in its place would be a second widget with its own keys.\n *\n * Only where it has to: `flex-wrap` breaks a row only when the segments do not fit, so\n * a wide field at Large stays one row, and a segment shares out what its row leaves\n * (`flex-1`); a label wider than the whole row still truncates as the last resort.\n * A `large:` class, so it costs no render and is right on the first paint.\n * `overflow=\"wrap\"` wraps at every size already.\n *\n * 0.32.1 (Kurvenschmiede's 0.32 report): every count and every placement, not only a\n * field of four or more. Since a row breaks only where its labels do not fit, a wrap\n * only ever replaces a truncation — and three options in a card at Extra large on a\n * 360 px phone read \"Syst… Li… D…\".\n *\n * 0.34 (round 0.34 T1, text size §10.17): the strip too, which 0.32.1 kept to one row so\n * its 26 px group lined up with the 42 px fields beside it (`STRIP_SEGMENT`). The size\n * sweep read \"Op…\" in its segments at 360 px / Extra large — the same \"Syst… Li… D…\" —\n * and a row of fields that grows to a taller cell (keksdose's status strip sits in an\n * `items-start` grid) is the smaller loss. At Normal, and wherever it fits, it is the\n * one row it was.\n */\nconst WRAP_AT_LARGE = \"large:flex-wrap\";\n\n/**\n * The strip placement's segments (keksdose dev#593, kk K4): a 22px group under the 20px\n * strip, which is a labelled Input's 42px at Normal —\n *\n *     strip 20 + group (1 + 2 + 16 + 2 + 1) 22 = 42 = Input (1 + 16 + 20 + 4 + 1)\n *\n * — both sizes setting their text in a 16px line with no padding (`md`'s 14px, `sm`'s\n * 12px). Until 0.34 the strip was 16px over a 26px group (a 20px line), and the label\n * row, which ends 18px down, crossed the group's top border by 2px; see\n * `LABEL_STRIP_PAD` in field-parts.tsx for the label row's sum. keksdose had the same\n * fix locally: `pt-5` and `@3xl:leading-4`.\n *\n * At Large and Extra large the label stands above the group and there is no strip to\n * share out, so the segments keep the line they had: `md` its text-sm line\n * (`large:leading-5` — a label that wraps there, WRAP_AT_LARGE, needs it), `sm` its 2px\n * either side.\n */\nconst STRIP_SEGMENT: Record<\"sm\" | \"md\", string> = {\n  md: \"py-0 leading-4 large:leading-5\",\n  sm: \"py-0 leading-4 large:py-0.5\",\n};\n\n/**\n * The strip placement's group is BLOCK-level (keksdose dev#593). Drawn `inline-flex`, it\n * sat on a line box of the strip's own line height, and a 22px box on a taller line\n * gained a pixel of leading above and below — 44px, not 42. Block-level, the group is\n * exactly its box. keksdose wrote it as `[&>[role=radiogroup]]:flex` on the strip.\n */\nconst STRIP_GROUP = \"flex\";\n\n/**\n * Where the group's `focus()` lands (see {@link ToggleGroupBaseProps.ref}): the radio\n * shape's one tab stop, or the pressed shape's pressed button — else the first option a\n * keyboard can reach. The rule /rhf's ToggleGroup adapter applied by id until 0.34.\n */\nfunction groupFocusTarget(group: HTMLElement): HTMLElement | null {\n  return (\n    group.querySelector<HTMLElement>('button[tabindex=\"0\"], button[aria-pressed=\"true\"]') ??\n    group.querySelector<HTMLElement>(\"button:not(:disabled)\")\n  );\n}\n\n/**\n * A line under the group saying what the CHOSEN option means — lenkbank's ToggleField\n * `hint` (features/gear/common.tsx:97): not help behind a \"?\" but a caption, and one\n * that changes as the choice does. Pass a function of the value for that; it is\n * attached with `aria-describedby`, and a function caption is also a polite live\n * region, because a description is read when the group is entered and not again when\n * an arrow key changes the choice underneath it.\n *\n * In muted caption-size text under the field (or the bare group), above an `error`.\n */\ntype ToggleGroupCaption<V> = ReactNode | ((value: V) => ReactNode);\n\n/** The group as it has always been: one option is always the answer. */\nexport interface ToggleGroupRequiredProps<T extends string> extends ToggleGroupBaseProps<T> {\n  allowEmpty?: false;\n  /**\n   * What the options ARE to a screen reader, separately from whether the group can be\n   * emptied (kastlan feedback #47).\n   *\n   *  - `\"radio\"` (default) — a `radiogroup` of radios: one Tab stop, arrow keys MOVE the\n   *    choice. Right for a choice between answers (\"Monthly / Yearly\").\n   *  - `\"pressed\"` — a `group` of toggle buttons (`aria-pressed`), each its own Tab stop,\n   *    Space/Enter to press; still one option always pressed. Right for a row that reads\n   *    as a set of switches — a view mode, a toolbar-like filter — where arrows moving the\n   *    selection on focus would be a surprise.\n   *\n   * Before this the only way to `aria-pressed` was `allowEmpty`, which also let a second\n   * press clear the choice — so kastlan took the clearable shape and threw the `null`\n   * away in `onChange` (`(v) => v && setMode(v)`), a group announcing that a press would\n   * unpress what it would not. Here a press on the pressed option re-sends its value, as\n   * the radio shape does, and nothing is ever unpressed. A clearable group\n   * (`allowEmpty`) is always `\"pressed\"`: a radio cannot be unchecked by activating it.\n   */\n  semantics?: \"radio\" | \"pressed\";\n  value: T;\n  onChange: (value: T) => void;\n  /** See {@link ToggleGroupCaption}. */\n  caption?: ToggleGroupCaption<T>;\n}\n\n/**\n * A group that can be emptied: clicking the active option clears it, and `onChange`\n * receives `null` (Keksdose's support-panel filters, where \"no filter\" is reached by\n * clicking the filter that is on).\n *\n * The options become TOGGLE BUTTONS (`aria-pressed`, in a `role=\"group\"`) rather than\n * radios. A radio cannot be unchecked by activating it — no screen reader user expects\n * a second press on \"Open, radio, checked\" to leave nothing checked, and nothing would\n * tell them it had. \"Open, toggle button, pressed\" says exactly what a press will do.\n */\nexport interface ToggleGroupClearableProps<T extends string> extends ToggleGroupBaseProps<T> {\n  allowEmpty: true;\n  /** Always toggle buttons — see {@link ToggleGroupRequiredProps.semantics}. Accepted so\n   *  a wrapper can forward one `semantics` to either shape. */\n  semantics?: \"pressed\";\n  value: T | null;\n  onChange: (value: T | null) => void;\n  /** See {@link ToggleGroupCaption}. `null` while nothing is chosen. */\n  caption?: ToggleGroupCaption<T | null>;\n}\n\n/** `allowEmpty` picks the shape, so `onChange` is typed `(T) => void` unless the group\n *  can actually emit `null` — no existing caller has a `null` to handle. */\nexport type ToggleGroupProps<T extends string> = ToggleGroupRequiredProps<T> | ToggleGroupClearableProps<T>;\n\n/**\n * Overloaded rather than typed by the union alone (keksdose, \"Gaps found adopting\n * 0.6.0\" #7). Inferring `T` through a union of prop shapes let TypeScript settle on\n * `string`, so `<ToggleGroup allowEmpty value={filter} onChange={setFilter} />` over a\n * `useState<Status | null>` did not compile unless the caller spelled\n * `<ToggleGroup<Status>>`. One signature per mode lets each infer `T` from its own\n * `value`/`onChange`/`options`; the third keeps a caller that forwards a\n * {@link ToggleGroupProps} union (a wrapper component) compiling.\n */\nexport function ToggleGroup<T extends string>(props: ToggleGroupClearableProps<T>): ReactElement;\nexport function ToggleGroup<T extends string>(props: ToggleGroupRequiredProps<T>): ReactElement;\nexport function ToggleGroup<T extends string>(props: ToggleGroupProps<T>): ReactElement;\nexport function ToggleGroup<T extends string>(props: ToggleGroupProps<T>): ReactElement {\n  const {\n    value,\n    options,\n    className,\n    optionClassName,\n    overflow = \"truncate\",\n    disabled = false,\n    size = \"md\",\n    label,\n    labelPlacement = \"field\",\n    chromeClassName,\n    hint,\n    help,\n    error,\n    disabledReason: ownDisabledReason,\n    disabledReasonDisplay,\n    commit,\n    \"aria-label\": ariaLabelAttr,\n    ref,\n    ...restWithMode\n  } = props;\n  const labelId = useId();\n  const errorId = useId();\n  const reasonId = useId();\n  const hintCaptionId = useId();\n  // The group's `focus()` is a no-op on a div with no tabindex; the caller's ref gets one\n  // that lands where the keyboard would (see `ref`).\n  const setGroup = useCallback(\n    (el: HTMLDivElement | null) => {\n      if (el) el.focus = (options?: FocusOptions) => groupFocusTarget(el)?.focus(options);\n      assignRef(ref, el);\n    },\n    [ref],\n  );\n  // The lock's reason under a locked provider (with `commit`), else the group's own.\n  const disabledReason = useCommitReason(commit, ownDisabledReason);\n  const locked = hasContent(disabledReason);\n  // §4: at Large and on touch the reason is a line under the group, not a bubble.\n  const reasonLine = useDisabledReasonLine(disabledReasonDisplay) && locked;\n  // §4: likewise a FieldHint \"?\" on the label line becomes a caption under the group at\n  // Large and on touch; text is a caption at every size, as Select's (see `hint`). With\n  // a `help` (0.36, only with `label`, as `hint`), its \"?\" is the label line's only one,\n  // and the hint — a FieldHint's words included — is the caption at every size.\n  const helpMark = fieldHelpMark(hasContent(label) ? help : undefined, label);\n  const withHelp = helpMark !== undefined;\n  const inlineHint = useInlineHint(hint, withHelp, label);\n  // A FieldSuggestion (0.55) is a caption at every size, as text is.\n  const hintAsCaption = withHelp\n    ? hasContent(inlineHint)\n      ? inlineHint\n      : undefined\n    : isTextHint(hint)\n      ? hint\n      : isSuggestionHint(hint) || inlineHint !== hint\n        ? inlineHint\n        : undefined;\n  const labelHint = helpMark ?? (hintAsCaption === undefined ? hint : undefined);\n  // Locked looks disabled — the dimmed group, the not-allowed cursor, no hover offer —\n  // but stays focusable; `disabled` alone also takes the segments out of the tab order.\n  const dimmed = disabled || locked;\n  const labelled = hasContent(label);\n  // `field` is the chrome; a label placed above or in a strip keeps the bare group's\n  // own box.\n  const field = labelled && labelPlacement === \"field\";\n  const above = labelled && labelPlacement === \"above\";\n  const strip = labelled && labelPlacement === \"strip\";\n  // At Large and Extra large a truncating group wraps instead, the strip too since 0.34\n  // (see WRAP_AT_LARGE).\n  const wrapAtLarge = overflow === \"truncate\";\n  const hasError = labelled && hasContent(error);\n  // Taken off the rest so neither reaches the DOM; `props` keeps them paired, which is\n  // what lets the `onChange` below be called with `null` only in the mode that allows it.\n  const { allowEmpty: _allowEmpty, onChange: _onChange, caption, semantics: _semantics, ...rest } = restWithMode;\n  // Invalid from outside too: a `Field` hands the bare group `aria-invalid`, and the\n  // border has to say what the attribute says.\n  const outsideInvalid = rest[\"aria-invalid\"] === true || rest[\"aria-invalid\"] === \"true\";\n  const captionId = useId();\n  const captionIsLive = typeof caption === \"function\";\n  const captionNode = captionIsLive ? (caption as (v: T | null) => ReactNode)(value) : caption;\n  const hasCaption = hasContent(captionNode);\n  const choose = (next: T) => {\n    // A locked group swallows the change: it saves on change, and a lock that let the\n    // value move and then discarded it would show a state that was never stored.\n    if (locked) return;\n    if (props.allowEmpty) props.onChange(next === value ? null : next);\n    else props.onChange(next);\n  };\n  // `pressed`: toggle buttons. Every clearable group is; a required one is when it asks\n  // (kastlan #47) — the role, and not whether a second press clears, is what this flag\n  // decides from here on, so `choose` above still keys off `allowEmpty` alone.\n  const pressed = props.allowEmpty === true || props.semantics === \"pressed\";\n  // A radio group is ONE tab stop (the checked radio, else the first) and arrows move\n  // the choice — the pattern `role=\"radiogroup\"` promises a screen-reader user. Before\n  // 0.7.0 each segment was its own tab stop with no arrow keys. The toggle-button shape\n  // is a row of buttons, where separate tab stops are the pattern.\n  const tabStop = options.some((o) => o.value === value) ? value : options[0]?.value;\n  const onRadioKey = (e: KeyboardEvent<HTMLButtonElement>, index: number) => {\n    const last = options.length - 1;\n    let next: number | null = null;\n    const step = horizontalStep(e.key, e.currentTarget);\n    if (step !== 0) next = index + step;\n    else if (e.key === \"ArrowDown\") next = index + 1;\n    else if (e.key === \"ArrowUp\") next = index - 1;\n    else if (e.key === \"Home\") next = 0;\n    else if (e.key === \"End\") next = last;\n    if (next === null) return;\n    e.preventDefault();\n    next = next < 0 ? last : next > last ? 0 : next;\n    // The segments' own parent: the group, or under a lock the tooltip's row inside it.\n    const buttons = e.currentTarget.parentElement?.querySelectorAll<HTMLButtonElement>(\":scope > button\");\n    buttons?.[next]?.focus();\n    // Locked: the focus walks (each segment says why on arrival), the choice does not.\n    choose(options[next].value);\n  };\n  const segments = options.map((opt, index) => {\n    const active = opt.value === value;\n    return (\n      <button\n        key={opt.value}\n        type=\"button\"\n        role={pressed ? undefined : \"radio\"}\n        aria-checked={pressed ? undefined : active}\n        aria-pressed={pressed ? active : undefined}\n        // A reason wins over `disabled` (as on Button): reachable, and refusing.\n        disabled={disabled && !locked}\n        aria-disabled={locked || undefined}\n        // On each segment rather than the group: the segment is what takes focus, and\n        // a group's description is not read reliably when focus lands inside it.\n        aria-describedby={locked ? reasonId : undefined}\n        tabIndex={pressed ? undefined : opt.value === tabStop ? 0 : -1}\n        onKeyDown={pressed ? undefined : (e) => onRadioKey(e, index)}\n        onClick={() => choose(opt.value)}\n        className={cn(\n          // `truncate` (which carries whitespace-nowrap) rather than letting a\n          // label wrap: a segmented control sizes its whole row to the tallest\n          // option, so one two-word option — Keksdose feedback #147's \"Where I\n          // am\" — silently doubles the height of every segment beside it.\n          //\n          // `basis-auto` is what keeps that ellipsis a LAST resort rather than\n          // the normal state (Keksdose dev#475). With flex-1's `basis-0`, a\n          // shrink-to-fit group (`w-auto`) still resolves to the sum of the\n          // labels' widths — and then splits it EQUALLY, so the short option\n          // got 66px it did not need and \"Where I am\" got 66 of the 81 it did:\n          // truncated at 1778px of free screen. Basing each segment on its own\n          // content and sharing only the LEFTOVER space keeps a full-width\n          // group's segments near-equal and an auto-width group's exact.\n          //\n          // `focus-visible` + `ring-inset`, not `focus` + an outset ring. A ring\n          // is a box-shadow that spreads OUTWARD, so on a flush group it painted\n          // 2px of ring over both neighbours and over the container's own border\n          // — and on a phone it appeared on every TAP, because a tap focuses the\n          // button. That is the other half of what live #268's rework saw\n          // overlaying the selected segment's boundary. Inset keeps the ring\n          // inside the segment it belongs to; focus-visible keeps it for the\n          // keyboard, which is the only input that needs it.\n          //\n          // The ring is the kit's focus frame (0.32, §5): `--focus-ring-width` wide.\n          //\n          // From Large up the group wraps its ROW first (WRAP_AT_LARGE), so a segment's\n          // own text breaks only when one label is wider than a whole row — and then it\n          // wraps rather than ending in an ellipsis (`truncate-until-large`, text size\n          // §10.17; round 0.34 T1: the sweep read 'confirmVariant=\"da…' at 360 px).\n          overflow === \"wrap\" ? \"whitespace-nowrap\" : \"min-w-0 truncate-until-large\",\n          \"flex-1 basis-auto rounded px-3 py-1.5 text-sm font-medium transition-colors focus:outline-none focus-visible:ring-inset focus-visible:ring-strong\",\n          FOCUS_RING_WIDTH,\n          size === \"sm\" && \"px-2 py-1 text-xs\",\n          // In the field chrome: no vertical padding, and the line that makes the\n          // field 42px under a strip that clears the label — see CHROME_PAD. `sm`\n          // keeps its 12px type here (it used to be overridden to the md line).\n          field && CHROME_SEGMENT[size],\n          // In the strip placement: a 22px group under a 20px strip — STRIP_SEGMENT.\n          strip && STRIP_SEGMENT[size],\n          active ? \"bg-inverse text-inverse\" : \"text-secondary hover:bg-hover\",\n          // No hover fill on a group that cannot be changed — a segment that\n          // lights up under the pointer is an offer, and there is none here. Not on\n          // the chosen segment: its fill IS its state, and its inverse text would\n          // vanish on a transparent hover.\n          dimmed && \"cursor-not-allowed\",\n          dimmed && !active && \"hover:bg-transparent dark:hover:bg-transparent\",\n          optionClassName,\n          opt.className,\n        )}\n      >\n        {opt.label}\n      </button>\n    );\n  });\n  const group = (\n    <div\n      // The audit's named example of a closed prop list (§\"Public API design\"): the\n      // tour locates a step by CSS SELECTOR, so a component that drops every attribute\n      // it was not expecting cannot be spotlighted at all — and Keksdose's rule editor\n      // carries a comment explaining that it wraps this group in a bare <div> for\n      // exactly that reason.\n      //\n      // `...rest` first, then the attributes the group cannot do without: a caller\n      // hanging an anchor or a test id on the group must not be able to overwrite the\n      // radiogroup role or the disabled state by accident. `className` is destructured\n      // out entirely and merged through `cn`, so it is never in here.\n      {...rest}\n      ref={setGroup}\n      role={pressed ? \"group\" : \"radiogroup\"}\n      aria-label={ariaLabelAttr}\n      aria-labelledby={labelled && ariaLabelAttr === undefined ? labelId : rest[\"aria-labelledby\"]}\n      aria-invalid={hasError || rest[\"aria-invalid\"] || undefined}\n      aria-describedby={\n        [\n          rest[\"aria-describedby\"],\n          hintAsCaption !== undefined && hintCaptionId,\n          hasCaption && captionId,\n          hasError && errorId,\n        ]\n          .filter(Boolean)\n          .join(\" \") || undefined\n      }\n      // `aria-disabled` on the group as well as on (or `disabled` on) each button: a\n      // radio group is what the user is being refused, and a screen reader announcing\n      // three separately-disabled radios does not say that.\n      aria-disabled={dimmed || undefined}\n      className={cn(\n        // `gap-0.5` — the same 2px as the container's own padding, so EVERY segment\n        // sits in a uniform 2px moat and no two fills ever touch. Flush segments were\n        // Keksdose live #268's rework: the pressed segment wears a saturated fill and\n        // an unpressed neighbour wears a pale hover fill, and with a shared edge the\n        // two rectangles read as one smeared shape — *\"the boundary of the selected\n        // option and hovering next to it overlays the boundary of the selected\n        // button\"*. A gap is what makes each segment its own chip; it cannot be\n        // undone by a caller's per-option colour, which a hover-only fix could.\n        //\n        // (The hover fill is the DESKTOP half of that report: Tailwind v4 wraps every\n        // `hover:` in `@media (hover: hover)`, so a phone never paints it. The half a\n        // phone does see is the focus ring — see the segment's own note below.)\n        \"inline-flex w-full gap-0.5 rounded-md border border-strong bg-surface p-0.5 shadow-sm\",\n        // Block-level under the strip, so it adds no line box's leading — STRIP_GROUP.\n        strip && STRIP_GROUP,\n        overflow === \"wrap\" && \"flex-wrap\",\n        wrapAtLarge && WRAP_AT_LARGE,\n        // The whole group fades, the way every other disabled control in this\n        // package does; `cursor-not-allowed` is on the buttons, which is what a\n        // pointer is actually over.\n        dimmed && \"opacity-60\",\n        // The bare group (no chrome to paint) wears the invalid border itself.\n        !field && (outsideInvalid || ((above || strip) && hasError)) && FIELD_INVALID,\n        // Inside the field's chrome the group is only a row of segments: no border, no\n        // surface, no padding of its own, and the field (not the group) is what dims.\n        field && \"border-0 bg-transparent p-0 shadow-none opacity-100\",\n        !labelled && className,\n      )}\n    >\n      {locked && !reasonLine ? (\n        // The reason's bubble wraps the SEGMENTS, inside the group, not the group: a\n        // wrapper outside it would become the flex or grid item in the caller's row in\n        // the group's place, and a `w-full` / `md:w-auto` on the group would size the\n        // wrong box. This row inherits the group's gap and wrap, so the segments lay out\n        // exactly as they do unlocked, and `:scope > button` above still finds them. A\n        // fragment child, so the Tooltip describes nothing itself — each segment points\n        // at the hidden copy, the way a locked Button does.\n        <Tooltip label={disabledReason} className=\"flex min-w-0 flex-1 gap-[inherit] [flex-wrap:inherit]\">\n          <>\n            {segments}\n            <span id={reasonId} hidden>\n              {disabledReason}\n            </span>\n          </>\n        </Tooltip>\n      ) : (\n        segments\n      )}\n    </div>\n  );\n  // Rendered whenever the caption is — `aria-live` must be on the element BEFORE its\n  // text changes, or the change is not announced — but empty (no height, no margin)\n  // when there is nothing to say, so a function caption that returns null for some\n  // options leaves no gap. Empty rather than `hidden`: some readers do not announce\n  // text that appears inside an element coming back from `display: none`.\n  const captionEl =\n    hasCaption || captionIsLive ? (\n      <p\n        id={captionId}\n        aria-live={captionIsLive ? \"polite\" : undefined}\n        className={cn(\"text-caption leading-snug text-muted\", hasCaption && \"mt-1\")}\n      >\n        {hasCaption ? captionNode : null}\n      </p>\n    ) : null;\n  const errorEl = hasError ? (\n    <p id={errorId} className={FIELD_ERROR_CLASS}>\n      {error}\n    </p>\n  ) : null;\n  // §4: the FieldHint's words and the lock's reason, under the group, before the caption\n  // (standing advice first) and the error (the news). The reason line IS what each\n  // segment's `aria-describedby` names.\n  const belowEl =\n    hintAsCaption !== undefined || reasonLine ? (\n      <>\n        {hintAsCaption !== undefined && (\n          <p id={hintCaptionId} className={FIELD_CAPTION_CLASS}>\n            {hintAsCaption}\n          </p>\n        )}\n        {reasonLine && (\n          <p id={reasonId} className={DISABLED_REASON_LINE_CLASS}>\n            {disabledReason}\n          </p>\n        )}\n      </>\n    ) : null;\n  if (above) {\n    // `relative` so a caller's `sr-only` label cannot escape (sr-only-containment).\n    return (\n      <div className={cn(\"relative grid min-w-0 gap-1.5\", className)}>\n        <div className=\"flex items-center gap-1\">\n          {/* A `<label>` with no `htmlFor`: a group is not labelable, so it is named\n              by `aria-labelledby` on the group; the element keeps the Field look. */}\n          <Label\n            id={labelId}\n            disabled={dimmed}\n            data-error={hasError || undefined}\n            className=\"data-[error=true]:text-danger\"\n          >\n            {label}\n          </Label>\n          {labelHint}\n        </div>\n        <div className=\"min-w-0\">\n          {group}\n          {belowEl}\n          {captionEl}\n          {errorEl}\n        </div>\n      </div>\n    );\n  }\n  if (strip) {\n    return (\n      <LabelStrip labelId={labelId} label={label} hint={labelHint} disabled={dimmed} className={className}>\n        {group}\n        {belowEl}\n        {captionEl}\n        {errorEl}\n      </LabelStrip>\n    );\n  }\n  if (!field) {\n    if (!captionEl && !belowEl) return group;\n    // The group keeps its `className`, as without a caption; the wrapper only stacks.\n    return (\n      <div className=\"min-w-0\">\n        {group}\n        {belowEl}\n        {captionEl}\n      </div>\n    );\n  }\n  return (\n    // `h-full` + `flex-1`: the chrome fills a grid or stretched flex row, which is what\n    // levels it with a select beside it whatever the browser makes of the select.\n    <div className={cn(\"flex h-full flex-col\", className)}>\n      <FloatingField\n        className=\"flex flex-1 flex-col\"\n        label={<span id={labelId}>{label}</span>}\n        staticLabel\n        hint={labelHint}\n      >\n        <div\n          className={cn(\n            \"flex flex-1 flex-col justify-center rounded-md border border-subtle bg-surface px-1 shadow-sm\",\n            CHROME_PAD[size],\n            dimmed && \"bg-surface-2 opacity-60\",\n            hasError && FIELD_INVALID,\n            chromeClassName,\n          )}\n        >\n          {group}\n        </div>\n      </FloatingField>\n      {belowEl}\n      {captionEl}\n      {errorEl}\n    </div>\n  );\n}\n"],"mappings":";AAweM,SA6II,UA7IJ,KA6II,YA7IJ;AAxeN,SAAS,aAAa,aAAa;AAEnC,SAAS,UAAU;AACnB,SAAS,sBAAsB;AAC/B,SAAS,eAAe,eAAe,aAAa;AACpD,SAAS,eAAe;AACxB,SAAS,uBAAyC;AAClD,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,wBAAwB;AAgMjC,MAAM,aAA0C,EAAE,IAAI,4BAA4B,IAAI,uBAAuB;AAC7G,MAAM,iBAA8C,EAAE,IAAI,2BAA2B,IAAI,iBAAiB;AAkC1G,MAAM,gBAAgB;AAmBtB,MAAM,gBAA6C;AAAA,EACjD,IAAI;AAAA,EACJ,IAAI;AACN;AAQA,MAAM,cAAc;AAOpB,SAAS,iBAAiB,OAAwC;AAChE,SACE,MAAM,cAA2B,mDAAmD,KACpF,MAAM,cAA2B,uBAAuB;AAE5D;AA+EO,SAAS,YAA8B,OAA0C;AACtF,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW;AAAA,IACX,WAAW;AAAA,IACX,OAAO;AAAA,IACP;AAAA,IACA,iBAAiB;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,IAChB;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,UAAU,MAAM;AACtB,QAAM,UAAU,MAAM;AACtB,QAAM,WAAW,MAAM;AACvB,QAAM,gBAAgB,MAAM;AAG5B,QAAM,WAAW;AAAA,IACf,CAAC,OAA8B;AAC7B,UAAI,GAAI,IAAG,QAAQ,CAACA,aAA2B,iBAAiB,EAAE,GAAG,MAAMA,QAAO;AAClF,gBAAU,KAAK,EAAE;AAAA,IACnB;AAAA,IACA,CAAC,GAAG;AAAA,EACN;AAEA,QAAM,iBAAiB,gBAAgB,QAAQ,iBAAiB;AAChE,QAAM,SAAS,WAAW,cAAc;AAExC,QAAM,aAAa,sBAAsB,qBAAqB,KAAK;AAKnE,QAAM,WAAW,cAAc,WAAW,KAAK,IAAI,OAAO,QAAW,KAAK;AAC1E,QAAM,WAAW,aAAa;AAC9B,QAAM,aAAa,cAAc,MAAM,UAAU,KAAK;AAEtD,QAAM,gBAAgB,WAClB,WAAW,UAAU,IACnB,aACA,SACF,WAAW,IAAI,IACb,OACA,iBAAiB,IAAI,KAAK,eAAe,OACvC,aACA;AACR,QAAM,YAAY,aAAa,kBAAkB,SAAY,OAAO;AAGpE,QAAM,SAAS,YAAY;AAC3B,QAAM,WAAW,WAAW,KAAK;AAGjC,QAAM,QAAQ,YAAY,mBAAmB;AAC7C,QAAM,QAAQ,YAAY,mBAAmB;AAC7C,QAAM,QAAQ,YAAY,mBAAmB;AAG7C,QAAM,cAAc,aAAa;AACjC,QAAM,WAAW,YAAY,WAAW,KAAK;AAG7C,QAAM,EAAE,YAAY,aAAa,UAAU,WAAW,SAAS,WAAW,YAAY,GAAG,KAAK,IAAI;AAGlG,QAAM,iBAAiB,KAAK,cAAc,MAAM,QAAQ,KAAK,cAAc,MAAM;AACjF,QAAM,YAAY,MAAM;AACxB,QAAM,gBAAgB,OAAO,YAAY;AACzC,QAAM,cAAc,gBAAiB,QAAuC,KAAK,IAAI;AACrF,QAAM,aAAa,WAAW,WAAW;AACzC,QAAM,SAAS,CAAC,SAAY;AAG1B,QAAI,OAAQ;AACZ,QAAI,MAAM,WAAY,OAAM,SAAS,SAAS,QAAQ,OAAO,IAAI;AAAA,QAC5D,OAAM,SAAS,IAAI;AAAA,EAC1B;AAIA,QAAM,UAAU,MAAM,eAAe,QAAQ,MAAM,cAAc;AAKjE,QAAM,UAAU,QAAQ,KAAK,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,CAAC,GAAG;AAC7E,QAAM,aAAa,CAAC,GAAqC,UAAkB;AACzE,UAAM,OAAO,QAAQ,SAAS;AAC9B,QAAI,OAAsB;AAC1B,UAAM,OAAO,eAAe,EAAE,KAAK,EAAE,aAAa;AAClD,QAAI,SAAS,EAAG,QAAO,QAAQ;AAAA,aACtB,EAAE,QAAQ,YAAa,QAAO,QAAQ;AAAA,aACtC,EAAE,QAAQ,UAAW,QAAO,QAAQ;AAAA,aACpC,EAAE,QAAQ,OAAQ,QAAO;AAAA,aACzB,EAAE,QAAQ,MAAO,QAAO;AACjC,QAAI,SAAS,KAAM;AACnB,MAAE,eAAe;AACjB,WAAO,OAAO,IAAI,OAAO,OAAO,OAAO,IAAI;AAE3C,UAAM,UAAU,EAAE,cAAc,eAAe,iBAAoC,iBAAiB;AACpG,cAAU,IAAI,GAAG,MAAM;AAEvB,WAAO,QAAQ,IAAI,EAAE,KAAK;AAAA,EAC5B;AACA,QAAM,WAAW,QAAQ,IAAI,CAAC,KAAK,UAAU;AAC3C,UAAM,SAAS,IAAI,UAAU;AAC7B,WACE;AAAA,MAAC;AAAA;AAAA,QAEC,MAAK;AAAA,QACL,MAAM,UAAU,SAAY;AAAA,QAC5B,gBAAc,UAAU,SAAY;AAAA,QACpC,gBAAc,UAAU,SAAS;AAAA,QAEjC,UAAU,YAAY,CAAC;AAAA,QACvB,iBAAe,UAAU;AAAA,QAGzB,oBAAkB,SAAS,WAAW;AAAA,QACtC,UAAU,UAAU,SAAY,IAAI,UAAU,UAAU,IAAI;AAAA,QAC5D,WAAW,UAAU,SAAY,CAAC,MAAM,WAAW,GAAG,KAAK;AAAA,QAC3D,SAAS,MAAM,OAAO,IAAI,KAAK;AAAA,QAC/B,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UA8BT,aAAa,SAAS,sBAAsB;AAAA,UAC5C;AAAA,UACA;AAAA,UACA,SAAS,QAAQ;AAAA;AAAA;AAAA;AAAA,UAIjB,SAAS,eAAe,IAAI;AAAA;AAAA,UAE5B,SAAS,cAAc,IAAI;AAAA,UAC3B,SAAS,4BAA4B;AAAA;AAAA;AAAA;AAAA;AAAA,UAKrC,UAAU;AAAA,UACV,UAAU,CAAC,UAAU;AAAA,UACrB;AAAA,UACA,IAAI;AAAA,QACN;AAAA,QAEC,cAAI;AAAA;AAAA,MAjEA,IAAI;AAAA,IAkEX;AAAA,EAEJ,CAAC;AACD,QAAM,QACJ;AAAA,IAAC;AAAA;AAAA,MAWE,GAAG;AAAA,MACJ,KAAK;AAAA,MACL,MAAM,UAAU,UAAU;AAAA,MAC1B,cAAY;AAAA,MACZ,mBAAiB,YAAY,kBAAkB,SAAY,UAAU,KAAK,iBAAiB;AAAA,MAC3F,gBAAc,YAAY,KAAK,cAAc,KAAK;AAAA,MAClD,oBACE;AAAA,QACE,KAAK,kBAAkB;AAAA,QACvB,kBAAkB,UAAa;AAAA,QAC/B,cAAc;AAAA,QACd,YAAY;AAAA,MACd,EACG,OAAO,OAAO,EACd,KAAK,GAAG,KAAK;AAAA,MAKlB,iBAAe,UAAU;AAAA,MACzB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAaT;AAAA;AAAA,QAEA,SAAS;AAAA,QACT,aAAa,UAAU;AAAA,QACvB,eAAe;AAAA;AAAA;AAAA;AAAA,QAIf,UAAU;AAAA;AAAA,QAEV,CAAC,UAAU,mBAAoB,SAAS,UAAU,aAAc;AAAA;AAAA;AAAA,QAGhE,SAAS;AAAA,QACT,CAAC,YAAY;AAAA,MACf;AAAA,MAEC,oBAAU,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAQV,oBAAC,WAAQ,OAAO,gBAAgB,WAAU,yDACxC,2CACG;AAAA;AAAA,UACD,oBAAC,UAAK,IAAI,UAAU,QAAM,MACvB,0BACH;AAAA,WACF,GACF;AAAA,UAEA;AAAA;AAAA,EAEJ;AAOF,QAAM,YACJ,cAAc,gBACZ;AAAA,IAAC;AAAA;AAAA,MACC,IAAI;AAAA,MACJ,aAAW,gBAAgB,WAAW;AAAA,MACtC,WAAW,GAAG,wCAAwC,cAAc,MAAM;AAAA,MAEzE,uBAAa,cAAc;AAAA;AAAA,EAC9B,IACE;AACN,QAAM,UAAU,WACd,oBAAC,OAAE,IAAI,SAAS,WAAW,mBACxB,iBACH,IACE;AAIJ,QAAM,UACJ,kBAAkB,UAAa,aAC7B,iCACG;AAAA,sBAAkB,UACjB,oBAAC,OAAE,IAAI,eAAe,WAAW,qBAC9B,yBACH;AAAA,IAED,cACC,oBAAC,OAAE,IAAI,UAAU,WAAW,4BACzB,0BACH;AAAA,KAEJ,IACE;AACN,MAAI,OAAO;AAET,WACE,qBAAC,SAAI,WAAW,GAAG,iCAAiC,SAAS,GAC3D;AAAA,2BAAC,SAAI,WAAU,2BAGb;AAAA;AAAA,UAAC;AAAA;AAAA,YACC,IAAI;AAAA,YACJ,UAAU;AAAA,YACV,cAAY,YAAY;AAAA,YACxB,WAAU;AAAA,YAET;AAAA;AAAA,QACH;AAAA,QACC;AAAA,SACH;AAAA,MACA,qBAAC,SAAI,WAAU,WACZ;AAAA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,SACH;AAAA,OACF;AAAA,EAEJ;AACA,MAAI,OAAO;AACT,WACE,qBAAC,cAAW,SAAkB,OAAc,MAAM,WAAW,UAAU,QAAQ,WAC5E;AAAA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,OACH;AAAA,EAEJ;AACA,MAAI,CAAC,OAAO;AACV,QAAI,CAAC,aAAa,CAAC,QAAS,QAAO;AAEnC,WACE,qBAAC,SAAI,WAAU,WACZ;AAAA;AAAA,MACA;AAAA,MACA;AAAA,OACH;AAAA,EAEJ;AACA;AAAA;AAAA;AAAA,IAGE,qBAAC,SAAI,WAAW,GAAG,wBAAwB,SAAS,GAClD;AAAA;AAAA,QAAC;AAAA;AAAA,UACC,WAAU;AAAA,UACV,OAAO,oBAAC,UAAK,IAAI,SAAU,iBAAM;AAAA,UACjC,aAAW;AAAA,UACX,MAAM;AAAA,UAEN;AAAA,YAAC;AAAA;AAAA,cACC,WAAW;AAAA,gBACT;AAAA,gBACA,WAAW,IAAI;AAAA,gBACf,UAAU;AAAA,gBACV,YAAY;AAAA,gBACZ;AAAA,cACF;AAAA,cAEC;AAAA;AAAA,UACH;AAAA;AAAA,MACF;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,OACH;AAAA;AAEJ;","names":["options"]}

package/dist/components/treemap-layout.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/treemap-layout.ts"],"sourcesContent":["// Where `Treemap` draws each node — a pure function of the nodes, the chart's size and the\n// text size, with no recharts in it (0.52 code review of treemap.tsx, findings 1 and 8).\n//\n// recharts lays nested data out itself, edge to edge, and 0.52 first made the groups' room\n// afterwards: a group's cell took its band and margin out of its rectangle and each child's\n// cell SQUEEZED the rectangle recharts gave it into what was left. Two faults followed.\n// A fixed 23px is a different share of every group, so a €100 tile in a 61px group was\n// drawn at two thirds of a €100 tile in a 300px one — in a chart whose one promise is that\n// area is share. And the squeeze ran through a cache the group's cell wrote during render\n// for its children's cells to read, which held only because recharts renders a group\n// before its children.\n//\n// So the layout is made here, up front: squarified as recharts does it, with each group\n// asking for its tiles' area PLUS its frame's, and its tiles laid out in its body. A\n// frame's area depends on the rectangle it gets, so the layout is run again with each\n// group's frame as measured until no frame moves by a pixel — two or three rounds.\n\nexport interface Box {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/** What the layout needs of a node: its key, its value, and a group's nodes. */\nexport interface LayoutNode {\n  path: string;\n  size: number;\n  children?: readonly LayoutNode[];\n}\n\n/** A node as drawn: its rectangle, and for a group the body its nodes fill and whether\n *  its band is drawn. Whole pixels, on shared edges, so neighbours meet without a seam. */\nexport interface Placed {\n  box: Box;\n  body?: Box;\n  banded?: boolean;\n}\n\nconst PHI = (1 + Math.sqrt(5)) / 2;\n\n/**\n * A group's band, in px at Normal, × the text size's scale: the 20px floor a tile keeps\n * for its own name, so the group's name sits in it as a tile's does in a tile.\n */\nexport const BAND = 20;\n/**\n * The frame's margin round its body, in px. Each tile keeps its 2px gutter, half of it\n * inside the tile, so 3 leaves one pixel of the frame's own colour between the group's\n * gutter and its tiles' — the frame reads as one outline round the group, not as a gutter\n * that happens to be wider.\n */\nexport const FRAME_MARGIN = 3;\n/**\n * The least of a group's height its body keeps under the band: 1/φ. At Normal that is a\n * group of 61px (20 band + 3 margin = 0.382 of it), whose body of 38px still holds a\n * tile's name and its second line (the note's 36px floor) — so a single row of tiles under\n * the band keeps both. A smaller group draws no band, and its name is in its tiles'\n * accessible names and its tooltip rather than over their area. Since the frame's area is\n * given to the group (above), this bounds the frame's share of the picture, not the tiles'.\n */\nexport const BODY_SHARE = 1 / PHI;\n\n/** A group drawn at `box`: whether it has the room for its band (see {@link BODY_SHARE};\n *  and 44px across, the floor of a word), and the body its nodes are drawn into. */\nexport function groupBody(box: Box, scale: number): { banded: boolean; body: Box } {\n  const band = BAND * scale;\n  const margin = Math.min(FRAME_MARGIN, Math.floor(box.width / 4), Math.floor(box.height / 4));\n  const banded = box.width >= 44 * scale && box.height - band - margin >= box.height * BODY_SHARE;\n  const top = banded ? band : margin;\n  return {\n    banded,\n    body: {\n      x: box.x + margin,\n      y: box.y + top,\n      width: Math.max(0, box.width - 2 * margin),\n      height: Math.max(0, box.height - top - margin),\n    },\n  };\n}\n\n/** The worst aspect ratio in a row of `area` along `side`, against the target `ratio`. */\nfunction worst(area: number, min: number, max: number, side: number, ratio: number): number {\n  const along = side * side;\n  const across = area * area;\n  if (across === 0 || min === 0) return Infinity;\n  return Math.max((along * max * ratio) / across, across / (along * min * ratio));\n}\n\n/**\n * Bruls, Huizing and van Wijk's squarified layout, as recharts runs it: `weights` share\n * out `rect` in order, a row at a time along its shorter side, and a row closes when the\n * next node would make its worst tile further from φ:1 (recharts' default ratio). Returns\n * one rectangle per weight, in order, in fractional pixels.\n */\nexport function squarify(weights: readonly number[], rect: Box, ratio = PHI): Box[] {\n  const out: Box[] = weights.map(() => ({ x: rect.x, y: rect.y, width: 0, height: 0 }));\n  const sum = weights.reduce((acc, w) => acc + Math.max(0, w), 0);\n  if (!(sum > 0) || rect.width <= 0 || rect.height <= 0) return out;\n  const areas = weights.map((w) => (Math.max(0, w) * rect.width * rect.height) / sum);\n  let { x, y, width, height } = rect;\n  let i = 0;\n  while (i < areas.length) {\n    const side = Math.min(width, height);\n    let rowArea = 0;\n    let min = Infinity;\n    let max = 0;\n    let best = Infinity;\n    let j = i;\n    while (j < areas.length) {\n      const a = areas[j]!;\n      const score = worst(rowArea + a, Math.min(min, a), Math.max(max, a), side, ratio);\n      if (j > i && score > best) break;\n      rowArea += a;\n      min = Math.min(min, a);\n      max = Math.max(max, a);\n      best = score;\n      j += 1;\n    }\n    // The last row takes what is left, so rounding never leaves a sliver unpainted.\n    const last = j === areas.length;\n    if (side === width) {\n      // A row along the top, as wide as the space.\n      const thick = last ? height : rowArea / width;\n      let at = x;\n      for (let k = i; k < j; k++) {\n        const len = k === j - 1 ? x + width - at : (areas[k]! / rowArea) * width;\n        out[k] = { x: at, y, width: len, height: thick };\n        at += len;\n      }\n      y += thick;\n      height -= thick;\n    } else {\n      // A column at the left, as tall as the space.\n      const thick = last ? width : rowArea / height;\n      let at = y;\n      for (let k = i; k < j; k++) {\n        const len = k === j - 1 ? y + height - at : (areas[k]! / rowArea) * height;\n        out[k] = { x, y: at, width: thick, height: len };\n        at += len;\n      }\n      x += thick;\n      width -= thick;\n    }\n    i = j;\n  }\n  return out;\n}\n\n/** Whole pixels on the EDGES: neighbours share an edge, so they round it alike. */\nfunction snap(b: Box): Box {\n  const x = Math.round(b.x);\n  const y = Math.round(b.y);\n  return { x, y, width: Math.round(b.x + b.width) - x, height: Math.round(b.y + b.height) - y };\n}\n\n/** The rounds the frames get to settle; three is usual, more only when a band switches. */\nconst ROUNDS = 8;\n\n/**\n * Every node of `nodes` placed in a `width` × `height` chart, by path.\n *\n * Each tile's area is its value's share of what is left for tiles once the frames have\n * theirs — the same density in every group and at the top. A group asks for its tiles'\n * area and its own frame's (band and margin, as {@link groupBody} measures them on the\n * rectangle it got last round), so its body holds exactly its tiles.\n */\nexport function layoutTreemap(\n  nodes: readonly LayoutNode[],\n  width: number,\n  height: number,\n  scale: number,\n): Map<string, Placed> {\n  const total = nodes.reduce((acc, n) => acc + n.size, 0);\n  const frames = new Map<string, number>();\n  let placed = new Map<string, Placed>();\n  for (let round = 0; round < ROUNDS; round++) {\n    const framed = [...frames.values()].reduce((acc, a) => acc + a, 0);\n    const spare = width * height - framed;\n    // Frames that would take the whole chart (a tiny chart of many groups) leave nothing\n    // to share; the tiles then take the density they would have without frames.\n    const density = total > 0 ? (spare > 0 ? spare : width * height) / total : 0;\n    const need = (n: LayoutNode): number =>\n      n.children ? (frames.get(n.path) ?? 0) + n.children.reduce((acc, c) => acc + need(c), 0) : n.size * density;\n    let moved = 0;\n    placed = new Map();\n    const place = (list: readonly LayoutNode[], rect: Box) => {\n      const boxes = squarify(\n        list.map((n) => need(n)),\n        rect,\n      );\n      list.forEach((n, i) => {\n        const box = snap(boxes[i]!);\n        if (!n.children) {\n          placed.set(n.path, { box });\n          return;\n        }\n        const { banded, body } = groupBody(box, scale);\n        placed.set(n.path, { box, body, banded });\n        const frame = box.width * box.height - body.width * body.height;\n        moved = Math.max(moved, Math.abs(frame - (frames.get(n.path) ?? 0)));\n        frames.set(n.path, frame);\n        place(n.children, body);\n      });\n    };\n    place(nodes, { x: 0, y: 0, width, height });\n    if (moved < 1) break;\n  }\n  return placed;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/treemap-layout.ts"],"sourcesContent":["// Where `Treemap` draws each node — a pure function of the nodes, the chart's size and the\n// text size, with no recharts in it (0.52 code review of treemap.tsx, findings 1 and 8).\n//\n// recharts lays nested data out itself, edge to edge, and 0.52 first made the groups' room\n// afterwards: a group's cell took its band and margin out of its rectangle and each child's\n// cell SQUEEZED the rectangle recharts gave it into what was left. Two faults followed.\n// A fixed 23px is a different share of every group, so a €100 tile in a 61px group was\n// drawn at two thirds of a €100 tile in a 300px one — in a chart whose one promise is that\n// area is share. And the squeeze ran through a cache the group's cell wrote during render\n// for its children's cells to read, which held only because recharts renders a group\n// before its children.\n//\n// So the layout is made here, up front: squarified as recharts does it, with each group\n// asking for its tiles' area PLUS its frame's, and its tiles laid out in its body. A\n// frame's area depends on the rectangle it gets, so the layout is run again with each\n// group's frame as measured until no frame moves by a pixel — two or three rounds.\n//\n// Since 0.55 it is the only layout the map has: the map draws its nodes itself, where this\n// puts them (treemap.tsx, \"The picture\"), and recharts lays nothing out for it any more.\n\nexport interface Box {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\n/** What the layout needs of a node: its key, its value, and a group's nodes. */\nexport interface LayoutNode {\n  path: string;\n  size: number;\n  children?: readonly LayoutNode[];\n}\n\n/** A node as drawn: its rectangle, and for a group the body its nodes fill and whether\n *  its band is drawn. Whole pixels, on shared edges, so neighbours meet without a seam. */\nexport interface Placed {\n  box: Box;\n  body?: Box;\n  banded?: boolean;\n}\n\nconst PHI = (1 + Math.sqrt(5)) / 2;\n\n/**\n * A group's band, in px at Normal, × the text size's scale: the 20px floor a tile keeps\n * for its own name, so the group's name sits in it as a tile's does in a tile.\n */\nexport const BAND = 20;\n/**\n * The frame's margin round its body, in px. Each tile keeps its 2px gutter, half of it\n * inside the tile, so 3 leaves one pixel of the frame's own colour between the group's\n * gutter and its tiles' — the frame reads as one outline round the group, not as a gutter\n * that happens to be wider.\n */\nexport const FRAME_MARGIN = 3;\n/**\n * The least of a group's height its body keeps under the band: 1/φ. At Normal that is a\n * group of 61px (20 band + 3 margin = 0.382 of it), whose body of 38px still holds a\n * tile's name and its second line (the note's 36px floor) — so a single row of tiles under\n * the band keeps both. A smaller group draws no band, and its name is in its tiles'\n * accessible names and its tooltip rather than over their area. Since the frame's area is\n * given to the group (above), this bounds the frame's share of the picture, not the tiles'.\n */\nexport const BODY_SHARE = 1 / PHI;\n\n/** A group drawn at `box`: whether it has the room for its band (see {@link BODY_SHARE};\n *  and 44px across, the floor of a word), and the body its nodes are drawn into. */\nexport function groupBody(box: Box, scale: number): { banded: boolean; body: Box } {\n  const band = BAND * scale;\n  const margin = Math.min(FRAME_MARGIN, Math.floor(box.width / 4), Math.floor(box.height / 4));\n  const banded = box.width >= 44 * scale && box.height - band - margin >= box.height * BODY_SHARE;\n  const top = banded ? band : margin;\n  return {\n    banded,\n    body: {\n      x: box.x + margin,\n      y: box.y + top,\n      width: Math.max(0, box.width - 2 * margin),\n      height: Math.max(0, box.height - top - margin),\n    },\n  };\n}\n\n/** The worst aspect ratio in a row of `area` along `side`, against the target `ratio`. */\nfunction worst(area: number, min: number, max: number, side: number, ratio: number): number {\n  const along = side * side;\n  const across = area * area;\n  if (across === 0 || min === 0) return Infinity;\n  return Math.max((along * max * ratio) / across, across / (along * min * ratio));\n}\n\n/**\n * Bruls, Huizing and van Wijk's squarified layout, as recharts runs it: `weights` share\n * out `rect` in order, a row at a time along its shorter side, and a row closes when the\n * next node would make its worst tile further from φ:1 (recharts' default ratio). Returns\n * one rectangle per weight, in order, in fractional pixels.\n */\nexport function squarify(weights: readonly number[], rect: Box, ratio = PHI): Box[] {\n  const out: Box[] = weights.map(() => ({ x: rect.x, y: rect.y, width: 0, height: 0 }));\n  const sum = weights.reduce((acc, w) => acc + Math.max(0, w), 0);\n  if (!(sum > 0) || rect.width <= 0 || rect.height <= 0) return out;\n  const areas = weights.map((w) => (Math.max(0, w) * rect.width * rect.height) / sum);\n  let { x, y, width, height } = rect;\n  let i = 0;\n  while (i < areas.length) {\n    const side = Math.min(width, height);\n    let rowArea = 0;\n    let min = Infinity;\n    let max = 0;\n    let best = Infinity;\n    let j = i;\n    while (j < areas.length) {\n      const a = areas[j]!;\n      const score = worst(rowArea + a, Math.min(min, a), Math.max(max, a), side, ratio);\n      if (j > i && score > best) break;\n      rowArea += a;\n      min = Math.min(min, a);\n      max = Math.max(max, a);\n      best = score;\n      j += 1;\n    }\n    // The last row takes what is left, so rounding never leaves a sliver unpainted.\n    const last = j === areas.length;\n    if (side === width) {\n      // A row along the top, as wide as the space.\n      const thick = last ? height : rowArea / width;\n      let at = x;\n      for (let k = i; k < j; k++) {\n        const len = k === j - 1 ? x + width - at : (areas[k]! / rowArea) * width;\n        out[k] = { x: at, y, width: len, height: thick };\n        at += len;\n      }\n      y += thick;\n      height -= thick;\n    } else {\n      // A column at the left, as tall as the space.\n      const thick = last ? width : rowArea / height;\n      let at = y;\n      for (let k = i; k < j; k++) {\n        const len = k === j - 1 ? y + height - at : (areas[k]! / rowArea) * height;\n        out[k] = { x, y: at, width: thick, height: len };\n        at += len;\n      }\n      x += thick;\n      width -= thick;\n    }\n    i = j;\n  }\n  return out;\n}\n\n/** Whole pixels on the EDGES: neighbours share an edge, so they round it alike. */\nfunction snap(b: Box): Box {\n  const x = Math.round(b.x);\n  const y = Math.round(b.y);\n  return { x, y, width: Math.round(b.x + b.width) - x, height: Math.round(b.y + b.height) - y };\n}\n\n/** The rounds the frames get to settle; three is usual, more only when a band switches. */\nconst ROUNDS = 8;\n\n/**\n * Every node of `nodes` placed in a `width` × `height` chart, by path.\n *\n * Each tile's area is its value's share of what is left for tiles once the frames have\n * theirs — the same density in every group and at the top. A group asks for its tiles'\n * area and its own frame's (band and margin, as {@link groupBody} measures them on the\n * rectangle it got last round), so its body holds exactly its tiles.\n */\nexport function layoutTreemap(\n  nodes: readonly LayoutNode[],\n  width: number,\n  height: number,\n  scale: number,\n): Map<string, Placed> {\n  const total = nodes.reduce((acc, n) => acc + n.size, 0);\n  const frames = new Map<string, number>();\n  let placed = new Map<string, Placed>();\n  for (let round = 0; round < ROUNDS; round++) {\n    const framed = [...frames.values()].reduce((acc, a) => acc + a, 0);\n    const spare = width * height - framed;\n    // Frames that would take the whole chart (a tiny chart of many groups) leave nothing\n    // to share; the tiles then take the density they would have without frames.\n    const density = total > 0 ? (spare > 0 ? spare : width * height) / total : 0;\n    const need = (n: LayoutNode): number =>\n      n.children ? (frames.get(n.path) ?? 0) + n.children.reduce((acc, c) => acc + need(c), 0) : n.size * density;\n    let moved = 0;\n    placed = new Map();\n    const place = (list: readonly LayoutNode[], rect: Box) => {\n      const boxes = squarify(\n        list.map((n) => need(n)),\n        rect,\n      );\n      list.forEach((n, i) => {\n        const box = snap(boxes[i]!);\n        if (!n.children) {\n          placed.set(n.path, { box });\n          return;\n        }\n        const { banded, body } = groupBody(box, scale);\n        placed.set(n.path, { box, body, banded });\n        const frame = box.width * box.height - body.width * body.height;\n        moved = Math.max(moved, Math.abs(frame - (frames.get(n.path) ?? 0)));\n        frames.set(n.path, frame);\n        place(n.children, body);\n      });\n    };\n    place(nodes, { x: 0, y: 0, width, height });\n    if (moved < 1) break;\n  }\n  return placed;\n}\n"],"mappings":"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","names":[]}

package/dist/components/treemap.d.ts

@@ -20,8 +20,8 @@ export interface TreemapNode {
     id: string;
     name: string;
     /** The tile's area. A node whose value is not a positive finite number is NOT
-     *  drawn — an area cannot be negative, and recharts lays a negative size out as
-     *  nonsense rather than refusing it. Saying so is the caller's job: a group that
+     *  drawn — an area cannot be negative, and a squarified layout handed a negative size
+     *  draws nonsense rather than refusing it. Saying so is the caller's job: a group that
      *  vanishes silently between two views of the same data is a bug report.
      *
      *  A GROUP's own `value` is not read: its area is its drawn children's together. Pass
@@ -256,11 +256,11 @@ export interface TreemapCellProps {
     onNodeClick?: (id: string, name: string, groups?: readonly string[]) => void;
     /** A group's cell's click; see {@link TreemapProps.onGroupClick}. */
     onGroupClick?: (id: string, name: string, groups?: readonly string[]) => void;
-    /** The ids of the groups round the node, outermost first. `Treemap` puts it on every
-     *  node it hands recharts; a cell drawn in a caller's own map has it if the data does. */
+    /** The ids of the groups round the node, outermost first. `Treemap` gives it every tile
+     *  it draws; a cell drawn in a caller's own map has it if the data does. */
     groups?: readonly string[];
-    /** The node's place in the tree, which `Treemap` puts on every node it hands recharts:
-     *  its key in the map's keyboard, where an id may repeat between a group and a tile. */
+    /** The node's place in the tree, which `Treemap` gives every tile it draws: its key in
+     *  the map's keyboard, where an id may repeat between a group and a tile. */
     path?: string;
     /** Filled in by recharts for a GROUP: the nodes laid out inside it. A cell with
      *  children draws a frame, not a tile (0.52). */
@@ -278,8 +278,8 @@ export interface TreemapCellProps {
     edges?: TreemapEdges;
 }
 /**
- * One tile. Exported so a caller drawing its own recharts `<Treemap>` gets the same
- * label rules.
+ * One tile, for a caller drawing its own recharts `<Treemap>`: the `content` that gives it
+ * the map's label rules. `Treemap` itself draws the same tile (0.55, "The picture").
  *
  * recharts' default cell inherits the chart-level `stroke`, an SVG presentation
  * attribute that lands on the `<svg>` root and cascades into the label — so the glyphs
@@ -288,15 +288,15 @@ export interface TreemapCellProps {
  * (`paint-order: stroke`), which defeats any inherited stroke and keeps the text solid
  * where it overlaps a lighter or darker part of its own tile.
  *
- * Inside a `Treemap` it is one stop of the map's keyboard, named with its value and
- * share (0.52); drawn on its own it is a stop only as a button (`onNodeClick`), named by
- * `name`.
+ * Drawn on its own it is a stop only as a button (`onNodeClick`), named by `name`; a
+ * `Treemap`'s tile is one stop of the map's keyboard, named with its value and share
+ * (0.52).
  *
  * A node with `children` is a GROUP (0.52): the cell draws a frame in the well's colour
  * (`--bg-surface-2`), with the group's name in a band along its top where the group has
- * the room (61px at Normal, treemap-layout's `BODY_SHARE`). Inside a `Treemap` its tiles are laid out
- * in the frame's body; in a caller's own nested recharts `<Treemap>` they are drawn where
- * recharts lays them, over the frame — only `Treemap` makes the room.
+ * the room (61px at Normal, treemap-layout's `BODY_SHARE`). In a caller's own nested
+ * recharts `<Treemap>` the group's tiles are drawn where recharts lays them, over the
+ * frame — only `Treemap` makes the room, laying them out in the frame's body.
  */
 export declare function TreemapCell(props: TreemapCellProps): import("react").JSX.Element;
 /**
@@ -312,6 +312,8 @@ export declare function TreemapCell(props: TreemapCellProps): import("react").JS
  * Renders nothing when no node has a positive value — an empty box is a hole in the
  * card, and the caller's own sentence is the better answer there.
  *
- * Needs `recharts`, like everything behind `@eifi1/ui-kit/chart`.
+ * Drawn by the kit (0.55): the layout, the SVG and the tooltip are the map's own, inside the
+ * chart shell every chart shares, `ChartContainer` — whose `ResponsiveContainer` is all of
+ * `recharts` it still needs.
  */
 export declare function Treemap({ data, valueFormatter, height, onNodeClick, onGroupClick, redactNames, shareInValue, nodeNote, maxTiles, colors, edges, description, labels: labelsProp, style, ...rest }: TreemapProps): import("react").JSX.Element | null;