@imfusion/web-ui 0.6.4-dev.55.g47fb2f84 → 0.6.4-dev.58.g88c8fcaa

package/README.md

@@ -28,48 +28,13 @@ To follow builds from `master`, use the `dev` dist-tag:
 npm install @imfusion/web-ui@dev
 ```
 
-Import the stylesheet and mount the provider once at your app root:
-
-```tsx
-import "@imfusion/web-ui/styles.css";
-import { WebUIProvider } from "@imfusion/web-ui";
-
-export function App() {
-  return <WebUIProvider>{/* app */}</WebUIProvider>;
-}
-```
-
-### Agent skills
-
-The package can install optional skills for agents working in a consumer project:
-
-```sh
-npx web-ui-install
-```
-
-Run the command again after updating the package. It refreshes the skills already installed in the project. Use
-`--reconfigure` to choose a different target. Add `--hooks` to install the lifecycle hooks for Claude Code and Codex.
-
-Start with `/imf-web-ui`. It routes library questions to the packaged user guides and UI work to the companion skills it
-needs. Agents read the guides from `node_modules/@imfusion/web-ui/docs/user-guide/` without a running Storybook.
-
-| Skill                     | Use it for                                                   |
-| ------------------------- | ------------------------------------------------------------ |
-| `/imf-web-ui`             | Route UI work and library questions to skills and guides.    |
-| `/imf-web-ui-setup`       | Plan library wiring, project setup, or tooling changes.      |
-| `/imf-web-ui-components`  | Look up component and icon APIs.                             |
-| `/imf-web-ui-ux`          | Choose components and shape screens and flows.               |
-| `/imf-web-ui-conventions` | Follow the frontend conventions and token seams.             |
-| `/imf-web-ui-audit`       | Inspect an existing frontend without changing it.            |
-| `/imf-web-ui-update`      | Update the package, skills, and hooks in a consumer project. |
-
-The shipped [`agent-tooling` topic](./src/llms/skills/imf-web-ui-conventions/topics/agent-tooling.md) explains the hook
-installation and Codex trust step.
+[Getting Started](./docs/user-guide/GettingStarted.mdx) covers the setup, with or without an agent.
+[Agent Tooling](./docs/user-guide/AgentTooling.mdx) covers the skills and hooks the package ships for coding agents.
 
 ### Versions
 
-Use a release version or range for normal development. Follow `master` through the `dev` dist-tag while building against the
-library:
+Use a release version or range for normal development, or follow `master` through the `dev` dist-tag while building against
+the library:
 
 | Dependency spec | Resolves to                      | Update with                   |
 | --------------- | -------------------------------- | ----------------------------- |
@@ -85,7 +50,7 @@ copy, so it never updates by itself.
 ## Read the docs
 
 [Storybook](https://storybook.js.org/) is the project documentation. It contains the setup guide, usage patterns, token
-reference, and component examples. It currently runs locally from this repository:
+reference, and component examples. It runs locally from this repository:
 
 ```sh
 npm run dev
@@ -105,17 +70,17 @@ npm run git:config
 
 The main development skills are:
 
