@cueplusplus/ui 0.3.0 → 0.5.0

package/manifest/components/terminal-block.json

@@ -0,0 +1,91 @@
+{
+  "name": "TerminalBlock",
+  "slug": "terminal-block",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "Command output that streams line by line and ends with an exit status.",
+  "props": [
+    {
+      "name": "command",
+      "type": "string",
+      "required": true,
+      "defaultValue": null,
+      "description": "Command string shown in the terminal header."
+    },
+    {
+      "name": "lines",
+      "type": "readonly string[]",
+      "required": true,
+      "defaultValue": null,
+      "description": "Output lines available to stream into the body."
+    },
+    {
+      "name": "visibleCount",
+      "type": "number",
+      "required": true,
+      "defaultValue": null,
+      "description": "How many output lines from the start are currently shown."
+    },
+    {
+      "name": "done",
+      "type": "boolean",
+      "required": true,
+      "defaultValue": null,
+      "description": "When true the header shows exit 0; otherwise a spinner keeps spinning."
+    },
+    {
+      "name": "variant",
+      "type": "\"paper\" | \"ink\"",
+      "required": false,
+      "defaultValue": "paper",
+      "description": "paper matches the surrounding surfaces; ink renders the classic dark terminal slab."
+    }
+  ],
+  "typeReferences": [
+    "Omit<\n  ComponentProps<\"div\">,\n  \"children\" | \"command\" | \"lines\" | \"visibleCount\" | \"done\" | \"variant\"\n> & {\n  /** Command string shown in the terminal header. */\n  command: string;\n  /** Output lines available to stream into the body. */\n  lines: readonly string[];\n  /** How many output lines from the start are currently shown. */\n  visibleCount: number;\n  /** When true the header shows exit 0; otherwise a spinner keeps spinning. */\n  done: boolean;\n  /** paper matches the surrounding surfaces; ink renders the classic dark terminal slab. */\n  variant?: \"paper\" | \"ink\";\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-font-mono",
+    "--cue-ok",
+    "--cue-radius-overlay",
+    "--cue-stream",
+    "--cue-sunken",
+    "--cue-text-ui"
+  ],
+  "summary": "Command output that streams line by line and ends with an exit status.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { TerminalBlock } from \"@cueplusplus/ui/elements\";\n\n<TerminalBlock\n  command=\"pnpm test\"\n  lines={[\"PASS  thread.test.ts\", \"Tests: 2 passed\"]}\n  visibleCount={2}\n  done\n/>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/terminal-block",
+  "mdUrl": "/docs/components/terminal-block.md",
+  "jsonUrl": "/r/components/terminal-block.json",
+  "specimens": [
+    {
+      "title": "TerminalBlock",
+      "group": "elements",
+      "components": [
+        "TerminalBlock"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"paper · streaming\" wide>\n    <TerminalBlock\n      command=\"cue patch --universe 3 --profile 'Source Four 26'\"\n      lines={OUTPUT}\n      visibleCount={2}\n      done={false}\n    />\n  </Specimen>\n  <Specimen label=\"ink · exit 0\" wide>\n    <TerminalBlock\n      command=\"cue patch --universe 3 --profile 'Source Four 26'\"\n      lines={OUTPUT}\n      visibleCount={OUTPUT.length}\n      done\n      variant=\"ink\"\n    />\n  </Specimen>\n</Specimens>",
+      "note": "Command output as it arrives: `visibleCount` says how many of the lines have landed, so the caller owns the clock and the block owns nothing. Two grounds — paper sits in the transcript, ink is the recessed slab a terminal is expected to be.",
+      "interaction": "none. It is a transcript of something that already happened."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/theme-provider.json

@@ -9,14 +9,14 @@
   "props": [
     {
       "name": "theme",
-      "type": "\"terminal\" | \"signal\" | \"cue\" | \"venu\" | \"hivehub\" | \"dusk\" | \"luma\" | \"snuffle\" | \"requestport\" | \"quotamate\"",
+      "type": "\"terminal\" | \"cue\" | \"signal\" | \"venu\" | \"hivehub\" | \"dusk\" | \"luma\" | \"snuffle\" | \"requestport\" | \"quotamate\"",
       "required": false,
       "defaultValue": "cue",
       "description": "Initial theme preset. Defaults to `\"cue\"`. Changing it after mount adopts the new value."
     },
     {
       "name": "density",
-      "type": "\"ultra-compact\" | \"compact\" | \"normal\" | \"large\" | \"ultra-large\"",
+      "type": "\"normal\" | \"large\" | \"compact\" | \"ultra-compact\" | \"ultra-large\"",
       "required": false,
       "defaultValue": "compact",
       "description": "Initial density level. Defaults to `\"compact\"`."

package/manifest/components/thinking-indicator.json

@@ -0,0 +1,63 @@
+{
+  "name": "ThinkingIndicator",
+  "slug": "thinking-indicator",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [],
+  "clientOnly": true,
+  "description": "A live status line that names what the agent is doing right now, with elapsed time.",
+  "props": [
+    {
+      "name": "label",
+      "type": "string",
+      "required": true,
+      "defaultValue": null,
+      "description": "What the agent is doing right now. Swapping it replays the entrance animation."
+    },
+    {
+      "name": "elapsed",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "Elapsed time rendered in mono next to the label. Omit to hide the timer."
+    }
+  ],
+  "typeReferences": [
+    "Omit<ComponentProps<\"div\">, \"children\" | \"label\" | \"elapsed\"> & {\n  /** What the agent is doing right now. Swapping it replays the entrance animation. */\n  label: string;\n  /** Elapsed time rendered in mono next to the label. Omit to hide the timer. */\n  elapsed?: string;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-stream",
+    "--cue-text-body"
+  ],
+  "summary": "A live status line that names what the agent is doing right now, with elapsed time.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { ThinkingIndicator } from \"@cueplusplus/ui/elements\";\n\n<ThinkingIndicator label=\"Reading thread.tsx\" elapsed=\"12s\" />",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/thinking-indicator",
+  "mdUrl": "/docs/components/thinking-indicator.md",
+  "jsonUrl": "/r/components/thinking-indicator.json",
+  "specimens": [
+    {
+      "title": "ThinkingIndicator",
+      "group": "elements-thread",
+      "components": [
+        "ThinkingIndicator"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"reading\" wide>\n    <ThinkingIndicator label=\"Reading front-truss.gdtf\" elapsed=\"0:04\" />\n  </Specimen>\n  <Specimen label=\"patching, no clock\" wide>\n    <ThinkingIndicator label=\"Patching universe 3\" />\n  </Specimen>\n</Specimens>",
+      "note": "One line that says what is happening right now, with the elapsed clock beside it. The label is keyed, so replacing it re-runs the entrance and the change reads as a change rather than as a re-render.",
+      "interaction": "none. It is a status line, not a control — the dot pulses and the label sweeps, and both stop for a reduced-motion reader."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/thread-list.json

@@ -0,0 +1,76 @@
+{
+  "name": "ThreadList",
+  "slug": "thread-list",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "Conversation history with unread marks and actions that wait for hover.",
+  "props": [
+    {
+      "name": "threads",
+      "type": "readonly ThreadItem[]",
+      "required": true,
+      "defaultValue": null,
+      "description": "Conversation rows with title, time, and optional unread mark."
+    },
+    {
+      "name": "activeIndex",
+      "type": "number",
+      "required": true,
+      "defaultValue": null,
+      "description": "Index of the currently selected thread. An index outside the list selects nothing."
+    },
+    {
+      "name": "onActiveIndexChange",
+      "type": "((index: number) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called when the user clicks a thread row."
+    }
+  ],
+  "typeReferences": [
+    "Omit<\n  ComponentProps<\"div\">,\n  \"children\" | \"threads\" | \"activeIndex\" | \"onActiveIndexChange\"\n> & {\n  /** Conversation rows with title, time, and optional unread mark. */\n  threads: readonly ThreadItem[];\n  /** Index of the currently selected thread. An index outside the list selects nothing. */\n  activeIndex: number;\n  /** Called when the user clicks a thread row. */\n  onActiveIndexChange?: (index: number) => void;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-radius-surface",
+    "--cue-stream",
+    "--cue-surface-1",
+    "--cue-surface-2",
+    "--cue-text-body"
+  ],
+  "summary": "Conversation history with unread marks and actions that wait for hover.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { ThreadList } from \"@cueplusplus/ui/elements\";\n\n<ThreadList\n  threads={[\n    { title: \"Composer polish\", time: \"2m\", unread: true },\n    { title: \"Runtime migration\", time: \"1h\" },\n  ]}\n  activeIndex={activeIndex}\n  onActiveIndexChange={setActiveIndex}\n/>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/thread-list",
+  "mdUrl": "/docs/components/thread-list.md",
+  "jsonUrl": "/r/components/thread-list.json",
+  "specimens": [
+    {
+      "title": "ThreadList",
+      "group": "elements-composer",
+      "components": [
+        "ThreadList"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"one open\">\n    <ThreadList threads={THREADS} activeIndex={thread} onActiveIndexChange={setThread} />\n  </Specimen>\n  <Specimen label=\"nothing open\">\n    <ThreadList threads={THREADS} activeIndex={-1} />\n  </Specimen>\n</Specimens>",
+      "note": "Conversation history at its smallest: a title, how long ago, and an unread dot. The row's actions replace the timestamp on hover rather than sitting beside it, which is what keeps a 240px rail from becoming a toolbar — and the active row never shows an unread mark, because reading it is what cleared it.",
+      "interaction": "the selected row carries `aria-current`; the rename and delete affordances appear on hover in the space the time was using, so nothing moves when they arrive."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/thread-search.json

@@ -0,0 +1,90 @@
+{
+  "name": "ThreadSearch",
+  "slug": "thread-search",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "History you can actually get back into: pinned first, then grouped by when.",
+  "props": [
+    {
+      "name": "threads",
+      "type": "readonly SearchableThread[]",
+      "required": true,
+      "defaultValue": null,
+      "description": "All threads. Filtering matches title and preview together."
+    },
+    {
+      "name": "query",
+      "type": "string",
+      "required": true,
+      "defaultValue": null,
+      "description": "Current search text."
+    },
+    {
+      "name": "activeId",
+      "type": "string",
+      "required": true,
+      "defaultValue": null,
+      "description": "Which thread is open."
+    },
+    {
+      "name": "onQueryChange",
+      "type": "((query: string) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called as the search is typed."
+    },
+    {
+      "name": "onSelect",
+      "type": "((id: string) => void)",
+      "required": false,
+      "defaultValue": null,
+      "description": "Called when a thread is opened."
+    }
+  ],
+  "typeReferences": [
+    "Omit<\n  ComponentProps<\"div\">,\n  \"children\" | \"threads\" | \"query\" | \"activeId\" | \"onQueryChange\" | \"onSelect\"\n> & {\n  /** All threads. Filtering matches title and preview together. */\n  threads: readonly SearchableThread[];\n  /** Current search text. */\n  query: string;\n  /** Which thread is open. */\n  activeId: string;\n  /** Called as the search is typed. */\n  onQueryChange?: (query: string) => void;\n  /** Called when a thread is opened. */\n  onSelect?: (id: string) => void;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-radius-overlay",
+    "--cue-radius-surface",
+    "--cue-surface-1",
+    "--cue-text-body",
+    "--cue-text-ui"
+  ],
+  "summary": "History you can actually get back into: pinned first, then grouped by when.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { ThreadSearch } from \"@cueplusplus/ui/elements\";\n\n<ThreadSearch\n  threads={threads}\n  query={query}\n  activeId={activeId}\n  onQueryChange={setQuery}\n  onSelect={setActiveId}\n/>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/thread-search",
+  "mdUrl": "/docs/components/thread-search.md",
+  "jsonUrl": "/r/components/thread-search.json",
+  "specimens": [
+    {
+      "title": "ThreadSearch",
+      "group": "elements-composer",
+      "components": [
+        "ThreadSearch"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"grouped\" wide>\n    <ThreadSearch\n      threads={SEARCHABLE}\n      query={threadQuery}\n      activeId={threadId}\n      onQueryChange={setThreadQuery}\n      onSelect={setThreadId}\n    />\n  </Specimen>\n  <Specimen label=\"filtered\" wide>\n    <ThreadSearch threads={SEARCHABLE} query=\"truss\" activeId=\"t-truss\" />\n  </Specimen>\n  <Specimen label=\"nothing matches\" wide>\n    <ThreadSearch threads={SEARCHABLE} query=\"haze\" activeId=\"\" />\n  </Specimen>\n</Specimens>",
+      "note": "History you can actually get back into: pinned first, then grouped by when. Filtering matches the title and the preview together, so a thread found by something said inside it still shows the line that found it. The pinned section is a lift out of the date groups rather than a copy — a pinned thread appears once.",
+      "interaction": "arrows walk the flattened order across group boundaries, which is the order the eye reads rather than the order the data is in."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/threshold-rail.json

@@ -72,14 +72,14 @@
     },
     {
       "name": "belowTone",
-      "type": "\"accent\" | \"danger\" | \"busy\" | \"ok\" | \"warn\" | \"info\"",
+      "type": "\"danger\" | \"accent\" | \"busy\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "danger",
       "description": "Ink for the zones outside the window. Defaults to `\"danger\"`."
     },
     {
       "name": "aboveTone",
-      "type": "\"accent\" | \"danger\" | \"busy\" | \"ok\" | \"warn\" | \"info\"",
+      "type": "\"danger\" | \"accent\" | \"busy\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "ok",
       "description": "Ink for the armed zone. Defaults to `\"ok\"`."

package/manifest/components/time-boundary.json

@@ -0,0 +1,62 @@
+{
+  "name": "TimeBoundary",
+  "slug": "time-boundary",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [],
+  "clientOnly": true,
+  "description": "The rule that says the day changed: a label centred between two hairlines.\n\nOne row, placed by the caller. That is the difference between this and\n`DaySeparator`, which takes a whole message list and inserts its own rules:\na transcript assembled from a row union — the shape every shipping agent UI\nconverged on — needs the boundary as a *member of that union*, not as a\ncomponent that owns the list around it.\n\nIt is a `role=\"separator\"` carrying its label as an accessible name, and the\ntext inside it is `aria-hidden`. A reader hears \"Today, separator\" once\nrather than twice, and the hairlines are never announced at all.",
+  "props": [
+    {
+      "name": "label",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "The label, pre-formatted: `Today`, `Yesterday`, `14 March`. This family\ndoes no date arithmetic and owns no locale — the caller knows which one the\nconsole is in, and `DaySeparator` next door takes its days the same way."
+    },
+    {
+      "name": "dateTime",
+      "type": "string",
+      "required": false,
+      "defaultValue": null,
+      "description": "The machine-readable instant, rendering the label inside a `<time>`. Worth\ngiving: it is what lets a test, a scraper or a deep link find the boundary\nwithout parsing the words a human reads."
+    }
+  ],
+  "typeReferences": [
+    "Omit<React.ComponentPropsWithoutRef<\"div\">, \"children\">"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-accent",
+    "--cue-border",
+    "--cue-fg-subtle"
+  ],
+  "summary": "The rule that says the day changed: a label centred between two hairlines.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { TimeBoundary } from \"@cueplusplus/ui/elements\";\n\n<TimeBoundary label=\"Today\" dateTime=\"2026-08-22\" />",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/time-boundary",
+  "mdUrl": "/docs/components/time-boundary.md",
+  "jsonUrl": "/r/components/time-boundary.json",
+  "specimens": [
+    {
+      "title": "TimeBoundary",
+      "group": "elements-thread",
+      "components": [
+        "TimeBoundary"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"today\" wide>\n    <div className=\"w-full max-w-md\">\n      <TimeBoundary label=\"Today\" dateTime=\"2026-08-22\" />\n    </div>\n  </Specimen>\n  <Specimen label=\"a date\" wide>\n    <div className=\"w-full max-w-md\">\n      <TimeBoundary label=\"14 March\" dateTime=\"2026-03-14\" />\n    </div>\n  </Specimen>\n</Specimens>",
+      "note": "One row, placed by the caller — which is the difference between this and DaySeparator, which takes a whole message list and inserts its own. A transcript assembled from a row union needs the boundary as a member of that union. It is a role=separator carrying its label as its name, with the text inside aria-hidden so a reader hears 'Today' once rather than twice, and the caller pre-formats the words because this family owns no locale.",
+      "interaction": "none. It is a rule with a word on it, and nothing here takes focus."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/timeline.json

@@ -40,7 +40,7 @@
       "props": [
         {
           "name": "tone",
-          "type": "\"idle\" | \"danger\" | \"busy\" | \"ok\" | \"warn\"",
+          "type": "\"danger\" | \"idle\" | \"busy\" | \"ok\" | \"warn\"",
           "required": true,
           "defaultValue": null,
           "description": "Which state this event is in. The shared `StatusDot` vocabulary."

package/manifest/components/todo-list.json

@@ -0,0 +1,69 @@
+{
+  "name": "TodoList",
+  "slug": "todo-list",
+  "group": "elements",
+  "importPath": "@cueplusplus/ui/elements",
+  "peerDependencies": [
+    "lucide-react"
+  ],
+  "clientOnly": true,
+  "description": "The agent's own working list, rewritten mid-run as it discovers what else is needed.",
+  "props": [
+    {
+      "name": "items",
+      "type": "readonly TodoItem[]",
+      "required": true,
+      "defaultValue": null,
+      "description": "The list as it stands right now. Each item carries its own status, so the agent\ncan add, reorder, and complete items in any order between renders."
+    },
+    {
+      "name": "revision",
+      "type": "number",
+      "required": false,
+      "defaultValue": null,
+      "description": "Which rewrite of the list this is. Omit to show a plain done/total count instead."
+    }
+  ],
+  "typeReferences": [
+    "Omit<ComponentProps<\"div\">, \"children\" | \"items\" | \"revision\"> & {\n  /**\n   * The list as it stands right now. Each item carries its own status, so the agent\n   * can add, reorder, and complete items in any order between renders.\n   */\n  items: readonly TodoItem[];\n  /** Which rewrite of the list this is. Omit to show a plain done/total count instead. */\n  revision?: number;\n}"
+  ],
+  "subcomponents": [],
+  "parts": [],
+  "variants": {},
+  "defaultVariants": {},
+  "tokensUsed": [
+    "--cue-border-strong",
+    "--cue-fg",
+    "--cue-fg-muted",
+    "--cue-fg-subtle",
+    "--cue-radius-control",
+    "--cue-stream",
+    "--cue-surface-2",
+    "--cue-text-body"
+  ],
+  "summary": "The agent's own working list, rewritten mid-run as it discovers what else is needed.",
+  "examples": [
+    {
+      "title": "Usage",
+      "code": "import { TodoList } from \"@cueplusplus/ui/elements\";\n\n<TodoList\n  items={[\n    { id: \"read\", text: \"Read the failing test\", status: \"done\" },\n    { id: \"fix\", text: \"Fix the converter\", status: \"active\" },\n    { id: \"verify\", text: \"Re-run the suite\", status: \"pending\" },\n  ]}\n  revision={2}\n/>",
+      "language": "tsx"
+    }
+  ],
+  "status": "todo-docs",
+  "url": "/docs/components/todo-list",
+  "mdUrl": "/docs/components/todo-list.md",
+  "jsonUrl": "/r/components/todo-list.json",
+  "specimens": [
+    {
+      "title": "TodoList",
+      "group": "elements",
+      "components": [
+        "TodoList"
+      ],
+      "code": "<Specimens>\n  <Specimen label=\"rev 3\" wide>\n    <TodoList items={TODOS} revision={3} />\n  </Specimen>\n  <Specimen label=\"no revision\" wide>\n    <TodoList items={TODOS.slice(0, 3)} />\n  </Specimen>\n</Specimens>",
+      "note": "The agent's own working list, which is not the plan: it is rewritten mid-run as the job turns out to be bigger. Items carry their own status, so more than one can be active, and `revision` is what makes a rewrite legible rather than alarming.",
+      "interaction": "none, and deliberately: a reader who could tick these off would be editing the agent's mind."
+    }
+  ],
+  "todo": true
+}

package/manifest/components/toggle-group.json

@@ -7,6 +7,13 @@
   "clientOnly": true,
   "description": "A cluster of {@link Toggle }s sharing one pressed state.\n\nThe difference from {@link SegmentedControl } is not cosmetic: a toggle group\ncan be **empty**. Pressing the pressed item unpresses it, so \"no filter\" is a\nreachable state — which is what a filter bar needs and what a view switcher\nmust never offer. Reach for `SegmentedControl` when the answer is always one\nof N, and for this when the answer may be none, or several (`multiple`).\n\nArrow-key roving focus and the pressed-state ARIA come from Base UI; this\nlayer supplies the density rung (published to the children through context)\nand the flat frame-less layout — a group of toggles is a row of controls, not\na boxed widget.",
   "props": [
+    {
+      "name": "defaultValue",
+      "type": "readonly string[]",
+      "required": false,
+      "defaultValue": null,
+      "description": "The initially pressed values when uncontrolled."
+    },
     {
       "name": "className",
       "type": "string",
@@ -28,13 +35,6 @@
       "defaultValue": "md",
       "description": "Rung of the control ladder for every toggle inside. Defaults to `\"md\"`."
     },
-    {
-      "name": "defaultValue",
-      "type": "readonly string[]",
-      "required": false,
-      "defaultValue": null,
-      "description": "The initially pressed values when uncontrolled."
-    },
     {
       "name": "value",
       "type": "readonly string[]",

package/manifest/components/token-editor.json

@@ -41,7 +41,7 @@
       "name": "groups",
       "type": "readonly TokenGroup[]",
       "required": false,
-      "defaultValue": "[\n  {\n    id: \"ground\",\n    label: \"Ground & surfaces\",\n    tokens: [\"bg\", \"sunken\", \"surface-1\", \"surface-2\", \"surface-3\", \"data-ground\", \"scrim\"],\n  },\n  { id: \"ink\", label: \"Ink\", tokens: [\"fg\", \"fg-muted\", \"fg-subtle\"] },\n  { id: \"borders\", label: \"Borders\", tokens: [\"border\", \"border-strong\", \"border-overlay\"] },\n  {\n    id: \"accent\",\n    label: \"Accent\",\n    tokens: [\"accent\", \"accent-hover\", \"accent-fg\", \"focus\", \"selection\"],\n  },\n  { id: \"status\", label: \"Status\", tokens: [\"ok\", \"busy\", \"warn\", \"danger\", \"info\"] },\n]",
+      "defaultValue": "[\n  {\n    id: \"ground\",\n    label: \"Ground & surfaces\",\n    tokens: [\"bg\", \"sunken\", \"surface-1\", \"surface-2\", \"surface-3\", \"data-ground\", \"scrim\"],\n  },\n  { id: \"ink\", label: \"Ink\", tokens: [\"fg\", \"fg-muted\", \"fg-subtle\"] },\n  { id: \"borders\", label: \"Borders\", tokens: [\"border\", \"border-strong\", \"border-overlay\"] },\n  {\n    id: \"accent\",\n    label: \"Accent\",\n    tokens: [\"accent\", \"accent-hover\", \"accent-fg\", \"focus\", \"selection\"],\n  },\n  {\n    id: \"status\",\n    label: \"Status\",\n    // `stream` is the live hue rather than a sixth tone, and it sits in this\n    // group because this is where somebody looking for \"the colour a running\n    // tool is\" will look for it. `warn-fg` and `danger-fg` each sit next to the\n    // tone they are chosen against: they are the inks on the two solid fills\n    // this system paints, and moving a tone without looking at its ink is how a\n    // confirm button stops being readable.\n    tokens: [\"ok\", \"busy\", \"warn\", \"warn-fg\", \"danger\", \"danger-fg\", \"info\", \"stream\"],\n  },\n]",
       "description": "Groups to render. Defaults to {@link COLOR_TOKEN_GROUPS}."
     },
     {