@gusnips/native 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * gusnips-native-css: `buildNativeCss` from the command line, for an app's `start` script.
+ *
+ * Scoped like every bin in this repo: a bare name belongs to whoever registers it on npm, and
+ * `bunx` would download and run theirs.
+ */
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { buildNativeCss } from "../css.js";
+const HELP = `gusnips-native-css: compile global.css for React Native, before Metro starts.
+
+Usage: gusnips-native-css [options]
+
+  --root <dir>       the app's folder (default: the current folder)
+  --input <file>     the Tailwind entry, from the app's folder (default: global.css)
+  --out <dir>        where stylesheet.ts goes (default: src/generated)
+  --palette <file>   a JSON file naming colours for code that cannot take a className:
+                     { "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)
+  -h, --help         show this
+
+Run it before Metro, in the same script: "start": "gusnips-native-css && react-native start"
+`;
+async function main() {
+    const { values } = parseArgs({
+        options: {
+            root: { type: "string" },
+            input: { type: "string" },
+            out: { type: "string" },
+            palette: { type: "string" },
+            rem: { type: "string" },
+            help: { type: "boolean", short: "h" },
+        },
+    });
+    if (values.help) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    const root = resolve(values.root ?? ".");
+    const result = await buildNativeCss({
+        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)),
+    });
+    console.log(`native css: ${result.classes} classes → ${result.files.join(", ")}`);
+    return 0;
+}
+/** 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"));
+    const palette = {};
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+        throw new Error(`${file} must hold an object of colour names.`);
+    for (const [name, entry] of Object.entries(parsed)) {
+        const light = entry?.light;
+        const dark = entry?.dark;
+        if (typeof light !== "string" || typeof dark !== "string")
+            throw new Error(`${file}: "${name}" needs a "light" and a "dark" class, such as ` +
+                '{ "light": "text-ink", "dark": "dark:text-ink-dark" }.');
+        palette[name] = { light, dark };
+    }
+    return palette;
+}
+main().then((code) => {
+    process.exitCode = code;
+}, (error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=gusnips-native-css.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gusnips-native-css.js","sourceRoot":"","sources":["../../../src/node/bin/gusnips-native-css.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAqB,MAAM,WAAW,CAAC;AAE9D,MAAM,IAAI,GAAG;;;;;;;;;;;;;;CAcZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;SACtC;KACF,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;QAClC,IAAI;QACJ,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,GAAG;QAClB,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;QAC9D,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;KAC/F,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,OAAO,cAAc,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,8FAA8F;AAC9F,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAClE,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,uCAAuC,CAAC,CAAC;IAClE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAY,KAAK,EAAE,KAAK,CAAC;QACpC,MAAM,IAAI,GAAY,KAAK,EAAE,IAAI,CAAC;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ;YACvD,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,MAAM,IAAI,gDAAgD;gBAC/D,wDAAwD,CAC3D,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CACT,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CACF,CAAC"}

package/dist/node/css.d.ts

@@ -0,0 +1,50 @@
+/** A colour code needs where it cannot take a `className`: one utility class per scheme. */
+export interface PaletteEntry {
+    /** A class that paints this colour in light mode, such as `"bg-surface"`. */
+    light: string;
+    /** The same in dark mode, such as `"dark:bg-dark-surface"`. */
+    dark: string;
+}
+export interface NativeCssOptions {
+    /** The app's folder. The other paths are read from it. Default: the current folder. */
+    root?: string;
+    /** The Tailwind entry. Default: `global.css`. */
+    input?: string;
+    /** Where `stylesheet.ts` (and `colors.ts`) are written. Default: `src/generated`. */
+    outDir?: string;
+    /**
+     * How many pixels one `rem` is. Default: 16, the web's.
+     *
+     * react-native-css's own default is 14, React Native's root font size, and that silently shrinks
+     * every rem-based size by an eighth: body text from 14 to 12.25 px and `h-12` from 48 to 42 px,
+     * against tokens written for the web. A `:root { font-size }` in the CSS does not fix it
+     * reliably, so the number is passed to the compiler instead.
+     */
+    rem?: number;
+    /**
+     * Hex colours for what cannot take a `className`: an icon's `color`, the navigation theme, the
+     * status bar. Each name maps to a class in each scheme, and `colors.ts` gets the hex those classes
+     * compile to. Read from the stylesheet itself, so a change of tokens cannot restyle the classes
+     * and leave the icons in the old colours, which is what a hand-copied list of hex values did.
+     */
+    palette?: Record<string, PaletteEntry>;
+}
+export interface NativeCssResult {
+    /** How many classes the stylesheet holds. */
+    classes: number;
+    /** The files written, as absolute paths. */
+    files: string[];
+}
+/**
+ * ```ts
+ * await buildNativeCss(); // global.css → src/generated/stylesheet.ts
+ * ```
+ */
+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;
+//# sourceMappingURL=css.d.ts.map

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

