@vmz/vmz 0.0.2 → 0.0.4

package/dist/dev-session.js

@@ -1,15 +1,16 @@
 // @ts-nocheck
 /**
- * Long-lived Node dev session (N2/N4).
+ * Long-lived Node dev session (/session).
  *
  * Rebuilds go through the N-API `Workspace` — never spawn `cargo` / `vmz-tools`.
- * N4: only dirty leaves are marked; Workspace emits affected deployment units.
+ * session: only dirty leaves are marked; Workspace emits affected deployment units.
  */
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { buildIntegratedDocuments, projectHasDocuments } from './document-integrate.js';
 import { createWorkspace } from './index.js';
+import { emitLocaleRuntimeModules, localeHasErrors } from './locale-check.js';
 import { log } from './log.js';
 import { diffFingerprints, fileFingerprintMap } from './watch-diff.js';
 /**
@@ -48,12 +49,23 @@ export function createDevSession(options) {
             ws.updateFiles(changes);
         return ws.build();
     }
+    function emitLocales() {
+        const localeEmit = emitLocaleRuntimeModules(project, outDir);
+        if (!localeEmit.ok || localeHasErrors({ diagnostics: localeEmit.diagnostics })) {
+            log.diagnostics(localeEmit.diagnostics ?? []);
+            log.error('locale runtime emit failed');
+            return false;
+        }
+        return true;
+    }
     function printReport(report, label) {
         const errors = log.diagnostics(report.diagnostics ?? []);
         if (errors) {
             log.error(`${label} failed (${errors} error(s))`);
             return false;
         }
+        if (!emitLocales())
+            return false;
         const mode = report.full ? 'full' : 'affected';
         const chunks = (report.affectedChunks || []).join(', ') || '(none)';
         log.info(`${label} ok (${mode}; chunks=[${chunks}]; ${(report.emitted ?? []).length} emitted)`);
@@ -65,7 +77,7 @@ export function createDevSession(options) {
             throw new Error(`vmz dev: missing src/ under ${project}`);
         }
         log.info('initial build (N-API workspace, full)…');
-        // Empty dirty → full project build (N4).
+        // Empty dirty → full project build (session).
         const initial = rebuild();
         if (!printReport(initial, 'build')) {
             throw new Error('vmz dev: initial build failed');
@@ -82,7 +94,8 @@ export function createDevSession(options) {
         }
         child = spawnHost({ project, outDir, host, port });
         const docsRoot = path.join(project, 'documents');
-        const watchRoots = [src].concat(existsSync(docsRoot) ? [docsRoot] : []);
+        const localesRoot = path.join(project, 'locales');
+        const watchRoots = [src].concat(existsSync(docsRoot) ? [docsRoot] : []).concat(existsSync(localesRoot) ? [localesRoot] : []);
         log.info(`dev → http://${host}:${port} (watching ${watchRoots.join(', ')})`);
         /** @type {Map<string, Map<string, string>>} */
         let fingerprints = new Map();
