@charcuterie/ui 3.5.0 → 3.6.0

package/dist/Stepper/Stepper.d.ts

@@ -0,0 +1,89 @@
+import type { ReactNode } from "react";
+/**
+ * Where a step sits in the sequence.
+ *
+ * `blocked` is not a worse `upcoming`. Upcoming means "its turn has
+ * not come"; blocked means "its turn has come and something is in
+ * the way", which is a thing to go and fix rather than a thing to
+ * wait for. Docket's phases need exactly this split — a phase gated
+ * behind an unfinished one, versus a phase gated behind an EMPTY
+ * one, where the second is a mistake somebody has to correct.
+ */
+export type StepStatus = "blocked" | "current" | "done" | "upcoming";
+export type Step = {
+    /** What the marker shows instead of its ordinal position. */
+    readonly marker?: ReactNode;
+    readonly key: string;
+    readonly label: ReactNode;
+    /** One line under the label — why it is blocked, what it is
+     * waiting on, when it finished. */
+    readonly description?: ReactNode;
+    /**
+     * What BELONGS to this step: the tasks in a phase, the fields in
+     * a form stage, the checks in a pipeline.
+     *
+     * The reason this component is not a `ProgressBar` with a legend.
+     * A bar says a sequence is half done; only the contents say which
+     * things go together and which one is next.
+     */
+    readonly content?: ReactNode;
+    readonly status?: StepStatus;
+};
+export type StepperOrientation = "horizontal" | "vertical";
+export type StepperProps = {
+    readonly className?: string;
+    /**
+     * What level the step labels are. The caller's, because only the
+     * caller knows what the stepper sits under — one below a page
+     * `<h1>` wants `2`, one inside an already-deep section wants `4`.
+     * Getting it wrong is an axe `heading-order` failure and a broken
+     * screen-reader outline.
+     */
+    readonly headingLevel?: 2 | 3 | 4 | 5;
+    /** The list's accessible name. Required — an unnamed sequence of
+     * numbers is a sequence of numbers. */
+    readonly label: string;
+    /**
+     * `horizontal` is a REQUEST, not a promise: it collapses to
+     * vertical below `cq-md`, because four steps side by side in a
+     * narrow container squash into unreadable slivers (`2. / De- /
+     * dupe`, measured). A step carrying `content` should stay
+     * vertical — a column cannot hold a list.
+     */
+    readonly orientation?: StepperOrientation;
+    readonly steps: readonly Step[];
+};
+/**
+ * An ordered sequence of steps, with what belongs to each one.
+ *
+ * ### Why the status is never colour alone
+ *
+ * Four states painted only as four marker colours is a WCAG 1.4.1
+ * failure however clear it looks, so each status reaches a screen
+ * reader as a word — `VisuallyHidden`, next to the label — and gets
+ * a second visual channel besides hue: a **filled** marker for done
+ * and current, an **outlined** one for upcoming and blocked, and a
+ * connector that is solid behind finished work and dashed ahead of
+ * it.
+ *
+ * ### Why the marker is a number and never a tick
+ *
+ * This library
+ * [ships no icons and no symbol glyphs](../../../../docs/decisions/2026-07-29-ship-no-icons-and-no-symbol-glyphs.md).
+ * A `✓` renders as an empty box wherever the font lacks it — which
+ * includes the sandbox chromium, the kiosk image and the ePaper
+ * build — and an empty box in the "done" position reads as an error.
+ * The ordinal always renders. An app that owns a glyph set can pass
+ * one as `marker`.
+ *
+ * ### Why the connector is an element
+ *
+ * Not a `::before`. `styles.css` is reserved for the handful of
+ * visuals a Tailwind utility genuinely cannot express — the looping
+ * animations and the scrollbar — and a line between two markers is
+ * not one of them. A real `<span aria-hidden>` also stops the last
+ * step drawing a connector into empty space, which is a
+ * `:not(:last-child)` selector nobody remembers to write.
+ */
+export declare const Stepper: ({ className, headingLevel, label, orientation, steps, }: StepperProps) => import("react").JSX.Element;
+//# sourceMappingURL=Stepper.d.ts.map

package/dist/Stepper/Stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stepper.d.ts","sourceRoot":"","sources":["../../src/Stepper/Stepper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,MAAM,GACN,UAAU,CAAA;AAEd,MAAM,MAAM,IAAI,GAAG;IACjB,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB;uCACmC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,UAAU,CAAA;AAE1D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACrC;2CACuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;CAChC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,OAAO,GAAI,yDAMrB,YAAY,gCAmHd,CAAA"}

