# @cloudflare/kumo-docs-astro

## 1.4.1

### Patch Changes

- e53bd68: Rebalanced semantic text token usage to improve hierarchy and consistency across components, docs, and generated Figma output.
  - Updated theme token definitions so `text-kumo-strong` represents high-emphasis text and `text-kumo-inactive` is lighter/inactive in both light and dark modes.
  - Migrated affected UI surfaces from `text-kumo-strong` to `text-kumo-subtle` where content is supportive metadata, labels, or secondary text.
  - Synced token usage in docs and Figma code generators with the updated semantic text mapping.

- Updated dependencies [e53bd68]
  - @cloudflare/kumo@2.0.1

## 1.4.0

### Minor Changes

- 353faea: Adds Autocomplete component. A free-form text input with an optional filtered suggestion list. Unlike Combobox, the value is not constrained to the items list.

### Patch Changes

- ec73bc5: Update chart color docs and demos, including sequential heatmap/CVD coverage and improved chart demo behavior.
- 8cc65bf: Clean up the Contributing page: remove the "Questions?" section that referenced an internal channel, and fix the "Related Docs" links to point to absolute GitHub URLs instead of relative paths that 404'd.
- 1eee41a: Add `InputGroup` compound component for composing decorated inputs

  Compound structure: `InputGroup`, `InputGroup.Input`, `InputGroup.Addon`, `InputGroup.Suffix`, `InputGroup.Button`.
  - Field integration — pass `label`, `description`, `error`, `required`, and `labelTooltip` directly to `InputGroup`
  - Size variants (`xs`, `sm`, `base`, `lg`) propagate to all sub-components via context, including icon sizing in addons
  - `InputGroup.Addon` — positions icons, text, or buttons at `align="start"` (default) or `align="end"` of the input
  - `InputGroup.Suffix` — inline text suffix (e.g. `.workers.dev`)
  - `InputGroup.Button` — ghost button for secondary actions with tooltip support
  - Deprecated `InputGroup.Label` — use `InputGroup.Addon` instead
  - Deprecated `InputGroup.Description` — use `InputGroup.Suffix` instead

  ```tsx
  {
    /* Reveal / hide password */
  }
  <InputGroup>
    <InputGroup.Input
      type={show ? "text" : "password"}
      defaultValue="password"
      aria-label="Password"
    />
    <InputGroup.Addon align="end" className="pr-1">
      <InputGroup.Button
        size="sm"
        aria-label={show ? "Hide password" : "Show password"}
        onClick={() => setShow(!show)}
      >
        {show ? <EyeSlashIcon size={16} /> : <EyeIcon size={16} />}
      </InputGroup.Button>
    </InputGroup.Addon>
  </InputGroup>;
  ```

  ```tsx
  {
    /* Search input */
  }
  <InputGroup>
    <InputGroup.Addon>
      <MagnifyingGlassIcon className="text-kumo-subtle" />
    </InputGroup.Addon>
    <InputGroup.Input placeholder="Search..." />
  </InputGroup>;
  ```

- f774e84: Fix copy code button z-index so it no longer appears above the sticky header when scrolling
- c019b41: Improved focus and keyboard accessibility styles across Kumo components and docs navigation.
  - Added the `kumo-focus` semantic token to the theme generator config and generated `theme-kumo.css` output.
  - Updated focus ring behavior across interactive components (including `Button`, `Input`, `InputGroup`, `Select`, `Checkbox`, `Radio`, `Switch`, `Sidebar`, `Tabs`, `Menubar`, and related controls) for more consistent and visible keyboard focus visibility.
  - Text-entry controls use a lighter opacity `kumo-focus` ring to keep pointer and keyboard focus visually consistent where browsers apply `:focus-visible` heuristics to typed-input controls.
  - Refined `Select` and `Input` styling/state combinations to align focus visuals with current semantic token usage.
  - Updated docs `SidebarNav` keyboard-focus affordances (links, section toggles, search trigger) and adjusted collapsible list overflow so focus rings remain visible.
  - Replace raw colors in `Select` with kumo semantic tokens.

