astralkit 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -1,37 +1,49 @@
-# Changelog
-
-All notable changes to the `astralkit` SDK package.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [0.3.1] — 2026-04-18
-
-### Added
-- `peerDependencies` declaration: `tailwindcss >= 3.0.0`. Installing `astralkit` in a project without Tailwind now surfaces a clear peer-dep warning instead of silent breakage.
-- File header comment on `astralkit-theme.css` explicitly marks it as the Tailwind v3 legacy file. Points readers at the `astralkit/theme-v3` export path and explains the v4 alternative.
-
-### Fixed
-- No functional changes from `0.3.0` — this is a metadata + documentation patch.
-
-## [0.3.0] — 2026-04-18
-
-### Changed (breaking behavior fix)
-- **`astralkit/theme` export now resolves to the Tailwind v4 file (`astralkit-theme-v4.css`).** Previously it pointed at `astralkit-theme.css` (the v3 `:root {}` file), which meant Tailwind v4 users were loading tokens that weren't registered with Tailwind's `@theme` system. Utilities like `bg-ak-primary` and `text-ak-text` were only working because the separate `astralkit-utilities.css` contains its own `@theme` blocks; the theme import was effectively dead weight.
-  - If you were relying on `@import "astralkit/theme"` resolving to the v3 `:root` syntax (e.g., in a Tailwind v3 project), import `astralkit/theme-v3` explicitly instead.
-  - If you're on Tailwind v4, no action needed — the new default is what you should have been getting all along.
-
-### Added
-- New `astralkit/theme-v3` export — explicit path to the Tailwind v3 legacy file (`astralkit-theme.css`).
-- `astralkit/theme-v4` export retained (unchanged) — still points at the v4 file. Existing imports keep working.
-- v4 theme refinements across 12 commits of token architecture work (including rail/panel elevated color overrides, sidebar token tuning, avatar size/badge tokens, and Phase A token standardization).
-- `primitives/.npmignore` — excludes `*.backup` and `*.pre-v4-split` scratch files from published tarballs. The `0.3.0` release removed ~220 kB of v3-migration scratch that was accidentally shipping in earlier versions.
-
-### Fixed
-- Tailwind v3 plugin registration (via CLI init) now covers additional `plugins: [...]` formatting variants.
-
-## [0.2.0] — 2026-04-02
-
-### Added
-- Initial public release on npm.
-- Design tokens (theme CSS), utilities CSS, palette presets, primitives folder, `cn()` helper, Tailwind v3/v4 configs.
+# Changelog
+
+All notable changes to the `astralkit` SDK package.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.3] — 2026-04-22
+
+### Changed
+- Widened `tailwind-merge` dependency range from `^2.2.0` to `^2.2.0 || ^3.0.0`. Tailwind CSS v4 projects use `tailwind-merge@v3` (which adds v4 class-name recognition), so accepting either major version lets npm dedupe to the host project's copy instead of nesting a second `node_modules/astralkit/node_modules/tailwind-merge`. Same `twMerge` API in both; no SDK code change required.
+
+## [0.3.2] — 2026-04-19
+
+### Fixed (revert of accidental change in 0.3.0 / 0.3.1)
+- **`astralkit/theme` export restored to the Tailwind v3 file (`astralkit-theme.css`, `:root` syntax).** This matches the 0.2.x default and is the designed behavior: v3 is the primary customer base, so the default export targets v3. Projects that pinned `0.3.0` or `0.3.1` saw this default silently flip to v4, which broke any v3 project with `@import "astralkit/theme"` in its CSS.
+- `astralkit/theme-v4` export unchanged — still the explicit opt-in for Tailwind v4 projects.
+- Removed the short-lived `astralkit/theme-v3` alias introduced in 0.3.0/0.3.1. If you added it to your CSS during that window, change it back to `astralkit/theme`.
+
+### Migrating from 0.3.0 / 0.3.1
+- **Tailwind v3 projects**: no action — your existing `@import "astralkit/theme"` now resolves to the v3 file again, as it did in 0.2.x.
+- **Tailwind v4 projects**: ensure your CSS uses `@import "astralkit/theme-v4"` (not `"astralkit/theme"`). The AstralKit main app and `astralkit init` for v4 projects already use the explicit `theme-v4` form.
+
+## [0.3.1] — 2026-04-18 (superseded — do not use for new installs)
+
+### Added
+- `peerDependencies` declaration: `tailwindcss >= 3.0.0`. Installing `astralkit` in a project without Tailwind now surfaces a clear peer-dep warning instead of silent breakage.
+- File header comment on `astralkit-theme.css` marking it as the Tailwind v3 file.
+
+### Known issue (fixed in 0.3.2)
+- The `astralkit/theme` export was flipped to resolve to the v4 file — unintentional. Any v3 project that upgraded from `0.2.x` silently started pulling v4 CSS. Use `0.3.2`.
+
+## [0.3.0] — 2026-04-18 (superseded — do not use for new installs)
+
+### Added
+- v4 theme refinements across 12 commits of token architecture work (rail/panel elevated colors, sidebar tokens, avatar sizes, Phase A standardization).
+- `primitives/.npmignore` — excludes `*.backup` and `*.pre-v4-split` scratch files from published tarballs (~220 kB removed).
+
+### Fixed
+- Tailwind v3 plugin registration (via CLI init) now covers additional `plugins: [...]` formatting variants.
+
+### Known issue (fixed in 0.3.2)
+- Same `astralkit/theme` export mis-resolution as 0.3.1. Use `0.3.2`.
+
+## [0.2.0] — 2026-04-02
+
+### Added
+- Initial public release on npm.
+- Design tokens (theme CSS), utilities CSS, palette presets, primitives folder, `cn()` helper, Tailwind v3/v4 configs.

