@vmz/vmz 0.3.11 → 0.3.13

package/delivery-runtime-files.json

@@ -33,6 +33,7 @@
         { "src": "browser/resume/resume.js", "out": "browser/resume/resume.js" },
         { "src": "ssr/render.js", "out": "ssr/render.js" },
         { "src": "ssr/serialize.js", "out": "ssr/serialize.js" },
+        { "src": "ssr/onmount.js", "out": "ssr/onmount.js" },
         { "src": "ssr/document.js", "out": "ssr/document.js" }
     ]
 }

package/dist/cli/cli.js

@@ -2,6 +2,7 @@
  * Node CLI command implementations .
  */
 import { spawn } from 'node:child_process';
+import { existsSync, statSync } from 'node:fs';
 import path from 'node:path';
 import { createCli } from '@vmz/commander';
 import { registerApplicationCommands } from './application-cmd.js';
@@ -14,7 +15,7 @@ import { buildIntegratedDocuments, projectHasDocuments } from '../document/docum
 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 { createWorkspace, getProtocolVersions, HOST_PROTOCOL, materializeServeHostRuntime, materializeWechatPackaging, resolveNativePath, } from '../workspace/public-api.js';
 import { gateGlobalProjectCommand, getInvocationContext, isGlobalAllowedCommand } from '../workspace/invocation.js';
 import { emitLocaleRuntimeModules, localeHasErrors } from '../locale/locale-check.js';
 import { registerLocaleCommands } from '../locale/locale-cmd.js';
@@ -22,15 +23,17 @@ import { emitLocaleRouteRealization } from '../locale/locale-route-emit.js';
 import { log } from '../workspace/log.js';
 import { resolveCliLogLevel, setCliLogLevel } from '../workspace/log-level.js';
 import { parseCliLogStyle, setCliLogStyle } from '../workspace/log-style.js';
-import { packFromDeploymentIr } from '../workspace/pack.js';
+import { ensureRuntimeCompanions, packFromDeploymentIr, packSsrFromDeploymentIr } from '../workspace/pack.js';
 import { registerPlanCommands } from './plan-cmd.js';
 import { loadVmzConfig } from '../workspace/plugin-host.js';
 import { findAvailablePort } from '../workspace/port.js';
 import { registerRefactorCommands } from './refactor-cmd.js';
 import { registerArtifactCommands } from './release-cmd.js';
-import { readPackageMeta, resolveWorkspaceDirs } from '../workspace/resolve.js';
+import { findPackageJson, readPackageMeta, resolveWorkspaceDirs } from '../workspace/resolve.js';
 import { emitRouteCatalog } from '../workspace/route-catalog-emit.js';
+import { resolveCoreRuntimeDist } from '../workspace/runtime-dist.js';
 import { registerTestCommand } from './test-cmd.js';
+import { emitStaticBootstrapEntries } from '../workspace/static-emit.js';
 export function printGlobalHelp() {
     return buildProductCli({ mode: 'global' }).parse(['help']);
 }
@@ -75,6 +78,7 @@ function buildProductCli(opts = {}) {
     withServeExtras(withCoreOpts(cli.command('serve', 'cli.cmd.serve'))).action((options) => cmdServe(options));
     withServeExtras(withCoreOpts(cli.command('dev', 'cli.cmd.dev'))).action((options) => cmdDev(options));
     withCoreOpts(cli.command('format', 'cli.cmd.format'))
+        .option('--rust', 'cli.opt.format-rust')
         .option('--no-javascript', 'cli.opt.format-no-javascript')
         .option('--no-rust', 'cli.opt.format-no-rust')
         .option('--no-vmz', 'cli.opt.format-no-vmz')
@@ -269,8 +273,21 @@ async function cmdBuild(args) {
         if (routeCatalog.written.length) {
             log.info(`route catalog (${routeCatalog.written.length} artifact(s))`);
         }
+        if (!wechatPack) {
+            try {
+                // Node graph must be packed before any SSR consumer (document
+                // build, static emit, render host) imports a compiled chunk.
+                ensureRuntimeCompanions(outDir, resolveCoreRuntimeDist());
+                const nodePack = packSsrFromDeploymentIr(outDir, { projectRoot: project });
+                log.info(`node pack ok (entries=${nodePack.manifest.entryCount}, chunks=${nodePack.manifest.chunkCount}, digest=${String(nodePack.manifest.packDigest).slice(0, 12)}…)`);
+            }
+            catch (err) {
+                log.error(`node pack failed: ${err instanceof Error ? err.message : String(err)}`);
+                return 1;
+            }
+        }
         if (projectHasDocuments(project)) {
-            const docs = await buildIntegratedDocuments({ projectRoot: project, outDir });
+            const docs = await buildIntegratedDocuments({ projectRoot: project, outDir, engines: cfg.engines });
             if (!docs.ok)
                 return 1;
         }
@@ -299,21 +316,16 @@ async function cmdBuild(args) {
         }
         let pack = null;
         try {
+            // Browser pack entries are the static bootstrap modules; static emit
+            // runs after pack (HTML resolves `_vmz/pack/`), so write them first.
+            emitStaticBootstrapEntries(outDir);
             pack = packFromDeploymentIr(outDir, {
                 release: Boolean(args.release),
                 profileId: selected.selection.profileId,
                 assembly: selected.selection.assembly,
-                coreDist: resolveCoreRuntimeDist(),
                 projectRoot: project,
             });
-            const lower = pack.manifest?.clientPackageLowering;
-            if (lower?.bareSpecs?.length) {
-                log.info(`pack client packages (${lower.bareSpecs.length} bare → vendor; rewritten=${lower.rewrittenFiles})`);
-            }
-            if (lower?.remainingBareSpecs?.length) {
-                log.warn(`pack client packages: ${lower.remainingBareSpecs.length} bare specifier(s) still unresolved for browser: ${lower.remainingBareSpecs.slice(0, 8).join(', ')}${lower.remainingBareSpecs.length > 8 ? '…' : ''}`);
-            }
-            log.info(`pack ok (units=${pack.manifest.unitCount}, digest=${String(pack.manifest.packDigest).slice(0, 12)}…)`);
+            log.info(`pack ok (entries=${pack.manifest.entryCount}, chunks=${pack.manifest.chunkCount}, digest=${String(pack.manifest.packDigest).slice(0, 12)}…)`);
         }
         catch (err) {
             log.error(`pack failed: ${err instanceof Error ? err.message : String(err)}`);
@@ -513,24 +525,35 @@ async function cmdDev(args) {
     }
 }
 async function cmdFormat(args) {
-    const pathArg = args._[0] ?? '.';
-    const { project, outDir } = resolveWorkspaceDirs({
-        path: pathArg,
-        outDir: typeof args['out-dir'] === 'string' ? args['out-dir'] : undefined,
-    });
+    const rawPath = args._[0];
+    if (typeof rawPath !== 'string' || rawPath.trim() === '') {
+        log.error('format: explicit <file|dir> path required — no implicit workspace scope (pass `.` for the current directory)');
+        return 1;
+    }
+    const target = path.resolve(process.cwd(), rawPath);
+    if (!existsSync(target)) {
+        log.error(`format: path does not exist: ${target}`);
+        return 1;
+    }
+    if (args.rust && args['no-rust']) {
+        log.error('format: conflicting `--rust` and `--no-rust`');
+        return 1;
+    }
+    const startDir = statSync(target).isDirectory() ? target : path.dirname(target);
+    const pkg = findPackageJson(startDir);
+    const configRoot = pkg ? path.dirname(pkg) : startDir;
     const checkOnly = Boolean(args.check);
-    log.info(`format ${project}${checkOnly ? ' --check' : ''}`);
+    log.info(`format ${target}${checkOnly ? ' --check' : ''}`);
     const { runFormatCommand } = await import('./format-cmd.js');
     return runFormatCommand({
-        project,
-        outDir,
+        target,
+        configRoot,
         check: checkOnly,
         overrides: {
             javascript: args['no-javascript'] ? false : undefined,
-            rust: args['no-rust'] ? false : undefined,
+            rust: args.rust ? true : args['no-rust'] ? false : undefined,
             vmz: args['no-vmz'] ? false : undefined,
         },
-        createWorkspace,
     });
 }
 function cmdLint(args) {

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

@@ -1,28 +1,20 @@
 /**
- * `vmz format` — workspace surfaces (JS/TS + Rust) + `.vmz` authoring formatter.
+ * `vmz format` — explicit-path formatter.
+ *
+ * Scope contract: the positional path is the whole scope. A file formats only
+ * itself; a directory is walked locally. Nothing ever falls back to a
+ * workspace-wide pass, and Rust runs per-file `rustfmt` — never `cargo fmt`.
  */
 export type FormatCommandOptions = {
-    project: string;
-    outDir: string;
+    /** Absolute explicit file or directory (already validated to exist). */
+    target: string;
+    /** Project root used to load `vmz.config` and the style config. */
+    configRoot: string;
     check: boolean;
     overrides?: {
         javascript?: boolean;
         rust?: boolean;
         vmz?: boolean;
     };
-    createWorkspace: (opts: {
-        root: string;
-        outDir: string;
-    }) => {
-        format: (checkOnly?: boolean) => {
-            filesChecked: number;
-            filesWritten: number;
-            filesNeedWrite: number;
-            diagnostics?: Array<{
-                severity?: string;
-            }>;
-        };
-        dispose: () => void;
-    };
 };
 export declare function runFormatCommand(opts: FormatCommandOptions): Promise<number>;

package/dist/cli/format-cmd.js

@@ -1,65 +1,53 @@
 /**
- * `vmz format` — workspace surfaces (JS/TS + Rust) + `.vmz` authoring formatter.
+ * `vmz format` — explicit-path formatter.
+ *
+ * Scope contract: the positional path is the whole scope. A file formats only
+ * itself; a directory is walked locally. Nothing ever falls back to a
+ * workspace-wide pass, and Rust runs per-file `rustfmt` — never `cargo fmt`.
  */
+import fs from 'node:fs';
+import path from 'node:path';
 import { loadNative } from '../workspace/public-api.js';
 import { loadVmzConfig } from '../workspace/plugin-host.js';
 import { log } from '../workspace/log.js';
 import { resolveFormatConfig } from './format-config.js';
 export async function runFormatCommand(opts) {
-    const { project, outDir, check, createWorkspace } = opts;
-    const { format: formatConfig } = await loadVmzConfig(project);
-    const resolved = resolveFormatConfig(project, formatConfig);
-    if (opts.overrides?.javascript !== undefined)
-        resolved.javascript = opts.overrides.javascript;
-    if (opts.overrides?.rust !== undefined)
-        resolved.rust = opts.overrides.rust;
-    if (opts.overrides?.vmz !== undefined)
-        resolved.vmz = opts.overrides.vmz;
+    const { target, configRoot, check } = opts;
+    const { format: formatConfig } = await loadVmzConfig(configRoot);
+    const resolved = resolveFormatConfig(formatConfig);
     const native = loadNative();
-    let exit = 0;
-    if (resolved.javascript || resolved.rust) {
-        const report = native.formatWorkspaceRun({
-            cwd: project,
+    let report;
+    try {
+        report = native.formatTargetsRun({
+            targets: [target],
             check,
-            includes: resolved.includes,
+            rust: opts.overrides?.rust,
+            javascript: opts.overrides?.javascript,
+            vmz: opts.overrides?.vmz,
             excludes: resolved.excludes,
-            rust: resolved.rust,
-            javascript: resolved.javascript,
-            styleConfig: resolved.style,
+            styleConfig: path.resolve(configRoot, resolved.style),
         });
-        if (report.errors.length > 0) {
-            for (const message of report.errors) {
-                log.error(message);
-            }
+    }
+    catch (err) {
+        log.error(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+    let exit = 0;
+    for (const message of report.errors) {
+        log.error(message);
+    }
+    if (report.errors.length > 0)
+        exit = 1;
+    if (log.diagnostics(report.diagnostics ?? []))
+        exit = 1;
+    const scope = fs.statSync(target).isDirectory() ? `${target}${path.sep}` : target;
+    if (check) {
+        log.info(`format ${scope}: ${report.needWrite} file(s) would change, ${report.unchanged} unchanged`);
+        if (report.needWrite > 0)
             exit = 1;
-        }
-        else if (check && report.formatted === 0 && report.unchanged > 0) {
-            log.info(`workspace format: no changes needed (${report.unchanged} file(s) checked)`);
-        }
-        else if (!check) {
-            log.info(`workspace format: ${report.formatted} file(s) updated, ${report.unchanged} unchanged`);
-        }
     }
-    if (resolved.vmz) {
-        log.info(`format .vmz ${project}${check ? ' --check' : ''}`);
-        const ws = createWorkspace({ root: project, outDir });
-        try {
-            const report = ws.format(check);
-            const errors = log.diagnostics(report.diagnostics ?? []);
-            if (check) {
-                log.info(`checked ${report.filesChecked} .vmz file(s); ${report.filesNeedWrite} need write`);
-                if (report.filesNeedWrite > 0)
-                    exit = 1;
-            }
-            else {
-                log.info(`formatted ${report.filesWritten}/${report.filesChecked} .vmz file(s)`);
-            }
-            if (errors)
-                exit = 1;
-        }
-        finally {
-            ws.dispose();
-        }
+    else {
+        log.info(`format ${scope}: ${report.formatted} file(s) updated, ${report.unchanged} unchanged`);
     }
     return exit;
 }

package/dist/cli/format-config.d.ts

@@ -1,16 +1,13 @@
 /**
  * `vmz.config` `format` resolution for `vmz format`.
+ *
+ * Scope always comes from the explicit CLI path — config only narrows
+ * (`excludes`) and styles. There are no config-driven `includes`.
  */
-import type { VmzFormatConfig } from '@vmz/plugin';
+import type { VmzFormatConfig } from '../workspace/user-config.js';
 export type ResolvedFormatOptions = {
-    includes?: string[];
     excludes: string[];
-    rust: boolean;
-    javascript: boolean;
-    vmz: boolean;
     style: string;
 };
-/** VMZ hybrid monorepo — JS/TS surfaces only, never whole-repo walk. */
-export declare const VMZ_FRAMEWORK_INCLUDES: readonly ["scripts/**", "packages/runtimes/**", "packages/examples/**", "packages/editors/**", "packages/ui/**", "packages/plugins/**", "packages/content/**", "packages/homepage/**", "package.json", "biome.json", "vmz.config.ts", "nifty.config.ts"];
-/** Merge `vmz.config` `format` with framework monorepo defaults. */
-export declare function resolveFormatConfig(projectRoot: string, format?: VmzFormatConfig): ResolvedFormatOptions;
+/** Merge `vmz.config` `format` excludes / style with the defaults. */
+export declare function resolveFormatConfig(format?: VmzFormatConfig | null): ResolvedFormatOptions;

package/dist/cli/format-config.js

@@ -1,38 +1,14 @@
 /**
  * `vmz.config` `format` resolution for `vmz format`.
+ *
+ * Scope always comes from the explicit CLI path — config only narrows
+ * (`excludes`) and styles. There are no config-driven `includes`.
  */
-import { existsSync } from 'node:fs';
-import path from 'node:path';
-/** VMZ hybrid monorepo — JS/TS surfaces only, never whole-repo walk. */
-export const VMZ_FRAMEWORK_INCLUDES = [
-    'scripts/**',
-    'packages/runtimes/**',
-    'packages/examples/**',
-    'packages/editors/**',
-    'packages/ui/**',
-    'packages/plugins/**',
-    'packages/content/**',
-    'packages/homepage/**',
-    'package.json',
-    'biome.json',
-    'vmz.config.ts',
-    'nifty.config.ts',
-];
 const DEFAULT_EXCLUDES = ['**/fixtures/**', '**/dist/**', '**/node_modules/**', '**/target/**'];
-function isFrameworkMonorepoRoot(projectRoot) {
-    return existsSync(path.join(projectRoot, 'packages', 'runtimes'));
-}
-/** Merge `vmz.config` `format` with framework monorepo defaults. */
-export function resolveFormatConfig(projectRoot, format) {
-    const frameworkRoot = isFrameworkMonorepoRoot(projectRoot);
-    const hasCargo = existsSync(path.join(projectRoot, 'Cargo.toml'));
-    const hasFormatSection = format !== undefined;
+/** Merge `vmz.config` `format` excludes / style with the defaults. */
+export function resolveFormatConfig(format) {
     return {
-        includes: format?.includes ?? (frameworkRoot ? [...VMZ_FRAMEWORK_INCLUDES] : undefined),
         excludes: [...DEFAULT_EXCLUDES, ...(format?.excludes ?? [])],
-        rust: format?.rust ?? (hasCargo && (frameworkRoot || hasFormatSection)),
-        javascript: format?.javascript ?? (frameworkRoot || hasFormatSection),
-        vmz: format?.vmz ?? true,
         style: format?.style ?? 'biome.json',
     };
 }

package/dist/delivery/delivery-profile.js

@@ -391,7 +391,7 @@ export function semanticIdsForAssembly(assembly) {
         case 'rust-embedded':
             return ['site-fallback', 'asset-graph'];
         case 'local-static':
-            return ['asset-graph'];
+            return ['static-delivery', 'asset-graph'];
         default:
             return [];
     }

package/dist/dev/dev-session.js

@@ -14,6 +14,7 @@ import { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { buildIntegratedDocuments, projectHasDocuments } from '../document/document-integrate.js';
 import { createWorkspace, resolveNativePath } from '../workspace/public-api.js';
+import { loadVmzConfig } from '../workspace/plugin-host.js';
 import { materializeWechatPackaging } from '../workspace/wechat-packaging.js';
 import { emitLocaleRuntimeModules, localeHasErrors } from '../locale/locale-check.js';
 import { log } from '../workspace/log.js';
@@ -199,6 +200,16 @@ export function createDevSession(options) {
             return 'respawn';
         }
     }
+    let docEnginesPromise = null;
+    /** `engines.code` / `engines.markdown` for the document layer (loaded once per session). */
+    function docEngines() {
+        if (!docEnginesPromise) {
+            docEnginesPromise = loadVmzConfig(project)
+                .then((cfg) => cfg.engines)
+                .catch(() => undefined);
+        }
+        return docEnginesPromise;
+    }
     async function start() {
         const src = path.join(project, 'src');
         if (!existsSync(src)) {
@@ -226,7 +237,7 @@ export function createDevSession(options) {
         // Reclaim orphan serve-host from a previous crashed launcher (same outDir).
         reclaimStaleDevHost(outDir);
         if (projectHasDocuments(project)) {
-            const docs = await buildIntegratedDocuments({ projectRoot: project, outDir });
+            const docs = await buildIntegratedDocuments({ projectRoot: project, outDir, engines: await docEngines() });
             if (!docs.ok) {
                 throw new Error('vmz dev: integrated document build failed');
             }
@@ -533,7 +544,7 @@ export function createDevSession(options) {
                     }
                     dependencyRoots = [...refreshed.dependencyRoots];
                     if (batch.docsDirty || projectHasDocuments(project)) {
-                        const docs = await buildIntegratedDocuments({ projectRoot: project, outDir });
+                        const docs = await buildIntegratedDocuments({ projectRoot: project, outDir, engines: await docEngines() });
                         if (!docs.ok)
                             log.warn('document mount rebuild failed — keeping previous docs');
                     }
@@ -563,7 +574,7 @@ export function createDevSession(options) {
                     }
                     await emitPublicAndTrack();
                     if (batch.docsDirty || projectHasDocuments(project)) {
-                        const docs = await buildIntegratedDocuments({ projectRoot: project, outDir });
+                        const docs = await buildIntegratedDocuments({ projectRoot: project, outDir, engines: await docEngines() });
                         if (!docs.ok) {
                             log.warn('document mount rebuild failed — keeping previous docs');
                         }
@@ -605,7 +616,7 @@ export function createDevSession(options) {
                     }
                     await emitPublicAndTrack();
                     if (batch.docsDirty || projectHasDocuments(project)) {
-                        const docs = await buildIntegratedDocuments({ projectRoot: project, outDir });
+                        const docs = await buildIntegratedDocuments({ projectRoot: project, outDir, engines: await docEngines() });
                         if (!docs.ok)
                             log.warn('document mount rebuild failed — keeping previous docs');
                     }
@@ -646,7 +657,7 @@ export function createDevSession(options) {
                 }
                 if (batch.docsDirty) {
                     log.info('documents change detected — rebuilding document mount…');
-                    const docs = await buildIntegratedDocuments({ projectRoot: project, outDir });
+                    const docs = await buildIntegratedDocuments({ projectRoot: project, outDir, engines: await docEngines() });
                     if (!docs.ok) {
                         log.warn('document mount rebuild failed — keeping previous docs');
                         continue;

package/dist/document/document-base-css.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Framework-owned document base stylesheet (`assets/vmz-document.css`).
+ *
+ * The single canonical document surface for every site: sidebar + article +
+ * toc grid, article type scale, code/table/quote blocks, island shells and the
+ * responsive breakpoints. Structural colors come from `--vmz-*` semantic tokens
+ * only (site brand flows in through the compiled `vmz-designs.css`); syntax
+ * colors inside code blocks come from the Shiki theme and stay identical on
+ * every site. Sites do not ship document stylesheets.
+ *
+ * House rules (规划设计/vmz 05): pure-white base with near-black blocks for
+ * rhythm, body text ≥ 16px, small text ≥ 12px at weight ≥ 400, no uppercase
+ * letter-spaced micro labels, no 3D / volumetric surfaces.
+ */
+export declare const DOCUMENT_BASE_CSS = "/* vmz document layer \u2014 canonical document surface (token-driven). */\n\n.site--docs {\n    min-height: 100vh;\n    display: flex;\n    flex-direction: column;\n    background: var(--vmz-surface-paper, #ffffff);\n}\n\n.site--docs > .doc-body {\n    flex: 1 0 auto;\n    display: grid;\n    grid-template-columns: 17rem minmax(0, 1fr);\n    align-items: start;\n    width: 100%;\n    max-width: 94rem;\n    margin: 0 auto;\n}\n\n/* Sidebar -------------------------------------------------------------- */\n\n.doc-sidebar {\n    position: sticky;\n    top: var(--vmz-layout-header-height-compact, 3.5rem);\n    align-self: start;\n    max-height: calc(100vh - var(--vmz-layout-header-height-compact, 3.5rem));\n    overflow-y: auto;\n    padding: 2rem 1.25rem 3rem 1.5rem;\n    border-right: 1px solid var(--vmz-line-default, #e5e6eb);\n}\n\n/* Density activation lives in this framework layer: sites only ship tokens. */\n\n:where([data-density=\"compact\"]) .doc-sidebar {\n    padding-top: var(--vmz-density-compact-padding-y, 1.5rem);\n    padding-bottom: 2rem;\n}\n\n:where([data-density=\"dense\"]) .doc-sidebar {\n    padding-top: var(--vmz-density-dense-padding-y, 1rem);\n    padding-bottom: 1.5rem;\n}\n\n.doc-sidebar__label {\n    font-size: 0.75rem;\n    font-weight: 500;\n    color: var(--vmz-text-muted, #6b7178);\n    margin: 0 0 var(--vmz-density-control-padding-y, 0.75rem);\n}\n\n.doc-subnav ul {\n    list-style: none;\n    margin: 0;\n    padding: 0;\n    display: grid;\n    gap: 2px;\n}\n\n.doc-subnav a {\n    display: block;\n    padding: 0.4375rem 0.625rem;\n    font-size: 0.875rem;\n    line-height: 1.45;\n    color: var(--vmz-text-steel, #51565d);\n    text-decoration: none;\n    border-left: 2px solid transparent;\n    border-radius: 0 4px 4px 0;\n    transition: color 120ms ease, background 120ms ease, border-color 120ms ease;\n}\n\n.doc-subnav a:hover {\n    color: var(--vmz-text-ink, #1f2329);\n    background: var(--vmz-surface-mist, #f7f8fa);\n    text-decoration: none;\n}\n\n.doc-subnav a[aria-current=\"page\"] {\n    color: var(--vmz-brand-primary, #1677ff);\n    border-left-color: var(--vmz-brand-primary, #1677ff);\n    background: var(--vmz-surface-paper, #ffffff);\n    font-weight: 500;\n}\n\n.doc-search {\n    margin-top: 1rem;\n    padding-top: 0.75rem;\n    border-top: 1px solid var(--vmz-line-default, #e5e6eb);\n    position: relative;\n}\n\n.doc-search__input {\n    width: 100%;\n    box-sizing: border-box;\n    padding: 0.4375rem 0.625rem;\n    font-size: 0.875rem;\n    line-height: 1.4;\n    color: var(--vmz-text-ink, #1f2329);\n    background: var(--vmz-surface-paper, #ffffff);\n    border: 1px solid var(--vmz-line-default, #e5e6eb);\n    border-radius: 6px;\n}\n\n.doc-search__input:focus-visible {\n    outline: 2px solid var(--vmz-brand-primary, #1677ff);\n    outline-offset: 1px;\n}\n\n.doc-search__results {\n    list-style: none;\n    margin: 0.375rem 0 0;\n    padding: 0.25rem;\n    display: grid;\n    gap: 1px;\n    background: var(--vmz-surface-paper, #ffffff);\n    border: 1px solid var(--vmz-line-default, #e5e6eb);\n    border-radius: 6px;\n    max-height: 16rem;\n    overflow-y: auto;\n}\n\n.doc-search__results[hidden] {\n    display: none;\n}\n\n.doc-search__results a {\n    display: block;\n    padding: 0.375rem 0.5rem;\n    font-size: 0.8125rem;\n    line-height: 1.4;\n    color: var(--vmz-text-steel, #51565d);\n    text-decoration: none;\n    border-radius: 4px;\n    overflow-wrap: break-word;\n}\n\n.doc-search__ctx {\n    color: var(--vmz-text-muted, #6b7178);\n}\n\n.doc-search__results li[aria-selected=\"true\"] a,\n.doc-search__results a:hover {\n    background: var(--vmz-surface-mist, #f7f8fa);\n    color: var(--vmz-text-ink, #1f2329);\n}\n\n.doc-search__empty {\n    padding: 0.375rem 0.5rem;\n    font-size: 0.8125rem;\n    color: var(--vmz-text-muted, #6b7178);\n}\n\n.doc-search__hint {\n    margin: 0.375rem 0 0;\n    font-size: 0.75rem;\n    line-height: 1.5;\n    color: var(--vmz-text-muted, #6b7178);\n}\n\n/* Content grid --------------------------------------------------------- */\n\n.doc-content {\n    display: grid;\n    grid-template-columns: minmax(0, 1fr) 13rem;\n    gap: 3rem;\n    padding: 3rem 3rem 4rem;\n    min-width: 0;\n}\n\n.doc-content > main {\n    min-width: 0;\n    max-width: 46rem;\n}\n\n/* Breadcrumb ----------------------------------------------------------- */\n\n.doc-breadcrumb {\n    font-size: 0.875rem;\n    line-height: 1.5;\n    color: var(--vmz-text-muted, #6b7178);\n    margin: 0 0 2rem;\n    display: flex;\n    gap: 0.375rem;\n    align-items: baseline;\n}\n\n.doc-breadcrumb a {\n    color: var(--vmz-text-steel, #51565d);\n    text-decoration: none;\n}\n\n.doc-breadcrumb a:hover {\n    color: var(--vmz-brand-primary, #1677ff);\n    text-decoration: underline;\n    text-underline-offset: 2px;\n}\n\n.doc-breadcrumb [aria-current] {\n    color: var(--vmz-text-ink, #1f2329);\n    font-weight: 500;\n}\n\n/* On this page --------------------------------------------------------- */\n\n.toc {\n    position: sticky;\n    top: calc(var(--vmz-layout-header-height-compact, 3.5rem) + 1.25rem);\n    align-self: start;\n    order: 2;\n    border-left: 1px solid var(--vmz-line-subtle, #f0f1f3);\n    padding-left: 1rem;\n}\n\n.toc__label {\n    font-size: 0.75rem;\n    font-weight: 500;\n    color: var(--vmz-text-muted, #6b7178);\n    margin: 0 0 0.5rem;\n}\n\n.toc ol {\n    list-style: none;\n    margin: 0;\n    padding: 0;\n    display: grid;\n    gap: 0.25rem;\n}\n\n.toc a {\n    color: var(--vmz-text-steel, #51565d);\n    text-decoration: none;\n    display: block;\n    line-height: 1.4;\n    font-size: 0.75rem;\n}\n\n.toc a:hover {\n    color: var(--vmz-brand-primary, #1677ff);\n}\n\n.toc .h3 {\n    padding-left: 0.75rem;\n    color: var(--vmz-text-muted, #6b7178);\n}\n\n/* Article typography --------------------------------------------------- */\n\n.doc-content main h1 {\n    font-family: var(--vmz-font-display, var(--vmz-font-sans, sans-serif));\n    font-size: clamp(2rem, 2.8vw, 2.5rem);\n    font-weight: 650;\n    letter-spacing: -0.03em;\n    line-height: 1.12;\n    margin: 0 0 1.25rem;\n    color: var(--vmz-text-ink, #1f2329);\n}\n\n.doc-content main h2 {\n    font-size: 1.4375rem;\n    letter-spacing: -0.02em;\n    margin: 3rem 0 0.875rem;\n    color: var(--vmz-text-ink, #1f2329);\n}\n\n.doc-content main h3 {\n    font-size: 1.125rem;\n    margin: 2rem 0 0.5rem;\n    color: var(--vmz-text-ink, #1f2329);\n}\n\n.doc-content main h4 {\n    font-size: 1rem;\n    margin: 1.75rem 0 0.375rem;\n    color: var(--vmz-text-ink, #1f2329);\n}\n\n.doc-content main p,\n.doc-content main li {\n    font-size: 1rem;\n    line-height: 1.75;\n    color: var(--vmz-text-steel, #51565d);\n}\n\n.doc-content main p {\n    margin: 0 0 1.125rem;\n}\n\n.doc-content main ul,\n.doc-content main ol {\n    margin: 0 0 1.25rem;\n    padding-left: 1.375rem;\n}\n\n.doc-content main li + li {\n    margin-top: 0.375rem;\n}\n\n.doc-content main li::marker {\n    color: var(--vmz-line-strong, #c9cdd4);\n}\n\n.doc-content main a {\n    color: var(--vmz-brand-primary, #1677ff);\n    text-decoration: underline;\n    text-underline-offset: 2px;\n    text-decoration-color: var(--vmz-line-strong, #c9cdd4);\n    overflow-wrap: break-word;\n}\n\n.doc-content main a:hover {\n    text-decoration-color: var(--vmz-brand-primary, #1677ff);\n}\n\n.doc-content main strong {\n    color: var(--vmz-text-ink, #1f2329);\n    font-weight: 600;\n}\n\n.doc-content main hr {\n    border: 0;\n    border-top: 1px solid var(--vmz-line-default, #e5e6eb);\n    margin: 1.75rem 0;\n}\n\n/* Inline code */\n.doc-content main :not(pre) > code {\n    font-family: var(--vmz-font-mono, ui-monospace, monospace);\n    font-size: 0.875rem;\n    color: var(--vmz-text-ink, #1f2329);\n    background: var(--vmz-surface-mist, #f7f8fa);\n    border: 1px solid var(--vmz-line-subtle, #f0f1f3);\n    border-radius: 4px;\n    padding: 0.0625rem 0.3125rem;\n    word-break: break-word;\n}\n\n/* Code blocks: near-black surface, token chrome, theme-owned syntax colors */\n.doc-content main pre {\n    position: relative;\n    margin: 0 0 1.375rem;\n    padding: 1.125rem 1.25rem;\n    overflow-x: auto;\n    border: 1px solid var(--vmz-line-default, #e5e6eb);\n    border-radius: 8px;\n    background: var(--vmz-surface-code, #0f1115);\n    color: var(--vmz-text-on-ink, #f7f8fa);\n    font-size: 0.84375rem;\n    line-height: 1.7;\n    tab-size: 4;\n}\n\n/* Copy button (injected by assets/vmz-document.js; hidden without JS) */\n.doc-copy {\n    position: absolute;\n    top: 0.5rem;\n    right: 0.5rem;\n    padding: 0.1875rem 0.5rem;\n    font-size: 0.75rem;\n    font-weight: 400;\n    line-height: 1.4;\n    color: var(--vmz-text-muted, #6b7178);\n    background: var(--vmz-surface-mist, #f7f8fa);\n    border: 1px solid var(--vmz-line-default, #e5e6eb);\n    border-radius: 4px;\n    cursor: pointer;\n    opacity: 0;\n    transition: opacity 120ms ease;\n}\n\npre:hover .doc-copy,\npre:focus-within .doc-copy,\n.doc-copy:focus-visible {\n    opacity: 1;\n}\n\n.doc-copy--done {\n    color: var(--vmz-status-success-accent, #237804);\n}\n\n/* Heading self anchors (build-time, no-JS usable) */\n.h-anchor {\n    margin-left: 0.4em;\n    font-size: 0.8em;\n    font-weight: 400;\n    text-decoration: none;\n    color: var(--vmz-text-muted, #6b7178);\n    opacity: 0;\n    transition: opacity 120ms ease;\n}\n\n.doc-content main h2:hover .h-anchor,\n.doc-content main h3:hover .h-anchor,\n.doc-content main h4:hover .h-anchor,\n.h-anchor:focus-visible {\n    opacity: 1;\n}\n\n.doc-content main pre code {\n    font-family: var(--vmz-font-mono, ui-monospace, monospace);\n    font-size: inherit;\n    background: transparent;\n    border: 0;\n    padding: 0;\n    color: inherit;\n}\n\n/* Tables */\n.doc-content main table {\n    width: 100%;\n    border-collapse: separate;\n    border-spacing: 0;\n    margin: 0.75rem 0 1.5rem;\n    font-size: 0.9375rem;\n    border: 1px solid var(--vmz-line-default, #e5e6eb);\n    border-radius: 10px;\n    display: block;\n    overflow-x: auto;\n}\n\n.doc-content main thead th {\n    background: var(--vmz-surface-mist, #f7f8fa);\n    border-bottom: 1px solid var(--vmz-line-default, #e5e6eb);\n    font-size: 0.8125rem;\n    font-weight: 600;\n    color: var(--vmz-text-muted, #6b7178);\n    text-align: left;\n    padding: 0.6875rem 1rem;\n    white-space: nowrap;\n}\n\n.doc-content main td,\n.doc-content main tbody th {\n    border-bottom: 1px solid var(--vmz-line-subtle, #f0f1f3);\n    padding: 0.6875rem 1rem;\n    vertical-align: top;\n    line-height: 1.6;\n    color: var(--vmz-text-steel, #51565d);\n}\n\n.doc-content main tbody tr:last-child td {\n    border-bottom: 0;\n}\n\n.doc-content main tbody tr:hover td {\n    background: var(--vmz-surface-fill, #fafbfc);\n}\n\n.doc-content main td code {\n    font-size: 0.8125rem;\n}\n\n/* Blockquote / callouts */\n.doc-content main blockquote {\n    margin: 0 0 1.25rem;\n    padding: 0.875rem 1.125rem;\n    border: 1px solid var(--vmz-line-default, #e5e6eb);\n    border-left: 3px solid var(--vmz-brand-primary, #1677ff);\n    border-radius: 0 8px 8px 0;\n    background: var(--vmz-surface-mist, #f7f8fa);\n    font-size: 1rem;\n    color: var(--vmz-text-steel, #51565d);\n}\n\n.doc-content main blockquote p {\n    margin: 0;\n    font-size: 1rem;\n}\n\n.doc-content main .warn {\n    background: var(--vmz-status-warning-background, #fff7e6);\n    border: 1px solid var(--vmz-status-warning-border, #ffe7ba);\n    border-left: 3px solid var(--vmz-status-warning-accent, #d48806);\n    color: var(--vmz-status-warning-foreground, #ad6800);\n    padding: 0.875rem 1.125rem;\n    border-radius: 0 8px 8px 0;\n    margin: 0 0 1.25rem;\n    font-size: 0.9375rem;\n    line-height: 1.65;\n}\n\n.doc-content main .warn p {\n    color: inherit;\n    font-size: inherit;\n    margin: 0;\n}\n\n/* Playground / island shells */\n.doc-content main [data-vmz-island],\n.doc-content main .doc-playground {\n    border: 1px solid var(--vmz-line-default, #e5e6eb);\n    border-radius: var(--vmz-radius-xs, 4px);\n    background: var(--vmz-surface-fill, #fafbfc);\n    padding: 0.75rem;\n    margin: 0 0 1rem;\n}\n\n.doc-content main .doc-playground-source,\n.doc-content main .doc-playground-fallback {\n    font-size: 0.8125rem;\n    color: var(--vmz-text-muted, #6b7178);\n}\n\n/* Standalone mount emits the same .site.site--docs > .doc-body skeleton as\n   the integrated shell \u2014 no second DOM shape. */\n\n.skip-link {\n    position: absolute;\n    left: -999px;\n    top: 0.75rem;\n    z-index: 50;\n    padding: 0.45rem 0.75rem;\n    background: var(--vmz-brand-primary, #1677ff);\n    color: var(--vmz-text-on-brand, #ffffff);\n    text-decoration: none;\n}\n\n.skip-link:focus {\n    left: 0.75rem;\n}\n\n/* Responsive ------------------------------------------------------------ */\n\n@media (max-width: 1100px) {\n    .doc-content {\n        grid-template-columns: minmax(0, 1fr);\n        padding: 1.75rem 1.5rem 2.5rem;\n    }\n\n    .toc {\n        position: static;\n        order: -1;\n        border-left: 0;\n        border-bottom: 1px solid var(--vmz-line-subtle, #f0f1f3);\n        padding: 0 0 0.75rem;\n        margin-bottom: 1.5rem;\n    }\n}\n\n@media (max-width: 860px) {\n    .site--docs > .doc-body,\n    body > .doc-body {\n        grid-template-columns: 1fr;\n    }\n\n    .doc-sidebar {\n        position: static;\n        max-height: none;\n        border-right: 0;\n        border-bottom: 1px solid var(--vmz-line-default, #e5e6eb);\n        padding: 1rem;\n    }\n\n    .doc-content {\n        padding: 1.25rem 1rem 2rem;\n    }\n\n    .doc-content main h1 {\n        font-size: 1.375rem;\n    }\n\n    .doc-content main pre {\n        font-size: 0.75rem;\n    }\n}\n";