ionbase-ui 0.51.0 → 0.69.0

package/dist/meta/index.json

@@ -1,11 +1,25 @@
 {
   "package": "ionbase-ui",
-  "version": "0.51.0",
+  "version": "0.69.0",
   "usage": "Pick a component here, then read dist/meta/<Name>.json for its full contract.",
   "hooks": [
     "useToast"
   ],
   "components": {
+    "Accordion": {
+      "summary": "Sections that collapse, with the document's heading structure intact. Holds the open set and the heading level.",
+      "status": "stable",
+      "variants": {},
+      "detail": "dist/meta/Accordion.json",
+      "hasIntent": true
+    },
+    "AccordionItem": {
+      "summary": "One collapsible section: an always-visible title that toggles a region beneath it.",
+      "status": "stable",
+      "variants": {},
+      "detail": "dist/meta/AccordionItem.json",
+      "hasIntent": true
+    },
     "AgentActivity": {
       "summary": "An ordered, plain-language log of what the agent is doing. Status is text and shape, never colour alone.",
       "status": "stable",
@@ -184,6 +198,20 @@
       "detail": "dist/meta/Badge.json",
       "hasIntent": true
     },
+    "Breadcrumb": {
+      "summary": "Where this page sits in the hierarchy, and how to get back up. An ordered list inside a named landmark.",
+      "status": "stable",
+      "variants": {},
+      "detail": "dist/meta/Breadcrumb.json",
+      "hasIntent": true
+    },
+    "BreadcrumbItem": {
+      "summary": "One crumb. A link to an ancestor, or the current page rendered as text.",
+      "status": "stable",
+      "variants": {},
+      "detail": "dist/meta/BreadcrumbItem.json",
+      "hasIntent": true
+    },
     "Button": {
       "summary": "Triggers an action in place. Never navigates.",
       "status": "stable",
@@ -246,6 +274,24 @@
       "detail": "dist/meta/CitationListItem.json",
       "hasIntent": true
     },
+    "Combobox": {
+      "summary": "A text field that filters a list of options down to one selected value.",
+      "status": "stable",
+      "variants": {
+        "size": [
+          "sm",
+          "md",
+          "lg"
+        ],
+        "menuTrigger": [
+          "focus",
+          "input",
+          "manual"
+        ]
+      },
+      "detail": "dist/meta/Combobox.json",
+      "hasIntent": true
+    },
     "ConfidenceIndicator": {
       "summary": "How much to trust the thing next to it — three levels with a required basis, never a percentage.",
       "status": "stable",
@@ -259,6 +305,32 @@
       "detail": "dist/meta/ConfidenceIndicator.json",
       "hasIntent": true
     },
+    "DatePicker": {
+      "summary": "A segmented date field with a calendar attached, taking and returning a YYYY-MM-DD string.",
+      "status": "stable",
+      "variants": {
+        "size": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      },
+      "detail": "dist/meta/DatePicker.json",
+      "hasIntent": true
+    },
+    "DateRangePicker": {
+      "summary": "Two segmented date fields sharing one calendar, returning an inclusive { start, end } of YYYY-MM-DD strings.",
+      "status": "stable",
+      "variants": {
+        "size": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      },
+      "detail": "dist/meta/DateRangePicker.json",
+      "hasIntent": true
+    },
     "Divider": {
       "summary": "A semantic thematic break, rendered as a real <hr>.",
       "status": "stable",
@@ -271,6 +343,25 @@
       "detail": "dist/meta/Divider.json",
       "hasIntent": true
     },
+    "Drawer": {
+      "summary": "A modal panel anchored to an edge. Modal behaviour — focus trap, Escape, scrim — with the shape of a side panel.",
+      "status": "stable",
+      "variants": {
+        "placement": [
+          "start",
+          "end",
+          "top",
+          "bottom"
+        ],
+        "size": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      },
+      "detail": "dist/meta/Drawer.json",
+      "hasIntent": true
+    },
     "EmptyState": {
       "summary": "The state a region shows when it has nothing to show, and why — first run, no results, no access, or a failed fetch.",
       "status": "stable",
@@ -290,6 +381,18 @@
       "detail": "dist/meta/EmptyState.json",
       "hasIntent": true
     },
+    "FileUpload": {
+      "summary": "A drop target wrapped around a real file input, with client-side accept and size checks.",
+      "status": "stable",
+      "variants": {
+        "size": [
+          "sm",
+          "md"
+        ]
+      },
+      "detail": "dist/meta/FileUpload.json",
+      "hasIntent": true
+    },
     "FullCard": {
       "summary": "A full-bleed row: a text column beside a framed media panel, mirrored by `alignment`.",
       "status": "stable",
@@ -305,7 +408,12 @@
     "Header": {
       "summary": "The page header bar. Renders Figma's Desktop, Tablet, Mobile-Closed and Mobile-Open from one DOM tree.",
       "status": "stable",
-      "variants": {},
+      "variants": {
+        "menuType": [
+          "dialog",
+          "panel"
+        ]
+      },
       "detail": "dist/meta/Header.json",
       "hasIntent": true
     },
@@ -416,6 +524,19 @@
       "detail": "dist/meta/NavItem.json",
       "hasIntent": true
     },
+    "NumberInput": {
+      "summary": "A quantity field: formats and parses in the user's locale, clamps to bounds, steps with − and + or the arrow keys, and never changes under the scroll wheel unless asked.",
+      "status": "stable",
+      "variants": {
+        "size": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      },
+      "detail": "dist/meta/NumberInput.json",
+      "hasIntent": true
+    },
     "Pagination": {
       "summary": "Page navigation for a table or list. Renders prev/next arrows, a truncated run of page numbers, and an optional rows-per-page Select.",
       "status": "stable",
@@ -459,10 +580,10 @@
       "status": "stable",
       "variants": {
         "placement": [
-          "right",
-          "left",
           "top",
-          "bottom"
+          "bottom",
+          "right",
+          "left"
         ],
         "size": [
           "sm",
@@ -473,6 +594,36 @@
       "detail": "dist/meta/Popover.json",
       "hasIntent": true
     },
+    "ProgressBar": {
+      "summary": "A determinate or indeterminate measure of work, with the name of the work attached. Omitting `value` is what makes it indeterminate.",
+      "status": "stable",
+      "variants": {
+        "intent": [
+          "primary",
+          "success",
+          "warning",
+          "error"
+        ],
+        "size": [
+          "sm",
+          "md"
+        ]
+      },
+      "detail": "dist/meta/ProgressBar.json",
+      "hasIntent": true
+    },
+    "PromptInput": {
+      "summary": "Where a person writes to an agent: a growing text field, a send control that becomes the stop control while a run is going, and slots for attachments and tools.",
+      "status": "stable",
+      "variants": {
+        "submitKey": [
+          "enter",
+          "mod-enter"
+        ]
+      },
+      "detail": "dist/meta/PromptInput.json",
+      "hasIntent": true
+    },
     "Radio": {
       "summary": "One option inside a RadioGroup. Meaningless on its own — the group owns the name and the selected value.",
       "status": "stable",
@@ -516,6 +667,26 @@
       "detail": "dist/meta/ScrollProgress.json",
       "hasIntent": true
     },
+    "SegmentedControl": {
+      "summary": "Pick one of two to five options, all visible at once. A radio group drawn as a segmented track — it sets a value and controls no panel.",
+      "status": "stable",
+      "variants": {
+        "size": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      },
+      "detail": "dist/meta/SegmentedControl.json",
+      "hasIntent": true
+    },
+    "SegmentedControlItem": {
+      "summary": "One segment: a radio drawn as part of the track, with an optional icon.",
+      "status": "stable",
+      "variants": {},
+      "detail": "dist/meta/SegmentedControlItem.json",
+      "hasIntent": true
+    },
     "Select": {
       "summary": "A dropdown over a native <select>, with the same label and error wiring as Input.",
       "status": "stable",
@@ -529,6 +700,78 @@
       "detail": "dist/meta/Select.json",
       "hasIntent": true
     },
+    "Sidebar": {
+      "summary": "An application's navigation as a column: pinned header and footer that take any component, a scrolling body of titled, collapsible sections, and nested items that expand.",
+      "status": "stable",
+      "variants": {},
+      "detail": "dist/meta/Sidebar.json",
+      "hasIntent": true
+    },
+    "SidebarItem": {
+      "summary": "One sidebar row: a link or a button, with an icon, a count, actions revealed on hover or focus, and nested items that expand.",
+      "status": "stable",
+      "variants": {},
+      "detail": "dist/meta/SidebarItem.json",
+      "hasIntent": true
+    },
+    "SidebarSection": {
+      "summary": "A group of sidebar items under an optional title, which can fold away and carry its own actions.",
+      "status": "stable",
+      "variants": {},
+      "detail": "dist/meta/SidebarSection.json",
+      "hasIntent": true
+    },
+    "Skeleton": {
+      "summary": "The shape of content that has not arrived. Always hidden from assistive technology — the caller owns the announcement.",
+      "status": "stable",
+      "variants": {
+        "variant": [
+          "circle",
+          "text",
+          "rect"
+        ]
+      },
+      "detail": "dist/meta/Skeleton.json",
+      "hasIntent": true
+    },
+    "Spinner": {
+      "summary": "An indeterminate wait, announced once. A ring plus a politely-announced label, sized off the icon ramp.",
+      "status": "stable",
+      "variants": {
+        "size": [
+          "sm",
+          "md",
+          "lg"
+        ]
+      },
+      "detail": "dist/meta/Spinner.json",
+      "hasIntent": true
+    },
+    "Stepper": {
+      "summary": "Where the user is in a task that has an order. An ordered list of steps, each stating its position and status in text.",
+      "status": "stable",
+      "variants": {
+        "orientation": [
+          "horizontal",
+          "vertical"
+        ]
+      },
+      "detail": "dist/meta/Stepper.json",
+      "hasIntent": true
+    },
+    "StepperStep": {
+      "summary": "One step in a Stepper: a numbered indicator, a name, and a status carried by shape and text as well as colour.",
+      "status": "stable",
+      "variants": {
+        "status": [
+          "error",
+          "incomplete",
+          "complete"
+        ]
+      },
+      "detail": "dist/meta/StepperStep.json",
+      "hasIntent": true
+    },
     "StreamingText": {
       "summary": "Model output arriving a token at a time, in a container that does not move. Deliberately not a live region.",
       "status": "stable",
@@ -690,15 +933,30 @@
       "detail": "dist/meta/Toggle.json",
       "hasIntent": true
     },
+    "ToolCall": {
+      "summary": "The evidence behind one step of an agent run: which tool, with what input, and what came back — collapsed by default, with any failure shown without a click.",
+      "status": "stable",
+      "variants": {
+        "status": [
+          "pending",
+          "active",
+          "done",
+          "failed",
+          "skipped"
+        ]
+      },
+      "detail": "dist/meta/ToolCall.json",
+      "hasIntent": true
+    },
     "Tooltip": {
       "summary": "A text-only hint attached to a trigger. Opens on hover and on focus.",
       "status": "stable",
       "variants": {
         "placement": [
-          "right",
-          "left",
           "top",
-          "bottom"
+          "bottom",
+          "right",
+          "left"
         ]
       },
       "detail": "dist/meta/Tooltip.json",

package/dist/meta/patterns/AgentRun.json

@@ -10,6 +10,8 @@
     "AgentActivity",
     "AgentActivityStep",
     "AgentStop",
+    "PromptInput",
+    "ToolCall",
     "StreamingText",
     "Alert",
     "Badge"
@@ -18,6 +20,8 @@
     "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.",
     "The result below the log, in a StreamingText with `isStreaming` true until the run ends.",
+    "A ToolCall under any step that called a tool, collapsed, with the same `status` as its step. The step is the account; the ToolCall is the evidence for it.",
+    "When the run was started from a PromptInput, that composer's `isRunning` stop IS the run's AgentStop. Render one stop control, not two.",
     "An Alert only when the run fails or is stopped — not for ordinary progress, which the step log already carries."
   ],
   "states": {
@@ -53,6 +57,21 @@
       "size",
       "stopOnEscape"
     ],
+    "PromptInput": [
+      "label",
+      "onSubmit",
+      "isRunning",
+      "onStop",
+      "isStopping"
+    ],
+    "ToolCall": [
+      "title",
+      "name",
+      "status",
+      "input",
+      "output",
+      "errorMessage"
+    ],
     "StreamingText": [
       "isStreaming",
       "minLines",
@@ -84,6 +103,14 @@
         "md"
       ]
     },
+    "ToolCall": {
+      "status": [
+        "active",
+        "done",
+        "failed",
+        "skipped"
+      ]
+    },
     "Alert": {
       "intent": [
         "error",

package/dist/meta/patterns/Form.json

@@ -13,6 +13,7 @@
     "RadioGroup",
     "Toggle",
     "PhoneInput",
+    "NumberInput",
     "Button",
     "Alert",
     "Divider"
@@ -44,6 +45,14 @@
     }
   },
   "propsUsed": {
+    "NumberInput": [
+      "label",
+      "minValue",
+      "maxValue",
+      "formatOptions",
+      "isInvalid",
+      "errorMessage"
+    ],
     "Input": [
       "label",
       "description",

package/dist/meta/patterns/PageShell.json

@@ -7,6 +7,10 @@
   "composes": [
     "Header",
     "NavItem",
+    "Sidebar",
+    "SidebarSection",
+    "SidebarItem",
+    "Drawer",
     "Logo",
     "LogoMark",
     "Avatar",
@@ -18,7 +22,8 @@
     "Header at the top with the brand in `brand`, primary navigation in `center` and account actions in `end`.",
     "One <main> content region, named, holding the page's own heading as its h1.",
     "ToastProvider mounted once around the whole shell, not per route.",
-    "Breadcrumbs, when present, sit inside <main> above the h1 — they describe where the content is, not where the chrome is."
+    "Breadcrumbs, when present, sit inside <main> above the h1 — they describe where the content is, not where the chrome is.",
+    "When navigation is hierarchical or longer than a header row holds, a Sidebar replaces the NavItems in Header's `center`: Header keeps the brand and account actions, and the Sidebar sits beside <main> as the primary navigation. Below the tablet breakpoint the same Sidebar moves into a Drawer opened by Header's own toggle with `menuType=\"dialog\"` — one copy, not two, and one menu button."
   ],
   "states": {
     "loading": {
@@ -41,13 +46,38 @@
       "end",
       "open",
       "onOpenChange",
-      "menuLabel"
+      "menuLabel",
+      "menuType"
     ],
     "NavItem": [
       "icon",
       "showChevron",
       "href"
     ],
+    "Sidebar": [
+      "label",
+      "header",
+      "footer"
+    ],
+    "SidebarSection": [
+      "title",
+      "isCollapsible",
+      "actions"
+    ],
+    "SidebarItem": [
+      "label",
+      "icon",
+      "href",
+      "isCurrent",
+      "badge",
+      "actions"
+    ],
+    "Drawer": [
+      "isOpen",
+      "onOpenChange",
+      "title",
+      "placement"
+    ],
     "ToastProvider": [
       "placement",
       "limit"
@@ -66,6 +96,11 @@
       "placement": [
         "top-right"
       ]
+    },
+    "Header": {
+      "menuType": [
+        "dialog"
+      ]
     }
   },
   "a11y": {
@@ -73,7 +108,8 @@
       "`menuLabel` on Header — the mobile toggle is icon-only",
       "a <nav> with its own accessible name wrapping the NavItems; Header supplies the banner landmark, not the navigation one",
       "exactly one <main>, and exactly one h1 inside it",
-      "`aria-current=\"page\"` on the NavItem for the current route — colour alone does not tell a screen-reader user where they are"
+      "`aria-current=\"page\"` on the NavItem for the current route — colour alone does not tell a screen-reader user where they are",
+      "with a Sidebar, `isCurrent` on the SidebarItem for the current route, and a Sidebar `label` distinct from any other nav on the page"
     ],
     "notes": [
       "The desktop/tablet/mobile switch is a media query inside Header. Do not duplicate that decision in React state."
@@ -88,6 +124,10 @@
       "dont": "the page title as an h2 because the logo is an h1",
       "why": "the brand is not a heading; the page's subject is"
     },
+    {
+      "dont": "a Sidebar AND the same destinations as NavItems in Header",
+      "why": "two navigation landmarks listing the same pages double every link a screen-reader user tabs through"
+    },
     {
       "dont": "rendering a second nav for mobile",
       "why": "Header moves the one copy, and two copies duplicate every link in the accessibility tree"

package/dist/meta/patterns/Wizard.json

@@ -6,6 +6,8 @@
     "the whole task is too long to present as one form without abandonment"
   ],
   "composes": [
+    "Stepper",
+    "StepperStep",
     "Button",
     "Input",
     "Select",
@@ -18,7 +20,7 @@
     "Modal"
   ],
   "structure": [
-    "A step indicator naming every step and marking the current one — not Tabs, because the steps are not peers and cannot be visited in any order.",
+    "A Stepper naming every step and marking the current one — not Tabs, because the steps are not peers and cannot be visited in any order. Completed steps link back; incomplete ones do not.",
     "One step's fields at a time, each step a Form in its own right.",
     "Back and Next, plus save-and-exit for anything longer than three steps.",
     "A final review step listing every answer with a link back to the step that set it."
@@ -42,6 +44,16 @@
     }
   },
   "propsUsed": {
+    "Stepper": [
+      "label",
+      "orientation"
+    ],
+    "StepperStep": [
+      "status",
+      "isCurrent",
+      "onPress",
+      "description"
+    ],
     "Button": [
       "variant",
       "size",
@@ -78,6 +90,13 @@
     ]
   },
   "variantsUsed": {
+    "StepperStep": {
+      "status": [
+        "incomplete",
+        "complete",
+        "error"
+      ]
+    },
     "Button": {
       "variant": [
         "primary-brand",

package/dist/meta/patterns/index.json

@@ -1,6 +1,6 @@
 {
   "package": "ionbase-ui",
-  "version": "0.51.0",
+  "version": "0.69.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": {
@@ -9,6 +9,8 @@
         "AgentActivity",
         "AgentActivityStep",
         "AgentStop",
+        "PromptInput",
+        "ToolCall",
         "StreamingText",
         "Alert",
         "Badge"
@@ -89,6 +91,7 @@
         "RadioGroup",
         "Toggle",
         "PhoneInput",
+        "NumberInput",
         "Button",
         "Alert",
         "Divider"
@@ -123,6 +126,10 @@
       "composes": [
         "Header",
         "NavItem",
+        "Sidebar",
+        "SidebarSection",
+        "SidebarItem",
+        "Drawer",
         "Logo",
         "LogoMark",
         "Avatar",
@@ -164,6 +171,8 @@
     "Wizard": {
       "summary": "A sequence of steps with per-step validation, where progress survives leaving.",
       "composes": [
+        "Stepper",
+        "StepperStep",
         "Button",
         "Input",
         "Select",