@vmz/vmz 0.0.4 → 0.1.1

package/dist/embedded-packaging.js

@@ -0,0 +1,109 @@
+/**
+ * rust-embedded packaging adapter: resource index + baseline closure.
+ * Packaging only — does not invent route / MIME / fallback semantics.
+ */
+// @ts-nocheck
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { writePrettyJsonFile } from './pretty-json.js';
+export const EMBEDDED_RESOURCE_INDEX_SCHEMA = 'vmz.embedded.resource_index.v0';
+/** Paths that must never enter the embedded baseline closure. */
+const SKIP_NAMES = new Set(['vmz-serve-host.mjs', 'vmz-serve-host.js', 'node_modules', '.git']);
+/**
+ * Walk outDir and build path → digest → relative blob path map.
+ * Copies files into `dist/_vmz/embedded-baseline/` (whole release, no file-level mix).
+ * @param {string} outDir
+ * @param {{ siteId?: string, contractDigest?: string | null }} [opts]
+ */
+export function emitEmbeddedPackaging(outDir, opts = {}) {
+    const vmzDir = path.join(outDir, '_vmz');
+    const baselineDir = path.join(vmzDir, 'embedded-baseline');
+    fs.mkdirSync(baselineDir, { recursive: true });
+    /** @type {Array<{ path: string, digest: string, blob: string, bytes: number }>} */
+    const objects = [];
+    const root = path.resolve(outDir);
+    walkFiles(root, (abs) => {
+        const rel = toPosix(path.relative(root, abs));
+        if (!rel || rel.startsWith('_vmz/embedded-baseline'))
+            return;
+        if (rel.startsWith('_vmz/embedded-resource-index'))
+            return;
+        const base = path.basename(abs);
+        if (SKIP_NAMES.has(base))
+            return;
+        // Keep other _vmz manifests inside baseline (contract, capability table, etc.)
+        const buf = fs.readFileSync(abs);
+        const digest = sha256Hex(buf);
+        const blobRel = `objects/${digest.slice(0, 2)}/${digest}`;
+        const blobAbs = path.join(baselineDir, blobRel);
+        fs.mkdirSync(path.dirname(blobAbs), { recursive: true });
+        if (!fs.existsSync(blobAbs))
+            fs.writeFileSync(blobAbs, buf);
+        // Also mirror tree under baseline/tree for host convenience
+        const treeAbs = path.join(baselineDir, 'tree', rel);
+        fs.mkdirSync(path.dirname(treeAbs), { recursive: true });
+        fs.copyFileSync(abs, treeAbs);
+        objects.push({ path: rel, digest, blob: blobRel, bytes: buf.length });
+    });
+    objects.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    const index = {
+        schema: EMBEDDED_RESOURCE_INDEX_SCHEMA,
+        siteId: opts.siteId || null,
+        contractDigest: opts.contractDigest || null,
+        objectCount: objects.length,
+        objects,
+    };
+    index.indexDigest = sha256Hex(canonicalJson({ ...index, indexDigest: undefined }));
+    const indexPath = path.join(vmzDir, 'embedded-resource-index.json');
+    writePrettyJsonFile(indexPath, index);
+    // Optional include_bytes entry point for Rust packaging adapters
+    const rsPath = path.join(vmzDir, 'embedded_site.rs');
+    fs.writeFileSync(rsPath, `// @generated by vmz — rust-embedded packaging adapter (do not edit)
+// Index digest: ${index.indexDigest}
+pub const EMBEDDED_RESOURCE_INDEX: &str = include_str!("embedded-resource-index.json");
+`, 'utf8');
+    return { index, indexPath, baselineDir };
+}
+/**
+ * @param {string} dir
+ * @param {(abs: string) => void} onFile
+ */
+function walkFiles(dir, onFile) {
+    if (!fs.existsSync(dir))
+        return;
+    for (const name of fs.readdirSync(dir)) {
+        if (SKIP_NAMES.has(name))
+            continue;
+        const abs = path.join(dir, name);
+        const st = fs.statSync(abs);
+        if (st.isDirectory()) {
+            if (name === 'embedded-baseline' && path.basename(path.dirname(abs)) === '_vmz')
+                continue;
+            walkFiles(abs, onFile);
+        }
+        else if (st.isFile()) {
+            onFile(abs);
+        }
+    }
+}
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+function sha256Hex(data) {
+    return crypto.createHash('sha256').update(data).digest('hex');
+}
+function canonicalJson(value) {
+    return JSON.stringify(sortKeys(value));
+}
+function sortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const k of Object.keys(value).sort())
+            out[k] = sortKeys(value[k]);
+        return out;
+    }
+    return value;
+}

package/dist/index.d.ts

@@ -79,6 +79,15 @@ export declare function queryApplicationProtocolCatalog(): any;
 export declare function checkApplicationsJson(hostRoot: any, packageRoots: any): any;
 export declare function queryTargetProtocolCatalog(): any;
 export declare function checkMiniprogramTargetContractJson(rootPath: any): any;
+export declare function lowerMiniprogramStaticSliceJson(rootPath: any): any;
+export declare function lowerMiniprogramBindingEventJson(rootPath: any): any;
+export declare function lowerMiniprogramStructureJson(rootPath: any): any;
+export declare function lowerMiniprogramRouteServerStyleJson(rootPath: any): any;
+export declare function lowerMiniprogramToolingDeployJson(rootPath: any): any;
+export declare function lowerMiniprogramWechatPackagingJson(rootPath: any): any;
+export declare function lowerMiniprogramMultiAdapterJson(rootPath: any): any;
+import { createMiniHost } from './mini-host.js';
+export { createMiniHost };
 export declare function queryProfileProtocolCatalog(): any;
 export declare function checkHostProfileProtocolJson(rootPath: any): any;
 export declare function checkProfileSolverJson(rootPath: any): any;
@@ -151,10 +160,18 @@ export { STATIC_DELIVERY_MANIFEST_SCHEMA, emitWebStatic, } from './static-emit.j
 export { CONTENT_ADDRESSED_ASSETS_SCHEMA, emitContentAddressedAssets, resolveAssetByDigest, assertSharedAssetPath, contentAddressedAssetsDigest, } from './content-addressed-assets.js';
 export { CDN_POLICY_MANIFEST_SCHEMA, CDN_ADAPTER_PROJECTION_SCHEMA, CACHE_HTML, CACHE_ASSET_IMMUTABLE, CACHE_META, buildCdnPolicyManifest, emitCdnPolicy, projectCdnAdapter, createLocalStaticHandler, listenLocalStaticHost, matchGlob, } from './cdn-policy.js';
 export { SITE_DELIVERY_CONTRACT_SCHEMA, SITE_DELIVERY_RESOLUTION_SCHEMA, defineSite, normalizeSiteDelivery, normalizeSourceProbe, resolveSiteRelease, probeReleaseDirectory, emitSiteDelivery, } from './site-delivery.js';
