@parity-app/cli 0.7.6 → 0.8.0

package/dist/{src-CMPL5C8p.mjs → src-XUZS4M-k.mjs}

@@ -1,7 +1,7 @@
 import { i as jsonText, o as parseData, r as finiteNumber, s as plainObject } from "./schema-Dp5Jhloe.mjs";
-import { B as packageManifest, P as collectCustomProperties, _ as renderSlotOf, c as isMadeValue, f as libraryManifestExtension, g as parseLibraryManifest, h as parseLibraryEdits, l as isSampleElement, o as applyLibraryEdits, u as isSampleRender, z as lengthToPixels } from "./src-BZFjMWhp.mjs";
-import { r as readLibraryEdits, s as parseJsonc } from "./src-CdMzjFSa.mjs";
-import { a as publishedVersions, n as packageFile, o as repositoryFiles, r as publishedSource } from "./published-CdXoUgfD.mjs";
+import { $ as lengthToPixels, C as isSampleRender, E as renderSlotOf, J as collectCustomProperties, O as valueImports, S as isSampleElement, f as parseLibraryEdits, l as libraryManifestExtension, o as applyLibraryEdits, p as parseLibraryManifest, tt as parseManifest, v as evaluateValue, x as isMadeValue, y as exportOf } from "./src-Ck9A-Gxr.mjs";
+import { r as readLibraryEdits, s as parseJsonc } from "./src-gCnKQqH5.mjs";
+import { a as publishedVersions, l as packageDocument, n as packageFile, o as repositoryFiles, r as publishedSource } from "./published-DYY8_8m9.mjs";
 import { createRequire } from "node:module";
 import { mkdir, readFile, readdir, realpath, rm, stat, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, posix, relative, resolve, sep } from "node:path";
@@ -86,6 +86,39 @@ function iconVariants(names, variants) {
 	});
 	return result;
 }
+/** Compares two strings by their UTF-16 code units, as `sort` does without a comparer. */
+function byCodeUnit(a, b) {
+	if (a < b) return -1;
+	return a > b ? 1 : 0;
+}
+/** Shorter names first, then by code unit: the order an icon's names are tried in for the one to insert. */
+function shorterName(a, b) {
+	return a.length - b.length || byCodeUnit(a, b);
+}
+/**
+* A set's icons, each once: the capitalised exports `drawable` accepts, grouped by the value they export, so aliases of
+* one icon (`Heart`, `HeartIcon`) are one group. Each keeps the shortest name the set's pattern matches, and every name
+* it's exported under in the module's order, so aliases the pattern leaves out (Hugeicons' `Gear` and `Cog` for
+* `Settings01Icon`) still find it. A group the pattern matches none of is left out.
+*/
+function iconAliases(module, icons, drawable) {
+	const pattern = icons?.match ? new RegExp(icons.match) : /^[A-Z]/;
+	const excluded = new Set(icons?.exclude);
+	const byValue = /* @__PURE__ */ new Map();
+	for (const [name, value] of Object.entries(module)) {
+		if (!/^[A-Z]/.test(name) || excluded.has(name) || !drawable(value, name)) continue;
+		const group = byValue.get(value);
+		if (group) group.push(name);
+		else byValue.set(value, [name]);
+	}
+	return [...byValue.values()].flatMap((names) => {
+		const name = names.filter((candidate) => pattern.test(candidate)).sort(shorterName)[0];
+		return name ? [{
+			name,
+			names
+		}] : [];
+	});
+}
 // ../code/src/checker.ts
 const probeName = "__parity_probe__.ts";
 const probeText = "import type { ReactNode } from \"react\"\nexport type ParityNode = ReactNode\n";
