astralkit 0.7.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +109 -102
- package/astralkit-theme-v4.css +750 -750
- package/astralkit-theme.css +750 -750
- package/astralkit-utilities.css +1128 -1128
- package/package.json +1 -1
- package/primitives/forms.css +2155 -2155
- package/primitives/layout.css +220 -220
- package/primitives/mobile.css +557 -557
- package/primitives/navigation.css +1057 -1057
- package/tailwind.cjs +544 -536
package/CHANGELOG.md
CHANGED
|
@@ -1,102 +1,109 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
All notable changes to the `astralkit` SDK package.
|
|
4
|
-
|
|
5
|
-
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
|
-
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
-
|
|
8
|
-
## [0.
|
|
9
|
-
|
|
10
|
-
###
|
|
11
|
-
- **
|
|
12
|
-
-
|
|
13
|
-
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
- `ak-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
- **
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
###
|
|
96
|
-
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to the `astralkit` SDK package.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [0.8.0] — 2026-08-23
|
|
9
|
+
|
|
10
|
+
### Changed (BREAKING — spacing grammar renumbered)
|
|
11
|
+
- **The ak spacing scale now uses Tailwind's core 4px-grid numbering.** `ak-N` = core `N` semantics: `ak-1`=4px, `ak-2`=8px, `ak-3`=12px, `ak-4`=16px, `ak-6`=24px … `ak-48`=192px. Values are UNCHANGED — names moved onto the numbering every AI coder and Tailwind user already knows, eliminating the underscore-fraction gotcha family (`ak-1_5` et al.).
|
|
12
|
+
- The two off-grid steps left the ak namespace: 6px is core `1.5` (`p-1.5`), 10px is core `2.5` — identical pixels, standard spelling.
|
|
13
|
+
- Old fraction names (`ak-0_5`…`ak-5_5`, dot variants in v3) remain as DEPRECATED aliases at their original values; removal planned for 1.0. Old INTEGER names could not be aliased (they collide with the new grammar) — code written against pre-0.8 integers must be migrated (`tools/spacing-migration/rename-map.py` in the AstralKit repo does it in one pass).
|
|
14
|
+
|
|
15
|
+
## [0.7.0] — 2026-08-22
|
|
16
|
+
|
|
17
|
+
### Added
|
|
18
|
+
- **Material utilities** — `ak-material-surface`, `ak-material-control`, refined `ak-dark-material`: the opaque elevated material surfaces the kanban/core component sets use for modals, drawers, and floating controls. Components built against these rendered **transparent overlays** on 0.6.0 (found live via the kanban-01 task drawer).
|
|
19
|
+
- **Semantic font utilities** — `ak-font-heading`, `ak-font-label`, `ak-font-ui`, `ak-font-ui-strong`, `ak-font-body`, backed by new font-dial variables (`--font-ak-heading` etc., with the previous literal stacks as fallbacks) so a theme can re-font at runtime.
|
|
20
|
+
- **Radix animation helpers** — `ak-overlay-anim`, `ak-pop-anim`, `ak-sheet-anim`, `ak-accordion-anim`, `ak-collapsible-anim`.
|
|
21
|
+
- **Control primitives** — `ak-control-track`, `ak-control-thumb`, `ak-control-knob`; plus `ak-button-group`(+`-separator`), `ak-scrollbar`, `ak-quiet-hover`.
|
|
22
|
+
- **`astralkit/presets` export** — appearance presets, theme palettes, chart palettes, font pairings, dials, and materials as data (the role system + font library per the no-font-dials-in-builder decision).
|
|
23
|
+
- **`ak-hover-shimmer`** animation (+ `ak-hover-shimmer-sweep` keyframes).
|
|
24
|
+
- **Error-role hover tokens** — `ak-error-hover`, `ak-danger-hover`.
|
|
25
|
+
|
|
26
|
+
### Changed
|
|
27
|
+
- `font-ak-sans`/`-serif`/`-mono` (v3 plugin) are now var-driven (`var(--font-ak-sans, Inter)` …) so containers can re-font at runtime; literal stacks remain as fallbacks — no visual change for existing consumers.
|
|
28
|
+
- `ak-focus-ring` implementation refined.
|
|
29
|
+
|
|
30
|
+
## [0.6.0] — 2026-07-06
|
|
31
|
+
|
|
32
|
+
### Added
|
|
33
|
+
- **`astralkit/theme-context` export** — `AkThemeProvider` / `useAkTheme`, the React context that propagates per-component dark mode across Radix portal boundaries (Dialog/DropdownMenu/Popover content portals to `document.body`, escaping the `data-ak-dark-*` attribute scope). Installable components now import this from the SDK instead of shipping a local provider file. Adds `react >= 18` as an **optional** peer dependency — CSS-only consumers are unaffected.
|
|
34
|
+
- **Sidebar theming layer** (authored post-0.5.0, first published here): `primitives/sidebar.css`, `ak-dark-material` / `ak-mirror-shimmer` and `ak-sidebar-*` utilities, plus the gradient / selection / inverse / surface-container token extensions the themed sidebar set depends on.
|
|
35
|
+
|
|
36
|
+
## [0.5.0] — 2026-06-12
|
|
37
|
+
|
|
38
|
+
### Added (Material 3 role grammar)
|
|
39
|
+
- **45 new color-role tokens across both the v4 `@theme` and the v3 Tailwind plugin** (full v3/v4 parity). These complete the M3 role grammar that a large set of components now depend on:
|
|
40
|
+
- **Surface containers** — `surface-3`, `surface-4`, `surface-container`, `surface-container-low`/`-lowest`/`-high`/`-highest`.
|
|
41
|
+
- **Inverse** — `inverse-surface`, `inverse-on-surface` (dark cards on light themes and vice-versa).
|
|
42
|
+
- **Secondary / tertiary / accent / error roles** — `secondary`(+`-container`), `on-secondary`(+`-container`), `tertiary`(+`-container`), `on-tertiary`(+`-container`), `accent`, `accent-soft`, `on-accent`, `error`, `error-container`, `on-error`, `on-error-container`, plus `primary-container`/`on-primary-container`.
|
|
43
|
+
- **Surface / outline** — `on-surface`, `on-surface-variant`, `outline`, `outline-variant`, `scrim`.
|
|
44
|
+
- **Per-theme controls** — `slider-fill`, `slider-ring` (themed Radix slider fill/ring).
|
|
45
|
+
- **Status badges** — `status-{new,beta,stable,deprecated}-{bg,border,text}`.
|
|
46
|
+
|
|
47
|
+
### Fixed
|
|
48
|
+
- **`ak-skeleton` shimmer now respects `prefers-reduced-motion`.** Added a `@media (prefers-reduced-motion: reduce)` guard that stops the looping shimmer on `.ak-skeleton::after`.
|
|
49
|
+
|
|
50
|
+
## [0.4.0] — 2026-06-06
|
|
51
|
+
|
|
52
|
+
### Added
|
|
53
|
+
- **`astralkit/motion`** — accessible Framer Motion presets tuned to the AstralKit motion tokens (`fadeInUp`, `fadeIn`, `scaleIn`, `staggerContainer`/`staggerItem`, `revealOnScroll`, `hoverLift`/`pressable`, `akTransition`, and `withReducedMotion`). Plain variant/transition objects — importing adds **no dependency**; bring your own `motion` (MIT). All presets are `prefers-reduced-motion`-safe via `withReducedMotion`.
|
|
54
|
+
|
|
55
|
+
### Changed
|
|
56
|
+
- **Motion policy reversed: Framer Motion is now allowed.** The previous "no Framer Motion" rule was based on a licensing misunderstanding — the `motion` package is MIT. `ai-rules.md` now permits Framer Motion + CSS + Lenis and points to the `astralkit/motion` presets; **GSAP** is the disallowed one (its license restricts sold products/templates).
|
|
57
|
+
- `ai-rules.md`: motion guidance updated accordingly; premium-effect toolkit (`ak-card-glow`, `ak-mesh-*`, `ak-float`, `ak-scroll-fade`, etc.) emphasized for richer output.
|
|
58
|
+
|
|
59
|
+
## [0.3.8] — 2026-06-06
|
|
60
|
+
|
|
61
|
+
### Fixed
|
|
62
|
+
- **Body font corrected to Inter.** `--font-ak-sans` was `'DM Sans'` in `astralkit-theme.css`, `astralkit-theme-v4.css`, and the Tailwind plugin, contradicting the canonical Inter body font. Replaced with `'Inter'` everywhere.
|
|
63
|
+
- **Tailwind v3 plugin export repointed to `tailwind.cjs`.** `astralkit/tailwind` resolved to a stale `tailwind.js` that was both an incomplete token subset and broken under the package's `"type": "module"` (it used CommonJS `require()`). Removed `tailwind.js`; `astralkit/tailwind` now resolves to the complete `tailwind.cjs`. Single source of truth for v3 utilities.
|
|
64
|
+
|
|
65
|
+
### Added (v3 plugin token parity with v4)
|
|
66
|
+
- Registered every token the v4 `@theme` auto-generates but the v3 plugin was missing: colors (`surface-raised`/`-soft`, `surface-glass`/`-strong`, `highlight-soft`/`-strong`, `skeleton-base`/`-shine`, `sheet-handle`, `pink`/`pink-subtle`), avatar/badge text sizes, spacing `ak-9`/`ak-11`/`ak-14`, `rounded-ak-xs`, `duration-ak-skeleton`, and `size-ak-avatar-xs`. v3 and v4 now expose an identical utility surface.
|
|
67
|
+
|
|
68
|
+
## [0.3.3] — 2026-04-22
|
|
69
|
+
|
|
70
|
+
### Changed
|
|
71
|
+
- 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.
|
|
72
|
+
|
|
73
|
+
## [0.3.2] — 2026-04-19
|
|
74
|
+
|
|
75
|
+
### Fixed (revert of accidental change in 0.3.0 / 0.3.1)
|
|
76
|
+
- **`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.
|
|
77
|
+
- `astralkit/theme-v4` export unchanged — still the explicit opt-in for Tailwind v4 projects.
|
|
78
|
+
- 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`.
|
|
79
|
+
|
|
80
|
+
### Migrating from 0.3.0 / 0.3.1
|
|
81
|
+
- **Tailwind v3 projects**: no action — your existing `@import "astralkit/theme"` now resolves to the v3 file again, as it did in 0.2.x.
|
|
82
|
+
- **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.
|
|
83
|
+
|
|
84
|
+
## [0.3.1] — 2026-04-18 (superseded — do not use for new installs)
|
|
85
|
+
|
|
86
|
+
### Added
|
|
87
|
+
- `peerDependencies` declaration: `tailwindcss >= 3.0.0`. Installing `astralkit` in a project without Tailwind now surfaces a clear peer-dep warning instead of silent breakage.
|
|
88
|
+
- File header comment on `astralkit-theme.css` marking it as the Tailwind v3 file.
|
|
89
|
+
|
|
90
|
+
### Known issue (fixed in 0.3.2)
|
|
91
|
+
- 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`.
|
|
92
|
+
|
|
93
|
+
## [0.3.0] — 2026-04-18 (superseded — do not use for new installs)
|
|
94
|
+
|
|
95
|
+
### Added
|
|
96
|
+
- v4 theme refinements across 12 commits of token architecture work (rail/panel elevated colors, sidebar tokens, avatar sizes, Phase A standardization).
|
|
97
|
+
- `primitives/.npmignore` — excludes `*.backup` and `*.pre-v4-split` scratch files from published tarballs (~220 kB removed).
|
|
98
|
+
|
|
99
|
+
### Fixed
|
|
100
|
+
- Tailwind v3 plugin registration (via CLI init) now covers additional `plugins: [...]` formatting variants.
|
|
101
|
+
|
|
102
|
+
### Known issue (fixed in 0.3.2)
|
|
103
|
+
- Same `astralkit/theme` export mis-resolution as 0.3.1. Use `0.3.2`.
|
|
104
|
+
|
|
105
|
+
## [0.2.0] — 2026-04-02
|
|
106
|
+
|
|
107
|
+
### Added
|
|
108
|
+
- Initial public release on npm.
|
|
109
|
+
- Design tokens (theme CSS), utilities CSS, palette presets, primitives folder, `cn()` helper, Tailwind v3/v4 configs.
|