@@ -0,0 +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;AAuDD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK7D"}

package/dist/node/css.js

@@ -0,0 +1,195 @@
+/**
+ * Tailwind classes for a bare React Native app, built before Metro starts.
+ *
+ * NativeWind v5 and react-native-css resolve `className` at runtime against a compiled stylesheet.
+ * Their own way of compiling it is a Metro transformer that hands the CSS step to
+ * `@expo/metro-config`'s worker, which needs the `expo` package and its native modules. A bare app
+ * has neither, so this runs the same two Expo-free stages itself:
+ *
+ *   1. the Tailwind v4 CLI compiles the app's `global.css` to plain CSS, finding the classes in the
+ *      app's own files (Tailwind v4 has no `--content` flag; a file outside the app folder needs an
+ *      `@source` line in `global.css`);
+ *   2. react-native-css's compiler turns that CSS into the stylesheet its runtime reads.
+ *
+ * The output is a TypeScript module the app injects at launch with `StyleCollection.inject`.
+ * Editing a `className` hot-reloads as usual; only a change to the CSS or the tokens needs a rebuild,
+ * which is why the build runs in the `start`, `ios` and `android` scripts, before Metro.
+ *
+ * Both tools are resolved from the APP's folder, not from this package: the stylesheet has to be in
+ * the format of the react-native-css the bundle will run, and `global.css` imports `tailwindcss`
+ * from where the app installed it.
+ */
+import { spawnSync } from "node:child_process";
+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";
+/**
+ * ```ts
+ * await buildNativeCss(); // global.css → src/generated/stylesheet.ts
+ * ```
+ */
+export async function buildNativeCss(options = {}) {
+    const root = resolve(options.root ?? ".");
+    const input = resolve(root, options.input ?? "global.css");
+    const outDir = resolve(root, options.outDir ?? "src/generated");
+    const rem = options.rem ?? 16;
+    if (!(rem > 0))
+        throw new Error(`buildNativeCss: rem must be a positive number, not ${rem}.`);
+    const fromApp = createRequire(join(root, "package.json"));
+    // Before Tailwind, so a missing react-native-css fails in a moment rather than after a compile.
+    const compiler = loadCompiler(fromApp);
+    const css = await runTailwind(fromApp, root, input);
+    const stylesheet = compiler.compile(css, { inlineRem: rem }).stylesheet();
+    dropUnmappable(stylesheet);
+    await mkdir(outDir, { recursive: true });
+    const banner = `// Generated by gusnips-native-css from ${relative(root, input)}. Do not edit: run it again.\n`;
+    const stylesheetFile = join(outDir, "stylesheet.ts");
+    await writeFile(stylesheetFile, `${banner}\nimport type { ReactNativeCssStyleSheet } from "react-native-css/compiler";\n\n` +
+        `export const stylesheet: ReactNativeCssStyleSheet = ${JSON.stringify(stylesheet)};\n`);
+    const files = [stylesheetFile];
+    const { palette } = options;
+    if (palette) {
+        const scheme = (mode) => Object.fromEntries(Object.entries(palette).map(([name, entry]) => [
+            name,
+            colorOf(stylesheet, entry[mode], root),
+        ]));
+        const colors = { light: scheme("light"), dark: scheme("dark") };
+        const colorsFile = join(outDir, "colors.ts");
+        await writeFile(colorsFile, `${banner}\nexport const COLORS = ${JSON.stringify(colors, null, 2)};\n`);
+        files.push(colorsFile);
+    }
+    return { classes: Array.isArray(stylesheet.s) ? stylesheet.s.length : 0, files };
+}
+async function runTailwind(fromApp, root, input) {
+    const cli = tailwindCli(fromApp);
+    // Out of the app's tree, so building reads the app and writes only `outDir`. Kept when the
+    // compile fails, because the half-written CSS is the first thing worth reading.
+    const work = await mkdtemp(join(tmpdir(), "gusnips-native-css-"));
+    const out = join(work, "tailwind.css");
+    const run = spawnSync(process.execPath, [cli, "-i", input, "-o", out], {
+        cwd: root,
+        encoding: "utf-8",
+        // The compile takes seconds. A hung CLI with no deadline holds `bun run start` forever.
+        timeout: 120_000,
+    });
+    if (run.error !== undefined)
+        throw new Error(`tailwindcss did not finish: ${run.error.message}`);
+    if (run.status !== 0)
+        throw new Error(`tailwindcss could not compile ${input}` +
+            `${run.stderr ? `:\n${run.stderr.slice(0, 1000)}` : ""}\n(work folder kept at ${work})`);
+    const css = await readFile(out, "utf-8");
+    await rm(work, { recursive: true, force: true });
+    return css;
+}
+function tailwindCli(fromApp) {
+    let manifestPath;
+    try {
+        manifestPath = fromApp.resolve("@tailwindcss/cli/package.json");
+    }
+    catch {
+        throw new Error(missing("@tailwindcss/cli"));
+    }
+    const manifest = fromApp(manifestPath);
+    const bin = typeof manifest.bin === "string" ? manifest.bin : manifest.bin?.["tailwindcss"];
+    if (!bin)
+        throw new Error(`@tailwindcss/cli at ${manifestPath} names no tailwindcss bin.`);
+    return join(dirname(manifestPath), bin);
+}
+/**
+ * The CommonJS build, on purpose: react-native-css's ES module build imports `debug` by a named
+ * export Node cannot see in a CommonJS package, so it does not load under plain Node (bun forgives
+ * it). `require` loads the build that works under both.
+ */
+function loadCompiler(fromApp) {
+    let compiler;
+    try {
+        compiler = fromApp("react-native-css/compiler");
+    }
+    catch (error) {
+        if (isNotFound(error))
+            throw new Error(missing("react-native-css"));
+        throw error;
+    }
+    refuseBrokenLightningcss(fromApp);
+    return compiler;
+}
+/**
+ * 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.
+ */
+function refuseBrokenLightningcss(fromApp) {
+    const fromCss = createRequire(fromApp.resolve("react-native-css/package.json"));
+    const candidates = [];
+    try {
+        candidates.push(createRequire(fromCss.resolve("@expo/metro-config/package.json")));
+    }
+    catch {
+        // No expo config beside it: react-native-css loads its own lightningcss.
+    }
+    candidates.push(fromCss);
+    for (const from of candidates) {
+        let version;
+        try {
+            const manifest = from("lightningcss/package.json");
+            version = manifest.version;
+        }
+        catch {
+            continue;
+        }
+        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;
+    }
+}
+/**
+ * Tailwind finds class names by reading source as text, so a React Native style key such as
+ * `transform` (an Animated style needs one) becomes a candidate. `transform` IS a Tailwind utility,
+ * so it compiles, but its value cannot map to React Native and comes out `null`, which then fails
+ * the app's typecheck on the generated file. Nobody can use it as a class on a phone, so it is
+ * dropped here rather than banning a JavaScript word from every source file.
+ */
+function dropUnmappable(stylesheet) {
+    if (!Array.isArray(stylesheet.s))
+        return;
+    stylesheet.s = stylesheet.s.filter((entry) => !(Array.isArray(entry) && entry[0] === "transform"));
+}
+function colorOf(stylesheet, className, root) {
+    const entry = Array.isArray(stylesheet.s)
+        ? stylesheet.s.find((each) => Array.isArray(each) && each[0] === className)
+        : undefined;
+    const hex = entry ? JSON.stringify(entry[1]).match(/#[0-9a-fA-F]{3,8}\b/)?.[0] : undefined;
+    if (hex === undefined)
+        throw new Error(`No colour for "${className}" in the compiled stylesheet. Tailwind writes only the classes ` +
+            `it finds in the app's files, so put "${className}" in a file under ${root} (a list of ` +
+            "the palette's classes beside the code that reads the colours keeps them found).");
+    return hex;
+}
+function missing(name) {
+    return (`${name} is not installed in the app. gusnips-native-css reads it from the app's own ` +
+        "packages: bun add react-native-css && bun add -d @tailwindcss/cli tailwindcss");
+}
+function isNotFound(error) {
+    return error instanceof Error && "code" in error && error.code === "MODULE_NOT_FOUND";
+}
+//# sourceMappingURL=css.js.map

package/dist/node/css.js.map

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

package/dist/node/metro.d.ts

@@ -0,0 +1,51 @@
+/** What a resolver hands back to Metro. Only the `sourceFile` form is built here. */
+export type Resolution = {
+    type: "sourceFile";
+    filePath: string;
+} | {
+    type: string;
+};
+/** Metro's `CustomResolver`, narrowed to the part this file reads. */
+export type ResolveRequest = (context: ResolutionContext, moduleName: string, platform: string | null) => Resolution;
+export interface ResolutionContext {
+    /** Metro's default resolver, for everything this one does not decide. */
+    readonly resolveRequest: ResolveRequest;
+}
+export interface MetroConfigInput {
+    readonly projectRoot?: string;
+    readonly watchFolders?: readonly string[];
+    readonly resolver?: {
+        readonly nodeModulesPaths?: readonly string[];
+        readonly resolveRequest?: ResolveRequest | null;
+    };
+}
+export interface NativeMetroOptions {
+    /**
+     * The monorepo's root folder, where the root `package.json` and `node_modules` are. Leave it out
+     * for an app that is not in a monorepo.
+     */
+    monorepoRoot?: string;
+}
+/**
+ * Wrap the config `@react-native/metro-config` gives you.
+ *
+ * ```js
+ * // metro.config.js
+ * const { getDefaultConfig } = require("@react-native/metro-config");
+ * const { nativeMetroConfig } = require("@gusnips/native/metro");
+ *
+ * module.exports = nativeMetroConfig(getDefaultConfig(__dirname), {
+ *   monorepoRoot: require("node:path").resolve(__dirname, "../.."),
+ * });
+ * ```
+ *
+ * A resolver already on the config still runs for everything this one does not decide.
+ */
+export declare function nativeMetroConfig<C extends MetroConfigInput>(config: C, { monorepoRoot }?: NativeMetroOptions): C & {
+    watchFolders: string[];
+    resolver: {
+        nodeModulesPaths: string[];
+        resolveRequest: ResolveRequest;
+    };
+};
+//# sourceMappingURL=metro.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metro.d.ts","sourceRoot":"","sources":["../../src/node/metro.ts"],"names":[],"mappings":"AA4BA,qFAAqF;AACrF,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,KACpB,UAAU,CAAC;AAEhB,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;KACjD,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,EAC1D,MAAM,EAAE,CAAC,EACT,EAAE,YAAY,EAAE,GAAE,kBAAuB;;;;;;EAiC1C"}

package/dist/node/metro.js

@@ -0,0 +1,100 @@
+/**
+ * The Metro config a bare React Native app needs inside a bun monorepo.
+ *
+ * Three things, each learned by a crash:
+ *
+ * - **Metro does not find workspaces on its own.** `watchFolders` and `nodeModulesPaths` point it at
+ *   the monorepo, so a workspace package that ships TypeScript source resolves like any other.
+ *   (Symlinks and package `exports` are on by default since Metro 0.79 and 0.82.)
+ * - **One React, the app's.** bun's isolated store keeps a spare `react` at its root, and a package
+ *   that forgets to declare react as a peer resolves `react` by walking up to THAT copy. Two Reacts
+ *   in one bundle: the app's own screens render, and that package's hooks crash with "Cannot read
+ *   property 'useMemo' of null". So every `react` and `react/*` import goes to the copy the app
+ *   itself resolves.
+ * - **react-native-css's override module.** `react-native-css/native` re-exports a module named
+ *   `react-native-css-metro-override` that throws on import unless Metro maps it to the package's
+ *   own empty `override.js`. Without the mapping every styled component dies at launch with "Cannot
+ *   read property 'useCssElement' of undefined". `withReactNativeCSS` does map it, and also swaps
+ *   Metro's transformer for one that requires `@expo/metro-config`, which a bare app does not have.
+ *   Only the mapping is taken here; the CSS itself is built ahead of time by `gusnips-native-css`.
+ *   Skipped when the app does not use react-native-css.
+ *
+ * Metro's own types are not imported: this package does not depend on metro, and the few fields read
+ * here are stated below.
+ */
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+/**
+ * Wrap the config `@react-native/metro-config` gives you.
+ *
+ * ```js
+ * // metro.config.js
+ * const { getDefaultConfig } = require("@react-native/metro-config");
+ * const { nativeMetroConfig } = require("@gusnips/native/metro");
+ *
+ * module.exports = nativeMetroConfig(getDefaultConfig(__dirname), {
+ *   monorepoRoot: require("node:path").resolve(__dirname, "../.."),
+ * });
+ * ```
+ *
+ * A resolver already on the config still runs for everything this one does not decide.
+ */
+export function nativeMetroConfig(config, { monorepoRoot } = {}) {
+    const { projectRoot } = config;
+    if (!projectRoot)
+        throw new Error("nativeMetroConfig: the config has no projectRoot. Pass it the config " +
+            "getDefaultConfig(__dirname) returns, which always sets one.");
+    const fromApp = createRequire(join(projectRoot, "package.json"));
+    const cssOverride = reactNativeCssOverride(fromApp);
+    const next = config.resolver?.resolveRequest ?? null;
+    const resolveRequest = (context, moduleName, platform) => {
+        if (cssOverride && moduleName.includes("react-native-css-metro-override"))
+            return { type: "sourceFile", filePath: cssOverride };
+        if (isReact(moduleName))
+            return { type: "sourceFile", filePath: fromApp.resolve(moduleName) };
+        return (next ?? context.resolveRequest)(context, moduleName, platform);
+    };
+    const extraRoots = monorepoRoot ? [monorepoRoot] : [];
+    return {
+        ...config,
+        watchFolders: unique([...(config.watchFolders ?? []), ...extraRoots]),
+        resolver: {
+            ...config.resolver,
+            nodeModulesPaths: unique([
+                ...[projectRoot, ...extraRoots].map((root) => join(root, "node_modules")),
+                ...(config.resolver?.nodeModulesPaths ?? []),
+            ]),
+            resolveRequest,
+        },
+    };
+}
+/**
+ * `react` and its own entry points, and nothing that merely starts with the word: `react-native`,
+ * `react-dom` and `react-i18next` are packages of their own and resolve the normal way.
+ *
+ * ponytail: only react is forced to one copy, because only react has been seen twice. If another
+ * package turns up twice in a bundle (react-native itself is the likely next), add it here.
+ */
+function isReact(moduleName) {
+    return moduleName === "react" || moduleName.startsWith("react/");
+}
+/** The app's react-native-css `override.js`, or null when the app has no react-native-css. */
+function reactNativeCssOverride(fromApp) {
+    let metroEntry;
+    try {
+        metroEntry = fromApp.resolve("react-native-css/metro");
+    }
+    catch {
+        return null;
+    }
+    const override = join(dirname(metroEntry), "override.js");
+    if (!existsSync(override))
+        throw new Error(`nativeMetroConfig: react-native-css is installed, but ${override} is not there. This ` +
+            "version keeps its override module somewhere else; @gusnips/native needs updating for it.");
+    return override;
+}
+function unique(paths) {
+    return [...new Set(paths)];
+}
+//# sourceMappingURL=metro.js.map

package/dist/node/metro.js.map

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

package/dist/query.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Call once, before the first query runs, beside where you build the `QueryClient`.
+ *
+ * ```ts
+ * installQueryManagers();
+ * export const queryClient = new QueryClient({ defaultOptions: queryDefaults() });
+ * ```
+ *
+ * The managers are React Query's own singletons, so a second call replaces the first rather than
+ * adding a second listener.
+ */
+export declare function installQueryManagers(): void;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAY3C"}

package/dist/query.js

@@ -0,0 +1,37 @@
+/**
+ * React Query on a phone: "focused" means the app is in the foreground, and "online" means NetInfo
+ * says so. React Query's own defaults read the browser's window and `navigator.onLine`, and a
+ * phone has neither.
+ *
+ * What this changes, so nobody expects more of it: a query's retries wait while the app is in the
+ * background or the phone is offline, and resume after; stale queries run again when the connection
+ * comes back (`refetchOnReconnect`, which `queryDefaults` turns on). It does NOT refetch when the app
+ * returns to the foreground, because `queryDefaults` leaves `refetchOnWindowFocus` off on purpose.
+ * The donor's comment said "refetch on app foreground" over a client where that option was off, so
+ * a screen still mounted from yesterday shows yesterday's data until something else refetches it.
+ * Pass `queryDefaults({ refetchOnWindowFocus: true })` if returning to the app should refresh.
+ */
+import NetInfo from "@react-native-community/netinfo";
+import { focusManager, onlineManager } from "@tanstack/react-query";
+import { AppState } from "react-native";
+/**
+ * Call once, before the first query runs, beside where you build the `QueryClient`.
+ *
+ * ```ts
+ * installQueryManagers();
+ * export const queryClient = new QueryClient({ defaultOptions: queryDefaults() });
+ * ```
+ *
+ * The managers are React Query's own singletons, so a second call replaces the first rather than
+ * adding a second listener.
+ */
+export function installQueryManagers() {
+    focusManager.setEventListener((setFocused) => {
+        const subscription = AppState.addEventListener("change", (state) => setFocused(state === "active"));
+        return () => subscription.remove();
+    });
+    // `!== false`, not `=== true`: NetInfo says `null` until it knows, and paused queries at every
+    // launch would be the price of reading that as offline.
+    onlineManager.setEventListener((setOnline) => NetInfo.addEventListener((state) => setOnline(state.isConnected !== false)));
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,OAAO,MAAM,iCAAiC,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB;IAClC,YAAY,CAAC,gBAAgB,CAAC,CAAC,UAAU,EAAE,EAAE;QAC3C,MAAM,YAAY,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CACjE,UAAU,CAAC,KAAK,KAAK,QAAQ,CAAC,CAC/B,CAAC;QACF,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,+FAA+F;IAC/F,wDAAwD;IACxD,aAAa,CAAC,gBAAgB,CAAC,CAAC,SAAS,EAAE,EAAE,CAC3C,OAAO,CAAC,gBAAgB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAC5E,CAAC;AACJ,CAAC"}

package/dist/sse.d.ts

@@ -0,0 +1,47 @@
+import { type SessionAdapter, type SseFrame } from "@gusnips/react";
+export interface SseStreamOptions {
+    /** The whole address of the stream, `https://api.example.com/chat/stream`. */
+    url: string;
+    /** POST, the default, sends `body` as JSON. GET sends nothing. */
+    method?: "GET" | "POST";
+    body?: unknown;
+    /**
+     * The adapter your `createApiClient` uses. Its token goes out as `Authorization: Bearer`, and a
+     * 401 calls its `refresh()` once and opens again with the new token. Leave it out for a stream
+     * that needs no sign-in.
+     */
+    session?: SessionAdapter;
+    /** Extra headers, computed when the request opens, like the API client's `headers`. */
+    headers?: () => Record<string, string>;
+    /** One frame off the wire. `data` is raw text: parse it the way your server writes it. */
+    onFrame: (frame: SseFrame) => void;
+    /**
+     * The stream failed. An `ApiError` when the server answered with a refusal, so the describer
+     * explains it like any other; a plain `Error` when nothing came back at all.
+     */
+    onError?: (error: Error) => void;
+    /** The stream ended, cleanly or not, without `abort()` being called. */
+    onClose?: () => void;
+}
+export interface SseStream {
+    readonly aborted: boolean;
+    /** Close the socket. No frame, error or close is delivered after this. */
+    abort(): void;
+}
+/**
+ * Open a stream. It starts at once; keep the handle to stop it.
+ *
+ * ```ts
+ * const stream = openSseStream({
+ *   url: `${API_URL}/chat/stream`,
+ *   body: { message },
+ *   session, // the same adapter createApiClient uses
+ *   onFrame: ({ event, data }) => handle(event, JSON.parse(data)),
+ * });
+ * ```
+ *
+ * ponytail: XHR keeps the whole response in `responseText`, so memory grows with the length of the
+ * stream. A chat turn is fine. A feed left open all day is not; that needs a native streaming module.
+ */
+export declare function openSseStream(options: SseStreamOptions): SseStream;
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAyBA,OAAO,EAA6B,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/F,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,0FAA0F;IAC1F,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,KAAK,IAAI,IAAI,CAAC;CACf;AAKD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAmFlE"}