ionbase-ui 0.51.0 → 0.69.0

package/dist/styles/spinner.css

@@ -0,0 +1,70 @@
+/*
+ * Spinner
+ *
+ * One ring, one token per slot, sized off the icon ramp rather than a ramp of
+ * its own — a spinner is an icon-shaped thing and giving it private sizes is
+ * the `control/<size>/*` mistake recorded in AGENTS.md.
+ */
+.ion-spinner {
+  --ion-spinner-size: var(--icon-size-md);
+  --ion-spinner-track: var(--border-subtle);
+  --ion-spinner-head: var(--border-primary-strong);
+
+  display: inline-flex;
+  align-items: center;
+  gap: var(--spacing-8);
+  color: var(--text-secondary);
+  font-family: var(--font-family-sans);
+  font-size: var(--type-body-sm);
+  line-height: var(--type-body-sm-line-height);
+}
+
+.ion-spinner--sm {
+  --ion-spinner-size: var(--icon-size-sm);
+}
+
+.ion-spinner--lg {
+  --ion-spinner-size: var(--icon-size-lg);
+}
+
+/*
+ * The track is the full ring and the head is one quadrant of it, which is what
+ * makes rotation legible: a ring of uniform colour spinning looks static.
+ */
+.ion-spinner__ring {
+  box-sizing: border-box;
+  flex: none;
+  width: var(--ion-spinner-size);
+  height: var(--ion-spinner-size);
+  border: var(--border-width-thick) solid var(--ion-spinner-track);
+  border-top-color: var(--ion-spinner-head);
+  border-radius: var(--radius-full);
+  animation: ion-spinner-rotate var(--ion-duration-slow) var(--ion-ease-linear)
+    infinite;
+}
+
+@keyframes ion-spinner-rotate {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+/*
+ * Slowed, not stopped. A stationary spinner is not a calmer spinner; it is
+ * indistinguishable from a hung one, and it removes the only signal a sighted
+ * user has that the wait is still live.
+ */
+@media (prefers-reduced-motion: reduce) {
+  .ion-spinner__ring {
+    animation-duration: 2400ms;
+  }
+}
+
+/* Forced colours throw the token palette away; the ring must still read as a
+ * ring, so the head keeps its contrast against the track. */
+@media (forced-colors: active) {
+  .ion-spinner__ring {
+    border-color: GrayText;
+    border-top-color: CanvasText;
+  }
+}

package/dist/styles/stepper.css

@@ -0,0 +1,250 @@
+/*
+ * Stepper
+ *
+ * Drawn in Figma as `Stepper` (1391:431) and `Stepper Step` (1391:356), from
+ * this file. Built code-first, like Breadcrumb: the indicator is a circle at the
+ * `lg` icon rung, the label type is Breadcrumb's, and the colours are the primary
+ * and error roles every other status in the system uses.
+ *
+ * Status is never colour alone. `complete` draws a check and `error` an
+ * exclamation, and both carry their name as visually hidden text.
+ *
+ * Status and current are BEM modifiers, not `[data-*]` attributes, and that is
+ * load-bearing: the contrast gate keys contexts on `--modifier` classes. The
+ * first draft used `[data-status]`, and the filled current indicator and every
+ * error colour were silently unmeasured — no failure, no pass, just absent.
+ */
+.ion-stepper {
+  display: flex;
+  gap: var(--spacing-8);
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  font-family: var(--font-family-sans);
+  font-size: var(--type-body-sm);
+  line-height: var(--type-body-sm-line-height);
+}
+
+/*
+ * Horizontal only: an inline-size container stops sizing to its content, which
+ * a vertical rail inside a flex parent needs to do.
+ */
+.ion-stepper--horizontal {
+  container-type: inline-size;
+}
+
+.ion-stepper--vertical {
+  flex-direction: column;
+  gap: 0;
+}
+
+.ion-stepper__label {
+  font-weight: var(--font-weight-medium);
+}
+
+.ion-stepper__step {
+  position: relative;
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-8);
+  min-width: 0;
+  color: var(--text-secondary);
+}
+
+.ion-stepper--vertical .ion-stepper__step {
+  align-items: flex-start;
+  padding-bottom: var(--spacing-24);
+}
+
+.ion-stepper--horizontal .ion-stepper__step {
+  flex: 1 1 0;
+  align-items: flex-start;
+}
+
+.ion-stepper--horizontal .ion-stepper__step:last-child {
+  flex: 0 0 auto;
+}
+
+.ion-stepper--vertical .ion-stepper__step:last-child {
+  padding-bottom: 0;
+}
+
+/*
+ * The connector. Drawn by CSS after every step but the last, so it is
+ * decoration that never enters the accessibility tree. It turns primary once
+ * the step before it is complete, which is the "how far have I got" reading.
+ *
+ * A border, not a background: the contrast gate reads `background-color` on a
+ * `::after` as the ground for the whole step, and measured the check glyph
+ * against its own connector at 1:1. It is a line, so it is drawn as one.
+ */
+.ion-stepper--horizontal .ion-stepper__step:not(:last-child)::after {
+  content: '';
+  flex: 1 1 var(--spacing-16);
+  min-width: var(--spacing-16);
+
+  /* Centred on the indicator, not on a step that may carry a description. */
+  margin-top: calc((var(--icon-size-lg) - var(--border-width-thick)) / 2);
+  border-top: var(--border-width-thick) solid var(--border-default);
+}
+
+.ion-stepper--vertical .ion-stepper__step:not(:last-child)::after {
+  content: '';
+  position: absolute;
+  top: calc(var(--icon-size-lg) + var(--spacing-4));
+  bottom: var(--spacing-4);
+
+  /* Centred under the indicator. */
+  left: calc((var(--icon-size-lg) - var(--border-width-thick)) / 2);
+  border-left: var(--border-width-thick) solid var(--border-default);
+}
+
+.ion-stepper__trigger {
+  display: inline-flex;
+  align-items: flex-start;
+  gap: var(--spacing-8);
+  min-width: 0;
+  margin: 0;
+  padding: 0;
+  border: 0;
+  border-radius: var(--radius-xs);
+  background: none;
+  color: inherit;
+  font: inherit;
+  text-align: start;
+  text-decoration: none;
+}
+
+a.ion-stepper__trigger,
+button.ion-stepper__trigger {
+  cursor: pointer;
+}
+
+a.ion-stepper__trigger:focus-visible,
+button.ion-stepper__trigger:focus-visible {
+  outline: var(--border-width-thick) solid var(--border-focus);
+  outline-offset: 2px;
+}
+
+a.ion-stepper__trigger:hover .ion-stepper__label,
+button.ion-stepper__trigger:hover .ion-stepper__label {
+  color: var(--text-default);
+  text-decoration: underline;
+}
+
+.ion-stepper__indicator {
+  display: inline-flex;
+  flex: none;
+  align-items: center;
+  justify-content: center;
+  width: var(--icon-size-lg);
+  height: var(--icon-size-lg);
+  border: var(--border-width-thick) solid var(--border-strong);
+  border-radius: var(--radius-full);
+  color: var(--text-secondary);
+  font-size: var(--type-caption);
+  font-weight: var(--font-weight-semibold);
+  line-height: var(--type-caption-line-height);
+}
+
+.ion-stepper__indicator svg {
+  width: var(--icon-size-sm);
+  height: var(--icon-size-sm);
+}
+
+.ion-stepper__text {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-2);
+  min-width: 0;
+
+  /* Aligns the label's first line with the 24px indicator. */
+  padding-top: var(--spacing-2);
+}
+
+.ion-stepper__description {
+  color: var(--text-tertiary);
+  font-size: var(--type-caption);
+  line-height: var(--type-caption-line-height);
+}
+
+/* complete — a primary check in a primary ring, and a primary connector. */
+.ion-stepper .ion-stepper__step--complete:not(:last-child)::after {
+  border-color: var(--border-primary);
+}
+
+.ion-stepper__step--complete .ion-stepper__indicator {
+  border-color: var(--border-primary);
+  color: var(--icon-primary);
+}
+
+/* error — the same ring in error, with a different glyph. */
+.ion-stepper__step--error {
+  color: var(--text-error);
+}
+
+.ion-stepper__step--error .ion-stepper__indicator {
+  border-color: var(--border-error);
+  color: var(--icon-error);
+}
+
+/*
+ * current — the one filled indicator on the row, so the position reads at a
+ * glance. The label goes to the strongest text colour for the same reason
+ * Breadcrumb's current crumb does.
+ */
+.ion-stepper__step--current {
+  color: var(--text-default);
+}
+
+.ion-stepper__step--current .ion-stepper__indicator {
+  border-color: var(--surface-primary);
+  background-color: var(--surface-primary);
+  color: var(--text-on-color);
+}
+
+.ion-stepper__step--current.ion-stepper__step--error {
+  color: var(--text-error);
+}
+
+.ion-stepper__step--current.ion-stepper__step--error .ion-stepper__indicator {
+  border-color: var(--surface-error);
+  background-color: var(--surface-error);
+  color: var(--text-on-color);
+}
+
+/*
+ * Narrow containers: a horizontal stepper keeps every indicator and only the
+ * current step's label. The other labels are hidden visually, NOT removed, so
+ * "Step 2 of 5: Shipping, Completed" is still read for each of them.
+ */
+@container (max-width: 40rem) {
+  .ion-stepper--horizontal .ion-stepper__step--current {
+    flex: 0 1 auto;
+  }
+
+  .ion-stepper--horizontal
+    .ion-stepper__step:not(.ion-stepper__step--current)
+    .ion-stepper__text {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+}
+
+/*
+ * Forced colours throw the primary fill away, which would leave the current
+ * step looking like every other. A heavier ring survives, because width is
+ * not a colour. (Not `Highlight` + `forced-color-adjust: none`: the contrast
+ * gate flattens at-rules, and a system colour here replaced the real fill in
+ * its model, so the white-on-primary pairing silently went unmeasured.)
+ */
+@media (forced-colors: active) {
+  .ion-stepper__step--current .ion-stepper__indicator {
+    border-width: var(--border-width-thicker);
+  }
+}

package/dist/styles/tool-call.css

@@ -0,0 +1,202 @@
+/*
+ * ToolCall
+ *
+ * Drawn in Figma as `Tool Call` (1392:391), from this file. The header row is AgentActivity's step one rung up —
+ * same glyphs, same status colours, read from the same module — and the
+ * disclosure chevron and its rotation are Accordion's. The error strip is
+ * Alert's subtle error pairing.
+ *
+ * The card surface is on the BLOCK, not an inner wrapper, so the contrast gate
+ * resolves the header's translucent `surface/hover` against a real ground.
+ * drawer.css records what happens otherwise: the pairing is skipped, silently.
+ */
+.ion-tool-call {
+  overflow: hidden;
+  border: var(--border-width-default) solid var(--border-subtle);
+  border-radius: var(--radius-md);
+  background-color: var(--surface-default);
+  color: var(--text-default);
+  font-family: var(--font-family-sans);
+  font-size: var(--type-body-sm);
+  line-height: var(--type-body-sm-line-height);
+}
+
+.ion-tool-call__header {
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-8);
+  width: 100%;
+  margin: 0;
+  padding: var(--spacing-8) var(--spacing-12);
+  border: 0;
+  background: none;
+  color: inherit;
+  font: inherit;
+  text-align: start;
+}
+
+button.ion-tool-call__header {
+  cursor: pointer;
+}
+
+@media (hover: hover) {
+  /* The colour is restated so the contrast gate has a pair to measure; with
+   * the background alone the hover state was never checked. */
+  button.ion-tool-call__header:hover {
+    background-color: var(--surface-hover);
+    color: var(--text-default);
+  }
+}
+
+button.ion-tool-call__header:focus-visible {
+  outline: var(--border-width-thick) solid var(--border-focus);
+  outline-offset: calc(-1 * var(--border-width-thick));
+}
+
+.ion-tool-call__glyph {
+  display: inline-flex;
+  flex: none;
+  width: var(--icon-size-sm);
+  height: var(--icon-size-sm);
+  color: var(--icon-tertiary);
+}
+
+.ion-tool-call__glyph svg,
+.ion-tool-call__chevron svg {
+  width: 100%;
+  height: 100%;
+}
+
+.ion-tool-call__heading {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: baseline;
+  flex: 1 1 auto;
+  column-gap: var(--spacing-8);
+  min-width: 0;
+}
+
+.ion-tool-call__title {
+  font-weight: var(--font-weight-medium);
+}
+
+.ion-tool-call__name {
+  color: var(--text-tertiary);
+  font-family: var(--font-family-mono);
+  font-size: var(--type-caption);
+  line-height: var(--type-caption-line-height);
+  overflow-wrap: anywhere;
+}
+
+.ion-tool-call__duration {
+  flex: none;
+  color: var(--text-tertiary);
+  font-size: var(--type-caption);
+  line-height: var(--type-caption-line-height);
+  font-variant-numeric: tabular-nums;
+}
+
+.ion-tool-call__chevron {
+  display: inline-flex;
+  flex: none;
+  width: var(--icon-size-sm);
+  height: var(--icon-size-sm);
+  color: var(--icon-secondary);
+  transition: transform var(--ion-duration-base) var(--ion-ease-out);
+}
+
+.ion-tool-call--expanded .ion-tool-call__chevron {
+  transform: rotate(180deg);
+}
+
+/*
+ * Outside the disclosure on purpose: the failure is the one part of a call a
+ * reader must not have to click to find.
+ */
+.ion-tool-call__error {
+  padding: var(--spacing-8) var(--spacing-12);
+  border-top: var(--border-width-default) solid var(--border-error-subtle);
+  background-color: var(--surface-error-subtle);
+  color: var(--text-error);
+}
+
+.ion-tool-call__body {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-12);
+  padding: var(--spacing-12);
+  border-top: var(--border-width-default) solid var(--border-subtle);
+}
+
+.ion-tool-call__section {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-4);
+}
+
+.ion-tool-call__label {
+  color: var(--text-secondary);
+  font-size: var(--type-caption);
+  line-height: var(--type-caption-line-height);
+  font-weight: var(--font-weight-medium);
+}
+
+/*
+ * Wraps rather than scrolling sideways: a long string in a JSON value would
+ * otherwise force a horizontal scrollbar on a phone. Height is capped, and the
+ * element is focusable (tabIndex 0 in the component) so the cap never hides
+ * content from a keyboard user.
+ */
+.ion-tool-call__payload {
+  max-height: 16rem;
+  margin: 0;
+  padding: var(--spacing-8);
+  overflow: auto;
+  border-radius: var(--radius-sm);
+  background-color: var(--surface-muted);
+  color: var(--text-default);
+  font-family: var(--font-family-mono);
+  font-size: var(--type-caption);
+  line-height: var(--type-caption-line-height);
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+}
+
+.ion-tool-call__payload:focus-visible {
+  outline: var(--border-width-thick) solid var(--border-focus);
+  outline-offset: 2px;
+}
+
+/* Status: the colour is the second signal — glyph shape and hidden text first. */
+.ion-tool-call--active .ion-tool-call__glyph {
+  color: var(--icon-primary);
+  animation: ion-tool-call-spin 1.2s linear infinite;
+}
+
+.ion-tool-call--done .ion-tool-call__glyph {
+  color: var(--icon-success);
+}
+
+.ion-tool-call--failed .ion-tool-call__glyph {
+  color: var(--icon-error);
+}
+
+.ion-tool-call--skipped .ion-tool-call__title {
+  color: var(--text-tertiary);
+}
+
+@keyframes ion-tool-call-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ion-tool-call--active .ion-tool-call__glyph {
+    animation: none;
+  }
+
+  .ion-tool-call__chevron {
+    transition: none;
+  }
+}

