velloo 0.6.0 → 0.8.0

package/{chunk-eqjtq673.js → chunk-yjwtdm71.js}

@@ -1,2 +1,2 @@
 // @bun
-import{fail}from"./chunk-s23gtejf.js";import"./chunk-ff0jfn0v.js";import{SHELLS,completionScript,commandSpecs,detectShell,installCompletions}from"./chunk-jsvkqae2.js";import{require_picocolors}from"./chunk-jrsknzjt.js";import{__toESM,defineCommand}from"./chunk-2smsg2ct.js";var import_picocolors=__toESM(require_picocolors(),1);var completions_default=defineCommand({meta:{name:"completions",description:"Shell TAB completions \u2014 print the script, or install it with --install"},args:{shell:{type:"positional",required:!1,description:`Shell: ${SHELLS.join(" | ")} (default: detected from $SHELL)`},install:{type:"boolean",default:!1,description:"Write the script + wire it into your shell (idempotent)"}},async run({args}){let shell=args.shell??detectShell();if(!shell||!SHELLS.includes(shell))fail("completions",`unsupported or undetected shell${args.shell?` "${args.shell}"`:""} \u2014 pass one of: ${SHELLS.join(", ")}.`);if(!args.install){console.log(completionScript(shell,await commandSpecs()));return}let r=await installCompletions(shell);if(console.log(""),console.log(import_picocolors.default.green(`\u2713 ${shell} completions installed.`)),console.log(`    script   ${import_picocolors.default.cyan(r.scriptPath)}`),r.rcPath)console.log(r.rcUpdated?`    rc       ${import_picocolors.default.cyan(r.rcPath)} ${import_picocolors.default.dim("(source line appended)")}`:`    rc       ${import_picocolors.default.cyan(r.rcPath)} ${import_picocolors.default.dim("(already wired)")}`);console.log(""),console.log(import_picocolors.default.dim(shell==="fish"?"  New fish sessions pick it up automatically.":`  Restart your shell (or \`source ${r.rcPath}\`) to activate TAB completion.`))}});export{completions_default as default};
+import{fail}from"./chunk-s23gtejf.js";import"./chunk-32cq4wpr.js";import{SHELLS,completionScript,commandSpecs,detectShell,installCompletions}from"./chunk-asqpx5v7.js";import{require_picocolors}from"./chunk-jrsknzjt.js";import{__toESM,defineCommand}from"./chunk-2smsg2ct.js";var import_picocolors=__toESM(require_picocolors(),1);var completions_default=defineCommand({meta:{name:"completions",description:"Shell TAB completions \u2014 print the script, or install it with --install"},args:{shell:{type:"positional",required:!1,description:`Shell: ${SHELLS.join(" | ")} (default: detected from $SHELL)`},install:{type:"boolean",default:!1,description:"Write the script + wire it into your shell (idempotent)"}},async run({args}){let shell=args.shell??detectShell();if(!shell||!SHELLS.includes(shell))fail("completions",`unsupported or undetected shell${args.shell?` "${args.shell}"`:""} \u2014 pass one of: ${SHELLS.join(", ")}.`);if(!args.install){console.log(completionScript(shell,await commandSpecs()));return}let r=await installCompletions(shell);if(console.log(""),console.log(import_picocolors.default.green(`\u2713 ${shell} completions installed.`)),console.log(`    script   ${import_picocolors.default.cyan(r.scriptPath)}`),r.rcPath)console.log(r.rcUpdated?`    rc       ${import_picocolors.default.cyan(r.rcPath)} ${import_picocolors.default.dim("(source line appended)")}`:`    rc       ${import_picocolors.default.cyan(r.rcPath)} ${import_picocolors.default.dim("(already wired)")}`);console.log(""),console.log(import_picocolors.default.dim(shell==="fish"?"  New fish sessions pick it up automatically.":`  Restart your shell (or \`source ${r.rcPath}\`) to activate TAB completion.`))}});export{completions_default as default};

package/{chunk-8vam2893.js → chunk-z6r6wxm6.js}

@@ -1,3 +1,3 @@
 // @bun