-| Skill                                  | Use it for                                       |
-| -------------------------------------- | ------------------------------------------------ |
-| `/web-ui-dev-getting-started`          | Route a first task based on experience and goal. |
-| `/web-ui-dev-start`                    | Establish task context and working location.     |
-| `/web-ui-dev-new-component`            | Add a primitive.                                 |
-| `/web-ui-dev-update-component`         | Change an existing primitive.                    |
-| `/web-ui-dev-design-component`         | Apply the ImFusion brand to a component.         |
-| `/web-ui-dev-story`                    | Author a Storybook story.                        |
-| `/web-ui-dev-commit`                   | Verify and commit a change.                      |
-| `/web-ui-dev-release`                  | Prepare and ship a release.                      |
-| `/web-ui-dev-audit-docs`               | Check docs for drift before a commit.            |
-| `/web-ui-dev-refresh-design-reference` | Refresh the committed brand snapshots.           |
-| `/web-ui-dev-teardown-worktree`        | Remove a finished worktree.                      |
-| `/web-ui-dev-mcp`                      | Recover one optional MCP capability.             |
+| Skill                            | Use it for                                       |
+| -------------------------------- | ------------------------------------------------ |
+| `/web-ui-dev-getting-started`    | Route a first task based on experience and goal. |
+| `/web-ui-dev-start`              | Establish task context and working location.     |
+| `/web-ui-dev-new-component`      | Add a primitive.                                 |
+| `/web-ui-dev-update-component`   | Change an existing primitive.                    |
+| `/web-ui-dev-design-component`   | Apply the ImFusion brand to a component.         |
+| `/web-ui-dev-story`              | Author a Storybook story.                        |
+| `/web-ui-dev-commit`             | Verify and commit a change.                      |
+| `/web-ui-dev-release`            | Prepare and ship a release.                      |
+| `/web-ui-dev-audit-docs`         | Check docs for drift before a commit.            |
+| `/web-ui-dev-claude-design-sync` | Update the design system in Claude Design.       |
+| `/web-ui-dev-teardown-worktree`  | Remove a finished worktree.                      |
+| `/web-ui-dev-mcp`                | Recover one optional MCP capability.             |

package/dist/assets/vendors/base-ui.d.ts