package/LICENSE

@@ -1,34 +1,34 @@
-AstralKit License
-
-Copyright (c) 2025-2026 Blue Beacon Creative LLC. All rights reserved.
-
-This software and associated files (the "Software") are the proprietary
-intellectual property of Blue Beacon Creative LLC. The Software is licensed,
-not sold.
-
-The design tokens and CSS utilities included in this package are freely usable
-in any project that uses AstralKit components. Components, boosters, and
-workflows installed via the AstralKit CLI are governed by the AstralKit End
-User License Agreement.
-
-PROHIBITED USES
-
-You may NOT, without the express prior written consent of Blue Beacon Creative LLC:
-
-1. Use the Software's source code as training data, fine-tuning data, or input
-   for any artificial intelligence system, machine learning model, large language
-   model, neural network, or any automated system designed to generate code,
-   text, images, or other output.
-
-2. Resell, sublicense, or redistribute the Software as a standalone product,
-   design system, or token library.
-
-3. Build a competing product using the Software's design tokens, CSS
-   architecture, or utility system.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED. IN NO EVENT SHALL BLUE BEACON CREATIVE LLC BE LIABLE FOR ANY CLAIM,
-DAMAGES OR OTHER LIABILITY.
-
-Full license terms: https://astralkit.com/license
-Contact: hello@astralkit.com
+AstralKit License
+
+Copyright (c) 2025-2026 Blue Beacon Creative LLC. All rights reserved.
+
+This software and associated files (the "Software") are the proprietary
+intellectual property of Blue Beacon Creative LLC. The Software is licensed,
+not sold.
+
+The design tokens and CSS utilities included in this package are freely usable
+in any project that uses AstralKit components. Components, boosters, and
+workflows installed via the AstralKit CLI are governed by the AstralKit End
+User License Agreement.
+
+PROHIBITED USES
+
+You may NOT, without the express prior written consent of Blue Beacon Creative LLC:
+
+1. Use the Software's source code as training data, fine-tuning data, or input
+   for any artificial intelligence system, machine learning model, large language
+   model, neural network, or any automated system designed to generate code,
+   text, images, or other output.
+
+2. Resell, sublicense, or redistribute the Software as a standalone product,
+   design system, or token library.
+
+3. Build a competing product using the Software's design tokens, CSS
+   architecture, or utility system.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL BLUE BEACON CREATIVE LLC BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY.
+
+Full license terms: https://astralkit.com/license
+Contact: hello@astralkit.com