-import{CURRENT_SCHEMA_VERSION}from"./chunk-8cj4swpr.js";import{snapshotVersion2}from"./chunk-p93x4pn2.js";import{TOOL_VERSION}from"./chunk-t6qr2ay9.js";function buildDefaultConfig(opts={}){return{schemaVersion:CURRENT_SCHEMA_VERSION,toolVersion:TOOL_VERSION,name:opts.name??"design",folderId:crypto.randomUUID(),libraries:{default:opts.library??{id:"shadcn-upstream",version:snapshotVersion2,source:"binary",componentsPath:"binary"}},defaultLibrary:"default",viewportPresets:[{name:"Mobile",w:390,h:844},{name:"Tablet",w:768,h:1024},{name:"Desktop",w:1440,h:900}],...opts.defaultScreen?{defaultScreen:opts.defaultScreen}:{},...opts.defaultBoard?{defaultBoard:opts.defaultBoard}:{},...opts.hostApp?{hostApp:opts.hostApp}:{},...opts.hostApps?{hostApps:opts.hostApps}:{},...opts.feedback?{feedback:opts.feedback}:{},...opts.styling?{styling:opts.styling}:{},...opts.codegen?{codegen:opts.codegen}:{},...opts.designSystem?{designSystem:opts.designSystem}:{}}}
+import{CURRENT_SCHEMA_VERSION}from"./chunk-xxw67jpk.js";import{snapshotVersion2}from"./chunk-p93x4pn2.js";import{TOOL_VERSION}from"./chunk-rrrn1mkq.js";function buildDefaultConfig(opts={}){return{schemaVersion:CURRENT_SCHEMA_VERSION,toolVersion:TOOL_VERSION,name:opts.name??"design",folderId:crypto.randomUUID(),libraries:{default:opts.library??{id:"shadcn-upstream",version:snapshotVersion2,source:"binary",componentsPath:"binary"}},defaultLibrary:"default",viewportPresets:[{name:"Mobile",w:390,h:844},{name:"Tablet",w:768,h:1024},{name:"Desktop",w:1440,h:900}],...opts.defaultScreen?{defaultScreen:opts.defaultScreen}:{},...opts.defaultBoard?{defaultBoard:opts.defaultBoard}:{},...opts.hostApp?{hostApp:opts.hostApp}:{},...opts.hostApps?{hostApps:opts.hostApps}:{},...opts.feedback?{feedback:opts.feedback}:{},...opts.styling?{styling:opts.styling}:{},...opts.codegen?{codegen:opts.codegen}:{},...opts.designSystem?{designSystem:opts.designSystem}:{},...opts.themeSource?{themeSource:opts.themeSource}:{}}}
 export{buildDefaultConfig};

package/{chunk-hsfpbjpc.js → chunk-zgwvkgsz.js}

@@ -1,2 +1,2 @@
 // @bun
