@cueplusplus/ui 0.9.0 → 0.11.0

package/manifest/components/usage-chart.json

@@ -12,63 +12,100 @@
       "type": "readonly UsageChartPoint[]",
       "required": true,
       "defaultValue": null,
-      "description": "The series. Sorted and cleaned internally; order in is not order out."
+      "description": "The series. Sorted and cleaned internally; order in is not order out.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "tone",
       "type": "\"danger\" | \"accent\" | \"busy\" | \"ok\" | \"warn\" | \"info\"",
       "required": false,
       "defaultValue": "accent",
-      "description": "Stroke tone. Defaults to `\"accent\"`."
+      "description": "Stroke tone. Defaults to `\"accent\"`.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "danger",
+          "accent",
+          "busy",
+          "ok",
+          "warn",
+          "info"
+        ]
+      }
     },
     {
       "name": "height",
       "type": "number",
       "required": false,
       "defaultValue": "120",
-      "description": "Plot height in px at the 16px root. Defaults to `120`."
+      "description": "Plot height in px at the 16px root. Defaults to `120`.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "gapMs",
       "type": "number",
       "required": false,
       "defaultValue": "15 * 60 * 1000",
-      "description": "Break the line when consecutive samples are further apart than this, in ms."
+      "description": "Break the line when consecutive samples are further apart than this, in ms.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "threshold",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "Draw a dashed rule at this percentage — where throttling starts, say."
+      "description": "Draw a dashed rule at this percentage — where throttling starts, say.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The accessible name. Name the series; the shape is not self-describing."
+      "description": "The accessible name. Name the series; the shape is not self-describing.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "emptyLabel",
       "type": "string",
       "required": false,
       "defaultValue": "No data yet",
-      "description": "What to say when there is nothing to plot. Defaults to `\"No data yet\"`."
+      "description": "What to say when there is nothing to plot. Defaults to `\"No data yet\"`.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "formatTimestamp",
       "type": "((t: number) => string)",
       "required": false,
       "defaultValue": null,
-      "description": "Format a sample's timestamp for the tooltip. Defaults to a short local date-time."
+      "description": "Format a sample's timestamp for the tooltip. Defaults to a short local date-time.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "formatValue",
       "type": "((v: number) => string)",
       "required": false,
       "defaultValue": "(value) => `${Math.round(value)}%`",
-      "description": "Format a sample's value for the tooltip. Defaults to `\"87%\"`."
+      "description": "Format a sample's value for the tooltip. Defaults to `\"87%\"`.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/verdict-row.json

@@ -14,35 +14,50 @@
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "What the scorer thought of the work, `0`–`1`. Clamped, and a non-finite\nscore is worth no stars — see {@link verdictStars}."
+      "description": "What the scorer thought of the work, `0`–`1`. Clamped, and a non-finite\nscore is worth no stars — see {@link verdictStars}.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "title",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "What the scorer is called. Defaults to `VERDICT_LABELS.title`\n(`Verification`), which is deliberately not `Critic`: the same row fits a\ntest run, a linter or a second model."
+      "description": "What the scorer is called. Defaults to `VERDICT_LABELS.title`\n(`Verification`), which is deliberately not `Critic`: the same row fits a\ntest run, a linter or a second model.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "summary",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "One line of the scorer's own prose, under the rating."
+      "description": "One line of the scorer's own prose, under the rating.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "issues",
       "type": "readonly VerdictIssue[]",
       "required": false,
       "defaultValue": null,
-      "description": "What it thinks is probably wrong, drawn as chips with their probabilities\nand tinted by them. Order is the caller's — most likely first reads best."
+      "description": "What it thinks is probably wrong, drawn as chips with their probabilities\nand tinted by them. Order is the caller's — most likely first reads best.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "labels",
       "type": "Partial<VerdictLabels>",
       "required": false,
       "defaultValue": null,
-      "description": "The row's three strings, merged over `VERDICT_LABELS`."
+      "description": "The row's three strings, merged over `VERDICT_LABELS`.",
+      "control": {
+        "kind": "opaque"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/voice-conversation.json

@@ -14,49 +14,79 @@
       "type": "\"thinking\" | \"connecting\" | \"listening\" | \"speaking\"",
       "required": true,
       "defaultValue": null,
-      "description": "Drives the orb and the caption. Only listening and speaking react to amplitude."
+      "description": "Drives the orb and the caption. Only listening and speaking react to amplitude.",
+      "control": {
+        "kind": "enum",
+        "members": [
+          "thinking",
+          "connecting",
+          "listening",
+          "speaking"
+        ]
+      }
     },
     {
       "name": "amplitude",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Current level from 0 to 1, clamped internally. Feed it from the analyser node."
+      "description": "Current level from 0 to 1, clamped internally. Feed it from the analyser node.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "transcript",
       "type": "readonly VoiceTurn[]",
       "required": true,
       "defaultValue": null,
-      "description": "Turns so far, oldest first."
+      "description": "Turns so far, oldest first.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "muted",
       "type": "boolean",
       "required": false,
       "defaultValue": null,
-      "description": "Marks the mic control as engaged and swaps the hint."
+      "description": "Marks the mic control as engaged and swaps the hint.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onToggleMute",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the mic is muted or unmuted."
+      "description": "Called when the mic is muted or unmuted.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onInterrupt",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the orb is pressed while the assistant is speaking. The orb is inert\nin every other mode, so the caption only offers the interrupt when one is\npossible."
+      "description": "Called when the orb is pressed while the assistant is speaking. The orb is inert\nin every other mode, so the caption only offers the interrupt when one is\npossible.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onEnd",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the call is ended."
+      "description": "Called when the call is ended.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/web-preview.json

@@ -14,35 +14,53 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Host the content is served from. Show the sandbox origin, not your own, so the\nisolation is legible. Displaying it does not create the isolation; the frame you\npass as children must already be sandboxed."
+      "description": "Host the content is served from. Show the sandbox origin, not your own, so the\nisolation is legible. Displaying it does not create the isolation; the frame you\npass as children must already be sandboxed.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "loading",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Fades the frame out and shimmers a status while the sandbox is being set up."
+      "description": "Fades the frame out and shimmers a status while the sandbox is being set up.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": true,
       "defaultValue": null,
-      "description": "The frame itself. In production this is a sandboxed iframe, not inline markup."
+      "description": "The frame itself. In production this is a sandboxed iframe, not inline markup.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     },
     {
       "name": "onReload",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the reload control."
+      "description": "Called from the reload control.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "onOpenExternal",
       "type": "(() => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called from the open-in-new-tab control."
+      "description": "Called from the open-in-new-tab control.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/web-search.json

@@ -14,35 +14,50 @@
       "type": "string",
       "required": true,
       "defaultValue": null,
-      "description": "Search query shown in the query pill."
+      "description": "Search query shown in the query pill.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "results",
       "type": "readonly WebSearchResult[]",
       "required": true,
       "defaultValue": null,
-      "description": "Result cards available to reveal one by one."
+      "description": "Result cards available to reveal one by one.",
+      "control": {
+        "kind": "array"
+      }
     },
     {
       "name": "visibleResults",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "How many results from the start are currently shown."
+      "description": "How many results from the start are currently shown.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "searching",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "When true a shimmering Searching label replaces the result count."
+      "description": "When true a shimmering Searching label replaces the result count.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "cycle",
       "type": "number",
       "required": true,
       "defaultValue": null,
-      "description": "Identity key that remounts the list so entrance animation can replay."
+      "description": "Identity key that remounts the list so entrance animation can replay.",
+      "control": {
+        "kind": "number"
+      }
     }
   ],
   "typeReferences": [

package/manifest/components/work-collapse.json

@@ -14,49 +14,72 @@
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "How long the run took, in milliseconds. Omit when it is not known."
+      "description": "How long the run took, in milliseconds. Omit when it is not known.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "toolCalls",
       "type": "number",
       "required": false,
       "defaultValue": null,
-      "description": "How many tool calls it made. Omit when it is not counted."
+      "description": "How many tool calls it made. Omit when it is not counted.",
+      "control": {
+        "kind": "number"
+      }
     },
     {
       "name": "running",
       "type": "boolean",
       "required": false,
       "defaultValue": "false",
-      "description": "Whether the run is still going: the label goes present tense and the sweep\nruns. Hermes's rule, and the one that keeps a collapsed live run from\nclaiming to be finished."
+      "description": "Whether the run is still going: the label goes present tense and the sweep\nruns. Hermes's rule, and the one that keeps a collapsed live run from\nclaiming to be finished.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "label",
       "type": "string",
       "required": false,
       "defaultValue": null,
-      "description": "The whole summary line, replacing the one {@link formatWorkLabel} would\nbuild. This is where a category summary goes — \"Explored 3 files, ran 5\ncommands\", composed from `VERB_TRIADS` — which is a sentence no formatter\nover a duration and a count could produce."
+      "description": "The whole summary line, replacing the one {@link formatWorkLabel} would\nbuild. This is where a category summary goes — \"Explored 3 files, ran 5\ncommands\", composed from `VERB_TRIADS` — which is a sentence no formatter\nover a duration and a count could produce.",
+      "control": {
+        "kind": "string"
+      }
     },
     {
       "name": "open",
       "type": "boolean",
       "required": true,
       "defaultValue": null,
-      "description": "Whether the rows are showing."
+      "description": "Whether the rows are showing.",
+      "control": {
+        "kind": "boolean"
+      }
     },
     {
       "name": "onOpenChange",
       "type": "((open: boolean) => void)",
       "required": false,
       "defaultValue": null,
-      "description": "Called when the row is expanded or collapsed."
+      "description": "Called when the row is expanded or collapsed.",
+      "control": {
+        "kind": "callback",
+        "fixture": "callback.log"
+      }
     },
     {
       "name": "children",
       "type": "ReactNode",
       "required": false,
       "defaultValue": null,
-      "description": "The rows the run folded away: tool calls, reasoning, whatever ran."
+      "description": "The rows the run folded away: tool calls, reasoning, whatever ran.",
+      "control": {
+        "kind": "node",
+        "fixture": "children.text"
+      }
     }
   ],
   "typeReferences": [

package/manifest/fixtures.json

@@ -0,0 +1,111 @@
+{
+  "schemaVersion": 2,
+  "generatedAt": "1970-01-01T00:00:00.000Z",
+  "fixtures": [
+    {
+      "id": "children.text",
+      "kind": "node",
+      "label": "A line of text"
+    },
+    {
+      "id": "children.rich",
+      "kind": "node",
+      "label": "A bold line and a paragraph"
+    },
+    {
+      "id": "children.label",
+      "kind": "node",
+      "label": "A short label"
+    },
+    {
+      "id": "bento.tiles",
+      "kind": "node",
+      "label": "Six bento tiles of mixed span"
+    },
+    {
+      "id": "icon.play",
+      "kind": "opaque",
+      "label": "Play icon",
+      "accepts": [
+        "ElementType<any, keyof IntrinsicElements>"
+      ]
+    },
+    {
+      "id": "icon.check",
+      "kind": "opaque",
+      "label": "Check icon"
+    },
+    {
+      "id": "table.rows-24",
+      "kind": "array",
+      "label": "24 cue rows"
+    },
+    {
+      "id": "table.rows-0",
+      "kind": "array",
+      "label": "0 rows, the empty table"
+    },
+    {
+      "id": "table.model-usage-6",
+      "kind": "array",
+      "label": "6 model rows",
+      "accepts": [
+        "readonly ModelUsage[]"
+      ]
+    },
+    {
+      "id": "agent.transcript",
+      "kind": "array",
+      "label": "6 transcript lines",
+      "accepts": [
+        "readonly string[]"
+      ]
+    },
+    {
+      "id": "chart.series",
+      "kind": "array",
+      "label": "12 trend points",
+      "accepts": [
+        "readonly number[]"
+      ]
+    },
+    {
+      "id": "form.fields",
+      "kind": "array",
+      "label": "4 field descriptors"
+    },
+    {
+      "id": "callback.log",
+      "kind": "callback",
+      "label": "Write to the event log"
+    },
+    {
+      "id": "sample.copy",
+      "kind": "object",
+      "label": "The five standard copy states"
+    },
+    {
+      "id": "sample.trend",
+      "kind": "array",
+      "label": "12 sample trend values"
+    },
+    {
+      "id": "sample.channels",
+      "kind": "array",
+      "label": "3 output channels"
+    },
+    {
+      "id": "sample.cues",
+      "kind": "array",
+      "label": "5 cue rows"
+    },
+    {
+      "id": "sample.blend-modes",
+      "kind": "array",
+      "label": "3 blend modes",
+      "accepts": [
+        "readonly SelectOption[]"
+      ]
+    }
+  ]
+}