# @cloudflare/kumo-docs-astro

## 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