+export { EMBEDDED_RESOURCE_INDEX_SCHEMA, emitEmbeddedPackaging, } from './embedded-packaging.js';
+export { SERVER_LANG_IDS, SERVER_LANG_ALIASES, SERVER_LANGUAGE_BACKENDS, resolveServerLanguage, assertLangRuntimePair, } from './server-language-backend.js';
+export { WECHAT_PACKAGING_SCHEMA, WECHAT_PACKAGING_REL, wechatPackagingFromDelivery, materializeWechatPackaging, } from './wechat-packaging.js';
+export { DELIVERY_PROFILE_AUTHORING_SCHEMA, BUILD_PROFILE_SELECTION_SCHEMA, ASSEMBLIES, SERVER_RUNTIMES, BUILTIN_PROFILES, pickSiteAuthoring, pickDeliveryPackaging, normalizeDeliveryAuthoring, selectBuildProfile, semanticIdsForAssembly, } from './delivery-profile.js';
+export { PACK_MANIFEST_SCHEMA, packFromDeploymentIr, ensureRuntimeCompanions } from './pack.js';
+export { SERVER_ARTIFACT_SCHEMA, HTTP_CONTRACT_SCHEMA, SERVER_RUNTIME_ADAPTER_SCHEMA, emitServerArtifact, projectServerRuntimeAdapter, } from './server-artifact.js';
+export { BUILD_PROOF_SCHEMA, ASSEMBLE_MANIFEST_SCHEMA, assembleDelivery, emitBuildProof, } from './build-assemble.js';
 export { PRODUCTION_SCENARIO_PACK_SCHEMA, PRODUCTION_CI_PROFILE_SCHEMA, PRODUCTION_TEST_REPORT_SCHEMA, browserProductionScenarioPack, browserProductionCiProfile, normalizeScenarioPack, normalizeCiProfile, scenarioPackDigest, ciProfileDigest, buildProductionTestReport, productionTestReportDigest, emitProductionTestArtifacts, assertNoForbiddenRunners, } from './production-test-pack.js';
 export { PRODUCTION_OBSERVABILITY_SCHEMA, PRODUCTION_TRACE_SCHEMA, REQUIRED_TRACE_FACETS, browserProductionObservability, normalizeObservability, redactSensitive, validateProductionTrace, buildCoveringProductionTrace, checkProductionBudgets, checkCapabilityClosure, applySecurityHeadersToCdnPolicy, measureDistBudgets, emitProductionObservability, observabilityDigest, } from './production-observability.js';
 export { buildApplicationContext, buildFormatterContext, checkLocaleRuntime, checkSsrClientParity, createLocaleSession, formatMessageTemplate, formatterContextDigest, negotiateLocale, resolveMessageVariant, validateFormatterContext, } from './locale-runtime.js';
-export { absoluteUrl, assertLocaleCacheKey, buildLocalePageMeta, buildLocaleRouteRealizationTable, checkLocaleRouter, commitLocaleRouteMetaTransition, localeAwareCacheKey, parseLocaleFromPath, planLocalePathNavigation, realizeRoutePath, resolveLinkHref, } from './locale-router.js';
+export { absoluteUrl, assertLocaleCacheKey, buildLocalePageMeta, buildLocaleRouteRealizationTable, checkLocaleRouter, commitLocaleRouteMetaTransition, localeAwareCacheKey, localizeBodyLinks, localizeSameAppHref, parseLocaleFromPath, planLocalePathNavigation, realizeRoutePath, resolveLinkHref, } from './locale-router.js';
+export { LOCALE_ROUTE_REALIZATION_ARTIFACT_SCHEMA, emitLocaleRouteRealization, } from './locale-route-emit.js';
 export { assertHostMessageInvariant, assertServerErrorEnvelope, assertServerFormatContext, buildLocaleDeliveryResolution, checkLocaleDelivery, fallbackDigest, messageCatalogHash, proveMiniPackageMessages, validateNativeLocalePack, } from './locale-delivery.js';
 export { checkLocaleConformance, diffLocaleCatalogs, explainLocaleMessage, extractHardcodedText, pseudoLocalizeCatalog, } from './locale-tooling.js';
 export { applyPlugins, contentHash, defineConfig, definePlugin, loadVmzConfig, } from './plugin-host.js';