- 87432f8: Add global letter-spacing and typography defaults
  - Set global `letter-spacing: -0.01em`, `line-height: 1.5`, and OpenType font features (`cv02`, `cv03`, `cv04`, `calt`) on `html`
  - Reset `letter-spacing: normal` on `pre`, `code`, `kbd`, and `.font-mono` elements
  - Replace hardcoded `tracking-[-0.02em]` with `tracking-tight` utility across headings
  - Switch prose paragraphs and lists from `leading-relaxed` to `leading-normal`

- Updated dependencies [ac6df5f]
- Updated dependencies [ec73bc5]
- Updated dependencies [bf68ac0]
- Updated dependencies [f9ba3f9]
- Updated dependencies [7d12918]
- Updated dependencies [69bfc53]
- Updated dependencies [30bfd82]
- Updated dependencies [1954aa8]
- Updated dependencies [3256a7b]
- Updated dependencies [1eee41a]
- Updated dependencies [b923281]
- Updated dependencies [06b8852]
- Updated dependencies [c019b41]
- Updated dependencies [21ed1a1]
- Updated dependencies [fa991d9]
- Updated dependencies [353faea]
- Updated dependencies [431de04]
- Updated dependencies [f9d8b76]
- Updated dependencies [07426f6]
- Updated dependencies [c1c60c8]
- Updated dependencies [267ba7a]
- Updated dependencies [6765526]
  - @cloudflare/kumo@2.0.0

## 1.3.18

### Patch Changes

- 547c7fa: Updated the token value for `kumo-line` and `kumo-hairline` in dark mode so they are more visible.
  - replace `kumo-line` usages with `kumo-hairline` across Kumo components and docs UI/content styles
  - use `ring-kumo-line` for shadowed surfaces (for example combobox, dialog, select, dropdown, toast, and related surface wrappers)
  - adjust theme token configuration and generated styles to support updated neutral/hairline appearance

- Updated dependencies [da6eee1]
- Updated dependencies [4785c43]
- Updated dependencies [1e7ba10]
- Updated dependencies [2682319]
- Updated dependencies [a0f2b18]
- Updated dependencies [9eb1306]
- Updated dependencies [4565baa]
- Updated dependencies [4dfdc3f]
- Updated dependencies [98e3170]
- Updated dependencies [9c3cdbf]
- Updated dependencies [27bcd59]
- Updated dependencies [a8adf02]
- Updated dependencies [547c7fa]
- Updated dependencies [58b5777]
- Updated dependencies [460a603]
- Updated dependencies [0cae077]
  - @cloudflare/kumo@1.19.0

## 1.3.17

### Patch Changes

- cf6b917: Align semantic token documentation and docs presentation updates.
  - Update `colors.mdx` token documentation structure.
  - Replaced `kumo-ring` with `kumo-hairline` for border/ring colors and all its instances in kumo components and docs.
  - Sync `packages/kumo/ai/USAGE.md` token reference categories and descriptions with the docs token guide.
  - Adjust the typo in the recessed dark token value in theme generator config and regenerate `theme-kumo.css`.
  - Updated `kumo-fill-hover` token value from `neutral-700` to `neutral-800`

- Updated dependencies [dacf445]
- Updated dependencies [44c26f5]
- Updated dependencies [2bb8628]
- Updated dependencies [e8bcf6f]
- Updated dependencies [c3beded]
- Updated dependencies [4a2fb02]
- Updated dependencies [b1e51a8]
- Updated dependencies [e676f0b]
- Updated dependencies [5e4c7b1]
- Updated dependencies [6458fae]
- Updated dependencies [cf6b917]
- Updated dependencies [a685953]
  - @cloudflare/kumo@1.18.0

## 1.3.16

### Patch Changes

- 6c21970: Fix missing disabled styling on Combobox triggers. `TriggerValue` and `TriggerMultipleWithInput` now apply `opacity-50` and `cursor-not-allowed` when disabled, matching the behaviour of the `Select` component.
- 36f1609: - Added a table-of-contents to the docs pages
  - Refined layout updates
  - Improved prose styling while avoiding impacts to embedded component previews