@@ -925,7 +958,7 @@ async function findPackage(from, name) {
 		const installedAt = join(folder, "node_modules", name);
 		const text = await readFile(join(installedAt, "package.json"), "utf8").catch(() => void 0);
 		if (text !== void 0) {
-			const manifest = readManifest(text, join(installedAt, "package.json"));
+			const manifest = parseManifest(text, join(installedAt, "package.json"));
 			return {
 				dir: await realpath(installedAt),
 				installedAt,
@@ -941,16 +974,9 @@ async function readPackage(dir) {
 	const text = await readFile(file, "utf8").catch(() => void 0);
 	return text === void 0 ? void 0 : {
 		dir,
-		manifest: readManifest(text, file)
+		manifest: parseManifest(text, file)
 	};
 }
-function readManifest(text, file) {
-	try {
-		return parseData(jsonText(packageManifest), text);
-	} catch (error) {
-		throw new TypeError(`${file}: ${error instanceof Error ? error.message : String(error)}`);
-	}
-}
 /** A bare specifier's package and the entry point in it: `@acme/ui/button` is `@acme/ui` and `./button`. */
 function splitSpecifier(specifier) {
 	const parts = specifier.split("/");
@@ -1156,6 +1182,14 @@ function isFile(path) {
 }
 // ../project/src/styles.ts
 /**
+* The parts of shadcn's `components.json` Parity reads: the app's stylesheet and the UI kit's import alias. It's
+* shadcn's file, so the rest passes through unchecked.
+*/
+const shadcnComponents = z.looseObject({
+	tailwind: z.looseObject({ css: z.string().optional() }).optional(),
+	aliases: z.looseObject({ ui: z.string().optional() }).optional()
+});
+/**
 * Where an app keeps its global styles when neither `components.json` nor the entry says: Vite's and Create React App's
 * `src/index.css`, the usual alternatives, and Next's `globals.css`, which its layout imports with no HTML entry.
 */
@@ -1178,8 +1212,8 @@ async function findStyles(root, notes = []) {
 }
 /** `findStyles`, with `components.json` already read. */
 async function stylesWith(root, shadcn, notes) {
-	const fromShadcn = field(shadcn, "tailwind", "css");
-	if (typeof fromShadcn === "string" && fromShadcn) {
+	const fromShadcn = shadcn?.tailwind?.css;
+	if (fromShadcn) {
 		notes.push(`styles from components.json: ${fromShadcn}`);
 		return {
 			styles: [toPosix(fromShadcn)],
@@ -1246,20 +1280,12 @@ async function shadcnConfig(root, notes) {
 	const text = await readText(join(root, "components.json"));
 	if (text === void 0) return void 0;
 	try {
-		return parseJsonc(text);
+		return parseData(shadcnComponents, parseJsonc(text));
 	} catch (error) {
 		notes.push(`Couldn't load components: ${error instanceof Error ? error.message : String(error)}`);
 		return;
 	}
 }
-function field(value, ...keys) {
-	let current = value;
-	for (const key of keys) {
-		if (typeof current !== "object" || current === null) return void 0;
-		current = current[key];
-	}
-	return current;
-}
 async function readText(path) {
 	return readFile(path, "utf8").catch(() => void 0);
 }
@@ -1297,7 +1323,15 @@ const skipped = /(?:^|\/)(?:node_modules|dist|build|__tests__|test|tests)\//;
 * says why, and generation goes on without them.
 */
 async function fetchExamples(pkg, packageDir, hints = {}, cacheRoot = join(homedir(), ".parity", "cache", "examples")) {
-	const upstream = await readUpstream(packageDir);
+	let upstream;
+	try {
+		upstream = await readUpstream(packageDir);
+	} catch (error) {
+		return {
+			files: [],
+			note: `Examples weren't read: ${message$1(error)}`
+		};
+	}
 	const repo = normalizeRepo(hints.repo ?? upstream?.repository ?? repositoryOf(pkg));
 	if (!repo) return {
 		files: [],
@@ -1335,11 +1369,20 @@ async function fetchExamples(pkg, packageDir, hints = {}, cacheRoot = join(homed
 		};
 	}
 }
+/** `upstream.json`, which a package built from another's source ships to say which repository and commit. */
+const upstreamFile = z.looseObject({
+	repository: z.string().optional(),
+	revision: z.string().optional()
+});
+/** The package's `upstream.json`, or nothing when it has none. Throws, naming the field, when it doesn't match. */
 async function readUpstream(packageDir) {
+	const file = join(packageDir, "upstream.json");
+	const text = await readFile(file, "utf8").catch(() => void 0);
+	if (text === void 0) return void 0;
 	try {
-		return JSON.parse(await readFile(join(packageDir, "upstream.json"), "utf8"));
-	} catch {
-		return;
+		return parseData(jsonText(upstreamFile), text);
+	} catch (error) {
+		throw new TypeError(`${file}: ${message$1(error)}`, { cause: error });
 	}
 }
 function repositoryOf(pkg) {
@@ -1417,16 +1460,15 @@ async function findCommit(repo, pkg, upstream, cacheRoot) {
 async function npmVersion(pkg) {
 	if (!pkg.name || !pkg.version) return void 0;
 	try {
-		const response = await fetch(`https://registry.npmjs.org/${pkg.name.replace("/", "%2F")}`, {
-			headers: { accept: "application/json" },
+		const document = await packageDocument(pkg.name, {
+			full: true,
 			signal: AbortSignal.timeout(3e4)
 		});
-		if (!response.ok) return void 0;
-		const packument = await response.json();
-		const gitHead = packument.versions?.[pkg.version]?.gitHead;
+		const gitHead = document.versions?.[pkg.version]?.gitHead;
+		const time = document.time?.[pkg.version];
 		return {
 			...gitHead ? { gitHead } : {},
-			...packument.time?.[pkg.version] ? { time: packument.time[pkg.version] } : {}
+			...typeof time === "string" ? { time } : {}
 		};
 	} catch {
 		return;
@@ -1575,7 +1617,7 @@ function methodCallsOn(files, sourceOf, pkg, reexported) {
 		const context = {
 			source,
 			resolve: () => void 0,
-			scope: declarations(source),
+			scope: declarations$1(source),
 			env: /* @__PURE__ */ new Map(),
 			...pkg ? { imports: packageImports(source, pkg, reexported) } : {}
 		};
@@ -1698,7 +1740,7 @@ function readSource(source, uses, base, family, setBy, pkg, imported = /* @__PUR
 	const context = {
 		source,
 		resolve,
-		scope: declarations(source),
+		scope: declarations$1(source),
 		env: /* @__PURE__ */ new Map(),
 		wrapping,
 		...pkg ? { imports: packageImports(source, pkg, reexported) } : {},
@@ -2094,7 +2136,7 @@ function bind(name, value, env) {
 	});
 }
 /** What each name a file declares is set to: `const x = ...`, and `const [x] = useState(...)`'s first value. */
-function declarations(source) {
+function declarations$1(source) {
 	const scope = /* @__PURE__ */ new Map();
 	const visit = (node) => {
 		if (ts.isVariableDeclaration(node) && node.initializer) {
@@ -2189,7 +2231,7 @@ function exampleItem(files, values) {
 		const item = hookItem(source, values, {
 			source,
 			resolve: () => void 0,
-			scope: declarations(source),
+			scope: declarations$1(source),
 			env: /* @__PURE__ */ new Map()
 		});
 		if (item && Object.keys(item).length > Object.keys(best ?? {}).length) best = item;
@@ -2801,16 +2843,15 @@ function preferredExports(typesFile, groups, usable) {
 			declared: target.name === symbol.name
 		});
 	}
-	const shortest = (a, b) => a.length - b.length || byCodeUnit$1(a, b);
 	const preferred = [];
 	for (const group of groups) {
 		const names = group.filter(usable);
-		const fallback = [...names].sort(shortest)[0];
+		const fallback = [...names].sort(shorterName)[0];
 		const rank = (name) => {
 			const mark = marks.get(name);
 			return (mark?.deprecated ? 2 : 0) + (mark?.declared === false ? 1 : 0);
 		};
-		const best = [...names].sort((a, b) => rank(a) - rank(b) || shortest(a, b))[0];
+		const best = [...names].sort((a, b) => rank(a) - rank(b) || shorterName(a, b))[0];
 		if (best && best !== fallback) preferred.push(best);
 	}
 	return preferred.sort();
@@ -2823,11 +2864,6 @@ function typesFor(specifier, from) {
 	}, ts.sys).resolvedModule?.resolvedFileName;
 	return resolved && /\.d\.[cm]?ts$/.test(resolved) ? resolved : void 0;
 }
-/** Compares two strings by their UTF-16 code units, as `sort` does without a comparer. */
-function byCodeUnit$1(a, b) {
-	if (a < b) return -1;
-	return a > b ? 1 : 0;
-}
 // ../libgen/src/icon-styles.ts
 /** How many of a set's icons are drawn from each module to tell its styles apart. */
 const sampled = 5;
@@ -3183,6 +3219,7 @@ async function relateParts(load, specifier, components, providers = [], edits =
 		note: "Parts weren't tried: React's server renderer wasn't found."
 	};
 	const byName = new Map(components.map((component) => [component.name, component]));
+	const host = await trialHost(load, [...valueImports(providers.map((provider) => provider.props)), ...valueImports([...examples.values()].map((use) => use.sample), "sample")]);
 	const wrappers = [];
 	for (const provider of providers) {
 		byName.delete(provider.component);
@@ -3191,7 +3228,7 @@ async function relateParts(load, specifier, components, providers = [], edits =
 			for (const part of provider.component.split(".")) found = found?.[part];
 			if (found) wrappers.push({
 				type: found,
-				props: await trialValue(load, provider.props ?? {})
+				props: evaluateValue(provider.props ?? {}, host)
 			});
 		} catch {}
 	}
@@ -3229,7 +3266,7 @@ async function relateParts(load, specifier, components, providers = [], edits =
 	for (const use of examples.values()) for (const call of callsIn(use.sample)) {
 		const key = JSON.stringify(call);
 		if (!byCall.has(key)) try {
-			byCall.set(key, await trialValue(load, call));
+			byCall.set(key, evaluateValue(call, host, "sample"));
 		} catch {
 			byCall.set(key, void 0);
 		}
@@ -4020,48 +4057,28 @@ function spelledOut(children, name) {
 	}
 }
 /**
-* A decorator's value outside a frame, for trying parts on the server: imports and calls are made, a mode's value is
-* its default, and the frame's own nodes are left undefined, as there's no frame. Direction and language take the
-* frame's defaults.
+* What values are worked out against outside a frame, for trying parts on the server: the modules they import, loaded
+* first, since evaluating is synchronous, a mode's value is its default, and the frame's own nodes are undefined, as there's no frame. Direction and
+* language take the frame's defaults. A module Node loads as CommonJS without a `default` is its own default export.
 */
-async function trialValue(load, value) {
-	if (Array.isArray(value)) return Promise.all(value.map((item) => trialValue(load, item)));
-	if (typeof value !== "object" || value === null) return value;
-	const record = value;
-	if (typeof record.$import === "string") return exported(await load(record.$import), String(record.export ?? "default"));
-	if (typeof record.$call === "object" && record.$call !== null) {
-		const call = record.$call;
-		const fn = exported(await load(call.import), call.export ?? "default");
-		const args = await trialValue(load, record.args ?? []);
-		if (typeof fn !== "function") return void 0;
-		const made = fn(...args);
-		for (const step of record.methods ?? []) {
-			const method = made?.[step.method];
-			if (typeof method !== "function") continue;
-			const args = await trialValue(load, step.args ?? []);
-			try {
-				method.apply(made, args);
-			} catch {}
-		}
-		return made;
-	}
-	if (typeof record.$global === "string") return trialValue(load, record.default);
-	if (typeof record.$frame === "string") {
-		if (record.$frame === "dir") return "ltr";
-		return record.$frame === "lang" ? "en-US" : void 0;
-	}
-	if ("$function" in record) {
-		const result = await trialValue(load, record.$function);
-		return () => result;
-	}
-	const resolved = {};
-	for (const [key, item] of Object.entries(record)) resolved[key] = await trialValue(load, item);
-	return resolved;
-}
-function exported(module, name) {
-	let found = module;
-	for (const part of name.split(".")) found = found?.[part];
-	return found ?? (name === "default" ? module : void 0);
+async function trialHost(load, imports) {
+	const modules = /* @__PURE__ */ new Map();
+	for (const specifier of new Set(imports)) try {
+		modules.set(specifier, await load(specifier));
+	} catch {}
+	return {
+		exported(specifier, path) {
+			const module = modules.get(specifier);
+			if (!module) throw new Error(`${specifier} isn't loaded`);
+			return exportOf(module, path) ?? (path === "default" ? module : void 0);
+		},
+		global: () => void 0,
+		frame: (part) => ({
+			dir: "ltr",
+			lang: "en-US"
+		})[part],
+		made: /* @__PURE__ */ new Map()
+	};
 }
 /** The parts the package puts inside another, as sample children, keeping only those it exports. */
 function exportedChildren(children, names) {
@@ -4079,6 +4096,38 @@ function componentsIn(children) {
 	return children.flatMap((child) => typeof child === "object" && "component" in child ? [child.component, ...componentsIn(child.children ?? [])] : []);
 }
 // ../libgen/src/presets.ts
+/** A function, which a theme object's schema can only check is one. */
+const callable = z.custom((value) => typeof value === "function", "expected a function");
+/** Custom properties by name, as a stylesheet object holds them. */
+const declarations = z.record(z.string(), z.unknown());
+/** What libgen reads of MUI: `createTheme`, and the stylesheets and theme it makes. */
+const muiStyles = z.looseObject({ createTheme: callable });
+const muiVariablesTheme = z.looseObject({ generateStyleSheets: callable });
+const muiStyleSheets = z.array(z.record(z.string(), declarations));
+const muiPlainTheme = z.looseObject({
+	breakpoints: z.looseObject({ values: z.record(z.string(), z.number()) }),
+	typography: z.record(z.string(), z.unknown())
+});
+/** A typography variant; the theme's other entries, such as `pxToRem` and `fontSize`, aren't objects. */
+const muiVariant = z.looseObject({
+	fontSize: z.unknown(),
+	lineHeight: z.unknown()
+});
+/** What libgen reads of Chakra: its default system's token stylesheet. */
+const chakraModule = z.looseObject({ defaultSystem: z.looseObject({ getTokenCss: callable }) });
+/** What libgen reads of Fluent: each theme's tokens, where it exports them. */
+const fluentTheme = z.record(z.string(), z.union([z.string(), z.number()])).optional();
+/**
+* Checks a theme object libgen reads by running the library, so a change in the library names the field it moved,
+* as `MUI's createTheme(): /breakpoints/values/sm: expected a number`.
+*/
+function readTheme(what, schema, value) {
+	try {
+		return parseData(schema, value);
+	} catch (error) {
+		throw new TypeError(`${what}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+	}
+}
 const createTheme = {
 	import: "@mui/material/styles",
 	export: "createTheme"
@@ -4246,18 +4295,20 @@ const presets = {
 			} }
 		],
 		async theme(load) {
-			const make = (await load("@mui/material/styles")).createTheme;
-			const theme = make({
+			const { createTheme } = readTheme("@mui/material/styles", muiStyles, await load("@mui/material/styles"));
+			const make = createTheme;
+			const theme = readTheme("MUI's createTheme()", muiVariablesTheme, make({
 				cssVariables: { colorSchemeSelector: "class" },
 				colorSchemes: {
 					light: true,
 					dark: true
 				}
-			});
+			}));
+			const sheets = readTheme("MUI's generateStyleSheets()", muiStyleSheets, theme.generateStyleSheets());
 			const tokens = /* @__PURE__ */ new Map();
-			for (const sheet of theme.generateStyleSheets()) for (const [selector, declarations] of Object.entries(sheet)) {
+			for (const sheet of sheets) for (const [selector, properties] of Object.entries(sheet)) {
 				const context = /\bdark\b/.test(selector) ? "dark" : "default";
-				for (const [name, value] of Object.entries(declarations)) {
+				for (const [name, value] of Object.entries(properties)) {
 					if (!name.startsWith("--") || typeof value !== "string" && typeof value !== "number") continue;
 					const property = name.slice(2);
 					if (/Channel$|Opacity$/.test(property)) continue;
@@ -4276,7 +4327,7 @@ const presets = {
 				category: "spacing",
 				values: { default: unit }
 			});
-			const plain = make({});
+			const plain = readTheme("MUI's createTheme()", muiPlainTheme, make({}));
 			const breakpoints = plain.breakpoints.values;
 			for (const [id, width] of Object.entries(breakpoints)) if (width > 0) tokens.set(`mui-breakpoint-${id}`, {
 				var: `mui-breakpoint-${id}`,
@@ -4284,7 +4335,9 @@ const presets = {
 				values: { default: `${width}px` }
 			});
 			for (const [variant, style] of Object.entries(plain.typography)) {
-				const { fontSize, lineHeight } = style ?? {};
+				const read = muiVariant.safeParse(style);
+				if (!read.success) continue;
+				const { fontSize, lineHeight } = read.data;
 				if (typeof fontSize !== "string") continue;
 				const size = `mui-font-size-${variant}`;
 				const leading = `mui-line-height-${variant}`;
@@ -4355,7 +4408,7 @@ const presets = {
 		],
 		notes: ["Chakra's Toaster is a snippet the app generates (`npx @chakra-ui/cli snippet add toaster`), not an export."],
 		async theme(load) {
-			const system = (await load("@chakra-ui/react")).defaultSystem;
+			const system = readTheme("@chakra-ui/react", chakraModule, await load("@chakra-ui/react")).defaultSystem;
 			const tokens = /* @__PURE__ */ new Map();
 			const visit = (styles, context) => {
 				if (typeof styles !== "object" || styles === null) return;
@@ -4370,7 +4423,7 @@ const presets = {
 					tokens.set(property, token);
 				} else visit(value, /\bdark\b/.test(key) ? "dark" : context);
 			};
-			visit(system.getTokenCss(), "default");
+			visit(readTheme("Chakra's getTokenCss()", declarations, system.getTokenCss()), "default");
 			const unit = tokens.get("chakra-spacing-1")?.values.default;
 			if (unit) tokens.set("spacing", {
 				var: "spacing",
@@ -4452,7 +4505,7 @@ const presets = {
 			const fluent = await load("@fluentui/tokens");
 			const tokens = /* @__PURE__ */ new Map();
 			for (const [context, name] of Object.entries(fluentThemes)) {
-				const theme = fluent[name];
+				const theme = readTheme(`@fluentui/tokens' ${name}`, fluentTheme, fluent[name]);
 				if (!theme) continue;
 				for (const [property, value] of Object.entries(theme)) {
 					const token = tokens.get(property) ?? {
@@ -5032,7 +5085,8 @@ async function describePackage(options, importName) {
 async function reviseLibrary(generated, options) {
 	const manifest = { ...generated.manifest };
 	const report = { ...generated.report };
-	const previous = previousComponents(options.previous);
+	const read = readPrevious(options.previous);
+	const previous = read?.manifest.components?.list;
 	const components = manifest.components;
 	if (previous && components) {
 		report.changes = compareComponents(previous, components.list);
@@ -5041,7 +5095,7 @@ async function reviseLibrary(generated, options) {
 			list: selectComponents(previous, components.list, report.changes, options.only ?? "all")
 		};
 	}
-	const kept = options.previous?.edits;
+	const kept = read?.file.edits;
 	const edits = options.edits ?? kept;
 	if (edits !== void 0) {
 		manifest.edits = edits;
@@ -5054,12 +5108,21 @@ async function reviseLibrary(generated, options) {
 		report
 	};
 }
-function previousComponents(previous) {
-	if (typeof previous !== "object" || previous === null) return void 0;
+/**
+* The library file being regenerated, read through the library schema (PAR-594), and the file's own object, whose
+* edits and authored fields are kept as written. One that doesn't read stops generation, naming the field, since
+* writing over it would lose what a person wrote there.
+*/
+function readPrevious(previous) {
+	if (previous === void 0) return void 0;
 	try {
-		return parseLibraryManifest(previous).components?.list;
-	} catch {
-		return;
+		return {
+			manifest: parseLibraryManifest(previous),
+			file: parseData(plainObject, previous)
+		};
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		throw new TypeError(`The library file being replaced doesn't read, so fix or delete it first: ${reason}`, { cause: error });
 	}
 }
 /**
@@ -5200,8 +5263,8 @@ async function appManifestPath(root) {
 * what a person wrote (the canvas, decorators, a name or description) stays.
 */
 function mergeManifest(existing, generated) {
-	if (typeof existing !== "object" || existing === null) return generated;
-	const kept = existing;
+	const kept = readPrevious(existing)?.file;
+	if (!kept) return generated;
 	const authored = [
 		"$schema",
 		"id",
@@ -5254,6 +5317,8 @@ function defaultRange(version) {
 	const [major = "0", minor = "0"] = version.split(/[.-]/);
 	return major === "0" ? `^0.${minor}.0` : `^${major}.0.0`;
 }
+/** A DTCG token file or resolver: a JSON object, with a resolver's `resolutionOrder` a list. */
+const tokenFile = jsonText(plainObject.pipe(z.looseObject({ resolutionOrder: z.array(z.unknown()).optional() })));
 /** A DTCG token file the package ships, if it has one in the format; Buildkit's `tokens.json` isn't yet. */
 async function dtcgIn(dir) {
 	for (const candidate of [
@@ -5264,13 +5329,11 @@ async function dtcgIn(dir) {
 	]) {
 		const text = await readFile(join(dir, candidate), "utf8").catch(() => void 0);
 		if (!text) continue;
-		try {
-			const parsed = JSON.parse(text);
-			if (Array.isArray(parsed.resolutionOrder) || /"\$value"\s*:/.test(text)) return {
-				path: candidate,
-				tokens: parsed
-			};
-		} catch {}
+		const parsed = tokenFile.safeParse(text).data;
+		if (parsed && (parsed.resolutionOrder !== void 0 || /"\$value"\s*:/.test(text))) return {
+			path: candidate,
+			tokens: parsed
+		};
 	}
 }
 /** The prefix most custom properties share, as in `mantine-`, which token paths leave out. */
@@ -5290,23 +5353,8 @@ function commonPrefix(names) {
 */
 async function exportedIcons(load, specifier, icons) {
 	const module = await load(specifier).catch(() => ({}));
-	const pattern = icons.match ? new RegExp(icons.match) : /^[A-Z]/;
-	const excluded = new Set(icons.exclude);
 	const drawable = (value) => icons.render !== "export" ? value !== void 0 && typeof value !== "function" : typeof value === "function" || typeof value === "object" && value !== null && "$$typeof" in value;
-	const byValue = /* @__PURE__ */ new Map();
-	for (const [key, value] of Object.entries(module)) {
-		if (!/^[A-Z]/.test(key) || excluded.has(key) || !drawable(value)) continue;
-		const names = byValue.get(value);
-		if (names) names.push(key);
-		else byValue.set(value, [key]);
-	}
-	const kept = [...byValue.values()].flatMap((names) => {
-		const name = names.filter((candidate) => pattern.test(candidate)).sort((a, b) => a.length - b.length || byCodeUnit(a, b))[0];
-		return name ? [{
-			name,
-			names
-		}] : [];
-	});
+	const kept = iconAliases(module, icons, drawable);
 	const read = icons.variants?.pattern ? iconVariants(kept.map(({ name }) => name), icons.variants) : void 0;
 	const byLabel = /* @__PURE__ */ new Map();
 	for (const { name, names } of kept) {
@@ -5324,11 +5372,6 @@ async function exportedIcons(load, specifier, icons) {
 		groups: kept.map(({ names }) => names)
 	};
 }
-/** Compares two strings by their UTF-16 code units, as `sort` does without a comparer. */
-function byCodeUnit(a, b) {
-	if (a < b) return -1;
-	return a > b ? 1 : 0;
-}
 /** Draws an icon with the project's own React, to tell a set's styles apart; nothing draws where React can't load. */
 async function iconDrawer(load) {
 	try {
@@ -5388,4 +5431,4 @@ async function resolveImport(from, specifier) {
 	const installed = await findPackage(from, name);
 	return installed && packageEntry(installed, "runtime", subpath);
 }
-export { appManifestPath, generateLibrary, manifestText, mergeManifest, parseLibraryEdits, reviseLibrary, iconVariants as t };
+export { appManifestPath, generateLibrary, shorterName as i, manifestText, mergeManifest, iconAliases as n, parseLibraryEdits, iconVariants as r, reviseLibrary, byCodeUnit as t };

package/dist/{src-DHuMBGiB.mjs → src-ZsXhzNYa.mjs}

@@ -1 +1 @@
-export { t as covers, n as newestEntries, i as registryDir, a as registryEntries } from "./src-CdMzjFSa.mjs";
+export { t as covers, n as newestEntries, i as registryDir, a as registryEntries } from "./src-gCnKQqH5.mjs";

package/dist/{src-CdMzjFSa.mjs → src-gCnKQqH5.mjs}

@@ -1,5 +1,5 @@
 import { n as fileObject, o as parseData } from "./schema-Dp5Jhloe.mjs";
-import { d as libraryManifest, f as libraryManifestExtension, h as parseLibraryEdits, o as applyLibraryEdits, p as libraryPackage } from "./src-BZFjMWhp.mjs";
+import { c as libraryManifest, f as parseLibraryEdits, l as libraryManifestExtension, o as applyLibraryEdits, u as libraryPackage } from "./src-Ck9A-Gxr.mjs";
 import { createRequire } from "node:module";
 import { readFile, readdir } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity-app/cli",
-  "version": "0.7.6",
+  "version": "0.8.0",
   "license": "MIT",
   "type": "module",
   "description": "Drive the Parity app from a terminal or an agent: read state, run edits, take screenshots, serve MCP.",

package/skills/execute.md

@@ -99,6 +99,15 @@ Overlaps(design?): Overlap[]
 Print(...values): void
 ```
 
+Every function checks its arguments before it does anything. A wrong one fails the call with an `invalid_input` error
+whose path names it, and the message starts with that path:
+
+- An option or field by its key: `width`, `style/gap`, `changes/title/text`.
+- A node by `node` (or `root` in `CreateDesign`) and where in it: `node/fontSize: unknown property`.
+- Any other argument by its name: `design`, `path`, `patch`, `nodes`.
+
+An option a function doesn't take is an error too, so check its spelling against the list above.
+
 ## Paths
 
 A design is named by its id or its name. A node is named by `design/node`, where `node` is the node's id or its name, or

package/dist/src-CbLrA8BA.mjs

@@ -1,5 +0,0 @@
-import "./schema-Dp5Jhloe.mjs";
-import "./client-BkLeG26A.mjs";
-export { t as componentNode, M as generateId, n as librarySource, i as withLibraryContext } from "./src-BZFjMWhp.mjs";
-import "./src-CdMzjFSa.mjs";
-import "./src-CMPL5C8p.mjs";