@parity-app/cli 0.7.6 → 0.8.0

package/dist/{src-BZFjMWhp.mjs → src-Ck9A-Gxr.mjs}

@@ -1,4 +1,4 @@
-import { n as fileObject, o as parseData, r as finiteNumber, s as plainObject } from "./schema-Dp5Jhloe.mjs";
+import { i as jsonText, n as fileObject, o as parseData, r as finiteNumber, s as plainObject } from "./schema-Dp5Jhloe.mjs";
 import { z } from "zod";
 // ../core/src/adapters.ts
 const packageVersions = z.record(z.string(), z.string());
@@ -18,6 +18,7 @@ const packageManifest = z.looseObject({
 	version: z.string().optional(),
 	dependencies: packageVersions.optional(),
 	devDependencies: packageVersions.optional(),
+	optionalDependencies: packageVersions.optional(),
 	scripts: z.record(z.string(), z.string()).optional(),
 	/** Entry points by subpath (`.`, `./tailwind.css`), or where the package's one entry point leads. */
 	exports: exportsTarget.optional(),
@@ -28,8 +29,28 @@ const packageManifest = z.looseObject({
 	/** The stylesheet a project imports to use the package, as some packages name it. */
 	style: z.string().optional(),
 	/** A workspace root's package folders, as npm, Yarn and Bun write them. */
-	workspaces: z.union([z.array(z.string()), z.looseObject({ packages: z.array(z.string()).optional() })]).optional()
+	workspaces: z.union([z.array(z.string()), z.looseObject({ packages: z.array(z.string()).optional() })]).optional(),
+	/** The command line it installs: one file named after the package, or files by command name. */
+	bin: z.union([z.string(), z.record(z.string(), z.string())]).optional(),
+	/** Where its source is, which libgen reads examples from. */
+	repository: z.union([z.string(), z.looseObject({
+		url: z.string().optional(),
+		directory: z.string().optional()
+	})]).optional(),
+	/** The package manager and version a project asks for, as Corepack writes it (`pnpm@10.4.0`). */
+	packageManager: z.string().optional()
 });
+/**
+* A package.json's text, read through {@link packageManifest}. Throws `TypeError` naming the file and the field at
+* fault, as in `/app/package.json: /scripts/dev: expected a string`, or `/: expected JSON`.
+*/
+function parseManifest(text, file) {
+	try {
+		return parseData(jsonText(packageManifest), text);
+	} catch (error) {
+		throw new TypeError(`${file}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+	}
+}
 // ../core/src/devices.ts
 const deviceKinds = [
 	"phone",
@@ -505,18 +526,20 @@ const componentNode$1 = nodeBase.extend({
 		return z.record(z.string(), z.array(designNode)).optional();
 	}
 });
+/** The elements a text node can be. */
+const textTags = [
+	"p",
+	"span",
+	"h1",
+	"h2",
+	"h3",
+	"h4",
+	"strong"
+];
 const textNode = nodeBase.extend({
 	type: z.literal("text"),
 	text: z.string(),
-	tag: z.enum([
-		"p",
-		"span",
-		"h1",
-		"h2",
-		"h3",
-		"h4",
-		"strong"
-	]).optional()
+	tag: z.enum(textTags).optional()
 });
 const instanceNode = nodeBase.extend({
 	type: z.literal("instance"),
@@ -753,6 +776,269 @@ const canvasDocument = fileObject({
 	/** The source each lens reads, where the person switched from the one Parity picked. */
 	sources: lensSources.optional()
 });
+// ../core/src/values/evaluate.ts
+/** The keys that mark an object as one of the value forms rather than plain JSON. */
+const valueForms = [
+	"$import",
+	"$call",
+	"$global",
+	"$frame",
+	"$function"
+];
+/** The parts of a frame a `$frame` value can name. */
+const frameParts = [
+	"root",
+	"host",
+	"body",
+	"document",
+	"dir",
+	"lang",
+	"selector"
+];
+/** Whether a sample's prop value is elements. */
+function isSampleElement(value) {
+	return typeof value === "object" && value !== null && Array.isArray(value.$element);
+}
+/** Whether a value is one the package makes. */
+function isMadeValue(value) {
+	const call = typeof value === "object" && value !== null ? value.$call : void 0;
+	return typeof call === "object" && call !== null && typeof call.import === "string";
+}
+/** Whether a sample's child or prop value is a render function. */
+function isSampleRender(value) {
+	return typeof value === "object" && value !== null && Array.isArray(value.$render);
+}
+/**
+* A value worked out against a host: plain JSON as written, and its kind's forms made. A `$import` without an `export`
+* is the module's default export. A `$call` calls its function with its `args`, then the `methods` in order on what it
+* returned, wherever the call is; a method that's missing or throws is passed over, as the made value is still usable.
+* Arrays and objects with no form inside them come back as they were, so a prop keeps its identity between draws.
+*/
+function evaluateValue(value, host, kind = "decorator") {
+	const evaluate = (item) => evaluateValue(item, host, kind);
+	if (Array.isArray(value)) {
+		const items = value.map(evaluate);
+		return items.every((item, index) => item === value[index]) ? value : items;
+	}
+	if (typeof value !== "object" || value === null) return value;
+	const record = value;
+	if (isMadeValue(record)) return made$1(record, host, kind);
+	if (kind === "sample") return evaluateEntries(record, evaluate);
+	if (typeof record.$import === "string") {
+		const imported = record;
+		return host.exported(imported.$import, imported.export ?? "default");
+	}
+	if (typeof record.$global === "string") {
+		const global = record;
+		const chosen = host.global(global.$global);
+		const values = global.values ?? {};
+		return evaluate(chosen !== void 0 && Object.hasOwn(values, chosen) ? values[chosen] : global.default);
+	}
+	if (typeof record.$frame === "string") return host.frame(record.$frame);
+	if ("$function" in record) return () => evaluate(record.$function);
+	return evaluateEntries(record, evaluate);
+}
+/** Plain JSON's entries worked out, or the object as it was when none of them changed. */
+function evaluateEntries(record, evaluate) {
+	let changed = false;
+	const entries = Object.entries(record).map(([key, item]) => {
+		const evaluated = evaluate(item);
+		if (evaluated !== item) changed = true;
+		return [key, evaluated];
+	});
+	return changed ? Object.fromEntries(entries) : record;
+}
+function made$1(value, host, kind) {
+	const key = JSON.stringify(value);
+	if (host.made.has(key)) return host.made.get(key);
+	const { import: specifier, export: name } = value.$call;
+	const fn = host.exported(specifier, name);
+	if (typeof fn !== "function") throw new Error(`${specifier} has no function ${name}`);
+	const result = fn(...(value.args ?? []).map((arg) => evaluateValue(arg, host, kind)));
+	for (const step of value.methods ?? []) {
+		const method = result?.[step.method];
+		if (typeof method !== "function") continue;
+		try {
+			method.apply(result, (step.args ?? []).map((arg) => evaluateValue(arg, host, kind)));
+		} catch {}
+	}
+	host.made.set(key, result);
+	return result;
+}
+/** The modules a value imports from, each once, in the order they first appear. Plain JSON imports none. */
+function valueImports(value, kind = "decorator") {
+	const found = /* @__PURE__ */ new Set();
+	const visit = (item) => {
+		if (Array.isArray(item)) return item.forEach(visit);
+		if (typeof item !== "object" || item === null) return;
+		const record = item;
+		if (kind === "decorator" && typeof record.$import === "string") {
+			found.add(record.$import);
+			return;
+		}
+		if (isMadeValue(record)) {
+			found.add(record.$call.import);
+			record.args?.forEach(visit);
+			for (const step of record.methods ?? []) step.args?.forEach(visit);
+			return;
+		}
+		if (kind === "decorator" && typeof record.$frame === "string") return;
+		Object.values(record).forEach(visit);
+	};
+	visit(value);
+	return [...found];
+}
+/** An export of a module, following dots into namespaces (`Tooltip.Provider`). */
+function exportOf(module, path) {
+	let found = module;
+	for (const part of path.split(".")) found = found?.[part];
+	return found;
+}
+/**
+* Where a part's sample calls what's inside it: its function children, else a render prop (Chakra's `TreeView.Node`
+* `render`), with the render function.
+*/
+function renderSlotOf(sample) {
+	const children = sample?.children?.find(isSampleRender);
+	if (children) return {
+		prop: "children",
+		render: children
+	};
+	const entry = Object.entries(sample?.props ?? {}).find(([, value]) => isSampleRender(value));
+	return entry ? {
+		prop: entry[0],
+		render: entry[1]
+	} : void 0;
+}
+/**
+* The key a component node keeps a render function's nodes under (`renderInput`, function children): `$render:` and the
+* prop, `$renderWith:` when what it's called with is spread onto them, and `?pass=a,b` for the props that take it.
+*/
+function renderSlotKey(prop, render) {
+	const pass = render.pass ? `?pass=${render.pass.join(",")}` : "";
+	return `${render.spread ? "$renderWith" : "$render"}:${prop}${pass}`;
+}
+/** A slot key `renderSlotKey` wrote, read back; `undefined` for a slot of plain nodes. */
+function readRenderSlotKey(key) {
+	const match = /^\$render(With)?:([^?]+)(?:\?pass=(.+))?$/.exec(key);
+	if (!match) return void 0;
+	const [, spread, prop, pass] = match;
+	return {
+		prop,
+		spread: spread !== void 0,
+		...pass ? { pass: pass.split(",") } : {}
+	};
+}
+// ../core/src/values/grammar.ts
+const primitives = [
+	z.string(),
+	finiteNumber,
+	z.boolean(),
+	z.null()
+];
+/**
+* A decorator's or sample's value: JSON, or one of five forms that `evaluateValue` works out against a host, the frame
+* in the guest and a trial outside one in libgen. An object with one of the forms' keys must be that form; any other
+* object is plain JSON, its values values too.
+*
+* - `{ "$import": "pkg", "export": "name" }`: something the package exports, such as a theme object. `export` defaults
+*   to `default`, the default export.
+* - `{ "$call": { "import": "pkg", "export": "name" }, "args": [...], "methods": [...] }`: what calling it returns,
+*   after calling `methods` on it in order.
+* - `{ "$global": "theme", "values": { "dark": ... }, "default": ... }`: picked by the frame's global, which is the
+*   mode's option for that variable.
+* - `{ "$frame": "root" | "host" | "body" }`: the frame's shadow root, the element it hangs from (which `:root[...]`
+*   rules match, as `:host(...)`), or the element standing in for its `<body>`. Also `document`, `dir`, `lang`, and
+*   `selector`, a CSS selector for the body alone.
+* - `{ "$function": ... }`: a function returning the value it holds.
+*
+* Values are checked once, when their library file loads. The guest evaluates them on every frame without zod. A
+* sample's values are `sampleValue`s.
+*/
+const decoratorValue = z.lazy(() => z.union([
+	...primitives,
+	z.array(decoratorValue),
+	form("$import", importedValue),
+	form("$call", madeValue),
+	form("$global", globalValue),
+	form("$frame", frameValue),
+	form("$function", functionValue),
+	plain(valueForms, decoratorValue)
+]));
+/**
+* A sample's value, which a design node's props copy: JSON, and values the package makes (`$call`), as an example
+* passes them. The other forms are a decorator's alone, so in a sample an object with their keys is data as written.
+*/
+const sampleValue = z.lazy(() => z.union([
+	...primitives,
+	z.array(sampleValue),
+	form("$call", made(sampleValue)),
+	plain(["$call"], sampleValue)
+]));
+/** Something the package exports, such as a theme object. */
+const importedValue = fileObject({
+	$import: z.string(),
+	export: z.string().optional()
+});
+/**
+* A value the package makes by calling one of its own functions, as an example does (Chakra's
+* `collection={createTreeCollection({ rootNode })}`): the canvas calls it with `args`, once per frame.
+*/
+function made(value) {
+	return fileObject({
+		$call: fileObject({
+			import: z.string(),
+			export: z.string()
+		}),
+		args: z.array(value).optional(),
+		/**
+		* Methods called on what it makes, in order, as the examples call them (Chakra's `toaster.create({ title })`), so
+		* a toaster is drawn with a toast in it.
+		*/
+		methods: z.array(fileObject({
+			method: z.string(),
+			args: z.array(value).optional()
+		})).optional()
+	});
+}
+const madeValue = made(decoratorValue);
+/** Picked by the frame's global, which is the mode's option for that variable, else `default`. */
+const globalValue = fileObject({
+	$global: z.string(),
+	values: z.record(z.string(), decoratorValue),
+	default: decoratorValue.optional()
+});
+/** Part of the frame itself. */
+const frameValue = fileObject({ $frame: z.enum(frameParts) });
+/** A function returning the value it holds. */
+const functionValue = fileObject({ $function: decoratorValue });
+/**
+* An object with a form's key is that form. Any other object is refused as another type of value would be, which
+* `parseData` passes over, so a broken form reports its own mistake and not the closest of the other forms.
+*/
+function form(key, schema) {
+	return z.unknown().superRefine((value, context) => {
+		if (!(typeof value === "object" && value !== null && key in value)) context.addIssue({
+			code: "invalid_type",
+			expected: "object",
+			input: value
+		});
+	}).pipe(schema);
+}
+/** Plain JSON, its values values too. An object with a form's key is refused, for the form to report. */
+function plain(forms, value) {
+	return plainObject.superRefine((record, context) => {
+		if (forms.some((key) => key in record)) context.addIssue({
+			code: "invalid_type",
+			expected: "object",
+			input: record
+		});
+	}).pipe(z.record(z.string(), value));
+}
+/** A decorator's attributes, styles and element props. */
+const decoratorProps = z.record(z.string(), decoratorValue);
+/** A sample's props, and those of the components in its children. */
+const sampleProps = z.record(z.string(), sampleValue);
 // ../core/src/library.ts
 const libraryBreakpoint = fileObject({
 	id: z.string(),
@@ -807,7 +1093,7 @@ const sampleRender = fileObject({
 /** A component of the same library, by its name in `components.list`, with its props and children. */
 const sampleComponent = fileObject({
 	component: z.string(),
-	props: plainObject.optional(),
+	props: sampleProps.optional(),
 	get children() {
 		return z.array(sampleChild).optional();
 	}
@@ -824,38 +1110,9 @@ const sampleChild = z.union([
 z.object({ $element: z.array(sampleChild) });
 /** What a component needs to draw something: props with sample values, and children, as for a collection's items. */
 const componentSample = fileObject({
-	props: plainObject.optional(),
+	props: sampleProps.optional(),
 	children: z.array(sampleChild).optional()
 });
-/** Whether a sample's prop value is elements. */
-function isSampleElement(value) {
-	return typeof value === "object" && value !== null && Array.isArray(value.$element);
-}
-/** Whether a sample's prop value is one the package makes. */
-function isMadeValue(value) {
-	const call = typeof value === "object" && value !== null ? value.$call : void 0;
-	return typeof call === "object" && call !== null && typeof call.import === "string";
-}
-/** Whether a sample's child or prop value is a render function. */
-function isSampleRender(value) {
-	return typeof value === "object" && value !== null && Array.isArray(value.$render);
-}
-/**
-* Where a part's sample calls what's inside it: its function children, else a render prop (Chakra's `TreeView.Node`
-* `render`), with the render function.
-*/
-function renderSlotOf(sample) {
-	const children = sample?.children?.find(isSampleRender);
-	if (children) return {
-		prop: "children",
-		render: children
-	};
-	const entry = Object.entries(sample?.props ?? {}).find(([, value]) => isSampleRender(value));
-	return entry ? {
-		prop: entry[0],
-		render: entry[1]
-	} : void 0;
-}
 /** A regular expression's source, checked by compiling it. */
 const pattern = z.string().refine((source) => {
 	try {
@@ -977,110 +1234,11 @@ const libraryIcons = fileObject({
 	/** Where `tags` were read from, as `package@version/path`. */
 	tagSource: z.string().optional()
 });
-/**
-* A decorator's value: JSON, or one of five forms that the guest works out for each frame. An object with one of the
-* forms' keys must be that form; any other object is plain JSON, its values decorator values too.
-*
-* - `{ "$import": "pkg", "export": "name" }`: something the package exports, such as a theme object. `export` defaults
-*   to `default`.
-* - `{ "$call": { "import": "pkg", "export": "name" }, "args": [...], "methods": [...] }`: what calling it returns.
-* - `{ "$global": "theme", "values": { "dark": ... }, "default": ... }`: picked by the frame's global, which is the
-*   mode's option for that variable.
-* - `{ "$frame": "root" | "host" | "body" }`: the frame's shadow root, the element it hangs from (which `:root[...]`
-*   rules match, as `:host(...)`), or the element standing in for its `<body>`. Also `document`, `dir`, `lang`, and
-*   `selector`, a CSS selector for the body alone.
-* - `{ "$function": ... }`: a function returning the value it holds.
-*
-* Values are checked once, when their library file loads. The guest evaluates them on every frame without zod.
-*/
-const decoratorValue = z.lazy(() => z.union([
-	z.string(),
-	finiteNumber,
-	z.boolean(),
-	z.null(),
-	z.array(decoratorValue),
-	form("$import", importedValue),
-	form("$call", madeValue),
-	form("$global", globalValue),
-	form("$frame", frameValue),
-	form("$function", functionValue),
-	plainValue
-]));
-const valueForms = [
-	"$import",
-	"$call",
-	"$global",
-	"$frame",
-	"$function"
-];
-/** Something the package exports, such as a theme object. */
-const importedValue = fileObject({
-	$import: z.string(),
-	export: z.string().optional()
-});
-/**
-* A value the package makes by calling one of its own functions, as an example does (Chakra's
-* `collection={createTreeCollection({ rootNode })}`): the canvas calls it with `args`, once per frame.
-*/
-const madeValue = fileObject({
-	$call: fileObject({
-		import: z.string(),
-		export: z.string()
-	}),
-	args: z.array(decoratorValue).optional(),
-	/**
-	* Methods called on what it makes, in order, as the examples call them (Chakra's `toaster.create({ title })`), so a
-	* toaster is drawn with a toast in it.
-	*/
-	methods: z.array(fileObject({
-		method: z.string(),
-		args: z.array(decoratorValue).optional()
-	})).optional()
-});
-/** Picked by the frame's global, which is the mode's option for that variable, else `default`. */
-const globalValue = fileObject({
-	$global: z.string(),
-	values: z.record(z.string(), decoratorValue),
-	default: decoratorValue.optional()
-});
-/** Part of the frame itself. */
-const frameValue = fileObject({ $frame: z.enum([
-	"root",
-	"host",
-	"body",
-	"document",
-	"dir",
-	"lang",
-	"selector"
-]) });
-/** A function returning the value it holds. */
-const functionValue = fileObject({ $function: decoratorValue });
-/**
-* An object with a form's key is that form. Any other object is refused as another type of value would be, which
-* `parseData` passes over, so a broken form reports its own mistake and not the closest of the other forms.
-*/
-function form(key, schema) {
-	return z.unknown().superRefine((value, context) => {
-		if (!(typeof value === "object" && value !== null && key in value)) context.addIssue({
-			code: "invalid_type",
-			expected: "object",
-			input: value
-		});
-	}).pipe(schema);
-}
-/** Plain JSON, its values decorator values too. An object with a form's key is refused, for the form to report. */
-const plainValue = plainObject.superRefine((record, context) => {
-	if (valueForms.some((key) => key in record)) context.addIssue({
-		code: "invalid_type",
-		expected: "object",
-		input: record
-	});
-}).pipe(z.record(z.string(), decoratorValue));
 const decoratorElement = fileObject({
 	import: z.string(),
 	/** The export to render; `default` for a default export. */
 	component: z.string(),
-	props: z.record(z.string(), decoratorValue).optional()
+	props: decoratorProps.optional()
 });
 const decoratorEffects = [
 	"wrap",
@@ -1101,8 +1259,8 @@ const libraryDecorator = fileObject({
 	wrap: decoratorElement.optional(),
 	add: decoratorElement.optional(),
 	class: decoratorValue.optional(),
-	attributes: z.record(z.string(), decoratorValue).optional(),
-	style: z.record(z.string(), decoratorValue).optional()
+	attributes: decoratorProps.optional(),
+	style: decoratorProps.optional()
 }).superRefine((decorator, context) => {
 	if (decoratorEffects.filter((key) => decorator[key] !== void 0).length !== 1) context.addIssue({
 		code: "custom",
@@ -1296,8 +1454,7 @@ function withLibraryContext(node, sources, around, taken) {
 		const plain = {};
 		const slots = {};
 		const renderSlot = (prop, render) => {
-			const pass = render.pass ? `?pass=${render.pass.join(",")}` : "";
-			slots[`${render.spread ? "$renderWith" : "$render"}:${prop}${pass}`] = nodes(render.$render);
+			slots[renderSlotKey(prop, render)] = nodes(render.$render);
 		};
 		for (const [key, value] of Object.entries(props)) if (isSampleRender(value)) renderSlot(key, value);
 		else if (isSampleElement(value)) slots[key] = nodes(value.$element);
@@ -1354,8 +1511,8 @@ function withLibraryContext(node, sources, around, taken) {
 	for (const parent of added.reverse()) {
 		const wrapper = component(parent);
 		const calls = renderSlotOf(sources[parent]?.sample);
-		const slot = calls ? `$render:${calls.prop}${calls.render.pass ? `?pass=${calls.render.pass.join(",")}` : ""}` : "children";
-		const kept = Object.fromEntries(Object.entries(wrapper.type === "component" ? wrapper.slots ?? {} : {}).filter(([name]) => !calls || !name.startsWith(`$render:${calls.prop}`)));
+		const slot = calls ? renderSlotKey(calls.prop, calls.render) : "children";
+		const kept = Object.fromEntries(Object.entries(wrapper.type === "component" ? wrapper.slots ?? {} : {}).filter(([name]) => !calls || readRenderSlotKey(name)?.prop !== calls.prop));
 		placed = wrapper.type === "component" ? {
 			...wrapper,
 			slots: {
@@ -1491,4 +1648,4 @@ function sampleIds(sample, library) {
 		...sample.children ? { children: sample.children.map(child) } : {}
 	};
 }
-export { paramTypes as A, packageManifest as B, imageCredit as C, linkTypes as D, linkEndKinds as E, remProperty as F, viewportHeightProperty as I, viewportWidthProperty as L, generateId as M, modeSettings as N, nodeTree as O, collectCustomProperties as P, deviceKinds as R, detectionCorrections as S, linkAllowed as T, renderSlotOf as _, openProps as a, containerKinds as b, isMadeValue as c, libraryManifest as d, libraryManifestExtension as f, parseLibraryManifest as g, parseLibraryEdits as h, withLibraryContext as i, walkNodes as j, noteSpec as k, isSampleElement as l, parentSignals as m, librarySource as n, applyLibraryEdits as o, libraryPackage as p, sampleIds as r, componentEvidence as s, componentNode as t, isSampleRender as u, canvasDocument as v, imageFits as w, containerSpec as x, canvasObjectKinds as y, lengthToPixels as z };
+export { lengthToPixels as $, canvasObjectKinds as A, nodeTree as B, isSampleRender as C, valueForms as D, renderSlotOf as E, imageFits as F, walkNodes as G, paramTypes as H, linkAllowed as I, collectCustomProperties as J, generateId as K, linkEndKinds as L, containerSpec as M, detectionCorrections as N, valueImports as O, imageCredit as P, deviceKinds as Q, linkTypes as R, isSampleElement as S, renderSlotKey as T, patchUnset as U, noteSpec as V, textTags as W, viewportHeightProperty as X, remProperty as Y, viewportWidthProperty as Z, sampleValue as _, openProps as a, frameParts as b, libraryManifest as c, parentSignals as d, packageManifest as et, parseLibraryEdits as f, sampleProps as g, decoratorValue as h, withLibraryContext as i, containerKinds as j, canvasDocument as k, libraryManifestExtension as l, decoratorProps as m, librarySource as n, applyLibraryEdits as o, parseLibraryManifest as p, modeSettings as q, sampleIds as r, componentEvidence as s, componentNode as t, parseManifest as tt, libraryPackage as u, evaluateValue as v, readRenderSlotKey as w, isMadeValue as x, exportOf as y, nodeStyle as z };