@parity-app/cli 0.5.1 → 0.6.0

package/dist/bin.mjs

@@ -180,7 +180,7 @@ const warningGroupsSchema = {
 		properties: {
 			category: {
 				type: "string",
-				description: "Stable: render_failed, unknown_component, unknown_component_design, unknown_prop, invalid_option, not_a_token, not_a_length_token, overlap, kind_changed or unnamed_layout."
+				description: "Stable: render_failed, unknown_component, unknown_component_design, unknown_prop, invalid_option, not_a_token, not_a_length_token, overlap, title_clearance, canvas_overlaps, kind_changed or unnamed_layout. overlap and title_clearance cover boards this call created, changed or moved: overlap when two boards collide, title_clearance when they're clear but one's title covers the other. canvas_overlaps counts the rest of the canvas's; call Overlaps() to check every board."
 			},
 			severity: {
 				type: "string",
@@ -922,10 +922,29 @@ const stateSchema = object({
 	},
 	overlaps: {
 		type: "array",
+		description: "Every pair of boards on the canvas that's too close, as execute's Overlaps() lists them. A pair with titleOnly doesn't collide: the lower board's title covers the upper one.",
 		items: object({
 			designs: strings,
-			names: strings
-		})
+			names: strings,
+			width: {
+				...number,
+				description: "How far they share, title band included."
+			},
+			height: number,
+			titleOnly: {
+				...boolean_,
+				description: "Only the lower board's title covers the other; the boards are clear."
+			},
+			estimated: {
+				...boolean_,
+				description: "One isn't drawn yet, so its size is estimated from its frames. Absent: both measured."
+			}
+		}, [
+			"width",
+			"height",
+			"titleOnly",
+			"estimated"
+		])
 	},
 	modes: {
 		type: "array",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity-app/cli",
-  "version": "0.5.1",
+  "version": "0.6.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

@@ -132,8 +132,9 @@ parity status --summary
   Lorem ipsum hides layout problems.
 - **Reuse what repeats.** When a row, card or list item appears more than twice, make it a component design with
   `ExtractComponent`, so each copy is an instance with its own content.
-- **Leave the canvas tidy.** New designs go into empty space (`FindEmptySpace`); `Overlaps()` tells you if boards
-  collide, sizing boards the canvas hasn't drawn yet from their frames (`estimated: true`).
+- **Leave the canvas tidy.** New designs go into empty space (`FindEmptySpace`). A call warns only about the boards it
+  moves; `Overlaps()` checks every board, telling collisions from a title too close (`titleOnly`) and boards sized from
+  their frames because the canvas hasn't drawn them (`estimated: true`).
 
 ## When something fails
 

package/skills/execute.md

@@ -459,12 +459,22 @@ size checks measure the same in `Measure` and `Screenshot` as on the canvas, eve
 
 ## The canvas
 
-`FindEmptySpace({ width, height })` finds room for a new board, to the right of the others unless `direction: "below"`,
-or next to the design named in `near`. `Overlaps()` lists boards that collide, titles included; move one with
-`UpdateDesign(design, { x, y })`. A board is as big as the canvas last drew it. One it hasn't drawn yet is sized from
-its frames, laid out as the canvas lays them out: each shown mode's frame size (`frames` on the design, else the mode's
-width), companions shrunk to 640 wide, and a frame without a fixed height as tall as its window. Those overlaps say
-`estimated: true`.
+`FindEmptySpace({ width, height })` finds room for a board that size, to the right of the others unless
+`direction: "below"`, or next to the design named in `near`. Its default `padding` of 240 leaves room for the board's
+title. Give it the size the board will be: `Designs()` has a drawn board's `width` and `height`.
+
+`Overlaps()` checks every board on the canvas and lists each pair that's too close, in one of two kinds:
+
+- **A collision:** the boards themselves overlap.
+- **Title clearance:** `titleOnly: true`. The boards are clear, but the lower one starts less than 160 below the upper
+  one, so the title the canvas draws above it covers the upper board.
+
+`width` and `height` are the area they share, title band included. Move one with `UpdateDesign(design, { x, y })`.
+
+A board is as big as the canvas last drew it, so its size is measured. One it hasn't drawn yet is sized from its frames,
+laid out as the canvas lays them out: each shown mode's frame size (`frames` on the design, else the mode's width),
+companions shrunk to 640 wide, and a frame without a fixed height as tall as its window. A pair with an estimated board
+says `estimated: true`; without it, both sizes are measured.
 
 ```js
 // With the default modes: a 1280 main frame, the dark one beside it at half size and the 390 phone, 2505 wide in all.
@@ -474,6 +484,20 @@ CreateDesign({ name: "Settings", x: 2200, y: 0 })
 Print(Overlaps(dashboard)) // Dashboard and Settings, 305 across, estimated: true
 ```
 
+An execute call's own warnings cover only the boards it creates, changes or moves: `overlap` for a collision and
+`title_clearance` for a title too close. Other crowded boards are counted in one `canvas_overlaps` suggestion, so a call
+that changes nothing, or only reads, doesn't make a crowded canvas look clear. To audit the canvas, call `Overlaps()`:
+
+```js
+for (const { names, titleOnly, estimated } of Overlaps()) {
+  const kind = titleOnly ? "a title covers a board" : "the boards collide"
+  Print(`${names.join(" and ")}: ${kind}, ${estimated ? "estimated" : "measured"}`)
+}
+// Room below Settings for a board 1400 wide and 1000 tall, and its title above it.
+const room = FindEmptySpace({ width: 1400, height: 1000, near: "settings", direction: "below" })
+CreateDesign({ name: "Plans", x: room.x, y: room.y })
+```
+
 ## Examples
 
 A new screen, checked in every state and mode: