@valancex/cli 0.13.0 → 0.15.0

package/dist/ui/run.d.ts

@@ -14,4 +14,5 @@ export declare const drawDev: (root: string, options: {
     readonly target?: TargetId;
     readonly port?: number;
     readonly host?: string;
+    readonly record?: string;
 }) => Promise<void>;

package/dist/ui/run.js

@@ -35,14 +35,27 @@ export const drawCheck = async (root) => {
 export const drawBuild = async (root, targets = []) => {
     const started = Date.now();
     const shown = show(_jsx(BuildProgress, { current: "configuration" }));
+    let measured = [];
     try {
         const built = await runBuild(root, {
             ...(targets.length === 0 ? {} : { targets }),
+            onReport: (report) => {
+                measured = report;
+            },
             onStage: ((stage) => shown.rerender(_jsx(BuildProgress, { current: stage }))),
         });
         shown.rerender(_jsx(BuildResult, { built: built, seconds: (Date.now() - started) / 1000 }));
         return built;
     }
+    catch (error) {
+        // A budget error stops the build after the bundle is measured: the report says by how much.
+        if (measured.length > 0) {
+            shown.unmount();
+            await shown.waitUntilExit();
+            measured.forEach((line) => console.error(line));
+        }
+        throw error;
+    }
     finally {
         shown.unmount();
         await shown.waitUntilExit();

package/dist/vite.js

@@ -1,5 +1,6 @@
-import { createLogger, createServer } from "vite";
+import { createLogger, createServer, defaultClientConditions, defaultServerConditions } from "vite";
 import { join, relative, sep } from "node:path";
+import { CONDITION, librariesOf } from "./libraries.js";
 import { GENERATED_DIR, OUTPUT_DIR } from "./project.js";
 export const CLIENT_ENTRY = `${GENERATED_DIR}/client.ts`;
 export const SERVER_ENTRY = `/${GENERATED_DIR}/server.ts`;
@@ -30,7 +31,19 @@ export const templates = (root) => ({
     // The module is only the file's address, so a change to the template changes nothing the browser holds; the rebuild (dev.ts) recompiles it and reloads once, with the overlay if it fails.
     handleHotUpdate: ({ file }) => (file.endsWith(".mprx") ? [] : undefined),
 });
+/**
+ * What marked packages (libraries, K4) need from the bundler: the `valance` export condition resolved, for the browser and for the server, and the packages processed by Vite instead of loaded by
+ * Node, which does not know `.mprx` or `.css`. Added for every project, with nothing to write: a project with no library has no package that has the condition.
+ */
+const librarySettings = (root) => {
+    const names = librariesOf(root).libraries.map((each) => each.name);
+    return {
+        resolve: { conditions: [CONDITION, ...defaultClientConditions] },
+        ssr: { noExternal: names, resolve: { conditions: [CONDITION, ...defaultServerConditions] } },
+    };
+};
 export const baseConfig = (root, config, out = OUTPUT_DIR) => ({
+    ...librarySettings(root),
     root,
     configFile: false,
     base: config.web.base,
@@ -41,9 +54,10 @@ export const baseConfig = (root, config, out = OUTPUT_DIR) => ({
     cacheDir: join(root, GENERATED_DIR, "cache"),
     customLogger: logger,
     clearScreen: false,
-    build: { outDir: join(root, out), emptyOutDir: true, target: "esnext", manifest: true, chunkSizeWarningLimit: 1500, rollupOptions: { input: join(root, CLIENT_ENTRY) } },
+    build: { outDir: join(root, out), emptyOutDir: true, target: "esnext", manifest: true, rollupOptions: { input: join(root, CLIENT_ENTRY) } },
     // The MESH runtime refers to node:fs/promises on a path the browser never takes.
-    optimizeDeps: { exclude: ["@valancex/mesh-runtime", "@valancex/cli", "@valancex/common"] },
+    // (a library's package is not prebundled either: its templates are the build's to compile)
+    optimizeDeps: { exclude: ["@valancex/mesh-runtime", "@valancex/cli", "@valancex/common", ...librariesOf(root).libraries.map((each) => each.name)] },
 });
 /** A Vite server that serves nothing: it loads the author's TypeScript and the generated server entry in Node. Used by build and check. */
 export const createLoader = async (root, config) => createServer({ ...baseConfig(root, config), optimizeDeps: { noDiscovery: true, include: [] }, server: { middlewareMode: true, hmr: false, watch: null, ws: false } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valancex/cli",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "vlx, the VALANCE command: make an application (vlx init), serve it as you edit (vlx dev), build it to a static site (vlx build), check it (vlx check). Content, layout, components and styles in, a website out.",
   "keywords": [
     "valance",
@@ -49,27 +49,32 @@
     "provenance": true
   },
   "dependencies": {
-    "@valancex/mesh-compiler": "^0.11.0",
-    "@valancex/port-desktop-vocabulary": "^0.6.0",
+    "@valancex/mesh-compiler": "^0.15.0 || ^0.16.0 || ^0.17.0",
+    "@valancex/port-desktop-vocabulary": "^0.12.0 || ^0.13.0 || ^0.14.0",
     "effect": "^3.10.0",
     "ink": "7.1.1",
     "postject": "1.0.0-alpha.6",
     "react": "19.2.8",
     "vite": "7.3.6",
-    "@valancex/valance": "^0.13.0",
-    "@valancex/common": "^0.13.0"
+    "@valancex/common": "^0.15.0",
+    "@valancex/style": "^0.15.0",
+    "@valancex/valance": "^0.15.0"
   },
   "devDependencies": {
+    "@types/jsdom": "^21.1.7",
     "@types/node": "^22.0.0",
     "@types/react": "19.2.18",
-    "@valancex/mesh-runtime": "^0.11.0",
+    "@valancex/mesh-runtime": "^0.17.0",
+    "dom-accessibility-api": "^0.7.0",
     "ink-testing-library": "4.0.0",
+    "jsdom": "^26.0.0",
     "playwright": "1.56.1",
     "typescript": "^5.6.0",
-    "vitest": "^3.2.0"
+    "vitest": "^3.2.0",
+    "vnu-jar": "^26.10.12"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && node scripts/copy-data.mjs",
     "typecheck": "tsc -p tsconfig.typecheck.json",
     "test": "vitest run"
   }

package/schemas/valance.schema.json

@@ -27,6 +27,82 @@
       "pattern": "^[^{}]*(\\{page\\}|\\{site\\})[^{}]*(\\{page\\}|\\{site\\}|[^{}])*$",
       "maxLength": 120,
       "description": "How a document's title is written: \"{page}\" is the page's title and \"{site}\" the name above. Must contain \"{page}\". A page whose title is the site's name is that name alone."
+    },
+    "record": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "redact"
+      ],
+      "description": "What `vlx dev --record` leaves out of a session log. A log holds what was typed and seen; a value marked here is never written (its place holds a digest) and the log still replays.",
+      "properties": {
+        "redact": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "scope": {
+              "type": "array",
+              "description": "Paths into the page's scope whose values are replaced by a digest; \"*\" is any list index or field name.",
+              "items": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            },
+            "commands": {
+              "type": "array",
+              "description": "Commands (\"component/name\") whose parameters are not recorded.",
+              "items": {
+                "type": "string",
+                "pattern": "^[\\w-]+/[\\w-]+$"
+              }
+            }
+          }
+        }
+      }
+    },
+    "theme": {
+      "type": "string",
+      "pattern": "^(@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$",
+      "description": "The theme package this project uses in place of the default theme: an installed package whose `valance` field is { \"kind\": \"theme\", \"theme\": \"./theme/theme.json\" }. A project with both this and a `theme/` directory is refused."
+    },
+    "budgets": {
+      "type": "array",
+      "description": "The size budgets `vlx build` holds the production build to (never `vlx dev`). A type, a warning and an error threshold in bytes: 500000, \"500kB\" or \"1MB\" (1 kB is 1,000 bytes). With none, the framework's start-up budgets apply.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "type"
+        ],
+        "properties": {
+          "type": {
+            "enum": [
+              "initial",
+              "runtime",
+              "startup",
+              "afterStart",
+              "anyChunk"
+            ],
+            "description": "initial: the start-up JavaScript and CSS; runtime: the WebAssembly runtime; startup: the whole start-up set; afterStart: what loads once the application runs; anyChunk: the largest JavaScript chunk. Brotli bytes."
+          },
+          "warning": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "error": {
+            "type": [
+              "string",
+              "number"
+            ]
+          }
+        }
+      }
     }
   }
 }