@@ -1,7 +1,6 @@
 /**
- * Base UI brandmark — compact glyph. Internal asset (not part of the public
- * package API); consumed by the Storybook origin badge to flag adapted
- * components. New upstreams (Mantine, …) get a sibling file here.
+ * Internal asset (not part of the public package API), consumed by the Storybook origin badge
+ * to flag adapted components. New upstreams get a sibling file here.
  */
 export declare function BaseUILogo({ size }: {
     size?: number;

package/dist/breakpoints/min-width.d.ts

@@ -1,9 +1,5 @@
 import { BreakpointName } from './registry';
-/**
- * Resolve a registry breakpoint name to the plain media-query string
- * `useMediaQuery` expects, e.g. `minWidth("md")` → `"(min-width: 768px)"`.
- *
- * Keeps JS-side viewport checks (e.g. a mobile burger toggle) reading from the
- * same numeric source as the CSS-side `@custom-media` definitions.
- */
+/** Resolves a registry breakpoint name to the media-query string `useMediaQuery` expects, e.g.
+ *  `minWidth("md")` → `"(min-width: 768px)"`. Keeps JS viewport checks reading from the same numeric
+ *  source as the CSS-side `@custom-media` definitions. */
 export declare function minWidth(name: BreakpointName): string;

package/dist/breakpoints/registry.d.ts

@@ -1,13 +1,7 @@
 /**
- * Breakpoint registry — the single source of truth for every
- * `@custom-media --imf-ui-*` definition AND the `minWidth()` JS helper.
- * `styles/custom-media.gen.css` is generated from this list by the codegen
- * runner (see `./gen-breakpoints-css.ts`), so CSS and JS can never drift.
- *
- * Values are min-width breakpoints (mobile-first). Component CSS consumes them
- * via `@media (--imf-ui-{name})`; Lightning CSS substitutes the literal at
- * build time (`drafts.customMedia`, enabled in `vite.config.ts` and
- * `.storybook/main.ts`).
+ * The single source of truth for every `@custom-media --imf-ui-*` definition and the
+ * `minWidth()` JS helper. `src/styles/custom-media.gen.css` is generated from this list
+ * by `src/codegen/gen-breakpoints-css.ts`, so CSS and JS can never drift.
  */
 export declare const BREAKPOINTS: {
     readonly mobile: 375;

package/dist/codegen/gen-breakpoints-css.d.ts

@@ -1,6 +1,2 @@
 import { BREAKPOINTS } from '../breakpoints/registry';
-/**
- * Render the `@custom-media --imf-ui-*` declarations from the breakpoint
- * registry. Pure function.
- */
 export declare function renderBreakpointsCss(registry: typeof BREAKPOINTS): string;

package/dist/codegen/gen-token-css.d.ts

@@ -1,6 +1,4 @@
 import { Token } from '../tokens/types';
-/** Render `token-controls.gen.css` — every non-font token's `:root` declarations, in registry order. */
 export declare function renderColorTokensCss(registry?: readonly Token[]): string;
-/** Render `font-families.gen.css` — the `--imf-ui-font-family-*` tokens, base stacks and aliases. */
 export declare function renderFontTokensCss(registry?: readonly Token[]): string;
 export declare function writeTokenCss(): void;

package/dist/components/button/button.d.ts

@@ -14,7 +14,7 @@ interface Props extends React.ComponentProps<typeof ButtonPrimitive>, VariantPro
     endIcon?: React.ReactNode;
 }
 /**
- * Button component
+ * Button
  *
  * @doc https://base-ui.com/react/components/button
  * @llm https://base-ui.com/react/components/button.md

package/dist/components/callout/callout.d.ts

@@ -4,22 +4,19 @@ declare const root: (props?: ({
     maxWidth?: "sm" | "md" | "lg" | "full" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 /**
- * Callout.Root — the banner container. Sets the `variant` (which tints the
- * surface and colours the icon and text) and lays out a leading `Callout.Icon`
- * beside a text region of `Callout.Title` / `Callout.Description`. `maxWidth`
- * caps the banner so it reads as a block region rather than stretching full
- * container width. A persistent element in the content flow — not a transient
- * Toast, not a modal Alert Dialog.
+ * Callout.Root — the banner container. Sets `variant` (tints surface, icon, and text) and lays
+ * out a leading `Callout.Icon` beside `Callout.Title` / `Callout.Description`. `maxWidth` caps
+ * the banner so it reads as a block region, not full container width. A persistent content-flow
+ * element — not a transient Toast, not a modal Alert Dialog.
  */
 declare function Root({ variant, maxWidth, children, ...props }: React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof root>): import("react/jsx-runtime").JSX.Element;
 declare namespace Root {
     var displayName: string;
 }
 /**
- * Callout.Icon — the leading status glyph. With no children it renders the
- * variant's default local icon; pass a custom icon as children to override.
- * `aria-hidden` (the variant is conveyed by copy, not the glyph) and inherits
- * the status colour via `currentColor`.
+ * Callout.Icon — the leading status glyph. Renders the variant's default icon when no children
+ * are passed; pass a custom icon as children to override. `aria-hidden` (variant is conveyed by
+ * copy) and inherits colour via `currentColor`.
  */
 declare function Icon({ children, ...props }: React.HTMLAttributes<HTMLSpanElement>): import("react/jsx-runtime").JSX.Element;
 declare namespace Icon {

package/dist/components/card/card.d.ts

@@ -23,10 +23,8 @@ type RootProps = React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof root
  * The image is always the first entry in the stack, so `orientation` just
  * switches the stack between a column and a row without reordering slots.
  *
- * The ImFusion brand ships flat (`shadow="none"`), but the shadow scale is a
- * first-class opt-in axis for third-party consumers. `shadow` picks the elevation
- * level only — how hard or spread that shadow reads is a global lighting decision,
- * owned by the `--imf-ui-shadow-hardness` / `--imf-ui-shadow-spread` tokens.
+ * `shadow` defaults to `lg`; `shadow="none"` gives the flat surface. It picks the elevation level only: how hard or
+ * spread the shadow reads is global, set by `--imf-ui-shadow-hardness` and `--imf-ui-shadow-spread`.
  */
 declare function Root({ density, variant, shadow, radius, orientation, withBorder, ...props }: RootProps): import("react/jsx-runtime").JSX.Element;
 declare namespace Root {

package/dist/components/chip/chip.cva.d.ts

@@ -1,9 +1,7 @@
 /**
  * Shared variants for `Chip` and any sibling primitive that renders the same
- * Chip visual on a different element (`ChipLink` renders `<a>`; a future
- * `ChipButton` would render `<button>`). Keeping them in their own module
- * means variant axes stay aligned without cross-component imports of a
- * component file.
+ * visual on a different element (`ChipLink` renders `<a>`). Keeping them here
+ * avoids cross-component imports between Chip and its siblings.
  */
 export declare const chip: (props?: ({
     variant?: "primary" | "positive" | "negative" | "main" | "support" | "minor" | "brand" | "warning" | "info" | "accent-1" | "accent-2" | "accent-3" | null | undefined;

package/dist/components/code/code.d.ts

@@ -22,7 +22,7 @@ type InlineLinkProps = useRender.ComponentProps<"a"> & {
 /**
  * Code.InlineLink — the inline-code chip rendered as a link: the same hairline
  * box, with an optional directional arrow behind the separator instead of a copy button.
- * Sibling of `Code.Inline`, sharing its chip visual (`.inline`) — never both a
+ * Sibling of `Code.Inline`, sharing its chip visual (`.inline`). Never both a
  * copy button and a link on the same chip. Mirrors `ChipLink`'s shape (anchor
  * is the chip root, trailing icon nudges on hover, `data-kind` picks the icon).
  */

package/dist/components/logo/imfusion/imfusion.d.ts

@@ -7,10 +7,7 @@ type Props = Omit<React.ComponentProps<typeof Logo>, "src" | "alt"> & {
 };
 /**
  * ImFusion's own logo — the generic {@link Logo} primitive pre-wired with the
- * ImFusion marks and the brand variant. The single branded entry point and the
- * only export from this module; external consumers compose `<Logo src={…} />`
- * with their own asset. Pass `glyph` for the compact mark; the default is the
- * Standard lockup.
+ * ImFusion marks and the brand variant. Pass `glyph` for the compact mark.
  */
 export declare function ImFusionLogo({ glyph, alt, variant, ...props }: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/logo/logo.d.ts

@@ -5,7 +5,7 @@ declare const logo: (props?: ({
     variant?: "oncolor" | "main" | "inherit" | "support" | "minor" | "brand" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 type Props = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & VariantProps<typeof logo> & {
-    /** Logo source — an image URL or an inline SVG node. Required; this primitive carries no brand default (see `ImFusionLogo` for our own mark). */
+    /** Logo source — an image URL or inline SVG node. No brand default; see `ImFusionLogo` for the ImFusion mark. */
     src: string | ReactNode;
     alt: string;
     /** Explicit height — overrides `size` variant when set. */

package/dist/components/navigation-menu/subs/flyout-link.d.ts

@@ -1,10 +1,8 @@
 import { NavigationMenu as NavigationMenuPrimitive } from '@base-ui/react/navigation-menu';
 /**
- * NavigationMenu.FlyoutLink — a quiet text link inside a flyout `Content`, the
- * lightweight alternative to a `LinkCard` when a card is too heavy. Renders an
- * `<a>`. A trailing `ArrowRight` slides in on hover/focus and the label nudges to
- * meet it; the current page is marked in primary. When a custom `render` is
- * supplied the icon is omitted — the consumer's element owns its content.
+ * NavigationMenu.FlyoutLink — a quiet text link inside a flyout `Content`, the lightweight
+ * alternative to `LinkCard`. Renders an `<a>`; a trailing `ArrowRight` slides in on hover/focus,
+ * and the current page is marked in primary. A custom `render` omits the icon.
  */
 export declare function FlyoutLink({ children, render, ...props }: React.ComponentProps<typeof NavigationMenuPrimitive.Link>): import("react/jsx-runtime").JSX.Element;
 export declare namespace FlyoutLink {

package/dist/components/navigation-menu/subs/inline-submenu.d.ts

@@ -29,10 +29,8 @@ type InlineSubmenuProps = {
  *
  * A curated partial over the namespace's own primitives (a nested vertical
  * `Root` without a `Portal`, plus the rail/detail layout). Drop it directly
- * inside a `NavigationMenu.Content`. It bakes in Base UI's viewport
- * responsiveness: the nested Root flips `orientation` at `md` via `useMediaQuery`
- * and the CSS flips the rail from a horizontal tab strip to a side rail at the
- * same breakpoint — no work for the consumer, no container queries.
+ * inside a `NavigationMenu.Content`. Switches from a tab strip to a side rail
+ * at `md` — no work for the consumer, no container queries.
  */
 export declare function InlineSubmenu({ items, defaultValue }: InlineSubmenuProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace InlineSubmenu {

package/dist/components/navigation-menu/subs/trigger.d.ts

@@ -2,10 +2,9 @@ import { NavigationMenu as NavigationMenuPrimitive } from '@base-ui/react/naviga
 import { UpstreamTrigger } from './shared';
 interface TriggerProps extends UpstreamTrigger {
     /**
-     * Marks this section as the current page so it shows the active treatment even
-     * when its flyout is closed — the "active trail" anchor for a nav where the
-     * open section isn't the current one. Base UI's Trigger has no active state of
-     * its own, so this stamps `data-active`.
+     * Marks this section as the current page, showing the active treatment even when its
+     * flyout is closed. Base UI's Trigger has no active state of its own, so this stamps
+     * `data-active`.
      * @default false
      */
     active?: boolean;
@@ -24,9 +23,8 @@ interface TriggerProps extends UpstreamTrigger {
 }
 /**
  * NavigationMenu.Trigger — opens an item's flyout on hover or click. Renders a
- * `<button>`. Ships a built-in `ChevronDown` (rotates when open) so consumers
- * don't hand-author an indicator; pass `hideChevron` to supply a custom `Icon`,
- * and `nested` when the trigger opens a submenu from inside another flyout.
+ * `<button>` with a built-in `ChevronDown` that rotates when open; pass
+ * `hideChevron` for a custom `Icon`, and `nested` for a trigger inside a flyout.
  */
 export declare function Trigger({ active, hideChevron, nested, children, ...props }: TriggerProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Trigger {

package/dist/components/number-field/number-field.d.ts

@@ -48,9 +48,8 @@ interface StepperProps extends React.ComponentProps<typeof NumberFieldPrimitive.
     /** Control height, matching Input's scale. @default "md" */
     size?: "sm" | "md" | "lg";
     /**
-     * Content rendered above the field as a drag handle: pressing it and moving
-     * sideways changes the value. Usually the field's label. The scrub cursor is
-     * supplied automatically.
+     * Drag handle rendered above the field: press and move sideways to change the value, usually
+     * the field's label. The scrub cursor is supplied automatically.
      */
     scrub?: React.ReactNode;
 }

package/dist/components/select/select.d.ts

@@ -5,9 +5,9 @@ interface RootProps<Value = unknown, Multiple extends boolean | undefined = fals
 /**
  * Select.Root — accessible select / listbox primitive.
  *
- * Renders a thin wrapper div so that a sibling Select.Label stacks above the
- * Select.Trigger regardless of the parent's layout. Select.Portal is unaffected
- * (it renders to document.body).
+ * Wraps children in a div so a sibling Select.Label stacks above Select.Trigger
+ * regardless of the parent's layout. Select.Portal is unaffected (it renders to
+ * document.body).
  *
  * @doc https://base-ui.com/react/components/select
  * @llm https://base-ui.com/react/components/select.md

package/dist/components/stack/stack.d.ts

@@ -8,9 +8,8 @@ type Props = React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof stack>;
 /**
  * Stack — vertical layout primitive.
  *
- * Copied and adapted from Mantine's Stack; no upstream runtime
- * dependency. Pure column flex container with token-driven gap and constrained
- * align/justify unions.
+ * Adapted from Mantine's Stack, no upstream runtime dependency: a pure column
+ * flex container with token-driven gap and constrained align/justify unions.
  *
  * @see https://mantine.dev/core/stack/
  */

package/dist/components/table/table.d.ts

@@ -47,11 +47,9 @@ type SortableHeaderCellProps = Omit<HeaderCellProps, "aria-sort"> & {
     onToggle?: React.MouseEventHandler<HTMLButtonElement>;
 };
 /**
- * Table.SortableHeaderCell — a partial: a header cell whose label is a sort
- * toggle, pre-composing HeaderCell + HeaderButton so the `aria-sort` state and
- * direction indicator don't get re-derived per consumer app. Headless-upstream-
- * agnostic: feed it `sortDirection` and `onToggle` (e.g. from a TanStack
- * column). Omit `onToggle` and it renders a plain non-sortable header cell.
+ * Table.SortableHeaderCell — a header cell whose label is a sort toggle,
+ * pre-composing HeaderCell + HeaderButton so `aria-sort` and the direction
+ * indicator aren't re-derived per consumer. Omit `onToggle` for a plain cell.
  */
 export declare function SortableHeaderCell({ sortDirection, onToggle, children, ...props }: SortableHeaderCellProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace SortableHeaderCell {

package/dist/components/tabs/tabs.d.ts

@@ -32,11 +32,9 @@ export declare namespace Tab {
     var displayName: string;
 }
 /**
- * Tabs.Indicator — the bordered box marking the active tab, overlapping the
- * shared hairline border to visually fuse the active tab with the panel
- * frame beneath it. Positioned via the `--active-tab-*` CSS custom
- * properties Base UI writes onto it; render once per Tabs.List, after the
- * Tabs.Tab list.
+ * Tabs.Indicator — the bordered box marking the active tab, positioned via
+ * the `--active-tab-*` CSS custom properties Base UI writes onto it. Render
+ * once per Tabs.List, after the Tabs.Tab list.
  */
 export declare function Indicator(props: React.ComponentProps<typeof TabsPrimitive.Indicator>): import("react/jsx-runtime").JSX.Element;
 export declare namespace Indicator {
@@ -44,9 +42,8 @@ export declare namespace Indicator {
 }
 /**
  * Tabs.PanelViewport — the shared frame Tabs.Panel elements render inside.
- * No Base UI equivalent exists (upstream leaves this as a plain wrapper div
- * in its own reference); we surface it as a named part since its hairline
- * border is what Tabs.Indicator visually fuses into.
+ * No Base UI equivalent exists; it's surfaced as a named part since its
+ * hairline border is what Tabs.Indicator visually fuses into.
  */
 export declare function PanelViewport(props: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
 export declare namespace PanelViewport {

package/dist/components/tooltip/tooltip.d.ts

@@ -33,10 +33,9 @@ export declare namespace Root {
 }
 interface TriggerProps extends UpstreamTrigger, VariantProps<typeof tooltipTrigger> {
     /**
-     * Milliseconds to wait before opening on hover. Defaults to a snappier value
-     * than Base UI's 600ms — a deliberate imf default per "make the correct
-     * choice the easy one". Grouped triggers under a `Tooltip.Provider` open
-     * instantly after the first regardless of this value.
+     * Milliseconds to wait before opening on hover. Defaults to less than Base
+     * UI's 600ms, deliberately. Grouped triggers under a `Tooltip.Provider` open instantly
+     * after the first, regardless of this value.
      */
     delay?: UpstreamTrigger["delay"];
 }
@@ -54,10 +53,8 @@ export declare namespace Portal {
  * Tooltip.Positioner — positions the popup relative to the trigger via
  * floating-point layout.
  *
- * `sideOffset` defaults to `--arrow-size` (tooltip.module.css) + 4px — enough
- * gap for the arrow to bridge with a few px of breathing room past its tip,
- * rather than landing flush on the trigger. Keep the two in sync if either
- * changes.
+ * `sideOffset` defaults to `--arrow-size` (tooltip.module.css) + 4px, for
+ * gap past the arrow tip. Keep the two values in sync.
  */
 export declare function Positioner({ sideOffset, ...props }: React.ComponentProps<typeof TooltipPrimitive.Positioner>): import("react/jsx-runtime").JSX.Element;
 export declare namespace Positioner {

package/dist/components/typo/typo.d.ts

@@ -63,9 +63,7 @@ export declare namespace Blockquote {
 }
 /**
  * Typo.InlineCode — inline code fragment. Thin wrapper over `Code.Inline`, which
- * owns the inline-code styling; the rendered `<code>` carries the `Code.Inline`
- * identity. Unlike other Typo members it has no color-`variant` axis — inline
- * code is a fixed neutral chip.
+ * owns the styling and identity. No color-`variant` axis — it's a fixed neutral chip.
  */
 export declare function InlineCode(props: React.ComponentProps<typeof Code.Inline>): import("react/jsx-runtime").JSX.Element;
 export declare namespace InlineCode {

package/dist/docgen/gen-docgen.utils.d.ts

@@ -3,10 +3,9 @@ export declare const docgenOptions: ParserOptions;
 /** Converts a kebab-case folder name to PascalCase component prefix. */
 export declare function toPascalCase(s: string): string;
 /**
- * Extracts the default value string from a react-docgen-typescript PropItem.
- * Parses JSDoc @default string literals via JSON.parse so that quoted strings
- * ("primary" → primary) and non-string literals (false, 0) both render
- * consistently with destructured defaults in the prop table.
+ * Extracts a default value from a react-docgen-typescript PropItem. Parses
+ * JSDoc @default string literals via JSON.parse so quoted strings and
+ * non-string literals render consistently with destructured defaults.
  */
 export declare function extractDefault(raw: unknown): string | null;
 /** Strips the minimum leading whitespace shared by all non-empty lines. */

package/dist/hooks/use-color-scheme.d.ts

@@ -6,20 +6,14 @@ import { ColorScheme, ColorSchemePreference } from '../types/theme';
  */
 export declare function parsePreference(stored: string | null): ColorSchemePreference;
 /**
- * Manages the active color scheme with OS preference support and localStorage persistence.
- *
- * Pass `{ value }` to drive it from an external source (e.g. a Storybook toolbar
- * global) — in that controlled mode localStorage is bypassed entirely.
- *
- * @returns `colorScheme` — the active preference; "system" means follow the OS
- * @returns `resolvedColorScheme` — the scheme currently in effect ("light" | "dark")
- * @returns `setColorScheme` — updates the preference and applies it immediately (no-op when controlled)
+ * Manages the active color scheme with OS preference support and localStorage
+ * persistence. Pass `{ value }` to drive it from an external source (e.g. a
+ * Storybook toolbar global); see the `value` param for controlled-mode behavior.
  */
 export declare function useColorScheme({ value }?: {
     /**
-     * Controlled preference. When provided, the hook applies this scheme and
-     * ignores localStorage (neither reads nor writes it), and `setColorScheme`
-     * becomes a no-op — the caller owns the value. Omit for the default
+     * Controlled preference. When provided, the hook applies this scheme and ignores
+     * localStorage entirely; `setColorScheme` becomes a no-op. Omit for the default
      * localStorage-backed behavior.
      */
     value?: ColorSchemePreference;

package/dist/hooks/use-media-query.d.ts

@@ -2,12 +2,7 @@ export interface UseMediaQueryOptions {
     getInitialValueInEffect: boolean;
 }
 /**
- * Returns whether the given media query string currently matches.
- * Updates reactively as the viewport changes.
- *
- * Copied and adapted from Mantine's useMediaQuery; no upstream
- * runtime dependency.
- *
- * @see https://github.com/mantinedev/mantine/blob/master/packages/%40mantine/hooks/src/use-media-query/use-media-query.ts
+ * Returns whether the given media query currently matches, updating
+ * reactively as the viewport changes.
  */
 export declare function useMediaQuery(query: string, initialValue?: boolean, { getInitialValueInEffect }?: UseMediaQueryOptions): boolean;

package/dist/integrations/image-display-options/image-display-options-view.utils.d.ts

@@ -19,7 +19,6 @@ export type FieldSpec = {
     step: number;
     format: Intl.NumberFormatOptions;
 };
-/** Per-slider bounds override. */
 type SliderRange = {
     min?: number;
     max?: number;