ionbase-ui 0.73.0 → 0.75.0

package/dist/meta/contrast.json

@@ -11131,6 +11131,36 @@
       "ratio": 9.04,
       "min": 4.5
     },
+    {
+      "component": "chart",
+      "context": "ion-chart ion-chart__caption",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-muted",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Light",
+      "fgHex": "#384252",
+      "bgHex": "#f0f2f4",
+      "ratio": 9.04,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-legend ion-chart-legend__item",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-muted",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Light",
+      "fgHex": "#384252",
+      "bgHex": "#f0f2f4",
+      "ratio": 9.04,
+      "min": 4.5
+    },
     {
       "component": "checkbox",
       "context": "ion-checkbox ion-checkbox__label",
@@ -12280,6 +12310,36 @@
       "ratio": 9.53,
       "min": 4.5
     },
+    {
+      "component": "chart",
+      "context": "ion-chart ion-chart__caption",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-page",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Light",
+      "fgHex": "#384252",
+      "bgHex": "#f6f8f9",
+      "ratio": 9.53,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-legend ion-chart-legend__item",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-page",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Light",
+      "fgHex": "#384252",
+      "bgHex": "#f6f8f9",
+      "ratio": 9.53,
+      "min": 4.5
+    },
     {
       "component": "checkbox",
       "context": "ion-checkbox ion-checkbox__label",
@@ -13415,6 +13475,50 @@
       "ratio": 10.15,
       "min": 4.5
     },
+    {
+      "component": "chart",
+      "context": "ion-chart ion-chart__caption",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-default",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Light",
+      "fgHex": "#384252",
+      "bgHex": "#ffffff",
+      "ratio": 10.15,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-legend ion-chart-legend__item",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-default",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Light",
+      "fgHex": "#384252",
+      "bgHex": "#ffffff",
+      "ratio": 10.15,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__label",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Light",
+      "fgHex": "#384252",
+      "bgHex": "#ffffff",
+      "ratio": 10.15,
+      "min": 4.5
+    },
     {
       "component": "checkbox",
       "context": "ion-checkbox ion-checkbox__label",
@@ -15371,6 +15475,50 @@
       "ratio": 11.38,
       "min": 4.5
     },
+    {
+      "component": "chart",
+      "context": "ion-chart ion-chart__caption",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-muted",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Dark",
+      "fgHex": "#dde0e4",
+      "bgHex": "#1d2735",
+      "ratio": 11.38,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-legend ion-chart-legend__item",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-muted",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Dark",
+      "fgHex": "#dde0e4",
+      "bgHex": "#1d2735",
+      "ratio": 11.38,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__label",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Dark",
+      "fgHex": "#dde0e4",
+      "bgHex": "#1d2735",
+      "ratio": 11.38,
+      "min": 4.5
+    },
     {
       "component": "checkbox",
       "context": "ion-checkbox ion-checkbox__label",
@@ -16673,6 +16821,36 @@
       "ratio": 13.31,
       "min": 4.5
     },
+    {
+      "component": "chart",
+      "context": "ion-chart ion-chart__caption",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-page",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Dark",
+      "fgHex": "#dde0e4",
+      "bgHex": "#131923",
+      "ratio": 13.31,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-legend ion-chart-legend__item",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-page",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Dark",
+      "fgHex": "#dde0e4",
+      "bgHex": "#131923",
+      "ratio": 13.31,
+      "min": 4.5
+    },
     {
       "component": "checkbox",
       "context": "ion-checkbox ion-checkbox__label",
@@ -17763,6 +17941,76 @@
       "ratio": 14.14,
       "min": 4.5
     },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Dark",
+      "fgHex": "#f6f8f9",
+      "bgHex": "#1d2735",
+      "ratio": 14.14,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__title",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Dark",
+      "fgHex": "#f6f8f9",
+      "bgHex": "#1d2735",
+      "ratio": 14.14,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__rows",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Dark",
+      "fgHex": "#f6f8f9",
+      "bgHex": "#1d2735",
+      "ratio": 14.14,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__row",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Dark",
+      "fgHex": "#f6f8f9",
+      "bgHex": "#1d2735",
+      "ratio": 14.14,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__value",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Dark",
+      "fgHex": "#f6f8f9",
+      "bgHex": "#1d2735",
+      "ratio": 14.14,
+      "min": 4.5
+    },
     {
       "component": "combobox",
       "context": "ion-combobox-menu ion-combobox-menu__label",
@@ -19341,6 +19589,36 @@
       "ratio": 15.86,
       "min": 4.5
     },
+    {
+      "component": "chart",
+      "context": "ion-chart ion-chart__caption",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-default",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Dark",
+      "fgHex": "#dde0e4",
+      "bgHex": "#000000",
+      "ratio": 15.86,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-legend ion-chart-legend__item",
+      "state": "default",
+      "fg": "--text-secondary",
+      "bg": "--surface-default",
+      "backdrop": null,
+      "kind": "text",
+      "ground": "assumed",
+      "mode": "Dark",
+      "fgHex": "#dde0e4",
+      "bgHex": "#000000",
+      "ratio": 15.86,
+      "min": 4.5
+    },
     {
       "component": "checkbox",
       "context": "ion-checkbox ion-checkbox__label",
@@ -21409,6 +21687,76 @@
       "ratio": 17.63,
       "min": 4.5
     },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Light",
