@unoverse-platform/studio 0.1.56 → 0.1.58

package/local/plugin.ts

@@ -222,7 +222,7 @@ export function localStudioHost(): Plugin {
         // 200. That has now cost three separate bugs (the /api allowlist, the dev proxy for
         // /.well-known and /publish), each of which looked like a missing route rather than
         // a filtered one.
-        if (!/^\/(dev|local|mcp|skills|prompt-blocks|registry|nodes|keys|execute|publish)\b/.test(path)) return next();
+        if (!/^\/(dev|local|mcp|skills|prompt-blocks|registry|nodes|keys|execute)\b/.test(path)) return next();
 
         /** Read a JSON request body. */
         const body = async (): Promise<Record<string, unknown>> => {
@@ -248,71 +248,10 @@ export function localStudioHost(): Plugin {
                 envFiles: [resolve(projectRoot, "..", ".env"), resolve(projectRoot, ".env")],
               });
 
-            /**
-             * PUBLISH, in two calls: plan then send.
-             *
-             * It runs HERE rather than in the browser because publishing reads the
-             * developer's disk: their definitions, and the design system they built on.
-             * A browser cannot, and a server that could would be a server this tool
-             * deliberately does not have.
-             *
-             * The token is passed per request and never stored. Studio holds it in the
-             * OIDC session for the tab (UniverseSession) and hands it over for the one
-             * call; local Studio writes no secret to disk (local/keys.ts), and connecting
-             * to a universe must not be the thing that breaks that.
-             *
-             * Same functions the CLI uses (`unoverse publish assets`), so the two cannot
-             * disagree about what a publish is.
-             */
-            case path === "/publish/plan" || path === "/publish/send": {
-              const b = await body();
-              const project = String(b.project ?? "");
-              const universe = String(b.universe ?? "");
-              const token = String(b.token ?? "");
-              if (!project || !universe || !token)
-                return json(res, { error: "project, universe and token are required" }, 400);
-
-              // Loaded through Vite's SSR runner, like the catalog and node loaders above: a bare
-              // dynamic import of a .js path does not resolve to the .ts source. The type below
-              // mirrors the module's real exports — tsc can't follow an ssrLoadModule path.
-              type PublishItem = { kind: string; name: string; why?: string; mode?: string };
-              type PublishModule = {
-                lintForPublish(designRoot: string, project: string): Promise<{ problems: unknown[]; errors: unknown[] }>;
-                collectProject(designRoot: string, project: string): unknown;
-                planPublish(collected: unknown, universe: string, token: string): Promise<Record<string, PublishItem[]>>;
-                sendPublish(plan: unknown, universe: string, token: string): Promise<{ sent: PublishItem[]; failed?: PublishItem[] }>;
-              };
-              const items = (await ssr(`${baseSrc}/items/publish.ts`)) as PublishModule;
-              const designRoot = designHome(projectRoot);
-
-              // LINT FIRST, ALWAYS. Nothing leaves the machine until the rules pass: a
-              // developer should learn about a raw hex value here, not from an HTTP error.
-              const { problems, errors } = await items.lintForPublish(designRoot, project);
-              if (errors.length) return json(res, { blocked: true, problems, errors });
-
-              const collected = items.collectProject(designRoot, project);
-              const plan = await items.planPublish(collected, universe, token);
-
-              // The screen renders kinds and names. The plan carries every file's full
-              // contents, so sending it whole would push the entire project through the
-              // browser for a list, and again on send.
-              type Lean = { kind: string; name: string; why?: string; mode?: string };
-              const lean = (list: Lean[] = []) =>
-                list.map(({ kind, name, why, mode }) => ({ kind, name, why, mode }));
-              const leanPlan = Object.fromEntries(
-                Object.entries(plan as Record<string, Lean[]>).map(([k, v]) => [k, lean(v)]),
-              );
-
-              if (path === "/publish/plan") return json(res, { problems, plan: leanPlan });
-
-              const result = await items.sendPublish(plan, universe, token);
-              return json(res, {
-                problems,
-                plan: leanPlan,
-                sent: lean(result.sent),
-                failed: lean(result.failed),
-              });
-            }
+            // NO PUBLISH ROUTES. Studio had /publish/plan and /publish/send; they moved
+            // to the terminal whole (LOCAL_STUDIO.md §Publish is terminal-only): the CLI
+            // runs the same base items/publish functions directly, and no token ever
+            // nears the browser because the browser no longer takes part.
 
             case path === "/dev/orgs":
               return json(res, { orgs: c.themeOrgs() });

package/local/sample-template/chat/components/assistant-turn.yaml

@@ -0,0 +1,40 @@
+type: Box
+visibleWhen: active
+style:
+  direction: row
+  gap: "2"
+  align: start
+children:
+  - type: Box
+    style:
+      direction: column
+      flex: 1
+      gap: "2"
+      minWidth: 0
+    children:
+      - type: ComponentSlot
+        select: {}
+      - type: Box
+        visibleWhen: streaming
+        children:
+          - type: Box
+            visibleWhen: empty
+            style:
+              direction: row
+              gap: "2"
+              align: center
+            children:
+              - $include: components/thinking-dots
+              - type: Text
+                bind:
+                  value: thinkingText
+                style:
+                  font: body.sm
+                  color: text.secondary
+      - type: Text
+        visibleWhen: time
+        bind:
+          value: time
+        style:
+          font: body.sm
+          color: text.secondary

package/local/sample-template/chat/components/core-focus.yaml

@@ -0,0 +1,46 @@
+# THE CHAT COLUMN WITH A FOCUSED COMPONENT OVER IT — core, plus the focus surface
+# laid over the conversation region. A core VARIANT, not a copy: header, states and
+# composer are the same shared files core.yaml includes; the only difference is the
+# overlay slot.
+type: Box
+appWidth: chat
+style:
+  direction: column
+  minHeight: "0"
+children:
+  - type: Box
+    style:
+      direction: column
+      flex: 1
+      minHeight: "0"
+      position: relative
+    children:
+      - $include: components/header
+      - type: Box
+        style:
+          direction: column
+          flex: 1
+          minHeight: "0"
+          position: relative
+          when:
+            - field: hasMessages
+              eq: true
+              apply:
+                background: surface.base
+                radiusTopLeft: 2xl
+                overflow: hidden
+        children:
+          - $include: states/welcome
+          - $include: states/conversation
+      - type: Box
+        style:
+          position: absolute
+          bottom: "0"
+          left: "0"
+          right: "0"
+          direction: column
+        children:
+          - $include: components/suggestions
+      - $include: components/focus-overlay
+  - type: Ref
+    ref: composer-bar

package/local/sample-template/chat/components/core.yaml

@@ -0,0 +1,41 @@
+type: Box
+appWidth: chat
+style:
+  direction: column
+  minHeight: "0"
+children:
+  - type: Box
+    style:
+      direction: column
+      flex: 1
+      minHeight: "0"
+      position: relative
+    children:
+      - $include: components/header
+      - type: Box
+        style:
+          direction: column
+          flex: 1
+          minHeight: "0"
+          position: relative
+          when:
+            - field: hasMessages
+              eq: true
+              apply:
+                background: surface.base
+                radiusTopLeft: 2xl
+                overflow: hidden
+        children:
+          - $include: states/welcome
+          - $include: states/conversation
+      - type: Box
+        style:
+          position: absolute
+          bottom: "0"
+          left: "0"
+          right: "0"
+          direction: column
+        children:
+          - $include: components/suggestions
+  - type: Ref
+    ref: composer-bar

package/local/sample-template/chat/components/focus-overlay.yaml

@@ -0,0 +1,20 @@
+type: ComponentSlot
+select:
+  from: all
+  where:
+    field: view
+    eq: focused
+  limit: 1
+frame:
+  type: Box
+  style:
+    position: absolute
+    inset: "0"
+    width: full
+    height: full
+    background: surface.base
+    overflow: hidden
+    direction: column
+    align: stretch
+  children:
+    - type: ComponentSlot

package/local/sample-template/chat/components/header.yaml

@@ -0,0 +1,53 @@
+type: Box
+style:
+  direction: row
+  align: center
+  justify: space-between
+  height: "20"
+  padding: [ "0", "4" ]
+  background: transparent
+children:
+  - type: Box
+    style:
+      direction: row
+      align: center
+      gap: "2"
+    children:
+      - type: Icon
+        icon: sparkles
+        style:
+          width: "6"
+          height: "6"
+          color: action.primary
+      - type: Text
+        style:
+          font: title
+          color: text.primary
+        value: Assistant
+  - type: Button
+    action: close
+    style:
+      flex: 0 0 auto
+      cursor: pointer
+      width: "8"
+      height: "8"
+      radius: full
+      background: surface.base
+      border: subtle
+      shadow: sm
+      direction: row
+      align: center
+      justify: center
+      transition: all 150ms ease
+      hover:
+        background: surface.sunken
+    children:
+      - type: Icon
+        icon: close
+        style:
+          width: "4"
+          height: "4"
+          color: text.secondary
+    visibleWhen:
+      field: surfacedView
+      in: [ "" ]

package/local/sample-template/chat/components/suggestions.yaml

@@ -0,0 +1,142 @@
+type: Box
+visibleWhen: hasMessages
+style:
+  width: full
+  position: relative
+  direction: column
+  background: transparent
+children:
+  - type: Box
+    visibleWhen:
+      field: openPanel
+      eq: faq
+    style:
+      width: full
+      direction: column
+      gap: "2"
+      background: surface.base
+      radius: lg
+      padding: "4"
+      shadow: lg
+      margin: [ "0", "0", "2", "0" ]
+      animation:
+        name: slideUp
+        duration: 0.3s
+        easing: ease-out
+        iteration: "1"
+    children:
+      - type: Box
+        style:
+          direction: row
+          justify: end
+        children:
+          - type: Button
+            action:
+              type: setTemplateValue
+              values:
+                - key: openPanel
+                  value: null
+            style:
+              flex: 0 0 auto
+              cursor: pointer
+              width: "8"
+              height: "8"
+              radius: full
+              background: surface.base
+              border: subtle
+              shadow: sm
+              direction: row
+              align: center
+              justify: center
+              transition: all 150ms ease
+              hover:
+                background: surface.sunken
+            children:
+              - type: Icon
+                icon: close
+                style:
+                  width: "4"
+                  height: "4"
+                  color: text.secondary
+      - type: Each
+        style:
+          direction: row
+          wrap: wrap
+          align: start
+          gap: "2"
+          width: full
+        template:
+          type: Button
+          action:
+            type: sendMessage
+            then:
+              type: setTemplateValue
+              values:
+                - key: openPanel
+                  value: null
+          style:
+            direction: row
+            align: center
+            flex: 0 0 auto
+            maxWidth: full
+            padding: [ "2", "4" ]
+            background: surface.base
+            border: subtle
+            outline: none
+            radius: full
+            shadow: sm
+            cursor: pointer
+            transition: all 150ms ease
+            hover:
+              background: surface.sunken
+          children:
+            - type: Text
+              bind:
+                value: text
+              style:
+                font: body.sm
+                color: text.secondary
+                lineHeight: tight
+        items:
+          - text: What can you help me with?
+          - text: How does this work?
+          - text: Show me an example
+  - type: Box
+    style:
+      width: full
+      direction: row
+      justify: center
+      padding: [ "1", "0" ]
+    children:
+      - type: Button
+        action:
+          type: setTemplateValue
+          values:
+            - key: openPanel
+              value: faq
+        style:
+          direction: row
+          align: center
+          gap: "1"
+          padding: [ "1", "3" ]
+          background: surface.base
+          border: subtle
+          outline: none
+          radius: full
+          cursor: pointer
+          transition: all 150ms ease
+          hover:
+            background: surface.sunken
+        children:
+          - type: Icon
+            icon: chat
+            style:
+              width: "4"
+              height: "4"
+              color: text.secondary
+          - type: Text
+            style:
+              font: body.sm
+              color: text.secondary
+              weight: medium
+            value: Suggestions

package/local/sample-template/chat/components/thinking-dots.yaml

@@ -0,0 +1,38 @@
+type: Box
+style:
+  direction: row
+  gap: "1"
+  align: center
+children:
+  - type: Box
+    style:
+      width: "1.5"
+      height: "1.5"
+      background: action.primary
+      radius: full
+      animation:
+        name: wave
+        duration: 1.6s
+        easing: ease-in-out
+  - type: Box
+    style:
+      width: "1.5"
+      height: "1.5"
+      background: action.primary
+      radius: full
+      animation:
+        name: wave
+        duration: 1.6s
+        easing: ease-in-out
+      animationDelay: 0.16s
+  - type: Box
+    style:
+      width: "1.5"
+      height: "1.5"
+      background: action.primary
+      radius: full
+      animation:
+        name: wave
+        duration: 1.6s
+        easing: ease-in-out
+      animationDelay: 0.32s

package/local/sample-template/chat/components/user-turn.yaml

@@ -0,0 +1,22 @@
+type: Box
+style:
+  direction: row
+  justify: end
+children:
+  - type: Box
+    style:
+      direction: row
+      align: center
+      background: action.primary
+      radius: 2xl
+      radiusTopRight: sm
+      padding: [ "2", "4" ]
+      maxWidth: compact
+    children:
+      - type: Text
+        bind:
+          value: text
+        style:
+          font: body.md
+          color: action.primary-text
+          lineHeight: tight

package/local/sample-template/chat/layouts/focused.yaml

@@ -0,0 +1,12 @@
+# FOCUSED — a component holding the conversation region, composer live beneath.
+# A LAYOUT owned by the `focused` state: a hosted component writes `view: focused`,
+# the ladder makes this arrangement active, this file draws it.
+type: Box
+style:
+  direction: row
+  width: full
+  height: full
+  overflow: hidden
+  background: surface.sunken
+children:
+  - $include: components/core-focus

package/local/sample-template/chat/layouts/standard.yaml

@@ -0,0 +1,9 @@
+type: Box
+style:
+  direction: row
+  width: full
+  height: full
+  overflow: hidden
+  background: surface.sunken
+children:
+  - $include: components/core

package/local/sample-template/chat/manifest.yaml

@@ -0,0 +1,41 @@
+# A GENERIC CHAT — a worked example template, shipped with Studio so templates/ is
+# never an empty folder. It is yours: rename it, restyle it (it uses only foundation
+# tokens, so your project's theme restyles it whole), or delete it.
+# Guide: https://docs.unoverse.ai/design/templates.md
+name: chat
+description: A conversational assistant surface with a welcome hero, suggestions, and a focus overlay.
+whenToUse: Talk to the assistant — ask a question, get help, or start any task in conversation. The conversational home and fallback surface.
+category: Assistant
+version: 1.0.0
+defaultState: template
+inputSchema:
+  type: object
+  properties:
+    message:
+      type: string
+      description: The user's request
+
+# THE TEMPLATE TREE (State Model v2): one declaration, everything follows.
+# Top-level order IS the priority ladder (base first, then reaction states). NESTING
+# is containment: welcome exists only inside standard — the compiler strips it from
+# every other arrangement — and it is the landing default. No stateOrder, no
+# hand-written guards.
+# NOTE: the conversation timeline is NOT declared as a substate — it is standard's own
+# shell content (states/conversation), included by the shared chrome (components/core)
+# and legitimately drawn under the focus overlay too. Declaring it would contain it to
+# standard and empty the chat column in every reaction state.
+states:
+  standard:
+    states:
+      welcome: {}
+  focused: {}
+
+preview:
+  conversation: [ markdown-renderer ]
+  focused: [ card ]
+
+autoTrigger: false
+# BIND YOUR WORKFLOW to bring this to life: build one on the Canvas, then set
+#   binding: { workflow: <workflow-id>, trigger: <trigger-node-id> }
+# The app owns its workflow; until it is bound, this template previews but cannot run.
+layout: standard

package/local/sample-template/chat/states/conversation.yaml

@@ -0,0 +1,21 @@
+type: Box
+visibleWhen: hasMessages
+autoScroll: true
+style:
+  flex: 1
+  minHeight: "0"
+  direction: column
+  overflow: auto
+  padding: [ "6", "8" ]
+children:
+  - type: Timeline
+    style:
+      direction: column
+      gap: "4"
+      margin: [ auto, "0", "0", "0" ]
+    assistantData:
+      thinkingText: Thinking…
+    user:
+      $include: components/user-turn
+    assistant:
+      $include: components/assistant-turn