@estiva-app/ui 0.35.1 → 0.36.0

package/dist/registry/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import {
   CONTRACT_KINDS,
+  NO_ALTERNATIVE,
   PAGE_SECTIONS,
   contractProblems,
   docsLink,
@@ -9,16 +10,18 @@ import {
   formatFindings,
   hasSeenIn,
   linkProblems,
-  pageProblem
-} from "./chunk-KMZIMB3G.js";
+  namedParts,
+  pageProblem,
+  whenNotProblem
+} from "./chunk-XK747STJ.js";
 import {
   buildAppRegistry
-} from "./chunk-3WJ7ZZ7Z.js";
+} from "./chunk-EVJW26UR.js";
 import {
   buildRegistry,
   readIndexExports,
   serializeRegistry
-} from "./chunk-XVII7P6G.js";
+} from "./chunk-SIB44CES.js";
 import {
   CLASSES,
   SCHEMA_VERSION,
@@ -27,6 +30,7 @@ import {
 export {
   CLASSES,
   CONTRACT_KINDS,
+  NO_ALTERNATIVE,
   PAGE_SECTIONS,
   SCHEMA_VERSION,
   buildAppRegistry,
@@ -38,9 +42,11 @@ export {
   formatFindings,
   hasSeenIn,
   linkProblems,
+  namedParts,
   pageProblem,
   readIndexExports,
   serializeRegistry,
-  validateRegistry
+  validateRegistry,
+  whenNotProblem
 };
 //# sourceMappingURL=index.js.map

package/dist/registry/siblings.d.ts

@@ -18,4 +18,13 @@ export declare function workspaceOf(from: string): string;
 export declare function findSiblings(workspace: string, { skip }?: {
     skip?: string[];
 }): Sibling[];
+/**
+ * How many commits the checkout that holds `folder` is behind its remote's main,
+ * as last fetched: nothing is fetched, so a search stays quick. Null when it is
+ * not a git checkout or has no remote main. A search that reads a stale copy
+ * answers with parts that are gone (the re-review after the audit before UIG-26:
+ * "files panel" found Peek's deleted FilesPanel in an old checkout), so `find`
+ * says so beside its answer.
+ */
+export declare function behindBy(folder: string): number | null;
 //# sourceMappingURL=siblings.d.ts.map

package/dist/registry/siblings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"siblings.d.ts","sourceRoot":"","sources":["../../src/registry/siblings.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,YAAY,mBAAmB,CAAA;AAE5C,MAAM,WAAW,OAAO;IACtB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAA;CACpB;AAYD,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrD;AAUD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,IAAS,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAAG,OAAO,EAAE,CAsBlG"}
+{"version":3,"file":"siblings.d.ts","sourceRoot":"","sources":["../../src/registry/siblings.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,YAAY,mBAAmB,CAAA;AAE5C,MAAM,WAAW,OAAO;IACtB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAA;CACpB;AAYD,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrD;AAUD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,IAAS,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAAG,OAAO,EAAE,CAsBlG;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYtD"}

package/dist/registry/storymap.d.ts

@@ -1,12 +1,26 @@
 import type { Registry } from './schema';
-/** Every top-level heading the sidebar has: the first segment of each story file's or page's title. */
+/** Every top-level heading the sidebar has, read from the story files: the first segment of each title. */
 export declare function sidebarHeadings(root: string): Set<string>;
-/** The headings `preview.tsx` orders, or null when it keeps no list. */
+/** The top-level headings of Storybook's own index (`storybook index`): the first segment of every entry's title. */
+export declare function indexHeadings(entries: Record<string, {
+    title?: string;
+}>): Set<string>;
+/** The headings the preview orders — a `HEADINGS` list or `storySort: { order: [...] }` — or null when it keeps no order. */
 export declare function orderedHeadings(previewText: string): string[] | null;
-/** The headings the Introduction names, one per table row that opens with a bold name. */
+/**
+ * The headings the Introduction names: a table row that opens with a bold name,
+ * or a bullet that opens with bold names joined by " · ".
+ */
 export declare function introductionHeadings(introText: string): Set<string>;
 /** The number the Introduction states, or null when it states none. */
 export declare function introductionCount(introText: string): number | null;
-/** What is wrong with the app's hand-written map of its Storybook; empty when nothing is. */
-export declare function storyMapProblems(registry: Registry, root: string): string[];
+/**
+ * What is wrong with the repository's hand-written map of its Storybook; empty
+ * when nothing is. `real` is the sidebar's top-level headings from Storybook's
+ * index, when the caller has it; `registry` is needed only for an app's count.
+ */
+export declare function storyMapProblems(root: string, { registry, real }?: {
+    registry?: Registry;
+    real?: Set<string>;
+}): string[];
 //# sourceMappingURL=storymap.d.ts.map

package/dist/registry/storymap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storymap.d.ts","sourceRoot":"","sources":["../../src/registry/storymap.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAsBxC,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAUzD;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAOpE;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAEnE;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B3E"}
+{"version":3,"file":"storymap.d.ts","sourceRoot":"","sources":["../../src/registry/storymap.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAuBxC,2GAA2G;AAC3G,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAUzD;AAED,qHAAqH;AACrH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAEtF;AA0BD,6HAA6H;AAC7H,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAIpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAInE;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAA4B,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAO,GAAG,MAAM,EAAE,CA6BrJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@estiva-app/ui",
-  "version": "0.35.1",
+  "version": "0.36.0",
   "description": "Estiva's design tokens (the contract) and a small set of primitives (a convenience) for every Estiva app.",
   "type": "module",
   "license": "MIT",
@@ -52,12 +52,15 @@
     "test": "vitest run --project unit",
     "test:watch": "vitest --project unit",
     "test:a11y": "vitest run --project storybook-signal --project storybook-ship",
+    "test:stories": "vitest run --project storybook-draw",
     "typecheck": "tsc --noEmit",
     "prelint": "node build.mjs",
     "lint": "eslint .",
     "prelint:rules": "node build.mjs",
     "lint:rules": "eslint --config eslint.gates.config.js .",
     "postlint:rules": "node dist/gates/cli.js count --repo estiva-ui --package",
+    "pregates:ci": "node build.mjs",
+    "gates:ci": "node dist/gates/cli.js ci --package",
     "pregates:status": "node build.mjs",
     "gates:status": "node dist/gates/cli.js status",
     "pregates:compare": "node build.mjs",

package/registry.json

@@ -4,7 +4,7 @@
     "kind": "package",
     "repo": "estiva-ui",
     "package": "@estiva-app/ui",
-    "packageVersion": "0.35.1",
+    "packageVersion": "0.36.0",
     "exports": 87,
     "typeExports": 96,
     "files": null
@@ -218,7 +218,20 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "components-attachmentcard--docs",
@@ -728,6 +741,10 @@
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
         }
       ],
       "status": "stable",
@@ -902,6 +919,22 @@
           "id": "portal",
           "behaviour": "Floats on top of the page"
         },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
+        {
+          "id": "follow",
+          "behaviour": "Stays attached to its anchor on scroll and resize"
+        },
         {
           "id": "walking",
           "behaviour": "Moves through its items with the arrow keys"
@@ -1100,10 +1133,22 @@
           "id": "portal",
           "behaviour": "Floats on top of the page"
         },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
         {
           "id": "focus",
           "behaviour": "Holds focus inside while open, and gives it back"
         },
+        {
+          "id": "scroll-lock",
+          "behaviour": "Stops the page behind it scrolling"
+        },
         {
           "id": "walking",
           "behaviour": "Moves through its items with the arrow keys"
@@ -1316,7 +1361,20 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "portal",
+          "behaviour": "Floats on top of the page"
+        },
+        {
+          "id": "walking",
+          "behaviour": "Moves through its items with the arrow keys"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "overlays-commandpalette--docs",
@@ -1415,6 +1473,22 @@
           "id": "portal",
           "behaviour": "Floats on top of the page"
         },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
+        {
+          "id": "scroll-lock",
+          "behaviour": "Stops the page behind it scrolling"
+        },
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"
@@ -1710,7 +1784,12 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "inputs-editabletext--docs",
@@ -2483,7 +2562,20 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "inputs-chipinput--docs",
@@ -2568,10 +2660,18 @@
       ],
       "variants": [],
       "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
         {
           "id": "portal",
           "behaviour": "Floats on top of the page"
         },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
         {
           "id": "page-keys",
           "behaviour": "Takes its keys by itself"
@@ -2583,6 +2683,10 @@
         {
           "id": "scroll-lock",
           "behaviour": "Stops the page behind it scrolling"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
         }
       ],
       "status": "stable",
@@ -2820,6 +2924,10 @@
           "id": "page-keys",
           "behaviour": "Takes its keys by itself"
         },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
         {
           "id": "follow",
           "behaviour": "Stays attached to its anchor on scroll and resize"
@@ -2926,7 +3034,16 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "overlays-menuitem--docs",
@@ -3024,7 +3141,16 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "overlays-menu--docs",
@@ -3093,7 +3219,16 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "overlays-menu--docs",
@@ -3265,7 +3400,20 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "components-persontrigger--docs",
@@ -3399,6 +3547,10 @@
           "id": "page-keys",
           "behaviour": "Takes its keys by itself"
         },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
         {
           "id": "follow",
           "behaviour": "Stays attached to its anchor on scroll and resize"
@@ -3494,6 +3646,10 @@
           "id": "press-outside",
           "behaviour": "Closes on a press outside"
         },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
         {
           "id": "follow",
           "behaviour": "Stays attached to its anchor on scroll and resize"
@@ -3757,6 +3913,10 @@
         {
           "id": "base-ui",
           "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
         }
       ],
       "status": "stable",
@@ -3814,7 +3974,12 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "components-reactionpicker--docs",
@@ -3890,6 +4055,10 @@
           "id": "base-ui",
           "behaviour": "Is built on Base UI"
         },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
