cloudflare/kumo
Publicmirrored fromhttps://github.com/cloudflare/kumoAvailable
packages/kumo-docs-astro/CHANGELOG.md
177lines · modecode
| 1 | # @cloudflare/kumo-docs-astro |
| 2 | |
| 3 | ## 1.0.1 |
| 4 | |
| 5 | ### Patch Changes |
| 6 | |
| 7 | - Updated dependencies [6dc9a73] |
| 8 | - Updated dependencies [001f9e7] |
| 9 | - @cloudflare/kumo@1.1.0 |
| 10 | |
| 11 | ## 1.0.0 |
| 12 | |
| 13 | ### Major Changes |
| 14 | |
| 15 | - 11e62a2: # Kumo 1.0.0 Release |
| 16 | |
| 17 | The first stable release of Kumo, Cloudflare's component library. |
| 18 | |
| 19 | ## Breaking Changes |
| 20 | |
| 21 | ### Blocks Distribution via CLI |
| 22 | |
| 23 | Blocks (`PageHeader`, `ResourceListPage`) are no longer exported from `@cloudflare/kumo`. They must now be installed via the CLI: |
| 24 | |
| 25 | ```bash |
| 26 | npx @cloudflare/kumo init # Initialize kumo.json |
| 27 | npx @cloudflare/kumo add PageHeader |
| 28 | ``` |
| 29 | |
| 30 | Blocks are copied to your project for full customization with imports automatically transformed to `@cloudflare/kumo`. |
| 31 | |
| 32 | ### Checkbox API Changes |
| 33 | - **Ref type changed**: `HTMLInputElement` → `HTMLButtonElement` |
| 34 | - **Props changed**: No longer extends `InputHTMLAttributes` (explicit props only) |
| 35 | - **Handler renamed**: `onChange`/`onValueChange` → `onCheckedChange` (deprecated handlers still work) |
| 36 | |
| 37 | ### Banner API Deprecation |
| 38 | |
| 39 | The `text` prop is deprecated in favor of `children`: |
| 40 | |
| 41 | ```tsx |
| 42 | // Before (deprecated) |
| 43 | <Banner text="Your message" /> |
| 44 | |
| 45 | // After (preferred) |
| 46 | <Banner>Your message</Banner> |
| 47 | ``` |
| 48 | |
| 49 | ## New Features |
| 50 | - **Link component**: Inline text links with Base UI composition API and `render` prop for framework routing |
| 51 | - **DropdownMenu enhancements**: Nested submenus (`Sub`, `SubTrigger`, `SubContent`) and radio items (`RadioGroup`, `RadioItem`) |
| 52 | - **Grid component**: New layout primitive |
| 53 | - **Theme generator**: Config-driven token definitions with consolidated semantic color system |
| 54 | - **Component catalog**: Visibility controls for documentation |
| 55 | - **Deprecated props lint rule**: `kumo/no-deprecated-props` detects `@deprecated` JSDoc tags |
| 56 | |
| 57 | ## Fixes |
| 58 | - Dropdown danger variant color contrast |
| 59 | - Tabs segmented indicator border radius |
| 60 | - Combobox dropdown scrolling |
| 61 | - Primary button hover/focus contrast |
| 62 | |
| 63 | ## Migration Guide |
| 64 | |
| 65 | ### Blocks |
| 66 | |
| 67 | If you were using blocks (note: they were never officially exported): |
| 68 | |
| 69 | ```bash |
| 70 | # 1. Initialize configuration |
| 71 | npx @cloudflare/kumo init |
| 72 | |
| 73 | # 2. Install blocks |
| 74 | npx @cloudflare/kumo add PageHeader |
| 75 | npx @cloudflare/kumo add ResourceListPage |
| 76 | |
| 77 | # 3. Update imports to the local path shown after installation |
| 78 | ``` |
| 79 | |
| 80 | ### Checkbox |
| 81 | |
| 82 | ```tsx |
| 83 | // Before |
| 84 | <Checkbox onChange={(e) => setValue(e.target.checked)} />; |
| 85 | const ref = useRef<HTMLInputElement>(null); |
| 86 | |
| 87 | // After |
| 88 | <Checkbox onCheckedChange={(checked) => setValue(checked)} />; |
| 89 | const ref = useRef<HTMLButtonElement>(null); |
| 90 | ``` |
| 91 | |
| 92 | ### Banner |
| 93 | |
| 94 | ```tsx |
| 95 | // Before (still works, but deprecated) |
| 96 | <Banner text="Your message" /> |
| 97 | |
| 98 | // After |
| 99 | <Banner>Your message</Banner> |
| 100 | ``` |
| 101 | |
| 102 | ### Minor Changes |
| 103 | |
| 104 | - 2de0c7b: feat: theme generator, color token consolidation, component catalog |
| 105 | - New theme generator system with config-driven token definitions |
| 106 | - Consolidated semantic color tokens with config.ts as single source of truth |
| 107 | - New component catalog system with visibility controls |
| 108 | - Added Grid component |
| 109 | - Updated Figma plugin generators for new semantic tokens |
| 110 | - Migrated documentation from Storybook to Astro |
| 111 | |
| 112 | ### Patch Changes |
| 113 | |
| 114 | - Updated dependencies [3a28186] |
| 115 | - Updated dependencies [2de0c7b] |
| 116 | - Updated dependencies [08c4426] |
| 117 | - Updated dependencies [2de0c7b] |
| 118 | - Updated dependencies [604fa9a] |
| 119 | - Updated dependencies [8cf48b7] |
| 120 | - Updated dependencies [11e62a2] |
| 121 | - Updated dependencies [98116b2] |
| 122 | - Updated dependencies [d071bc8] |
| 123 | - Updated dependencies [80c6470] |
| 124 | - Updated dependencies [2c7f957] |
| 125 | - Updated dependencies [3a2e265] |
| 126 | - Updated dependencies [2de0c7b] |
| 127 | - Updated dependencies [e9fe499] |
| 128 | - Updated dependencies [7d4a4e0] |
| 129 | - @cloudflare/kumo@1.0.0 |
| 130 | |
| 131 | ## 0.5.0 |
| 132 | |
| 133 | ### Minor Changes |
| 134 | |
| 135 | - d04c91f: Ship component registry with @cloudflare/kumo module |
| 136 | - 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. |
| 137 | |
| 138 | Bump node to v24.12.0 |
| 139 | |
| 140 | ### Patch Changes |
| 141 | |
| 142 | - Updated dependencies [d04c91f] |
| 143 | - Updated dependencies [0e246bf] |
| 144 | - Updated dependencies [d04c91f] |
| 145 | - @cloudflare/kumo@0.7.0 |
| 146 | |
| 147 | ## 0.4.2 |
| 148 | |
| 149 | ### Patch Changes |
| 150 | |
| 151 | - Updated dependencies [46236bd] |
| 152 | - Updated dependencies [50dae6f] |
| 153 | - Updated dependencies [4266f72] |
| 154 | - Updated dependencies [4ac5fbe] |
| 155 | - Updated dependencies [009097d] |
| 156 | - @cloudflare/kumo@0.6.0 |
| 157 | |
| 158 | ## 0.4.1 |
| 159 | |
| 160 | ### Patch Changes |
| 161 | |
| 162 | - Updated dependencies [ee744b3] |
| 163 | - Updated dependencies [b4a817f] |
| 164 | - Updated dependencies [7c2e8dd] |
| 165 | - Updated dependencies [5bdfae9] |
| 166 | - Updated dependencies [d598621] |
| 167 | - Updated dependencies [0e5cf84] |
| 168 | - Updated dependencies [e613876] |
| 169 | - Updated dependencies [6c94137] |
| 170 | - Updated dependencies [d9add6b] |
| 171 | - Updated dependencies [356d1e6] |
| 172 | - Updated dependencies [742dc89] |
| 173 | - Updated dependencies [5b256bd] |
| 174 | - Updated dependencies [872ef11] |
| 175 | - Updated dependencies [d998518] |
| 176 | - Updated dependencies [9537114] |
| 177 | - @cloudflare/kumo@0.5.0 |
| 178 | |