unoverse 0.1.187 → 0.1.189

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unoverse",
-  "version": "0.1.187",
+  "version": "0.1.189",
   "description": "The Unoverse front door — create a Studio project, a universe, or a client app, and launch Studio.",
   "license": "SEE LICENSE IN README.md",
   "type": "module",

package/vendor/base/lint/design/file.mjs

@@ -399,8 +399,16 @@ function lintFile(file) {
     // ONE REQUIREMENT SHAPE (2026-08-29): a kind declares its tree (`states:`) OR
     // its drawing (`root` — flat components/atoms). A tree component's root is
     // SYNTHESIZED by the compiler, never required.
+    // A BLOCK is a template that declares a DRAWING instead of a tree (2026-08-31): a flat
+    // file, no manifest, one `root:` — `pair`, `feature`, `single`, `rail`, `stack`. It has
+    // no states because it is not a screen: it is a shape a page imports by `Ref`, inlined
+    // before the page's sections compile. Requiring `states:` of it would be demanding a
+    // state machine from a fragment, which is the same mistake as demanding a manifest:
+    // both are what a PAGE has, and a block is not a page.
+    const isBlock = declared === "template" && json.states === undefined && json.root !== undefined;
     const envelopeRequired =
-      declared === "app" || declared === "template" ? ["name", "states"]
+      isBlock ? ["name", "root"]
+      : declared === "app" || declared === "template" ? ["name", "states"]
       : declared === "component" ? ["name", ...(json.states !== undefined || json.state?.view !== undefined ? [] : ["root"])]
       : ["name", "root"];
     if (declared === "template" && json.states === undefined && (json.parts !== undefined || json.shapes !== undefined)) envelopeRequired.pop();

package/vendor/base/lint/design/vocabulary.mjs

@@ -45,7 +45,7 @@ export const UNIVERSAL_PROPS = new Set([
  */
 export const PROP_KEYS = [
   "type", "input", "description", "maxLength", "minItems", "maxItems",
-  "hydrate", "optional", "enum", "preview", "default", "items",
+  "hydrate", "override", "optional", "enum", "preview", "default", "items",
 ];
 
 /**
@@ -86,7 +86,7 @@ export const PRIMITIVE_PROPS = {
   Input: ["placeholder", "inputType", "disabledWhen", "maxLength", "multiline", "rows",
           "inputMode", "autoComplete", "advanceOnFill"],
   Select: ["placeholder", "options", "disabledWhen"],
-  Each: ["template", "app", "items"],
+  Each: ["item", "app", "items"],
   Switch: ["on", "cases", "fallback"],
   Ref: ["ref", "props", "with", "children", "name"],
   ComponentSlot: ["select", "frame", "fallback", "pinned", "appWidth"],
@@ -121,7 +121,7 @@ export const STYLE_KEYS = new Set([
 // exact regex from server/src/runtime/definition-tokens.test.ts
 export const RAW_VALUE = /#[0-9a-fA-F]{3,8}\b|\b\d*\.?\d+(px|rem|em)\b/;
 // nodes reachable through these keys (data keys like `items`/`cases` handled explicitly)
-export const CHILD_NODE_KEYS = ["children", "template", "fallback", "user", "assistant"];
+export const CHILD_NODE_KEYS = ["children", "item", "fallback", "user", "assistant"];
 // folders that hold BARE PARTIALS one level under the definition root
 export const PARTIAL_DIRS = new Set(["layouts", "states", "components", "blocks"]);
 

package/vendor/base/lint/design/walk.mjs

@@ -68,16 +68,19 @@ function walkNode(node, file, root, widthCap = null, isLayoutRoot = false) {
               report("error", file, `director.preview names unknown component "${c}". No match in the design system or this org's components (lookup is case-insensitive)`);
         }
       }
-      // ONE MIND, MANY BANDS (§9b rule 3, amended 2026-08-30): a layout may hold several
-      // directed bands — one verdict, arranged — but each must claim a DISTINCT face, or
-      // the surface is ambiguous (the reaction contract's one-view-one-surface rule). So
-      // on a multi-band layout every director declares its `state:`; two bands claiming
-      // the same face is the error this rule now exists for.
+      // A PLACE NEEDS NO NAME (§9d, ruled 2026-08-31). A layout may hold several director
+      // places — one mind, arranged — and each needs a DISTINCT address or the surface is
+      // ambiguous (the reaction contract's one-view-one-surface rule). But the ADDRESS is
+      // the compiler's to hand out, by position, and an author writes places and a brief,
+      // never a face name. This rule used to demand `state:` on every place after the
+      // first; that was config in the layout, saying nothing the one mind did not already
+      // know from the page's brief.
+      //
+      // An AUTHORED `state:` still stands (the flat-email pin, §9b rule 4), so two places
+      // pinned to the SAME face remains an error — that one is genuinely ambiguous.
       const seen = directorsSeen.get(file) ?? [];
       const face = typeof d?.state === "string" ? d.state : null;
-      if (seen.length && !face)
-        report("error", file, `a second "director:" in this layout declares no "state:". Several bands are allowed — one mind, arranged — but each must claim a DISTINCT face, so every one of them names it (§9b rule 3)`);
-      else if (face && seen.includes(face))
+      if (face && seen.includes(face))
         report("error", file, `two directed bands claim the face "${face}". A face has exactly one surface, or the active one is ambiguous (§9b rule 3, the reaction contract)`);
       directorsSeen.set(file, [...seen, face]);
     } else if (typeof node[word] !== "string") {
@@ -151,12 +154,12 @@ function walkNode(node, file, root, widthCap = null, isLayoutRoot = false) {
           report("error", file, `Switch on "${node.on}" → case "${caseKey}" re-guards its own discriminant. A layer never guards itself; delete the visibleWhen (docs.unoverse.ai/design/components)`);
       }
   }
-  // Each: a `template` + a list — EITHER a literal `items:[]` (hardcoded content,
+  // Each: an `item` + a list — EITHER a literal `items:[]` (hardcoded content,
   // the microapp default) OR `bind.items` (a workflow-fed array).
   if (t === "Each") {
     const hasList = Array.isArray(node.items) || (node.bind && typeof node.bind === "object" && node.bind.items);
-    if (!node.template || !hasList)
-      report("error", file, `Each needs "template" + a list. Literal "items": [...] or "bind": { "items": "<field>" } (docs.unoverse.ai/design/components)`);
+    if (!node.item || !hasList)
+      report("error", file, `Each needs "item" + a list. Literal "items": [...] or "bind": { "items": "<field>" } (docs.unoverse.ai/design/components)`);
   }
   if (t === "Ref") {
     if (typeof node.ref !== "string")