+        },
         {
           "id": "scroll",
           "behaviour": "Scrolls with our scrollbar"
@@ -4201,6 +4370,10 @@
           "id": "page-keys",
           "behaviour": "Takes its keys by itself"
         },
+        {
+          "id": "focus",
+          "behaviour": "Holds focus inside while open, and gives it back"
+        },
         {
           "id": "follow",
           "behaviour": "Stays attached to its anchor on scroll and resize"
@@ -4437,6 +4610,10 @@
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
         }
       ],
       "status": "stable",
@@ -4459,7 +4636,12 @@
       "purposeFrom": "page",
       "props": [],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "inputs-textarea--docs",
@@ -4615,7 +4797,24 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "portal",
+          "behaviour": "Floats on top of the page"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "follow",
+          "behaviour": "Stays attached to its anchor on scroll and resize"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "feedback-toast--docs",
@@ -4701,6 +4900,10 @@
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"
+        },
+        {
+          "id": "tab-stop",
+          "behaviour": "Is reachable with Tab"
         }
       ],
       "status": "stable",
@@ -4800,7 +5003,16 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-toolbar--docs",
@@ -4834,7 +5046,16 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-toolbar--docs",
@@ -4920,7 +5141,16 @@
           ]
         }
       ],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-toolbar--docs",
