diff --git a/.changeset/deprecate-kumo-hairline.md b/.changeset/deprecate-kumo-hairline.md new file mode 100644 index 0000000000..1d96bbe047 --- /dev/null +++ b/.changeset/deprecate-kumo-hairline.md @@ -0,0 +1,9 @@ +--- +"@cloudflare/kumo": minor +--- + +Deprecate `kumo-hairline` token in favor of `kumo-line`. + +The `kumo-line` token has been redefined to use 10% black in light mode and 10% white in dark mode, unifying the two former border/ring tokens into a single semantic token. All internal usage has been migrated from `kumo-hairline` to `kumo-line`. + +For backwards compatibility, `--color-kumo-hairline` is kept as a CSS alias for `--color-kumo-line`. Existing consumers using `bg-kumo-hairline`, `border-kumo-hairline`, `ring-kumo-hairline`, etc. will continue to work but should migrate to the `kumo-line` equivalents. The alias will be removed in the next major release. diff --git a/AGENTS.md b/AGENTS.md index 9d0b5529ad..fd9a04a040 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -39,7 +39,7 @@ kumo/ ### Styling (CRITICAL) -- **ONLY semantic tokens**: `bg-kumo-base`, `text-kumo-default`, `border-kumo-line`, `ring-kumo-hairline` +- **ONLY semantic tokens**: `bg-kumo-base`, `text-kumo-default`, `border-kumo-line`, `ring-kumo-line` - **NEVER raw Tailwind colors**: `bg-blue-500`, `text-gray-900` → fails lint - **NEVER `dark:` variant**: dark mode automatic via `light-dark()` in CSS custom properties - **Exceptions**: `bg-white`, `bg-black`, `text-white`, `text-black`, `transparent` diff --git a/lint/no-primitive-colors.js b/lint/no-primitive-colors.js index 1bb1a180c6..372417c841 100644 --- a/lint/no-primitive-colors.js +++ b/lint/no-primitive-colors.js @@ -11,7 +11,7 @@ const INVALID_TOKEN_RULE = "invalid-color-token"; // We want to enforce use of Kumo semantic color tokens `--color-kumo-*`. // Any Tailwind color utility (e.g. `bg-blue-500`) or legacy semantic -// utility (e.g. `bg-kumo-hairline`, `text-kumo-default`) in class strings should be +// utility (e.g. `bg-kumo-line`, `text-kumo-default`) in class strings should be // replaced by semantic tokens / component APIs. // Matches Tailwind-like color utilities in class strings. diff --git a/packages/kumo-docs-astro/src/components/Header.astro b/packages/kumo-docs-astro/src/components/Header.astro index 8da1ec2971..07cbd05460 100644 --- a/packages/kumo-docs-astro/src/components/Header.astro +++ b/packages/kumo-docs-astro/src/components/Header.astro @@ -8,10 +8,10 @@ const kumoVersion = ---