@parity-app/cli 0.6.2 → 0.7.0

package/dist/bin.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { a as CodedError, c as errorDetails, l as readErrorDetails, o as closest, s as errorCodes } from "./schema-zRNxotYl.mjs";
-import { a as describeExec, c as describeProps, f as setCaller, i as describeConsole, l as describeStatus, n as describeAccessibility, o as describeModes, p as mcpCallerName, r as describeComponents, s as describeProblems, t as call, u as describeTokens } from "./client-BUaE9b77.mjs";
+import { c as closest, d as readErrorDetails, l as errorCodes, s as CodedError, u as errorDetails } from "./schema-DcQLoUPP.mjs";
+import { a as describeExec, c as describeProps, f as setCaller, i as describeConsole, l as describeStatus, n as describeAccessibility, o as describeModes, p as mcpCallerName, r as describeComponents, s as describeProblems, t as call, u as describeTokens } from "./client-D5kbiMmn.mjs";
 import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
 import { dirname, join, normalize, relative, resolve, sep } from "node:path";
 import { parseArgs } from "node:util";
@@ -387,16 +387,11 @@ const executeOperation = {
 */
 async function runCheck(library, options) {
 	if (!library) throw new Error("parity lib check <library> [--tab t] [--mode m]");
-	const { applyLibraryEdits, componentNode, generateId, librarySource, parseLibraryEdits, withLibraryContext } = await import("./src-BgQ7gnXE.mjs");
-	const { registryDir, registryEntries } = await import("./src-CiqdFzei.mjs");
-	const entry = (await registryEntries()).find((item) => item.manifest.id === library);
+	const { componentNode, generateId, librarySource, withLibraryContext } = await import("./src-BaOpaXkV.mjs");
+	const { newestEntries, registryDir } = await import("./src-vUHtM2X4.mjs");
+	const entry = (await newestEntries()).find((item) => item.manifest.id === library);
 	if (!entry) throw new Error(`The registry has no library "${library}"`);
-	let manifest = entry.manifest;
-	if (manifest.edits) {
-		const edits = typeof manifest.edits === "string" ? parseLibraryEdits(JSON.parse(await readFile(join(dirname(entry.path), manifest.edits), "utf8"))) : manifest.edits;
-		manifest = applyLibraryEdits(manifest, edits).manifest;
-	}
-	const list = manifest.components?.list ?? {};
+	const list = entry.manifest.components?.list ?? {};
 	const names = Object.keys(list).filter((name) => list[name].visual !== false);
 	const id = (name) => `${library}/${name}`;
 	const sources = Object.fromEntries(Object.keys(list).map((name) => [id(name), {
@@ -516,8 +511,8 @@ function describeCheck(report) {
 * because it reads the project's files and its own copy of TypeScript.
 */
 async function runLib(packageName, options) {
-	const { appManifestPath, generateLibrary, manifestText, mergeManifest, reviseLibrary } = await import("./src-BvKhu6dX.mjs");
-	const { covers, registryDir, registryEntries } = await import("./src-CiqdFzei.mjs");
+	const { appManifestPath, generateLibrary, manifestText, mergeManifest, reviseLibrary } = await import("./src-x0VQ8I6l.mjs");
+	const { covers, registryDir, registryEntries } = await import("./src-vUHtM2X4.mjs");
 	const spec = packageName === void 0 ? void 0 : packageSpec(packageName);
 	let root = resolve(options.root ?? ".");
 	if (spec && (spec.version !== void 0 || options.registry && !options.root)) {
@@ -528,7 +523,7 @@ async function runLib(packageName, options) {
 		console.error(`Installing ${spec.name} ${version} on its own…`);
 		root = await installedVersion(spec.name, version);
 	}
-	const { parseLibraryEdits } = await import("./src-BvKhu6dX.mjs");
+	const { parseLibraryEdits } = await import("./src-x0VQ8I6l.mjs");
 	const trialEdits = options.edits ? parseLibraryEdits(JSON.parse(await readFile(resolve(options.edits), "utf8"))) : void 0;
 	const recordedId = options.registry && spec ? options.id ?? (await registryEntries()).find((entry) => entry.manifest.package?.name === spec.name)?.manifest.id : void 0;
 	const appErrors = recordedId ? await readAppErrors(registryDir(), recordedId) : void 0;
@@ -948,11 +943,15 @@ const stateSchema = object({
 	},
 	modes: {
 		type: "array",
+		description: "The project's modes, primary first.",
 		items: object({
 			id: string,
 			name: string,
 			width: { type: "number" },
-			primary: boolean_
+			primary: {
+				...boolean_,
+				description: "The project's first mode: every design's main frame unless it picks another. Only one is."
+			}
 		})
 	},
 	components: strings,

package/dist/{client-BUaE9b77.mjs → client-D5kbiMmn.mjs}

@@ -1,4 +1,4 @@
-import { a as CodedError, l as readErrorDetails, n as jsonText, r as nonBlankString, u as unknownReference } from "./schema-zRNxotYl.mjs";
+import { d as readErrorDetails, f as unknownReference, i as nonBlankString, r as jsonText, s as CodedError } from "./schema-DcQLoUPP.mjs";
 import { join } from "node:path";
 import { randomUUID } from "node:crypto";
 import { readFileSync, readdirSync, realpathSync, rmSync } from "node:fs";

package/dist/index.mjs

@@ -1 +1 @@
-export { t as call, n as describeAccessibility, r as describeComponents, i as describeConsole, a as describeExec, o as describeModes, s as describeProblems, c as describeProps, l as describeStatus, u as describeTokens, d as registry, f as setCaller } from "./client-BUaE9b77.mjs";
+export { t as call, n as describeAccessibility, r as describeComponents, i as describeConsole, a as describeExec, o as describeModes, s as describeProblems, c as describeProps, l as describeStatus, u as describeTokens, d as registry, f as setCaller } from "./client-D5kbiMmn.mjs";

package/dist/schema-DcQLoUPP.mjs

@@ -0,0 +1,239 @@
+import { z } from "zod";
+// ../core/src/errors.ts
+/**
+* Why an agent's call failed, as a stable code it can act on without reading the message. The CLI and MCP publish
+* these; the app throws them where it knows the cause.
+*/
+const errorCodes = [
+	"invalid_input",
+	"not_running",
+	"not_answering",
+	"unknown_tab",
+	"tab_not_ready",
+	"unknown_design",
+	"unknown_node",
+	"ambiguous_reference",
+	"unknown_state",
+	"unknown_mode",
+	"unknown_viewport",
+	"unknown_component",
+	"unknown_icon_set",
+	"unknown_edit_id",
+	"conflict",
+	"execution_failed",
+	"app_error"
+];
+/** Details as another process sends them. Each field that's malformed falls back on its own; only the code must hold. */
+const errorDetailsSchema = z.object({
+	code: z.enum(errorCodes),
+	/** Whether sending the same request again, unchanged, can succeed. */
+	retryable: z.boolean().catch(false),
+	/** The request field at fault, as a path: `design`, `state`, `edits/0/find`. */
+	field: z.string().min(1).optional().catch(void 0),
+	/** Valid references to use instead of an unknown or ambiguous one, at most `alternativeLimit` of them. */
+	alternatives: z.array(z.unknown()).transform((items) => items.filter((item) => typeof item === "string").slice(0, 20)).optional().catch(void 0)
+});
+/** An error with a stable code, the field it's about and what to use instead. */
+var CodedError = class extends Error {
+	details;
+	constructor(message, details) {
+		super(message);
+		this.name = "CodedError";
+		this.details = {
+			...details,
+			retryable: details.retryable ?? false
+		};
+	}
+};
+/** An unknown reference, naming the valid ones closest to what was asked for, up to `alternativeLimit`. */
+function unknownReference(code, message, reference, candidates, field) {
+	return new CodedError(message, {
+		code,
+		...field === void 0 ? {} : { field },
+		alternatives: closest(reference, candidates)
+	});
+}
+/**
+* Candidates sharing text with the reference first, ignoring case, then the rest by how few single-character edits
+* away they are, so a typo's intended id makes the cut; ties keep their own order. All of them when they fit.
+*/
+function closest(reference, candidates, limit = 20) {
+	const unique = [...new Set(candidates)];
+	if (unique.length <= limit) return unique;
+	const wanted = reference.toLowerCase();
+	const ranked = unique.map((candidate, index) => {
+		const lower = candidate.toLowerCase();
+		const near = wanted.length > 0 && (lower.includes(wanted) || wanted.includes(lower));
+		return {
+			candidate,
+			index,
+			near: near ? 0 : 1,
+			distance: near ? 0 : editDistance(wanted, lower)
+		};
+	});
+	ranked.sort((a, b) => a.near - b.near || a.distance - b.distance || a.index - b.index);
+	return ranked.slice(0, limit).map(({ candidate }) => candidate);
+}
+/** How many single-character insertions, deletions or substitutions turn one string into the other. */
+function editDistance(a, b) {
+	let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+	for (let i = 1; i <= a.length; i++) {
+		const row = [i];
+		for (let j = 1; j <= b.length; j++) row[j] = Math.min(previous[j] + 1, row[j - 1] + 1, previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+		previous = row;
+	}
+	return previous[b.length];
+}
+/** A thrown value's details, when it carries them. */
+function errorDetails(error) {
+	return error instanceof CodedError ? error.details : void 0;
+}
+/** Details that came from another process, checked before they're trusted. Anything malformed reads as none. */
+function readErrorDetails(value) {
+	return errorDetailsSchema.safeParse(value).data;
+}
+// ../core/src/schema.ts
+/**
+* Checks for data Parity didn't make (PAR-578): files, agent input, environment variables, other programs' JSON. A zod
+* schema is both the check and the type. A failed check reads as core's hand-written ones in `validate.ts` do: a JSON
+* pointer to the value at fault, then what was expected there, as in `/containers/0/name: expected a string`.
+*/
+/** An object with string keys, and not an array or null. */
+const plainObject = z.record(z.string(), z.unknown());
+/** Text with something besides whitespace, trimmed. */
+const nonBlankString = z.string().trim().min(1, "can't be blank");
+/** A number other than NaN or ±Infinity, which zod 4 refuses on its own. */
+const finiteNumber = z.number();
+/**
+* An object in a file Parity owns, such as a `.par`. A key it doesn't know is an error, and a key set to `undefined` is
+* left out, as JSON leaves it out, so what the window saves from memory reads as it would from the file.
+*/
+function fileObject(shape) {
+	return z.strictObject(shape).overwrite(withoutUnset);
+}
+/** Zod's own copy of an object, without the keys whose values are `undefined`. */
+function withoutUnset(value) {
+	for (const [key, entry] of Object.entries(value)) if (entry === void 0) Reflect.deleteProperty(value, key);
+	return value;
+}
+/** JSON text holding what `schema` checks. Text that isn't JSON fails as `expected JSON`. */
+function jsonText(schema) {
+	return z.string().transform((text, context) => {
+		try {
+			return JSON.parse(text);
+		} catch {
+			context.addIssue({
+				code: "custom",
+				message: "expected JSON"
+			});
+			return z.NEVER;
+		}
+	}).pipe(schema);
+}
+/**
+* Checks data Parity didn't make and returns what the schema reads from it, or throws `TypeError` with the first
+* problem as `/json/pointer: message`. `at` is where the value sits in a larger one, so its pointers start there.
+*/
+function parseData(schema, value, at = "") {
+	const result = schema.safeParse(value, { error: issueText });
+	if (result.success) return result.data;
+	const { pointer, message } = firstProblem(result.error.issues, at);
+	throw new TypeError(`${pointer || "/"}: ${message}`);
+}
+/** A path inside a value as a JSON pointer (RFC 6901): `/edits/0/find`, or `` for the value itself. */
+function jsonPointer(path) {
+	return path.map((key) => `/${String(key).replaceAll("~", "~0").replaceAll("/", "~1")}`).join("");
+}
+/**
+* The problem to report from a failed check: its first issue. An unknown property points at that property. A union
+* that no option matched reports the option that came closest, or every type it takes when none got past the value's
+* type. An option for another type of value isn't close, so `{ size: "big" }` against a string or an object with a
+* numeric size reports the size, however many issues the object has.
+*/
+function firstProblem(issues, at) {
+	const [issue] = issues;
+	if (!issue) return {
+		pointer: at,
+		message: "isn't valid"
+	};
+	const pointer = at + jsonPointer(issue.path);
+	if (issue.code === "unrecognized_keys") return {
+		pointer: pointer + jsonPointer(issue.keys.slice(0, 1)),
+		message: issue.message
+	};
+	if (issue.code === "invalid_union" && issue.errors.length > 0) return unionProblem(issue.errors, pointer);
+	return {
+		pointer,
+		message: issue.message
+	};
+}
+function unionProblem(options, pointer) {
+	const issues = options.flat();
+	const shallow = issues.every((issue) => issue.path.length === 0);
+	const expected = issues.map(expectation);
+	if (shallow && expected.every((text) => text !== void 0)) return {
+		pointer,
+		message: `expected ${[...new Set(expected)].join(" or ")}`
+	};
+	const depth = (option) => option[0]?.path.length ?? 0;
+	const typed = options.filter((option) => !refusesType(option));
+	return firstProblem((typed.length > 0 ? typed : options).reduce((best, option) => option.length < best.length || option.length === best.length && depth(option) > depth(best) ? option : best), pointer);
+}
+/** Whether a union's option failed on the value's type itself, as a string option does for an object. */
+function refusesType(option) {
+	const [first] = option;
+	return first?.code === "invalid_type" && first.path.length === 0;
+}
+/** What one type or value check wanted, as `a string` or `"row"`; nothing for other checks. */
+function expectation(issue) {
+	if (issue.code === "invalid_type") return typeName(issue.expected);
+	if (issue.code === "invalid_value") return issue.values.map(literal).join(" or ");
+}
+/** Zod's issues in `validate.ts`'s words. Messages a schema gives itself win, and anything else keeps zod's own. */
+function issueText(issue) {
+	switch (issue.code) {
+		case "invalid_type": return `expected ${typeName(issue.expected)}`;
+		case "invalid_value": return issue.values.length === 1 ? `expected ${literal(issue.values[0])}` : `expected one of ${issue.values.map(literal).join(", ")}`;
+		case "unrecognized_keys": return "unknown property";
+		case "invalid_union": {
+			const options = "options" in issue ? issue.options : void 0;
+			return Array.isArray(options) && options.length > 0 ? `expected one of ${options.map(literal).join(", ")}` : void 0;
+		}
+		case "too_small": return bound("at least", "more than", issue.origin, issue.minimum, issue.inclusive);
+		case "too_big": return bound("at most", "less than", issue.origin, issue.maximum, issue.inclusive);
+		default: return;
+	}
+}
+const typeNames = {
+	array: "an array",
+	boolean: "true or false",
+	int: "a whole number",
+	number: "a number",
+	object: "an object",
+	record: "an object",
+	string: "a string",
+	tuple: "an array"
+};
+function typeName(expected) {
+	return typeNames[expected] ?? expected;
+}
+function literal(value) {
+	return typeof value === "string" ? JSON.stringify(value) : String(value);
+}
+const units = {
+	string: "character",
+	array: "item",
+	set: "item"
+};
+/** A size or range check's limit, as `expected at least 1 item` or `expected less than 10`. */
+function bound(inclusiveWords, exclusiveWords, origin, limit, inclusive = true) {
+	const words = inclusive ? inclusiveWords : exclusiveWords;
+	const unit = units[origin];
+	if (unit) return `expected ${words} ${limit} ${unit}${Number(limit) === 1 ? "" : "s"}`;
+	return [
+		"number",
+		"int",
+		"bigint"
+	].includes(origin) ? `expected ${words} ${limit}` : void 0;
+}
+export { parseData as a, closest as c, readErrorDetails as d, unknownReference as f, nonBlankString as i, errorCodes as l, finiteNumber as n, plainObject as o, jsonText as r, CodedError as s, fileObject as t, errorDetails as u };

package/dist/src-BaOpaXkV.mjs

@@ -0,0 +1,4 @@
+import "./schema-DcQLoUPP.mjs";
+export { t as componentNode, w as generateId, n as librarySource, i as withLibraryContext } from "./src-CSah1pZ-.mjs";
+import "./src-D2kRGtaF.mjs";
+import "./src-x0VQ8I6l.mjs";