package/README.md

@@ -1,58 +1,71 @@
-# astralkit
-
-Design tokens, CSS variables, and utilities for [AstralKit](https://astralkit.com) UI components.
-
-This package provides the foundation that all AstralKit components depend on:
-
-- **Theme CSS** — `ak-*` design tokens (colors, spacing, typography, radius, shadows)
-- **Utilities CSS** — Tailwind CSS utility class extensions
-- **`cn()` helper** — Class merging utility (clsx + tailwind-merge)
-
-## Installation
-
-```bash
-npm install astralkit
-```
-
-Or use the CLI which installs this automatically:
-
-```bash
-npx @astralkit/cli init
-```
-
-## Usage
-
-**In your CSS:**
-```css
-@import "tailwindcss";
-@import "astralkit/theme";
-@import "astralkit/utilities";
-```
-
-**In your components:**
-```tsx
-import { cn } from 'astralkit/utils'
-
-export function Button({ className, ...props }) {
-  return <button className={cn('px-4 py-2 bg-ak-primary text-ak-on-primary', className)} {...props} />
-}
-```
-
-## What's included
-
-| Export | Description |
-|---|---|
-| `astralkit/theme` | CSS custom properties for all design tokens |
-| `astralkit/utilities` | Tailwind CSS utility extensions |
-| `astralkit/utils` | `cn()` class merging function |
-
-## Documentation
-
-- [Getting Started](https://astralkit.com/documentation/quick-start)
-- [Design Tokens](https://astralkit.com/documentation/design-tokens)
-- [CSS Variables Reference](https://astralkit.com/documentation/css-variables-reference)
-- [Theming & Customization](https://astralkit.com/documentation/theming-customization)
-
-## License
-
-Proprietary — [AstralKit License](https://astralkit.com/license)
+# astralkit
+
+Design tokens, CSS variables, and utilities for [AstralKit](https://astralkit.com) UI components.
+
+This package provides the foundation that all AstralKit components depend on:
+
+- **Theme CSS** — `ak-*` design tokens (colors, spacing, typography, radius, shadows)
+- **Utilities CSS** — Tailwind CSS utility class extensions
+- **`cn()` helper** — Class merging utility (clsx + tailwind-merge)
+
+## Installation
+
+```bash
+npm install astralkit
+```
+
+Or use the CLI which installs this automatically:
+
+```bash
+npx @astralkit/cli init
+```
+
+## Usage
+
+**In your CSS — Tailwind v3 (default):**
+```css
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+@import "astralkit/theme";
+@import "astralkit/utilities";
+```
+
+> Also add `require('astralkit/tailwind.cjs')` to the `plugins` array in your `tailwind.config.js`. `astralkit init` does this for you.
+
+**In your CSS — Tailwind v4:**
+```css
+@import "tailwindcss";
+@import "astralkit/theme-v4";
+@import "astralkit/utilities";
+```
+
+**In your components:**
+```tsx
+import { cn } from 'astralkit/utils'
+
+export function Button({ className, ...props }) {
+  return <button className={cn('px-4 py-2 bg-ak-primary text-ak-on-primary', className)} {...props} />
+}
+```
+
+## What's included
+
+| Export | Description |
+|---|---|
+| `astralkit/theme` | Design tokens as CSS custom properties (Tailwind **v3** — default) |
+| `astralkit/theme-v4` | Design tokens via the Tailwind v4 `@theme` directive |
+| `astralkit/utilities` | Tailwind CSS utility extensions (works with v3 and v4) |
+| `astralkit/tailwind.cjs` | Tailwind v3 plugin — registers `ak-*` tokens with the v3 config |
+| `astralkit/utils` | `cn()` class merging function |
+
+## Documentation
+
+- [Getting Started](https://astralkit.com/documentation/quick-start)
+- [Design Tokens](https://astralkit.com/documentation/design-tokens)
+- [CSS Variables Reference](https://astralkit.com/documentation/css-variables-reference)
+- [Theming & Customization](https://astralkit.com/documentation/theming-customization)
+
+## License
+
+Proprietary — [AstralKit License](https://astralkit.com/license)