package/templates/desktop/gitignore

@@ -1,4 +1,7 @@
 node_modules
 dist
 .valance
+# session recordings (vlx dev --record) hold what was typed: never commit them
+.valance/sessions/
+*.session.jsonl
 .work*

package/templates/multi/src/web/layout.mprx

@@ -7,10 +7,10 @@
     <nav class="sidebar" label="Pages">
       {#each sections as s (s.id)}
         <section>
-          {#if s.title != ""}<para class="nav-title">{s.title}</para>{/if}
+          {#if s.title != ""}<paragraph class="nav-title">{s.title}</paragraph>{/if}
           <list class="nav-list">
             {#each s.items as n (n.id)}
-              <item><link class="nav-link" href={n.href} current={n.current}>{n.label}</link></item>
+              <listitem><link class="nav-link" href={n.href} current={n.current}>{n.label}</link></listitem>
             {/each}
           </list>
         </section>

package/templates/web/gitignore

@@ -1,4 +1,7 @@
 node_modules
 dist
 .valance
+# session recordings (vlx dev --record) hold what was typed: never commit them
+.valance/sessions/
+*.session.jsonl
 .work*

package/templates/web/src/layout.mprx

@@ -7,10 +7,10 @@
     <nav class="sidebar" label="Pages">
       {#each sections as s (s.id)}
         <section>
-          {#if s.title != ""}<para class="nav-title">{s.title}</para>{/if}
+          {#if s.title != ""}<paragraph class="nav-title">{s.title}</paragraph>{/if}
           <list class="nav-list">
             {#each s.items as n (n.id)}
-              <item><link class="nav-link" href={n.href} current={n.current}>{n.label}</link></item>
+              <listitem><link class="nav-link" href={n.href} current={n.current}>{n.label}</link></listitem>
             {/each}
           </list>
         </section>

package/views/block.mprx

@@ -1,3 +1,3 @@
 <mesh-fragment>
-  {#if b.kind == "heading"}<heading-block level={b.level} anchor={b.anchor} spans={b.spans} />{:else if b.kind == "list"}<list-block ordered={b.ordered} items={b.items} />{:else if b.kind == "code"}<pre class="code" tabindex="0"><code>{b.text}</code></pre>{:else if b.kind == "quote"}<quote class="quote"><runs spans={b.spans} /></quote>{:else if b.kind == "image"}<image class="picture" src={b.src} alt={b.alt} loading="lazy" />{:else}<para class="prose"><runs spans={b.spans} /></para>{/if}
+  {#if b.kind == "heading"}<heading-block level={b.level} anchor={b.anchor} spans={b.spans} />{:else if b.kind == "list"}<list-block ordered={b.ordered} items={b.items} />{:else if b.kind == "code"}<pre class="code" tabindex="0"><code>{b.text}</code></pre>{:else if b.kind == "quote"}<blockquote class="quote"><runs spans={b.spans} /></blockquote>{:else if b.kind == "image"}<image class="picture" src={b.src} alt={b.alt} loading="lazy" />{:else}<paragraph class="prose"><runs spans={b.spans} /></paragraph>{/if}
 </mesh-fragment>

package/views/layout.mprx

@@ -6,10 +6,10 @@
     <nav class="sidebar" label="Pages">
       {#each sections as s (s.id)}
         <section>
-          {#if s.title != ""}<para class="nav-title">{s.title}</para>{/if}
+          {#if s.title != ""}<paragraph class="nav-title">{s.title}</paragraph>{/if}
           <list class="nav-list">
             {#each s.items as n (n.id)}
-              <item><link class="nav-link" href={n.href} current={n.current}>{n.label}</link></item>
+              <listitem><link class="nav-link" href={n.href} current={n.current}>{n.label}</link></listitem>
             {/each}
           </list>
         </section>

package/views/list-items.mprx

@@ -1,3 +1,3 @@
 <mesh-fragment>
-  {#each items as i (i.id)}<item><runs spans={i.spans} /></item>{/each}
+  {#each items as i (i.id)}<listitem><runs spans={i.spans} /></listitem>{/each}
 </mesh-fragment>