@vmz/vmz 0.3.9 → 0.3.11

package/dist/cli/cli.js

@@ -13,6 +13,7 @@ import { registerDocumentCommands } from '../document/document-cmd.js';
 import { buildIntegratedDocuments, projectHasDocuments } from '../document/document-integrate.js';
 import { registerExplainCommand } from './explain-cmd.js';
 import { registerGithubActionsCommand } from './github-actions-cmd.js';
+import { registerInitCommands } from './init-cmd.js';
 import { createWorkspace, getProtocolVersions, HOST_PROTOCOL, materializeServeHostRuntime, materializeWechatPackaging, resolveCoreRuntimeDist, resolveNativePath, } from '../workspace/public-api.js';
 import { gateGlobalProjectCommand, getInvocationContext, isGlobalAllowedCommand } from '../workspace/invocation.js';
 import { emitLocaleRuntimeModules, localeHasErrors } from '../locale/locale-check.js';
@@ -92,6 +93,7 @@ function buildProductCli(opts = {}) {
     registerRefactorCommands(cli.command('refactor', 'cli.cmd.refactor'));
     registerExplainCommand(cli);
     registerGithubActionsCommand(cli);
+    registerInitCommands(cli.command('init', 'cli.cmd.init'));
     cli.command('version', 'cli.cmd.version').action(() => cmdVersion());
     return cli;
 }

package/dist/cli/init-cmd.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `vmz init` — materialize official presets into the application workspace.
+ */
+import type { Command } from '@vmz/commander';
+export declare function registerInitCommands(parent: Command): void;

package/dist/cli/init-cmd.js

@@ -0,0 +1,80 @@
+/**
+ * `vmz init` — materialize official presets into the application workspace.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { log } from '../workspace/log.js';
+import { resolveWorkspaceDirs } from '../workspace/resolve.js';
+export function registerInitCommands(parent) {
+    parent
+        .command('design', 'cli.cmd.init.design')
+        .option('--preset <name>', 'cli.opt.init-preset')
+        .option('--designs-dir <dir>', 'cli.opt.init-designs-dir')
+        .option('--force', 'cli.opt.init-force')
+        .option('--dry-run', 'cli.opt.init-dry-run')
+        .action((options) => cmdInitDesign(options));
+}
+/** Resolve `@vmz/ui/presets/<id>` from the project and read its `files` manifest. */
+function resolvePreset(project, id) {
+    const require = createRequire(path.join(project, 'package.json'));
+    const manifestPath = require.resolve(`@vmz/ui/presets/${id}`);
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    const files = [
+        manifest.files?.theme,
+        ...(manifest.files?.tokens ?? []),
+        ...(manifest.files?.themes ?? []),
+    ].filter((rel) => typeof rel === 'string' && rel.length > 0);
+    if (!files.length) {
+        throw new Error(`@vmz/ui/presets/${id} has no materialize files`);
+    }
+    // `presets/<id>.v0.json` sits next to the `presets/<id>/` directory.
+    return { id: manifest.id ?? id, root: path.join(path.dirname(manifestPath), id), files };
+}
+function cmdInitDesign(args) {
+    const { project } = resolveWorkspaceDirs({ path: args._[0] ?? '.' });
+    const presetId = typeof args.preset === 'string' && args.preset ? args.preset : 'web-surface';
+    const force = args.force === true;
+    const dryRun = args['dry-run'] === true;
+    let preset;
+    try {
+        preset = resolvePreset(project, presetId);
+    }
+    catch (error) {
+        log.errorId('cli.err.init.preset', {
+            preset: presetId,
+            detail: error instanceof Error ? error.message : String(error),
+        });
+        return 1;
+    }
+    const designsDir = typeof args['designs-dir'] === 'string' && args['designs-dir']
+        ? path.resolve(project, args['designs-dir'])
+        : path.join(project, 'designs');
+    const created = [];
+    const overwritten = [];
+    const skipped = [];
+    for (const rel of preset.files) {
+        const source = path.join(preset.root, rel);
+        const destination = path.join(designsDir, rel);
+        const existed = existsSync(destination);
+        if (existed && !force) {
+            skipped.push(rel);
+            continue;
+        }
+        if (!dryRun) {
+            mkdirSync(path.dirname(destination), { recursive: true });
+            writeFileSync(destination, readFileSync(source));
+        }
+        (existed ? overwritten : created).push(rel);
+    }
+    const prefix = dryRun ? 'init design (dry-run)' : 'init design';
+    console.log(`${prefix}: preset=${preset.id} designs=${designsDir}`);
+    for (const rel of created)
+        console.log(`  create ${rel}`);
+    for (const rel of overwritten)
+        console.log(`  overwrite ${rel}`);
+    for (const rel of skipped)
+        console.log(`  skip ${rel}`);
+    console.log(`${prefix}: created=${created.length} overwritten=${overwritten.length} skipped=${skipped.length}`);
+    return 0;
+}