-import"./chunk-1gkeepkm.js";import"./chunk-8cj4swpr.js";import{normalizeCloudUrl,loadCredential,listCredentials,deleteCredential,clearCredentials,revokeCredential}from"./chunk-2ba6edh8.js";import{defaultCloudUrl}from"./chunk-hjc5eg5c.js";import{defineCommand}from"./chunk-2smsg2ct.js";var logout_default=defineCommand({meta:{name:"logout",description:"Log out of velloo-cloud (signs the CLI token out and removes it)"},args:{url:{type:"string",description:"velloo-cloud base URL (default: $VELLOO_CLOUD_URL or the built-in default)"},all:{type:"boolean",default:!1,description:"Remove saved credentials for every cloud"}},async run({args}){if(args.all){await Promise.all(Object.entries(await listCredentials()).map(([cloudUrl,credential])=>revokeCredential(cloudUrl,credential.token)));let count=await clearCredentials();console.log(count>0?`velloo logout: removed credentials for ${count} cloud${count===1?"":"s"}`:"velloo logout: no saved credentials");return}let cloudUrl=args.url?normalizeCloudUrl(args.url):defaultCloudUrl(),existing=await loadCredential(cloudUrl);if(existing)await revokeCredential(cloudUrl,existing.token);if(await deleteCredential(cloudUrl))console.log(`velloo logout: logged out of ${cloudUrl}${existing?.email?` (${existing.email})`:""}`);else console.log(`velloo logout: not logged in to ${cloudUrl}`)}});export{logout_default as default};
+import"./chunk-bntsn3wj.js";import"./chunk-xxw67jpk.js";import{normalizeCloudUrl,loadCredential,listCredentials,deleteCredential,clearCredentials,revokeCredential}from"./chunk-rg86bhtb.js";import{defaultCloudUrl}from"./chunk-w30zfv3m.js";import{defineCommand}from"./chunk-2smsg2ct.js";var logout_default=defineCommand({meta:{name:"logout",description:"Log out of velloo-cloud (signs the CLI token out and removes it)"},args:{url:{type:"string",description:"velloo-cloud base URL (default: $VELLOO_CLOUD_URL or the built-in default)"},all:{type:"boolean",default:!1,description:"Remove saved credentials for every cloud"}},async run({args}){if(args.all){await Promise.all(Object.entries(await listCredentials()).map(([cloudUrl,credential])=>revokeCredential(cloudUrl,credential.token)));let count=await clearCredentials();console.log(count>0?`velloo logout: removed credentials for ${count} cloud${count===1?"":"s"}`:"velloo logout: no saved credentials");return}let cloudUrl=args.url?normalizeCloudUrl(args.url):defaultCloudUrl(),existing=await loadCredential(cloudUrl);if(existing)await revokeCredential(cloudUrl,existing.token);if(await deleteCredential(cloudUrl))console.log(`velloo logout: logged out of ${cloudUrl}${existing?.email?` (${existing.email})`:""}`);else console.log(`velloo logout: not logged in to ${cloudUrl}`)}});export{logout_default as default};

package/cli.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env bun
 // @bun
-import"./chunk-s23gtejf.js";import{COMMANDS}from"./chunk-ff0jfn0v.js";import{TOOL_VERSION}from"./chunk-t6qr2ay9.js";import{maybeNotifyAboutUpdate}from"./chunk-rk238m15.js";import{defineCommand,runMain}from"./chunk-2smsg2ct.js";var main=defineCommand({meta:{name:"velloo",version:TOOL_VERSION,description:"Open-source, local-first canvas for agent-driven design."},subCommands:COMMANDS});await runMain(main);var command=process.argv[2];if(!["mcp","__daemon","__update_check","run","upgrade"].includes(command??""))await maybeNotifyAboutUpdate();
+import"./chunk-s23gtejf.js";import{COMMANDS}from"./chunk-32cq4wpr.js";import{TOOL_VERSION}from"./chunk-rrrn1mkq.js";import{maybeNotifyAboutUpdate}from"./chunk-d19ttv1a.js";import{defineCommand,runMain}from"./chunk-2smsg2ct.js";var main=defineCommand({meta:{name:"velloo",version:TOOL_VERSION,description:"Open-source, local-first canvas for agent-driven design."},subCommands:COMMANDS});await runMain(main);var command=process.argv[2];if(!["mcp","__daemon","__update_check","run","upgrade"].includes(command??""))await maybeNotifyAboutUpdate();

package/launcher.cjs