package/llms.txt

@@ -2,7 +2,7 @@
 
 > IonBase is a React design system for enterprise SaaS, built to be consumed by an agent rather than read by a developer. Every component ships a machine-readable contract carrying the judgement a type signature cannot: when to use it, what to use instead, the anti-patterns, and what it guarantees for accessibility versus what it requires of you.
 
-Version 0.51.0. 48 components.
+Version 0.69.0. 70 components.
 
 ## Read these, in this order
 
@@ -13,7 +13,7 @@ Both are importable: `ionbase-ui/meta/index` and `ionbase-ui/meta/<Name>.json`.
 
 ## Components
 
-`AgentActivity`, `AgentActivityStep`, `AgentStop`, `Alert`, `ApprovalGate`, `Avatar`, `AvatarGradient`, `AvatarGroup`, `Badge`, `Button`, `Checkbox`, `Citation`, `CitationList`, `CitationListItem`, `ConfidenceIndicator`, `Divider`, `EmptyState`, `FullCard`, `Header`, `Icon`, `Input`, `Link`, `Logo`, `LogoMark`, `Menu`, `MenuItem`, `Modal`, `NavItem`, `Pagination`, `PhoneInput`, `Popover`, `Radio`, `RadioGroup`, `ScrollProgress`, `Select`, `StreamingText`, `TabItem`, `Table`, `TableBody`, `TableCell`, `TableHead`, `TableRow`, `Tabs`, `Textarea`, `Toast`, `ToastProvider`, `Toggle`, `Tooltip`
+`Accordion`, `AccordionItem`, `AgentActivity`, `AgentActivityStep`, `AgentStop`, `Alert`, `ApprovalGate`, `Avatar`, `AvatarGradient`, `AvatarGroup`, `Badge`, `Breadcrumb`, `BreadcrumbItem`, `Button`, `Checkbox`, `Citation`, `CitationList`, `CitationListItem`, `Combobox`, `ConfidenceIndicator`, `DatePicker`, `DateRangePicker`, `Divider`, `Drawer`, `EmptyState`, `FileUpload`, `FullCard`, `Header`, `Icon`, `Input`, `Link`, `Logo`, `LogoMark`, `Menu`, `MenuItem`, `Modal`, `NavItem`, `NumberInput`, `Pagination`, `PhoneInput`, `Popover`, `ProgressBar`, `PromptInput`, `Radio`, `RadioGroup`, `ScrollProgress`, `SegmentedControl`, `SegmentedControlItem`, `Select`, `Sidebar`, `SidebarItem`, `SidebarSection`, `Skeleton`, `Spinner`, `Stepper`, `StepperStep`, `StreamingText`, `TabItem`, `Table`, `TableBody`, `TableCell`, `TableHead`, `TableRow`, `Tabs`, `Textarea`, `Toast`, `ToastProvider`, `Toggle`, `ToolCall`, `Tooltip`
 
 ## Patterns
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ionbase-ui",
-  "version": "0.51.0",
+  "version": "0.69.0",
   "description": "IonBase Design System — accessible React components, styles and design tokens in one package",
   "license": "MIT",
   "type": "module",
@@ -85,6 +85,7 @@
     "eslint": "^8.57.0 || ^9.0.0"
   },
   "dependencies": {
+    "@internationalized/date": "^3.12.2",
     "@react-stately/collections": "^3.13.1",
     "@react-types/shared": "^3.36.0",
     "react-aria": "^3.34.0",