@vmz/vmz 0.1.13 → 0.1.15

package/dist/index.d.ts

@@ -53,6 +53,14 @@ export declare function handshake(host?: {
  * @returns {string | null}
  */
 export declare function resolveCoreRuntimeDist(): string;
+/** Runtime companions required by dist/vmz-serve-host.mjs relative imports. */
+export declare const SERVE_HOST_RUNTIME_FILES: string[][];
+/**
+ * Copy serve-host + registry bootstrap modules from `@vmz/core` into app outDir.
+ * @param {string} outDir
+ * @param {string} [coreDist]
+ */
+export declare function materializeServeHostRuntime(outDir: any, coreDist?: string): void;
 /**
  * @typedef {object} WorkspaceOptions
  * @property {string} root
@@ -84,6 +92,7 @@ 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 };
@@ -146,6 +155,7 @@ export declare function checkApplicationHostCompositionJson(hostRoot: any, packa
  */
 export declare function checkApplicationDevTestDeployJson(hostRoot: any, packageRoots: any, dirtyPaths?: any[]): any;
 export { createDevSession, listWatchedFiles, srcFingerprint } from './dev-session.js';
+export { coalesceRootBurst, collectDevWatchRoots, mergeDirtySets, localLinkDependencyRoots, watchRootForSourceFile, } from './dev-watch-roots.js';
 export { findAvailablePort } from './port.js';
 export { runCli, parseArgs, printHelp, printGlobalHelp, printProjectHelp } from './cli.js';
 export { findNearestProjectVmz, getInvocationContext, isGlobalAllowedCommand, isUnderNodeModules, resolveThisPackageRoot, resolveVmzBin, gateGlobalProjectCommand, } from './invocation.js';
@@ -156,12 +166,15 @@ export { cmdApplication, runCheck as runApplicationCheck } from './application-c
 export { cmdArtifact } from './release-cmd.js';
 export { ARTIFACT_DIFF_SCHEMA, DELIVERY_ARTIFACT_MANIFEST_SCHEMA, RELEASE_ENVELOPE_SCHEMA, ROUTE_REALIZATION_TABLE_SCHEMA, atomicWritePointer, canonicalJson, diffArtifacts, loadReleaseEnvelope, packRelease, publishRelease, readPointer, rollbackRelease, sha256File, sha256Hex, } from './release-pack.js';
 export { STATIC_DELIVERY_MANIFEST_SCHEMA, emitWebStatic, } from './static-emit.js';
-export { CONTENT_ADDRESSED_ASSETS_SCHEMA, emitContentAddressedAssets, resolveAssetByDigest, assertSharedAssetPath, contentAddressedAssetsDigest, } from './content-addressed-assets.js';
+export { CONTENT_ADDRESSED_ASSETS_SCHEMA, emitContentAddressedAssets, resolveAssetByDigest, assertSharedAssetPath, contentAddressedAssetsDigest, rewriteCssImports, rewriteJsEntryRelativeImports, } from './content-addressed-assets.js';
+export { SITE_FAVICON_SCHEMA, emitSiteFavicon, readSiteFaviconHeadHtml, packPngsIntoIco, } from './site-favicon.js';
+export { PUBLIC_STATIC_ASSETS_SCHEMA, emitPublicStaticAssets, } from './public-static-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 { DELIVERY_PROFILE_AUTHORING_SCHEMA, BUILD_PROFILE_SELECTION_SCHEMA, ASSEMBLIES, SERVER_RUNTIMES, BUILTIN_PROFILES, pickSiteAuthoring, normalizeDeliveryAuthoring, selectBuildProfile, semanticIdsForAssembly, } from './delivery-profile.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, normalizeProfileArtifactName, resolveProfileArtifactDir, 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';
@@ -231,6 +244,8 @@ declare const _default: {
     expectedProtocol: typeof expectedProtocol;
     resolveNativePath: typeof resolveNativePath;
     resolveCoreRuntimeDist: typeof resolveCoreRuntimeDist;
+    materializeServeHostRuntime: typeof materializeServeHostRuntime;
+    SERVE_HOST_RUNTIME_FILES: string[][];
     loadNative: typeof loadNative;
     getProtocolVersions: typeof getProtocolVersions;
     handshake: typeof handshake;
@@ -244,6 +259,7 @@ declare const _default: {
     lowerMiniprogramStructureJson: typeof lowerMiniprogramStructureJson;
     lowerMiniprogramRouteServerStyleJson: typeof lowerMiniprogramRouteServerStyleJson;
     lowerMiniprogramToolingDeployJson: typeof lowerMiniprogramToolingDeployJson;
+    lowerMiniprogramWechatPackagingJson: typeof lowerMiniprogramWechatPackagingJson;
     lowerMiniprogramMultiAdapterJson: typeof lowerMiniprogramMultiAdapterJson;
     createMiniHost: typeof createMiniHost;
     queryProfileProtocolCatalog: typeof queryProfileProtocolCatalog;

package/dist/index.js

@@ -4,9 +4,10 @@
  * Coarse-grained only — no transform hooks / per-AST callbacks.
  */
 import { createRequire } from 'node:module';
-import { existsSync } from 'node:fs';
+import { copyFileSync, 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);
@@ -143,6 +144,33 @@ export function resolveCoreRuntimeDist() {
         return nested;
     return null;
 }
+/** Runtime companions required by dist/vmz-serve-host.mjs relative imports. */
+export const SERVE_HOST_RUNTIME_FILES = [
+    ['serve-host.mjs', 'vmz-serve-host.mjs'],
+    ['native-addon.js', 'native-addon.js'],
+    ['list-client-components.js', 'list-client-components.js'],
+    ['deployment-registry.js', 'deployment-registry.js'],
+    ['render-host.js', 'render-host.js'],
+    ['route-layout-chain.js', 'route-layout-chain.js'],
+];
+/**
+ * Copy serve-host + registry bootstrap modules from `@vmz/core` into app outDir.
+ * @param {string} outDir
+ * @param {string} [coreDist]
+ */
+export function materializeServeHostRuntime(outDir, coreDist = resolveCoreRuntimeDist()) {
+    if (!coreDist) {
+        throw new Error('materializeServeHostRuntime: @vmz/core dist not found');
+    }
+    for (const [srcName, outName] of SERVE_HOST_RUNTIME_FILES) {
+        const src = path.join(coreDist, srcName);
+        const dst = path.join(outDir, outName);
+        if (!existsSync(src)) {
+            throw new Error(`materializeServeHostRuntime: missing ${src}`);
+        }
+        copyFileSync(src, dst);
+    }
+}
 /**
  * @typedef {object} WorkspaceOptions
  * @property {string} root
@@ -158,7 +186,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 +197,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.
@@ -216,6 +263,11 @@ 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);
@@ -344,6 +396,7 @@ export function checkApplicationDevTestDeployJson(hostRoot, packageRoots, dirtyP
     return native.checkApplicationDevTestDeployJson(hostRoot, packageRoots, dirtyPaths);
 }
 export { createDevSession, listWatchedFiles, srcFingerprint } from './dev-session.js';
+export { coalesceRootBurst, collectDevWatchRoots, mergeDirtySets, localLinkDependencyRoots, watchRootForSourceFile, } from './dev-watch-roots.js';
 export { findAvailablePort } from './port.js';
 export { runCli, parseArgs, printHelp, printGlobalHelp, printProjectHelp } from './cli.js';
 export { findNearestProjectVmz, getInvocationContext, isGlobalAllowedCommand, isUnderNodeModules, resolveThisPackageRoot, resolveVmzBin, gateGlobalProjectCommand, } from './invocation.js';
@@ -356,12 +409,15 @@ export { ARTIFACT_DIFF_SCHEMA, DELIVERY_ARTIFACT_MANIFEST_SCHEMA, RELEASE_ENVELO
 // APPLICATION_ARTIFACT_SCHEMA lives in @vmz/protocol (already re-exported above);
 // release-pack keeps a local constant for envelope writes — do not dual-export the name.
 export { STATIC_DELIVERY_MANIFEST_SCHEMA, emitWebStatic, } from './static-emit.js';
-export { CONTENT_ADDRESSED_ASSETS_SCHEMA, emitContentAddressedAssets, resolveAssetByDigest, assertSharedAssetPath, contentAddressedAssetsDigest, } from './content-addressed-assets.js';
+export { CONTENT_ADDRESSED_ASSETS_SCHEMA, emitContentAddressedAssets, resolveAssetByDigest, assertSharedAssetPath, contentAddressedAssetsDigest, rewriteCssImports, rewriteJsEntryRelativeImports, } from './content-addressed-assets.js';
+export { SITE_FAVICON_SCHEMA, emitSiteFavicon, readSiteFaviconHeadHtml, packPngsIntoIco, } from './site-favicon.js';
+export { PUBLIC_STATIC_ASSETS_SCHEMA, emitPublicStaticAssets, } from './public-static-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 { DELIVERY_PROFILE_AUTHORING_SCHEMA, BUILD_PROFILE_SELECTION_SCHEMA, ASSEMBLIES, SERVER_RUNTIMES, BUILTIN_PROFILES, pickSiteAuthoring, normalizeDeliveryAuthoring, selectBuildProfile, semanticIdsForAssembly, } from './delivery-profile.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, normalizeProfileArtifactName, resolveProfileArtifactDir, 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';
@@ -431,6 +487,8 @@ export default {
     expectedProtocol,
     resolveNativePath,
     resolveCoreRuntimeDist,
+    materializeServeHostRuntime,
+    SERVE_HOST_RUNTIME_FILES,
     loadNative,
     getProtocolVersions,
     handshake,
@@ -444,6 +502,7 @@ export default {
     lowerMiniprogramStructureJson,
     lowerMiniprogramRouteServerStyleJson,
     lowerMiniprogramToolingDeployJson,
+    lowerMiniprogramWechatPackagingJson,
     lowerMiniprogramMultiAdapterJson,
     createMiniHost,
     queryProfileProtocolCatalog,

package/dist/locale-check.js

@@ -6,8 +6,10 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
-import JSON5 from 'json5';
-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';
+import { loadLocalePlan, mapPlanDiagnostics, parseAuthorInput } from './author-input.js';
+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
  */
@@ -246,124 +248,57 @@ export function checkLocales(opts) {
     const localesRoot = path.join(projectRoot, 'locales');
     /** @type {Array<{ code: string, severity: string, message: string, path?: string }>} */
     const diagnostics = [];
-    const manifestPathJson5 = path.join(localesRoot, 'locales.json5');
-    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: 'warning',
-            message: 'locales/locales.json5 missing — declare LocaleId policy under /locales (native i18n, not an afterthought)',
-            path: 'locales/locales.json5',
-        });
-        return emptyReport(projectRoot, diagnostics);
-    }
-    /** @type {any} */
-    let rawManifest = null;
-    try {
-        rawManifest = JSON5.parse(fs.readFileSync(manifestPath, 'utf8'));
-    }
-    catch (e) {
-        diagnostics.push({
-            code: DIAG_CATALOG_PARSE,
-            severity: 'error',
-            message: `locales.json5 parse failed: ${e.message || e}`,
-            path: path.relative(projectRoot, manifestPath).replace(/\\/g, '/'),
-        });
+    const plan = loadLocalePlan(projectRoot);
+    diagnostics.push(...mapPlanDiagnostics(plan.diagnostics));
+    const missingManifest = (plan.diagnostics || []).some((d) => d.code === DIAG_MANIFEST_MISSING);
+    if (missingManifest || !plan.locales?.length) {
         return emptyReport(projectRoot, diagnostics);
     }
-    const localeEntries = Array.isArray(rawManifest.locales) ? rawManifest.locales : [];
+    const localeEntries = plan.locales || [];
     /** @type {string[]} */
-    const orderedIds = [];
+    const orderedIds = localeEntries.map((e) => e.id);
     /** @type {Set<string>} */
-    const seen = new Set();
-    for (const entry of localeEntries) {
-        const id = String(entry?.id || '');
-        const v = validateLocaleId(id);
-        if (!v.ok) {
-            diagnostics.push({
-                code: DIAG_ID_INVALID,
-                severity: 'error',
-                message: v.message,
-                path: path.relative(projectRoot, manifestPath).replace(/\\/g, '/'),
-            });
-            continue;
-        }
-        if (seen.has(id)) {
-            diagnostics.push({
-                code: DIAG_ID_COLLISION,
-                severity: 'error',
-                message: `duplicate LocaleId ${id} in locales[]`,
-                path: path.relative(projectRoot, manifestPath).replace(/\\/g, '/'),
-            });
-            continue;
-        }
-        seen.add(id);
-        orderedIds.push(id);
-    }
-    const defaultLocale = String(rawManifest.defaultLocale || '');
-    if (!defaultLocale || !seen.has(defaultLocale)) {
-        diagnostics.push({
-            code: DIAG_DEFAULT_MISSING,
-            severity: 'error',
-            message: `defaultLocale ${JSON.stringify(defaultLocale)} missing from locales[]`,
-            path: path.relative(projectRoot, manifestPath).replace(/\\/g, '/'),
-        });
-    }
-    const fallback = rawManifest.fallback && typeof rawManifest.fallback === 'object' ? rawManifest.fallback : {};
-    const fb = findFallbackCycles(fallback, seen);
-    for (const u of fb.unknown) {
-        diagnostics.push({
-            code: DIAG_FALLBACK_UNKNOWN,
-            severity: 'error',
-            message: `fallback references unknown LocaleId: ${u}`,
-            path: path.relative(projectRoot, manifestPath).replace(/\\/g, '/'),
-        });
-    }
-    for (const c of fb.cycles) {
-        diagnostics.push({
-            code: DIAG_FALLBACK_CYCLE,
-            severity: 'error',
-            message: `fallback cycle: ${c}`,
-            path: path.relative(projectRoot, manifestPath).replace(/\\/g, '/'),
-        });
-    }
+    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 = [];
-    for (const ent of fs.readdirSync(localesRoot, { withFileTypes: true })) {
-        if (LOCALE_RESERVED_TOP.has(ent.name))
-            continue;
-        if (ent.isFile()) {
-            diagnostics.push({
-                code: DIAG_LAYOUT_ILLEGAL,
-                severity: 'error',
-                message: `illegal top-level file under /locales: ${ent.name} (only locales.json5 + LocaleId dirs)`,
-                path: `locales/${ent.name}`,
-            });
-            continue;
-        }
-        if (!ent.isDirectory())
-            continue;
-        const v = validateLocaleId(ent.name);
-        if (!v.ok) {
-            diagnostics.push({
-                code: DIAG_ID_INVALID,
-                severity: 'error',
-                message: `directory ${ent.name}: ${v.message}`,
-                path: `locales/${ent.name}`,
-            });
-            continue;
-        }
-        diskLocales.push(ent.name);
-        if (!seen.has(ent.name)) {
-            diagnostics.push({
-                code: DIAG_DIR_ORPHAN,
-                severity: 'error',
-                message: `locale directory ${ent.name} not listed in locales.json5 locales[]`,
-                path: `locales/${ent.name}`,
-            });
+    if (fs.existsSync(localesRoot)) {
+        for (const ent of fs.readdirSync(localesRoot, { withFileTypes: true })) {
+            if (LOCALE_RESERVED_TOP.has(ent.name))
+                continue;
+            if (ent.isFile()) {
+                diagnostics.push({
+                    code: DIAG_LAYOUT_ILLEGAL,
+                    severity: 'error',
+                    message: `illegal top-level file under /locales: ${ent.name} (only locales.json5 + LocaleId dirs)`,
+                    path: `locales/${ent.name}`,
+                });
+                continue;
+            }
+            if (!ent.isDirectory())
+                continue;
+            const v = validateLocaleId(ent.name);
+            if (!v.ok) {
+                diagnostics.push({
+                    code: DIAG_ID_INVALID,
+                    severity: 'error',
+                    message: `directory ${ent.name}: ${v.message}`,
+                    path: `locales/${ent.name}`,
+                });
+                continue;
+            }
+            diskLocales.push(ent.name);
+            if (!seen.has(ent.name)) {
+                diagnostics.push({
+                    code: DIAG_DIR_ORPHAN,
+                    severity: 'error',
+                    message: `locale directory ${ent.name} not listed in locales.json5 locales[]`,
+                    path: `locales/${ent.name}`,
+                });
+            }
         }
     }
     for (const id of orderedIds) {
@@ -402,7 +337,7 @@ export function checkLocales(opts) {
                     });
                     return;
                 }
-                parsed = JSON5.parse(text);
+                parsed = parseAuthorInput(text);
             }
             catch (e) {
                 diagnostics.push({
@@ -446,7 +381,6 @@ export function checkLocales(opts) {
             }
         });
     }
-    // Default locale must define every MessageId; param contracts must match across variants.
     for (const node of messages.values()) {
         if (defaultLocale && !node.variants[defaultLocale]) {
             diagnostics.push({
@@ -475,7 +409,7 @@ export function checkLocales(opts) {
                 if (!node.variants[loc] && loc !== defaultLocale) {
                     const edges = fallback[loc] || [];
                     const canFallback = edges.some((e) => node.variants[e]);
-                    if (!canFallback && rawManifest.missing !== 'warn') {
+                    if (!canFallback && missingPolicy !== 'warn') {
                         diagnostics.push({
                             code: DIAG_MESSAGE_MISSING_VARIANT,
                             severity: 'error',
@@ -486,7 +420,6 @@ export function checkLocales(opts) {
             }
         }
     }
-    // scan source for #locales/* imports / message references.
     const used = scanLocaleUsages(projectRoot);
     /** @type {any[]} */
     const typedModules = [];
@@ -557,12 +490,12 @@ export function checkLocales(opts) {
         localesRoot: path.relative(projectRoot, localesRoot).replace(/\\/g, '/') || 'locales',
         manifest: {
             schema: LOCALE_MANIFEST_SCHEMA,
-            schemaVersion: rawManifest.schemaVersion ?? 1,
+            schemaVersion: 1,
             defaultLocale,
             locales: localeEntries,
             fallback,
-            routing: rawManifest.routing || { strategy: 'prefix', defaultPrefix: 'include' },
-            missing: rawManifest.missing || 'error',
+            routing,
+            missing: missingPolicy,
         },
         catalogIds: catalogIds.sort(),
         messageCatalog: {
@@ -668,25 +601,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 = {
@@ -694,7 +621,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;
 }
 /**
@@ -724,59 +651,30 @@ export function emitLocaleRuntimeModules(projectRoot, distDir) {
     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() {`,
-            `  if (typeof globalThis !== "undefined" && globalThis.__vmzLocaleIdHint) {`,
-            `    return String(globalThis.__vmzLocaleIdHint);`,
-            `  }`,
-            `  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";`,
-            `  }`,
-            `  try {`,
-            `    const stored = localStorage.getItem("vmz.locale");`,
-            `    if (stored) return stored;`,
-            `  } catch {}`,
-            `  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,
+            });
         }
-        lines.push('');
+        const native = requireNativeAddon();
+        if (typeof native.generateLocaleRuntimeModule !== 'function') {
+            throw new Error('vmz native addon missing generateLocaleRuntimeModule — rebuild with `pnpm napi:build`');
+        }
+        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);
@@ -790,7 +688,7 @@ function rewriteLocaleImportsInDist(distDir) {
     const files = [];
     walkDistJs(distDir, (file) => files.push(file));
     for (const file of files) {
-        let text = fs.readFileSync(file, 'utf8');
+        const text = fs.readFileSync(file, 'utf8');
         if (!text.includes('#locales/'))
             continue;
         const fromDir = path.dirname(file);