@vmz/vmz 0.1.17 → 0.1.19

package/dist/locale-check.d.ts

@@ -1,56 +1,54 @@
-/**
- * @param {string} literal
- */
-export declare function validateLocaleId(literal: any): {
-    ok: boolean;
+export interface LocaleDiagnostic {
+    code: string;
+    severity: string;
     message: string;
-} | {
+    path?: string;
+}
+export interface MessageParam {
+    name: string;
+    kind: string;
+}
+export interface MessageVariant {
+    template: string;
+    params: MessageParam[];
+    path: string;
+}
+export interface MessageNode {
+    messageId: string;
+    catalogId: string;
+    variants: Record<string, MessageVariant>;
+}
+export declare function validateLocaleId(literal: string): {
     ok: boolean;
-    message?: undefined;
+    message?: string;
 };
 /**
  * Flatten catalog object into MessageId → string template.
  * Arrays are forbidden.
- * @param {any} node
- * @param {string} prefix
- * @param {Array<{code:string,severity:string,message:string,path?:string}>} diagnostics
- * @param {string} sourcePath
- * @returns {Map<string, string>}
  */
-export declare function flattenCatalog(node: any, prefix: any, diagnostics: any, sourcePath: any): Map<any, any>;
+export declare function flattenCatalog(node: unknown, prefix: string, diagnostics: LocaleDiagnostic[], sourcePath: string): Map<string, string>;
 /**
  * ICU MessageFormat compatible subset: extract argument names + kinds.
- * @param {string} template
- * @returns {{ ok: boolean, params: Array<{ name: string, kind: string }>, error?: string }}
  */
-export declare function extractMessageParams(template: any): {
-    ok: boolean;
-    params: any[];
-    error: string;
-} | {
+export declare function extractMessageParams(template: string): {
     ok: boolean;
-    params: {
-        name: any;
-        kind: any;
-    }[];
-    error?: undefined;
+    params: MessageParam[];
+    error?: string;
 };
-/**
- * Detect fallback cycles (explicit DAG).
- * @param {Record<string, string[]>} fallback
- * @param {Set<string>} known
- */
-export declare function findFallbackCycles(fallback: any, known: any): {
-    cycles: any[];
-    unknown: any[];
+/** Detect fallback cycles (explicit DAG). */
+export declare function findFallbackCycles(fallback: Record<string, string[]>, known: Set<string>): {
+    cycles: string[];
+    unknown: string[];
 };
-/**
- * @param {{ projectRoot: string, strict?: boolean, checkUnused?: boolean }} opts
- */
-export declare function checkLocales(opts: any): {
+export interface CheckLocalesOpts {
+    projectRoot: string;
+    strict?: boolean;
+    checkUnused?: boolean;
+}
+export declare function checkLocales(opts: CheckLocalesOpts): {
     schema: string;
     status: string;
-    root: any;
+    root: string;
     localesRoot: string;
     manifest: any;
     catalogIds: any[];
@@ -63,60 +61,61 @@ export declare function checkLocales(opts: any): {
         catalogs: any[];
         messageIds: any[];
     };
-    diagnostics: any;
+    diagnostics: LocaleDiagnostic[];
 };
 /**
  * Scan src for `#locales/<catalog>` imports and `messageId` string literals after import.
  * First-slice heuristic — full VPG edges land with compiler deepen.
  */
-export declare function scanLocaleUsages(projectRoot: any): {
-    catalogs: Set<unknown>;
-    messageIds: Set<unknown>;
-    importedNames: Map<any, any>;
+export declare function scanLocaleUsages(projectRoot: string): {
+    catalogs: Set<string>;
+    messageIds: Set<string>;
+    importedNames: Map<string, Set<string>>;
 };
-/**
- * Emit typed module stubs for `#locales/*` ( surface).
- * @param {ReturnType<typeof checkLocales>} report
- * @param {string} outDir
- */
-export declare function emitLocaleTypedModules(report: any, outDir: any): any[];
+/** Emit typed module stubs for `#locales/*`. */
+export declare function emitLocaleTypedModules(report: ReturnType<typeof checkLocales>, outDir: string): string[];
 /**
  * Emit runtime `#locales/<catalog>.js` into application `dist/` and rewrite
  * client imports from `#locales/...` to relative ESM paths.
  *
  * Variant pick reads `html[data-locale]` (else defaultLocale). Thin bridge until
  * host LocaleTransition reloads locale-scoped chunks (I2/I4).
- *
- * @param {string} projectRoot
- * @param {string} distDir
- * @returns {{ ok: boolean, written: string[], diagnostics: any[] }}
  */
-export declare function emitLocaleRuntimeModules(projectRoot: any, distDir: any): {
+export declare function emitLocaleRuntimeModules(projectRoot: string, distDir: string): {
     ok: boolean;
-    written: any[];
-    diagnostics: any;
+    written: string[];
+    diagnostics: LocaleDiagnostic[];
 };
-/**
- * MessageId rename plan — WorkspaceEdit-shaped, no parallel rename IR.
- * @param {ReturnType<typeof checkLocales>} report
- * @param {string} fromId
- * @param {string} toId
- */
-export declare function planLocaleRename(report: any, fromId: any, toId: any): {
+/** MessageId rename plan — WorkspaceEdit-shaped, no parallel rename IR. */
+export declare function planLocaleRename(report: ReturnType<typeof checkLocales>, fromId: string, toId: string): {
     schema: string;
     status: string;
-    fromId: any;
-    toId: any;
-    edits: any[];
+    fromId: string;
+    toId: string;
+    edits: Array<{
+        path: string;
+        kind: string;
+        from: string;
+        to: string;
+    }>;
     error: string;
     virtualModule?: undefined;
 } | {
     schema: string;
     status: string;
-    fromId: any;
-    toId: any;
-    edits: any[];
+    fromId: string;
+    toId: string;
+    edits: {
+        path: string;
+        kind: string;
+        from: string;
+        to: string;
+    }[];
     virtualModule: string;
     error?: undefined;
 };
-export declare function localeHasErrors(report: any): any;
+export declare function localeHasErrors(report: {
+    diagnostics?: Array<{
+        severity?: string;
+    }>;
+}): boolean;

package/dist/locale-check.js

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Locale check + message contracts / typed module projection.
  *
@@ -10,9 +9,6 @@ import { loadLocalePlan, mapPlanDiagnostics, parseAuthorInput } from './author-i
 import { DIAG_CATALOG_CONFLICT, DIAG_CATALOG_PARSE, DIAG_DIR_MISSING, DIAG_DIR_ORPHAN, DIAG_ID_INVALID, DIAG_LAYOUT_ILLEGAL, DIAG_MANIFEST_MISSING, DIAG_MESSAGE_ARRAY_FORBIDDEN, DIAG_MESSAGE_HTML_FORBIDDEN, DIAG_MESSAGE_MISSING_DEFAULT, DIAG_MESSAGE_MISSING_VARIANT, DIAG_MESSAGE_PARAMETER_MISMATCH, DIAG_MESSAGE_SYNTAX_INVALID, DIAG_MESSAGE_UNUSED, LOCALE_CHECK_SCHEMA, LOCALE_ID_RE, LOCALE_MANIFEST_SCHEMA, LOCALE_RESERVED_TOP, LOCALE_TYPED_MODULE_SCHEMA, LOCALE_VIRTUAL_MODULE_PREFIX, MESSAGE_CATALOG_SCHEMA, MESSAGE_NODE_SCHEMA, } from './locale-schema.js';
 import { requireNativeAddon } from './native-addon.js';
 import { writePrettyJsonFile } from './pretty-json.js';
-/**
- * @param {string} literal
- */
 export function validateLocaleId(literal) {
     const name = String(literal || '');
     if (!name)
@@ -34,14 +30,8 @@ export function validateLocaleId(literal) {
 /**
  * Flatten catalog object into MessageId → string template.
  * Arrays are forbidden.
- * @param {any} node
- * @param {string} prefix
- * @param {Array<{code:string,severity:string,message:string,path?:string}>} diagnostics
- * @param {string} sourcePath
- * @returns {Map<string, string>}
  */
 export function flattenCatalog(node, prefix, diagnostics, sourcePath) {
-    /** @type {Map<string, string>} */
     const out = new Map();
     if (node == null || typeof node !== 'object') {
         diagnostics.push({
@@ -101,12 +91,9 @@ export function flattenCatalog(node, prefix, diagnostics, sourcePath) {
 }
 /**
  * ICU MessageFormat compatible subset: extract argument names + kinds.
- * @param {string} template
- * @returns {{ ok: boolean, params: Array<{ name: string, kind: string }>, error?: string }}
  */
 export function extractMessageParams(template) {
     const text = String(template ?? '');
-    /** @type {Map<string, string>} */
     const params = new Map();
     let i = 0;
     while (i < text.length) {
@@ -181,7 +168,6 @@ function findMatchingBrace(text, openIdx) {
     return -1;
 }
 function splitTopLevel(text, sep) {
-    /** @type {string[]} */
     const parts = [];
     let depth = 0;
     let start = 0;
@@ -199,15 +185,9 @@ function splitTopLevel(text, sep) {
     parts.push(text.slice(start));
     return parts;
 }
-/**
- * Detect fallback cycles (explicit DAG).
- * @param {Record<string, string[]>} fallback
- * @param {Set<string>} known
- */
+/** Detect fallback cycles (explicit DAG). */
 export function findFallbackCycles(fallback, known) {
-    /** @type {string[]} */
     const cycles = [];
-    /** @type {string[]} */
     const unknown = [];
     for (const [from, tos] of Object.entries(fallback || {})) {
         if (!known.has(from))
@@ -218,9 +198,7 @@ export function findFallbackCycles(fallback, known) {
         }
     }
     for (const start of Object.keys(fallback || {})) {
-        /** @type {Set<string>} */
         const stack = new Set();
-        /** @type {string[]} */
         const path = [];
         const visit = (node) => {
             if (stack.has(node)) {
@@ -240,13 +218,9 @@ export function findFallbackCycles(fallback, known) {
     }
     return { cycles: [...new Set(cycles)], unknown: [...new Set(unknown)] };
 }
-/**
- * @param {{ projectRoot: string, strict?: boolean, checkUnused?: boolean }} opts
- */
 export function checkLocales(opts) {
     const projectRoot = path.resolve(opts.projectRoot);
     const localesRoot = path.join(projectRoot, 'locales');
-    /** @type {Array<{ code: string, severity: string, message: string, path?: string }>} */
     const diagnostics = [];
     const plan = loadLocalePlan(projectRoot);
     diagnostics.push(...mapPlanDiagnostics(plan.diagnostics));
@@ -255,15 +229,12 @@ export function checkLocales(opts) {
         return emptyReport(projectRoot, diagnostics);
     }
     const localeEntries = plan.locales || [];
-    /** @type {string[]} */
     const orderedIds = localeEntries.map((e) => e.id);
-    /** @type {Set<string>} */
     const seen = new Set(orderedIds);
     const defaultLocale = String(plan.defaultLocale || '');
     const fallback = plan.fallback && typeof plan.fallback === 'object' ? plan.fallback : {};
     const missingPolicy = plan.missing || 'error';
     const routing = plan.routing || { strategy: 'prefix', defaultPrefix: 'include' };
-    /** @type {string[]} */
     const diskLocales = [];
     if (fs.existsSync(localesRoot)) {
         for (const ent of fs.readdirSync(localesRoot, { withFileTypes: true })) {
@@ -311,9 +282,7 @@ export function checkLocales(opts) {
             });
         }
     }
-    /** @type {Map<string, { messageId: string, catalogId: string, variants: Record<string, { template: string, params: any[], path: string }> }>} */
     const messages = new Map();
-    /** @type {string[]} */
     const catalogIds = [];
     for (const locale of orderedIds) {
         const dir = path.join(localesRoot, locale);
@@ -324,7 +293,6 @@ export function checkLocales(opts) {
             const catalogId = rel.replace(/\.(json5|json|ya?ml)$/i, '').replace(/\//g, '.');
             if (!catalogIds.includes(catalogId))
                 catalogIds.push(catalogId);
-            /** @type {any} */
             let parsed = null;
             try {
                 const text = fs.readFileSync(fileAbs, 'utf8');
@@ -340,10 +308,11 @@ export function checkLocales(opts) {
                 parsed = parseAuthorInput(text);
             }
             catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
                 diagnostics.push({
                     code: DIAG_CATALOG_PARSE,
                     severity: 'error',
-                    message: `catalog parse failed: ${e.message || e}`,
+                    message: `catalog parse failed: ${msg}`,
                     path: path.relative(projectRoot, fileAbs).replace(/\\/g, '/'),
                 });
                 return;
@@ -421,7 +390,6 @@ export function checkLocales(opts) {
         }
     }
     const used = scanLocaleUsages(projectRoot);
-    /** @type {any[]} */
     const typedModules = [];
     const byCatalog = new Map();
     for (const node of messages.values()) {
@@ -430,7 +398,6 @@ export function checkLocales(opts) {
         byCatalog.get(node.catalogId).push(node);
     }
     for (const [catalogId, nodes] of byCatalog) {
-        /** @type {Map<string, number>} */
         const leafCount = new Map();
         for (const n of nodes) {
             const leaf = leafExportName(n.messageId);
@@ -549,11 +516,8 @@ function walkCatalogFiles(dir, fn) {
  * First-slice heuristic — full VPG edges land with compiler deepen.
  */
 export function scanLocaleUsages(projectRoot) {
-    /** @type {Set<string>} */
     const catalogs = new Set();
-    /** @type {Set<string>} */
     const messageIds = new Set();
-    /** @type {Map<string, Set<string>>} */
     const importedNames = new Map();
     const src = path.join(projectRoot, 'src');
     if (!fs.existsSync(src))
@@ -592,14 +556,9 @@ function walkSource(dir, fn) {
             fn(full);
     }
 }
-/**
- * Emit typed module stubs for `#locales/*` ( surface).
- * @param {ReturnType<typeof checkLocales>} report
- * @param {string} outDir
- */
+/** Emit typed module stubs for `#locales/*`. */
 export function emitLocaleTypedModules(report, outDir) {
     fs.mkdirSync(outDir, { recursive: true });
-    /** @type {string[]} */
     const written = [];
     const native = requireNativeAddon();
     if (typeof native.generateLocaleTypedModule !== 'function') {
@@ -630,10 +589,6 @@ export function emitLocaleTypedModules(report, outDir) {
  *
  * Variant pick reads `html[data-locale]` (else defaultLocale). Thin bridge until
  * host LocaleTransition reloads locale-scoped chunks (I2/I4).
- *
- * @param {string} projectRoot
- * @param {string} distDir
- * @returns {{ ok: boolean, written: string[], diagnostics: any[] }}
  */
 export function emitLocaleRuntimeModules(projectRoot, distDir) {
     const report = checkLocales({ projectRoot, checkUnused: false });
@@ -646,7 +601,6 @@ export function emitLocaleRuntimeModules(projectRoot, distDir) {
     }
     const defaultLocale = report.manifest.defaultLocale || 'zh-hans';
     const byId = new Map((report.messageCatalog?.messages || []).map((m) => [m.messageId, m]));
-    /** @type {string[]} */
     const written = [];
     const localesOut = path.join(distDir, 'locales');
     fs.mkdirSync(localesOut, { recursive: true });
@@ -654,7 +608,6 @@ export function emitLocaleRuntimeModules(projectRoot, distDir) {
         const exports = [];
         for (const exp of mod.exports || []) {
             const node = byId.get(exp.messageId);
-            /** @type {string[][]} */
             const variants = [];
             if (node?.variants) {
                 for (const [loc, v] of Object.entries(node.variants)) {
@@ -680,11 +633,7 @@ export function emitLocaleRuntimeModules(projectRoot, distDir) {
     rewriteLocaleImportsInDist(distDir);
     return { ok: true, written, diagnostics: report.diagnostics || [] };
 }
-/**
- * @param {string} distDir
- */
 function rewriteLocaleImportsInDist(distDir) {
-    /** @type {string[]} */
     const files = [];
     walkDistJs(distDir, (file) => files.push(file));
     for (const file of files) {
@@ -704,10 +653,6 @@ function rewriteLocaleImportsInDist(distDir) {
             fs.writeFileSync(file, next, 'utf8');
     }
 }
-/**
- * @param {string} dir
- * @param {(file: string) => void} fn
- */
 function walkDistJs(dir, fn) {
     if (!fs.existsSync(dir))
         return;
@@ -723,12 +668,7 @@ function walkDistJs(dir, fn) {
         }
     }
 }
-/**
- * MessageId rename plan — WorkspaceEdit-shaped, no parallel rename IR.
- * @param {ReturnType<typeof checkLocales>} report
- * @param {string} fromId
- * @param {string} toId
- */
+/** MessageId rename plan — WorkspaceEdit-shaped, no parallel rename IR. */
 export function planLocaleRename(report, fromId, toId) {
     const node = (report.messageCatalog?.messages || []).find((m) => m.messageId === fromId);
     if (!node) {
@@ -741,7 +681,6 @@ export function planLocaleRename(report, fromId, toId) {
             error: `unknown MessageId ${fromId}`,
         };
     }
-    /** @type {Array<{ path: string, kind: string, from: string, to: string }>} */
     const edits = [];
     for (const variant of Object.values(node.variants || {})) {
         edits.push({

package/dist/locale-cmd.d.ts

@@ -1,5 +1,2 @@
-/**
- * @param {string[]} argv
- * @returns {Promise<number>}
- */
-export declare function cmdLocale(argv: any): Promise<0 | 1>;
+import type { Command } from '@vmz/commander';
+export declare function registerLocaleCommands(parent: Command): void;