package/dist/Stepper/Stepper.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { toClassName } from "../toClassName.js";
+import { VisuallyHidden } from "../VisuallyHidden/VisuallyHidden.js";
+/**
+ * An ordered sequence of steps, with what belongs to each one.
+ *
+ * ### Why the status is never colour alone
+ *
+ * Four states painted only as four marker colours is a WCAG 1.4.1
+ * failure however clear it looks, so each status reaches a screen
+ * reader as a word — `VisuallyHidden`, next to the label — and gets
+ * a second visual channel besides hue: a **filled** marker for done
+ * and current, an **outlined** one for upcoming and blocked, and a
+ * connector that is solid behind finished work and dashed ahead of
+ * it.
+ *
+ * ### Why the marker is a number and never a tick
+ *
+ * This library
+ * [ships no icons and no symbol glyphs](../../../../docs/decisions/2026-07-29-ship-no-icons-and-no-symbol-glyphs.md).
+ * A `✓` renders as an empty box wherever the font lacks it — which
+ * includes the sandbox chromium, the kiosk image and the ePaper
+ * build — and an empty box in the "done" position reads as an error.
+ * The ordinal always renders. An app that owns a glyph set can pass
+ * one as `marker`.
+ *
+ * ### Why the connector is an element
+ *
+ * Not a `::before`. `styles.css` is reserved for the handful of
+ * visuals a Tailwind utility genuinely cannot express — the looping
+ * animations and the scrollbar — and a line between two markers is
+ * not one of them. A real `<span aria-hidden>` also stops the last
+ * step drawing a connector into empty space, which is a
+ * `:not(:last-child)` selector nobody remembers to write.
+ */
+export const Stepper = ({ className, headingLevel = 3, label, orientation = "vertical", steps, }) => {
+    const Heading = `h${headingLevel}`;
+    const isHorizontal = orientation === "horizontal";
+    return (_jsx("div", { className: toClassName("@container", className), children: _jsx("ol", { "aria-label": label, className: toClassName("flex list-none flex-col gap-5 p-0", 
+            // Horizontal is the WIDE answer only. Below `cq-md` this
+            // falls back to the column, which is the same rule
+            // `Board` follows and for the same reason: the owner
+            // browses zoomed in, so a window's width is not the
+            // number of pixels anything actually has.
+            isHorizontal && "cq-md:flex-row cq-md:gap-0"), children: steps.map((step, index) => {
+                const status = step.status ?? "upcoming";
+                const isLast = index === steps.length - 1;
+                return (_jsxs("li", { className: toClassName("relative grid grid-cols-[auto_minmax(0,1fr)] grid-rows-[auto_minmax(0,1fr)] gap-x-3", isHorizontal &&
+                        "cq-md:flex cq-md:min-w-0 cq-md:flex-1 cq-md:flex-col cq-md:gap-y-2", 
+                    // Blocked and upcoming recede; the step you can act
+                    // on is the one that keeps full contrast. Opacity
+                    // rather than a muted token so the step's own
+                    // contents dim with it — a task list at full strength
+                    // under a dimmed heading reads as startable.
+                    (status === "blocked" ||
+                        status === "upcoming") &&
+                        "opacity-70"), children: [_jsx("span", { className: toClassName("col-start-1 row-start-1 grid size-7 place-items-center rounded-full border text-sm tabular-nums", STATUS_MARKER_CLASS[status], isHorizontal && "cq-md:col-start-1"), children: step.marker ?? index + 1 }), isLast ? null : (_jsx("span", { "aria-hidden": true, className: toClassName("col-start-1 row-start-2 my-1 w-0.5 justify-self-center rounded-full", 
+                            // Solid behind finished work, dashed ahead of it
+                            // — the second visual channel that keeps this
+                            // from being colour alone.
+                            status === "done"
+                                ? "bg-intent-success-solid"
+                                : "bg-border-subtle", isHorizontal &&
+                                "cq-md:absolute cq-md:top-3.5 cq-md:start-7 cq-md:my-0 cq-md:h-0.5 cq-md:w-[calc(100%-1.75rem)]") })), _jsxs("div", { className: toClassName("col-start-2 row-span-2 row-start-1 min-w-0", isHorizontal && "cq-md:col-start-1"), children: [_jsxs(Heading, { className: "m-0 flex flex-wrap items-center gap-2 text-md font-medium text-content-primary", children: [step.label, _jsx(VisuallyHidden, { children: STATUS_LABEL[status] })] }), step.description == null ? null : (_jsx("p", { className: "mt-0.5 mb-0 text-sm text-content-secondary", children: step.description })), step.content == null ? null : (_jsx("div", { className: "mt-2", children: step.content }))] })] }, step.key));
+            }) }) }));
+};
+/**
+ * Written out in full, never interpolated. Tailwind v4 scans source
+ * text for COMPLETE class strings, so `` `bg-intent-${x}-solid` ``
+ * generates nothing at all and the element paints transparent with
+ * no error and no failing test —
+ * `tailwindCandidates.test.ts` is what makes this near-duplication
+ * safe to keep.
+ */
+const STATUS_MARKER_CLASS = {
+    blocked: "border-intent-warning-border bg-intent-warning-surface text-intent-warning-content",
+    current: "border-intent-accent-border bg-intent-accent-surface text-intent-accent-content",
+    done: "border-intent-success-border bg-intent-success-solid text-intent-success-on-solid",
+    upcoming: "border-border-subtle bg-surface-raised text-content-secondary",
+};
+const STATUS_LABEL = {
+    blocked: "Blocked",
+    current: "In progress",
+    done: "Done",
+    upcoming: "Not started",
+};
+//# sourceMappingURL=Stepper.js.map