@@ -80,7 +80,9 @@ const runtime = join(runtimeRoot, "bin", process.platform === "win32" ? "bun.exe
 if (!existsSync(runtime)) die(`the Bun runtime package ${runtimeName} is incomplete`);
 
 const app = join(__dirname, "cli.js");
-const child = spawnSync(runtime, [app, ...process.argv.slice(2)], {
+// `--no-install`: Bun must never answer an import from its global cache or
+// fetch a package to do it — see BUN_RUNTIME_FLAGS in src/bun-runtime.ts.
+const child = spawnSync(runtime, ["--no-install", app, ...process.argv.slice(2)], {
   stdio: "inherit",
   env: {
     ...process.env,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "velloo",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "type": "module",
   "description": "Local-first, code-shaped design canvas — your AI agent designs with your real components, in your repo",
   "license": "Apache-2.0",

package/pkgs/helpers/src/box.tsx

@@ -9,13 +9,19 @@ import type * as React from "react";
 import { createElement } from "react";
 import { cn } from "./cn.ts";
 
-// Restrict `as` to a lowercase HTML tag name. Anything else (a component
-// reference, an injection attempt) falls back to div. Rendering the real tag
-// means inline elements (span/strong/a/…) get their natural inline display
-// from the UA stylesheet, instead of a div's block stacking inline runs.
-const TAG = /^[a-z][a-z0-9]*$/;
+/**
+ * An element name: an HTML tag, or one of SVG's camelCase ones
+ * (`linearGradient`, `clipPath`). Shared by everything that has to agree on
+ * what `as` may hold — compose's lowering, each `Box`, and codegen — because a
+ * tag one of them accepts and another doesn't renders as a `div`.
+ */
+export const ELEMENT_TAG = /^[a-z][a-zA-Z0-9]*$/;
 
+// Restrict `as` to an element name. Anything else (a component reference, an
+// injection attempt) falls back to div. Rendering the real tag means inline
+// elements (span/strong/a/…) get their natural inline display from the UA
+// stylesheet, instead of a div's block stacking inline runs.
 export function Box({ as, className, ...props }: React.ComponentProps<"div"> & { as?: string }) {
-  const tag = typeof as === "string" && TAG.test(as) ? as : "div";
+  const tag = typeof as === "string" && ELEMENT_TAG.test(as) ? as : "div";
   return createElement(tag, { "data-slot": "box", className: cn(className), ...props });
 }

package/pkgs/helpers/src/descriptors.ts

@@ -233,6 +233,12 @@ export const HELPER_DESCRIPTORS: readonly ComponentDescriptor[] = [
     props: [
       { name: "content", type: "string | undefined", optional: true, control: "string" },
       { name: "viewBox", type: "string | undefined", optional: true, control: "string" },
+      {
+        name: "preserveAspectRatio",
+        type: "string | undefined",
+        optional: true,
+        control: "string",
+      },
       { name: "color", type: "string | undefined", optional: true, control: "color" },
     ],
     example: {

package/pkgs/helpers/src/icon.tsx

@@ -27,11 +27,13 @@ function lookup(name: string): IconNode | undefined {
   return viaPascal === undefined ? undefined : ICON_NODES[viaPascal];
 }
 
-const FALLBACK = lookup("HelpCircle");
-
 export function Icon({ name, className, size = 16, strokeWidth = 2, ...props }: IconProps) {
   const hit = lookup(name);
-  const node = hit ?? FALLBACK;
+  // Looked up here, not once at module level: a call at the top of this file
+  // is a side effect to a bundler, which then keeps the module — and the 0.6 MB
+  // of icon data behind it — in every bundle that imports anything at all from
+  // the helpers index, `Icon` on the screen or not.
+  const node = hit ?? lookup("HelpCircle");
   if (!node) return null;
   const tint = hit ? className : cn("text-[var(--color-fg-muted)]", className);
   return (

package/pkgs/helpers/src/index.ts

@@ -1,4 +1,4 @@
-export { Box } from "./box.tsx";
+export { Box, ELEMENT_TAG } from "./box.tsx";
 export { cn, mergeTailwind } from "./cn.ts";
 export { HELPER_DESCRIPTORS, helperDescriptors } from "./descriptors.ts";
 export { Divider, type DividerProps } from "./divider.tsx";
@@ -29,4 +29,4 @@ export {
 export { Prose, type ProseProps } from "./prose.tsx";
 export { helpersRegistry } from "./registry.ts";
 export { SVG, type SVGProps } from "./svg.tsx";
-export { Text, type TextProps } from "./text.tsx";
+export { Text, type TextProps, TextRunContext, textTag } from "./text.tsx";

package/pkgs/helpers/src/text.tsx

@@ -3,14 +3,38 @@ import { textClasses } from "@velloo/schema/typeset";
 import * as React from "react";
 import { cn } from "./cn.ts";
 
-export interface TextProps extends React.HTMLAttributes<HTMLParagraphElement> {
+export interface TextProps extends React.HTMLAttributes<HTMLElement> {
   /** Visual weight. Selects a rung of the theme's type ladder plus a tone. */
   variant?: "default" | "muted" | "small" | "lead";
 }
 
-export const Text = React.forwardRef<HTMLParagraphElement, TextProps>(
-  ({ variant = "default", className, ...props }, ref) => (
-    <p ref={ref} className={cn(textClasses(variant), className)} {...props} />
-  ),
+/**
+ * True beneath a `Text`. A paragraph cannot hold a paragraph: an HTML parser
+ * ends the outer `<p>` where the inner one starts, so markup that is rendered
+ * on the server and parsed again (a screenshot, a comparison) lays the inner
+ * text out as a sibling, while the same tree mounted on the client keeps it
+ * nested. A `Text` inside a `Text` is a run of that paragraph, so it renders
+ * the element a run is — and every path draws the same line.
+ */
+export const TextRunContext = React.createContext(false);
+
+/** The element a `Text` renders: a paragraph, or a run inside one. */
+export function textTag(run: boolean): "p" | "span" {
+  return run ? "span" : "p";
+}
+
+export const Text = React.forwardRef<HTMLElement, TextProps>(
+  ({ variant, className, ...props }, ref) => {
+    const run = React.useContext(TextRunContext);
+    return (
+      <TextRunContext.Provider value={true}>
+        {React.createElement(textTag(run), {
+          ref,
+          className: cn(textClasses(variant, run), className) || undefined,
+          ...props,
+        })}
+      </TextRunContext.Provider>
+    );
+  },
 );
 Text.displayName = "Text";

package/pkgs/provider-antd/src/index.ts

@@ -54,6 +54,7 @@ export function createProvider(): FrameworkAdapter {
       ),
     styleChannel: STYLE_PROP,
     styleChannels: ["style"],
+    themeRoles: ["background", "foreground", "primary", "destructive", "card"],
     mcpIntro: () => [...ANTD_INTRO],
     renderPass: (theme, dark) => makeRenderPass(theme, dark ?? false),
     codegenModule: "antd",

package/pkgs/provider-antd/src/manifest.ts

@@ -838,6 +838,7 @@ export const ANTD_MANIFEST: Manifest = [
     [
       { name: "content", type: "string", optional: false, control: "string" },
       { name: "viewBox", type: "string", optional: false, control: "string" },
+      { name: "preserveAspectRatio", type: "string", optional: true, control: "string" },
     ],
     "Raw inline SVG markup.",
   ),

package/pkgs/provider-chakra/src/manifest.ts

@@ -403,6 +403,7 @@ export const CHAKRA_MANIFEST: Manifest = [
     [
       { name: "content", type: "string", optional: false, control: "string" },
       { name: "viewBox", type: "string", optional: false, control: "string" },
+      { name: "preserveAspectRatio", type: "string", optional: true, control: "string" },
     ],
     "Raw inline SVG markup.",
   ),

package/pkgs/provider-html/src/index.ts

@@ -59,6 +59,7 @@ export function createProvider(): FrameworkAdapter {
     loadManifest: async () => HTML_MANIFEST,
     styleChannel: STYLE_PROP,
     styleChannels: ["style"],
+    themeRoles: ["background", "foreground", "card", "muted", "border", "input"],
     registryForChannel: () => registry,
     mcpIntro: () => HTML_INTRO,
     hostStylesheets: true,

package/pkgs/provider-mui/src/index.ts

@@ -57,6 +57,16 @@ export function createProvider(): FrameworkAdapter {
       ),
     styleChannel: SX_PROP,
     styleChannels: ["sx"],
+    themeRoles: [
+      "background",
+      "foreground",
+      "primary",
+      "secondary",
+      "destructive",
+      "card",
+      "muted",
+      "border",
+    ],
     mcpIntro: () => [...MUI_INTRO],
     renderPass: (theme, dark) => makeRenderPass(theme, dark ?? false),
     codegenModule: "@mui/material",

package/pkgs/provider-mui/src/manifest.ts

@@ -250,6 +250,7 @@ export const MUI_MANIFEST: Manifest = [
     [
       { name: "content", type: "string", optional: false, control: "string" },
       { name: "viewBox", type: "string", optional: false, control: "string" },
+      { name: "preserveAspectRatio", type: "string", optional: true, control: "string" },
     ],
     "Raw inline SVG markup.",
   ),

package/pkgs/provider-none/src/components-inline.tsx

@@ -1,12 +1,7 @@
+import { ELEMENT_TAG, TextRunContext, textTag } from "@velloo/helpers";
 import { headingInlineStyle, textInlineStyle } from "@velloo/schema/typeset";
 import * as React from "react";
-import {
-  BOX_TAG,
-  type ButtonProps,
-  type ContainerProps,
-  type InputProps,
-  type StackProps,
-} from "./components.tsx";
+import type { ButtonProps, ContainerProps, InputProps, StackProps } from "./components.tsx";
 
 /**
  * Inline-styled variants of the no-library primitives, for a `none`-CSS folder
@@ -38,7 +33,10 @@ export const Box = React.forwardRef<
   HTMLDivElement,
   React.HTMLAttributes<HTMLDivElement> & { as?: string }
 >(({ as, ...rest }, ref) =>
-  React.createElement(typeof as === "string" && BOX_TAG.test(as) ? as : "div", { ref, ...rest }),
+  React.createElement(typeof as === "string" && ELEMENT_TAG.test(as) ? as : "div", {
+    ref,
+    ...rest,
+  }),
 );
 Box.displayName = "Box";
 
@@ -201,13 +199,21 @@ export const Heading = React.forwardRef<HTMLHeadingElement, HeadingProps>(
 );
 Heading.displayName = "Heading";
 
-interface TextProps extends React.HTMLAttributes<HTMLParagraphElement> {
+interface TextProps extends React.HTMLAttributes<HTMLElement> {
   variant?: "default" | "muted" | "small" | "lead";
 }
 
-export const Text = React.forwardRef<HTMLParagraphElement, TextProps>(
-  ({ variant = "default", style, ...rest }, ref) => (
-    <p ref={ref} style={merge(textInlineStyle(variant), style)} {...rest} />
-  ),
-);
+// A `Text` inside a `Text` is a run of it — see `TextRunContext`.
+export const Text = React.forwardRef<HTMLElement, TextProps>(({ variant, style, ...rest }, ref) => {
+  const run = React.useContext(TextRunContext);
+  return (
+    <TextRunContext.Provider value={true}>
+      {React.createElement(textTag(run), {
+        ref,
+        style: merge(textInlineStyle(variant, run), style),
+        ...rest,
+      })}
+    </TextRunContext.Provider>
+  );
+});
 Text.displayName = "Text";

package/pkgs/provider-none/src/components.tsx

@@ -3,6 +3,7 @@ import {
   BUTTON_VARIANT_CLASS,
   CARD_CLASS,
   CONTAINER_WIDTH_CLASS,
+  ELEMENT_TAG,
   INPUT_CLASS,
   STACK_ALIGN_CLASS,
   STACK_JUSTIFY_CLASS,
@@ -23,12 +24,9 @@ import * as React from "react";
 
 interface DivProps extends React.HTMLAttributes<HTMLDivElement> {}
 
-/** `as` takes a lowercase HTML tag only — anything else renders the div. */
-export const BOX_TAG = /^[a-z][a-z0-9]*$/;
-
 export const Box = React.forwardRef<HTMLDivElement, DivProps & { as?: string }>(
   ({ as, className, ...rest }, ref) =>
-    React.createElement(typeof as === "string" && BOX_TAG.test(as) ? as : "div", {
+    React.createElement(typeof as === "string" && ELEMENT_TAG.test(as) ? as : "div", {
       ref,
       className: clsx(className),
       ...rest,

package/pkgs/provider-none/src/index.ts

@@ -59,6 +59,7 @@ export function createProvider(): FrameworkAdapter {
     // is `none` resolves to the inline-`style` channel instead.
     styleChannel: TAILWIND_CLASSNAME,
     styleChannels: ["tailwind-classname", "style"],
+    themeRoles: ["background", "foreground", "card", "muted", "border", "input"],
     mcpIntro: (channel) => [...(channel === "style" ? NONE_INLINE_INTRO : NONE_INTRO)],
     // Inline-styled primitives for the `style` channel; Tailwind-classed for
     // every other channel. Lets a `none/none` folder paint with the JIT off.

package/pkgs/schema/src/board.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { FlowEdgeSchema } from "./flow.ts";
 import { FrameSchema } from "./frame.ts";
 import { ResourceIdSchema } from "./ids.ts";
 
@@ -12,7 +13,11 @@ import { ResourceIdSchema } from "./ids.ts";
 export const BoardGroupSchema = z.object({
   id: ResourceIdSchema,
   name: z.string().min(1),
-  /** CSS color value; canvas uses it for the group region tint and tag chip. */
+  /**
+   * CSS color value. The sidebar uses a board group's for its chip and rail;
+   * a frame group may carry one, but the canvas draws nothing for frame
+   * groups yet.
+   */
   color: z.string().optional(),
 });
 
@@ -61,6 +66,13 @@ export const BoardSchema = z.object({
   frames: z.array(FrameSchema).default([]),
   /** Frame regions within this board (see {@link BoardGroupSchema}). */
   groups: z.array(BoardGroupSchema).default([]),
+  /**
+   * Arrows between this board's frames (see {@link FlowEdgeSchema}). Absent ⇒
+   * a board of unconnected frames, which is every existing one — and the field
+   * is dropped again when the last arrow goes, so such a board's file never
+   * changes shape.
+   */
+  edges: z.array(FlowEdgeSchema).optional(),
 });
 
 export type Board = z.infer<typeof BoardSchema>;

package/pkgs/schema/src/config.ts

@@ -106,6 +106,38 @@ export const HostAppSchema = z.object({
 
 export type HostApp = z.infer<typeof HostAppSchema>;
 
+/**
+ * Where the design's theme came from in the app: what `velloo init` read (or
+ * left alone), and what an `import_theme` from a stylesheet into the default
+ * theme records again. Agents are told by it what checking the theme against
+ * the app means — a theme read from a JavaScript theme object (`mantine`,
+ * `mui`) is compared with that module, since no stylesheet holds it.
+ *
+ *   "stylesheet"       — the app's stylesheet, and what it brings with it.
+ *   "design-md"        — a DESIGN.md, layered on the stylesheet.
+ *   "mantine" / "mui"  — the theme object the app hands that library.
+ *   "library-defaults" — the app uses `library` and sets no theme of its own,
+ *                        so the design is on that library's.
+ *   "preset"           — nothing of the app's: a built-in preset.
+ */
+export const ThemeSourceSchema = z.object({
+  kind: z.enum(["stylesheet", "design-md", "mantine", "mui", "library-defaults", "preset"]),
+  /**
+   * The app's files it was read from, relative to the app root, the one
+   * `kind` names first: a stylesheet is followed by the sheets it imports,
+   * the tailwind.config it merged and the modules whose font loader calls
+   * set a face. Absent when nothing was read from a file in the app.
+   */
+  files: z.array(AppRelativePathSchema).min(1).optional(),
+  /** The library whose own theme it is — for `"library-defaults"`. */
+  library: z.string().min(1).optional(),
+});
+
+export type ThemeSource = z.infer<typeof ThemeSourceSchema>;
+
+/** The CSS framework a folder styles with. See `ConfigSchema.styling`. */
+export const StylingSchema = z.object({ framework: z.enum(["tailwind", "none"]) });
+
 /**
  * Folder config. Multi-library: a folder registers N libraries by id
  * and pins one as the default; each screen optionally declares which
@@ -186,7 +218,7 @@ export const ConfigSchema = z
      * server rejects a folder whose CSS framework no registered library
      * supports (e.g. shadcn + none).
      */
-    styling: z.object({ framework: z.enum(["tailwind", "none"]) }).optional(),
+    styling: StylingSchema.optional(),
     /** Host app location for the live-island bundler. See `HostAppSchema`. */
     hostApp: HostAppSchema.optional(),
     /**
@@ -203,6 +235,11 @@ export const ConfigSchema = z
      * a file somewhere unconventional, or pins the choice when several exist.
      */
     designSystem: z.object({ path: AppRelativePathSchema }).optional(),
+    /**
+     * Where the default theme was read from in the app. See `ThemeSourceSchema`.
+     * Absent for a design made before it was recorded: nothing is assumed.
+     */
+    themeSource: ThemeSourceSchema.optional(),
     /**
      * Named host apps for monorepos — the multi-app twin of `hostApp`, keyed
      * by a short app name (`"web"`, `"admin"`; `init`'s multi-app scan uses