@@ -100,10 +113,12 @@ export function createDevSession(options) {
                 if (stopped || signal?.aborted)
                     break;
                 if (child && child.exitCode != null) {
-                    throw new Error(`vmz serve-host exited: ${child.exitCode}`);
+                    log.warn(`serve-host exited (${child.exitCode}) — respawning…`);
+                    child = spawnHost({ project, outDir, host, port });
+                    continue;
                 }
-                /** @type {{ srcChanged: string[], srcDeleted: string[], docsDirty: boolean }} */
-                let batch = { srcChanged: [], srcDeleted: [], docsDirty: false };
+                /** @type {{ srcChanged: string[], srcDeleted: string[], docsDirty: boolean, localesDirty: boolean }} */
+                let batch = { srcChanged: [], srcDeleted: [], docsDirty: false, localesDirty: false };
                 try {
                     // Probe only — keep prior fingerprints until debounce resample
                     // (same contract as pre-docs watcher: empty second pass would miss soft reload).
@@ -115,6 +130,10 @@ export function createDevSession(options) {
                             batch.srcChanged = diff.changed;
                             batch.srcDeleted = diff.deleted;
                         }
+                        else if (root === localesRoot) {
+                            if (diff.changed.length || diff.deleted.length)
+                                batch.localesDirty = true;
+                        }
                         else if (diff.changed.length || diff.deleted.length) {
                             batch.docsDirty = true;
                         }
@@ -124,11 +143,11 @@ export function createDevSession(options) {
                     log.warn('watch error:', err);
                     continue;
                 }
-                if (!batch.srcChanged.length && !batch.srcDeleted.length && !batch.docsDirty)
+                if (!batch.srcChanged.length && !batch.srcDeleted.length && !batch.docsDirty && !batch.localesDirty)
                     continue;
                 await sleep(200);
                 // Resample against the same prior fingerprints, then commit.
-                batch = { srcChanged: [], srcDeleted: [], docsDirty: false };
+                batch = { srcChanged: [], srcDeleted: [], docsDirty: false, localesDirty: false };
                 for (const root of watchRoots) {
                     const prev = fingerprints.get(root) || new Map();
                     const next = fileFingerprintMap(root);
@@ -138,11 +157,15 @@ export function createDevSession(options) {
                         batch.srcChanged = diff.changed;
                         batch.srcDeleted = diff.deleted;
                     }
+                    else if (root === localesRoot) {
+                        if (diff.changed.length || diff.deleted.length)
+                            batch.localesDirty = true;
+                    }
                     else if (diff.changed.length || diff.deleted.length) {
                         batch.docsDirty = true;
                     }
                 }
-                if (!batch.srcChanged.length && !batch.srcDeleted.length && !batch.docsDirty)
+                if (!batch.srcChanged.length && !batch.srcDeleted.length && !batch.docsDirty && !batch.localesDirty)
                     continue;
                 let needFullReload = batch.docsDirty;
                 if (batch.srcChanged.length || batch.srcDeleted.length) {
@@ -180,12 +203,26 @@ export function createDevSession(options) {
                                 : 'soft reload ok (full page)');
                     }
                     catch (err) {
-                        log.warn(`soft reload failed (${err}) — restarting serve-host…`);
-                        killChild(child);
-                        child = spawnHost({ project, outDir, host, port });
+                        log.warn(`soft reload failed (${err}) — keeping previous serve-host (fix and save)`);
                     }
                     continue;
                 }
+                if (batch.localesDirty) {
+                    log.info('locales change detected — re-emitting #locales runtime…');
+                    if (!emitLocales()) {
+                        log.warn('locale runtime emit failed — keeping previous modules');
+                        continue;
+                    }
+                    try {
+                        await softReload(host, port, { full: true, islandHmr: false });
+                        log.info('soft reload ok (full page; locales)');
+                    }
+                    catch (err) {
+                        log.warn(`soft reload failed (${err}) — keeping previous serve-host (fix and save)`);
+                    }
+                    if (!batch.docsDirty)
+                        continue;
+                }
                 if (batch.docsDirty) {
                     log.info('documents change detected — rebuilding document mount…');
                     const docs = await buildIntegratedDocuments({ projectRoot: project, outDir });
@@ -198,9 +235,7 @@ export function createDevSession(options) {
                         log.info('soft reload ok (full page; docs)');
                     }
                     catch (err) {
-                        log.warn(`soft reload failed (${err}) — restarting serve-host…`);
-                        killChild(child);
-                        child = spawnHost({ project, outDir, host, port });
+                        log.warn(`soft reload failed (${err}) — keeping previous serve-host (fix and save)`);
                     }
                 }
             }

package/dist/document-build.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * Document D1 Static + D3 Interactive artifacts.
- * Design: 规划设计/vmz/19 §5–6 · D1/D3
+ * Document Static + Interactive artifacts.
  */
 import fs from 'node:fs';
 import path from 'node:path';

package/dist/document-check.d.ts

@@ -1,5 +1,5 @@
 /**
- * Build DocumentManifest + run D0 / --strict checks.
+ * Build DocumentManifest + run / --strict checks.
  */
 /**
  * Resolve project documents root.

package/dist/document-check.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 /**
- * Build DocumentManifest + run D0 / --strict checks.
+ * Build DocumentManifest + run / --strict checks.
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -44,7 +44,7 @@ export function loadDocumentsConfig(documentsRoot) {
     return { config: null, diagnostics, configPath: null };
 }
 /**
- * D0: only declaration objects — no arbitrary hooks.
+ *: only declaration objects — no arbitrary hooks.
  * @param {string} raw
  * @param {string} filename
  */
