@gusnips/native 0.1.0 → 0.1.2

package/README.md

@@ -121,13 +121,16 @@ Five things worth knowing:
   of 48. `--rem` changes it if you really want another value.
 - **Tailwind finds your classes by itself** in the app's folder. Tailwind v4 has no `--content`
   flag. For a file outside the folder, add an `@source` line to `global.css`.
-- **Pin lightningcss to 1.30.1, or use a version after 1.30.2.** 1.30.2 breaks react-native-css's
-  compiler, and react-native-css's own check for it is swallowed by an empty `catch`. The build
-  refuses 1.30.2 instead. Pin it with `"overrides": { "lightningcss": "1.30.1" }` in the root
+- **Pin lightningcss to exactly 1.30.1.** react-native-css 3.0.7's compiler breaks on 1.30.2, and
+  an app measured 1.32.0 and 1.33.0 breaking it too, so no later release is known to work.
+  react-native-css's own check is swallowed by an empty `catch`, so the build refuses every
+  release after 1.30.1 instead. Pin it with `"overrides": { "lightningcss": "1.30.1" }` in the root
   `package.json`: a devDependency is not enough, because react-native-css loads the copy under
   `@expo/metro-config` first.
 - **A `className` change hot-reloads.** Only a change to `global.css` or your tokens needs the
-  build to run again.
+  build to run again. While you work on those, keep `gusnips-native-css --watch` running beside
+  Metro: it builds again when `global.css` or a file it imports changes (your token files, followed
+  through their own imports), and not when you edit a component.
 - **There is no global font.** react-native-css drops element and `*` selectors, so a text without
   a `font-*` class renders in the system font.
 
@@ -148,7 +151,8 @@ each class compiles to. The colours come from the stylesheet itself, so a change
 icons with the text. Tailwind writes only classes it finds in your files, so keep each palette
 class in your source; the build stops and names any it cannot find.
 
-From a script, the same build is `buildNativeCss({ palette })` from `@gusnips/native/css`.
+From a script, the same build is `buildNativeCss({ palette })` from `@gusnips/native/css`, and the
+watch is `watchNativeCss(options, { onBuild, onError })`.
 
 ## Streams
 
@@ -293,6 +297,20 @@ and under the default flow that URL carries the refresh token.
   resolver protects the bundle from bun's store layout; the catalog stops the versions drifting in
   the first place.
 
+## Testing an app that uses this
+
+Mock the kit's import, not `react-native` under it:
+
+```ts
+vi.mock("@gusnips/native/network", () => ({ useIsOffline: () => false }));
+vi.mock("@gusnips/native/query", () => ({ installQueryManagers: () => {} }));
+```
+
+Vitest runs a package from `node_modules` as it is, outside its own module graph, so a
+`vi.mock("react-native")` or `vi.mock("@react-native-community/netinfo")` in your test never
+reaches the imports inside `@gusnips/native`. Those load the real packages, which do not run under
+Node. Mocking the subpath your code imports replaces the whole thing, and nothing under it loads.
+
 ## Why the dependencies are peers
 
 There are no `dependencies`. Each package here is one your app already has, or one that carries

package/dist/node/bin/gusnips-native-css.js

