Version Packages

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@cloudflare/kumo@2.12.0

Minor Changes

• 716e5b8: Add the Text heading variant with a 16px semibold default and a 20px
  size="lg" option. The variant defaults to a span, so callers choose heading
  semantics explicitly with as. Deprecate the numbered heading1, heading2,
  and heading3 variants.

Patch Changes

• d7a7a35: Collapsible.DefaultTrigger now uses text-kumo-default (neutral) with font-medium instead of the blue text-kumo-link color.

• 0db4f66: deprecate MenuBar in favor of segmented Tabs

  • mark the MenuBar component (and its exports) as @deprecated; it will be removed in a future release
  • new usage should prefer Tabs with variant="segmented" (the default Tabs variant)
  • the runtime behaviour of MenuBar is unchanged for existing consumers
  • remove the MenuBar documentation page and demos from the docs site

• c64183b: Fix Toast background clipping the ring outline at the corners — the inner background layer's radius (11px) was smaller than the root's rounded-xl (12px), painting over the ring at the corners. Matched them up.

• ef13cb4: Restore disabled and loading state handling for Toolbar.Button so disabled
  controls expose the correct semantics and cannot be activated.

• 51d0f03: Normalize shadows and outlines on tip-style overlays (Popover, Tooltip, ClipboardText, Chart tooltip).

  • Drop the shadow-kumo-tip-shadow color override so shadows use Tailwind's default translucent black instead of an opaque light-gray in light mode.
  • Tune shadow sizes: Popover, Tooltip, ClipboardText tooltip, and Chart tooltip use shadow-md; ClipboardText's "Copied" toast keeps shadow-lg to match the Toast component.
  • Switch these overlays from outline-kumo-fill to outline-kumo-line, matching every other floating surface (Dropdown, Select, Combobox, Dialog, etc.).
  • Rename kumo-tip-shadow → kumo-arrow-edge and kumo-tip-stroke → kumo-arrow-stroke. The tokens draw the border on Popover/Tooltip arrow SVGs, not a box shadow. Both now resolve to kumo-line, so the arrow border aligns with the popup outline in both modes.

• d586bf3: Add scrollToItem(id, options?) to useSidebar() for imperatively scrolling
  a nav item into the sidebar viewport. Tag items with the new itemId prop on
  Sidebar.MenuButton or Sidebar.MenuItem.

  Options:

  • align: "start" | "center" | "end" | "auto" (default "auto" — no-op if
    the item is already visible; otherwise scroll the minimum distance).
  • behavior: "auto" | "smooth" (default "auto" — instant, best for
    cross-app landings so users don't watch the sidebar animate on entry).
    prefers-reduced-motion forces "auto".

  Scrolls only the sidebar viewport (never the document) and works with
  Sidebar.SlidingViews: items register with the provider via an internal
  map, so scrollToItem walks up from the target to find its owning viewport
  rather than querying the DOM.

@cloudflare/kumo-docs-astro@1.5.18

Patch Changes

• d66dbe1: - Adds a custom 404 page using a wireframe grid and animated dashed Kumo logo
  • Adds an easter egg that reverses the logo animation direction
  • Configures static assets to serve the custom 404 page
• Updated dependencies [716e5b8]
• Updated dependencies [d7a7a35]
• Updated dependencies [0db4f66]
• Updated dependencies [c64183b]
• Updated dependencies [ef13cb4]
• Updated dependencies [51d0f03]
• Updated dependencies [d586bf3]
  • @cloudflare/kumo@2.12.0

@cloudflare/kumo-figma@0.3.48

Patch Changes

• Updated dependencies [716e5b8]
• Updated dependencies [d7a7a35]
• Updated dependencies [0db4f66]
• Updated dependencies [c64183b]
• Updated dependencies [ef13cb4]
• Updated dependencies [51d0f03]
• Updated dependencies [d586bf3]
  • @cloudflare/kumo@2.12.0

[pkg-pr-new]

npm i https://pkg.pr.new/@cloudflare/kumo@737

commit: fea6afc

[github-actions]

Docs Preview

View docs preview

Commit: 69dbf8c

[github-actions]

Visual Regression Report — 31 changed, 12 unchanged

31 screenshot(s) with visual changes:

Button / Variant: Primary

181 px (0.2%) changed

Before	After	Diff

Button / Variant: Ghost

101 px (0.11%) changed

Before	After	Diff

Button / Variant: Outline

320 px (0.36%) changed

Before	After	Diff

Button / With Icon

654 px (0.74%) changed

Before	After	Diff

Button / Loading State

512 px (0.58%) changed

Before	After	Diff

Button / Disabled State

117 px (0.13%) changed

Before	After	Diff

Button / Title

1,136 px (1.28%) changed

Before	After	Diff

Button / Link as Button

1,134 px (1.28%) changed

Before	After	Diff

Button / Link with Tooltip

748 px (0.84%) changed

Before	After	Diff

Button / Disabled Link

743 px (0.84%) changed

Before	After	Diff

Dialog / Dialog With Actions

298 px (0.34%) changed

Before	After	Diff

Dialog / Dialog Sizes

2,298 px (2.59%) changed

Before	After	Diff

Dialog / Custom Max Width

1,012 px (1.14%) changed

Before	After	Diff

Dialog / Dialog With Select

497 px (0.56%) changed

Before	After	Diff

Dialog / Dialog With Combobox

383 px (0.43%) changed

Before	After	Diff

Dialog / Dialog With Dropdown

482 px (0.54%) changed

Before	After	Diff

Dialog (Open)

0 px (0%) changed

Before	After	Diff

Select / Select Basic

1,104 px (1.25%) changed

Before	After	Diff

Select / Select Sizes

170 px (0.1%) changed

Before	After	Diff

Select / Select Without Label

668 px (0.75%) changed

Before	After	Diff

Select / Select With Description

1,688 px (1.62%) changed

Before	After	Diff

Select / Select With Error

2,236 px (2.15%) changed

Before	After	Diff

Select / Select Placeholder

977 px (1.1%) changed

Before	After	Diff

Select / Select With Tooltip

1,022 px (1.15%) changed

Before	After	Diff

Select / Select Loading

2,375 px (1.35%) changed

Before	After	Diff

Select / Select Multiple

1,265 px (1.43%) changed

Before	After	Diff

Select / Select Complex

1,279 px (1.23%) changed

Before	After	Diff

Select / Select Disabled Items

103 px (0.12%) changed

Before	After	Diff

Select / Select Grouped With Disabled

1,728 px (1.95%) changed

Before	After	Diff

Select / Select Long List

1,354 px (1.3%) changed

Before	After	Diff

Select (Open)

1,155 px (0%) changed

Before	After	Diff

12 screenshot(s) unchanged

• Button / Basic
• Button / Variant: Secondary
• Button / Variant: Destructive
• Button / Variant: Secondary Destructive
• Button / Sizes
• Button / Icon Only
• Dialog / Dialog Basic
• Dialog / Dialog Alert
• Dialog / Dialog Confirmation
• Select / Select Custom Rendering
• Select / Select Disabled Options
• Select / Select Grouped

---

Generated by Kumo Visual Regression