@sableui/react 0.13.1 → 0.14.0

package/dist/components/chat-composer/use-eased-growth.js

@@ -0,0 +1,70 @@
+"use client";
+
+// src/components/chat-composer/use-eased-growth.ts
+import { useCallback, useEffect, useRef } from "react";
+import { useIsomorphicLayoutEffect } from "../../lib/use-isomorphic-layout-effect.js";
+var GROW_TRANSITION = "height calc(var(--motion-duration-fast) * var(--motion-expressive, 1)) var(--motion-ease-standard), opacity var(--motion-duration-fast) var(--motion-ease-standard)";
+function useEasedGrowth(ref, value) {
+  const mounted = useRef(false);
+  const width = useRef(0);
+  const fit = useCallback(
+    (animate) => {
+      const el = ref.current;
+      if (!el) return;
+      const style = getComputedStyle(el);
+      const from = Number.parseFloat(style.height);
+      const scrollTop = el.scrollTop;
+      el.style.transition = "none";
+      el.style.height = "auto";
+      if (el.scrollHeight === 0) {
+        el.style.height = "";
+        el.style.overflowY = "";
+        el.style.transition = GROW_TRANSITION;
+        return;
+      }
+      const content = el.scrollHeight + (Number.parseFloat(style.borderTopWidth) || 0) + (Number.parseFloat(style.borderBottomWidth) || 0);
+      const max = Number.parseFloat(style.maxHeight);
+      const target = Number.isNaN(max) ? content : Math.min(content, max);
+      const capped = content > target + 0.5;
+      el.style.overflowY = capped ? "" : "hidden";
+      if (animate && Number.isFinite(from)) {
+        el.style.height = `${from}px`;
+        void el.offsetHeight;
+        el.style.transition = GROW_TRANSITION;
+        el.style.height = `${target}px`;
+      } else {
+        el.style.height = `${target}px`;
+        void el.offsetHeight;
+        el.style.transition = GROW_TRANSITION;
+      }
+      el.scrollTop = capped ? scrollTop : 0;
+    },
+    [ref]
+  );
+  useIsomorphicLayoutEffect(() => {
+    fit(mounted.current);
+    mounted.current = true;
+  }, [value, fit]);
+  useEffect(() => {
+    const el = ref.current;
+    if (!el || typeof ResizeObserver === "undefined") return;
+    width.current = el.clientWidth;
+    const ro = new ResizeObserver(() => {
+      if (el.clientWidth === width.current) return;
+      width.current = el.clientWidth;
+      fit(false);
+    });
+    ro.observe(el);
+    let live = true;
+    document.fonts?.ready.then(() => {
+      if (live) fit(false);
+    });
+    return () => {
+      live = false;
+      ro.disconnect();
+    };
+  }, [ref, fit]);
+}
+export {
+  useEasedGrowth
+};

package/dist/components/checkbox/checkbox-mark.js

