unoverse 0.1.179 → 0.1.181

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unoverse",
-  "version": "0.1.179",
+  "version": "0.1.181",
   "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

@@ -101,7 +101,12 @@ function lintFile(file) {
       // manifest-only form must resolve a layout; an envelope-form template supplies its own.
       const hasEnvelope = !!defPath(root, basename(root));
       if (!hasEnvelope) {
-        const layoutName = json.layout ?? "main";
+        // The base defaults to the FIRST DECLARED STATE (states own layouts and
+        // declaration order ranks them); "main" only when no states block exists.
+        const firstState = json.states && typeof json.states === "object" && !Array.isArray(json.states)
+          ? Object.keys(json.states)[0]
+          : undefined;
+        const layoutName = json.layout ?? firstState ?? "main";
         if (!defPath(join(root, "layouts"), layoutName))
           report("error", file, `manifest.layout "${layoutName}" → layouts/${layoutName} does not exist (and no <name> envelope) (docs.unoverse.ai/design/apps)`);
       }
@@ -123,7 +128,7 @@ function lintFile(file) {
           report("error", file, `manifest "states" must be an object — the template tree: { <base>: { states: {…} }, <reaction>: {}, … } (STATE_MODEL §5)`);
         } else {
           const names = Object.keys(json.states);
-          const base = json.layout ?? "main";
+          const base = json.layout ?? Object.keys(json.states)[0] ?? "main";
           if (!names.includes(base))
             report("error", file, `the template tree must include the BASE state "${base}" (named for the default layout) — the ladder derives as the top level minus it (STATE_MODEL §5)`);
           const subs = [];
@@ -279,16 +284,21 @@ function lintFile(file) {
 
   if (isEnvelope) {
     // COMPONENT envelope (templates have no envelope — their manifest is it).
-    for (const req of ["kind", "name", "root"])
+    // The declaration word is `type:`; `kind:` is the legacy spelling, still read.
+    const declared = json.type ?? json.kind;
+    for (const req of ["name", "root"])
       if (json[req] === undefined) report("error", file, `envelope missing "${req}" (docs.unoverse.ai/design/sdui-and-mcp-apps)`);
-    if (json.kind && !["component", "template", "atom"].includes(json.kind))
-      report("error", file, `unknown kind "${json.kind}"`);
-    if (json.kind === "component" && !json.category)
+    if (declared === undefined) report("error", file, `envelope missing "type" (docs.unoverse.ai/design/sdui-and-mcp-apps)`);
+    if (json.kind !== undefined && json.type === undefined)
+      report("warn", file, `"kind" is the legacy spelling of the declaration — write "type: ${json.kind}"`);
+    if (declared && !["component", "template", "atom"].includes(declared))
+      report("error", file, `unknown type "${declared}"`);
+    if (declared === "component" && !json.category)
       report("warn", file, `component has no "category". Used to group it in the palette (docs.unoverse.ai/design/sdui-and-mcp-apps)`);
     if (json.root) walkNode(json.root, file, root);
 
     // ── the contained-microapp discipline (mirrors microapp-structure.test.ts) ──
-    if (json.kind === "component") {
+    if (declared === "component") {
       const hasLayouts = existsSync(join(root, "layouts"));
       const statesDir = join(root, "states");
       const stateFiles = existsSync(statesDir)

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

@@ -13,7 +13,7 @@
 // ── ground truth (mirrors design/_schema/unoverse.schema.json + server guards) ──
 export const PRIMITIVES = new Set([
   "Box", "Stack", "Row", "Column", "Each", "Switch", "ComponentSlot", "Timeline",
-  "Text", "Image", "Button", "Input", "Select", "Markdown", "Skeleton", "Icon", "Ref", "Orb",
+  "Text", "Image", "Button", "Input", "Select", "Markdown", "Skeleton", "Icon", "Ref", "Orb", "Template",
 ]);
 export const CONDITION_KEYS = new Set(["field", "eq", "ne", "in"]);
 
@@ -56,6 +56,10 @@ export const PRIMITIVE_PROPS = {
   Switch: ["on", "cases", "fallback"],
   Ref: ["ref", "props", "with", "children", "name"],
   ComponentSlot: ["select", "frame", "fallback", "pinned", "appWidth"],
+  // THE MOUNT (UNOVERSE_TEMPLATE_MODEL §12): a layout place that runs a mounted
+  // template's machinery. `name` addresses the manifest's `templates:` entry;
+  // `frame` is the dressing drawn around it when occupied.
+  Template: ["name", "frame", "template", "director", "appWidth"],
   Timeline: ["user", "assistant", "userData", "assistantData", "autoScroll"],
 };