package/dist/document/document-enrich.js

@@ -125,7 +125,7 @@ export function enrichDocumentContent(manifest, ctx) {
             if (resolved.ok === false) {
                 diagnostics.push({
                     code: DIAG.LINK_BROKEN,
-                    severity: 'error',
+                    severity: resolved.severity ?? 'error',
                     message: `broken link ${JSON.stringify(href)}: ${resolved.reason}`,
                     path: page.sourcePath,
                 });
@@ -173,6 +173,14 @@ function resolveDocHref(href, fromPageKey, locale, routeBase, pageKeySet) {
         const pk = stripped === '' ? 'index' : stripped;
         if (keys.has(pk))
             return { ok: true, locale, pageKey: pk, anchor, anchors: [] };
+        const docBase = routeBase === '/' ? '' : routeBase.replace(/\/$/, '');
+        if (docBase !== '' && !want.startsWith(`${docBase}/`) && want !== docBase) {
+            return {
+                ok: false,
+                reason: 'not a document route (application routes are not validated here)',
+                severity: 'warning',
+            };
+        }
         return { ok: false, reason: 'unknown route' };
     }
     // Relative to current page directory

package/dist/document/document-layout-render.js

@@ -27,18 +27,23 @@ export function assertIntegratedDistReady(distDir) {
 export function assertCompiledShellHtml(html) {
     const header = html.match(/<header[^>]*data-vmz-fixture="site-header"[\s\S]*?<\/header>/i)?.[0] ?? '';
     const footer = html.match(/<footer[^>]*data-vmz-fixture="site-footer"[\s\S]*?<\/footer>/i)?.[0] ?? '';
-    for (const part of [header, footer]) {
-        const leak = part.match(/\{[A-Za-z][A-Za-z0-9]*\}/);
+    const parts = [
+        { label: 'header', tag: 'header', fixture: 'site-header', html: header },
+        { label: 'footer', tag: 'footer', fixture: 'site-footer', html: footer },
+    ];
+    for (const part of parts) {
+        if (!part.html) {
+            throw new Error(`document layout SSR missing compiled <${part.tag} data-vmz-fixture="${part.fixture}"> in chrome`);
+        }
+        const leak = part.html.match(/\{[A-Za-z][A-Za-z0-9]*\}/);
         if (leak) {
-            throw new Error(`document layout SSR leaked binding placeholder ${leak[0]}`);
+            throw new Error(`document layout SSR leaked binding placeholder ${leak[0]} in ${part.label}`);
         }
-        if (/<(?:Link|Button|Icon)\b/.test(part)) {
-            throw new Error('document layout SSR leaked uncompiled VMZ component tag in chrome');
+        const leakedTag = part.html.match(/<(Link|Button|Icon)\b/)?.[1];
+        if (leakedTag) {
+            throw new Error(`document layout SSR leaked uncompiled <${leakedTag}> in ${part.label} (compile it or use plain HTML)`);
         }
     }
-    if (!header || !footer) {
-        throw new Error('document layout SSR missing compiled SiteHeader/SiteFooter fixtures');
-    }
 }
 async function loadCtor(distDir, chunkId) {
     const href = pathToFileURL(path.join(distDir, `${chunkId}.client.js`)).href;

package/locales/en-US/cli.json

@@ -50,6 +50,8 @@
     "cli.cmd.plan": "Dump frozen Rust plans via N-API",
     "cli.cmd.plan.locale": "LocalePlan from locales/",
     "cli.cmd.plan.document-route": "DocumentRoutePlan from documents/",
+    "cli.cmd.init": "Materialize project scaffolding from official presets",
+    "cli.cmd.init.design": "Copy the application Style Theme preset into designs/ (skip existing files)",
     "cli.cmd.version": "Show host + native protocol versions",
     "cli.opt.out-dir": "Workspace output root (default: dist)",
     "cli.opt.release": "Release build (omit serve-host; pack minify; proof)",
@@ -101,7 +103,12 @@
     "cli.opt.gha.timeout-minutes": "Max wait minutes for mode=wait",
     "cli.opt.gha.interval-seconds": "Poll interval seconds for mode=wait",
     "cli.opt.gha.required-conclusion": "Required conclusion when mode=wait (default success)",
+    "cli.opt.init-preset": "Official preset id (default web-surface)",
+    "cli.opt.init-designs-dir": "Target designs directory (default <project>/designs)",
+    "cli.opt.init-force": "Overwrite existing design files",
+    "cli.opt.init-dry-run": "Print the materialize plan without writing files",
     "cli.err.unknown_plan_kind": "unknown plan kind `{kind}` (locale | document-route)",
+    "cli.err.init.preset": "cannot materialize preset `{preset}`: {detail} (install `@vmz/ui` in the app first)",
     "cli.err.gha.mode": "unknown --mode {mode} (status | wait)",
     "cli.err.gha.repo": "set --owner/--repo or GITHUB_REPOSITORY (owner/repo)",
     "cli.err.invalid_level": "unknown --level `{level}` (error | warn | info)",

package/package.json

@@ -3,23 +3,23 @@
     "vmz": "./bin/vmz.js"
   },
   "dependencies": {
-    "@vmz/commander": "0.3.9",
-    "@vmz/core": "0.3.9",
-    "@vmz/diagnostic": "0.3.9",
-    "@vmz/plugin": "0.3.9",
-    "@vmz/protocol": "0.3.9"
+    "@vmz/commander": "0.3.11",
+    "@vmz/core": "0.3.11",
+    "@vmz/diagnostic": "0.3.11",
+    "@vmz/plugin": "0.3.11",
+    "@vmz/protocol": "0.3.11"
   },
   "description": "VMZ Node toolchain — N-API workspace session + CLI (publish name @vmz/vmz)",
   "devDependencies": {
     "@types/node": "^22.15.0",
-    "@vmz/plugin": "0.3.9",
-    "@vmz/plugin-katex": "0.3.9",
-    "@vmz/plugin-markdown-it": "0.3.9",
-    "@vmz/plugin-shiki": "0.3.9",
-    "@vmz/test": "0.3.9",
+    "@vmz/plugin": "0.3.11",
+    "@vmz/plugin-katex": "0.3.11",
+    "@vmz/plugin-markdown-it": "0.3.11",
+    "@vmz/plugin-shiki": "0.3.11",
+    "@vmz/test": "0.3.11",
     "linkedom": "^0.18.13",
     "typescript": "^5.8.3",
-    "vmz-plugin-conformance": "0.3.9"
+    "vmz-plugin-conformance": "0.3.11"
   },
   "engines": {
     "node": ">=24.12.0"
@@ -80,16 +80,16 @@
   "main": "./dist/index.js",
   "name": "@vmz/vmz",
   "optionalDependencies": {
-    "@vmz/vmz-darwin-arm64": "0.3.9",
-    "@vmz/vmz-darwin-x64": "0.3.9",
-    "@vmz/vmz-linux-arm64": "0.3.9",
-    "@vmz/vmz-linux-x64": "0.3.9",
-    "@vmz/vmz-win32-arm64": "0.3.9",
-    "@vmz/vmz-win32-x64": "0.3.9"
+    "@vmz/vmz-darwin-arm64": "0.3.11",
+    "@vmz/vmz-darwin-x64": "0.3.11",
+    "@vmz/vmz-linux-arm64": "0.3.11",
+    "@vmz/vmz-linux-x64": "0.3.11",
+    "@vmz/vmz-win32-arm64": "0.3.11",
+    "@vmz/vmz-win32-x64": "0.3.11"
   },
   "peerDependencies": {
-    "@vmz/plugin-markdown-it": "0.3.9",
-    "@vmz/test": "0.3.9",
+    "@vmz/plugin-markdown-it": "0.3.11",
+    "@vmz/test": "0.3.11",
     "typescript": "^5.8.3"
   },
   "peerDependenciesMeta": {
@@ -122,5 +122,5 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.3.9"
+  "version": "0.3.11"
 }