@parity-app/cli 0.8.0 → 0.9.0

package/dist/bin.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { c as CodedError, d as errorDetails, f as readErrorDetails, i as jsonText, l as closest, s as plainObject, t as checkData, u as errorCodes } from "./schema-Dp5Jhloe.mjs";
-import { _ as requests, a as describeExec, c as describeProps, f as setCaller, g as requestJsonSchema, h as replies, i as describeConsole, l as describeStatus, m as readRequest, n as describeAccessibility, o as describeModes, p as mcpCallerName, r as describeComponents, s as describeProblems, t as call, u as describeTokens, v as skillRequest } from "./client-CkT-5H3_.mjs";
+import { _ as requests, a as describeExec, c as describeProps, f as setCaller, g as requestJsonSchema, h as replies, i as describeConsole, l as describeStatus, m as readRequest, n as describeAccessibility, o as describeModes, p as mcpCallerName, r as describeComponents, s as describeProblems, t as call, u as describeTokens, v as skillRequest } from "./client-Cgwc4jGv.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";
@@ -160,7 +160,7 @@ const appErrorsFile = jsonText(z.record(z.string(), z.string()));
 */
 async function runCheck(library, options) {
 	if (!library) throw new Error("parity lib check <library> [--tab t] [--mode m]");
-	const { componentNode, generateId, librarySource, withLibraryContext } = await import("./src-C4S96XEj.mjs");
+	const { componentNode, generateId, librarySource, withLibraryContext } = await import("./src-B9dFylXR.mjs");
 	const { newestEntries, registryDir } = await import("./src-ZsXhzNYa.mjs");
 	const entry = (await newestEntries()).find((item) => item.manifest.id === library);
 	if (!entry) throw new Error(`The registry has no library "${library}"`);
@@ -651,7 +651,7 @@ const tools = [
 	operationTool("get_console", "Read what the project's own code wrote to the console: errors, warnings and logs from its components on the canvas, including while the person interacts with them, and from offscreen renders such as screenshots. Oldest first; the same message several times in a row is counted once. clear: true empties it after reading, so the next read shows only what's new.", operations.console, (result) => [text(describeConsole(result))]),
 	operationTool("open_project", "Open a project folder in a new Parity tab, or switch to it if it's already open.", operations.open, json),
 	operationTool("get_tokens", "Read tokens filtered by category, source or name, with values in every theme.", operations.tokens, (result) => [text(describeTokens(result))]),
-	operationTool("get_components", "List project components, libraries, icon sets and exports that were left out or failed to render.", operations.components, (result) => [text(describeComponents(result))]),
+	operationTool("get_components", "List project components with the file each is written in, libraries, icon sets and exports that were left out or failed to render.", operations.components, (result) => [text(describeComponents(result))]),
 	operationTool("get_props", "Read a component's props from source, and its composition: the parents or provider it goes inside, the parts it holds, its slots and an example node to insert. all includes attributes it passes through.", operations.props, (result) => [text(describeProps(result))]),
 	{
 		name: "read_skill",

package/dist/{client-CkT-5H3_.mjs → client-Cgwc4jGv.mjs}

@@ -494,7 +494,10 @@ const consoleReply = z.looseObject({
 		where: z.enum(["canvas", "offscreen"]),
 		count: z.int(),
 		first: number,
-		last: number
+		last: number,
+		design: z.string().optional().describe("The design that wrote it, by key (path#id), when known."),
+		state: z.string().optional(),
+		mode: z.string().optional()
 	}))
 });
 const tokenInfo = z.looseObject({
@@ -505,6 +508,8 @@ const tokenInfo = z.looseObject({
 });
 const componentsReply = z.looseObject({
 	components: strings,
+	/** The file each of the project's own components is written in, from the project root, by component (PAR-167). */
+	files: z.record(z.string(), z.string()).optional(),
 	iconLibraries: strings.optional(),
 	/** The app's capitalised exports the type checker left out, with why. */
 	leftOut: z.array(z.looseObject({
@@ -1234,10 +1239,11 @@ function describeTokens({ tokens, total, truncated }) {
 	return lines.join("\n");
 }
 /**
-* The project's own components, then each library's, then the icon libraries, then the exports left out and why, the
-* components failing to draw and why, and what the person corrected by hand.
+* The project's own components, by the file each is written in when that's known, then each library's, then the icon
+* libraries, then the exports left out and why, the components failing to draw and why, and what the person corrected
+* by hand.
 */
-function describeComponents({ components, iconLibraries = [], leftOut = [], drawn = 0, failing = [], corrections = {} }) {
+function describeComponents({ components, files = {}, iconLibraries = [], leftOut = [], drawn = 0, failing = [], corrections = {} }) {
 	const groups = /* @__PURE__ */ new Map();
 	for (const component of components) {
 		const slash = component.indexOf("/");
@@ -1245,7 +1251,8 @@ function describeComponents({ components, iconLibraries = [], leftOut = [], draw
 		groups.set(group, [...groups.get(group) ?? [], slash > 0 ? component.slice(slash + 1) : component]);
 	}
 	const lines = [];
-	for (const [group, names] of [...groups].sort(([a], [b]) => first("", a, b))) lines.push(group ? `${group}, as ${group}/Name:` : "The project's own:", `  ${names.join(", ")}`, "");
+	for (const [group, names] of [...groups].sort(([a], [b]) => first("", a, b))) if (group) lines.push(`${group}, as ${group}/Name:`, `  ${names.join(", ")}`, "");
+	else lines.push(...ownComponents(names, files), "");
 	if (iconLibraries.length > 0) lines.push(`Icons: ${iconLibraries.map((library) => `${library}, as ${library}/Name`).join("; ")}`, "");
 	if (leftOut.length > 0) {
 		lines.push("Not components:");
@@ -1265,6 +1272,22 @@ function describeComponents({ components, iconLibraries = [], leftOut = [], draw
 	}
 	return lines.join("\n").trimEnd();
 }
+/** The project's own components, under the file each is written in when the app says, files in order (PAR-167). */
+function ownComponents(names, files) {
+	const byFile = /* @__PURE__ */ new Map();
+	const unplaced = [];
+	for (const name of names) {
+		const file = files[name];
+		if (file) byFile.set(file, [...byFile.get(file) ?? [], name]);
+		else unplaced.push(name);
+	}
+	if (byFile.size === 0) return ["The project's own:", `  ${names.join(", ")}`];
+	return [
+		"The project's own, by file:",
+		...[...byFile].sort(([a], [b]) => a.localeCompare(b)).map(([file, inFile]) => `  ${file}: ${inFile.join(", ")}`),
+		...unplaced.length > 0 ? [`  file not known yet: ${unplaced.join(", ")}`] : []
+	];
+}
 /** A component's props, with each variant's options and default, then what it needs around it and holds. */
 function describeProps(result) {
 	const lines = [];
@@ -1325,10 +1348,16 @@ function describeConsole(result) {
 		const [first = "", ...rest] = entry.text.split("\n");
 		lines.push("", `${time} ${entry.level}${repeats}: ${first}`, ...rest.map((line) => `  ${line}`));
 		const offscreen = entry.where === "offscreen" ? ", in an offscreen render" : "";
-		lines.push(`  at ${scriptPath(entry.source)}:${entry.line}${offscreen}`);
+		lines.push(`  at ${scriptPath(entry.source)}:${entry.line}${offscreen}${writtenBy(entry)}`);
 	}
 	return lines.join("\n");
 }
+/** The design a message came from, by id, with the state and mode it was drawn in, when the app knows (PAR-147). */
+function writtenBy({ design, state, mode }) {
+	if (!design) return "";
+	const frame = [state, mode].filter(Boolean).join(", ");
+	return `, from design ${design.slice(design.lastIndexOf("#") + 1)}${frame ? ` (${frame})` : ""}`;
+}
 /** Compares two names alphabetically, with `name` before every other. */
 function first(name, a, b) {
 	if (a === name) return -1;

package/dist/index.d.mts

@@ -488,6 +488,9 @@ declare const replies: {
       count: z.ZodInt;
       first: z.ZodNumber;
       last: z.ZodNumber;
+      design: z.ZodOptional<z.ZodString>;
+      state: z.ZodOptional<z.ZodString>;
+      mode: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
   }, z.core.$loose>;
   tokens: z.ZodArray<z.ZodObject<{
@@ -498,6 +501,7 @@ declare const replies: {
   }, z.core.$loose>>;
   components: z.ZodObject<{
     components: z.ZodArray<z.ZodString>;
+    files: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     iconLibraries: z.ZodOptional<z.ZodArray<z.ZodString>>;
     leftOut: z.ZodOptional<z.ZodArray<z.ZodObject<{
       name: z.ZodString;
@@ -643,6 +647,9 @@ declare const consoleResult: z.ZodObject<{
     count: z.ZodInt;
     first: z.ZodNumber;
     last: z.ZodNumber;
+    design: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodString>;
   }, z.core.$loose>>;
 }, z.core.$loose>;
 declare const tokensResult: z.ZodObject<{
@@ -818,10 +825,11 @@ export declare function describeProblems(result: ProblemsResponse): string;
 /** Tokens by category, each with its value in every theme that sets one. */
 export declare function describeTokens({ tokens, total, truncated }: TokensResponse): string;
 /**
- * The project's own components, then each library's, then the icon libraries, then the exports left out and why, the
- * components failing to draw and why, and what the person corrected by hand.
+ * The project's own components, by the file each is written in when that's known, then each library's, then the icon
+ * libraries, then the exports left out and why, the components failing to draw and why, and what the person corrected
+ * by hand.
  */
-export declare function describeComponents({ components, iconLibraries, leftOut, drawn, failing, corrections }: ComponentsResponse): string;
+export declare function describeComponents({ components, files, iconLibraries, leftOut, drawn, failing, corrections }: ComponentsResponse): string;
 /** A component's props, with each variant's options and default, then what it needs around it and holds. */
 export declare function describeProps(result: PropsResponse): string;
 /** A readable account of what a project's code wrote to the console, oldest first, with where each came from. */

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-CkT-5H3_.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-Cgwc4jGv.mjs";

package/dist/{src-C4S96XEj.mjs → src-B9dFylXR.mjs}

@@ -1,5 +1,5 @@
 import "./schema-Dp5Jhloe.mjs";
-import "./client-CkT-5H3_.mjs";
+import "./client-Cgwc4jGv.mjs";
 export { t as componentNode, K as generateId, n as librarySource, i as withLibraryContext } from "./src-Ck9A-Gxr.mjs";
 import "./src-gCnKQqH5.mjs";
 import "./src-XUZS4M-k.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity-app/cli",
-  "version": "0.8.0",
+  "version": "0.9.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/SKILL.md

@@ -45,9 +45,10 @@ project, pass `tab: "active"` (`--tab active`) and read `get_app_state` for the
 | `read_skill`          | `parity skill [file]`        | This skill.                                                                                                                                                                         |
 
 The token, component and prop tools read what designs can use without writing a snippet in either transport.
-`parity components` also says which of the app's exports aren't components and why, which components fail to draw on the
-canvas and why (often a missing provider, which a decorator adds), and what the person listed or took off the list by
-hand.
+`parity components` also says which file each of the project's own components is written in, which of the app's exports
+aren't components and why, which components fail to draw on the canvas and why (often a missing provider, which a
+decorator adds), and what the person listed or took off the list by hand. `Measure` gives the file and line that writes
+each node's element.
 
 CLI commands and MCP tools share validation and defaults. Screenshot scale defaults to 1 and accepts 0.25 to 3. Audits
 check every state and shown mode unless narrowed; a single-element selector list is equivalent to a string. Screenshot

package/skills/execute.md

@@ -438,12 +438,13 @@ token values not yet saved show, the person's edits and this call's own `SetToke
 
 `Measure` lays out one frame and returns its state, mode and size, whether it overflows sideways, and every node's box
 with the node it's drawn inside (`parent`); a node an ancestor cuts off has `clipped` and that ancestor's box in `clip`.
-`Problems` checks frames for render errors, overflow, clipping and unknown components. Each layout problem has its
-`kind`: `frame-overflow` for a node that sticks out of the frame, by its position or its width, or `clipped` for one an
-ancestor that hides overflow cuts off. It names the `node`, its `box`, the `container` it overflows (the clipping node,
-or the frame, which has no `node`) with that box, and the pixels past each edge in `overflow`. A node past a parent that
-doesn't clip, inside the frame, shows, so it isn't a problem; children going no further than a reported parent are left
-out.
+A node whose element the project's code writes, such as a component's, has `source`: the file, line and column, as
+`src/components/ui/button.tsx:44:5`, to open or edit. Parity's own layers have none. `Problems` checks frames for render
+errors, overflow, clipping and unknown components. Each layout problem has its `kind`: `frame-overflow` for a node that
+sticks out of the frame, by its position or its width, or `clipped` for one an ancestor that hides overflow cuts off. It
+names the `node`, its `box`, the `container` it overflows (the clipping node, or the frame, which has no `node`) with
+that box, and the pixels past each edge in `overflow`. A node past a parent that doesn't clip, inside the frame, shows,
+so it isn't a problem; children going no further than a reported parent are left out.
 
 ```js
 const id = CreateDesign({ name: "Checkout" })