- c58357d: Add changelog page
- 0e5dd5e: restructure contributing docs into a complete contributor workflow so setup, validation, changeset, and PR guidance are all in one place
- Updated dependencies [355a1b5]
- Updated dependencies [250a6dd]
- Updated dependencies [7721bc5]
- Updated dependencies [8c244d2]
- Updated dependencies [6c21970]
- Updated dependencies [0e4247a]
- Updated dependencies [ef15662]
- Updated dependencies [0060bb9]
- Updated dependencies [04a1f07]
- Updated dependencies [94d50e2]
- Updated dependencies [cd0c22f]
- Updated dependencies [db75c51]
- Updated dependencies [17f21f3]
- Updated dependencies [eb68b35]
- Updated dependencies [e21a6df]
- Updated dependencies [29c56fd]
- Updated dependencies [9272b4a]
- Updated dependencies [6b15bac]
- Updated dependencies [d1f697b]
- Updated dependencies [cfe814d]
- Updated dependencies [7ac73d2]
- Updated dependencies [56e3640]
- Updated dependencies [dcbf185]
- Updated dependencies [f0c8952]
  - @cloudflare/kumo@1.17.0

## 1.3.15

### Patch Changes

- Updated dependencies [b3c44f1]
- Updated dependencies [c5f69b9]
- Updated dependencies [759f4e8]
- Updated dependencies [a67fac7]
- Updated dependencies [15a344e]
- Updated dependencies [5d8d3a9]
- Updated dependencies [7e82920]
  - @cloudflare/kumo@1.16.0

## 1.3.14

### Patch Changes

- Updated dependencies [9fbf3a8]
- Updated dependencies [3430785]
- Updated dependencies [73f554a]
  - @cloudflare/kumo@1.15.0

## 1.3.13

### Patch Changes

- 839b0cb: fix: update styling for mostly-used components with new greyscale tokens (combobox, dialog, input, layerCard, select & tabs) as well as homegrid and component preview backgrounds.
- Updated dependencies [839b0cb]
- Updated dependencies [7083a17]
  - @cloudflare/kumo@1.14.1

## 1.3.12

### Patch Changes

- 70a7443: Updated the Contributing docs with content from `CONTRIBUTING.md` so there's a single source of truth for our contribution workflow and repository guidance.
- Updated dependencies [f2e17d7]
- Updated dependencies [eba693e]
- Updated dependencies [db91f50]
- Updated dependencies [80afd4d]
- Updated dependencies [dc9742d]
- Updated dependencies [f94fee7]
- Updated dependencies [66012b7]
- Updated dependencies [8b2d6a0]
- Updated dependencies [e8acdd8]
- Updated dependencies [abbf586]
- Updated dependencies [c6aa554]
  - @cloudflare/kumo@1.14.0

## 1.3.11

### Patch Changes

- Updated dependencies [c272f6a]
- Updated dependencies [5e12c15]
  - @cloudflare/kumo@1.13.1

## 1.3.10

### Patch Changes

- Updated dependencies [56a8b35]
  - @cloudflare/kumo@1.13.0

## 1.3.9

### Patch Changes

- Updated dependencies [eda8362]
  - @cloudflare/kumo@1.12.1

## 1.3.8

### Patch Changes

- Updated dependencies [2ff49b7]
- Updated dependencies [4d6de27]
- Updated dependencies [59f7935]
- Updated dependencies [9eaf584]
  - @cloudflare/kumo@1.12.0

## 1.3.7

### Patch Changes

- Updated dependencies [a53ec1b]
- Updated dependencies [cb121bc]
- Updated dependencies [c6a3fb3]
- Updated dependencies [1bfffaa]
- Updated dependencies [5d16fdb]
- Updated dependencies [8b964f5]
- Updated dependencies [529274d]
- Updated dependencies [140f4ab]
- Updated dependencies [f1c6392]
- Updated dependencies [da03394]
- Updated dependencies [2f0e572]
- Updated dependencies [ee1099d]
- Updated dependencies [6dc952f]
- Updated dependencies [2352344]
  - @cloudflare/kumo@1.11.0

## 1.3.6

### Patch Changes

- Updated dependencies [5943e77]
- Updated dependencies [35d5c42]
- Updated dependencies [5505610]
- Updated dependencies [003128b]
- Updated dependencies [1cad157]
- Updated dependencies [9d89256]
- Updated dependencies [e6218d2]
- Updated dependencies [02d0d65]
- Updated dependencies [3170d65]
- Updated dependencies [31ce577]
- Updated dependencies [ee5a632]
- Updated dependencies [409d32b]
- Updated dependencies [7816318]
- Updated dependencies [e7f0c80]
- Updated dependencies [a7eb061]
- Updated dependencies [c0341b4]
- Updated dependencies [35d5c42]
- Updated dependencies [abb7f8c]
- Updated dependencies [8972cc4]
- Updated dependencies [bb49d4b]
  - @cloudflare/kumo@1.10.0