package/dist/Stepper/Stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stepper.js","sourceRoot":"","sources":["../../src/Stepper/Stepper.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -145,6 +145,8 @@ export type { SortableTableHeaderProps, SortDirection, } from "./SortableTableHe
 export { SortableTableHeader } from "./SortableTableHeader/SortableTableHeader.tsx";
 export type { SpinnerProps } from "./Spinner/Spinner.tsx";
 export { Spinner } from "./Spinner/Spinner.tsx";
+export type { Step, StepperOrientation, StepperProps, StepStatus, } from "./Stepper/Stepper.tsx";
+export { Stepper } from "./Stepper/Stepper.tsx";
 export type { SwatchAppearance, SwatchProps, SwatchSize, } from "./Swatch/Swatch.tsx";
 export { Swatch } from "./Swatch/Swatch.tsx";
 export type { SwitchProps } from "./Switch/Switch.tsx";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -88,6 +88,7 @@ export { Shell } from "./Shell/Shell.js";
 export { Skeleton } from "./Skeleton/Skeleton.js";
 export { SortableTableHeader } from "./SortableTableHeader/SortableTableHeader.js";
 export { Spinner } from "./Spinner/Spinner.js";
+export { Stepper } from "./Stepper/Stepper.js";
 export { Swatch } from "./Swatch/Swatch.js";
 export { Switch } from "./Switch/Switch.js";
 export { mergeSlotProps } from "./slotProps.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@charcuterie/ui",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "The Charcuterie components. Tokens for look, @charcuterie/logic for state, ARIA that agents can actually drive.",
   "license": "MIT",
   "type": "module",

package/src/Stepper/Stepper.mdx

@@ -0,0 +1,86 @@
+import { Canvas, Controls, Meta } from "@storybook/addon-docs/blocks";
+
+import * as StepperStories from "./Stepper.stories";
+
+<Meta of={StepperStories} />
+
+# Stepper
+
+An ordered sequence of steps, with **what belongs to each one** under it.
+
+Docket asked for this. Its phases — *"these 3 cards have to be done in order"* — were a
+hand-rolled numbered rail with a connector drawn in a `::before`, and a `ProgressBar` per
+phase for the count. Neither says which things go together.
+
+<Canvas of={StepperStories.Default} />
+
+## Props
+
+<Controls />
+
+## Why a step carries content
+
+This is the difference between a stepper and a progress bar with a legend. A bar says a
+sequence is half done; only the contents say **which three things go together and which
+one is next**.
+
+```tsx
+<Stepper
+  label="Ingest sequence"
+  steps={phases.map((phase) => ({
+    content: <TaskList tasks={tasksIn(phase)} />,
+    description: gateReason(phase),
+    key: phase.id,
+    label: phase.name,
+    status: statusOf(phase),
+  }))}
+/>
+```
+
+## The four statuses, and why `blocked` is not a worse `upcoming`
+
+| Status | Means |
+| --- | --- |
+| `done` | Finished. |
+| `current` | Being worked on. |
+| `upcoming` | Its turn has not come. |
+| `blocked` | Its turn **has** come and something is in the way. |
+
+The last two look alike and are not. `upcoming` is a thing to wait for; `blocked` is a
+thing to go and fix, and collapsing them hides the second behind the first. Docket's case
+is exact: a phase gated behind an *unfinished* phase is normal, and a phase gated behind an
+**empty** one is a mistake somebody has to correct — the same grey pill for both is how
+that sits unnoticed.
+
+## Status is never colour alone
+
+Four marker colours is four colours as far as assistive technology, a greyscale print and
+the ePaper build are concerned — a WCAG 1.4.1 failure however clear it looks. So the status
+reaches a screen reader as a **word**, in a `VisuallyHidden` beside the label, and gets a
+second visual channel besides hue: a filled marker for finished work, an outlined one
+ahead of it, and a connector that is solid behind and subdued in front.
+
+## The marker is the ordinal, never a tick
+
+This library
+[ships no icons and no symbol glyphs](?path=/docs/guides-decisions--docs). A `✓` renders as
+an empty box wherever the font lacks it — the sandbox chromium, the kiosk image, the ePaper
+build — and an empty box in the "done" position reads as an *error*, which is the opposite
+of what it meant. The ordinal always renders. An app that owns a glyph set passes one as
+`marker`.
+
+## `horizontal` is a request, not a promise
+
+It collapses to the vertical column below `cq-md`. Four steps side by side in a narrow
+container squash into `2. / De- / dupe` — measured, in the app this came out of, before any
+of them contained anything. A step carrying `content` should stay vertical regardless: a
+column cannot hold a list.
+
+<Canvas of={StepperStories.Responsive} />
+
+## There is nothing to focus
+
+A stepper is a **document outline**, not a widget: an `<ol>` of headings. Advancing is the
+app's operation and the component only reports where the sequence got to, so there is no
+roving focus, no `aria-current` on a control, and nothing to arrow between. If your steps
+are *navigable* — a checkout you can click back into — you want `Tabs`.