@@ -8,7 +8,7 @@
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import { parseArgs } from "node:util";
-import { buildNativeCss } from "../css.js";
+import { buildNativeCss, watchNativeCss } from "../css.js";
 const HELP = `gusnips-native-css: compile global.css for React Native, before Metro starts.
 
 Usage: gusnips-native-css [options]
@@ -20,9 +20,11 @@ Usage: gusnips-native-css [options]
                      { "text": { "light": "text-ink", "dark": "dark:text-ink-dark" } }
                      writes colors.ts beside stylesheet.ts
   --rem <px>         pixels per rem (default: 16, as on the web)
+  --watch            build again when global.css or a file it imports changes
   -h, --help         show this
 
 Run it before Metro, in the same script: "start": "gusnips-native-css && react-native start"
+While you edit the CSS or the tokens, keep "gusnips-native-css --watch" open beside Metro.
 `;
 async function main() {
     const { values } = parseArgs({
@@ -32,6 +34,7 @@ async function main() {
             out: { type: "string" },
             palette: { type: "string" },
             rem: { type: "string" },
+            watch: { type: "boolean" },
             help: { type: "boolean", short: "h" },
         },
     });
@@ -39,17 +42,29 @@ async function main() {
         process.stdout.write(HELP);
         return 0;
     }
-    const root = resolve(values.root ?? ".");
-    const result = await buildNativeCss({
-        root,
+    const options = {
+        root: resolve(values.root ?? "."),
         input: values.input,
         outDir: values.out,
         rem: values.rem === undefined ? undefined : Number(values.rem),
         palette: values.palette === undefined ? undefined : await readPalette(resolve(values.palette)),
+    };
+    if (!values.watch) {
+        report(await buildNativeCss(options));
+        return 0;
+    }
+    // The folder watchers keep the process running until Ctrl-C. A failed build is printed and
+    // the watch goes on.
+    await watchNativeCss(options, {
+        onBuild: report,
+        onError: (error) => console.error(`native css: ${error.message}`),
     });
-    console.log(`native css: ${result.classes} classes → ${result.files.join(", ")}`);
+    console.log("native css: watching global.css and the files it imports. Ctrl-C stops.");
     return 0;
 }
+function report(result) {
+    console.log(`native css: ${result.classes} classes → ${result.files.join(", ")}`);
+}
 /** The palette file is the app's own, but a typo in it should read as one, not as a crash. */
 async function readPalette(file) {
     const parsed = JSON.parse(await readFile(file, "utf-8"));

package/dist/node/bin/gusnips-native-css.js.map

@@ -1 +1 @@
-{"version":3,"file":"gusnips-native-css.js","sourceRoot":"","sources":["../../../src/node/bin/gusnips-native-css.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gusnips-native-css.js","sourceRoot":"","sources":["../../../src/node/bin/gusnips-native-css.ts"],"names":[],"mappings":"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"}

package/dist/node/css.d.ts

@@ -41,4 +41,40 @@ export interface NativeCssResult {
  * ```
  */
 export declare function buildNativeCss(options?: NativeCssOptions): Promise<NativeCssResult>;
+/**
+ * Whether this lightningcss breaks react-native-css 3.0.7's compiler. 1.30.2 is the release
+ * react-native-css itself names, and an adopter's app then measured 1.32.0 and 1.33.0 failing the
+ * same way, so every release after 1.30.1 counts as broken until one is measured working.
+ */
+export declare function isBrokenLightningcss(version: string): boolean;
+/**
+ * The files whose change means the stylesheet must be built again: the entry, and every file of the
+ * app's it imports, followed through their own imports. That is `global.css` and the token files
+ * it pulls in. A package import (`tailwindcss/theme.css`, `nativewind/theme`) is left out, because it
+ * changes only on an install. Source files are left out on purpose too: a `className` edit
+ * hot-reloads without a rebuild, and a rebuild on every save would cost a compile per keystroke.
+ *
+ * An import is the app's own when it names a file that exists from the importing file's folder,
+ * which is how Tailwind tries it first.
+ */
+export declare function cssInputs(entry: string): Promise<string[]>;
+export interface NativeCssWatchHandlers {
+    /** A build finished. Also called for the first build. */
+    onBuild(result: NativeCssResult): void;
+    /** A build failed. Watching goes on, so fixing the file builds again. */
+    onError(error: Error): void;
+}
+/**
+ * Build, then build again whenever `global.css` or a file it imports changes. Stop it with
+ * `close()`. A first build that fails is reported and watched like any other, so saving the fix is
+ * enough.
+ *
+ * It watches each FOLDER and filters by name, not each file: an editor that saves by writing a new
+ * file and renaming it over the old one leaves a per-file watcher on the deleted file, which then
+ * never fires again. The import list is read again after every build, so a new token file starts
+ * being watched as soon as `global.css` imports it.
+ */
+export declare function watchNativeCss(options: NativeCssOptions, { onBuild, onError }: NativeCssWatchHandlers): Promise<{
+    close(): void;
+}>;
 //# sourceMappingURL=css.d.ts.map

package/dist/node/css.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/node/css.ts"],"names":[],"mappings":"AA8BA,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2C7F"}
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/node/css.ts"],"names":[],"mappings":"AA+BA,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2C7F;AAuDD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK7D;AA+ED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAehE;AAMD,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACvC,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,gBAAgB,EACzB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,sBAAsB,GAC3C,OAAO,CAAC;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC,CA0D5B"}

package/dist/node/css.js

@@ -20,10 +20,11 @@
  * from where the app installed it.
  */
 import { spawnSync } from "node:child_process";
+import { statSync, watch } from "node:fs";
 import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
 import { tmpdir } from "node:os";
-import { dirname, join, relative, resolve } from "node:path";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 /**
  * ```ts
  * await buildNativeCss(); // global.css → src/generated/stylesheet.ts
@@ -115,10 +116,23 @@ function loadCompiler(fromApp) {
     return compiler;
 }
 /**
- * lightningcss 1.30.2 breaks react-native-css's compiler. react-native-css checks for it and means
- * to throw, but the check sits inside a `try` whose `catch` is empty, so the throw is swallowed and
- * the build goes on. This asks the same copy its loader picks: the one under `@expo/metro-config`
- * first (a peer of react-native-css, so bun installs it), then its own.
+ * Whether this lightningcss breaks react-native-css 3.0.7's compiler. 1.30.2 is the release
+ * react-native-css itself names, and an adopter's app then measured 1.32.0 and 1.33.0 failing the
+ * same way, so every release after 1.30.1 counts as broken until one is measured working.
+ */
+export function isBrokenLightningcss(version) {
+    const [major = 0, minor = 0, patch = 0] = version.split(/[.+-]/, 3).map(Number);
+    if (major !== 1)
+        return major > 1;
+    if (minor !== 30)
+        return minor > 30;
+    return patch > 1;
+}
+/**
+ * react-native-css checks for a broken lightningcss and means to throw, but the check sits inside a
+ * `try` whose `catch` is empty, so the throw is swallowed and the build goes on. This asks the same
+ * copy its loader picks: the one under `@expo/metro-config` first (a peer of react-native-css, so
+ * bun installs it), then its own.
  *
  * That order is also why a devDependency on lightningcss does not fix it. Pin it with `overrides`
  * in the root `package.json`, which reaches every copy.
@@ -142,9 +156,10 @@ function refuseBrokenLightningcss(fromApp) {
         catch {
             continue;
         }
-        if (version === "1.30.2")
-            throw new Error("lightningcss 1.30.2 breaks react-native-css's compiler. Pin it to 1.30.1 with " +
-                '"overrides": { "lightningcss": "1.30.1" } in the root package.json, or move to a newer one.');
+        if (isBrokenLightningcss(version))
+            throw new Error(`lightningcss ${version} breaks react-native-css's compiler (every release after 1.30.1 ` +
+                'measured so far does). Pin it with "overrides": { "lightningcss": "1.30.1" } in the root ' +
+                "package.json, then run bun install.");
         return;
     }
 }
@@ -178,4 +193,105 @@ function missing(name) {
 function isNotFound(error) {
     return error instanceof Error && "code" in error && error.code === "MODULE_NOT_FOUND";
 }
+// ── Watching ─────────────────────────────────────────────────────────────────
+/**
+ * The files whose change means the stylesheet must be built again: the entry, and every file of the
+ * app's it imports, followed through their own imports. That is `global.css` and the token files
+ * it pulls in. A package import (`tailwindcss/theme.css`, `nativewind/theme`) is left out, because it
+ * changes only on an install. Source files are left out on purpose too: a `className` edit
+ * hot-reloads without a rebuild, and a rebuild on every save would cost a compile per keystroke.
+ *
+ * An import is the app's own when it names a file that exists from the importing file's folder,
+ * which is how Tailwind tries it first.
+ */
+export async function cssInputs(entry) {
+    const found = new Set();
+    async function visit(file) {
+        if (found.has(file))
+            return;
+        found.add(file);
+        const source = await readFile(file, "utf-8").catch(() => "");
+        const code = source.replace(/\/\*[\s\S]*?\*\//g, "");
+        for (const [, specifier] of code.matchAll(/@import\s+(?:url\(\s*)?["']([^"']+)["']/g)) {
+            if (specifier === undefined)
+                continue;
+            const target = isAbsolute(specifier) ? specifier : resolve(dirname(file), specifier);
+            if (isFile(target))
+                await visit(target);
+        }
+    }
+    await visit(resolve(entry));
+    return [...found];
+}
+function isFile(path) {
+    return statSync(path, { throwIfNoEntry: false })?.isFile() ?? false;
+}
+/**
+ * Build, then build again whenever `global.css` or a file it imports changes. Stop it with
+ * `close()`. A first build that fails is reported and watched like any other, so saving the fix is
+ * enough.
+ *
+ * It watches each FOLDER and filters by name, not each file: an editor that saves by writing a new
+ * file and renaming it over the old one leaves a per-file watcher on the deleted file, which then
+ * never fires again. The import list is read again after every build, so a new token file starts
+ * being watched as soon as `global.css` imports it.
+ */
+export async function watchNativeCss(options, { onBuild, onError }) {
+    const root = resolve(options.root ?? ".");
+    const entry = resolve(root, options.input ?? "global.css");
+    let watchers = [];
+    let watched = new Set();
+    let timer;
+    let running = null;
+    let again = false;
+    let closed = false;
+    async function rewatch() {
+        const inputs = await cssInputs(entry);
+        for (const watcher of watchers)
+            watcher.close();
+        watched = new Set(inputs);
+        watchers = [...new Set(inputs.map((file) => dirname(file)))].map((folder) => watch(folder, (_event, name) => {
+            if (name !== null && watched.has(join(folder, basename(name))))
+                schedule();
+        }));
+    }
+    // One build at a time: a save during a build marks it to run once more after, so the last save
+    // always lands and two compiles never write the same files at once.
+    async function build() {
+        if (running) {
+            again = true;
+            return running;
+        }
+        running = (async () => {
+            do {
+                again = false;
+                try {
+                    onBuild(await buildNativeCss(options));
+                }
+                catch (error) {
+                    onError(error instanceof Error ? error : new Error(String(error)));
+                }
+                if (!closed)
+                    await rewatch();
+            } while (again && !closed);
+        })().finally(() => {
+            running = null;
+        });
+        return running;
+    }
+    // Editors fire several events for one save. One build per burst.
+    function schedule() {
+        clearTimeout(timer);
+        timer = setTimeout(() => void build(), 50);
+    }
+    await build();
+    return {
+        close() {
+            closed = true;
+            clearTimeout(timer);
+            for (const watcher of watchers)
+                watcher.close();
+        },
+    };
+}
 //# sourceMappingURL=css.js.map

package/dist/node/css.js.map

@@ -1 +1 @@
-{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/node/css.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/node/css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAkB,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CnF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAO,GAAqB,EAAE;IACjE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,GAAG,GAAG,CAAC,CAAC;IAE9F,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IAC1D,gGAAgG;IAChG,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;IAC1E,cAAc,CAAC,UAAU,CAAC,CAAC;IAE3B,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,2CAA2C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,gCAAgC,CAAC;IAChH,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrD,MAAM,SAAS,CACb,cAAc,EACd,GAAG,MAAM,kFAAkF;QACzF,uDAAuD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CACzF,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,cAAc,CAAC,CAAC;IAE/B,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,CAAC,IAAwB,EAAE,EAAE,CAC1C,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI;YACJ,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;SACvC,CAAC,CACH,CAAC;QACJ,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAChE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7C,MAAM,SAAS,CACb,UAAU,EACV,GAAG,MAAM,2BAA2B,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CACzE,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;AACnF,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAoB,EAAE,IAAY,EAAE,KAAa;IAC1E,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,2FAA2F;IAC3F,gFAAgF;IAChF,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE;QACrE,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,OAAO;QACjB,wFAAwF;QACxF,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACjG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,iCAAiC,KAAK,EAAE;YACtC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,0BAA0B,IAAI,GAAG,CAC1F,CAAC;IACJ,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,OAAoB;IACvC,IAAI,YAAoB,CAAC;IACzB,IAAI,CAAC;QACH,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,QAAQ,GAA8C,OAAO,CAAC,YAAY,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,OAAO,QAAQ,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC;IAC5F,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,YAAY,4BAA4B,CAAC,CAAC;IAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,OAAoB;IACxC,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACpE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChF,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,GAAG,EAAE,CAAC;IACpC,OAAO,KAAK,GAAG,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,wBAAwB,CAAC,OAAoB;IACpD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC,CAAC;IAChF,MAAM,UAAU,GAAkB,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;IACD,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAwB,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACxE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,oBAAoB,CAAC,OAAO,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,gBAAgB,OAAO,kEAAkE;gBACvF,2FAA2F;gBAC3F,qCAAqC,CACxC,CAAC;QACJ,OAAO;IACT,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,UAAoC;IAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO;IACzC,UAAU,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAChC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,UAAoC,EAAE,SAAiB,EAAE,IAAY;IACpF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;QAC3E,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,IAAI,GAAG,KAAK,SAAS;QACnB,MAAM,IAAI,KAAK,CACb,kBAAkB,SAAS,iEAAiE;YAC1F,wCAAwC,SAAS,qBAAqB,IAAI,cAAc;YACxF,iFAAiF,CACpF,CAAC;IACJ,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,CACL,GAAG,IAAI,+EAA+E;QACtF,+EAA+E,CAChF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,CAAC;AACxF,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAa;IAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,UAAU,KAAK,CAAC,IAAY;QAC/B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAC5B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,0CAA0C,CAAC,EAAE,CAAC;YACtF,IAAI,SAAS,KAAK,SAAS;gBAAE,SAAS;YACtC,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;YACrF,IAAI,MAAM,CAAC,MAAM,CAAC;gBAAE,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,KAAK,CAAC;AACtE,CAAC;AASD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAyB,EACzB,EAAE,OAAO,EAAE,OAAO,EAA0B;IAE5C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;IAC3D,IAAI,QAAQ,GAAgB,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,KAAgD,CAAC;IACrD,IAAI,OAAO,GAAyB,IAAI,CAAC;IACzC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,KAAK,UAAU,OAAO;QACpB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAChD,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAC1E,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;YAC7B,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;gBAAE,QAAQ,EAAE,CAAC;QAC7E,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,+FAA+F;IAC/F,oEAAoE;IACpE,KAAK,UAAU,KAAK;QAClB,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YACpB,GAAG,CAAC;gBACF,KAAK,GAAG,KAAK,CAAC;gBACd,IAAI,CAAC;oBACH,OAAO,CAAC,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;gBACzC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACrE,CAAC;gBACD,IAAI,CAAC,MAAM;oBAAE,MAAM,OAAO,EAAE,CAAC;YAC/B,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,EAAE;QAC7B,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iEAAiE;IACjE,SAAS,QAAQ;QACf,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,KAAK,EAAE,CAAC;IACd,OAAO;QACL,KAAK;YACH,MAAM,GAAG,IAAI,CAAC;YACd,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusnips/native",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "What a bare React Native app needs beside @gusnips/react: streams over XHR, React Query on app focus and network, theme and language that remember the choice, the Supabase session storage, the Metro config for a bun monorepo, and the Tailwind to react-native-css build.",
   "type": "module",
   "license": "MIT",

package/src/node/bin/gusnips-native-css.ts

@@ -8,7 +8,7 @@
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import { parseArgs } from "node:util";
-import { buildNativeCss, type PaletteEntry } from "../css.ts";
+import { buildNativeCss, watchNativeCss, type NativeCssResult, type PaletteEntry } from "../css.ts";
 
 const HELP = `gusnips-native-css: compile global.css for React Native, before Metro starts.
 
@@ -21,9 +21,11 @@ Usage: gusnips-native-css [options]
                      { "text": { "light": "text-ink", "dark": "dark:text-ink-dark" } }
                      writes colors.ts beside stylesheet.ts
   --rem <px>         pixels per rem (default: 16, as on the web)
+  --watch            build again when global.css or a file it imports changes
   -h, --help         show this
 
 Run it before Metro, in the same script: "start": "gusnips-native-css && react-native start"
+While you edit the CSS or the tokens, keep "gusnips-native-css --watch" open beside Metro.
 `;
 
 async function main(): Promise<number> {
@@ -34,6 +36,7 @@ async function main(): Promise<number> {
       out: { type: "string" },
       palette: { type: "string" },
       rem: { type: "string" },
+      watch: { type: "boolean" },
       help: { type: "boolean", short: "h" },
     },
   });
@@ -42,18 +45,31 @@ async function main(): Promise<number> {
     return 0;
   }
 
-  const root = resolve(values.root ?? ".");
-  const result = await buildNativeCss({
-    root,
+  const options = {
+    root: resolve(values.root ?? "."),
     input: values.input,
     outDir: values.out,
     rem: values.rem === undefined ? undefined : Number(values.rem),
     palette: values.palette === undefined ? undefined : await readPalette(resolve(values.palette)),
+  };
+  if (!values.watch) {
+    report(await buildNativeCss(options));
+    return 0;
+  }
+  // The folder watchers keep the process running until Ctrl-C. A failed build is printed and
+  // the watch goes on.
+  await watchNativeCss(options, {
+    onBuild: report,
+    onError: (error) => console.error(`native css: ${error.message}`),
   });
-  console.log(`native css: ${result.classes} classes → ${result.files.join(", ")}`);
+  console.log("native css: watching global.css and the files it imports. Ctrl-C stops.");
   return 0;
 }
 
+function report(result: NativeCssResult): void {
+  console.log(`native css: ${result.classes} classes → ${result.files.join(", ")}`);
+}
+
 /** The palette file is the app's own, but a typo in it should read as one, not as a crash. */
 async function readPalette(file: string): Promise<Record<string, PaletteEntry>> {
   const parsed: unknown = JSON.parse(await readFile(file, "utf-8"));

package/src/node/css.test.ts

@@ -0,0 +1,61 @@
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { cssInputs, isBrokenLightningcss } from "./css.ts";
+
+describe("isBrokenLightningcss", () => {
+  it("lets 1.30.1 and earlier through", () => {
+    for (const version of ["1.30.1", "1.30.0", "1.29.3", "1.0.0", "0.9.9"])
+      expect(isBrokenLightningcss(version), version).toBe(false);
+  });
+
+  it("refuses every release after 1.30.1, the measured ones included", () => {
+    for (const version of ["1.30.2", "1.30.10", "1.31.0", "1.32.0", "1.33.0", "2.0.0"])
+      expect(isBrokenLightningcss(version), version).toBe(true);
+  });
+
+  it("reads a prerelease or build suffix by its numbers", () => {
+    expect(isBrokenLightningcss("1.30.1-beta.2")).toBe(false);
+    expect(isBrokenLightningcss("1.30.2+build.7")).toBe(true);
+  });
+});
+
+const made: string[] = [];
+afterEach(async () => {
+  for (const dir of made.splice(0)) await rm(dir, { recursive: true, force: true });
+});
+
+describe("cssInputs: what makes --watch build again", () => {
+  it("is the entry and every local file it imports, followed through their own imports", async () => {
+    const app = await mkdtemp(join(tmpdir(), "native-css-inputs-"));
+    made.push(app);
+    const shared = join(app, "packages", "shared");
+    await mkdir(shared, { recursive: true });
+    await mkdir(join(app, "mobile"), { recursive: true });
+    await writeFile(
+      join(app, "mobile", "global.css"),
+      [
+        '@import "tailwindcss/theme.css" layer(theme);', // a package: changes only on install
+        '@import "nativewind/theme";',
+        '@import "../packages/shared/tokens.css";',
+        '/* @import "./commented-out.css"; */',
+        '@import url("./fonts.css");',
+        '@import "./missing.css";', // a typo is Tailwind's error to report, not a file to watch
+      ].join("\n"),
+    );
+    await writeFile(join(app, "mobile", "fonts.css"), ":root { --font-sans: Inter; }");
+    await writeFile(join(app, "mobile", "commented-out.css"), "");
+    await writeFile(join(shared, "tokens.css"), '@import "./colors.css";\n@theme {}');
+    await writeFile(join(shared, "colors.css"), '@import "./tokens.css";'); // a cycle ends
+
+    expect((await cssInputs(join(app, "mobile", "global.css"))).sort()).toEqual(
+      [
+        join(app, "mobile", "fonts.css"),
+        join(app, "mobile", "global.css"),
+        join(shared, "colors.css"),
+        join(shared, "tokens.css"),
+      ].sort(),
+    );
+  });
+});

package/src/node/css.ts

@@ -20,10 +20,11 @@
  * from where the app installed it.
  */
 import { spawnSync } from "node:child_process";
+import { statSync, watch, type FSWatcher } from "node:fs";
 import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
 import { tmpdir } from "node:os";
-import { dirname, join, relative, resolve } from "node:path";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import type { ReactNativeCssStyleSheet } from "react-native-css/compiler";
 
 type Compiler = typeof import("react-native-css/compiler");
@@ -172,10 +173,22 @@ function loadCompiler(fromApp: NodeRequire): Compiler {
 }
 
 /**
- * lightningcss 1.30.2 breaks react-native-css's compiler. react-native-css checks for it and means
- * to throw, but the check sits inside a `try` whose `catch` is empty, so the throw is swallowed and
- * the build goes on. This asks the same copy its loader picks: the one under `@expo/metro-config`
- * first (a peer of react-native-css, so bun installs it), then its own.
+ * Whether this lightningcss breaks react-native-css 3.0.7's compiler. 1.30.2 is the release
+ * react-native-css itself names, and an adopter's app then measured 1.32.0 and 1.33.0 failing the
+ * same way, so every release after 1.30.1 counts as broken until one is measured working.
+ */
+export function isBrokenLightningcss(version: string): boolean {
+  const [major = 0, minor = 0, patch = 0] = version.split(/[.+-]/, 3).map(Number);
+  if (major !== 1) return major > 1;
+  if (minor !== 30) return minor > 30;
+  return patch > 1;
+}
+
+/**
+ * react-native-css checks for a broken lightningcss and means to throw, but the check sits inside a
+ * `try` whose `catch` is empty, so the throw is swallowed and the build goes on. This asks the same
+ * copy its loader picks: the one under `@expo/metro-config` first (a peer of react-native-css, so
+ * bun installs it), then its own.
  *
  * That order is also why a devDependency on lightningcss does not fix it. Pin it with `overrides`
  * in the root `package.json`, which reaches every copy.
@@ -197,10 +210,11 @@ function refuseBrokenLightningcss(fromApp: NodeRequire): void {
     } catch {
       continue;
     }
-    if (version === "1.30.2")
+    if (isBrokenLightningcss(version))
       throw new Error(
-        "lightningcss 1.30.2 breaks react-native-css's compiler. Pin it to 1.30.1 with " +
-          '"overrides": { "lightningcss": "1.30.1" } in the root package.json, or move to a newer one.',
+        `lightningcss ${version} breaks react-native-css's compiler (every release after 1.30.1 ` +
+          'measured so far does). Pin it with "overrides": { "lightningcss": "1.30.1" } in the root ' +
+          "package.json, then run bun install.",
       );
     return;
   }
@@ -244,3 +258,116 @@ function missing(name: string): string {
 function isNotFound(error: unknown): boolean {
   return error instanceof Error && "code" in error && error.code === "MODULE_NOT_FOUND";
 }
+
+// ── Watching ─────────────────────────────────────────────────────────────────
+
+/**
+ * The files whose change means the stylesheet must be built again: the entry, and every file of the
+ * app's it imports, followed through their own imports. That is `global.css` and the token files
+ * it pulls in. A package import (`tailwindcss/theme.css`, `nativewind/theme`) is left out, because it
+ * changes only on an install. Source files are left out on purpose too: a `className` edit
+ * hot-reloads without a rebuild, and a rebuild on every save would cost a compile per keystroke.
+ *
+ * An import is the app's own when it names a file that exists from the importing file's folder,
+ * which is how Tailwind tries it first.
+ */
+export async function cssInputs(entry: string): Promise<string[]> {
+  const found = new Set<string>();
+  async function visit(file: string): Promise<void> {
+    if (found.has(file)) return;
+    found.add(file);
+    const source = await readFile(file, "utf-8").catch(() => "");
+    const code = source.replace(/\/\*[\s\S]*?\*\//g, "");
+    for (const [, specifier] of code.matchAll(/@import\s+(?:url\(\s*)?["']([^"']+)["']/g)) {
+      if (specifier === undefined) continue;
+      const target = isAbsolute(specifier) ? specifier : resolve(dirname(file), specifier);
+      if (isFile(target)) await visit(target);
+    }
+  }
+  await visit(resolve(entry));
+  return [...found];
+}
+
+function isFile(path: string): boolean {
+  return statSync(path, { throwIfNoEntry: false })?.isFile() ?? false;
+}
+
+export interface NativeCssWatchHandlers {
+  /** A build finished. Also called for the first build. */
+  onBuild(result: NativeCssResult): void;
+  /** A build failed. Watching goes on, so fixing the file builds again. */
+  onError(error: Error): void;
+}
+
+/**
+ * Build, then build again whenever `global.css` or a file it imports changes. Stop it with
+ * `close()`. A first build that fails is reported and watched like any other, so saving the fix is
+ * enough.
+ *
+ * It watches each FOLDER and filters by name, not each file: an editor that saves by writing a new
+ * file and renaming it over the old one leaves a per-file watcher on the deleted file, which then
+ * never fires again. The import list is read again after every build, so a new token file starts
+ * being watched as soon as `global.css` imports it.
+ */
+export async function watchNativeCss(
+  options: NativeCssOptions,
+  { onBuild, onError }: NativeCssWatchHandlers,
+): Promise<{ close(): void }> {
+  const root = resolve(options.root ?? ".");
+  const entry = resolve(root, options.input ?? "global.css");
+  let watchers: FSWatcher[] = [];
+  let watched = new Set<string>();
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  let running: Promise<void> | null = null;
+  let again = false;
+  let closed = false;
+
+  async function rewatch(): Promise<void> {
+    const inputs = await cssInputs(entry);
+    for (const watcher of watchers) watcher.close();
+    watched = new Set(inputs);
+    watchers = [...new Set(inputs.map((file) => dirname(file)))].map((folder) =>
+      watch(folder, (_event, name) => {
+        if (name !== null && watched.has(join(folder, basename(name)))) schedule();
+      }),
+    );
+  }
+
+  // One build at a time: a save during a build marks it to run once more after, so the last save
+  // always lands and two compiles never write the same files at once.
+  async function build(): Promise<void> {
+    if (running) {
+      again = true;
+      return running;
+    }
+    running = (async () => {
+      do {
+        again = false;
+        try {
+          onBuild(await buildNativeCss(options));
+        } catch (error) {
+          onError(error instanceof Error ? error : new Error(String(error)));
+        }
+        if (!closed) await rewatch();
+      } while (again && !closed);
+    })().finally(() => {
+      running = null;
+    });
+    return running;
+  }
+
+  // Editors fire several events for one save. One build per burst.
+  function schedule(): void {
+    clearTimeout(timer);
+    timer = setTimeout(() => void build(), 50);
+  }
+
+  await build();
+  return {
+    close() {
+      closed = true;
+      clearTimeout(timer);
+      for (const watcher of watchers) watcher.close();
+    },
+  };
+}