## 1.3.5

### Patch Changes

- Updated dependencies [23865db]
- Updated dependencies [89cb5ec]
- Updated dependencies [68c2f0d]
  - @cloudflare/kumo@1.9.0

## 1.3.4

### Patch Changes

- Updated dependencies [0ca3b05]
- Updated dependencies [f69df6d]
- Updated dependencies [cf4ff38]
  - @cloudflare/kumo@1.8.0

## 1.3.3

### Patch Changes

- Updated dependencies [d9b6498]
- Updated dependencies [835a7c0]
- Updated dependencies [391f13a]
- Updated dependencies [d0e1d29]
  - @cloudflare/kumo@1.7.0

## 1.3.2

### Patch Changes

- Updated dependencies [c71bd9b]
- Updated dependencies [50d4251]
- Updated dependencies [93361ed]
- Updated dependencies [46ecf42]
- Updated dependencies [a9167fa]
- Updated dependencies [f02494d]
  - @cloudflare/kumo@1.6.0

## 1.3.1

### Patch Changes

- 752fdf1: support overwriting text in pagination component
- Updated dependencies [2c8a5ad]
- Updated dependencies [31cc2e1]
- Updated dependencies [1ae7dfd]
- Updated dependencies [fa3eba3]
- Updated dependencies [3bc976e]
- Updated dependencies [752fdf1]
  - @cloudflare/kumo@1.5.1

## 1.3.0

### Minor Changes

- d7a6da3: fix(cli): resolve broken doc/docs/ls commands by fixing registry path from catalog/ to ai/
  fix(dialog): wrap sub-components to isolate @base-ui/react type references from downstream consumers
  fix(label): render as `<label>` element with htmlFor support instead of `<span>`
  feat(input): add Textarea alias for InputArea
  feat(toast): add ToastProvider alias for Toasty
  feat(button): require aria-label on icon-only buttons (shape="square" | "circle") via discriminated union
  fix(docs): add Tailwind 4 @source directive to usage example, add confirmation dialog recipe, update Select basic example, document icon-only button aria-label pattern

### Patch Changes

- Updated dependencies [d7a6da3]
  - @cloudflare/kumo@1.5.0

## 1.2.2

### Patch Changes

- Updated dependencies [b64847d]
- Updated dependencies [ea583d8]
  - @cloudflare/kumo@1.4.1

## 1.2.1

### Patch Changes

- Updated dependencies [71d667b]
- Updated dependencies [262e0e6]
  - @cloudflare/kumo@1.4.0

## 1.2.0

### Minor Changes

- 6a40edf: add 'Delete Resource' block

### Patch Changes

- Updated dependencies [6a40edf]
  - @cloudflare/kumo@1.3.0

## 1.1.0

### Minor Changes

- 833ce8b: Add variant support, custom content, and action buttons to Toast component.

### Patch Changes

- Updated dependencies [d10c711]
- Updated dependencies [833ce8b]
  - @cloudflare/kumo@1.2.0

## 1.0.1

### Patch Changes

- Updated dependencies [6dc9a73]
- Updated dependencies [001f9e7]
  - @cloudflare/kumo@1.1.0

## 1.0.0

### Major Changes