package/src/Stepper/Stepper.stories.tsx

@@ -0,0 +1,224 @@
+import type { Meta, StoryObj } from "@storybook/react"
+import { useState } from "react"
+import { Button } from "../Button/Button.tsx"
+import {
+  ContainerBoard,
+  StoryCell,
+  StoryGrid,
+  StorySection,
+} from "../board.storyHelpers.tsx"
+import { Card } from "../Card/Card.tsx"
+import type { Step } from "./Stepper.tsx"
+import { Stepper } from "./Stepper.tsx"
+
+const RIP: Step[] = [
+  {
+    description: "3 of 3 discs read",
+    key: "rip",
+    label: "Rip",
+    status: "done",
+  },
+  {
+    description: "2 of 5 titles tagged",
+    key: "tag",
+    label: "Tag",
+    status: "current",
+  },
+  {
+    description: "Opens when Tag is finished",
+    key: "file",
+    label: "File",
+    status: "upcoming",
+  },
+]
+
+const meta = {
+  title: "Components/Data/Stepper",
+  component: Stepper,
+  parameters: { layout: "padded" },
+  args: {
+    headingLevel: 3,
+    label: "Ingest sequence",
+    orientation: "vertical",
+    steps: RIP,
+  },
+} satisfies Meta<typeof Stepper>
+
+export default meta
+
+type Story = StoryObj<typeof meta>
+
+/**
+ * The marker is the ordinal and never a tick — this library ships
+ * no icons and no symbol glyphs, and a `✓` the font lacks renders
+ * as an empty box in the one position where an empty box reads as
+ * an error.
+ */
+export const Default: Story = {}
+
+export const AllVariants: Story = {
+  render: (stepperProps) => (
+    <StorySection title="Four statuses, two orientations, and the case the component exists for: steps that CARRY something.">
+      <StoryGrid columns={2}>
+        <StoryCell align="stretch" label="vertical">
+          <Stepper {...stepperProps} />
+        </StoryCell>
+
+        <StoryCell
+          align="stretch"
+          label="orientation=horizontal"
+        >
+          <Stepper
+            {...stepperProps}
+            label="Ingest sequence, across"
+            orientation="horizontal"
+          />
+        </StoryCell>
+
+        <StoryCell align="stretch" label="status=blocked">
+          {/* Blocked is not a worse `upcoming`. Its turn HAS come
+              and something is in the way — a thing to go and fix
+              rather than a thing to wait for. */}
+          <Stepper
+            {...stepperProps}
+            label="A sequence held up"
+            steps={[
+              { key: "a", label: "Rip", status: "done" },
+              {
+                description:
+                  "Waiting on Rip, which has no titles yet — add one, or delete the step",
+                key: "b",
+                label: "Tag",
+                status: "blocked",
+              },
+              {
+                key: "c",
+                label: "File",
+                status: "upcoming",
+              },
+            ]}
+          />
+        </StoryCell>
+
+        <StoryCell
+          align="stretch"
+          label="steps that carry content"
+        >
+          <Stepper
+            {...stepperProps}
+            label="A sequence with its work under it"
+            steps={[
+              {
+                content: (
+                  <Card>Read the disc into an ISO</Card>
+                ),
+                key: "a",
+                label: "Rip",
+                status: "done",
+              },
+              {
+                content: <Card>Match each title</Card>,
+                key: "b",
+                label: "Tag",
+                status: "current",
+              },
+            ]}
+          />
+        </StoryCell>
+      </StoryGrid>
+    </StorySection>
+  ),
+}
+
+export const AllStates: Story = {
+  render: (stepperProps) => (
+    <StorySection title="Every status beside every other, so the four are legible as a set rather than one at a time.">
+      <Stepper
+        {...stepperProps}
+        label="Every status"
+        steps={[
+          { key: "a", label: "Done", status: "done" },
+          {
+            key: "b",
+            label: "In progress",
+            status: "current",
+          },
+          { key: "c", label: "Blocked", status: "blocked" },
+          {
+            key: "d",
+            label: "Not started",
+            status: "upcoming",
+          },
+        ]}
+      />
+    </StorySection>
+  ),
+}
+
+/**
+ * `horizontal` is a REQUEST. Below `cq-md` it falls back to the
+ * column, because four steps side by side in a narrow container
+ * squash into `2. / De- / dupe` — measured, in the app this
+ * component came out of.
+ */
+export const Responsive: Story = {
+  args: { orientation: "horizontal" },
+  render: (stepperProps) => (
+    <ContainerBoard>
+      <Stepper {...stepperProps} />
+    </ContainerBoard>
+  ),
+}
+
+/**
+ * The whole keyboard path, which is the point of the headings: a
+ * stepper is a document outline, not a widget. There is nothing to
+ * focus and nothing to arrow between — advancing is the app's
+ * operation, and the component only reports where the sequence got
+ * to.
+ */
+export const Interactive: Story = {
+  render: (stepperProps) => {
+    const [reached, setReached] = useState(1)
+
+    return (
+      <div className="flex flex-col gap-3">
+        <div className="flex gap-2">
+          <Button
+            isDisabled={reached === 0}
+            onClick={() => {
+              setReached((was) => was - 1)
+            }}
+            type="button"
+          >
+            Back
+          </Button>
+          <Button
+            intent="accent"
+            isDisabled={reached === RIP.length}
+            onClick={() => {
+              setReached((was) => was + 1)
+            }}
+            type="button"
+          >
+            Advance
+          </Button>
+        </div>
+
+        <Stepper
+          {...stepperProps}
+          steps={RIP.map((step, index) => ({
+            ...step,
+            description: undefined,
+            status:
+              index < reached
+                ? ("done" as const)
+                : index === reached
+                  ? ("current" as const)
+                  : ("upcoming" as const),
+          }))}
+        />
+      </div>
+    )
+  },
+}

