synthesisui 0.16.91 → 0.16.92

package/dist/commands/import.js

@@ -18,6 +18,7 @@ import { describeConvention, describeRemainder, detectConventions, } from "../do
 import { diagnose, scanSource } from "../doctor/scan.js";
 import { parseSchemeBlocks } from "../doctor/scheme-blocks.js";
 import { describeSignals, emptySignals, finishSignals, readSignalsInto, } from "../doctor/signals.js";
+import { sketchOf } from "../doctor/sketch.js";
 import { buildTable } from "../doctor/tokens.js";
 import { readInlineStyle, rootClasses, rootTag, transcribe, } from "../doctor/transcribe.js";
 import { transcribeVariants } from "../doctor/variant-read.js";
@@ -472,8 +473,16 @@ export async function takeCensus(root, opts) {
                     Object.keys(parts).length +
                     layers.length;
                 const tag = rootTag(src);
+                /**
+                 * THE SKETCH travels with the look, so the reading phase never opens this
+                 * file again: naming parts is a sentence over data the census already holds,
+                 * and a file read whose content is here is a pipeline optimization failure -
+                 * the owner's rule, adopted verbatim (dono, 01/08).
+                 */
+                const sketch = sketchOf(src);
                 if (size > 0 || tag) {
                     looks[found[0].name] = {
+                        ...(sketch.length > 0 ? { sketch } : {}),
                         ...t,
                         base,
                         states,

package/dist/doctor/css-modules.js

@@ -267,7 +267,7 @@ function looksLikeTypeArg(source, at) {
     }
     return false;
 }
-function scanTags(source) {
+export function scanTags(source) {
     const out = [];
     for (let i = 0; i < source.length; i++) {
         if (source[i] !== "<")

package/dist/doctor/sketch.js

@@ -0,0 +1,68 @@
+/**
+ * THE ANATOMY SKETCH - the component's own markup, carried by the census so nobody
+ * reads the file twice.
+ *
+ * The owner's directive, verbatim in intent (dono, 01/08): the census is the ONLY
+ * source of truth about the project's tree; iterative per-layer sweeps are forbidden;
+ * and any file read whose content the census already carries is a pipeline
+ * optimization failure. The reading phase was the last consumer of raw files - it
+ * opened every component to see its JSX before naming parts, which is most of the
+ * tokens and most of the minutes of a run.
+ *
+ * The sketch is everything that reading extracted, minus the one thing that is
+ * genuinely a judgment: the NAMES. Tag, class string, depth, text, and the
+ * capitalised frontiers, per element, in document order. A reader holding this names
+ * `trigger`/`status-dot`/`panel` without opening anything - and naming is a sentence,
+ * not a sweep.
+ *
+ * GENERALIZED BY CONSTRUCTION: it reads JSX shape, not folder layout, so it works the
+ * same in an atomic library, a feature-foldered app, or a single flat directory.
+ */
+import { scanTags } from "./css-modules.js";
+/** Past this a component is a page in disguise, and the gate already said no. */
+const MAX_NODES = 60;
+/** `className="..."` or className={"..."} / {`...`} with no interpolation. */
+const CLASS_ATTR = /className=\{?["'`]([^"'`{}$]*)["'`]\}?/;
+/**
+ * The sketch of one component file.
+ *
+ * Depth comes from the same tag scanner the CSS-module reader trusts (brace-counting,
+ * quote-aware, type-argument-proof). Text is captured only when it is a short literal
+ * sitting directly between an open and its close - dynamic children are the caller's,
+ * and the slot form already says so.
+ */
+export function sketchOf(source) {
+    const events = scanTags(source);
+    const out = [];
+    let depth = 0;
+    for (let i = 0; i < events.length; i++) {
+        const event = events[i];
+        if (event.kind === "close") {
+            depth = Math.max(0, depth - 1);
+            continue;
+        }
+        if (out.length >= MAX_NODES)
+            break;
+        const node = { tag: event.tag, depth };
+        const cls = CLASS_ATTR.exec(event.body);
+        if (cls?.[1].trim())
+            node.classes = cls[1].trim();
+        // Literal text: the slice between this open and the next event, when it is prose.
+        const next = events[i + 1];
+        if (next) {
+            const between = source
+                .slice(event.at + event.tag.length, next.at)
+                .replace(/^[^>]*>/, "")
+                .trim();
+            if (between &&
+                between.length <= 60 &&
+                !between.includes("{") &&
+                !between.includes("<")) {
+                node.text = between;
+            }
+        }
+        out.push(node);
+        depth += 1;
+    }
+    return out;
+}

package/dist/doctor/transcribe.js

@@ -610,6 +610,20 @@ export function readUtility(utility, declared) {
             if (size)
                 return { property: axisProp, value: size };
         }
+        /**
+         * THEIR OWN SPACING STEP IS A LIVE UTILITY IN v4: `gap-sm` compiles to
+         * `var(--spacing-sm)` the moment the theme declares it. A real Label uses exactly
+         * that, and the reading filed it under "known typos in their source" - the typo
+         * was ours (test15, 01/08). Their name first, the numeric formula second.
+         */
+        const own = `--spacing-${sizeRest}`;
+        if (declared.has(own)) {
+            return {
+                property: spaceProp,
+                value: `{spacing.${sizeRest}}`,
+                token: own,
+            };
+        }
         const size = SPACING[sizeRest] ?? numericSpacing(sizeRest);
         if (size)
             return { property: spaceProp, value: size };

package/dist/skill-import.js

@@ -669,6 +669,41 @@ what shows while it loads     a skeleton, a blur, or the surface colour
 what shows when it is missing a missing asset must never look broken
 \`\`\`
 
+### The census is the ONLY source of truth - four universal rules
+
+These hold in ANY project, whatever its folders, and they exist because a run spent most
+of its tokens re-reading what the census already carried (dono, 01/08):
+
+1. **No iterative sweeps by layer or folder.** Never walk atoms/, then molecules/, then
+   organisms/ reading files - the census walked everything once.
+2. **Batch over the census's own data.** Everything you consume comes out of
+   \`_synthesisui/census.json\` - the looks, the sketch, the signals, the coverage.
+3. **Metadata is one pass, already done.** Theme, fonts, page, libraries, architecture
+   arrive counted. You confirm in a sentence; you never re-derive.
+4. **A file read whose content the census carries is a PIPELINE FAILURE.** Say so in
+   not-expressed.md when you catch yourself - that report is how the census grows.
+
+### Name the parts from the SKETCH - the file is already in the census
+
+Every component's look carries \`sketch\`: its own markup as data - tag, class string,
+depth and text per element, in document order. That is everything you used to open the
+file for, minus the one thing that is genuinely yours: the NAMES.
+
+\`\`\`json
+"sketch": [
+  { "tag": "div",  "depth": 0, "classes": "rounded-md border ..." },
+  { "tag": "button", "depth": 1, "classes": "flex w-full ..." },
+  { "tag": "span", "depth": 2, "classes": "size-2 rounded-full bg-success-500" },
+  { "tag": "span", "depth": 2, "text": "Status" },
+  { "tag": "ChevronDownIcon", "depth": 2 }
+]
+\`\`\`
+
+Read that and write the anatomy: depth 1 is \`trigger\`, the dot is \`status-dot\`, the
+capitalised tag is a frontier. **Do not open the component file** - if the sketch is
+missing or visibly truncated (60-node cap), say so in not-expressed.md and only then
+read, because that gap is the census's to close.
+
 ### What the CLI now reads for you, so do not spend a turn on it
 
 **The rule under all of this: you are given EVIDENCE and asked to DECIDE.** You are never

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.91",
+  "version": "0.16.92",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {