@g3nomaly/ui 0.3.4 → 0.3.5

package/dist/packages/dependencies.d.ts

@@ -12,17 +12,20 @@ export interface NpmDependency {
     range?: string;
 }
 /**
- * @brief An npm package the app lacks, or holds at a version outside the range a component asks for.
+ * @brief An npm package the app lacks, declares only for build time although a component imports it
+ * at runtime, or holds at a version outside the range a component asks for.
  *
  * @property dependency - The package as the first component listing it asks for it.
  * @property dev - Whether every component listing it needs it at build time only.
  * @property neededBy - Keys of the components that list it, e.g. `["@shadcn/dialog"]`.
+ * @property devOnly - The app declares it in `devDependencies` only, though a component needs it at runtime.
  * @property installed - Installed version when it is outside the range; absent when the package is missing.
  */
 export interface DependencyProblem {
     dependency: NpmDependency;
     dev: boolean;
     neededBy: string[];
+    devOnly?: true;
     installed?: string;
 }
 /**
@@ -34,7 +37,8 @@ export interface DependencyProblem {
 export declare function parseNpmDependency(spec: string): NpmDependency;
 /**
  * @brief Checks the npm packages of components against the app: a package its `package.json`
- * does not declare is missing, and an installed package outside the requested range is out of range.
+ * does not declare is missing, a runtime package it declares in `devDependencies` only is misplaced,
+ * and an installed package outside the requested range is out of range.
  *
  * @param projectRoot - Absolute project root holding the app's `package.json`.
  * @param components - Components by key whose packages to check.

package/dist/packages/dependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/packages/dependencies.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAI,MAAM,CAAC;IACf,IAAI,EAAI,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,aAAa,CAAC;IAC1B,GAAG,EAAS,OAAO,CAAC;IACpB,QAAQ,EAAI,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAG9D;AAYD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,iBAAiB,EAAE,CA4B1H"}
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/packages/dependencies.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAI,MAAM,CAAC;IACf,IAAI,EAAI,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,aAAa,CAAC;IAC1B,GAAG,EAAS,OAAO,CAAC;IACpB,QAAQ,EAAI,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAI,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAG9D;AAYD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,iBAAiB,EAAE,CAiC1H"}

package/dist/packages/dependencies.js

@@ -1,5 +1,5 @@
 // packages/ui/src/packages/dependencies.ts
-import { findInstalledPackage, readDeclaredDependencies } from "@g3nomaly/core/sources";
+import { findInstalledPackage, readDeclaredDependencies, RUNTIME_SECTIONS } from "@g3nomaly/core/sources";
 /**
  * @brief Splits an npm spec into name and version range. The range follows the last `@` that is not a scope's.
  *
@@ -21,7 +21,8 @@ function isSemverRange(range) {
 }
 /**
  * @brief Checks the npm packages of components against the app: a package its `package.json`
- * does not declare is missing, and an installed package outside the requested range is out of range.
+ * does not declare is missing, a runtime package it declares in `devDependencies` only is misplaced,
+ * and an installed package outside the requested range is out of range.
  *
  * @param projectRoot - Absolute project root holding the app's `package.json`.
  * @param components - Components by key whose packages to check.
@@ -29,6 +30,7 @@ function isSemverRange(range) {
  */
 export function findDependencyProblems(projectRoot, components) {
     const declared = readDeclaredDependencies(projectRoot);
+    const runtime = readDeclaredDependencies(projectRoot, RUNTIME_SECTIONS);
     const problems = new Map();
     const check = (key, spec, dev) => {
         const dependency = parseNpmDependency(spec);
@@ -42,6 +44,10 @@ export function findDependencyProblems(projectRoot, components) {
             problems.set(dependency.name, { dependency, dev, neededBy: [key] });
             return;
         }
+        if (!dev && runtime[dependency.name] === undefined) {
+            problems.set(dependency.name, { dependency, dev, neededBy: [key], devOnly: true });
+            return;
+        }
         if (dependency.range === undefined || !isSemverRange(dependency.range))
             return;
         const installed = findInstalledPackage(projectRoot, dependency.name)?.version;

package/dist/packages/dependencies.js.map

@@ -1 +1 @@
-{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../src/packages/dependencies.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AA+BxF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACtG,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,UAAyC;IACnG,MAAM,QAAQ,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEtD,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,IAAY,EAAE,GAAY,EAAQ,EAAE;QAC9D,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAQ,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5C,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO;QAC/E,MAAM,SAAS,GAAG,oBAAoB,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAC9E,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClF,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1D,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,YAAY,IAAI,EAAE;YAAK,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5E,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,eAAe,IAAI,EAAE;YAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../src/packages/dependencies.ts"],"names":[],"mappings":"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"}

package/dist/packages/install.d.ts

@@ -7,4 +7,24 @@
  * @returns `undefined` on success, else the error `bun add` printed.
  */
 export declare function bunAdd(projectRoot: string, specs: readonly string[], dev: boolean): Promise<string | undefined>;
+/**
+ * @brief Runs `bun remove` in the project for one package.
+ *
+ * @param projectRoot - Absolute project root holding the app's `package.json`.
+ * @param pkg - Package to remove, e.g. `my-ui`.
+ * @returns `undefined` on success, else the error `bun remove` printed.
+ */
+export declare function bunRemove(projectRoot: string, pkg: string): Promise<string | undefined>;
+/**
+ * @brief Packs a package folder with `bun pm pack`, which runs its `prepack` script first and keeps
+ * only what its `files` field lists, so the tarball holds no `node_modules`.
+ *
+ * @param folder - Absolute folder holding the package's `package.json`.
+ * @returns The tarball's file name inside `folder`, e.g. `my-ui-0.3.0.tgz`, or the error `bun pm pack` printed.
+ */
+export declare function bunPack(folder: string): Promise<{
+    tarball: string;
+} | {
+    error: string;
+}>;
 //# sourceMappingURL=install.d.ts.map

package/dist/packages/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/packages/install.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CASrH"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/packages/install.ts"],"names":[],"mappings":"AA2BA;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAGrH;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE7F;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAM9F"}

package/dist/packages/install.js

@@ -1,4 +1,18 @@
 // packages/ui/src/packages/install.ts
+/**
+ * @brief Runs `bun` with the given arguments in a folder.
+ *
+ * @param cwd - Absolute folder to run in.
+ * @param args - Arguments after `bun`, e.g. `["add", "radix-ui"]`.
+ * @returns Its stdout, and the error it printed when it failed.
+ */
+async function runBun(cwd, args) {
+    const proc = Bun.spawn([process.execPath, ...args], { cwd, stdout: "pipe", stderr: "pipe" });
+    const [stdout, stderr, exitCode] = await Promise.all([new Response(proc.stdout).text(), new Response(proc.stderr).text(), proc.exited]);
+    if (exitCode === 0)
+        return { stdout: stdout.trim() };
+    return { stdout: stdout.trim(), error: stderr.trim() || `bun ${args[0] ?? ""} exited with ${exitCode}` };
+}
 /**
  * @brief Runs `bun add` in the project for the given specs, with `-d` for build-time packages.
  *
@@ -10,12 +24,31 @@
 export async function bunAdd(projectRoot, specs, dev) {
     if (specs.length === 0)
         return undefined;
-    const proc = Bun.spawn([process.execPath, "add", ...(dev ? ["-d"] : []), ...specs], {
-        cwd: projectRoot,
-        stdout: "ignore",
-        stderr: "pipe",
-    });
-    const [stderr, exitCode] = await Promise.all([new Response(proc.stderr).text(), proc.exited]);
-    return exitCode === 0 ? undefined : stderr.trim() || `bun add exited with ${exitCode}`;
+    return (await runBun(projectRoot, ["add", ...(dev ? ["-d"] : []), ...specs])).error;
+}
+/**
+ * @brief Runs `bun remove` in the project for one package.
+ *
+ * @param projectRoot - Absolute project root holding the app's `package.json`.
+ * @param pkg - Package to remove, e.g. `my-ui`.
+ * @returns `undefined` on success, else the error `bun remove` printed.
+ */
+export async function bunRemove(projectRoot, pkg) {
+    return (await runBun(projectRoot, ["remove", pkg])).error;
+}
+/**
+ * @brief Packs a package folder with `bun pm pack`, which runs its `prepack` script first and keeps
+ * only what its `files` field lists, so the tarball holds no `node_modules`.
+ *
+ * @param folder - Absolute folder holding the package's `package.json`.
+ * @returns The tarball's file name inside `folder`, e.g. `my-ui-0.3.0.tgz`, or the error `bun pm pack` printed.
+ */
+export async function bunPack(folder) {
+    const result = await runBun(folder, ["pm", "pack", "--quiet"]);
+    if (result.error !== undefined)
+        return { error: result.error };
+    // `--quiet` prints only the file name, but the output of a `prepack` script comes before it.
+    const tarball = result.stdout.split("\n").map((line) => line.trim()).filter(Boolean).at(-1);
+    return tarball === undefined ? { error: "bun pm pack printed no tarball name" } : { tarball };
 }
 //# sourceMappingURL=install.js.map

package/dist/packages/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/packages/install.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,WAAmB,EAAE,KAAwB,EAAE,GAAY;IACtF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE;QAClF,GAAG,EAAK,WAAW;QACnB,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IACH,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9F,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,uBAAuB,QAAQ,EAAE,CAAC;AACzF,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/packages/install.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAatC;;;;;;GAMG;AACH,KAAK,UAAU,MAAM,CAAC,GAAW,EAAE,IAAuB;IACxD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7F,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACxI,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACrD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,gBAAgB,QAAQ,EAAE,EAAE,CAAC;AAC3G,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,WAAmB,EAAE,KAAwB,EAAE,GAAY;IACtF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,CAAC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACtF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAmB,EAAE,GAAW;IAC9D,OAAO,CAAC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc;IAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/D,6FAA6F;IAC7F,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;AAChG,CAAC"}

package/dist/packages/localPack.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @brief A package the app installs from a folder on disk.
+ *
+ * @property folder - Absolute folder holding the package's `package.json`.
+ * @property declared - The range the app's `package.json` gives it, e.g. `file:../my-ui`.
+ * @property tarball - Absolute path of the tarball the app installs, when it installs a packed copy rather than a link to the folder.
+ */
+export interface LocalPackage {
+    folder: string;
+    declared: string;
+    tarball?: string;
+}
+/**
+ * @brief Where the app installs a package from, when that is a folder on disk: a `file:` or `link:`
+ * range naming the folder itself, or a tarball packed inside it.
+ *
+ * @param projectRoot - Absolute project root holding the app's `package.json`.
+ * @param pkg - Package name, e.g. `my-ui`.
+ * @returns The folder, or `null` when the app installs the package from a registry, git or a workspace,
+ * or the folder holds a different package.
+ */
+export declare function localPackage(projectRoot: string, pkg: string): LocalPackage | null;
+/**
+ * @brief The outcome of `installPackedCopy`.
+ *
+ * @property installed - The range now in `package.json`, e.g. `file:../my-ui/my-ui-0.3.0.tgz`; absent when nothing changed.
+ * @property error - What failed; the app keeps what it had.
+ */
+export interface PackResult {
+    installed?: string;
+    error?: string;
+}
+/**
+ * @brief Installs a packed copy of a local package in place of a link to its folder, or refreshes the
+ * copy. A linked folder brings its own `node_modules`, so files the app imports from it load the folder's
+ * packages, such as a second React; a packed copy holds only what the package's `files` field lists.
+ *
+ * Packs the folder with `bun pm pack` (which runs its `prepack` script), then removes the package and
+ * adds the tarball: Bun keeps an old copy when a tarball is replaced under the same name. A tarball
+ * identical to the one already installed is left as is.
+ *
+ * @param projectRoot - Absolute project root holding the app's `package.json`.
+ * @param pkg - Package name, e.g. `my-ui`.
+ * @param local - Where the app installs it from now.
+ * @returns The new range, nothing when the installed copy is current, or the error.
+ */
+export declare function installPackedCopy(projectRoot: string, pkg: string, local: LocalPackage): Promise<PackResult>;
+//# sourceMappingURL=localPack.d.ts.map

package/dist/packages/localPack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localPack.d.ts","sourceRoot":"","sources":["../../src/packages/localPack.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAI,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAalF;AAOD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBlH"}

package/dist/packages/localPack.js

@@ -0,0 +1,72 @@
+// packages/ui/src/packages/localPack.ts
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { readDeclaredDependencies } from "@g3nomaly/core/sources";
+import { bunAdd, bunPack, bunRemove } from "./install";
+const PackageNameSchema = z.object({ name: z.string().min(1) });
+/** `file:../my-ui`, `link:../my-ui` or `file:../my-ui/my-ui-0.3.0.tgz`. */
+const LOCAL_SPEC = /^(?:file|link):(.+)$/;
+/**
+ * @brief Where the app installs a package from, when that is a folder on disk: a `file:` or `link:`
+ * range naming the folder itself, or a tarball packed inside it.
+ *
+ * @param projectRoot - Absolute project root holding the app's `package.json`.
+ * @param pkg - Package name, e.g. `my-ui`.
+ * @returns The folder, or `null` when the app installs the package from a registry, git or a workspace,
+ * or the folder holds a different package.
+ */
+export function localPackage(projectRoot, pkg) {
+    const declared = readDeclaredDependencies(projectRoot)[pkg];
+    const target = declared === undefined ? undefined : LOCAL_SPEC.exec(declared)?.[1];
+    if (declared === undefined || target === undefined)
+        return null;
+    const resolved = path.resolve(projectRoot, target);
+    const packed = /\.(?:tgz|tar\.gz)$/.test(resolved);
+    const folder = packed ? path.dirname(resolved) : resolved;
+    const manifest = path.join(folder, "package.json");
+    if (!fs.existsSync(manifest))
+        return null;
+    const parsed = PackageNameSchema.safeParse(JSON.parse(fs.readFileSync(manifest, "utf8")));
+    if (!parsed.success || parsed.data.name !== pkg)
+        return null;
+    return { folder, declared, ...(packed ? { tarball: resolved } : {}) };
+}
+/** Bytes of a file, or `null` when it does not exist. */
+function readIfExists(file) {
+    return fs.existsSync(file) ? fs.readFileSync(file) : null;
+}
+/**
+ * @brief Installs a packed copy of a local package in place of a link to its folder, or refreshes the
+ * copy. A linked folder brings its own `node_modules`, so files the app imports from it load the folder's
+ * packages, such as a second React; a packed copy holds only what the package's `files` field lists.
+ *
+ * Packs the folder with `bun pm pack` (which runs its `prepack` script), then removes the package and
+ * adds the tarball: Bun keeps an old copy when a tarball is replaced under the same name. A tarball
+ * identical to the one already installed is left as is.
+ *
+ * @param projectRoot - Absolute project root holding the app's `package.json`.
+ * @param pkg - Package name, e.g. `my-ui`.
+ * @param local - Where the app installs it from now.
+ * @returns The new range, nothing when the installed copy is current, or the error.
+ */
+export async function installPackedCopy(projectRoot, pkg, local) {
+    const previous = local.tarball === undefined ? null : readIfExists(local.tarball);
+    const packed = await bunPack(local.folder);
+    if ("error" in packed)
+        return { error: `bun pm pack failed in ${local.folder}: ${packed.error}` };
+    const tarball = path.join(local.folder, packed.tarball);
+    const relative = path.relative(projectRoot, tarball).split(path.sep).join("/");
+    const range = `file:${relative.startsWith(".") ? relative : `./${relative}`}`;
+    if (tarball === local.tarball && previous !== null && previous.equals(fs.readFileSync(tarball)))
+        return {};
+    const removed = await bunRemove(projectRoot, pkg);
+    if (removed !== undefined)
+        return { error: `bun remove ${pkg} failed: ${removed}` };
+    const added = await bunAdd(projectRoot, [`${pkg}@${range}`], false);
+    if (added === undefined)
+        return { installed: range };
+    const restored = await bunAdd(projectRoot, [`${pkg}@${local.declared}`], false);
+    return { error: `bun add ${pkg}@${range} failed: ${added}${restored === undefined ? `; restored ${local.declared}` : `; restoring ${local.declared} failed too: ${restored}`}` };
+}
+//# sourceMappingURL=localPack.js.map

package/dist/packages/localPack.js.map

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

package/dist/registry/componentsJson.d.ts

@@ -6,13 +6,16 @@ export declare const COMPONENTS_JSON: string;
  * @brief Builds `components.json` from every `*.meta.ts` under the built components
  * folder: each component with its files hashed and stamped with the package
  * version, the meta file itself included. Files marked `install: "package"` must
- * be reachable through the package's `exports`, since apps import them from it.
+ * be reachable through the package's `exports`, since apps import them from it,
+ * and may only import packages the package declares in `peerDependencies`, so
+ * they use the app's copy. A component needs at least one file the app gets copied.
  *
  * @param componentsDir - Absolute built components folder, e.g. `<package>/dist/components`
  * @param outFile - Absolute path to write, e.g. `<package>/dist/components.json`
  * @param version - Package version stamped on every component and file
  * @returns how many components were written
- * @throws {Error} naming each file marked `install: "package"` that the package's `exports` does not reach
+ * @throws {Error} naming each file marked `install: "package"` that the package's `exports` does not reach,
+ * each package such a file imports that is not a peer, and each component with no copied file
  */
 export declare function writeComponentsJson(componentsDir: string, outFile: string, version: string): Promise<number>;
 /**

package/dist/registry/componentsJson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"componentsJson.d.ts","sourceRoot":"","sources":["../../src/registry/componentsJson.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,mGAAmG;AACnG,eAAO,MAAM,cAAc,QAAmC,CAAC;AAC/D,eAAO,MAAM,eAAe,QAAuC,CAAC;AAIpE;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BlH;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAMzF"}
+{"version":3,"file":"componentsJson.d.ts","sourceRoot":"","sources":["../../src/registry/componentsJson.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,mGAAmG;AACnG,eAAO,MAAM,cAAc,QAAmC,CAAC;AAC/D,eAAO,MAAM,eAAe,QAAuC,CAAC;AAIpE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ClH;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAMzF"}

package/dist/registry/componentsJson.js

@@ -8,6 +8,7 @@ import { hashFile } from "@g3nomaly/core/hash";
 import { getSafeObject } from "@g3nomaly/core/security";
 import { findPackageRoot } from "@g3nomaly/core/utils";
 import { unexportedFiles } from "./packageExports";
+import { undeclaredImports } from "./packageImports";
 import { PackagedComponentSchema } from "./types";
 /** Where a package keeps its built components and their registry, relative to the package root. */
 export const COMPONENTS_DIR = path.join("dist", "components");
@@ -17,19 +18,28 @@ const ComponentsJsonSchema = z.record(z.string(), PackagedComponentSchema);
  * @brief Builds `components.json` from every `*.meta.ts` under the built components
  * folder: each component with its files hashed and stamped with the package
  * version, the meta file itself included. Files marked `install: "package"` must
- * be reachable through the package's `exports`, since apps import them from it.
+ * be reachable through the package's `exports`, since apps import them from it,
+ * and may only import packages the package declares in `peerDependencies`, so
+ * they use the app's copy. A component needs at least one file the app gets copied.
  *
  * @param componentsDir - Absolute built components folder, e.g. `<package>/dist/components`
  * @param outFile - Absolute path to write, e.g. `<package>/dist/components.json`
  * @param version - Package version stamped on every component and file
  * @returns how many components were written
- * @throws {Error} naming each file marked `install: "package"` that the package's `exports` does not reach
+ * @throws {Error} naming each file marked `install: "package"` that the package's `exports` does not reach,
+ * each package such a file imports that is not a peer, and each component with no copied file
  */
 export async function writeComponentsJson(componentsDir, outFile, version) {
     const store = createRegistryStore();
     const metaFiles = await glob("**/*.meta.ts", { cwd: componentsDir, absolute: true });
     for (const metaFile of metaFiles.sort()) {
         const meta = await getSafeObject(metaFile, PackagedComponentSchema);
+        if (meta.files.every((file) => file.install === "package")) {
+            throw new Error([
+                `${path.relative(componentsDir, metaFile)} lists no file for the app to copy, so apps could never install ${meta.name}.`,
+                "A file that stays in the package needs no meta file of its own: delete this one, and import the file by package path where it is used.",
+            ].join("\n"));
+        }
         const files = [...meta.files, { path: path.relative(componentsDir, metaFile), type: "meta" }];
         const hashed = await Promise.all(files.map(async (file) => ({
             ...file,
@@ -48,6 +58,15 @@ export async function writeComponentsJson(componentsDir, outFile, version) {
             `add an export that reaches them, e.g. "exports": { "./*": "./${path.relative(packageRoot, componentsDir).split(path.sep).join("/")}/*.ts" }`,
         ].join("\n"));
     }
+    const undeclared = undeclaredImports(packageRoot, packageFiles);
+    if (undeclared.length > 0) {
+        throw new Error([
+            "files marked install: \"package\" import packages that are not in the peerDependencies of package.json:",
+            ...undeclared.map(({ file, pkg }) => `    ${file}: ${pkg}`),
+            "these files run in the app, so they must use the app's copy, or the app loads a second one, such as a second React.",
+            "add each package to \"peerDependencies\", and to \"devDependencies\" to build and typecheck here.",
+        ].join("\n"));
+    }
     writeTo(store, outFile, jsonHandler);
     return Object.keys(store.store.state).length;
 }

package/dist/registry/componentsJson.js.map

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

package/dist/registry/packageImports.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @brief A package a file imports that its package does not declare as a peer.
+ *
+ * @property file - Path of the importing file from the package root, e.g. `dist/components/dock/layout.ts`.
+ * @property pkg - Name of the imported package, e.g. `react` or `@tanstack/store`.
+ */
+export interface UndeclaredImport {
+    file: string;
+    pkg: string;
+}
+/**
+ * @brief Packages the files import at runtime that the package's `peerDependencies` lack.
+ *
+ * Files marked `install: "package"` run inside the app, so every package they import must come from the
+ * app's own install: a package installed beside them would load a second copy, such as a second React.
+ * Type-only imports are left out, since they are gone at runtime, and so are imports of the package itself.
+ *
+ * @param packageRoot - Absolute folder holding the package's `package.json`.
+ * @param files - Files to scan, relative to the package root.
+ * @returns One entry per file and package that is not a peer, in file order.
+ */
+export declare function undeclaredImports(packageRoot: string, files: readonly string[]): UndeclaredImport[];
+//# sourceMappingURL=packageImports.d.ts.map

package/dist/registry/packageImports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageImports.d.ts","sourceRoot":"","sources":["../../src/registry/packageImports.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAG,MAAM,CAAC;CACd;AAiBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAYnG"}

package/dist/registry/packageImports.js

@@ -0,0 +1,51 @@
+// packages/ui/src/registry/packageImports.ts
+import fs from "node:fs";
+import { builtinModules } from "node:module";
+import path from "node:path";
+import { z } from "zod";
+const PackagePeersSchema = z.object({
+    name: z.string().min(1),
+    peerDependencies: z.record(z.string(), z.string()).optional(),
+});
+/** Node and Bun built-ins, which need no install. */
+const BUILTINS = new Set(builtinModules);
+/**
+ * @brief The package an import path names, or `null` for a path that needs no package: a relative
+ * path, a built-in such as `node:fs` or `bun:test`.
+ *
+ * @param specifier - The import path as written, e.g. `@tanstack/store/vanilla`.
+ * @returns The package name, e.g. `@tanstack/store`.
+ */
+function packageOf(specifier) {
+    if (specifier.startsWith(".") || specifier.startsWith("/"))
+        return null;
+    if (specifier.startsWith("node:") || specifier.startsWith("bun:") || specifier === "bun")
+        return null;
+    const [first = "", second] = specifier.split("/");
+    const name = first.startsWith("@") && second !== undefined ? `${first}/${second}` : first;
+    return BUILTINS.has(name) ? null : name;
+}
+/**
+ * @brief Packages the files import at runtime that the package's `peerDependencies` lack.
+ *
+ * Files marked `install: "package"` run inside the app, so every package they import must come from the
+ * app's own install: a package installed beside them would load a second copy, such as a second React.
+ * Type-only imports are left out, since they are gone at runtime, and so are imports of the package itself.
+ *
+ * @param packageRoot - Absolute folder holding the package's `package.json`.
+ * @param files - Files to scan, relative to the package root.
+ * @returns One entry per file and package that is not a peer, in file order.
+ */
+export function undeclaredImports(packageRoot, files) {
+    const manifest = PackagePeersSchema.parse(JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8")));
+    const peers = manifest.peerDependencies ?? {};
+    const transpiler = new Bun.Transpiler({ loader: "tsx" });
+    return files.flatMap((file) => {
+        const imports = transpiler.scanImports(fs.readFileSync(path.join(packageRoot, file), "utf8"));
+        const packages = new Set(imports.map((entry) => packageOf(entry.path)));
+        return [...packages]
+            .filter((pkg) => pkg !== null && pkg !== manifest.name && peers[pkg] === undefined)
+            .map((pkg) => ({ file, pkg }));
+    });
+}
+//# sourceMappingURL=packageImports.js.map

package/dist/registry/packageImports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageImports.js","sourceRoot":"","sources":["../../src/registry/packageImports.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAc,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC;AAEH,qDAAqD;AACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;AAazC;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,SAAiB;IAClC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACtG,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1F,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,KAAwB;IAC7E,MAAM,QAAQ,GAAK,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACzH,MAAM,KAAK,GAAQ,QAAQ,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAEzD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,OAAO,GAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/F,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,QAAQ,CAAC;aACjB,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;aACjG,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/registry/readSource.js

@@ -74,7 +74,7 @@ export function readComponentSource(flags) {
                 }]);
         }
         if (unreachable.length > 0) {
-            warnings.push(`${unreachable.join(", ")} import files that stay in the package, which only resolve when the source is installed with \`bun add\` and registered as \`npm:<package>\``);
+            warnings.push(`${unreachable.join(", ")} import files that stay in the package, which only resolve when the source is installed with \`bun add\`, from npm, git, a workspace or a folder, and registered as \`npm:<package>\``);
         }
         return { entries, warnings };
     };

package/dist/registry/readSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"readSource.js","sourceRoot":"","sources":["../../src/registry/readSource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AActE;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAA+B,EAAE,KAAyB;IACpF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAC,YAAY,CAAC;QAC/D,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAG,OAAO,KAAK,CAAC,WAAW,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAmD;IACzE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACxC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,QAAwB;IACjD,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;AAClH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,EAAE;QACxB,MAAM,OAAO,GAA8B,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAK,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3E,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;YAC7E,MAAM,KAAK,GAAU,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;YACjG,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,6CAA6C,CAAC,CAAC;gBACnE,SAAS;YACX,CAAC;YACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,KAAK,IAAI;gBAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1E,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;YACrI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE;oBACjB,GAAG,IAAI;oBACP,KAAK,EAAG,OAAO,CAAC,IAAI,CAAC;oBACrB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;oBAC1G,KAAK;oBACL,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;oBACvD,GAAG,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;iBACvD,CAAC,CAAC,CAAC;QACN,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,8IAA8I,CAAC,CAAC;QACzL,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"readSource.js","sourceRoot":"","sources":["../../src/registry/readSource.ts"],"names":[],"mappings":"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"}

package/dist/theme/cssVars.d.ts

@@ -1,19 +1,32 @@
 import type { CssVars } from "../registry/types";
+/**
+ * @brief One token added to a stylesheet.
+ *
+ * @property block - Selector of the block it went into, e.g. `:root`.
+ * @property name - Its name with the leading `--`, e.g. `--sidebar`.
+ * @property value - Its value, e.g. `oklch(0.98 0 0)`.
+ */
+export interface AddedToken {
+    block: string;
+    name: string;
+    value: string;
+}
 /**
  * @brief The result of adding tokens to a stylesheet.
  *
  * @property css - The stylesheet with the missing tokens added.
- * @property added - Each token added, as `<block> --<name>`, e.g. `:root --sidebar`.
+ * @property added - Each token added, in block order.
  */
 export interface CssVarsMerge {
     css: string;
-    added: string[];
+    added: AddedToken[];
 }
 /**
  * @brief Adds the theme tokens a stylesheet lacks: `light` to `:root`, `dark` to `.dark`, `theme` to
- * `@theme inline`. When the stylesheet has a `@theme` block (Tailwind v4), each colour token also gets
- * its `--color-<name>: var(--<name>)` mapping there, the way shadcn adds them, so Tailwind classes such
- * as `bg-sidebar` work. Tokens the stylesheet defines keep their value: the app's theme wins.
+ * `@theme inline`. When the stylesheet has a `@theme` block (Tailwind v4), each token whose value is a
+ * colour also gets its `--color-<name>: var(--<name>)` mapping there, the way shadcn adds them, so
+ * Tailwind classes such as `bg-sidebar` work. Tokens the stylesheet defines, in any block of the same
+ * kind, keep their value: the app's theme wins.
  *
  * @param css - The stylesheet, e.g. the contents of `src/index.css`.
  * @param vars - Tokens to add.

package/dist/theme/cssVars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cssVars.d.ts","sourceRoot":"","sources":["../../src/theme/cssVars.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAoBjD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAI,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAiDD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,CAenE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAM7D"}
+{"version":3,"file":"cssVars.d.ts","sourceRoot":"","sources":["../../src/theme/cssVars.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAqBjD;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAG,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAI,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAkED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,CAanE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAM7D"}