package/src/Stepper/Stepper.test.tsx

@@ -0,0 +1,112 @@
+import { composeStories } from "@storybook/react"
+import { expect, userEvent } from "storybook/test"
+import { test } from "vitest"
+
+import { expectNoAxeViolations } from "../expectNoAxeViolations.testHelpers.ts"
+import { mountStory } from "../mountStory.testHelpers.ts"
+import * as stories from "./Stepper.stories.tsx"
+
+const { AllStates, Default, Interactive, Responsive } =
+  composeStories(stories)
+
+test("the sequence is an ordered list with a name", async () => {
+  const { canvas } = await mountStory(Default)
+
+  // A `<ol>`, not a stack of divs: the ORDER is the meaning, and a
+  // screen reader announcing "list, 3 items" is what carries it.
+  await expect(
+    canvas.getByRole("list", { name: "Ingest sequence" }),
+  ).toBeVisible()
+  await expect(
+    canvas.getAllByRole("listitem"),
+  ).toHaveLength(3)
+})
+
+test("each step is a heading at the level the caller asked for", async () => {
+  const { canvas } = await mountStory(Default)
+
+  await expect(
+    canvas.getByRole("heading", { level: 3, name: /Rip/ }),
+  ).toBeVisible()
+})
+
+/**
+ * The rule this component turns on. Four statuses painted as four
+ * marker colours is a WCAG 1.4.1 failure however clear it looks,
+ * so every status reaches a screen reader as a word — and that is
+ * also the only channel that survives greyscale and the ePaper
+ * build.
+ */
+test("every status is a word, not only a colour", async () => {
+  const { canvas } = await mountStory(AllStates)
+
+  for (const status of [
+    "Done",
+    "In progress",
+    "Blocked",
+    "Not started",
+  ]) {
+    // Twice each: once as the step's visible label in this story,
+    // once as the visually-hidden status.
+    await expect(
+      canvas.getAllByText(status).length,
+    ).toBeGreaterThanOrEqual(2)
+  }
+})
+
+test("the marker is the ordinal, so it renders in a font with no tick glyph", async () => {
+  const { canvas } = await mountStory(Default)
+
+  // Not `✓`. `docs/decisions/2026-07-29-ship-no-icons-and-no-symbol-
+  // glyphs.md` — a glyph the font lacks paints as an empty box, and
+  // an empty box in the "done" position reads as an error.
+  await expect(canvas.getByText("1")).toBeVisible()
+  await expect(canvas.getByText("3")).toBeVisible()
+})
+
+/**
+ * The last step must not draw a connector into empty space. A real
+ * element rather than a `::before` is what makes this assertable at
+ * all — a pseudo-element has nothing to count.
+ */
+test("the last step draws no connector", async () => {
+  const { canvas } = await mountStory(Default)
+
+  const connectors = canvas
+    .getAllByRole("listitem")
+    .map((item: HTMLElement) =>
+      item.querySelector("span[aria-hidden='true']"),
+    )
+
+  await expect(connectors.filter(Boolean)).toHaveLength(2)
+  await expect(connectors[2]).toBeNull()
+})
+
+test("advancing moves which step is current", async () => {
+  const { canvas } = await mountStory(Interactive)
+
+  const heading = () =>
+    canvas.getByRole("heading", { level: 3, name: /Tag/ })
+
+  await expect(heading()).toBeVisible()
+
+  await userEvent.click(
+    canvas.getByRole("button", { name: "Advance" }),
+  )
+
+  // Tag was current and is now done — the status word is the
+  // assertion, because it is the only channel that is not a colour.
+  await expect(
+    heading().textContent?.includes("Done"),
+  ).toBe(true)
+})
+
+test("no axe violations, in either orientation", async () => {
+  const vertical = await mountStory(Default)
+
+  await expectNoAxeViolations(vertical.canvasElement)
+
+  const horizontal = await mountStory(Responsive)
+
+  await expectNoAxeViolations(horizontal.canvasElement)
+})

