@c9up/nebula 0.1.7 → 0.1.9

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.
Files changed (2) hide show
  1. package/README.md +27 -2
  2. package/package.json +10 -3
package/README.md CHANGED
@@ -74,7 +74,7 @@ shadcn stands on Radix, `clsx`, `tailwind-merge`, `class-variance-authority`, `l
74
74
  | `@tanstack/react-table` | `organisms/DataTable.ts` — sort, filter, page, select |
75
75
  | `recharts` | `organisms/Chart.ts` — line, area and bar, as inline SVG |
76
76
  | `react-hook-form` | `form()` from `@c9up/aurora`, bound by `organisms/Form.ts` |
77
- | `tw-animate-css` | four keyframes in `theme.css` |
77
+ | `tw-animate-css` | **not replaced** — required by the `tailwind` and `unocss` adapters, see below |
78
78
 
79
79
  Several of those are narrower than what they replace — see [parity with shadcn](#parity-with-shadcn) for the full list rather than a reassuring summary.
80
80
 
@@ -124,7 +124,32 @@ physical, because that is what the caller means.
124
124
 
125
125
  ## Choose your CSS engine
126
126
 
127
- nebula declares **no CSS dependency at all**, not even a peer one. You install the engine you want; `config/nebula.ts` names it; nebula generates the matching stubs and build command. Same arrangement AdonisJS uses for its asset bundler.
127
+ nebula declares **no CSS engine dependency at all**. You install the engine you want; `config/nebula.ts` names it; nebula generates the matching stubs and build command. Same arrangement AdonisJS uses for its asset bundler.
128
+
129
+ ### The one thing you must install: `tw-animate-css`
130
+
131
+ On the `tailwind` and `unocss` adapters, add it and import it next to the tokens:
132
+
133
+ ```css
134
+ @import "tw-animate-css";
135
+ @import "@c9up/nebula/theme.css";
136
+ ```
137
+
138
+ Overlay enter and exit animations are `tw-animate-css`'s registered utilities —
139
+ `animate-in` / `animate-out` and the `fade-*` / `zoom-*` / `slide-*` modifiers —
140
+ the same ones shadcn uses. Without the import those classes are never emitted,
141
+ so overlays appear and disappear with no animation. Closing still works: a
142
+ surface that is not animating is removed at once, and one whose `animationend`
143
+ never arrives is removed on a deadline.
144
+
145
+ The `css` adapter needs nothing: `nebula.css` is compiled here and already
146
+ carries them.
147
+
148
+ Earlier versions inlined four bespoke keyframes in `theme.css` to avoid this
149
+ dependency, referenced through Tailwind ARBITRARY values. That is the one
150
+ arrangement that fails badly rather than cosmetically — Tailwind compiles an
151
+ arbitrary value unconditionally, so `animation` was set while the keyframes
152
+ behind it might exist nowhere. A registered utility is simply absent instead.
128
153
 
129
154
  ```ts
130
155
  // config/nebula.ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@c9up/nebula",
3
- "version": "0.1.7",
3
+ "version": "0.1.9",
4
4
  "description": "Nebula — shadcn/ui ported to Aurora, organised as atomic design. Zero-dependency headless primitives, cva reimplemented, copy-the-source registry.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -61,7 +61,13 @@
61
61
  }
62
62
  },
63
63
  "peerDependencies": {
64
- "@c9up/aurora": "^0.1.30"
64
+ "@c9up/aurora": "^0.1.30",
65
+ "tw-animate-css": "^1.4.0"
66
+ },
67
+ "peerDependenciesMeta": {
68
+ "tw-animate-css": {
69
+ "optional": true
70
+ }
65
71
  },
66
72
  "devDependencies": {
67
73
  "@biomejs/biome": "^2.5.12",
@@ -91,8 +97,9 @@
91
97
  "type": "git",
92
98
  "url": "git+https://github.com/C9up/nebula.git"
93
99
  },
100
+ "//engines": "Node 24, not 22, because AsyncLocalStorage sits on the request hot path — the container resolves through it, HttpContext is it, and the emitter reads it on every event. Node 24 backs it with AsyncContextFrame by default, and measured on that exact pattern (one context per request, six async boundaries, several reads) it costs 0.61 us per request instead of 1.55 us: 2.5x, on every request, for free. Before 24 the same mechanism existed only behind an experimental flag, and a framework cannot base its performance on a flag the application has to remember to pass. This is NOT 'track the current LTS' — security fixes still land in 22 until 2027, npm 11 is irrelevant under pnpm, and node:sqlite is not what atlas uses.",
94
101
  "engines": {
95
- "node": ">=22.0.0"
102
+ "node": ">=24.0.0"
96
103
  },
97
104
  "scripts": {
98
105
  "build": "tsc -p tsconfig.build.json",