@@ -88,7 +88,7 @@ export function checkDocuments(opts) {
         diagnostics.push({
             code: DIAG.CONFIG_MISSING,
             severity: strict ? 'error' : 'warning',
-            message: 'documents.config.json|ts missing; D0 requires defaultLocale + locales for strict coverage checks',
+            message: 'documents.config.json|ts missing; strict mode requires defaultLocale + locales for strict coverage checks',
             path: documentsRoot,
         });
     }
@@ -175,7 +175,7 @@ export function checkDocuments(opts) {
             });
         }
     }
-    // D0: no silent whole-page fallback by default
+    // no silent whole-page fallback by default
     if (config && config.fallback === true) {
         diagnostics.push({
             code: DIAG.FALLBACK_SILENT,

package/dist/document-cmd.d.ts

@@ -1,6 +1,5 @@
 /**
- * `vmz document` / `vmz docs` CLI (D0 check · D1 build).
- * Design: 规划设计/vmz/19 §1 · §8
+ * `vmz document` / `vmz docs` CLI .
  */
 /**
  * @param {string[]} argv

package/dist/document-cmd.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * `vmz document` / `vmz docs` CLI (D0 check · D1 build).
- * Design: 规划设计/vmz/19 §1 · §8
+ * `vmz document` / `vmz docs` CLI .
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -14,7 +13,7 @@ import { createWorkspace } from './index.js';
 import { log } from './log.js';
 import { parseArgs } from './cli.js';
 function printDocumentHelp() {
-    console.log(`vmz document — project /documents domain (D0–D3)
+    console.log(`vmz document — project /documents domain
 
 Usage:
   vmz document check [project]   Check locale tree + links/anchors + fence/API evidence

package/dist/document-designs.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 /**
- * Document D1 — wire project `/designs` into static document assets.
+ * Document — wire project `/designs` into static document assets.
  * Prefer compiled `vmz-designs.css` / `vmz.css`; else emit a minimal token CSS.
  */
 import fs from 'node:fs';
@@ -64,12 +64,17 @@ function emitMinimalDesignsCss(designsDir) {
     const vars = {};
     const tokenDir = path.join(designsDir, 'tokens');
     if (fs.existsSync(tokenDir)) {
-        walkJson(tokenDir, (obj, prefix) => flattenTokens(obj, prefix, vars));
+        walkJson(tokenDir, (obj, prefix) => {
+            collectStyleThemeEntries(obj, vars);
+            flattenTokens(obj, prefix, vars);
+        });
     }
     const themeJson = path.join(designsDir, 'theme.json');
     if (fs.existsSync(themeJson)) {
         try {
-            flattenTokens(JSON.parse(fs.readFileSync(themeJson, 'utf8')), '', vars);
+            const theme = JSON.parse(fs.readFileSync(themeJson, 'utf8'));
+            collectStyleThemeEntries(theme, vars);
+            flattenTokens(theme, '', vars);
         }
         catch {
             /* ignore */
@@ -89,10 +94,33 @@ function cssVar(key) {
         .replace(/^-|-$/g, '');
     return `--${name}`;
 }
+/**
+ * Style Theme entries (`key.path` + `value`) → `vmz-*` CSS vars (same naming as application compile).
+ * @param {unknown} obj
+ * @param {Record<string, string>} out
+ */
+function collectStyleThemeEntries(obj, out) {
+    if (obj == null || typeof obj !== 'object' || Array.isArray(obj))
+        return;
+    const entries = /** @type {{ key?: { path?: unknown }, value?: unknown }[]} */ ( /** @type {{ entries?: unknown }} */(obj).entries);
+    if (!Array.isArray(entries))
+        return;
+    for (const e of entries) {
+        const pathParts = e?.key?.path;
+        if (!Array.isArray(pathParts) || pathParts.length === 0)
+            continue;
+        if (typeof e.value !== 'string' && typeof e.value !== 'number')
+            continue;
+        const dotted = pathParts.map(String).join('-');
+        out[`vmz-${dotted}`] = String(e.value);
+    }
+}
 function flattenTokens(obj, prefix, out) {
     if (obj == null || typeof obj !== 'object' || Array.isArray(obj))
         return;
     for (const [k, v] of Object.entries(obj)) {
+        if (k === 'entries')
+            continue;
         const key = prefix ? `${prefix}-${k}` : k;
         if (v != null && typeof v === 'object' && !Array.isArray(v)) {
             if ('value' in v && (typeof v.value === 'string' || typeof v.value === 'number')) {

package/dist/document-enrich.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * Document D1 — enrich manifest with routes, anchors, nav; diagnose links.
- * Design: 规划设计/vmz/19 §5–6
+ * Document — enrich manifest with routes, anchors, nav; diagnose links.
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -115,7 +114,7 @@ export function enrichDocumentContent(manifest, ctx) {
             if (!href || href.startsWith('mailto:') || href.startsWith('http://') || href.startsWith('https://')) {
                 continue;
             }
-            // D2 API refs are resolved by evidence, not as page links.
+            // API refs are resolved by evidence, not as page links.
             if (href.startsWith('vmz-api:') || href.startsWith('api:')) {
                 continue;
             }

package/dist/document-evidence.d.ts

@@ -30,10 +30,10 @@ export declare function resolveApiSymbol(index: any, query: any): {
 /**
  * @param {import('./document-schema.js').DocumentManifest} manifest
  * @param {{
- *   analyzeMarkdown: Function,
- *   projectRoot: string,
- *   createWorkspace?: Function,
- *   ensureProgramGraph?: boolean,
+ * analyzeMarkdown: Function,
+ * projectRoot: string,
+ * createWorkspace?: Function,
+ * ensureProgramGraph?: boolean,
  * }} ctx
  */
 export declare function enrichDocumentEvidence(manifest: any, ctx: any): Promise<{

package/dist/document-evidence.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * Document D2 Evidence — fence check + API refs from Program Graph.
- * Design: 规划设计/vmz/19 §4 · §8 D2
+ * Document Evidence — fence check + API refs from Program Graph.
  *
  * Not a Doc IR: filesystem/manifest projection + Workspace/Program Graph queries.
  */
@@ -117,10 +116,10 @@ export function resolveApiSymbol(index, query) {
 /**
  * @param {import('./document-schema.js').DocumentManifest} manifest
  * @param {{
- *   analyzeMarkdown: Function,
- *   projectRoot: string,
- *   createWorkspace?: Function,
- *   ensureProgramGraph?: boolean,
+ * analyzeMarkdown: Function,
+ * projectRoot: string,
+ * createWorkspace?: Function,
+ * ensureProgramGraph?: boolean,
  * }} ctx
  */
 export async function enrichDocumentEvidence(manifest, ctx) {
@@ -424,22 +423,31 @@ function checkScriptFence({ fence, meta, sourcePath, page }) {
             diagnostics.push({
                 code: DIAG.FENCE_CHECK,
                 severity: 'error',
-                message: `${meta.lang} fence parse produced empty SourceFile`,
+                message: `${meta.lang} fence parse produced no SourceFile`,
                 path: `${sourcePath}:${fence.lineStart}`,
             });
-            return { record: { status: 'failed' }, diagnostics };
+            return { record: { status: 'failed', detail: 'parse' }, diagnostics };
         }
-        return { record: { status: 'ok', detail: 'syntax' }, diagnostics };
+        return { record: { status: 'ok' }, diagnostics };
     }
     catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (/Cannot find module ['\"]typescript['\"]/i.test(msg) || e?.code === 'MODULE_NOT_FOUND') {
+            diagnostics.push({
+                code: DIAG.FENCE_CHECK,
+                severity: 'error',
+                message: 'TS/JS fence check needs `typescript` (optional peer of `@vmz/vmz`). Install: pnpm add -D typescript',
+                path: `${sourcePath}:${fence.lineStart}`,
+            });
+            return { record: { status: 'failed', detail: 'missing-typescript' }, diagnostics };
+        }
         diagnostics.push({
             code: DIAG.FENCE_CHECK,
             severity: 'error',
-            message: `${meta.lang} fence check unavailable: ${e.message || e}`,
+            message: `${meta.lang} fence check failed: ${msg}`,
             path: `${sourcePath}:${fence.lineStart}`,
-            pageKey: page?.identity?.pageKey,
         });
-        return { record: { status: 'failed', detail: 'engine' }, diagnostics };
+        return { record: { status: 'failed', detail: 'exception' }, diagnostics };
     }
 }
 function walkFiles(dir, fn) {

package/dist/document-integrate.d.ts

@@ -1,7 +1,6 @@
 /**
  * Integrated DocumentMount — build /documents into the host app dist so
  * routeBase (e.g. /d) is served as static HTML next to SSR pages.
- * Design: 规划设计/vmz/19 · Integrated DocumentMount (same project, no separate package).
  */
 /**
  * @param {string} projectRoot

package/dist/document-integrate.js

@@ -2,7 +2,6 @@
 /**
  * Integrated DocumentMount — build /documents into the host app dist so
  * routeBase (e.g. /d) is served as static HTML next to SSR pages.
- * Design: 规划设计/vmz/19 · Integrated DocumentMount (same project, no separate package).
  */
 import fs from 'node:fs';
 import path from 'node:path';

package/dist/document-interactive.d.ts

@@ -5,10 +5,10 @@
 export declare function htmlToSearchText(html: any): string;
 /**
  * @param {{
- *   manifest: any,
- *   enriched: { byId: Map<string, any> },
- *   evidence: any,
- *   version?: string | null,
+ * manifest: any,
+ * enriched: { byId: Map<string, any> },
+ * evidence: any,
+ * version?: string | null,
  * }} opts
  */
 export declare function buildDocumentSearch(opts: any): {
@@ -20,9 +20,9 @@ export declare function buildDocumentSearch(opts: any): {
 /**
  * Island-only resume plan for document surfaces.
  * @param {{
- *   evidence: any,
- *   searchHref?: string,
- *   fenceBodies?: Map<string, string>,
+ * evidence: any,
+ * searchHref?: string,
+ * fenceBodies?: Map<string, string>,
  * }} opts
  */
 export declare function buildDocumentIslands(opts: any): {
@@ -57,10 +57,10 @@ export declare function collectFenceBodies(analyzedByPageId: any, pages: any): M
 /**
  * Render SSR island shells (no script — resume later).
  * @param {{
- *   islands: any,
- *   searchIndexHref: string,
- *   pageKey: string,
- *   locale: string,
+ * islands: any,
+ * searchIndexHref: string,
+ * pageKey: string,
+ * locale: string,
  * }} opts
  */
 export declare function renderIslandShellsHtml(opts: any): {

package/dist/document-interactive.js

@@ -1,7 +1,6 @@
 // @ts-nocheck
 /**
- * Document D3 Interactive — search index + Island-only resume plan.
- * Design: 规划设计/vmz/19 §5–6 · §8 D3
+ * Document Interactive — search index + Island-only resume plan.
  *
  * Not a Doc IR: build artifacts + ResumeEntry-shaped island hosts.
  * Static HTML stays no-JS readable; islands resume later, never full-page hydrate.
@@ -27,10 +26,10 @@ export function htmlToSearchText(html) {
 }
 /**
  * @param {{
- *   manifest: any,
- *   enriched: { byId: Map<string, any> },
- *   evidence: any,
- *   version?: string | null,
+ * manifest: any,
+ * enriched: { byId: Map<string, any> },
+ * evidence: any,
+ * version?: string | null,
  * }} opts
  */
 export function buildDocumentSearch(opts) {
@@ -114,9 +113,9 @@ export function buildDocumentSearch(opts) {
 /**
  * Island-only resume plan for document surfaces.
  * @param {{
- *   evidence: any,
- *   searchHref?: string,
- *   fenceBodies?: Map<string, string>,
+ * evidence: any,
+ * searchHref?: string,
+ * fenceBodies?: Map<string, string>,
  * }} opts
  */
 export function buildDocumentIslands(opts) {
@@ -216,10 +215,10 @@ export function collectFenceBodies(analyzedByPageId, pages) {
 /**
  * Render SSR island shells (no script — resume later).
  * @param {{
- *   islands: any,
- *   searchIndexHref: string,
- *   pageKey: string,
- *   locale: string,
+ * islands: any,
+ * searchIndexHref: string,
+ * pageKey: string,
+ * locale: string,
  * }} opts
  */
 export function renderIslandShellsHtml(opts) {

package/dist/document-locale.d.ts

@@ -1,5 +1,5 @@
 /**
- * Locale key validation & canonicalization (D0).
+ * Locale key validation & canonicalization .
  */
 /**
  * Soft-normalize for alias / conflict detection (does not validate).

package/dist/document-locale.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 /**
- * Locale key validation & canonicalization (D0).
+ * Locale key validation & canonicalization .
  */
 import { LOCALE_ALIASES } from './document-schema.js';
 /** Literal must be lowercase ASCII BCP 47-ish with `-` separators only. */

package/dist/document-markdown.d.ts

@@ -1,6 +1,5 @@
 /**
- * Document D1 — resolve engines.markdown via the official plugin runtime.
- * Design: 规划设计/vmz/19 §3 · 23 §0（runtime.ts；与 plugin-host 同一 importMaybeTs）.
+ * Document — resolve engines.markdown via the official plugin runtime.
  */
 /**
  * @param {{ engines?: { markdown?: string } }} [opts]

package/dist/document-markdown.js

@@ -1,9 +1,9 @@
 // @ts-nocheck
 /**
- * Document D1 — resolve engines.markdown via the official plugin runtime.
- * Design: 规划设计/vmz/19 §3 · 23 §0（runtime.ts；与 plugin-host 同一 importMaybeTs）.
+ * Document — resolve engines.markdown via the official plugin runtime.
  */
 import { createRequire } from 'node:module';
+import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { importMaybeTs } from './plugin-host.js';
@@ -14,17 +14,23 @@ const require = createRequire(import.meta.url);
 export async function resolveMarkdownEngine(opts = {}) {
     const id = opts.engines?.markdown || 'markdown-it';
     if (id !== 'markdown-it') {
-        throw new Error(`unsupported engines.markdown ${JSON.stringify(id)} (D1: markdown-it only)`);
+        throw new Error(`unsupported engines.markdown ${JSON.stringify(id)} (markdown-it only)`);
     }
-    let runtimeFile;
+    let runtimeFile = null;
     try {
         const pkg = require.resolve('@vmz/plugin-markdown-it/package.json');
         runtimeFile = path.join(path.dirname(pkg), 'runtime.ts');
     }
-    catch (e) {
-        // Workspace fallback when package exports omit package.json.
+    catch {
+        // Developer mode: monorepo source checkout.
         const here = path.dirname(fileURLToPath(import.meta.url));
-        runtimeFile = path.resolve(here, '../../../plugins/vmz-plugin-markdown-it/runtime.ts');
+        const fallback = path.resolve(here, '../../../plugins/vmz-plugin-markdown-it/runtime.ts');
+        if (existsSync(fallback))
+            runtimeFile = fallback;
+    }
+    if (!runtimeFile || !existsSync(runtimeFile)) {
+        throw new Error('markdown engine needs `@vmz/plugin-markdown-it` (optional peer of `@vmz/vmz`).\n' +
+            '  Install:  pnpm add -D @vmz/plugin-markdown-it');
     }
     const mod = await importMaybeTs(runtimeFile);
     if (typeof mod.analyzeMarkdown !== 'function') {

package/dist/document-scan.d.ts

@@ -1,5 +1,5 @@
 /**
- * Scan /documents tree → pages + locale dirs (D0).
+ * Scan /documents tree → pages + locale dirs .
  */
 /**
  * PageKey from locale-relative markdown path (strip extension; index → parent or "index").
@@ -9,9 +9,9 @@ export declare function pageKeyFromRel(relMd: any): any;
 /**
  * @param {string} documentsRoot absolute path to .../documents
  * @returns {{
- *   locales: string[],
- *   pages: Array<{ identity: { pageKey: string, locale: string }, sourcePath: string }>,
- *   diagnostics: Array<{ code: string, severity: string, message: string, path?: string }>,
+ * locales: string[],
+ * pages: Array<{ identity: { pageKey: string, locale: string }, sourcePath: string }>,
+ * diagnostics: Array<{ code: string, severity: string, message: string, path?: string }>,
  * }}
  */
 export declare function scanDocumentsTree(documentsRoot: any): {

package/dist/document-scan.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 /**
- * Scan /documents tree → pages + locale dirs (D0).
+ * Scan /documents tree → pages + locale dirs .
  */
 import fs from 'node:fs';
 import path from 'node:path';
@@ -50,9 +50,9 @@ export function pageKeyFromRel(relMd) {
 /**
  * @param {string} documentsRoot absolute path to .../documents
  * @returns {{
- *   locales: string[],
- *   pages: Array<{ identity: { pageKey: string, locale: string }, sourcePath: string }>,
- *   diagnostics: Array<{ code: string, severity: string, message: string, path?: string }>,
+ * locales: string[],
+ * pages: Array<{ identity: { pageKey: string, locale: string }, sourcePath: string }>,
+ * diagnostics: Array<{ code: string, severity: string, message: string, path?: string }>,
  * }}
  */
 export function scanDocumentsTree(documentsRoot) {