+      "fgHex": "#131923",
+      "bgHex": "#ffffff",
+      "ratio": 17.63,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__title",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Light",
+      "fgHex": "#131923",
+      "bgHex": "#ffffff",
+      "ratio": 17.63,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__rows",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Light",
+      "fgHex": "#131923",
+      "bgHex": "#ffffff",
+      "ratio": 17.63,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__row",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Light",
+      "fgHex": "#131923",
+      "bgHex": "#ffffff",
+      "ratio": 17.63,
+      "min": 4.5
+    },
+    {
+      "component": "chart",
+      "context": "ion-chart-tooltip ion-chart-tooltip__value",
+      "state": "default",
+      "fg": "--text-default",
+      "bg": "--surface-raised",
+      "backdrop": "--surface-raised",
+      "kind": "text",
+      "mode": "Light",
+      "fgHex": "#131923",
+      "bgHex": "#ffffff",
+      "ratio": 17.63,
+      "min": 4.5
+    },
     {
       "component": "combobox",
       "context": "ion-combobox-menu ion-combobox-menu__label",

package/dist/meta/index.json

@@ -1,10 +1,23 @@
 {
   "package": "ionbase-ui",
-  "version": "0.73.0",
+  "version": "0.75.0",
   "usage": "Pick a component here, then read dist/meta/<Name>.json for its full contract.",
   "hooks": [
+    "useAgentRun",
     "useToast"
   ],
+  "helpers": [
+    "agentRunFrom",
+    "agentRunHasEnded",
+    "agentRunLog",
+    "agentRunReducer",
+    "chartAxisProps",
+    "chartGridProps",
+    "chartSeriesClass",
+    "chartTooltipProps",
+    "initialAgentRunState",
+    "replayAgentRun"
+  ],
   "components": {
     "Accordion": {
       "summary": "Sections that collapse, with the document's heading structure intact. Holds the open set and the heading level.",
@@ -235,6 +248,25 @@
       "detail": "dist/meta/Button.json",
       "hasIntent": true
     },
+    "ChartLegend": {
+      "summary": "Which colour is which series, for a chart drawn with visx. The swatch reads the same token as the series.",
+      "status": "stable",
+      "variants": {
+        "shape": [
+          "square",
+          "line"
+        ]
+      },
+      "detail": "dist/meta/ChartLegend.json",
+      "hasIntent": true
+    },
+    "ChartTooltip": {
+      "summary": "The panel showing the values under the pointer on a visx chart. visx positions it; this draws it.",
+      "status": "stable",
+      "variants": {},
+      "detail": "dist/meta/ChartTooltip.json",
+      "hasIntent": true
+    },
     "Checkbox": {
       "summary": "A native checkbox with the system's styling, supporting an indeterminate state.",
       "status": "stable",

package/dist/meta/patterns/AgentRun.json

@@ -16,6 +16,20 @@
     "Alert",
     "Badge"
   ],
+  "drivenBy": {
+    "hook": "useAgentRun",
+    "note": "It turns the events a run reports into the props on AgentActivityStep (`status`), StreamingText (`outputProps`), AgentStop (`stopProps`) and ApprovalGate (`approvalProps`), and applies this pattern's states on the way: one active step, a stop keeps what was done and skips the rest, a failure marks the step that was running. It owns state, not markup or copy — which steps to show is `log`, and every sentence is yours. Feed it with `dispatch` from a live run or `replay(recording)` from a stored one; `agentRunFrom(events)` rebuilds a finished run without playing it.",
+    "events": [
+      "`run-started` — optionally with `steps: [{ id, label }]`, the plan, so steps the run never reaches can be named as not done",
+      "`step-started` { id, label? } — closes whichever step was active; exactly one is active at a time",
+      "`step-done` / `step-skipped` { id }",
+      "`step-failed` { id, error? }",
+      "`approval-requested` { id } — the step becomes the ApprovalGate; the run is `awaiting`",
+      "`approval-resolved` { id, decision: approved | rejected | expired, resolution? } — `expired` ends the run without acting",
+      "`output` { text } — appended; `output-done` ends streaming",
+      "`run-finished`, `run-failed` { error? }, `run-stopped` { resolution? } — the three ends a producer sends; after any end, later events are ignored"
+    ]
+  },
   "structure": [
     "A header row carrying the task name and the AgentStop control. The stop is the first thing on screen and it stays there for the whole run.",
     "An AgentActivity list of AgentActivityStep, one per step, in the order they happened. Exactly one step is `active` at a time.",

package/dist/meta/patterns/HumanApproval.json

@@ -13,6 +13,10 @@
     "AgentStop",
     "Alert"
   ],
+  "drivenBy": {
+    "hook": "useAgentRun",
+    "note": "`approvalProps` carries the gate's `status`, `isSubmitting` and `resolution`, and `onApprove`/`onReject` when `onDecision` is given. A decision that throws stays pending with `state.approval.error` set — show it, because a decision the server never received must not look made. A stop or an expiry while pending resolves the gate as `expired`, never as approved."
+  },
   "structure": [
     "The gate appears in place, where the run reached it — inside the step log, not in a dialog that covers it.",
     "The AgentActivityStep that is waiting stays `active`; the ApprovalGate is its `detail`.",

package/dist/meta/patterns/index.json

@@ -1,6 +1,6 @@
 {
   "package": "ionbase-ui",
-  "version": "0.73.0",
+  "version": "0.75.0",
   "usage": "A pattern is a documented composition of components, not a component. Read one here, then read the contracts of what it composes.",
   "patterns": {
     "AgentRun": {
@@ -15,6 +15,7 @@
         "Alert",
         "Badge"
       ],
+      "drivenBy": "useAgentRun",
       "states": [
         "loading",
         "empty",
@@ -113,6 +114,7 @@
         "AgentStop",
         "Alert"
       ],
+      "drivenBy": "useAgentRun",
       "states": [
         "loading",
         "empty",