@@ -4946,7 +5176,16 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "role",
+          "behaviour": "Says what it is to assistive technology"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-toolbar--docs",
@@ -5041,7 +5280,28 @@
         }
       ],
       "variants": [],
-      "ownsBehaviours": [],
+      "ownsBehaviours": [
+        {
+          "id": "base-ui",
+          "behaviour": "Is built on Base UI"
+        },
+        {
+          "id": "portal",
+          "behaviour": "Floats on top of the page"
+        },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "follow",
+          "behaviour": "Stays attached to its anchor on scroll and resize"
+        }
+      ],
       "status": "stable",
       "migrationStage": null,
       "docsId": "primitives-tooltip--docs",
@@ -5193,6 +5453,22 @@
           "id": "base-ui",
           "behaviour": "Is built on Base UI"
         },
+        {
+          "id": "portal",
+          "behaviour": "Floats on top of the page"
+        },
+        {
+          "id": "press-outside",
+          "behaviour": "Closes on a press outside"
+        },
+        {
+          "id": "page-keys",
+          "behaviour": "Takes its keys by itself"
+        },
+        {
+          "id": "follow",
+          "behaviour": "Stays attached to its anchor on scroll and resize"
+        },
         {
           "id": "role",
           "behaviour": "Says what it is to assistive technology"

package/skill/estiva-ui.md

@@ -32,7 +32,8 @@ and when not to. Most of what gets asked for already exists somewhere.
    refuses a raw element, a rebuilt behaviour or a restyled part, and its error
    names the part to use.
 5. **An exception** carries its reason on the line above it. For the gate:
-   `// @estiva-escape: <reason>`, never `eslint-disable`. For the token lint:
+   `// @estiva-escape(<rule>): <reason>`, naming the one rule it keeps off,
+   never `eslint-disable`. For the token lint:
    `// eslint-disable-next-line <rule> -- @estiva-escape: <reason>`.
 
 ## Gotchas

package/src/AppShell.mdx

@@ -32,7 +32,8 @@ Layout only: no data, no routes.
 ## When not
 
 - Panels *inside* the content — lists beside conversations, side rails —
-  are layout components, not the shell's business.
+  are layout components, not the shell's business. A list beside the
+  content is **ListColumn**.
 - Mixing the pairs (a rail in the solid frame, a sidebar in the floating
   one) is possible but is a new design, not a port — take it to the
   designer first.