@@ -9,7 +9,14 @@ function CheckboxMark({ className }) {
     Base.Indicator,
     {
       className: cn(
-        "flex items-center justify-center text-current motion-interactive ease-spring data-[starting-style]:scale-0 data-[starting-style]:opacity-0 data-[ending-style]:scale-0 data-[ending-style]:opacity-0",
+        // motion-tick, not a scale from 0: the mark wipes in from its leading
+        // stroke, so checking reads as a tick being drawn rather than a dot
+        // swelling into a check. The dash takes the same wipe, which for a
+        // horizontal bar is simply a line drawn left to right. It declares its
+        // own transition list, so motion-interactive must not sit here too —
+        // two transition-property declarations on one element and the later
+        // class silently wins, dropping the clip-path.
+        "flex items-center justify-center text-current motion-tick",
         className
       ),
       render: (indicatorProps, state) => /* @__PURE__ */ jsx("span", { ...indicatorProps, children: /* @__PURE__ */ jsx(

package/dist/components/checkbox/checkbox.js

@@ -1,13 +1,15 @@
 // src/components/checkbox/checkbox.tsx
 import { Checkbox as Base } from "@base-ui/react/checkbox";
 import { cn } from "../../lib/cn.js";
+import { motionAttribute } from "../../motion/MotionProvider.js";
 import { CHECK_BOX } from "../../lib/selection-card.js";
 import { CheckboxMark } from "./checkbox-mark.js";
 import { jsx } from "react/jsx-runtime";
-function Checkbox({ className, children, ...props }) {
+function Checkbox({ className, children, motion, ...props }) {
   return /* @__PURE__ */ jsx(
     Base.Root,
     {
+      "data-motion": motionAttribute(motion),
       className: cn(
         CHECK_BOX,
         "text-primary-foreground",

package/dist/components/checkbox/checkbox.meta.js

@@ -22,7 +22,8 @@ var checkboxMeta = {
       },
       {
         guidance: "dont",
-        description: "Do not use Checkbox for mutually exclusive choices; use Radio or Select instead."
+        description: "Do not use Checkbox for mutually exclusive choices; use Radio or Select instead.",
+        instead: ["Radio", "Select"]
       },
       {
         guidance: "dont",
@@ -90,6 +91,12 @@ var checkboxMeta = {
       name: "render",
       type: "ReactElement | (props, state) => ReactElement",
       description: "Compose the root with another element through the Base UI render prop."
+    },
+    {
+      name: "motion",
+      type: '"full" | "subtle" | "off"',
+      default: '"full"',
+      description: "How much motion this component uses: `full` (default) inherits the app's policy, `subtle` keeps feedback and drops the flourish, `off` stills it. It can only turn motion down \u2014 it never overrides a reader's reduce-motion setting. Under `subtle` the tick fades in instead of drawing itself."
     }
   ],
   tokensUsed: [
@@ -99,6 +106,32 @@ var checkboxMeta = {
     "primary-foreground",
     "ring"
   ],
+  motion: [
+    {
+      slot: "arrival",
+      recipe: "none",
+      part: "Root",
+      why: "It arrives with the form it belongs to. Animating each box in turns a settings list into a title sequence."
+    },
+    {
+      slot: "response",
+      recipe: "motion-interactive",
+      part: "Box",
+      why: "The box fills with the primary colour as it is checked; easing the fill keeps the mark and the box changing as one event rather than two frames apart."
+    },
+    {
+      slot: "transition",
+      recipe: "motion-tick",
+      part: "Mark",
+      why: "The check draws itself in from its leading stroke, so checking reads as the box being ticked rather than a glyph appearing. The dash wipes the same way. Unchecking only fades, so clearing a list is quick; under `subtle` checking fades too."
+    },
+    {
+      slot: "activity",
+      recipe: "none",
+      part: "Root",
+      why: "A checkbox commits instantly. A slow write belongs to the surrounding form's pending state, not the control."
+    }
+  ],
   a11y: [
     "Base UI renders a hidden native <input type=checkbox> for keyboard, focus, and form semantics.",
     "Space toggles; focus-visible draws a 2px ring in the --ring token.",

package/dist/components/checkbox-card/checkbox-card.js

@@ -2,6 +2,7 @@
 import { Checkbox as Base } from "@base-ui/react/checkbox";
 import { CheckboxGroup as BaseGroup } from "@base-ui/react/checkbox-group";
 import { cn } from "../../lib/cn.js";
+import { motionAttribute } from "../../motion/MotionProvider.js";
 import {
   CHECK_BOX,
   SELECTION_CARD_GLYPH,
@@ -52,6 +53,7 @@ function CheckboxCard({
   description,
   icon,
   tone = "neutral",
+  motion,
   ...props
 }) {
   const t = checkboxCardToneClasses[tone];
@@ -59,6 +61,7 @@ function CheckboxCard({
   return /* @__PURE__ */ jsxs(
     Base.Root,
     {
+      "data-motion": motionAttribute(motion),
       className: cn(
         SELECTION_CARD_SHELL,
         icon != null ? SELECTION_CARD_LAYOUT.tile : SELECTION_CARD_LAYOUT.row,

package/dist/components/checkbox-card/checkbox-card.meta.js

@@ -92,6 +92,12 @@ var checkboxCardMeta = {
       name: "checked / onCheckedChange / defaultChecked / disabled",
       type: "Base UI Checkbox.Root props",
       description: "Standard checkbox state. Without a group-owned value, each card is independent \u2014 drive checked/onCheckedChange per item for multi-select."
+    },
+    {
+      name: "motion",
+      type: '"full" | "subtle" | "off"',
+      default: '"full"',
+      description: "How much motion this component uses: `full` (default) inherits the app's policy, `subtle` keeps feedback and drops the flourish, `off` stills it. It can only turn motion down \u2014 it never overrides a reader's reduce-motion setting. Under `subtle` the tick fades in instead of drawing itself."
     }
   ],
   subcomponents: [
@@ -124,6 +130,32 @@ var checkboxCardMeta = {
     "tone-warning",
     "tone-warning-foreground"
   ],
+  motion: [
+    {
+      slot: "arrival",
+      recipe: "none",
+      part: "Root",
+      why: "It arrives with the form it belongs to. Animating each box in turns a settings list into a title sequence."
+    },
+    {
+      slot: "response",
+      recipe: "motion-interactive",
+      part: "Box",
+      why: "The box fills with the primary colour as it is checked; easing the fill keeps the mark and the box changing as one event rather than two frames apart."
+    },
+    {
+      slot: "transition",
+      recipe: "motion-tick",
+      part: "Mark",
+      why: "The check draws itself in from its leading stroke, so checking reads as the box being ticked rather than a glyph appearing. The dash wipes the same way. Unchecking only fades, so clearing a list is quick; under `subtle` checking fades too."
+    },
+    {
+      slot: "activity",
+      recipe: "none",
+      part: "Root",
+      why: "A checkbox commits instantly. A slow write belongs to the surrounding form's pending state, not the control."
+    }
+  ],
   a11y: [
     "Base UI provides the checkbox role, aria-checked, hidden native input, keyboard toggle, and data-[checked]/data-disabled state.",
     "The whole card is the hit target; focus draws a 2px outline outside the card (not a ring, so the checked tone ring survives focus); Space toggles the focused card.",

package/dist/components/code-block/code-block.js

@@ -7,6 +7,15 @@ import { Button } from "../button/button.js";
 import { cn } from "../../lib/cn.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 var CodeHighlightContext = createContext(null);
+function CopyGlyph({ copied }) {
+  return /* @__PURE__ */ jsxs("span", { "aria-hidden": "true", className: "motion-icon-swap", children: [
+    /* @__PURE__ */ jsx("span", { "data-active": !copied, className: "inline-flex", children: /* @__PURE__ */ jsx(Icon, { name: "copy" }) }),
+    /* @__PURE__ */ jsx("span", { "data-active": copied, className: "inline-flex", children: /* @__PURE__ */ jsx(Icon, { name: "check" }) })
+  ] });
+}
+function CopiedStatus({ copied }) {
+  return /* @__PURE__ */ jsx("span", { role: "status", className: "sr-only", children: copied ? "Copied" : "" });
+}
 function CodeHighlightProvider({ highlight, children }) {
   return /* @__PURE__ */ jsx(CodeHighlightContext.Provider, { value: highlight, children });
 }
@@ -39,7 +48,8 @@ function CodeBlock({
             ] }),
             code
           ] }),
-          showCopy ? /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": "Copy command", onClick: copy, className: "shrink-0 text-muted-foreground", children: /* @__PURE__ */ jsx(Icon, { name: copied ? "check" : "copy" }) }) : null
+          showCopy ? /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": "Copy command", onClick: copy, className: "shrink-0 text-muted-foreground", children: /* @__PURE__ */ jsx(CopyGlyph, { copied }) }) : null,
+          showCopy ? /* @__PURE__ */ jsx(CopiedStatus, { copied }) : null
         ]
       }
     );
@@ -57,7 +67,7 @@ function CodeBlock({
       children: [
         hasHeader ? /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-3 border-b border-border px-4 py-2", children: [
           /* @__PURE__ */ jsx("span", { className: "text-mono-caption text-muted-foreground", children: filename }),
-          showCopy ? /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": "Copy code", onClick: copy, className: "text-muted-foreground", children: /* @__PURE__ */ jsx(Icon, { name: copied ? "check" : "copy" }) }) : null
+          showCopy ? /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": "Copy code", onClick: copy, className: "text-muted-foreground", children: /* @__PURE__ */ jsx(CopyGlyph, { copied }) }) : null
         ] }) : null,
         /* @__PURE__ */ jsx(
           "pre",
@@ -72,7 +82,8 @@ function CodeBlock({
             children: /* @__PURE__ */ jsx("code", { children: highlighter ? highlighter(code) : code })
           }
         ),
-        copyColumn ? /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": "Copy code", onClick: copy, className: "m-2 ms-0 shrink-0 text-muted-foreground", children: /* @__PURE__ */ jsx(Icon, { name: copied ? "check" : "copy" }) }) : null
+        copyColumn ? /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "icon-sm", "aria-label": "Copy code", onClick: copy, className: "m-2 ms-0 shrink-0 text-muted-foreground", children: /* @__PURE__ */ jsx(CopyGlyph, { copied }) }) : null,
+        showCopy ? /* @__PURE__ */ jsx(CopiedStatus, { copied }) : null
       ]
     }
   );

package/dist/components/code-block/code-block.meta.js

@@ -79,9 +79,36 @@ var codeBlockMeta = {
     }
   ],
   tokensUsed: ["border", "muted", "muted-foreground", "foreground"],
+  motion: [
+    {
+      slot: "arrival",
+      recipe: "none",
+      part: "Root",
+      why: "Code is reading content and arrives with the page or message it belongs to. An entrance of its own would delay the text someone came to copy."
+    },
+    {
+      slot: "response",
+      recipe: "motion-interactive",
+      part: "Copy button",
+      why: "The copy button is a quiet ghost icon in the corner of a block. Its hover fill is what tells the pointer it is a control and not decoration."
+    },
+    {
+      slot: "transition",
+      recipe: "motion-icon-swap",
+      part: "Copy glyph",
+      why: "The copy mark turning into a check is the only proof the clipboard took the text. Snapped between frames it was easy to miss at the edge of a block; the swap reads as one mark being replaced."
+    },
+    {
+      slot: "activity",
+      recipe: "none",
+      part: "Root",
+      why: "Copying is instant. There is no in-between worth showing, and a spinner for a clipboard write would read as a slow one."
+    }
+  ],
   a11y: [
     "Code renders inside a <pre><code> for correct semantics and screen-reader handling.",
-    "Copy is the ghost icon Button with `useCopy`, which guards clipboard access for SSR safety."
+    "Copy is the ghost icon Button with `useCopy`, which guards clipboard access for SSR safety.",
+    'A successful copy is announced as "Copied" through a polite role=status region that is always mounted; the button keeps its label, which names what it does. Both glyphs are aria-hidden.'
   ],
   examples: [
     {

package/dist/components/collapsible/collapsible.meta.js

@@ -22,7 +22,8 @@ var collapsibleMeta = {
       },
       {
         guidance: "dont",
-        description: "Do not use Collapsible for multi-section navigation; use Accordion or Tabs instead."
+        description: "Do not use Collapsible for multi-section navigation; use Accordion or Tabs instead.",
+        instead: ["Accordion", "Tabs"]
       },
       {
         guidance: "dont",
@@ -91,6 +92,38 @@ var collapsibleMeta = {
     }
   ],
   tokensUsed: ["foreground", "muted-foreground"],
+  motion: [
+    {
+      slot: "arrival",
+      recipe: "none",
+      part: "Root",
+      why: "A collapsible is part of the page it sits in, present from first paint. Its trigger is what the reader notices, not an entrance."
+    },
+    {
+      slot: "response",
+      recipe: "none",
+      part: "CollapsibleTrigger",
+      why: "The trigger is whatever the consumer renders (usually a Button), and that control brings its own response. Adding one here would double it."
+    },
+    {
+      slot: "transition",
+      recipe: "motion-disclosure",
+      part: "CollapsiblePanel",
+      why: "The height change ties the content that appears to the trigger that was pressed; snapped open, everything below jumps with nothing linking cause to effect."
+    },
+    {
+      slot: "transition",
+      recipe: "motion-interactive",
+      part: "CollapsibleIndicator",
+      why: "The chevron turns with the panel rather than flipping in one frame: motion-interactive lists `rotate`, the property rotate-180 writes."
+    },
+    {
+      slot: "activity",
+      recipe: "none",
+      part: "Root",
+      why: "Nothing here is indeterminate; content that loads on open should put its own loader inside the panel."
+    }
+  ],
   a11y: [
     "Base UI wires aria-expanded on the trigger and aria-controls/id between trigger and panel.",
     "Trigger is a real <button>; toggles on click and Enter/Space.",

package/dist/components/color-field/color-field.meta.js

@@ -95,6 +95,32 @@ var colorFieldMeta = {
       description: "Accessible name for the trigger; the current value is appended to it."
     }
   ],
+  motion: [
+    {
+      slot: "arrival",
+      recipe: "motion-pop",
+      part: "Popover",
+      why: "The picker grows out of the swatch it edits (PopoverContent's recipe, its origin on the anchor). In a property panel with a column of swatches, that origin is what tells you which colour you are now editing."
+    },
+    {
+      slot: "response",
+      recipe: "motion-interactive",
+      part: "Swatch",
+      why: "Preset swatches lift slightly under the pointer. They are 20px chips of colour with no label, and the eased lift is what tells you which one a click will take."
+    },
+    {
+      slot: "transition",
+      recipe: "none",
+      part: "Handles",
+      why: "The saturation, hue and alpha handles follow the pointer exactly. A handle that trailed the drag would misreport the colour under the cursor, and a swatch or a typed hex moving them is the value changing, which the field should show at once."
+    },
+    {
+      slot: "activity",
+      recipe: "none",
+      part: "Root",
+      why: "Picking is synchronous. The EyeDropper is the browser's own modal, with its own feedback."
+    }
+  ],
   a11y: [
     `The trigger's accessible name includes the current value, so a screen reader announces the colour rather than just "button" \u2014 the swatch itself conveys nothing without sight.`,
     "The Transparent entry is a toggle with aria-pressed, because it is a state of the value and not a navigation action.",

package/dist/components/combobox/combobox.meta.js

@@ -32,7 +32,8 @@ var comboboxMeta = {
       },
       {
         guidance: "dont",
-        description: "Use Combobox for tiny option sets where Select or Radio would be easier to scan."
+        description: "Use Combobox for tiny option sets where Select or Radio would be easier to scan.",
+        instead: ["Select", "Radio"]
       },
       {
         guidance: "do",
@@ -44,7 +45,8 @@ var comboboxMeta = {
       },
       {
         guidance: "dont",
-        description: "Use Combobox as a command launcher. Use CommandMenu for actions and navigation."
+        description: "Use Combobox as a command launcher. Use CommandMenu for actions and navigation.",
+        instead: ["CommandMenu"]
       },
       {
         guidance: "dont",
@@ -201,6 +203,50 @@ var comboboxMeta = {
     "secondary",
     "secondary-foreground"
   ],
+  motion: [
+    {
+      slot: "arrival",
+      recipe: "motion-pop",
+      part: "ComboboxContent",
+      why: "The list grows from the field it filters, its origin on Base UI's anchor. With several comboboxes in a form, that is what attaches the open list to the one being typed in."
+    },
+    {
+      slot: "response",
+      recipe: "motion-interactive",
+      part: "ComboboxItem",
+      why: "A row's ink eases as the pointer or the arrow keys reach it, so moving through a long filtered list reads as continuous movement rather than rows blinking."
+    },
+    {
+      slot: "response",
+      recipe: "custom",
+      part: "Highlight",
+      why: "One highlight travels to the active row (lib/highlight-glide: a measured translate on the motion tokens) instead of each row painting its own fill. When the list re-filters under the caret, the highlight sliding to the new match is what shows the keyboard target moved."
+    },
+    {
+      slot: "response",
+      recipe: "motion-interactive",
+      part: "Toggle",
+      why: "The chevron toggle at the field's edge eases its ink on hover; the change is what tells you it is a separate target from the text box."
+    },
+    {
+      slot: "transition",
+      recipe: "motion-interactive",
+      part: "Toggle",
+      why: "The chevron turns 180\xB0 as the list opens and closes (motion-interactive lists `rotate`), in step with the popup, so it reads as one control changing direction."
+    },
+    {
+      slot: "transition",
+      recipe: "motion-pop",
+      part: "ComboboxContent",
+      why: "Closing shrinks back toward the field, returning the eye to the input that now holds the value."
+    },
+    {
+      slot: "activity",
+      recipe: "none",
+      part: "Root",
+      why: "Combobox ships no loading part. A list fetched as you type shows a Spinner (motion-spin) in ComboboxEmpty or the content \u2014 where the results will land \u2014 and only the caller knows a fetch is in flight."
+    }
+  ],
   a11y: [
     "Base UI provides role=combobox/listbox/option, roving tabindex, arrow-key navigation, and type-to-filter.",
     "Esc and outside-press dismiss; focus returns to the input on close.",

package/dist/components/command-menu/command-menu.js

@@ -187,8 +187,13 @@ function CommandMenuBody({
       ),
       query ? (
         // Empties the query and hands focus back to the field, which owns
-        // the keyboard (the list is driven from it).
-        /* @__PURE__ */ jsx(
+        // the keyboard (the list is driven from it). It mounts on the first
+        // keystroke, beside the caret the eye is on, so the wrapper fades it
+        // in (motion-appear) rather than letting it blink into the header.
+        // On the wrapper, not the Button: motion-appear declares its own
+        // transition list and would fight motion-interactive for the one
+        // transition-property slot. Removal stays instant.
+        /* @__PURE__ */ jsx("span", { className: "flex motion-appear", children: /* @__PURE__ */ jsx(
           Button,
           {
             variant: "ghost",
@@ -203,7 +208,7 @@ function CommandMenuBody({
             },
             children: /* @__PURE__ */ jsx(Icon, { name: "xmark" })
           }
-        )
+        ) })
       ) : null
     ] }),
     /* @__PURE__ */ jsx("div", { role: "status", "aria-live": "polite", className: "sr-only", children: resultCount === 0 ? "No results" : `${resultCount} result${resultCount === 1 ? "" : "s"}` }),

package/dist/components/command-menu/command-menu.meta.js

@@ -28,7 +28,8 @@ var commandMenuMeta = {
       },
       {
         guidance: "dont",
-        description: "Hand-style a <button> to look like a search field, or put a SearchInput in the header that opens a dialog when focused. The first drifts from the field it imitates; the second is a text box you cannot type in. A header search that opens the palette is CommandMenuTrigger."
+        description: "Hand-style a <button> to look like a search field, or put a SearchInput in the header that opens a dialog when focused. The first drifts from the field it imitates; the second is a text box you cannot type in. A header search that opens the palette is CommandMenuTrigger.",
+        instead: ["CommandMenuTrigger"]
       },
       {
         guidance: "do",
@@ -44,7 +45,8 @@ var commandMenuMeta = {
       },
       {
         guidance: "dont",
-        description: "Use CommandMenu as a replacement for every dropdown. Simple choices belong in Select, Menu, or Tabs."
+        description: "Use CommandMenu as a replacement for every dropdown. Simple choices belong in Select, Menu, or Tabs.",
+        instead: ["Select", "Menu", "Tabs"]
       },
       {
         guidance: "do",
@@ -64,7 +66,8 @@ var commandMenuMeta = {
       },
       {
         guidance: "dont",
-        description: "Hand-build a palette mock from a search glyph, a row of buttons and a highlight. That is CommandMenuPanel, and the hand-built one has no combobox, no filtering and no keyboard model."
+        description: "Hand-build a palette mock from a search glyph, a row of buttons and a highlight. That is CommandMenuPanel, and the hand-built one has no combobox, no filtering and no keyboard model.",
+        instead: ["CommandMenuPanel"]
       },
       {
         guidance: "dont",
@@ -226,6 +229,44 @@ var commandMenuMeta = {
     "accent",
     "accent-foreground"
   ],
+  motion: [
+    {
+      slot: "arrival",
+      recipe: "motion-pop",
+      part: "Dialog",
+      why: "The palette opens on DialogContent's recipe over a fading backdrop. It is summoned by a keystroke from nowhere on screen, and the short scale-in is what says a layer arrived rather than the page changing. The inline CommandMenuPanel has no entrance: it is part of the page."
+    },
+    {
+      slot: "arrival",
+      recipe: "motion-appear",
+      part: "Clear button",
+      why: "The clear button mounts on the first keystroke, beside the caret the eye is already on. Fading in, it reads as the field offering a way back instead of a control blinking into the header. Removal is instant, so an emptied query does not wait on its X."
+    },
+    {
+      slot: "response",
+      recipe: "motion-interactive",
+      part: "CommandItem",
+      why: "The active row follows both the arrow keys and the pointer, and its fill eases between rows, so scanning results while typing reads as one highlight moving rather than rows flashing in turn."
+    },
+    {
+      slot: "response",
+      recipe: "motion-interactive",
+      part: "CommandMenuTrigger",
+      why: "The search-shaped trigger eases its ink on hover like the field shell it imitates, so it reads as the field it opens."
+    },
+    {
+      slot: "transition",
+      recipe: "motion-pop",
+      part: "Dialog",
+      why: "Closing on Enter or Esc shrinks the palette away fast and returns focus where it came from; the exit is the confirmation that the command ran or was dismissed."
+    },
+    {
+      slot: "activity",
+      recipe: "none",
+      part: "List",
+      why: "Results are filtered synchronously from the items passed in. Async results are the caller's to mark with a Spinner (motion-spin) in the list, where the person is already looking."
+    }
+  ],
   a11y: [
     "CommandMenuTrigger is a real <button> named by its visible placeholder, with aria-haspopup=dialog and aria-keyshortcuts (Meta+K on macOS, Control+K elsewhere). Its Kbd hint is aria-hidden, so the shortcut is announced once rather than read as part of the name.",
     "The shortcut never fires from inside a text field, textarea, select or contenteditable (Ctrl+K is delete-to-end-of-line in macOS text views), except the palette's own input.",