package/src/Stepper/Stepper.tsx

@@ -0,0 +1,246 @@
+import type { ReactNode } from "react"
+
+import { toClassName } from "../toClassName.ts"
+import { VisuallyHidden } from "../VisuallyHidden/VisuallyHidden.tsx"
+
+/**
+ * Where a step sits in the sequence.
+ *
+ * `blocked` is not a worse `upcoming`. Upcoming means "its turn has
+ * not come"; blocked means "its turn has come and something is in
+ * the way", which is a thing to go and fix rather than a thing to
+ * wait for. Docket's phases need exactly this split — a phase gated
+ * behind an unfinished one, versus a phase gated behind an EMPTY
+ * one, where the second is a mistake somebody has to correct.
+ */
+export type StepStatus =
+  | "blocked"
+  | "current"
+  | "done"
+  | "upcoming"
+
+export type Step = {
+  /** What the marker shows instead of its ordinal position. */
+  readonly marker?: ReactNode
+  readonly key: string
+  readonly label: ReactNode
+  /** One line under the label — why it is blocked, what it is
+   * waiting on, when it finished. */
+  readonly description?: ReactNode
+  /**
+   * What BELONGS to this step: the tasks in a phase, the fields in
+   * a form stage, the checks in a pipeline.
+   *
+   * The reason this component is not a `ProgressBar` with a legend.
+   * A bar says a sequence is half done; only the contents say which
+   * things go together and which one is next.
+   */
+  readonly content?: ReactNode
+  readonly status?: StepStatus
+}
+
+export type StepperOrientation = "horizontal" | "vertical"
+
+export type StepperProps = {
+  readonly className?: string
+  /**
+   * What level the step labels are. The caller's, because only the
+   * caller knows what the stepper sits under — one below a page
+   * `<h1>` wants `2`, one inside an already-deep section wants `4`.
+   * Getting it wrong is an axe `heading-order` failure and a broken
+   * screen-reader outline.
+   */
+  readonly headingLevel?: 2 | 3 | 4 | 5
+  /** The list's accessible name. Required — an unnamed sequence of
+   * numbers is a sequence of numbers. */
+  readonly label: string
+  /**
+   * `horizontal` is a REQUEST, not a promise: it collapses to
+   * vertical below `cq-md`, because four steps side by side in a
+   * narrow container squash into unreadable slivers (`2. / De- /
+   * dupe`, measured). A step carrying `content` should stay
+   * vertical — a column cannot hold a list.
+   */
+  readonly orientation?: StepperOrientation
+  readonly steps: readonly Step[]
+}
+
+/**
+ * An ordered sequence of steps, with what belongs to each one.
+ *
+ * ### Why the status is never colour alone
+ *
+ * Four states painted only as four marker colours is a WCAG 1.4.1
+ * failure however clear it looks, so each status reaches a screen
+ * reader as a word — `VisuallyHidden`, next to the label — and gets
+ * a second visual channel besides hue: a **filled** marker for done
+ * and current, an **outlined** one for upcoming and blocked, and a
+ * connector that is solid behind finished work and dashed ahead of
+ * it.
+ *
+ * ### Why the marker is a number and never a tick
+ *
+ * This library
+ * [ships no icons and no symbol glyphs](../../../../docs/decisions/2026-07-29-ship-no-icons-and-no-symbol-glyphs.md).
+ * A `✓` renders as an empty box wherever the font lacks it — which
+ * includes the sandbox chromium, the kiosk image and the ePaper
+ * build — and an empty box in the "done" position reads as an error.
+ * The ordinal always renders. An app that owns a glyph set can pass
+ * one as `marker`.
+ *
+ * ### Why the connector is an element
+ *
+ * Not a `::before`. `styles.css` is reserved for the handful of
+ * visuals a Tailwind utility genuinely cannot express — the looping
+ * animations and the scrollbar — and a line between two markers is
+ * not one of them. A real `<span aria-hidden>` also stops the last
+ * step drawing a connector into empty space, which is a
+ * `:not(:last-child)` selector nobody remembers to write.
+ */
+export const Stepper = ({
+  className,
+  headingLevel = 3,
+  label,
+  orientation = "vertical",
+  steps,
+}: StepperProps) => {
+  const Heading = `h${headingLevel}` as "h3"
+  const isHorizontal = orientation === "horizontal"
+
+  return (
+    // The container is a WRAPPER, never the `<ol>` itself.
+    //
+    // An element cannot answer its own container query: declaring
+    // `container-type` on the list makes it the query container for
+    // its DESCENDANTS, and `cq-md:` on the list resolves against
+    // whatever container is further up — usually none. The first
+    // version of this component put both on the `<ol>`, and the
+    // result was a horizontal stepper whose CONNECTORS went
+    // horizontal (they are children, so they matched) while the
+    // list stayed a column. Valid CSS, no error, nothing for axe or
+    // a DOM test to say, and obvious the moment it was rendered.
+    // `Board` carries the same note for the same reason.
+    <div className={toClassName("@container", className)}>
+      <ol
+        aria-label={label}
+        className={toClassName(
+          "flex list-none flex-col gap-5 p-0",
+          // Horizontal is the WIDE answer only. Below `cq-md` this
+          // falls back to the column, which is the same rule
+          // `Board` follows and for the same reason: the owner
+          // browses zoomed in, so a window's width is not the
+          // number of pixels anything actually has.
+          isHorizontal && "cq-md:flex-row cq-md:gap-0",
+        )}
+      >
+        {steps.map((step, index) => {
+          const status = step.status ?? "upcoming"
+          const isLast = index === steps.length - 1
+
+          return (
+            <li
+              className={toClassName(
+                "relative grid grid-cols-[auto_minmax(0,1fr)] grid-rows-[auto_minmax(0,1fr)] gap-x-3",
+                isHorizontal &&
+                  "cq-md:flex cq-md:min-w-0 cq-md:flex-1 cq-md:flex-col cq-md:gap-y-2",
+                // Blocked and upcoming recede; the step you can act
+                // on is the one that keeps full contrast. Opacity
+                // rather than a muted token so the step's own
+                // contents dim with it — a task list at full strength
+                // under a dimmed heading reads as startable.
+                (status === "blocked" ||
+                  status === "upcoming") &&
+                  "opacity-70",
+              )}
+              key={step.key}
+            >
+              <span
+                className={toClassName(
+                  "col-start-1 row-start-1 grid size-7 place-items-center rounded-full border text-sm tabular-nums",
+                  STATUS_MARKER_CLASS[status],
+                  isHorizontal && "cq-md:col-start-1",
+                )}
+              >
+                {step.marker ?? index + 1}
+              </span>
+
+              {/* Absent on the last step, so nothing draws a line
+                into empty space. */}
+              {isLast ? null : (
+                <span
+                  aria-hidden
+                  className={toClassName(
+                    "col-start-1 row-start-2 my-1 w-0.5 justify-self-center rounded-full",
+                    // Solid behind finished work, dashed ahead of it
+                    // — the second visual channel that keeps this
+                    // from being colour alone.
+                    status === "done"
+                      ? "bg-intent-success-solid"
+                      : "bg-border-subtle",
+                    isHorizontal &&
+                      "cq-md:absolute cq-md:top-3.5 cq-md:start-7 cq-md:my-0 cq-md:h-0.5 cq-md:w-[calc(100%-1.75rem)]",
+                  )}
+                />
+              )}
+
+              <div
+                className={toClassName(
+                  "col-start-2 row-span-2 row-start-1 min-w-0",
+                  isHorizontal && "cq-md:col-start-1",
+                )}
+              >
+                <Heading className="m-0 flex flex-wrap items-center gap-2 text-md font-medium text-content-primary">
+                  {step.label}
+
+                  {/* The status as a WORD. Four marker colours is
+                    four colours as far as assistive technology is
+                    concerned, and this is the only channel that
+                    survives a screen reader, a greyscale print and
+                    the ePaper build at once. */}
+                  <VisuallyHidden>
+                    {STATUS_LABEL[status]}
+                  </VisuallyHidden>
+                </Heading>
+
+                {step.description == null ? null : (
+                  <p className="mt-0.5 mb-0 text-sm text-content-secondary">
+                    {step.description}
+                  </p>
+                )}
+
+                {step.content == null ? null : (
+                  <div className="mt-2">{step.content}</div>
+                )}
+              </div>
+            </li>
+          )
+        })}
+      </ol>
+    </div>
+  )
+}
+
+/**
+ * Written out in full, never interpolated. Tailwind v4 scans source
+ * text for COMPLETE class strings, so `` `bg-intent-${x}-solid` ``
+ * generates nothing at all and the element paints transparent with
+ * no error and no failing test —
+ * `tailwindCandidates.test.ts` is what makes this near-duplication
+ * safe to keep.
+ */
+const STATUS_MARKER_CLASS: Record<StepStatus, string> = {
+  blocked:
+    "border-intent-warning-border bg-intent-warning-surface text-intent-warning-content",
+  current:
+    "border-intent-accent-border bg-intent-accent-surface text-intent-accent-content",
+  done: "border-intent-success-border bg-intent-success-solid text-intent-success-on-solid",
+  upcoming:
+    "border-border-subtle bg-surface-raised text-content-secondary",
+}
+
+const STATUS_LABEL: Record<StepStatus, string> = {
+  blocked: "Blocked",
+  current: "In progress",
+  done: "Done",
+  upcoming: "Not started",
+}

