@shadow-js/ui 1.0.0 → 1.0.2

package/dist/cli.mjs

@@ -1,16 +1,48 @@
 #!/usr/bin/env node
 import { spawn } from "node:child_process";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import { createInterface } from "node:readline/promises";
-import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readlinkSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { parseArgs } from "node:util";
+import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
-//#region src/cli/fs.ts
+// src/cli/fs.ts
 /**
 * The filesystem the CLI works on, as an interface so commands are tested against a temp
 * directory or an in-memory tree, and so every path goes through one place.
 * @packageDocumentation
 */
+/** Symbolic links followed while resolving one path; the same bound the operating system uses. */
+const MAX_LINK_HOPS = 40;
+/** Whether a failed file call means "nothing is there" (or a file stands where a directory should). */
+function isMissing(error) {
+	const code = error.code;
+	return code === "ENOENT" || code === "ENOTDIR";
+}
+/**
+* The real path of `path`, where the part that does not exist yet is kept as written. A symbolic
+* link whose target is missing is followed to that target: a write through it would create the
+* target, so the guard has to see where it is.
+*/
+function resolveReal(path, hops) {
+	try {
+		return realpathSync(path);
+	} catch (error) {
+		if (!isMissing(error)) throw error;
+	}
+	let link;
+	try {
+		link = readlinkSync(path);
+	} catch (error) {
+		if (!isMissing(error) && error.code !== "EINVAL") throw error;
+	}
+	if (link !== void 0) {
+		if (hops >= MAX_LINK_HOPS) throw Object.assign(/* @__PURE__ */ new Error(`Too many symbolic links: ${path}`), { code: "ELOOP" });
+		return resolveReal(resolve(resolveReal(dirname(path), hops + 1), link), hops + 1);
+	}
+	const parent = dirname(path);
+	if (parent === path) return path;
+	return join(resolveReal(parent, hops), basename(path));
+}
 /**
 * The real filesystem.
 *
@@ -26,7 +58,7 @@ function nodeFs() {
 		exists: (path) => existsSync(path),
 		read(path) {
 			try {
-				return readFileSync(path, "utf8");
+				return readFileSync(path, "utf8").replace(/^\uFEFF/, "");
 			} catch (error) {
 				if (error.code === "ENOENT") return void 0;
 				throw error;
@@ -40,15 +72,7 @@ function nodeFs() {
 			rmSync(path, { force: true });
 		},
 		realpath(path) {
-			const tail = [];
-			let current = path;
-			while (!existsSync(current)) {
-				const parent = dirname(current);
-				if (parent === current) return path;
-				tail.unshift(basename(current));
-				current = parent;
-			}
-			return join(realpathSync(current), ...tail);
+			return resolveReal(path, 0);
 		}
 	};
 }
@@ -210,25 +234,37 @@ function installCrashHandlers(argv) {
 	process.on("uncaughtException", crash);
 	process.on("unhandledRejection", crash);
 }
-/** The edit script turning `a` into `b`; one big replacement when the texts are too large. */
-function edits(a, b) {
-	const n = a.length;
-	const m = b.length;
-	const max = n + m;
-	if (max > 2e4) return [...a.map((line) => ({
+/** The whole of `a` deleted and the whole of `b` inserted: always correct, never minimal. */
+function replacement(a, b) {
+	return [...a.map((line) => ({
 		kind: "delete",
 		line
 	})), ...b.map((line) => ({
 		kind: "insert",
 		line
 	}))];
+}
+/** The edit script turning `a` into `b`; one big replacement when the texts are too large or too different. */
+function edits(a, b) {
+	const n = a.length;
+	const m = b.length;
+	const max = n + m;
+	if (max > 2e4) return replacement(a, b);
 	const offset = max;
-	let frontier = new Int32Array(2 * max + 2);
+	const frontier = new Int32Array(2 * max + 2);
+	/** The frontier before each round, only the diagonals the next round can read: `[offset - d - 1, offset + d + 1]`. */
 	const trace = [];
+	let kept = 0;
 	let reached = -1;
 	for (let d = 0; d <= max && reached === -1; d += 1) {
-		trace.push(frontier.slice());
-		const next = frontier.slice();
+		const from = Math.max(0, offset - d - 1);
+		const cells = frontier.slice(from, Math.min(frontier.length, offset + d + 2));
+		kept += cells.length;
+		if (kept > 16e6) return replacement(a, b);
+		trace.push({
+			from,
+			cells
+		});
 		for (let k = -d; k <= d; k += 2) {
 			let x;
 			const below = frontier[offset + k - 1] ?? 0;
@@ -240,24 +276,24 @@ function edits(a, b) {
 				x += 1;
 				y += 1;
 			}
-			next[offset + k] = x;
+			frontier[offset + k] = x;
 			if (x >= n && y >= m) {
 				reached = d;
 				break;
 			}
 		}
-		frontier = next;
 	}
 	const result = [];
 	let x = n;
 	let y = m;
 	for (let d = reached; d > 0; d -= 1) {
-		const previous = trace[d] ?? /* @__PURE__ */ new Int32Array(0);
+		const previous = trace[d];
+		const at = (index) => previous === void 0 ? 0 : previous.cells[index - previous.from] ?? 0;
 		const k = x - y;
-		const below = previous[offset + k - 1] ?? 0;
-		const above = previous[offset + k + 1] ?? 0;
+		const below = at(offset + k - 1);
+		const above = at(offset + k + 1);
 		const previousK = k === -d || k !== d && below < above ? k + 1 : k - 1;
-		const previousX = previous[offset + previousK] ?? 0;
+		const previousX = at(offset + previousK);
 		const previousY = previousX - previousK;
 		while (x > previousX && y > previousY) {
 			x -= 1;
@@ -371,8 +407,187 @@ function unifiedDiff(before, after, labels, context = 3) {
 		...hunks
 	].join("\n");
 }
-//#endregion
-//#region src/cli/paths.ts
+// src/cli/schema.ts
+/**
+* The base colors, in documentation order.
+* @since 1.0.0
+*
+* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
+*/
+const BASE_COLORS = [
+	"neutral",
+	"zinc",
+	"slate",
+	"stone",
+	"gray"
+];
+/**
+* The default aliases (shadcn's).
+* @since 1.0.0
+*
+* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
+*/
+const DEFAULT_ALIASES = {
+	components: "@/components",
+	ui: "@/components/ui",
+	lib: "@/lib",
+	utils: "@/lib/utils",
+	hooks: "@/hooks"
+};
+/** Registry item names are kebab-case; nothing else may reach a file path. */
+const NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** A file name inside `registry/<name>/`. */
+const FILE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+/**
+* Whether `name` is a valid registry item name.
+*
+* @param name Any string.
+* @returns `true` for kebab-case names such as `dropdown-menu`.
+* @example
+* isValidItemName("../etc/passwd"); // false
+* @since 1.0.0
+*
+* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
+*/
+function isValidItemName(name) {
+	return NAME_PATTERN.test(name);
+}
+/**
+* Thrown for malformed registry or configuration data.
+* @since 1.0.0
+*
+* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
+*/
+var SchemaError = class extends Error {
+	/** The stable code `--json` prints. */
+	code = "SHADOW_UI_INVALID_FILE";
+	constructor(message) {
+		super(message);
+		this.name = "SchemaError";
+	}
+};
+function record(value, where) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new SchemaError(`${where} must be an object`);
+	return value;
+}
+function text(value, where) {
+	if (typeof value !== "string" || value === "") throw new SchemaError(`${where} must be a string`);
+	return value;
+}
+function strings(value, where) {
+	if (!Array.isArray(value)) throw new SchemaError(`${where} must be an array`);
+	return value.map((entry, index) => text(entry, `${where}[${index}]`));
+}
+function itemType(value, where) {
+	if (value === "ui" || value === "lib" || value === "hook") return value;
+	throw new SchemaError(`${where} must be "ui", "lib" or "hook"`);
+}
+function parseItem(value, index) {
+	const where = `items[${index}]`;
+	const item = record(value, where);
+	const name = text(item["name"], `${where}.name`);
+	if (!isValidItemName(name)) throw new SchemaError(`${where}.name "${name}" is not a valid name`);
+	const files = item["files"];
+	if (!Array.isArray(files) || files.length === 0) throw new SchemaError(`${where}.files must be a non-empty array`);
+	const dependencies = record(item["dependencies"], `${where}.dependencies`);
+	const tailwind = record(item["tailwind"], `${where}.tailwind`);
+	return {
+		name,
+		type: itemType(item["type"], `${where}.type`),
+		title: text(item["title"], `${where}.title`),
+		description: text(item["description"], `${where}.description`),
+		files: files.map((file, fileIndex) => {
+			const entry = record(file, `${where}.files[${fileIndex}]`);
+			const path = text(entry["path"], `${where}.files[${fileIndex}].path`);
+			const segments = path.split("/");
+			const [root, folder, base] = segments;
+			if (segments.length !== 3 || root !== "registry" || folder !== name || base === void 0 || !FILE_PATTERN.test(base)) throw new SchemaError(`${where}.files[${fileIndex}].path "${path}" must be registry/${name}/<file>`);
+			return {
+				path,
+				type: itemType(entry["type"], `${where}.files[${fileIndex}].type`)
+			};
+		}),
+		registryDependencies: strings(item["registryDependencies"], `${where}.registryDependencies`),
+		dependencies: Object.fromEntries(Object.entries(dependencies).map(([pkg, version]) => [pkg, text(version, `${where}.dependencies.${pkg}`)])),
+		exports: strings(item["exports"], `${where}.exports`),
+		primitives: strings(item["primitives"], `${where}.primitives`),
+		tailwind: {
+			tokens: strings(tailwind["tokens"], `${where}.tailwind.tokens`),
+			animations: tailwind["animations"] === true
+		}
+	};
+}
+/**
+* Validates parsed `registry.json` data.
+*
+* @param value The parsed JSON.
+* @returns The typed index.
+* @throws SchemaError naming the first malformed field.
+* @example
+* const index = parseRegistryIndex(JSON.parse(readFileSync("registry.json", "utf8")));
+* @since 1.0.0
+*
+* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
+*/
+function parseRegistryIndex(value) {
+	const root = record(value, "registry");
+	const items = root["items"];
+	if (!Array.isArray(items)) throw new SchemaError("registry.items must be an array");
+	const parsed = items.map(parseItem);
+	const seen = /* @__PURE__ */ new Set();
+	for (const item of parsed) {
+		if (seen.has(item.name)) throw new SchemaError(`registry has two items named "${item.name}"`);
+		seen.add(item.name);
+	}
+	return {
+		name: text(root["name"], "registry.name"),
+		version: text(root["version"], "registry.version"),
+		frameworkDependencies: strings(root["frameworkDependencies"], "registry.frameworkDependencies"),
+		items: parsed
+	};
+}
+/**
+* Validates parsed `components.json` data.
+*
+* @param value The parsed JSON.
+* @returns The typed configuration, with defaults for missing aliases.
+* @throws SchemaError naming the first malformed field.
+* @example
+* const config = parseComponentsConfig(JSON.parse(readFileSync("components.json", "utf8")));
+* @since 1.0.0
+*
+* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
+*/
+function parseComponentsConfig(value) {
+	const root = record(value, "components.json");
+	const tailwind = record(root["tailwind"], "components.json tailwind");
+	const baseColor = tailwind["baseColor"] ?? "neutral";
+	if (!BASE_COLORS.includes(baseColor)) throw new SchemaError(`components.json tailwind.baseColor must be one of ${BASE_COLORS.join(", ")}`);
+	const given = root["aliases"] === void 0 ? {} : record(root["aliases"], "components.json aliases");
+	const alias = (key) => {
+		const entry = given[key];
+		if (entry === void 0) return DEFAULT_ALIASES[key];
+		const aliasText = text(entry, `components.json aliases.${key}`);
+		if (aliasText.includes("..") || /\s/.test(aliasText)) throw new SchemaError(`components.json aliases.${key} "${aliasText}" is not a valid alias`);
+		return aliasText;
+	};
+	const framework = root["framework"];
+	return {
+		framework: framework === "vite" || framework === "dusk" ? framework : "unknown",
+		tailwind: {
+			css: text(tailwind["css"], "components.json tailwind.css"),
+			baseColor
+		},
+		aliases: {
+			components: alias("components"),
+			ui: alias("ui"),
+			lib: alias("lib"),
+			utils: alias("utils"),
+			hooks: alias("hooks")
+		}
+	};
+}
+// src/cli/paths.ts
 /**
 * Path handling: reading `tsconfig` path aliases, mapping an import alias to a directory, and the
 * guard that keeps every write inside the project. Pure except for the `ProjectFs` it is handed.
@@ -478,7 +693,14 @@ function readPathMappings(fs, root) {
 	for (const name of ["tsconfig.json", "tsconfig.app.json"]) {
 		const text = fs.read(join(root, name));
 		if (text === void 0) continue;
-		const options = asRecord(asRecord(parseJsonc(text))?.["compilerOptions"]);
+		let parsed;
+		try {
+			parsed = parseJsonc(text);
+		} catch (error) {
+			if (error instanceof SyntaxError) throw new SchemaError(`${name} is not valid JSON: ${error.message}`);
+			throw error;
+		}
+		const options = asRecord(asRecord(parsed)?.["compilerOptions"]);
 		const paths = asRecord(options?.["paths"]);
 		if (paths === void 0) continue;
 		const base = typeof options?.["baseUrl"] === "string" ? resolve(root, options["baseUrl"]) : root;
@@ -567,8 +789,7 @@ function resolveInsideReal(fs, root, target) {
 	if (rel === ".." || rel.startsWith(`..${sep}`) || isAbsolute(rel)) throw new PathError(`Refusing to write outside the project (symbolic link): ${target}`);
 	return absolute;
 }
-//#endregion
-//#region src/cli/pm.ts
+// src/cli/pm.ts
 /**
 * Package manager detection and the install command line. npm is the default; pnpm, yarn and bun
 * are used when their lockfile (or the `packageManager` field) says so.
@@ -635,189 +856,7 @@ function installCommand(manager, packages) {
 		};
 	}
 }
-//#endregion
-//#region src/cli/schema.ts
-/**
-* The base colors, in documentation order.
-* @since 1.0.0
-*
-* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
-*/
-const BASE_COLORS = [
-	"neutral",
-	"zinc",
-	"slate",
-	"stone",
-	"gray"
-];
-/**
-* The default aliases (shadcn's).
-* @since 1.0.0
-*
-* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
-*/
-const DEFAULT_ALIASES = {
-	components: "@/components",
-	ui: "@/components/ui",
-	lib: "@/lib",
-	utils: "@/lib/utils",
-	hooks: "@/hooks"
-};
-/** Registry item names are kebab-case; nothing else may reach a file path. */
-const NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-/** A file name inside `registry/<name>/`. */
-const FILE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
-/**
-* Whether `name` is a valid registry item name.
-*
-* @param name Any string.
-* @returns `true` for kebab-case names such as `dropdown-menu`.
-* @example
-* isValidItemName("../etc/passwd"); // false
-* @since 1.0.0
-*
-* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
-*/
-function isValidItemName(name) {
-	return NAME_PATTERN.test(name);
-}
-/**
-* Thrown for malformed registry or configuration data.
-* @since 1.0.0
-*
-* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
-*/
-var SchemaError = class extends Error {
-	/** The stable code `--json` prints. */
-	code = "SHADOW_UI_INVALID_FILE";
-	constructor(message) {
-		super(message);
-		this.name = "SchemaError";
-	}
-};
-function record(value, where) {
-	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new SchemaError(`${where} must be an object`);
-	return value;
-}
-function text(value, where) {
-	if (typeof value !== "string" || value === "") throw new SchemaError(`${where} must be a string`);
-	return value;
-}
-function strings(value, where) {
-	if (!Array.isArray(value)) throw new SchemaError(`${where} must be an array`);
-	return value.map((entry, index) => text(entry, `${where}[${index}]`));
-}
-function itemType(value, where) {
-	if (value === "ui" || value === "lib" || value === "hook") return value;
-	throw new SchemaError(`${where} must be "ui", "lib" or "hook"`);
-}
-function parseItem(value, index) {
-	const where = `items[${index}]`;
-	const item = record(value, where);
-	const name = text(item["name"], `${where}.name`);
-	if (!isValidItemName(name)) throw new SchemaError(`${where}.name "${name}" is not a valid name`);
-	const files = item["files"];
-	if (!Array.isArray(files) || files.length === 0) throw new SchemaError(`${where}.files must be a non-empty array`);
-	const dependencies = record(item["dependencies"], `${where}.dependencies`);
-	const tailwind = record(item["tailwind"], `${where}.tailwind`);
-	return {
-		name,
-		type: itemType(item["type"], `${where}.type`),
-		title: text(item["title"], `${where}.title`),
-		description: text(item["description"], `${where}.description`),
-		files: files.map((file, fileIndex) => {
-			const entry = record(file, `${where}.files[${fileIndex}]`);
-			const path = text(entry["path"], `${where}.files[${fileIndex}].path`);
-			const segments = path.split("/");
-			const [root, folder, base] = segments;
-			if (segments.length !== 3 || root !== "registry" || folder !== name || base === void 0 || !FILE_PATTERN.test(base)) throw new SchemaError(`${where}.files[${fileIndex}].path "${path}" must be registry/${name}/<file>`);
-			return {
-				path,
-				type: itemType(entry["type"], `${where}.files[${fileIndex}].type`)
-			};
-		}),
-		registryDependencies: strings(item["registryDependencies"], `${where}.registryDependencies`),
-		dependencies: Object.fromEntries(Object.entries(dependencies).map(([pkg, version]) => [pkg, text(version, `${where}.dependencies.${pkg}`)])),
-		exports: strings(item["exports"], `${where}.exports`),
-		primitives: strings(item["primitives"], `${where}.primitives`),
-		tailwind: {
-			tokens: strings(tailwind["tokens"], `${where}.tailwind.tokens`),
-			animations: tailwind["animations"] === true
-		}
-	};
-}
-/**
-* Validates parsed `registry.json` data.
-*
-* @param value The parsed JSON.
-* @returns The typed index.
-* @throws SchemaError naming the first malformed field.
-* @example
-* const index = parseRegistryIndex(JSON.parse(readFileSync("registry.json", "utf8")));
-* @since 1.0.0
-*
-* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
-*/
-function parseRegistryIndex(value) {
-	const root = record(value, "registry");
-	const items = root["items"];
-	if (!Array.isArray(items)) throw new SchemaError("registry.items must be an array");
-	const parsed = items.map(parseItem);
-	const seen = /* @__PURE__ */ new Set();
-	for (const item of parsed) {
-		if (seen.has(item.name)) throw new SchemaError(`registry has two items named "${item.name}"`);
-		seen.add(item.name);
-	}
-	return {
-		name: text(root["name"], "registry.name"),
-		version: text(root["version"], "registry.version"),
-		frameworkDependencies: strings(root["frameworkDependencies"], "registry.frameworkDependencies"),
-		items: parsed
-	};
-}
-/**
-* Validates parsed `components.json` data.
-*
-* @param value The parsed JSON.
-* @returns The typed configuration, with defaults for missing aliases.
-* @throws SchemaError naming the first malformed field.
-* @example
-* const config = parseComponentsConfig(JSON.parse(readFileSync("components.json", "utf8")));
-* @since 1.0.0
-*
-* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
-*/
-function parseComponentsConfig(value) {
-	const root = record(value, "components.json");
-	const tailwind = record(root["tailwind"], "components.json tailwind");
-	const baseColor = tailwind["baseColor"] ?? "neutral";
-	if (!BASE_COLORS.includes(baseColor)) throw new SchemaError(`components.json tailwind.baseColor must be one of ${BASE_COLORS.join(", ")}`);
-	const given = root["aliases"] === void 0 ? {} : record(root["aliases"], "components.json aliases");
-	const alias = (key) => {
-		const entry = given[key];
-		if (entry === void 0) return DEFAULT_ALIASES[key];
-		const aliasText = text(entry, `components.json aliases.${key}`);
-		if (aliasText.includes("..") || /\s/.test(aliasText)) throw new SchemaError(`components.json aliases.${key} "${aliasText}" is not a valid alias`);
-		return aliasText;
-	};
-	const framework = root["framework"];
-	return {
-		framework: framework === "vite" || framework === "dusk" ? framework : "unknown",
-		tailwind: {
-			css: text(tailwind["css"], "components.json tailwind.css"),
-			baseColor
-		},
-		aliases: {
-			components: alias("components"),
-			ui: alias("ui"),
-			lib: alias("lib"),
-			utils: alias("utils"),
-			hooks: alias("hooks")
-		}
-	};
-}
-//#endregion
-//#region src/cli/project.ts
+// src/cli/project.ts
 /**
 * The project the CLI works in: `components.json`, `package.json`, the stylesheet that imports
 * Tailwind, and the theme stylesheet `init` generates. Reads through {@link ProjectFs}.
@@ -1084,8 +1123,7 @@ function display(root, absolute) {
 function themePathFor(cssPath) {
 	return join(dirname(cssPath), THEME_FILE);
 }
-//#endregion
-//#region src/cli/resolve.ts
+// src/cli/resolve.ts
 /**
 * Registry resolution: from the names a user typed to the ordered list of items to copy and the
 * npm packages they need. Pure: no filesystem, no network.
@@ -1242,13 +1280,13 @@ function dependentsOf(index, name, candidates) {
 	}
 	return found.sort();
 }
-//#endregion
-//#region src/cli/rewrite.ts
+// src/cli/rewrite.ts
 /**
 * Maps one import specifier from the registry layout to the project's aliases.
 *
 * @param specifier An import specifier such as `@/components/ui/button`.
 * @param aliases The aliases from `components.json`.
+* @param options Rewrites besides the aliases (relative imports between ui components).
 * @returns The rewritten specifier, or the input unchanged when it is not a registry alias.
 * @example
 * rewriteSpecifier("@/lib/utils", { ...aliases, utils: "~/helpers/cn" }); // "~/helpers/cn"
@@ -1256,9 +1294,12 @@ function dependentsOf(index, name, candidates) {
 *
 * @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
 */
-function rewriteSpecifier(specifier, aliases) {
+function rewriteSpecifier(specifier, aliases, options = {}) {
 	if (specifier === "@/lib/utils") return aliases.utils;
-	if (specifier.startsWith("@/components/ui/")) return `${aliases.ui}/${specifier.slice(16)}`;
+	if (specifier.startsWith("@/components/ui/")) {
+		const rest = specifier.slice(16);
+		return options.relativeUi === true ? `./${rest}` : `${aliases.ui}/${rest}`;
+	}
 	if (specifier.startsWith("@/hooks/")) return `${aliases.hooks}/${specifier.slice(8)}`;
 	if (specifier.startsWith("@/lib/")) return `${aliases.lib}/${specifier.slice(6)}`;
 	return specifier;
@@ -1271,6 +1312,7 @@ const SPECIFIER = /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s+)(["'])(@\/[^"'\n]+)\2
 *
 * @param source A registry file's text.
 * @param aliases The aliases from `components.json`.
+* @param options Rewrites besides the aliases (relative imports between ui components).
 * @returns The text with rewritten specifiers.
 * @example
 * rewriteImports('import { cn } from "@/lib/utils";', aliases);
@@ -1278,11 +1320,10 @@ const SPECIFIER = /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s+)(["'])(@\/[^"'\n]+)\2
 *
 * @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
 */
-function rewriteImports(source, aliases) {
-	return source.replace(SPECIFIER, (_match, lead, quote, specifier) => `${lead}${quote}${rewriteSpecifier(specifier, aliases)}${quote}`);
+function rewriteImports(source, aliases, options = {}) {
+	return source.replace(SPECIFIER, (_match, lead, quote, specifier) => `${lead}${quote}${rewriteSpecifier(specifier, aliases, options)}${quote}`);
 }
-//#endregion
-//#region src/cli/commands.ts
+// src/cli/commands.ts
 /**
 * The CLI commands. Each takes a {@link CliContext} (filesystem, registry, output, prompt and
 * installer are parameters), so tests run them against a temp directory with a recording
@@ -1341,12 +1382,26 @@ function targetFor(item, file, config, mappings, ctx, pathOverride) {
 	if (item.type === "lib" && item.name === "utils") return resolveInsideReal(ctx.fs, ctx.cwd, `${aliasToDirectory(config.aliases.utils, mappings)}${extname(base)}`);
 	return resolveInsideReal(ctx.fs, ctx.cwd, join(directoryFor(item, config, mappings, ctx, pathOverride), base));
 }
+/**
+* Whether ui components written with `--path` need relative imports between them: they do when that directory is not the one the
+* `ui` alias names (the alias would point at a directory that does not hold them), or when the alias names no directory at all.
+*/
+function importsBetweenUiAreRelative(ctx, config, mappings, pathOverride) {
+	if (pathOverride === void 0) return false;
+	try {
+		return resolve(aliasToDirectory(config.aliases.ui, mappings)) !== resolve(ctx.cwd, pathOverride);
+	} catch (error) {
+		if (error instanceof PathError) return true;
+		throw error;
+	}
+}
 /** Builds the per-file plan for the items, reading what is on disk. */
 function planFiles(ctx, config, items, pathOverride, mappings = readPathMappings(ctx.fs, ctx.cwd)) {
 	const plans = [];
+	const relativeUi = importsBetweenUiAreRelative(ctx, config, mappings, pathOverride);
 	for (const item of items) for (const file of item.files) {
 		const raw = ctx.registry.readFile(file.path);
-		const content = file.path.endsWith(".css") ? raw : rewriteImports(raw, config.aliases);
+		const content = file.path.endsWith(".css") ? raw : rewriteImports(raw, config.aliases, { relativeUi: relativeUi && item.type === "ui" });
 		const target = targetFor(item, file, config, mappings, ctx, pathOverride);
 		const current = ctx.fs.read(target);
 		plans.push({
@@ -1823,8 +1878,7 @@ function runRemove(ctx, names, flags) {
 		return failed(ctx, error);
 	}
 }
-//#endregion
-//#region src/cli/completion.ts
+// src/cli/completion.ts
 /**
 * Shell completion scripts for the `shadow-ui` command. Each script is static text built from the
 * commands and flags it is given. It never calls back into the CLI, so it cannot complete
@@ -1935,8 +1989,7 @@ function fishScript(commands, flags) {
 		...flags.map((flag) => `complete -c shadow-ui -l ${flag}`)
 	].join("\n");
 }
-//#endregion
-//#region src/cli/main.ts
+// src/cli/main.ts
 /**
 * Argument parsing and dispatch for the `shadow-ui` command. `main` takes its context as a
 * parameter, so it is tested without spawning a process.
@@ -2169,8 +2222,43 @@ async function dispatch(ctx, command, rest, values, common) {
 		}
 	}
 }
-//#endregion
-//#region src/cli/registry-source.ts
+// src/cli/prompt.ts
+/**
+* The yes/no question of the executable, kept apart from `bin.ts` (which runs on import) so a test
+* can drive it with in-memory streams.
+* @packageDocumentation
+*/
+/**
+* Asks a yes/no question and resolves `true` only for `y` or `yes` (any case). An empty answer is
+* no, and so is the end of input (Ctrl-D, a closed pipe): readline never settles `question()` when
+* its input ends, which left Node to exit with code 13 ("unsettled top-level await").
+*
+* @param question The question, without the `(y/N)` suffix.
+* @param input The stream the answer is read from.
+* @param output The stream the question is written to.
+* @returns Whether the user said yes.
+* @example
+* const yes = await askYesNo("Install packages?", process.stdin, process.stdout);
+* @since 1.0.0
+*
+* @internal Not exported from `@shadow-js/ui`: part of the shadow-ui command, whose public surface is the CLI.
+*/
+async function askYesNo(question, input, output) {
+	const prompt = createInterface({
+		input,
+		output
+	});
+	try {
+		const answer = await new Promise((settle, fail) => {
+			prompt.once("close", () => settle(""));
+			prompt.question(`${question} (y/N) `).then(settle, fail);
+		});
+		return /^y(es)?$/i.test(answer.trim());
+	} finally {
+		prompt.close();
+	}
+}
+// src/cli/registry-source.ts
 /**
 * Where the CLI reads the registry from. The registry ships inside the package, so nothing is
 * downloaded: `registry.json` plus the files under `registry/` and `styles/`.
@@ -2243,8 +2331,7 @@ function loadRegistrySource(root = packageRoot()) {
 		return existsSync(file) ? readFileSync(file, "utf8") : void 0;
 	});
 }
-//#endregion
-//#region src/cli/bin.ts
+// src/cli/bin.ts
 /**
 * The `shadow-ui` executable: wires the real filesystem, terminal and package manager into
 * {@link main}. Kept tiny; everything testable lives in the other modules.
@@ -2254,21 +2341,12 @@ function realContext(cwd) {
 		cwd: resolve(cwd ?? process.cwd()),
 		fs: nodeFs(),
 		registry: loadRegistrySource(),
-		version: "1.0.0",
+		version: "1.0.2",
 		out: (line) => process.stdout.write(`${line}\n`),
 		err: (line) => process.stderr.write(`${line}\n`),
 		async confirm(question) {
 			if (!process.stdin.isTTY) return false;
-			const prompt = createInterface({
-				input: process.stdin,
-				output: process.stdout
-			});
-			try {
-				const answer = await prompt.question(`${question} (y/N) `);
-				return /^y(es)?$/i.test(answer.trim());
-			} finally {
-				prompt.close();
-			}
+			return askYesNo(question, process.stdin, process.stdout);
 		},
 		install: ({ cwd: directory, manager, packages, output }) => new Promise((done, reject) => {
 			const args = manager === "npm" ? ["install", ...packages] : ["add", ...packages];
@@ -2289,5 +2367,4 @@ function realContext(cwd) {
 const argv = process.argv.slice(2);
 if (wantsJson(argv)) installCrashHandlers(argv);
 process.exitCode = await main(argv, realContext);
-//#endregion
 export {};