- 11e62a2: # Kumo 1.0.0 Release

  The first stable release of Kumo, Cloudflare's component library.

  ## Breaking Changes

  ### Blocks Distribution via CLI

  Blocks (`PageHeader`, `ResourceListPage`) are no longer exported from `@cloudflare/kumo`. They must now be installed via the CLI:

  ```bash
  npx @cloudflare/kumo init        # Initialize kumo.json
  npx @cloudflare/kumo add PageHeader
  ```

  Blocks are copied to your project for full customization with imports automatically transformed to `@cloudflare/kumo`.

  ### Checkbox API Changes
  - **Ref type changed**: `HTMLInputElement` → `HTMLButtonElement`
  - **Props changed**: No longer extends `InputHTMLAttributes` (explicit props only)
  - **Handler renamed**: `onChange`/`onValueChange` → `onCheckedChange` (deprecated handlers still work)

  ### Banner API Deprecation

  The `text` prop is deprecated in favor of `children`:

  ```tsx
  // Before (deprecated)
  <Banner text="Your message" />

  // After (preferred)
  <Banner>Your message</Banner>
  ```

  ## New Features
  - **Link component**: Inline text links with Base UI composition API and `render` prop for framework routing
  - **DropdownMenu enhancements**: Nested submenus (`Sub`, `SubTrigger`, `SubContent`) and radio items (`RadioGroup`, `RadioItem`)
  - **Grid component**: New layout primitive
  - **Theme generator**: Config-driven token definitions with consolidated semantic color system
  - **Component catalog**: Visibility controls for documentation
  - **Deprecated props lint rule**: `kumo/no-deprecated-props` detects `@deprecated` JSDoc tags

  ## Fixes
  - Dropdown danger variant color contrast
  - Tabs segmented indicator border radius
  - Combobox dropdown scrolling
  - Primary button hover/focus contrast

  ## Migration Guide

  ### Blocks

  If you were using blocks (note: they were never officially exported):

  ```bash
  # 1. Initialize configuration
  npx @cloudflare/kumo init

  # 2. Install blocks
  npx @cloudflare/kumo add PageHeader
  npx @cloudflare/kumo add ResourceListPage

  # 3. Update imports to the local path shown after installation
  ```

  ### Checkbox

  ```tsx
  // Before
  <Checkbox onChange={(e) => setValue(e.target.checked)} />;
  const ref = useRef<HTMLInputElement>(null);

  // After
  <Checkbox onCheckedChange={(checked) => setValue(checked)} />;
  const ref = useRef<HTMLButtonElement>(null);
  ```

  ### Banner

  ```tsx
  // Before (still works, but deprecated)
  <Banner text="Your message" />

  // After
  <Banner>Your message</Banner>
  ```

### Minor Changes

- 2de0c7b: feat: theme generator, color token consolidation, component catalog
  - New theme generator system with config-driven token definitions
  - Consolidated semantic color tokens with config.ts as single source of truth
  - New component catalog system with visibility controls
  - Added Grid component
  - Updated Figma plugin generators for new semantic tokens
  - Migrated documentation from Storybook to Astro

### Patch Changes

- Updated dependencies [3a28186]
- Updated dependencies [2de0c7b]
- Updated dependencies [08c4426]
- Updated dependencies [2de0c7b]
- Updated dependencies [604fa9a]
- Updated dependencies [8cf48b7]
- Updated dependencies [11e62a2]
- Updated dependencies [98116b2]
- Updated dependencies [d071bc8]
- Updated dependencies [80c6470]
- Updated dependencies [2c7f957]
- Updated dependencies [3a2e265]
- Updated dependencies [2de0c7b]
- Updated dependencies [e9fe499]
- Updated dependencies [7d4a4e0]
  - @cloudflare/kumo@1.0.0

## 0.5.0

### Minor Changes

- d04c91f: Ship component registry with @cloudflare/kumo module
- d04c91f: Migrate documentation site from React Router (`kumo-docs`) to Astro (`kumo-docs-astro`) as the primary docs platform, consolidate CI/CD pipelines, and add version display features.

  Bump node to v24.12.0

### Patch Changes

- Updated dependencies [d04c91f]
- Updated dependencies [0e246bf]
- Updated dependencies [d04c91f]
  - @cloudflare/kumo@0.7.0

## 0.4.2

### Patch Changes

- Updated dependencies [46236bd]
- Updated dependencies [50dae6f]
- Updated dependencies [4266f72]
- Updated dependencies [4ac5fbe]
- Updated dependencies [009097d]
  - @cloudflare/kumo@0.6.0

## 0.4.1

### Patch Changes

- Updated dependencies [ee744b3]
- Updated dependencies [b4a817f]
- Updated dependencies [7c2e8dd]
- Updated dependencies [5bdfae9]
- Updated dependencies [d598621]
- Updated dependencies [0e5cf84]
- Updated dependencies [e613876]
- Updated dependencies [6c94137]
- Updated dependencies [d9add6b]
- Updated dependencies [356d1e6]
- Updated dependencies [742dc89]
- Updated dependencies [5b256bd]
- Updated dependencies [872ef11]
- Updated dependencies [d998518]
- Updated dependencies [9537114]
  - @cloudflare/kumo@0.5.0