package/src/index.ts

@@ -328,6 +328,13 @@ export type {
 export { SortableTableHeader } from "./SortableTableHeader/SortableTableHeader.tsx"
 export type { SpinnerProps } from "./Spinner/Spinner.tsx"
 export { Spinner } from "./Spinner/Spinner.tsx"
+export type {
+  Step,
+  StepperOrientation,
+  StepperProps,
+  StepStatus,
+} from "./Stepper/Stepper.tsx"
+export { Stepper } from "./Stepper/Stepper.tsx"
 export type {
   SwatchAppearance,
   SwatchProps,

package/src/sourceRules.test.ts

@@ -236,6 +236,13 @@ test("a container-query component is never storied in a shrink-to-fit cell", ()
     "Main",
     "MarkdownEditor",
     "MediaTile",
+    // `Stepper`'s container is the one that decides whether a
+    // `horizontal` sequence is actually horizontal. Below `--cq-md`
+    // it falls back to the vertical column, because four steps side
+    // by side in a narrow container squash into `2. / De- / dupe` —
+    // measured in Docket, before any of the steps contained
+    // anything.
+    "Stepper",
   ])
 
   // `StoryCell`s are never nested, so the lazy match really does
@@ -430,7 +437,7 @@ test("the barrel is the only place components are re-exported", async () => {
   // `useBoardDrag.ts` are its members and stay out of this count and
   // the barrel by the `<Name>/<Name>.tsx` rule, exactly as
   // `ToolbarSlot` and `QueryBuilderRow` do.
-  expect(componentNames.length).toBe(49)
+  expect(componentNames.length).toBe(50)
 
   for (const name of componentNames) {
     expect(barrel).toContain(`export { ${name} }`)