@adea-ai/ui 0.63.3 → 0.64.0

package/dist/lib/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","names":[],"sources":["../../src/lib/tokens.ts"],"sourcesContent":["/**\n * The design system's token manifest.\n *\n * `theme.css` is the source of truth for token *values*. This file is the\n * source of truth for token *names and meaning* — what each one is for, and\n * which ones a theme may vary.\n *\n * It exists because a manifest that is only documentation rots. Two things read\n * it instead:\n *\n *   - the token galleries in Storybook, so the review surface shows every token\n *     rather than the ones an author remembered;\n *   - `tests/tokens.test.ts`, which parses `theme.css` and fails when a token\n *     is declared in one place and missing from the other.\n *\n * That pairing is what makes \"every token is documented and every documented\n * token exists\" a property the build enforces rather than a promise.\n */\n\nimport { ACCENTS } from '@adea-ai/themes'\n\nexport type TokenKind =\n  | 'color'\n  | 'dimension'\n  | 'font-family'\n  | 'number'\n  | 'duration'\n  | 'easing'\n  | 'shadow'\n  | 'text'\n\nexport type TokenDefinition = {\n  /** The custom property name, without the leading `--`. */\n  name: string\n  kind: TokenKind\n  /** One line: what this token is for. Shown in the gallery. */\n  description: string\n  /** True when the light and dark themes give it different values. */\n  themed?: boolean\n}\n\n/**\n * Colour roles, in the order they appear in a page: surfaces first, then text,\n * then the lines between them, then the semantic fills. The order is the\n * documentation — reading the gallery top to bottom walks the surface ladder.\n */\nexport const colorTokens: TokenDefinition[] = [\n  // Surfaces\n  {\n    name: 'background',\n    kind: 'color',\n    themed: true,\n    description: 'The canvas every panel sits on.',\n  },\n  {\n    name: 'foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Default body text on the canvas.',\n  },\n  {\n    name: 'card',\n    kind: 'color',\n    themed: true,\n    description: 'A panel or card raised one rung above the canvas.',\n  },\n  { name: 'card-foreground', kind: 'color', themed: true, description: 'Text on `card`.' },\n  {\n    name: 'popover',\n    kind: 'color',\n    themed: true,\n    description: 'A floating surface: dialog, menu, popover, tooltip-free.',\n  },\n  { name: 'popover-foreground', kind: 'color', themed: true, description: 'Text on `popover`.' },\n  {\n    name: 'surface',\n    kind: 'color',\n    themed: true,\n    description: 'Alias of `background`, for code that means \"a surface\" not \"the page\".',\n  },\n  {\n    name: 'surface-sunken',\n    kind: 'color',\n    themed: true,\n    description: 'A well: code blocks, inset lists, empty states.',\n  },\n  {\n    name: 'surface-raised',\n    kind: 'color',\n    themed: true,\n    description: 'Alias of `card`, for panels that sit on the canvas.',\n  },\n  {\n    name: 'surface-overlay',\n    kind: 'color',\n    themed: true,\n    description: 'Alias of `popover`, for floating layers.',\n  },\n  {\n    name: 'surface-hover',\n    kind: 'color',\n    themed: true,\n    description: 'The hover fill shared by rows, menu items and ghost controls.',\n  },\n  {\n    name: 'surface-active',\n    kind: 'color',\n    themed: true,\n    description: 'The pressed/selected fill, one rung past hover.',\n  },\n  {\n    name: 'chrome',\n    kind: 'color',\n    themed: true,\n    description: 'Window chrome: the top bar and its frosted fill.',\n  },\n  {\n    name: 'chrome-alpha',\n    kind: 'number',\n    themed: true,\n    description: 'Opacity of the chrome fill behind a blur.',\n  },\n\n  // The brand action\n  {\n    name: 'primary',\n    kind: 'color',\n    themed: true,\n    description: 'The Adea emerald. The one primary action in a view.',\n  },\n  {\n    name: 'primary-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Label on `primary`. Black in dark, white in light — the accent flips polarity.',\n  },\n  {\n    name: 'primary-hover',\n    kind: 'color',\n    themed: true,\n    description: 'Hover rung for a primary action.',\n  },\n  {\n    name: 'primary-subtle',\n    kind: 'color',\n    themed: true,\n    description: 'Tinted primary fill: selected rows, focus rings, subtle buttons.',\n  },\n\n  {\n    name: 'secondary',\n    kind: 'color',\n    themed: true,\n    description: 'A quieter filled surface for a secondary action.',\n  },\n  {\n    name: 'secondary-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Label on `secondary`.',\n  },\n  {\n    name: 'muted',\n    kind: 'color',\n    themed: true,\n    description: 'A neutral fill: skeletons, inert chips, table footers.',\n  },\n  {\n    name: 'muted-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'De-emphasised text. Measured to clear 4.5:1 on both `background` and `card`.',\n  },\n  {\n    name: 'accent',\n    kind: 'color',\n    themed: true,\n    description: \"shadcn's hover-surface accent. Not the brand colour — that is `primary`.\",\n  },\n  { name: 'accent-foreground', kind: 'color', themed: true, description: 'Text on `accent`.' },\n\n  // Status\n  {\n    name: 'destructive',\n    kind: 'color',\n    themed: true,\n    description: 'Irreversible or dangerous actions.',\n  },\n  {\n    name: 'destructive-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Label on `destructive`.',\n  },\n  {\n    name: 'destructive-subtle',\n    kind: 'color',\n    themed: true,\n    description: 'Tinted destructive fill: alert banners, invalid fields.',\n  },\n  { name: 'success', kind: 'color', themed: true, description: 'A completed or healthy state.' },\n  { name: 'success-foreground', kind: 'color', themed: true, description: 'Label on `success`.' },\n  { name: 'success-subtle', kind: 'color', themed: true, description: 'Tinted success fill.' },\n  {\n    name: 'warning',\n    kind: 'color',\n    themed: true,\n    description: 'Something needs attention but is not broken.',\n  },\n  { name: 'warning-foreground', kind: 'color', themed: true, description: 'Label on `warning`.' },\n  { name: 'warning-subtle', kind: 'color', themed: true, description: 'Tinted warning fill.' },\n  { name: 'info', kind: 'color', themed: true, description: 'Neutral information.' },\n  { name: 'info-foreground', kind: 'color', themed: true, description: 'Label on `info`.' },\n  { name: 'info-subtle', kind: 'color', themed: true, description: 'Tinted info fill.' },\n\n  // Lines\n  {\n    name: 'border',\n    kind: 'color',\n    themed: true,\n    description: 'Every hairline: panel edges, dividers, card outlines.',\n  },\n  {\n    name: 'input',\n    kind: 'color',\n    themed: true,\n    description:\n      'The edge of an editable control. A rung stronger than `border` so a field is findable.',\n  },\n  {\n    name: 'ring',\n    kind: 'color',\n    themed: true,\n    description: 'The focus ring. Always paired with `primary-subtle` as its glow.',\n  },\n\n  // Theme-invariant glass\n  {\n    name: 'scrim',\n    kind: 'color',\n    description: 'Dark glass for overlays and on-screen controls. Same in both themes.',\n  },\n  { name: 'scrim-foreground', kind: 'color', description: 'Text drawn on `scrim`.' },\n  { name: 'scrim-edge', kind: 'color', description: 'The hairline drawn on `scrim`.' },\n\n  // Diff and code\n  { name: 'diff-add', kind: 'color', themed: true, description: 'Background of an added line.' },\n  {\n    name: 'diff-add-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text of an added line.',\n  },\n  {\n    name: 'diff-delete',\n    kind: 'color',\n    themed: true,\n    description: 'Background of a removed line.',\n  },\n  {\n    name: 'diff-delete-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text of a removed line.',\n  },\n  { name: 'diff-hunk', kind: 'color', themed: true, description: 'Background of a hunk header.' },\n  {\n    name: 'diff-hunk-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text of a hunk header.',\n  },\n  {\n    name: 'diff-meta-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'File headers and line numbers in a diff.',\n  },\n\n  // Charts\n  {\n    name: 'chart-1',\n    kind: 'color',\n    themed: true,\n    description: 'Categorical series 1. The set is closed at six.',\n  },\n  { name: 'chart-2', kind: 'color', themed: true, description: 'Categorical series 2.' },\n  { name: 'chart-3', kind: 'color', themed: true, description: 'Categorical series 3.' },\n  { name: 'chart-4', kind: 'color', themed: true, description: 'Categorical series 4.' },\n  { name: 'chart-5', kind: 'color', themed: true, description: 'Categorical series 5.' },\n  { name: 'chart-6', kind: 'color', themed: true, description: 'Categorical series 6.' },\n\n  // Sidebar (the shadcn contract, kept whole)\n  {\n    name: 'sidebar',\n    kind: 'color',\n    themed: true,\n    description: 'The rail and sidebar surface, tinted against the canvas.',\n  },\n  {\n    name: 'sidebar-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Default text in the rail and sidebar.',\n  },\n  {\n    name: 'sidebar-primary',\n    kind: 'color',\n    themed: true,\n    description: 'The active destination in the rail.',\n  },\n  {\n    name: 'sidebar-primary-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text on the active rail destination.',\n  },\n  {\n    name: 'sidebar-accent',\n    kind: 'color',\n    themed: true,\n    description: 'Hover and selected fill for rail and sidebar rows.',\n  },\n  {\n    name: 'sidebar-accent-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text on `sidebar-accent`.',\n  },\n  {\n    name: 'sidebar-border',\n    kind: 'color',\n    themed: true,\n    description: 'The rule between the rail and the canvas.',\n  },\n  { name: 'sidebar-ring', kind: 'color', themed: true, description: 'Focus ring inside the rail.' },\n  {\n    name: 'sidebar-muted-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Rail labels that are not the current destination.',\n  },\n]\n\nexport const radiusTokens: TokenDefinition[] = [\n  {\n    name: 'radius-lg',\n    kind: 'dimension',\n    description:\n      '10px — cards and panels. Also the knob: move this one value to re-round the whole system.',\n  },\n  { name: 'radius-sm', kind: 'dimension', description: '6px — badges, keyboard keys, menu items.' },\n  {\n    name: 'radius-md',\n    kind: 'dimension',\n    description: '8px — every control: buttons, inputs, selects.',\n  },\n  { name: 'radius-xl', kind: 'dimension', description: '14px — dialogs, menus, sheets.' },\n  { name: 'radius-2xl', kind: 'dimension', description: '18px — full-window surfaces and media.' },\n]\n\nexport const typographyTokens: TokenDefinition[] = [\n  {\n    name: 'font-sans',\n    kind: 'font-family',\n    description: 'The selected interface face. Space Grotesk unless the font axis says otherwise.',\n  },\n  {\n    name: 'font-mono',\n    kind: 'font-family',\n    description: 'The selected monospace face. Code, terminals, ids, paths.',\n  },\n  {\n    name: 'font-family-space-grotesk',\n    kind: 'font-family',\n    description: 'The interface default, and the face the visual language was drawn against.',\n  },\n  {\n    name: 'font-family-jetbrains-mono',\n    kind: 'font-family',\n    description: 'The monospace default. Code, terminals, diffs.',\n  },\n  {\n    name: 'font-family-geist',\n    kind: 'font-family',\n    description: 'An alternative interface face. cortana already ships it.',\n  },\n  {\n    name: 'font-family-geist-mono',\n    kind: 'font-family',\n    description: 'The monospace counterpart to Geist.',\n  },\n  {\n    name: 'font-family-system',\n    kind: 'font-family',\n    description: \"The platform's own interface face. First-class, not a fallback.\",\n  },\n  {\n    name: 'font-family-system-mono',\n    kind: 'font-family',\n    description: \"The platform's own monospace face.\",\n  },\n  {\n    name: 'ui-tracking',\n    kind: 'text',\n    description:\n      'Letter spacing for measured chrome. `normal` on a proportional face, tightened when the UI font is monospace — which is roughly 20% wider at the same size.',\n  },\n  {\n    name: 'ui-word-spacing',\n    kind: 'text',\n    description:\n      \"Word spacing for measured chrome. Mono's space is a full advance-width cell, so a two-word label reads as two floating words without this.\",\n  },\n  {\n    name: 'text-2xs',\n    kind: 'text',\n    description: '11px — the smallest label the system permits: kbd keys, status bar.',\n  },\n  { name: 'text-xs', kind: 'text', description: '12px — metadata, badges, secondary rows.' },\n  {\n    name: 'text-sm',\n    kind: 'text',\n    description: '14px — the interface default. Body copy, labels, controls.',\n  },\n  { name: 'text-base', kind: 'text', description: '16px — card titles and dialog titles.' },\n  { name: 'text-lg', kind: 'text', description: '18px — a section heading inside a page.' },\n  { name: 'text-xl', kind: 'text', description: '20px — a page title.' },\n  { name: 'text-2xl', kind: 'text', description: '24px — a display figure.' },\n  {\n    name: 'text-3xl',\n    kind: 'text',\n    description: '30px — the largest size in the system. Reserved for an empty-state headline.',\n  },\n]\n\nexport const densityTokens: TokenDefinition[] = [\n  { name: 'control-height-2xs', kind: 'dimension', description: '20px — an inline chip control.' },\n  { name: 'control-height-xs', kind: 'dimension', description: '24px — a dense table row action.' },\n  { name: 'control-height-sm', kind: 'dimension', description: '28px — the toolbar default.' },\n  {\n    name: 'control-height-md',\n    kind: 'dimension',\n    description: '32px — the form default. Button and Input are this size unless told otherwise.',\n  },\n  { name: 'control-height-lg', kind: 'dimension', description: '36px — a primary form action.' },\n  {\n    name: 'control-height-xl',\n    kind: 'dimension',\n    description: '40px — a hero control in an empty state.',\n  },\n  {\n    name: 'control-padding-2xs',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 20px control.',\n  },\n  {\n    name: 'control-padding-xs',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 24px control.',\n  },\n  {\n    name: 'control-padding-sm',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 28px control.',\n  },\n  {\n    name: 'control-padding-md',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 32px control.',\n  },\n  {\n    name: 'control-padding-lg',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 36px control.',\n  },\n  {\n    name: 'control-padding-xl',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 40px control.',\n  },\n  { name: 'row-height-sm', kind: 'dimension', description: '28px — a dense list row.' },\n  { name: 'row-height-md', kind: 'dimension', description: '32px — the default list row.' },\n  { name: 'row-height-lg', kind: 'dimension', description: '36px — a two-line list row.' },\n  { name: 'rail-width', kind: 'dimension', description: '58px — the icon-only rail.' },\n  { name: 'rail-width-expanded', kind: 'dimension', description: '236px — the labelled rail.' },\n  {\n    name: 'rail-item-height',\n    kind: 'dimension',\n    description: '36px — a rail or sidebar destination.',\n  },\n  {\n    name: 'sidebar-width',\n    kind: 'dimension',\n    description: '256px — the secondary navigation column.',\n  },\n  {\n    name: 'sidebar-width-compact',\n    kind: 'dimension',\n    description: '48px — the collapsed secondary column.',\n  },\n  { name: 'topbar-height', kind: 'dimension', description: '48px — the window title row.' },\n  { name: 'statusbar-height', kind: 'dimension', description: '28px — the bottom readout strip.' },\n]\n\nexport const elevationTokens: TokenDefinition[] = [\n  {\n    name: 'shadow-2xs',\n    kind: 'shadow',\n    themed: true,\n    description: 'Barely there: a chip resting on a card.',\n  },\n  {\n    name: 'shadow-xs',\n    kind: 'shadow',\n    themed: true,\n    description: 'A card or panel on the canvas.',\n  },\n  {\n    name: 'shadow-sm',\n    kind: 'shadow',\n    themed: true,\n    description: 'A control that lifts: a pressed toggle, a thumb.',\n  },\n  { name: 'shadow-md', kind: 'shadow', themed: true, description: 'A menu or popover.' },\n  { name: 'shadow-lg', kind: 'shadow', themed: true, description: 'A dialog or sheet.' },\n  {\n    name: 'shadow-xl',\n    kind: 'shadow',\n    themed: true,\n    description: 'The command palette, above everything.',\n  },\n]\n\nexport const motionTokens: TokenDefinition[] = [\n  {\n    name: 'duration-fast',\n    kind: 'duration',\n    description: '120ms — a state change the user is already watching.',\n  },\n  { name: 'duration-normal', kind: 'duration', description: '200ms — an entrance.' },\n  { name: 'duration-slow', kind: 'duration', description: '320ms — a layout settle.' },\n  {\n    name: 'ease-out',\n    kind: 'easing',\n    description: 'A fast start and a long settle. Reads as decisive rather than floaty.',\n  },\n  {\n    name: 'ease-in-out',\n    kind: 'easing',\n    description: 'For a loop that has no start or end, such as a shimmer.',\n  },\n]\n\nexport const zIndexTokens: TokenDefinition[] = [\n  { name: 'z-base', kind: 'number', description: 'In flow, at the document order.' },\n  {\n    name: 'z-docked',\n    kind: 'number',\n    description: 'A sticky table header standing above its own scroll body.',\n  },\n  { name: 'z-sticky', kind: 'number', description: 'The top bar and any other pinned chrome.' },\n  { name: 'z-drawer', kind: 'number', description: 'A drawer, below a modal dialog.' },\n  { name: 'z-dialog', kind: 'number', description: 'A modal dialog and its scrim.' },\n  {\n    name: 'z-menu',\n    kind: 'number',\n    description: 'Menus, popovers and comboboxes. Above dialogs, because a dialog can contain one.',\n  },\n  {\n    name: 'z-tooltip',\n    kind: 'number',\n    description: 'Tooltips. Above menus, because a menu item can carry one.',\n  },\n  {\n    name: 'z-toast',\n    kind: 'number',\n    description: 'Notifications. Above everything, so they are never hidden by a dialog.',\n  },\n]\n\n/**\n * The accent axis.\n *\n * adea's accent presets, as a selection rather than a constant. `theme` is the\n * default and means \"the variant's own primary\" — monochrome in adea's palette —\n * and each named preset overrides the interactive roles through the\n * `[data-accent]` blocks in `theme.css`.\n *\n * These are the same six presets `accentPresets` exports in adea's own\n * `appearance.ts`, and the values match. A consumer's appearance picker and the\n * workshop's theme toolbar read this one list, so the two cannot disagree about\n * what a preset is called or what colour it is.\n */\nexport type AccentPreset = {\n  /** The `data-accent` value. `theme` is the variant's own primary. */\n  id: string\n  label: string\n  /** What the preset is for, in the gallery and in a picker. */\n  description: string\n  /** The accent as it appears in the light theme. Absent for `theme`. */\n  light?: string\n  /** The accent as it appears in the dark theme. Absent for `theme`. */\n  dark?: string\n}\n\nexport const accentPresets: readonly AccentPreset[] = Object.freeze([\n  {\n    id: 'theme',\n    label: 'Theme',\n    description:\n      \"The variant's own primary. Neutral in adea's palette, so the interface stays monochrome.\",\n  },\n  ...ACCENTS,\n])\n\n/**\n * The font axis.\n *\n * The family is a selection, like the accent: `data-font` sits on the same element\n * and each option swaps the interface face. `space-grotesk` is the default because\n * it is the face the visual language was drawn against, and `system` is a\n * first-class option rather than a fallback — an application that wants the\n * platform's own face should be able to say so without losing the rest of the\n * system.\n */\nexport type FontOption = {\n  /** The `data-font` value. `space-grotesk` is the default and needs no attribute. */\n  id: string\n  label: string\n  description: string\n  /** Which of the two stacks this option sets. */\n  stack: 'sans' | 'mono' | 'both'\n}\n\nexport const fontOptions: readonly FontOption[] = Object.freeze([\n  {\n    id: 'space-grotesk',\n    label: 'Space Grotesk',\n    description: 'The default, and the face the visual language was drawn against.',\n    stack: 'both',\n  },\n  {\n    id: 'system',\n    label: 'System',\n    description: \"The platform's own face. What a terminal or editor usually wants.\",\n    stack: 'both',\n  },\n  {\n    id: 'geist',\n    label: 'Geist',\n    description: 'The face cortana already ships. Neutral and wide.',\n    stack: 'both',\n  },\n  {\n    id: 'geist-mono',\n    label: 'Geist Mono',\n    description: 'Monospace throughout, for someone who wants a uniform texture.',\n    stack: 'both',\n  },\n  {\n    id: 'jetbrains-mono',\n    label: 'JetBrains Mono',\n    description: 'Monospace throughout, with coding ligatures off.',\n    stack: 'both',\n  },\n])\n\n/** Every token, in gallery order. */\nexport const designTokens = {\n  color: colorTokens,\n  radius: radiusTokens,\n  typography: typographyTokens,\n  density: densityTokens,\n  elevation: elevationTokens,\n  motion: motionTokens,\n  zIndex: zIndexTokens,\n} as const\n\n/** Flat list, for completeness checks and for search. */\nexport const allTokens: TokenDefinition[] = Object.values(designTokens).flat()\n\n/**\n * Aliases that exist only to make a call site read better, and which therefore\n * have no gallery row of their own. Kept explicit so the completeness check\n * below can tell \"deliberately absent\" from \"forgotten\".\n */\nexport const undocumentedTokenAliases: string[] = ['radius']\n"],"mappings":"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"}
+{"version":3,"file":"tokens.js","names":[],"sources":["../../src/lib/tokens.ts"],"sourcesContent":["/**\n * The design system's token manifest.\n *\n * `theme.css` is the source of truth for token *values*. This file is the\n * source of truth for token *names and meaning* — what each one is for, and\n * which ones a theme may vary.\n *\n * It exists because a manifest that is only documentation rots. Two things read\n * it instead:\n *\n *   - the token galleries in Storybook, so the review surface shows every token\n *     rather than the ones an author remembered;\n *   - `tests/tokens.test.ts`, which parses `theme.css` and fails when a token\n *     is declared in one place and missing from the other.\n *\n * That pairing is what makes \"every token is documented and every documented\n * token exists\" a property the build enforces rather than a promise.\n */\n\nimport { ACCENTS } from '@adea-ai/themes'\n\nexport type TokenKind =\n  | 'color'\n  | 'dimension'\n  | 'font-family'\n  | 'number'\n  | 'duration'\n  | 'easing'\n  | 'shadow'\n  | 'text'\n\nexport type TokenDefinition = {\n  /** The custom property name, without the leading `--`. */\n  name: string\n  kind: TokenKind\n  /** One line: what this token is for. Shown in the gallery. */\n  description: string\n  /** True when the light and dark themes give it different values. */\n  themed?: boolean\n}\n\n/**\n * Colour roles, in the order they appear in a page: surfaces first, then text,\n * then the lines between them, then the semantic fills. The order is the\n * documentation — reading the gallery top to bottom walks the surface ladder.\n */\nexport const colorTokens: TokenDefinition[] = [\n  // Surfaces\n  {\n    name: 'background',\n    kind: 'color',\n    themed: true,\n    description: 'The canvas every panel sits on.',\n  },\n  {\n    name: 'foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Default body text on the canvas.',\n  },\n  {\n    name: 'card',\n    kind: 'color',\n    themed: true,\n    description: 'A panel or card raised one rung above the canvas.',\n  },\n  { name: 'card-foreground', kind: 'color', themed: true, description: 'Text on `card`.' },\n  {\n    name: 'popover',\n    kind: 'color',\n    themed: true,\n    description: 'A floating surface: dialog, menu, popover, tooltip-free.',\n  },\n  { name: 'popover-foreground', kind: 'color', themed: true, description: 'Text on `popover`.' },\n  {\n    name: 'surface',\n    kind: 'color',\n    themed: true,\n    description: 'Alias of `background`, for code that means \"a surface\" not \"the page\".',\n  },\n  {\n    name: 'surface-sunken',\n    kind: 'color',\n    themed: true,\n    description: 'A well: code blocks, inset lists, empty states.',\n  },\n  {\n    name: 'surface-raised',\n    kind: 'color',\n    themed: true,\n    description: 'Alias of `card`, for panels that sit on the canvas.',\n  },\n  {\n    name: 'surface-overlay',\n    kind: 'color',\n    themed: true,\n    description: 'Alias of `popover`, for floating layers.',\n  },\n  {\n    name: 'surface-hover',\n    kind: 'color',\n    themed: true,\n    description: 'The hover fill shared by rows, menu items and ghost controls.',\n  },\n  {\n    name: 'surface-active',\n    kind: 'color',\n    themed: true,\n    description: 'The pressed/selected fill, one rung past hover.',\n  },\n  {\n    name: 'chrome',\n    kind: 'color',\n    themed: true,\n    description: 'Window chrome: the top bar and its frosted fill.',\n  },\n  {\n    name: 'chrome-alpha',\n    kind: 'number',\n    themed: true,\n    description: 'Opacity of the chrome fill behind a blur.',\n  },\n\n  // The brand action\n  {\n    name: 'primary',\n    kind: 'color',\n    themed: true,\n    description: 'The Adea emerald. The one primary action in a view.',\n  },\n  {\n    name: 'primary-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Label on `primary`. Black in dark, white in light — the accent flips polarity.',\n  },\n  {\n    name: 'primary-hover',\n    kind: 'color',\n    themed: true,\n    description: 'Hover rung for a primary action.',\n  },\n  {\n    name: 'primary-subtle',\n    kind: 'color',\n    themed: true,\n    description: 'Tinted primary fill: selected rows, focus rings, subtle buttons.',\n  },\n\n  {\n    name: 'secondary',\n    kind: 'color',\n    themed: true,\n    description: 'A quieter filled surface for a secondary action.',\n  },\n  {\n    name: 'secondary-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Label on `secondary`.',\n  },\n  {\n    name: 'muted',\n    kind: 'color',\n    themed: true,\n    description: 'A neutral fill: skeletons, inert chips, table footers.',\n  },\n  {\n    name: 'muted-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'De-emphasised text. Measured to clear 4.5:1 on both `background` and `card`.',\n  },\n  {\n    name: 'accent',\n    kind: 'color',\n    themed: true,\n    description: \"shadcn's hover-surface accent. Not the brand colour — that is `primary`.\",\n  },\n  { name: 'accent-foreground', kind: 'color', themed: true, description: 'Text on `accent`.' },\n\n  // Status\n  {\n    name: 'destructive',\n    kind: 'color',\n    themed: true,\n    description: 'Irreversible or dangerous actions.',\n  },\n  {\n    name: 'destructive-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Label on `destructive`.',\n  },\n  {\n    name: 'destructive-subtle',\n    kind: 'color',\n    themed: true,\n    description: 'Tinted destructive fill: alert banners, invalid fields.',\n  },\n  { name: 'success', kind: 'color', themed: true, description: 'A completed or healthy state.' },\n  { name: 'success-foreground', kind: 'color', themed: true, description: 'Label on `success`.' },\n  { name: 'success-subtle', kind: 'color', themed: true, description: 'Tinted success fill.' },\n  {\n    name: 'warning',\n    kind: 'color',\n    themed: true,\n    description: 'Something needs attention but is not broken.',\n  },\n  { name: 'warning-foreground', kind: 'color', themed: true, description: 'Label on `warning`.' },\n  { name: 'warning-subtle', kind: 'color', themed: true, description: 'Tinted warning fill.' },\n  { name: 'info', kind: 'color', themed: true, description: 'Neutral information.' },\n  { name: 'info-foreground', kind: 'color', themed: true, description: 'Label on `info`.' },\n  { name: 'info-subtle', kind: 'color', themed: true, description: 'Tinted info fill.' },\n\n  // Lines\n  {\n    name: 'border',\n    kind: 'color',\n    themed: true,\n    description: 'Every hairline: panel edges, dividers, card outlines.',\n  },\n  {\n    name: 'input',\n    kind: 'color',\n    themed: true,\n    description:\n      'The edge of an editable control. A rung stronger than `border` so a field is findable.',\n  },\n  {\n    name: 'ring',\n    kind: 'color',\n    themed: true,\n    description: 'The focus ring. Always paired with `primary-subtle` as its glow.',\n  },\n\n  // Theme-invariant glass\n  {\n    name: 'scrim',\n    kind: 'color',\n    description: 'Dark glass for overlays and on-screen controls. Same in both themes.',\n  },\n  { name: 'scrim-foreground', kind: 'color', description: 'Text drawn on `scrim`.' },\n  { name: 'scrim-edge', kind: 'color', description: 'The hairline drawn on `scrim`.' },\n\n  // Diff and code\n  { name: 'diff-add', kind: 'color', themed: true, description: 'Background of an added line.' },\n  {\n    name: 'diff-add-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text of an added line.',\n  },\n  {\n    name: 'diff-delete',\n    kind: 'color',\n    themed: true,\n    description: 'Background of a removed line.',\n  },\n  {\n    name: 'diff-delete-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text of a removed line.',\n  },\n  { name: 'diff-hunk', kind: 'color', themed: true, description: 'Background of a hunk header.' },\n  {\n    name: 'diff-hunk-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text of a hunk header.',\n  },\n  {\n    name: 'diff-meta-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'File headers and line numbers in a diff.',\n  },\n\n  // Charts\n  {\n    name: 'chart-1',\n    kind: 'color',\n    themed: true,\n    description: 'Categorical series 1. The set is closed at six.',\n  },\n  { name: 'chart-2', kind: 'color', themed: true, description: 'Categorical series 2.' },\n  { name: 'chart-3', kind: 'color', themed: true, description: 'Categorical series 3.' },\n  { name: 'chart-4', kind: 'color', themed: true, description: 'Categorical series 4.' },\n  { name: 'chart-5', kind: 'color', themed: true, description: 'Categorical series 5.' },\n  { name: 'chart-6', kind: 'color', themed: true, description: 'Categorical series 6.' },\n\n  // Sidebar (the shadcn contract, kept whole)\n  {\n    name: 'sidebar',\n    kind: 'color',\n    themed: true,\n    description: 'The rail and sidebar surface, tinted against the canvas.',\n  },\n  {\n    name: 'sidebar-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Default text in the rail and sidebar.',\n  },\n  {\n    name: 'sidebar-primary',\n    kind: 'color',\n    themed: true,\n    description: 'The active destination in the rail.',\n  },\n  {\n    name: 'sidebar-primary-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text on the active rail destination.',\n  },\n  {\n    name: 'sidebar-accent',\n    kind: 'color',\n    themed: true,\n    description: 'Hover and selected fill for rail and sidebar rows.',\n  },\n  {\n    name: 'sidebar-accent-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Text on `sidebar-accent`.',\n  },\n  {\n    name: 'sidebar-border',\n    kind: 'color',\n    themed: true,\n    description: 'The rule between the rail and the canvas.',\n  },\n  { name: 'sidebar-ring', kind: 'color', themed: true, description: 'Focus ring inside the rail.' },\n  {\n    name: 'sidebar-muted-foreground',\n    kind: 'color',\n    themed: true,\n    description: 'Rail labels that are not the current destination.',\n  },\n]\n\nexport const radiusTokens: TokenDefinition[] = [\n  {\n    name: 'radius-lg',\n    kind: 'dimension',\n    description:\n      '10px — cards and panels. Also the knob: move this one value to re-round the whole system.',\n  },\n  { name: 'radius-sm', kind: 'dimension', description: '6px — badges, keyboard keys, menu items.' },\n  {\n    name: 'radius-md',\n    kind: 'dimension',\n    description: '8px — every control: buttons, inputs, selects.',\n  },\n  { name: 'radius-xl', kind: 'dimension', description: '14px — dialogs, menus, sheets.' },\n  { name: 'radius-2xl', kind: 'dimension', description: '18px — full-window surfaces and media.' },\n]\n\nexport const typographyTokens: TokenDefinition[] = [\n  {\n    name: 'font-sans',\n    kind: 'font-family',\n    description: 'The selected interface face. Space Grotesk unless the font axis says otherwise.',\n  },\n  {\n    name: 'font-mono',\n    kind: 'font-family',\n    description: 'The selected monospace face. Code, terminals, ids, paths.',\n  },\n  {\n    name: 'font-family-space-grotesk',\n    kind: 'font-family',\n    description: 'The interface default, and the face the visual language was drawn against.',\n  },\n  {\n    name: 'font-family-jetbrains-mono',\n    kind: 'font-family',\n    description: 'The monospace default. Code, terminals, diffs.',\n  },\n  {\n    name: 'font-family-geist',\n    kind: 'font-family',\n    description: 'An alternative interface face. cortana already ships it.',\n  },\n  {\n    name: 'font-family-geist-mono',\n    kind: 'font-family',\n    description: 'The monospace counterpart to Geist.',\n  },\n  {\n    name: 'font-family-system',\n    kind: 'font-family',\n    description: \"The platform's own interface face. First-class, not a fallback.\",\n  },\n  {\n    name: 'font-family-system-mono',\n    kind: 'font-family',\n    description: \"The platform's own monospace face.\",\n  },\n  {\n    name: 'ui-tracking',\n    kind: 'text',\n    description:\n      'Letter spacing for measured chrome. `normal` on a proportional face, tightened when the UI font is monospace — which is roughly 20% wider at the same size.',\n  },\n  {\n    name: 'ui-word-spacing',\n    kind: 'text',\n    description:\n      \"Word spacing for measured chrome. Mono's space is a full advance-width cell, so a two-word label reads as two floating words without this.\",\n  },\n  {\n    name: 'text-2xs',\n    kind: 'text',\n    description: '11px — the smallest label the system permits: kbd keys, status bar.',\n  },\n  { name: 'text-xs', kind: 'text', description: '12px — metadata, badges, secondary rows.' },\n  {\n    name: 'text-sm',\n    kind: 'text',\n    description: '14px — the interface default. Body copy, labels, controls.',\n  },\n  { name: 'text-base', kind: 'text', description: '16px — card titles and dialog titles.' },\n  { name: 'text-lg', kind: 'text', description: '18px — a section heading inside a page.' },\n  { name: 'text-xl', kind: 'text', description: '20px — a page title.' },\n  { name: 'text-2xl', kind: 'text', description: '24px — a display figure.' },\n  {\n    name: 'text-3xl',\n    kind: 'text',\n    description: '30px — the largest size in the system. Reserved for an empty-state headline.',\n  },\n]\n\n/** Height tokens also size both axes of icon controls through Tailwind's --size\n * namespace. Padding has its own --spacing mapping. Nominal pixel descriptions\n * use a 16px rem; rendered dimensions follow the consumer's root font size. */\nexport const densityTokens: TokenDefinition[] = [\n  { name: 'control-height-2xs', kind: 'dimension', description: '20px — an inline chip control.' },\n  { name: 'control-height-xs', kind: 'dimension', description: '24px — a dense table row action.' },\n  { name: 'control-height-sm', kind: 'dimension', description: '28px — the toolbar default.' },\n  {\n    name: 'control-height-md',\n    kind: 'dimension',\n    description: '32px — the form default. Button and Input are this size unless told otherwise.',\n  },\n  { name: 'control-height-lg', kind: 'dimension', description: '36px — a primary form action.' },\n  {\n    name: 'control-height-xl',\n    kind: 'dimension',\n    description: '40px — a hero control in an empty state.',\n  },\n  {\n    name: 'control-padding-2xs',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 20px control.',\n  },\n  {\n    name: 'control-padding-xs',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 24px control.',\n  },\n  {\n    name: 'control-padding-sm',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 28px control.',\n  },\n  {\n    name: 'control-padding-md',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 32px control.',\n  },\n  {\n    name: 'control-padding-lg',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 36px control.',\n  },\n  {\n    name: 'control-padding-xl',\n    kind: 'dimension',\n    description: 'Inline padding that pairs with the 40px control.',\n  },\n  { name: 'row-height-sm', kind: 'dimension', description: '28px — a dense list row.' },\n  { name: 'row-height-md', kind: 'dimension', description: '32px — the default list row.' },\n  { name: 'row-height-lg', kind: 'dimension', description: '36px — a two-line list row.' },\n  { name: 'rail-width', kind: 'dimension', description: '58px — the icon-only rail.' },\n  { name: 'rail-width-expanded', kind: 'dimension', description: '236px — the labelled rail.' },\n  {\n    name: 'rail-item-height',\n    kind: 'dimension',\n    description: '36px — a rail or sidebar destination.',\n  },\n  {\n    name: 'sidebar-width',\n    kind: 'dimension',\n    description: '256px — the secondary navigation column.',\n  },\n  {\n    name: 'sidebar-width-compact',\n    kind: 'dimension',\n    description: '48px — the collapsed secondary column.',\n  },\n  { name: 'topbar-height', kind: 'dimension', description: '48px — the window title row.' },\n  { name: 'statusbar-height', kind: 'dimension', description: '28px — the bottom readout strip.' },\n]\n\nexport const elevationTokens: TokenDefinition[] = [\n  {\n    name: 'shadow-2xs',\n    kind: 'shadow',\n    themed: true,\n    description: 'Barely there: a chip resting on a card.',\n  },\n  {\n    name: 'shadow-xs',\n    kind: 'shadow',\n    themed: true,\n    description: 'A card or panel on the canvas.',\n  },\n  {\n    name: 'shadow-sm',\n    kind: 'shadow',\n    themed: true,\n    description: 'A control that lifts: a pressed toggle, a thumb.',\n  },\n  { name: 'shadow-md', kind: 'shadow', themed: true, description: 'A menu or popover.' },\n  { name: 'shadow-lg', kind: 'shadow', themed: true, description: 'A dialog or sheet.' },\n  {\n    name: 'shadow-xl',\n    kind: 'shadow',\n    themed: true,\n    description: 'The command palette, above everything.',\n  },\n]\n\nexport const motionTokens: TokenDefinition[] = [\n  {\n    name: 'duration-fast',\n    kind: 'duration',\n    description: '120ms — a state change the user is already watching.',\n  },\n  { name: 'duration-normal', kind: 'duration', description: '200ms — an entrance.' },\n  { name: 'duration-slow', kind: 'duration', description: '320ms — a layout settle.' },\n  {\n    name: 'ease-out',\n    kind: 'easing',\n    description: 'A fast start and a long settle. Reads as decisive rather than floaty.',\n  },\n  {\n    name: 'ease-in-out',\n    kind: 'easing',\n    description: 'For a loop that has no start or end, such as a shimmer.',\n  },\n]\n\nexport const zIndexTokens: TokenDefinition[] = [\n  { name: 'z-base', kind: 'number', description: 'In flow, at the document order.' },\n  {\n    name: 'z-docked',\n    kind: 'number',\n    description: 'A sticky table header standing above its own scroll body.',\n  },\n  { name: 'z-sticky', kind: 'number', description: 'The top bar and any other pinned chrome.' },\n  { name: 'z-drawer', kind: 'number', description: 'A drawer, below a modal dialog.' },\n  { name: 'z-dialog', kind: 'number', description: 'A modal dialog and its scrim.' },\n  {\n    name: 'z-menu',\n    kind: 'number',\n    description: 'Menus, popovers and comboboxes. Above dialogs, because a dialog can contain one.',\n  },\n  {\n    name: 'z-tooltip',\n    kind: 'number',\n    description: 'Tooltips. Above menus, because a menu item can carry one.',\n  },\n  {\n    name: 'z-toast',\n    kind: 'number',\n    description: 'Notifications. Above everything, so they are never hidden by a dialog.',\n  },\n]\n\n/**\n * The accent axis.\n *\n * adea's accent presets, as a selection rather than a constant. `theme` is the\n * default and means \"the variant's own primary\" — monochrome in adea's palette —\n * and each named preset overrides the interactive roles through the\n * `[data-accent]` blocks in `theme.css`.\n *\n * These are the same six presets `accentPresets` exports in adea's own\n * `appearance.ts`, and the values match. A consumer's appearance picker and the\n * workshop's theme toolbar read this one list, so the two cannot disagree about\n * what a preset is called or what colour it is.\n */\nexport type AccentPreset = {\n  /** The `data-accent` value. `theme` is the variant's own primary. */\n  id: string\n  label: string\n  /** What the preset is for, in the gallery and in a picker. */\n  description: string\n  /** The accent as it appears in the light theme. Absent for `theme`. */\n  light?: string\n  /** The accent as it appears in the dark theme. Absent for `theme`. */\n  dark?: string\n}\n\nexport const accentPresets: readonly AccentPreset[] = Object.freeze([\n  {\n    id: 'theme',\n    label: 'Theme',\n    description:\n      \"The variant's own primary. Neutral in adea's palette, so the interface stays monochrome.\",\n  },\n  ...ACCENTS,\n])\n\n/**\n * The font axis.\n *\n * The family is a selection, like the accent: `data-font` sits on the same element\n * and each option swaps the interface face. `space-grotesk` is the default because\n * it is the face the visual language was drawn against, and `system` is a\n * first-class option rather than a fallback — an application that wants the\n * platform's own face should be able to say so without losing the rest of the\n * system.\n */\nexport type FontOption = {\n  /** The `data-font` value. `space-grotesk` is the default and needs no attribute. */\n  id: string\n  label: string\n  description: string\n  /** Which of the two stacks this option sets. */\n  stack: 'sans' | 'mono' | 'both'\n}\n\nexport const fontOptions: readonly FontOption[] = Object.freeze([\n  {\n    id: 'space-grotesk',\n    label: 'Space Grotesk',\n    description: 'The default, and the face the visual language was drawn against.',\n    stack: 'both',\n  },\n  {\n    id: 'system',\n    label: 'System',\n    description: \"The platform's own face. What a terminal or editor usually wants.\",\n    stack: 'both',\n  },\n  {\n    id: 'geist',\n    label: 'Geist',\n    description: 'The face cortana already ships. Neutral and wide.',\n    stack: 'both',\n  },\n  {\n    id: 'geist-mono',\n    label: 'Geist Mono',\n    description: 'Monospace throughout, for someone who wants a uniform texture.',\n    stack: 'both',\n  },\n  {\n    id: 'jetbrains-mono',\n    label: 'JetBrains Mono',\n    description: 'Monospace throughout, with coding ligatures off.',\n    stack: 'both',\n  },\n])\n\n/** Every token, in gallery order. */\nexport const designTokens = {\n  color: colorTokens,\n  radius: radiusTokens,\n  typography: typographyTokens,\n  density: densityTokens,\n  elevation: elevationTokens,\n  motion: motionTokens,\n  zIndex: zIndexTokens,\n} as const\n\n/** Flat list, for completeness checks and for search. */\nexport const allTokens: TokenDefinition[] = Object.values(designTokens).flat()\n\n/**\n * Aliases that exist only to make a call site read better, and which therefore\n * have no gallery row of their own. Kept explicit so the completeness check\n * below can tell \"deliberately absent\" from \"forgotten\".\n */\nexport const undocumentedTokenAliases: string[] = ['radius']\n"],"mappings":"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"}

package/dist/r/conversation.json

@@ -8,13 +8,20 @@
   ],
   "registryDependencies": [
     "@adea-ai/ui/button",
+    "@adea-ai/ui/button-group",
     "@adea-ai/ui/code-block",
+    "@adea-ai/ui/dropdown-menu",
     "@adea-ai/ui/kbd",
     "@adea-ai/ui/spinner",
     "@adea-ai/ui/textarea",
     "lib"
   ],
   "files": [
+    {
+      "path": "src/components/conversation/busy-send-button.tsx",
+      "type": "registry:ui",
+      "target": "components/conversation/busy-send-button.tsx"
+    },
     {
       "path": "src/components/conversation/conversation-avatar.tsx",
       "type": "registry:ui",
@@ -45,6 +52,16 @@
       "type": "registry:ui",
       "target": "components/conversation/message-row.tsx"
     },
+    {
+      "path": "src/components/conversation/scroll-follow-core.ts",
+      "type": "registry:ui",
+      "target": "components/conversation/scroll-follow-core.ts"
+    },
+    {
+      "path": "src/components/conversation/scroll-follow.ts",
+      "type": "registry:ui",
+      "target": "components/conversation/scroll-follow.ts"
+    },
     {
       "path": "src/components/conversation/thread-panel.tsx",
       "type": "registry:ui",

package/dist/r/registry.json

@@ -1781,13 +1781,20 @@
       ],
       "registryDependencies": [
         "@adea-ai/ui/button",
+        "@adea-ai/ui/button-group",
         "@adea-ai/ui/code-block",
+        "@adea-ai/ui/dropdown-menu",
         "@adea-ai/ui/kbd",
         "@adea-ai/ui/spinner",
         "@adea-ai/ui/textarea",
         "lib"
       ],
       "files": [
+        {
+          "path": "src/components/conversation/busy-send-button.tsx",
+          "type": "registry:ui",
+          "target": "components/conversation/busy-send-button.tsx"
+        },
         {
           "path": "src/components/conversation/conversation-avatar.tsx",
           "type": "registry:ui",
@@ -1818,6 +1825,16 @@
           "type": "registry:ui",
           "target": "components/conversation/message-row.tsx"
         },
+        {
+          "path": "src/components/conversation/scroll-follow-core.ts",
+          "type": "registry:ui",
+          "target": "components/conversation/scroll-follow-core.ts"
+        },
+        {
+          "path": "src/components/conversation/scroll-follow.ts",
+          "type": "registry:ui",
+          "target": "components/conversation/scroll-follow.ts"
+        },
         {
           "path": "src/components/conversation/thread-panel.tsx",
           "type": "registry:ui",

package/dist/r/src/components/conversation/busy-send-button.tsx

@@ -0,0 +1,161 @@
+/*
+ * Substantially translated from KiroCrew website/src/components/BusySendButton.tsx
+ * at 283e136c0f902e965a535a7c9548c57c7504fed0.
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Licensed under Apache-2.0; see LICENSE and NOTICE.
+ */
+import { ArrowUpFromLine, ChevronDown, Target } from 'lucide-solid'
+import { For, Show, createUniqueId } from 'solid-js'
+import { Button } from '../ui/button/button'
+import { ButtonGroup } from '../ui/button-group/button-group'
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuRadioGroup,
+  DropdownMenuRadioItem,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from '../ui/dropdown-menu/dropdown-menu'
+
+export type BusySendMode = 'steer' | 'queue'
+export type BusySendButtonProps = {
+  mode: BusySendMode
+  onModeChange: (mode: BusySendMode) => void
+  /** Executes only the selected action. The host owns the draft and command. */
+  onFire: () => void
+  /** An empty draft or pending delivery disables fire, but not choosing a mode. */
+  disabled?: boolean
+  /** Disable mode selection when the host has no authority to change preferences. */
+  selectionDisabled?: boolean
+  /** Host capability/authority failures: unavailable rows remain visible. */
+  unavailable?: Partial<Record<BusySendMode, string>>
+  /** Supply only when the host implements this alternate-action keyboard chord. */
+  alternateActionHint?: string
+}
+
+const modes: BusySendMode[] = ['steer', 'queue']
+const labels = { steer: 'Steer', queue: 'Queue' }
+const descriptions = {
+  steer: 'Act on this right away',
+  queue: 'Run after the current work finishes',
+}
+
+/**
+ * Kiro's split action/menu composition, with app-owned mode and availability.
+ * Picking a mode never fires it. Persistence, migration and same-session
+ * broadcasts belong to the consumer; this component has no storage or global listeners.
+ * Kobalte replaces the donor manual portal/positioning and document listeners:
+ * arrows wrap and selection/Escape return focus. Kobalte 0.13.14 prevents Tab
+ * without moving focus, so a menu-scoped translation of the donor Tab cycle
+ * fills that gap. It discovers enabled radio rows only; no document trap.
+ * No force-reset timer or runtime authority is translated from the adjacent
+ * donor stop flow.
+ */
+export function BusySendButton(props: BusySendButtonProps) {
+  const reasonId = createUniqueId()
+  const reason = () => props.unavailable?.[props.mode]
+  const variant = () => (props.mode === 'steer' ? ('default' as const) : ('secondary' as const))
+  return (
+    <div data-slot="busy-send-button" class="flex w-fit flex-col gap-1">
+      <DropdownMenu placement="top-end" modal={false}>
+        <ButtonGroup label="Send while busy">
+          <Button
+            type="button"
+            size="icon-sm"
+            variant={variant()}
+            aria-label={props.mode === 'steer' ? 'Steer' : 'Queue message'}
+            aria-describedby={reason() ? reasonId : undefined}
+            disabled={props.disabled || !!reason()}
+            onClick={() => {
+              if (!props.disabled && !reason()) props.onFire()
+            }}
+          >
+            <Show when={props.mode === 'steer'} fallback={<ArrowUpFromLine />}>
+              <Target />
+            </Show>
+          </Button>
+          <DropdownMenuTrigger
+            as={Button}
+            type="button"
+            size="icon-sm"
+            variant={variant()}
+            aria-label="Send options"
+            disabled={props.selectionDisabled}
+          >
+            <ChevronDown />
+          </DropdownMenuTrigger>
+        </ButtonGroup>
+        <DropdownMenuContent hideArrow>
+          <DropdownMenuRadioGroup
+            on:keydown={(event: KeyboardEvent) => {
+              if (
+                event.key !== 'Tab' ||
+                event.isComposing ||
+                !(event.currentTarget instanceof HTMLElement)
+              )
+                return
+              const rows = Array.from(
+                event.currentTarget.querySelectorAll<HTMLElement>(
+                  '[role="menuitemradio"]:not([aria-disabled="true"])'
+                )
+              )
+              if (!rows.length) return
+              event.preventDefault()
+              event.stopPropagation()
+              const active = document.activeElement
+              const index = active instanceof HTMLElement ? rows.indexOf(active) : -1
+              const next =
+                index < 0
+                  ? event.shiftKey
+                    ? rows.length - 1
+                    : 0
+                  : (index + (event.shiftKey ? -1 : 1) + rows.length) % rows.length
+              rows[next]?.focus()
+            }}
+            value={props.mode}
+            onChange={(value) => {
+              if (
+                (value === 'steer' || value === 'queue') &&
+                !props.selectionDisabled &&
+                !props.unavailable?.[value]
+              )
+                props.onModeChange(value)
+            }}
+          >
+            <For each={modes}>
+              {(mode) => (
+                <DropdownMenuRadioItem
+                  value={mode}
+                  closeOnSelect
+                  disabled={props.selectionDisabled || !!props.unavailable?.[mode]}
+                >
+                  <Show when={mode === 'steer'} fallback={<ArrowUpFromLine />}>
+                    <Target />
+                  </Show>
+                  <div class="flex min-w-0 flex-col gap-1">
+                    <span>{labels[mode]}</span>
+                    <span class="text-muted-foreground text-xs">{descriptions[mode]}</span>
+                    <Show when={props.unavailable?.[mode]}>
+                      {(message) => <span class="text-muted-foreground text-xs">{message()}</span>}
+                    </Show>
+                  </div>
+                </DropdownMenuRadioItem>
+              )}
+            </For>
+          </DropdownMenuRadioGroup>
+          <Show when={props.alternateActionHint}>
+            <DropdownMenuSeparator />
+            <p class="text-muted-foreground px-2 py-1 text-xs">{props.alternateActionHint}</p>
+          </Show>
+        </DropdownMenuContent>
+      </DropdownMenu>
+      <Show when={reason()}>
+        {(message) => (
+          <p id={reasonId} class="text-muted-foreground text-xs">
+            {message()}
+          </p>
+        )}
+      </Show>
+    </div>
+  )
+}

package/dist/r/src/components/conversation/conversation-surface.tsx

@@ -1,8 +1,9 @@
 import { ArrowDown } from 'lucide-solid'
 import type { ComponentProps, JSX } from 'solid-js'
-import { Show, createSignal, onCleanup, splitProps } from 'solid-js'
+import { Show, splitProps } from 'solid-js'
 import { cn } from '../../lib/utils'
 import { Button } from '../ui/button/button'
+import { createScrollFollow } from './scroll-follow'
 
 /**
  * ConversationSurface.
@@ -15,7 +16,7 @@ import { Button } from '../ui/button/button'
  *     to the end by an arriving message, and that is the single most common way a
  *     chat surface is made unusable.
  *   - **Offer a way back.** Once the reader is not at the bottom, a control appears
- *     that returns them and says how much they have missed.
+ *     that returns them. Pixel distance cannot prove an unread message count.
  *   - **`overscroll-contain`.** The transcript scrolls to its end and stops, rather
  *     than dragging the pane behind it — which in a desktop shell means the whole
  *     window moves.
@@ -23,48 +24,42 @@ import { Button } from '../ui/button/button'
 export type ConversationSurfaceProps = ComponentProps<'div'> & {
   /** How far from the bottom still counts as "at the bottom", in px. */
   threshold?: number
+  /** Disable automatic positioning while the host owns scroll restoration. */
+  follow?: boolean
+  /** Optional conversation identity: changing it re-arms follow at the bottom. */
+  resetKey?: string
   /** Rendered above the transcript when there is nothing in it. */
   empty?: JSX.Element
   /** A header that scrolls with the transcript, e.g. a day divider or a banner. */
   header?: JSX.Element
 }
 
-/** How far the reader is from the end of the transcript, in px. */
-function distanceFromBottom(element: HTMLDivElement): number {
-  return element.scrollHeight - element.scrollTop - element.clientHeight
-}
-
 export function ConversationSurface(props: ConversationSurfaceProps) {
-  const [local, rest] = splitProps(props, ['class', 'threshold', 'empty', 'header', 'children'])
-
-  const [atBottom, setAtBottom] = createSignal(true)
-  const [missed, setMissed] = createSignal(0)
-  let scroller: HTMLDivElement | undefined
-
-  const onScroll = () => {
-    if (!scroller) return
-    const distance = distanceFromBottom(scroller)
-    const threshold = local.threshold ?? 80
-    setAtBottom(distance <= threshold)
-    setMissed(distance <= threshold ? 0 : Math.round(distance / 96))
-  }
-
-  const jumpToLatest = () => {
-    scroller?.scrollTo({ top: scroller.scrollHeight, behavior: 'smooth' })
-    setAtBottom(true)
-    setMissed(0)
-  }
-
-  // An arriving message while the reader is at the bottom should follow it. While
-  // they are not, it must not.
-  const observer = () => {
-    if (!scroller) return
-    const mutation = new MutationObserver(() => {
-      if (atBottom()) scroller?.scrollTo({ top: scroller.scrollHeight })
-      else onScroll()
-    })
-    mutation.observe(scroller, { childList: true, subtree: true })
-    onCleanup(() => mutation.disconnect())
+  const [local, rest] = splitProps(props, [
+    'class',
+    'threshold',
+    'follow',
+    'resetKey',
+    'empty',
+    'header',
+    'children',
+    'onScroll',
+    'ref',
+    'tabindex',
+  ])
+  // Kobalte provides the control's semantics; transcript follow is a native
+  // geometry contract. KiroCrew's plain-scroller controller handles streaming,
+  // content collapse and pane resizing without treating them as user consent.
+  const follow = createScrollFollow({
+    enabled: () => local.follow !== false,
+    resetKey: () => local.resetKey,
+    threshold: () => local.threshold ?? 80,
+  })
+  const onScroll: JSX.EventHandlerUnion<HTMLDivElement, Event> = (event) => {
+    follow.onScroll()
+    const handler = local.onScroll
+    if (typeof handler === 'function') handler(event)
+    else if (handler) handler[0](handler[1], event)
   }
 
   return (
@@ -74,31 +69,33 @@ export function ConversationSurface(props: ConversationSurfaceProps) {
     >
       <div
         ref={(element) => {
-          scroller = element
-          observer()
+          follow.bindScroller(element)
+          if (typeof local.ref === 'function') local.ref(element)
         }}
         onScroll={onScroll}
+        tabindex={local.tabindex ?? 0}
         class="min-h-0 flex-1 overflow-y-auto overscroll-contain"
         {...rest}
       >
-        <Show when={local.header}>{local.header}</Show>
-        <Show when={local.children} fallback={<div class="p-4">{local.empty}</div>}>
-          {local.children}
-        </Show>
+        <div ref={follow.bindContent} data-slot="conversation-content">
+          <Show when={local.header}>{local.header}</Show>
+          <Show when={local.children} fallback={<div class="p-4">{local.empty}</div>}>
+            {local.children}
+          </Show>
+        </div>
       </div>
 
-      <Show when={!atBottom()}>
+      <Show when={!follow.atBottom()}>
         <div class="pointer-events-none absolute inset-x-0 bottom-3 flex justify-center">
           <Button
+            type="button"
             size="sm"
             variant="secondary"
             class="pointer-events-auto gap-1.5 shadow-md"
-            onClick={jumpToLatest}
+            onClick={follow.jump}
           >
             <ArrowDown />
-            <Show when={missed() > 0} fallback={<>Jump to latest</>}>
-              {missed()} new
-            </Show>
+            Jump to latest
           </Button>
         </div>
       </Show>

package/dist/r/src/components/conversation/index.ts

@@ -1,3 +1,4 @@
+export { BusySendButton, type BusySendMode, type BusySendButtonProps } from './busy-send-button'
 export {
   ConversationAvatar,
   type ConversationAvatarKind,