@@ -224,6 +241,14 @@ declare const _default: {
     checkApplicationsJson: typeof checkApplicationsJson;
     queryTargetProtocolCatalog: typeof queryTargetProtocolCatalog;
     checkMiniprogramTargetContractJson: typeof checkMiniprogramTargetContractJson;
+    lowerMiniprogramStaticSliceJson: typeof lowerMiniprogramStaticSliceJson;
+    lowerMiniprogramBindingEventJson: typeof lowerMiniprogramBindingEventJson;
+    lowerMiniprogramStructureJson: typeof lowerMiniprogramStructureJson;
+    lowerMiniprogramRouteServerStyleJson: typeof lowerMiniprogramRouteServerStyleJson;
+    lowerMiniprogramToolingDeployJson: typeof lowerMiniprogramToolingDeployJson;
+    lowerMiniprogramWechatPackagingJson: typeof lowerMiniprogramWechatPackagingJson;
+    lowerMiniprogramMultiAdapterJson: typeof lowerMiniprogramMultiAdapterJson;
+    createMiniHost: typeof createMiniHost;
     queryProfileProtocolCatalog: typeof queryProfileProtocolCatalog;
     checkHostProfileProtocolJson: typeof checkHostProfileProtocolJson;
     checkProfileSolverJson: typeof checkProfileSolverJson;

package/dist/index.js

@@ -7,6 +7,7 @@ import { createRequire } from 'node:module';
 import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { materializeWechatPackaging } from './wechat-packaging.js';
 export { HOST_PROTOCOL, COMPILER_PROTOCOL, PROGRAM_IR_SCHEMA, PLAN_SCHEMA, PLUGIN_PROTOCOL, DX_PROTOCOL, DX_SYMBOL_SCHEMA, DX_REFERENCE_SCHEMA, DX_EXPLAIN_SCHEMA, DX_WORKSPACE_EDIT_SCHEMA, DX_CODE_ACTION_SCHEMA, DX_AFFECTED_SCHEMA, DX_RENAME_SCHEMA, DX_TEST_SELECTION_SCHEMA, DX_SOURCE_MAP_SCHEMA, DX_SYMBOL_INDEX_SCHEMA, DX_CROSS_SFC_CHECK_SCHEMA, DX_SEMANTIC_TRANSACTION_SCHEMA, DX_CANCEL_SCHEMA, DX_AFFECTED_PREVIEW_SCHEMA, DX_HMR_PLAN_SCHEMA, DX_BUDGET_SCHEMA, DX_TRANSACTION_CHECK_SCHEMA, DX_BOUNDARY_VALIDATOR_SCHEMA, DX_LEAKAGE_SCHEMA, DX_CAPABILITY_TARGET_SCHEMA, DX_DEAD_GRAPH_SCHEMA, DX_DEPLOYMENT_PROOF_CHECK_SCHEMA, DX_TRACE_SCHEMA, DX_CAUSAL_REPLAY_SCHEMA, DX_CAUSAL_REPLAY_CHECK_SCHEMA, APPLICATION_PROTOCOL, APPLICATION_DESCRIPTOR_SCHEMA, APPLICATIONS_CONFIG_SCHEMA, APPLICATION_CATALOG_SCHEMA, APPLICATION_CHECK_SCHEMA, APPLICATION_BASE_SCHEMA, APPLICATION_RELOCATION_SCHEMA, APPLICATION_RELOCATED_SCHEMA, APPLICATION_RELOCATABLE_CHECK_SCHEMA, APPLICATION_ARTIFACT_SCHEMA, APPLICATION_MOUNT_TABLE_SCHEMA, APPLICATION_ARTIFACT_BOUNDARY_SCHEMA, APPLICATION_ISOLATION_SCHEMA, APPLICATION_ISOLATION_CHECK_SCHEMA, APPLICATION_CROSS_LINK_SCHEMA, APPLICATION_HOST_COMPOSITION_SCHEMA, APPLICATION_DEV_SESSIONS_SCHEMA, APPLICATION_AFFECTED_SCHEMA, APPLICATION_PROXY_DISPATCH_SCHEMA, APPLICATION_MOUNTED_TEST_SCHEMA, APPLICATION_DEPLOY_ADAPTER_SCHEMA, APPLICATION_DEV_CHECK_SCHEMA, PROTOCOL_CATALOG_SCHEMA, TEST_PROTOCOL, TEST_MANIFEST_SCHEMA, TEST_REPORT_SCHEMA, protocolCatalog, dxCatalog, testCatalog, applicationCatalog, TARGET_PROTOCOL, TARGET_VIEW_OPS_SCHEMA, TARGET_PLATFORM_PROFILE_SCHEMA, TARGET_MINI_PROGRAM_ARTIFACT_SCHEMA, TARGET_CHECK_SCHEMA, TARGET_DIAG_DOM_LEAK_IN_PLAN, targetCatalog, PROFILE_PROTOCOL, PROFILE_HOST_SCHEMA, PROFILE_DELIVERY_SCHEMA, PROFILE_CHECK_SCHEMA, PROFILE_DIAG_HOST_PROFILE_INVALID, PROFILE_DIAG_RESOLUTION_DIGEST_MISMATCH, PROFILE_DIAG_CORE_ID_OVERRIDE, PROFILE_DIAG_HOST_PROFILE_REF_UNRESOLVED, PROFILE_SURFACE_KINDS, PROFILE_UNIFIED_LIFECYCLE_EVENTS, PROFILE_CORE_ID_PREFIX, PROFILE_SOLVER_CHECK_SCHEMA, PROFILE_HOST_RESOLUTION_MANIFEST_SCHEMA, PROFILE_EXECUTOR_CHECK_SCHEMA, PROFILE_EXECUTOR_SCENARIO_SCHEMA, PROFILE_DIAG_SURFACE_NO_MATCH, PROFILE_DIAG_SURFACE_AMBIGUOUS, PROFILE_DIAG_CAPABILITY_UNRESOLVED, PROFILE_DIAG_CAPABILITY_PERMISSION_UNDECLARED, PROFILE_DIAG_ROUTE_UNREALIZABLE, PROFILE_DIAG_STALE_GENERATION, PROFILE_DIAG_MISSING_ENVELOPE_IDS, PROFILE_DIAG_SURFACE_OWNS_STATE, PROFILE_DIAG_PRIVATE_OBJECT_CROSSING, PROFILE_DIAG_SPLIT_TRANSACTION, PROFILE_DIAG_DISPOSE_NOT_AUTHORITATIVE, PROFILE_DIAG_CANCEL_NOT_PROPAGATED, PROFILE_LIFECYCLE_MAPPING_ENTRY_SCHEMA, PROFILE_LIFECYCLE_MAPPING_TABLE_SCHEMA, PROFILE_RECOVERY_POLICY_SCHEMA, PROFILE_LIFECYCLE_SCENARIO_SCHEMA, PROFILE_LIFECYCLE_RECOVERY_CHECK_SCHEMA, PROFILE_LIFECYCLE_HOST_KINDS, PROFILE_PERSISTENCE_WINDOWS, PROFILE_DIAG_LIFECYCLE_UNPROVEN, PROFILE_DIAG_LIFECYCLE_MAPPING_INCOMPLETE, PROFILE_DIAG_RECOVERY_DUPLICATES_OWNER, PROFILE_DIAG_RECOVERY_ASSUMES_HEAP, PROFILE_DIAG_PERSISTENCE_WINDOW_INVALID, PROFILE_DELIVERY_PACKAGE_CONSTRAINTS_SCHEMA, PROFILE_DELIVERY_SECURITY_POLICY_SCHEMA, PROFILE_DELIVERY_UPDATE_POLICY_SCHEMA, PROFILE_DELIVERY_ARTIFACT_MANIFEST_SCHEMA, PROFILE_DELIVERY_PROOF_MANIFEST_SCHEMA, PROFILE_DELIVERY_PROOF_SCENARIO_SCHEMA, PROFILE_DELIVERY_PROOF_CHECK_SCHEMA, PROFILE_DELIVERY_UPDATE_CHANNELS, PROFILE_DELIVERY_ASSET_STRATEGIES, PROFILE_DIAG_DELIVERY_CONSTRAINT_EXCEEDED, PROFILE_DIAG_HOST_PLAN_VERSION_MISMATCH, PROFILE_DIAG_PROOF_MANIFEST_INCOMPLETE, PROFILE_DIAG_PROOF_COPIES_SEMANTIC_IR, PROFILE_DIAG_UPDATE_WITHOUT_REPROOF, PROFILE_DIAG_SECURITY_POLICY_INSECURE, PROFILE_CONFORMANCE_FIXTURE_SCHEMA, PROFILE_CONFORMANCE_STATE_SNAPSHOT_SCHEMA, PROFILE_CONFORMANCE_TRACE_SCHEMA, PROFILE_CONFORMANCE_HOST_RUN_SCHEMA, PROFILE_CONFORMANCE_SCENARIO_SCHEMA, PROFILE_CONFORMANCE_CHECK_SCHEMA, PROFILE_CONFORMANCE_SURFACE_ROLES, PROFILE_DIAG_STABLE_ID_DIVERGENCE, PROFILE_DIAG_STATE_RESULT_DIVERGENCE, PROFILE_DIAG_TRACE_INVARIANT_BROKEN, PROFILE_DIAG_CONFORMANCE_HOST_INCOMPLETE, PROFILE_DIAG_CONFORMANCE_SURFACE_ROLE_MISMATCH, profileCatalog, NATIVE_HOST_PROTOCOL, NATIVE_HOST_WEBVIEW_DEPLOYMENT_SCHEMA, NATIVE_HOST_CAPABILITY_SCHEMA, NATIVE_HOST_BRIDGE_SCHEMA, NATIVE_HOST_APPLICATION_IDENTITY_SCHEMA, NATIVE_HOST_CHECK_SCHEMA, NATIVE_HOST_DIAG_ARBITRARY_BRIDGE, NATIVE_HOST_SHELL_SCHEMA, NATIVE_HOST_SHELL_CHECK_SCHEMA, NATIVE_HOST_DEEP_LINK_SCHEMA, NATIVE_HOST_LOCAL_BUNDLE_SCHEMA, NATIVE_HOST_DIAG_MISSING_SHELL_HOOK, NATIVE_HOST_DIAG_PLATFORM_SEMANTIC_FORK, NATIVE_HOST_DIAG_REMOTE_ENTRY_DEFAULT, NATIVE_HOST_DIAG_MISSING_ENTRY_ARTIFACT, NATIVE_HOST_REQUIRED_SHELL_HOOKS, NATIVE_HOST_CAPABILITY_CALL_SCHEMA, NATIVE_HOST_BRIDGE_TRACE_SCHEMA, NATIVE_HOST_BRIDGE_STUB_CATALOG_SCHEMA, NATIVE_HOST_BRIDGE_CHECK_SCHEMA, NATIVE_HOST_DIAG_MISSING_NONCE, NATIVE_HOST_DIAG_CALL_NOT_ALLOWLISTED, NATIVE_HOST_FIRST_BATCH_STUB_IDS, NATIVE_HOST_LIFECYCLE_SCHEMA, NATIVE_HOST_LIFECYCLE_CHECK_SCHEMA, NATIVE_HOST_DIAG_BACKGROUND_IS_DESTROY, NATIVE_HOST_DIAG_CRASH_ASSUMES_JS_HEAP, NATIVE_HOST_DIAG_MISSING_LIFECYCLE_EVENT, NATIVE_HOST_REQUIRED_LIFECYCLE_EVENTS, NATIVE_HOST_FULLSTACK_SCHEMA, NATIVE_HOST_FULLSTACK_CHECK_SCHEMA, NATIVE_HOST_DIAG_BRIDGE_BYPASSES_SERVER, NATIVE_HOST_DIAG_REMOTE_WITHOUT_INTEGRITY, NATIVE_HOST_DIAG_MISSING_SERVER_TRANSPORT, NATIVE_HOST_NATIVE_SURFACE_SCHEMA, NATIVE_HOST_NATIVE_SURFACE_CHECK_SCHEMA, NATIVE_HOST_DIAG_SURFACE_IS_CAPABILITY, NATIVE_HOST_DIAG_IMPLICIT_STATE_SHARE, NATIVE_HOST_HIGH_VALUE_SURFACE_KINDS, NATIVE_HOST_MULTI_PLATFORM_SCHEMA, NATIVE_HOST_MULTI_PLATFORM_SHARED_SCHEMA, NATIVE_HOST_MULTI_PLATFORM_CHECK_SCHEMA, NATIVE_HOST_DIAG_MISSING_PLATFORM_ADAPTER, NATIVE_HOST_DIAG_PLATFORM_PRIVATE_SCHEMA, NATIVE_HOST_DIAG_ADAPTER_IS_SEMANTIC_CORE, NATIVE_HOST_REQUIRED_MULTI_PLATFORMS, NATIVE_HOST_MULTI_PLATFORM_ADAPTER_KIND, nativeHostCatalog, LOCALE_PROTOCOL, LOCALE_MANIFEST_SCHEMA, LOCALE_MESSAGE_CATALOG_SCHEMA, LOCALE_MESSAGE_NODE_SCHEMA, LOCALE_CHECK_SCHEMA, LOCALE_TYPED_MODULE_SCHEMA, LOCALE_RENAME_SCHEMA, LOCALE_APPLICATION_CONTEXT_SCHEMA, LOCALE_FORMATTER_CONTEXT_SCHEMA, LOCALE_TRANSITION_SCHEMA, LOCALE_RUNTIME_CHECK_SCHEMA, LOCALE_FALLBACK_RESOLUTION_SCHEMA, FORMATTER_DATA_VERSION, LOCALE_ROUTE_REALIZATION_SCHEMA, LOCALE_PAGE_META_SCHEMA, LOCALE_LINK_RESOLUTION_SCHEMA, LOCALE_ROUTER_CHECK_SCHEMA, LOCALE_DELIVERY_RESOLUTION_SCHEMA, LOCALE_CHUNK_MANIFEST_SCHEMA, LOCALE_NATIVE_PACK_SCHEMA, LOCALE_MINI_PACKAGE_PROOF_SCHEMA, LOCALE_SERVER_ERROR_ENVELOPE_SCHEMA, LOCALE_DELIVERY_CHECK_SCHEMA, LOCALE_EXPLAIN_SCHEMA, LOCALE_DIFF_SCHEMA, LOCALE_EXTRACT_SCHEMA, LOCALE_PSEUDO_SCHEMA, LOCALE_CONFORMANCE_SCHEMA, LOCALE_DIAG_MANIFEST_MISSING, LOCALE_DIAG_ID_INVALID, LOCALE_DIAG_FALLBACK_CYCLE, LOCALE_DIAG_MESSAGE_PARAMETER_MISMATCH, LOCALE_DIAG_MESSAGE_UNUSED, LOCALE_DIAG_FORMATTER_CONTEXT_INCOMPLETE, LOCALE_DIAG_FORMATTER_VERSION_MISMATCH, LOCALE_DIAG_DIGEST_MISMATCH, LOCALE_DIAG_TRANSITION_PARTIAL, LOCALE_DIAG_TRANSITION_UNSUPPORTED, LOCALE_DIAG_TRANSITION_LOAD_FAILED, LOCALE_DIAG_MACHINE_DEFAULT_FORBIDDEN, LOCALE_DIAG_MESSAGE_MIXED_LOCALE, LOCALE_DIAG_STALE_GENERATION, LOCALE_DIAG_ROUTE_COLLISION, LOCALE_DIAG_CANONICAL_MISSING, LOCALE_DIAG_HREFLANG_INCOMPLETE, LOCALE_DIAG_META_LOCALE_MISMATCH, LOCALE_DIAG_LINK_HARDCODED_PATH, LOCALE_DIAG_CACHE_KEY_STEALS_CONTENT, LOCALE_DIAG_PREFIX_OMIT_WITHOUT_REDIRECT, LOCALE_DIAG_DELIVERY_FULL_BUNDLE, LOCALE_DIAG_CHUNK_HASH_MISMATCH, LOCALE_DIAG_NATIVE_PACK_UNSIGNED, LOCALE_DIAG_NATIVE_PACK_HAS_JS, LOCALE_DIAG_NATIVE_PACK_APP_MISMATCH, LOCALE_DIAG_MINI_CROSS_PACKAGE_UNPROVEN, LOCALE_DIAG_SERVER_TRANSLATED_ERROR, LOCALE_DIAG_SERVER_FORMAT_WITHOUT_CONTEXT, LOCALE_DIAG_HOST_MESSAGE_DIVERGENCE, LOCALE_DIAG_MESSAGE_DYNAMIC_ID_UNBOUNDED, LOCALE_DIAG_HARDCODED_TEXT, LOCALE_DIAG_PSEUDO_PRODUCTION_FORBIDDEN, LOCALE_DIAG_CONFORMANCE_DIVERGENCE, LOCALE_DIAG_EXPLAIN_UNKNOWN, LOCALE_VIRTUAL_MODULE_PREFIX, localeCatalog, } from '@vmz/protocol';
 import { HOST_PROTOCOL, COMPILER_PROTOCOL, PROGRAM_IR_SCHEMA, PLUGIN_PROTOCOL, DX_PROTOCOL, DX_SYMBOL_SCHEMA, DX_REFERENCE_SCHEMA, DX_EXPLAIN_SCHEMA, DX_WORKSPACE_EDIT_SCHEMA, DX_CODE_ACTION_SCHEMA, DX_AFFECTED_SCHEMA, DX_RENAME_SCHEMA, DX_TEST_SELECTION_SCHEMA, DX_SOURCE_MAP_SCHEMA, DX_SYMBOL_INDEX_SCHEMA, DX_CROSS_SFC_CHECK_SCHEMA, DX_SEMANTIC_TRANSACTION_SCHEMA, DX_CANCEL_SCHEMA, DX_AFFECTED_PREVIEW_SCHEMA, DX_HMR_PLAN_SCHEMA, DX_BUDGET_SCHEMA, DX_TRANSACTION_CHECK_SCHEMA, DX_BOUNDARY_VALIDATOR_SCHEMA, DX_LEAKAGE_SCHEMA, DX_CAPABILITY_TARGET_SCHEMA, DX_DEAD_GRAPH_SCHEMA, DX_DEPLOYMENT_PROOF_CHECK_SCHEMA, DX_TRACE_SCHEMA, DX_CAUSAL_REPLAY_SCHEMA, DX_CAUSAL_REPLAY_CHECK_SCHEMA, APPLICATION_PROTOCOL, APPLICATION_DESCRIPTOR_SCHEMA, APPLICATIONS_CONFIG_SCHEMA, APPLICATION_CATALOG_SCHEMA, APPLICATION_CHECK_SCHEMA, APPLICATION_BASE_SCHEMA, APPLICATION_RELOCATION_SCHEMA, APPLICATION_RELOCATED_SCHEMA, APPLICATION_RELOCATABLE_CHECK_SCHEMA, APPLICATION_ARTIFACT_SCHEMA, APPLICATION_MOUNT_TABLE_SCHEMA, APPLICATION_ARTIFACT_BOUNDARY_SCHEMA, APPLICATION_ISOLATION_SCHEMA, APPLICATION_ISOLATION_CHECK_SCHEMA, APPLICATION_CROSS_LINK_SCHEMA, APPLICATION_HOST_COMPOSITION_SCHEMA, APPLICATION_DEV_SESSIONS_SCHEMA, APPLICATION_AFFECTED_SCHEMA, APPLICATION_PROXY_DISPATCH_SCHEMA, APPLICATION_MOUNTED_TEST_SCHEMA, APPLICATION_DEPLOY_ADAPTER_SCHEMA, APPLICATION_DEV_CHECK_SCHEMA, PROTOCOL_CATALOG_SCHEMA, TARGET_PROTOCOL, TARGET_VIEW_OPS_SCHEMA, TARGET_PLATFORM_PROFILE_SCHEMA, TARGET_MINI_PROGRAM_ARTIFACT_SCHEMA, TARGET_CHECK_SCHEMA, targetCatalog, PROFILE_PROTOCOL, PROFILE_HOST_SCHEMA, PROFILE_DELIVERY_SCHEMA, PROFILE_CHECK_SCHEMA, PROFILE_DIAG_HOST_PROFILE_INVALID, PROFILE_DIAG_RESOLUTION_DIGEST_MISMATCH, PROFILE_DIAG_CORE_ID_OVERRIDE, PROFILE_DIAG_HOST_PROFILE_REF_UNRESOLVED, PROFILE_SURFACE_KINDS, PROFILE_UNIFIED_LIFECYCLE_EVENTS, PROFILE_CORE_ID_PREFIX, PROFILE_SOLVER_CHECK_SCHEMA, PROFILE_HOST_RESOLUTION_MANIFEST_SCHEMA, PROFILE_EXECUTOR_CHECK_SCHEMA, PROFILE_EXECUTOR_SCENARIO_SCHEMA, PROFILE_DIAG_SURFACE_NO_MATCH, PROFILE_DIAG_SURFACE_AMBIGUOUS, PROFILE_DIAG_CAPABILITY_UNRESOLVED, PROFILE_DIAG_CAPABILITY_PERMISSION_UNDECLARED, PROFILE_DIAG_ROUTE_UNREALIZABLE, PROFILE_DIAG_STALE_GENERATION, PROFILE_DIAG_MISSING_ENVELOPE_IDS, PROFILE_DIAG_SURFACE_OWNS_STATE, PROFILE_DIAG_PRIVATE_OBJECT_CROSSING, PROFILE_DIAG_SPLIT_TRANSACTION, PROFILE_DIAG_DISPOSE_NOT_AUTHORITATIVE, PROFILE_DIAG_CANCEL_NOT_PROPAGATED, PROFILE_LIFECYCLE_SCENARIO_SCHEMA, PROFILE_LIFECYCLE_RECOVERY_CHECK_SCHEMA, PROFILE_LIFECYCLE_HOST_KINDS, PROFILE_PERSISTENCE_WINDOWS, PROFILE_DIAG_LIFECYCLE_UNPROVEN, PROFILE_DIAG_LIFECYCLE_MAPPING_INCOMPLETE, PROFILE_DIAG_RECOVERY_DUPLICATES_OWNER, PROFILE_DIAG_RECOVERY_ASSUMES_HEAP, PROFILE_DIAG_PERSISTENCE_WINDOW_INVALID, PROFILE_DELIVERY_PACKAGE_CONSTRAINTS_SCHEMA, PROFILE_DELIVERY_SECURITY_POLICY_SCHEMA, PROFILE_DELIVERY_UPDATE_POLICY_SCHEMA, PROFILE_DELIVERY_ARTIFACT_MANIFEST_SCHEMA, PROFILE_DELIVERY_PROOF_MANIFEST_SCHEMA, PROFILE_DELIVERY_PROOF_SCENARIO_SCHEMA, PROFILE_DELIVERY_PROOF_CHECK_SCHEMA, PROFILE_DELIVERY_UPDATE_CHANNELS, PROFILE_DELIVERY_ASSET_STRATEGIES, PROFILE_DIAG_DELIVERY_CONSTRAINT_EXCEEDED, PROFILE_DIAG_HOST_PLAN_VERSION_MISMATCH, PROFILE_DIAG_PROOF_MANIFEST_INCOMPLETE, PROFILE_DIAG_PROOF_COPIES_SEMANTIC_IR, PROFILE_DIAG_UPDATE_WITHOUT_REPROOF, PROFILE_DIAG_SECURITY_POLICY_INSECURE, PROFILE_CONFORMANCE_FIXTURE_SCHEMA, PROFILE_CONFORMANCE_STATE_SNAPSHOT_SCHEMA, PROFILE_CONFORMANCE_TRACE_SCHEMA, PROFILE_CONFORMANCE_HOST_RUN_SCHEMA, PROFILE_CONFORMANCE_SCENARIO_SCHEMA, PROFILE_CONFORMANCE_CHECK_SCHEMA, PROFILE_CONFORMANCE_SURFACE_ROLES, PROFILE_DIAG_STABLE_ID_DIVERGENCE, PROFILE_DIAG_STATE_RESULT_DIVERGENCE, PROFILE_DIAG_TRACE_INVARIANT_BROKEN, PROFILE_DIAG_CONFORMANCE_HOST_INCOMPLETE, PROFILE_DIAG_CONFORMANCE_SURFACE_ROLE_MISMATCH, profileCatalog, NATIVE_HOST_PROTOCOL, NATIVE_HOST_WEBVIEW_DEPLOYMENT_SCHEMA, NATIVE_HOST_CAPABILITY_SCHEMA, NATIVE_HOST_BRIDGE_SCHEMA, NATIVE_HOST_APPLICATION_IDENTITY_SCHEMA, NATIVE_HOST_CHECK_SCHEMA, NATIVE_HOST_DIAG_ARBITRARY_BRIDGE, NATIVE_HOST_SHELL_SCHEMA, NATIVE_HOST_SHELL_CHECK_SCHEMA, NATIVE_HOST_DEEP_LINK_SCHEMA, NATIVE_HOST_LOCAL_BUNDLE_SCHEMA, NATIVE_HOST_DIAG_MISSING_SHELL_HOOK, NATIVE_HOST_DIAG_PLATFORM_SEMANTIC_FORK, NATIVE_HOST_DIAG_REMOTE_ENTRY_DEFAULT, NATIVE_HOST_DIAG_MISSING_ENTRY_ARTIFACT, NATIVE_HOST_REQUIRED_SHELL_HOOKS, NATIVE_HOST_CAPABILITY_CALL_SCHEMA, NATIVE_HOST_BRIDGE_TRACE_SCHEMA, NATIVE_HOST_BRIDGE_STUB_CATALOG_SCHEMA, NATIVE_HOST_BRIDGE_CHECK_SCHEMA, NATIVE_HOST_DIAG_MISSING_NONCE, NATIVE_HOST_DIAG_CALL_NOT_ALLOWLISTED, NATIVE_HOST_FIRST_BATCH_STUB_IDS, NATIVE_HOST_LIFECYCLE_SCHEMA, NATIVE_HOST_LIFECYCLE_CHECK_SCHEMA, NATIVE_HOST_DIAG_BACKGROUND_IS_DESTROY, NATIVE_HOST_DIAG_CRASH_ASSUMES_JS_HEAP, NATIVE_HOST_DIAG_MISSING_LIFECYCLE_EVENT, NATIVE_HOST_REQUIRED_LIFECYCLE_EVENTS, NATIVE_HOST_FULLSTACK_SCHEMA, NATIVE_HOST_FULLSTACK_CHECK_SCHEMA, NATIVE_HOST_DIAG_BRIDGE_BYPASSES_SERVER, NATIVE_HOST_DIAG_REMOTE_WITHOUT_INTEGRITY, NATIVE_HOST_DIAG_MISSING_SERVER_TRANSPORT, NATIVE_HOST_NATIVE_SURFACE_SCHEMA, NATIVE_HOST_NATIVE_SURFACE_CHECK_SCHEMA, NATIVE_HOST_DIAG_SURFACE_IS_CAPABILITY, NATIVE_HOST_DIAG_IMPLICIT_STATE_SHARE, NATIVE_HOST_HIGH_VALUE_SURFACE_KINDS, NATIVE_HOST_MULTI_PLATFORM_SCHEMA, NATIVE_HOST_MULTI_PLATFORM_SHARED_SCHEMA, NATIVE_HOST_MULTI_PLATFORM_CHECK_SCHEMA, NATIVE_HOST_DIAG_MISSING_PLATFORM_ADAPTER, NATIVE_HOST_DIAG_PLATFORM_PRIVATE_SCHEMA, NATIVE_HOST_DIAG_ADAPTER_IS_SEMANTIC_CORE, NATIVE_HOST_REQUIRED_MULTI_PLATFORMS, NATIVE_HOST_MULTI_PLATFORM_ADAPTER_KIND, nativeHostCatalog, localeCatalog, } from '@vmz/protocol';
 const require = createRequire(import.meta.url);
@@ -158,7 +159,7 @@ export function createWorkspace(options) {
     const native = loadNative();
     const protocol = options.protocol ?? expectedProtocol();
     const runtimeDist = options.runtimeDist ?? resolveCoreRuntimeDist() ?? undefined;
-    return native.JsWorkspace.create({
+    const ws = native.JsWorkspace.create({
         root: options.root,
         outDir: options.outDir,
         runtimeDist,
@@ -169,6 +170,25 @@ export function createWorkspace(options) {
             pluginProtocol: protocol.pluginProtocol,
         },
     });
+    const pack = ws.lowerMiniprogramWechatPackaging.bind(ws);
+    const wrappedPack = () => {
+        materializeWechatPackaging(options.root);
+        return pack();
+    };
+    try {
+        ws.lowerMiniprogramWechatPackaging = wrappedPack;
+        return ws;
+    }
+    catch {
+        return new Proxy(ws, {
+            get(target, prop, receiver) {
+                if (prop === 'lowerMiniprogramWechatPackaging')
+                    return wrappedPack;
+                const value = Reflect.get(target, prop, receiver);
+                return typeof value === 'function' ? value.bind(target) : value;
+            },
+        });
+    }
 }
 /**
  * frozen application composition protocol catalog.
@@ -196,6 +216,37 @@ export function checkMiniprogramTargetContractJson(rootPath) {
     const native = loadNative();
     return native.checkMiniprogramTargetContractJson(rootPath);
 }
+export function lowerMiniprogramStaticSliceJson(rootPath) {
+    const native = loadNative();
+    return native.lowerMiniprogramStaticSliceJson(rootPath);
+}
+export function lowerMiniprogramBindingEventJson(rootPath) {
+    const native = loadNative();
+    return native.lowerMiniprogramBindingEventJson(rootPath);
+}
+export function lowerMiniprogramStructureJson(rootPath) {
+    const native = loadNative();
+    return native.lowerMiniprogramStructureJson(rootPath);
+}
+export function lowerMiniprogramRouteServerStyleJson(rootPath) {
+    const native = loadNative();
+    return native.lowerMiniprogramRouteServerStyleJson(rootPath);
+}
+export function lowerMiniprogramToolingDeployJson(rootPath) {
+    const native = loadNative();
+    return native.lowerMiniprogramToolingDeployJson(rootPath);
+}
+export function lowerMiniprogramWechatPackagingJson(rootPath) {
+    const native = loadNative();
+    materializeWechatPackaging(rootPath);
+    return native.lowerMiniprogramWechatPackagingJson(rootPath);
+}
+export function lowerMiniprogramMultiAdapterJson(rootPath) {
+    const native = loadNative();
+    return native.lowerMiniprogramMultiAdapterJson(rootPath);
+}
+import { createMiniHost } from './mini-host.js';
+export { createMiniHost };
 export function queryProfileProtocolCatalog() {
     const native = loadNative();
     return native.queryProfileProtocolCatalog();
@@ -333,10 +384,18 @@ export { STATIC_DELIVERY_MANIFEST_SCHEMA, emitWebStatic, } from './static-emit.j
 export { CONTENT_ADDRESSED_ASSETS_SCHEMA, emitContentAddressedAssets, resolveAssetByDigest, assertSharedAssetPath, contentAddressedAssetsDigest, } from './content-addressed-assets.js';
 export { CDN_POLICY_MANIFEST_SCHEMA, CDN_ADAPTER_PROJECTION_SCHEMA, CACHE_HTML, CACHE_ASSET_IMMUTABLE, CACHE_META, buildCdnPolicyManifest, emitCdnPolicy, projectCdnAdapter, createLocalStaticHandler, listenLocalStaticHost, matchGlob, } from './cdn-policy.js';
 export { SITE_DELIVERY_CONTRACT_SCHEMA, SITE_DELIVERY_RESOLUTION_SCHEMA, defineSite, normalizeSiteDelivery, normalizeSourceProbe, resolveSiteRelease, probeReleaseDirectory, emitSiteDelivery, } from './site-delivery.js';
+export { EMBEDDED_RESOURCE_INDEX_SCHEMA, emitEmbeddedPackaging, } from './embedded-packaging.js';
+export { SERVER_LANG_IDS, SERVER_LANG_ALIASES, SERVER_LANGUAGE_BACKENDS, resolveServerLanguage, assertLangRuntimePair, } from './server-language-backend.js';
+export { WECHAT_PACKAGING_SCHEMA, WECHAT_PACKAGING_REL, wechatPackagingFromDelivery, materializeWechatPackaging, } from './wechat-packaging.js';
+export { DELIVERY_PROFILE_AUTHORING_SCHEMA, BUILD_PROFILE_SELECTION_SCHEMA, ASSEMBLIES, SERVER_RUNTIMES, BUILTIN_PROFILES, pickSiteAuthoring, pickDeliveryPackaging, normalizeDeliveryAuthoring, selectBuildProfile, semanticIdsForAssembly, } from './delivery-profile.js';
+export { PACK_MANIFEST_SCHEMA, packFromDeploymentIr, ensureRuntimeCompanions } from './pack.js';
+export { SERVER_ARTIFACT_SCHEMA, HTTP_CONTRACT_SCHEMA, SERVER_RUNTIME_ADAPTER_SCHEMA, emitServerArtifact, projectServerRuntimeAdapter, } from './server-artifact.js';
+export { BUILD_PROOF_SCHEMA, ASSEMBLE_MANIFEST_SCHEMA, assembleDelivery, emitBuildProof, } from './build-assemble.js';
 export { PRODUCTION_SCENARIO_PACK_SCHEMA, PRODUCTION_CI_PROFILE_SCHEMA, PRODUCTION_TEST_REPORT_SCHEMA, browserProductionScenarioPack, browserProductionCiProfile, normalizeScenarioPack, normalizeCiProfile, scenarioPackDigest, ciProfileDigest, buildProductionTestReport, productionTestReportDigest, emitProductionTestArtifacts, assertNoForbiddenRunners, } from './production-test-pack.js';
 export { PRODUCTION_OBSERVABILITY_SCHEMA, PRODUCTION_TRACE_SCHEMA, REQUIRED_TRACE_FACETS, browserProductionObservability, normalizeObservability, redactSensitive, validateProductionTrace, buildCoveringProductionTrace, checkProductionBudgets, checkCapabilityClosure, applySecurityHeadersToCdnPolicy, measureDistBudgets, emitProductionObservability, observabilityDigest, } from './production-observability.js';
 export { buildApplicationContext, buildFormatterContext, checkLocaleRuntime, checkSsrClientParity, createLocaleSession, formatMessageTemplate, formatterContextDigest, negotiateLocale, resolveMessageVariant, validateFormatterContext, } from './locale-runtime.js';
-export { absoluteUrl, assertLocaleCacheKey, buildLocalePageMeta, buildLocaleRouteRealizationTable, checkLocaleRouter, commitLocaleRouteMetaTransition, localeAwareCacheKey, parseLocaleFromPath, planLocalePathNavigation, realizeRoutePath, resolveLinkHref, } from './locale-router.js';
+export { absoluteUrl, assertLocaleCacheKey, buildLocalePageMeta, buildLocaleRouteRealizationTable, checkLocaleRouter, commitLocaleRouteMetaTransition, localeAwareCacheKey, localizeBodyLinks, localizeSameAppHref, parseLocaleFromPath, planLocalePathNavigation, realizeRoutePath, resolveLinkHref, } from './locale-router.js';
+export { LOCALE_ROUTE_REALIZATION_ARTIFACT_SCHEMA, emitLocaleRouteRealization, } from './locale-route-emit.js';
 export { assertHostMessageInvariant, assertServerErrorEnvelope, assertServerFormatContext, buildLocaleDeliveryResolution, checkLocaleDelivery, fallbackDigest, messageCatalogHash, proveMiniPackageMessages, validateNativeLocalePack, } from './locale-delivery.js';
 export { checkLocaleConformance, diffLocaleCatalogs, explainLocaleMessage, extractHardcodedText, pseudoLocalizeCatalog, } from './locale-tooling.js';
 export { applyPlugins, contentHash, defineConfig, definePlugin, loadVmzConfig, } from './plugin-host.js';
@@ -406,6 +465,14 @@ export default {
     checkApplicationsJson,
     queryTargetProtocolCatalog,
     checkMiniprogramTargetContractJson,
+    lowerMiniprogramStaticSliceJson,
+    lowerMiniprogramBindingEventJson,
+    lowerMiniprogramStructureJson,
+    lowerMiniprogramRouteServerStyleJson,
+    lowerMiniprogramToolingDeployJson,
+    lowerMiniprogramWechatPackagingJson,
+    lowerMiniprogramMultiAdapterJson,
+    createMiniHost,
     queryProfileProtocolCatalog,
     checkHostProfileProtocolJson,
     checkProfileSolverJson,

package/dist/locale-check.js

@@ -7,6 +7,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import JSON5 from 'json5';
+import { requireNativeAddon } from './native-addon.js';
+import { writePrettyJsonFile } from './pretty-json.js';
 import { DIAG_CATALOG_CONFLICT, DIAG_CATALOG_PARSE, DIAG_DEFAULT_MISSING, DIAG_DIR_MISSING, DIAG_DIR_ORPHAN, DIAG_FALLBACK_CYCLE, DIAG_FALLBACK_UNKNOWN, DIAG_ID_COLLISION, DIAG_ID_INVALID, DIAG_LAYOUT_ILLEGAL, DIAG_MANIFEST_MISSING, DIAG_MESSAGE_ARRAY_FORBIDDEN, DIAG_MESSAGE_HTML_FORBIDDEN, DIAG_MESSAGE_MISSING_DEFAULT, 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';
 /**
  * @param {string} literal
@@ -250,10 +252,12 @@ export function checkLocales(opts) {
     const manifestPathJson = path.join(localesRoot, 'locales.json');
     const manifestPath = fs.existsSync(manifestPathJson5) ? manifestPathJson5 : fs.existsSync(manifestPathJson) ? manifestPathJson : null;
     if (!fs.existsSync(localesRoot) || !manifestPath) {
+        // Discipline nudge: i18n is first-class — missing policy is never silent.
+        // Soft for now (warning); production profiles may elevate to error later.
         diagnostics.push({
             code: DIAG_MANIFEST_MISSING,
-            severity: 'error',
-            message: 'locales/locales.json5 missing (LocaleId policy truth source)',
+            severity: 'warning',
+            message: 'locales/locales.json5 missing — declare LocaleId policy under /locales (native i18n, not an afterthought)',
             path: 'locales/locales.json5',
         });
         return emptyReport(projectRoot, diagnostics);
@@ -586,9 +590,10 @@ function paramSignature(params) {
         .join(',');
 }
 function emptyReport(projectRoot, diagnostics) {
+    const hasErrors = (diagnostics || []).some((d) => d.severity === 'error');
     return {
         schema: LOCALE_CHECK_SCHEMA,
-        status: 'failed',
+        status: hasErrors ? 'failed' : 'ready',
         root: projectRoot,
         localesRoot: 'locales',
         manifest: null,
@@ -665,25 +670,19 @@ export function emitLocaleTypedModules(report, outDir) {
     fs.mkdirSync(outDir, { recursive: true });
     /** @type {string[]} */
     const written = [];
+    const native = requireNativeAddon();
+    if (typeof native.generateLocaleTypedModule !== 'function') {
+        throw new Error('vmz native addon missing generateLocaleTypedModule — rebuild with `pnpm napi:build`');
+    }
     for (const mod of report.typedModules || []) {
-        const lines = [
-            `/** Generated LocalizedText module — ${mod.module} (vmz.locale.typed_module.v0) */`,
-            `export type LocalizedText = string & { readonly __brand: 'LocalizedText' };`,
-            '',
-        ];
-        for (const exp of mod.exports) {
-            if (!exp.params.length) {
-                lines.push(`export declare function ${exp.exportName}(): LocalizedText;`);
-            }
-            else {
-                const args = exp.params.map((p) => `${p.name}: ${p.kind === 'plural' || p.kind === 'number' ? 'number' : 'string'}`).join('; ');
-                lines.push(`export declare function ${exp.exportName}(args: { ${args} }): LocalizedText;`);
-            }
-        }
-        lines.push('');
+        const exports = (mod.exports || []).map((exp) => ({
+            exportName: exp.exportName,
+            params: (exp.params || []).map((p) => ({ name: p.name, kind: p.kind || 'string' })),
+        }));
+        const text = native.generateLocaleTypedModule(mod.module, exports);
         const file = path.join(outDir, `${mod.catalogId}.d.ts`);
         fs.mkdirSync(path.dirname(file), { recursive: true });
-        fs.writeFileSync(file, lines.join('\n'), 'utf8');
+        fs.writeFileSync(file, text, 'utf8');
         written.push(file);
     }
     const index = {
@@ -691,7 +690,7 @@ export function emitLocaleTypedModules(report, outDir) {
         modules: (report.typedModules || []).map((m) => m.module),
         outDir,
     };
-    fs.writeFileSync(path.join(outDir, 'index.json'), `${JSON.stringify(index, null, 2)}\n`, 'utf8');
+    writePrettyJsonFile(path.join(outDir, 'index.json'), index);
     return written;
 }
 /**
@@ -706,71 +705,45 @@ export function emitLocaleTypedModules(report, outDir) {
  * @returns {{ ok: boolean, written: string[], diagnostics: any[] }}
  */
 export function emitLocaleRuntimeModules(projectRoot, distDir) {
-    const localesRoot = path.join(projectRoot, 'locales');
-    if (!fs.existsSync(localesRoot)) {
-        return { ok: true, written: [], diagnostics: [] };
-    }
     const report = checkLocales({ projectRoot, checkUnused: false });
     if (localeHasErrors(report)) {
         return { ok: false, written: [], diagnostics: report.diagnostics || [] };
     }
-    const defaultLocale = report.manifest?.defaultLocale || 'zh-hans';
+    // Missing locales.json5 is warning-only for now — surface diagnostics, skip emit.
+    if (!report.manifest) {
+        return { ok: true, written: [], diagnostics: report.diagnostics || [] };
+    }
+    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 });
     for (const mod of report.typedModules || []) {
-        const lines = [
-            `/** Generated ${mod.module} — runtime LocalizedText (defaultLocale=${defaultLocale}) */`,
-            `const __vmzDefaultLocale = ${JSON.stringify(defaultLocale)};`,
-            `function __vmzLocaleId() {`,
-            `  try {`,
-            `    const stored = localStorage.getItem("vmz.locale");`,
-            `    if (stored) return stored;`,
-            `  } catch {}`,
-            `  if (typeof document !== "undefined") {`,
-            `    const d = document.documentElement?.getAttribute("data-locale");`,
-            `    if (d) return d;`,
-            `    const lang = document.documentElement?.lang;`,
-            `    if (lang === "en" || lang === "en-US" || lang === "en-us") return "en-us";`,
-            `    if (lang === "zh" || lang === "zh-CN" || lang === "zh-Hans" || lang === "zh-hans") return "zh-hans";`,
-            `  }`,
-            `  return __vmzDefaultLocale;`,
-            `}`,
-            `function __vmzFormat(template, args) {`,
-            `  if (!args) return String(template ?? "");`,
-            `  return String(template ?? "").replace(/\\{(\\w+)(?:,\\s*\\w+)?\\}/g, (m, name) =>`,
-            `    Object.prototype.hasOwnProperty.call(args, name) ? String(args[name]) : m`,
-            `  );`,
-            `}`,
-            `function __vmzPick(variants, args) {`,
-            `  const id = __vmzLocaleId();`,
-            `  const template = variants[id] ?? variants[__vmzDefaultLocale] ?? "";`,
-            `  return __vmzFormat(template, args);`,
-            `}`,
-            '',
-        ];
+        const exports = [];
         for (const exp of mod.exports || []) {
             const node = byId.get(exp.messageId);
-            const variants = {};
+            /** @type {string[][]} */
+            const variants = [];
             if (node?.variants) {
                 for (const [loc, v] of Object.entries(node.variants)) {
-                    variants[loc] = v.template;
+                    variants.push([loc, v.template]);
                 }
             }
-            const lit = JSON.stringify(variants);
-            if ((exp.params || []).length) {
-                lines.push(`export function ${exp.exportName}(args) { return __vmzPick(${lit}, args); }`);
-            }
-            else {
-                lines.push(`export function ${exp.exportName}() { return __vmzPick(${lit}); }`);
-            }
+            exports.push({
+                exportName: exp.exportName,
+                variants,
+                hasParams: (exp.params || []).length > 0,
+            });
+        }
+        const native = requireNativeAddon();
+        if (typeof native.generateLocaleRuntimeModule !== 'function') {
+            throw new Error('vmz native addon missing generateLocaleRuntimeModule — rebuild with `pnpm napi:build`');
         }
-        lines.push('');
+        const code = native.generateLocaleRuntimeModule(defaultLocale, exports);
         const file = path.join(localesOut, `${mod.catalogId}.js`);
         fs.mkdirSync(path.dirname(file), { recursive: true });
-        fs.writeFileSync(file, lines.join('\n'), 'utf8');
+        fs.writeFileSync(file, code, 'utf8');
         written.push(file);
     }
     rewriteLocaleImportsInDist(distDir);

package/dist/locale-cmd.js

@@ -12,6 +12,7 @@ import { checkLocaleRouter } from './locale-router.js';
 import { checkLocaleRuntime } from './locale-runtime.js';
 import { checkLocaleConformance, diffLocaleCatalogs, explainLocaleMessage, extractHardcodedText, pseudoLocalizeCatalog, } from './locale-tooling.js';
 import { log } from './log.js';
+import { emitPrettyJson, generatePrettyJson } from './pretty-json.js';
 function printLocaleHelp() {
     console.log(`vmz locale — /locales application i18n (–)
 
@@ -91,14 +92,7 @@ function cmdLocaleCheck(args) {
     const report = checkLocales({ projectRoot, strict: Boolean(args.strict) });
     const jsonOut = args.json;
     if (jsonOut) {
-        const text = JSON.stringify(report, null, 2);
-        if (typeof jsonOut === 'string') {
-            fs.writeFileSync(jsonOut, `${text}\n`, 'utf8');
-            log.info(`wrote ${jsonOut}`);
-        }
-        else {
-            console.log(text);
-        }
+        emitPrettyJson(jsonOut, report, { logWrote: (p) => log.info(`wrote ${p}`) });
     }
     else {
         for (const d of report.diagnostics) {
@@ -117,8 +111,8 @@ function cmdLocaleList(args) {
     const projectRoot = resolveProject(args);
     const report = checkLocales({ projectRoot, checkUnused: false });
     if (!report.manifest) {
-        log.error('locales.json5 missing');
-        return 1;
+        console.warn('vmz warn vmz::locale::manifest_missing: locales/locales.json5 missing');
+        return localeHasErrors(report) ? 1 : 0;
     }
     for (const loc of report.manifest.locales) {
         const mark = loc.id === report.manifest.defaultLocale ? ' (default)' : '';
@@ -151,7 +145,7 @@ function cmdLocaleRename(args) {
     const report = checkLocales({ projectRoot, checkUnused: false });
     const plan = planLocaleRename(report, fromId, toId);
     if (args.json) {
-        console.log(JSON.stringify(plan, null, 2));
+        emitPrettyJson(args.json, plan);
     }
     else if (plan.status !== 'ready') {
         log.error(plan.error || 'rename failed');
@@ -181,14 +175,7 @@ function cmdLocaleRuntimeCheck(args) {
     });
     const { session: _session, ...jsonReport } = report;
     if (args.json) {
-        const text = JSON.stringify(jsonReport, null, 2);
-        if (typeof args.json === 'string') {
-            fs.writeFileSync(args.json, `${text}\n`, 'utf8');
-            log.info(`wrote ${args.json}`);
-        }
-        else {
-            console.log(text);
-        }
+        emitJson(args, jsonReport);
     }
     else {
         for (const d of report.diagnostics) {
@@ -231,14 +218,7 @@ function cmdLocaleRouterCheck(args) {
         origin: routesFile.origin || 'https://example.test',
     });
     if (args.json) {
-        const text = JSON.stringify(report, null, 2);
-        if (typeof args.json === 'string') {
-            fs.writeFileSync(args.json, `${text}\n`, 'utf8');
-            log.info(`wrote ${args.json}`);
-        }
-        else {
-            console.log(text);
-        }
+        emitJson(args, report);
     }
     else {
         for (const d of report.diagnostics) {
@@ -268,14 +248,7 @@ function cmdLocaleDeliveryCheck(args) {
         planVersion: 'plan.v0',
     });
     if (args.json) {
-        const text = JSON.stringify(report, null, 2);
-        if (typeof args.json === 'string') {
-            fs.writeFileSync(args.json, `${text}\n`, 'utf8');
-            log.info(`wrote ${args.json}`);
-        }
-        else {
-            console.log(text);
-        }
+        emitJson(args, report);
     }
     else {
         for (const d of report.diagnostics) {
@@ -290,14 +263,9 @@ function cmdLocaleDeliveryCheck(args) {
     return report.status === 'ready' ? 0 : 1;
 }
 function emitJson(args, report) {
-    const text = JSON.stringify(report, null, 2);
-    if (typeof args.json === 'string') {
-        fs.writeFileSync(args.json, `${text}\n`, 'utf8');
-        log.info(`wrote ${args.json}`);
-    }
-    else {
-        console.log(text);
-    }
+    emitPrettyJson(args.json, report, {
+        logWrote: (p) => log.info(`wrote ${p}`),
+    });
 }
 function cmdLocaleExplain(args) {
     const messageId = typeof args._[0] === 'string' ? args._[0] : '';
@@ -401,7 +369,7 @@ function cmdLocalePseudo(args) {
         const outDir = (typeof args.out === 'string' && args.out) || path.join(projectRoot, 'dist', 'locales-pseudo');
         fs.mkdirSync(outDir, { recursive: true });
         const outFile = path.join(outDir, `${report.pseudoLocale}.json`);
-        fs.writeFileSync(outFile, `${JSON.stringify(report.catalog, null, 2)}\n`, 'utf8');
+        fs.writeFileSync(outFile, `${generatePrettyJson(report.catalog)}\n`, 'utf8');
         log.info(`locale pseudo: source=${sourceLocale} keys=${Object.keys(report.catalog).length} out=${outFile}`);
     }
     return report.status === 'ready' ? 0 : 1;

package/dist/locale-route-emit.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Emit RouteId × LocaleId realization (+ PageMeta / hreflang seed) into dist/_vmz.
+ * Consumed by serve-host + static-emit; LocaleId stays out of stable RouteId.
+ */
+export declare const LOCALE_ROUTE_REALIZATION_ARTIFACT_SCHEMA = "vmz.locale.route_realization.v0";
+/**
+ * @param {string} projectRoot
+ * @param {string} distDir
+ * @param {{ origin?: string }} [opts]
+ */
+export declare function emitLocaleRouteRealization(projectRoot: any, distDir: any, opts?: {}): {
+    ok: boolean;
+    written: any[];
+    diagnostics: any;
+    artifact: any;
+} | {
+    ok: boolean;
+    written: string[];
+    artifact: {
+        schema: string;
+        defaultLocale: any;
+        locales: any;
+        routing: {
+            strategy: any;
+            defaultPrefix: any;
+            defaultLocale: any;
+        };
+        origin: string;
+        routes: {
+            routeId: string;
+            path: string;
+        }[];
+        realizations: any[];
+        pageMetas: any[];
+    };
+    diagnostics: any[];
+};