@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.
- package/README.md +27 -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` |
|
|
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
|
|
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.
|
|
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": ">=
|
|
102
|
+
"node": ">=24.0.0"
|
|
96
103
|
},
|
|
97
104
|
"scripts": {
|
|
98
105
|
"build": "tsc -p tsconfig.build.json",
|