@vmz/vmz 0.1.17 → 0.1.18

package/dist/explain-cmd.js

@@ -1,48 +1,44 @@
-// @ts-nocheck
 /**
- * `vmz explain` — DX causal explain queries .
- *
- * @param {string[]} argv args after `explain`
+ * `vmz explain` — DX causal explain; registered on `@vmz/commander`.
  */
 import { createWorkspace } from './index.js';
 import { log } from './log.js';
 import { resolveWorkspaceDirs } from './resolve.js';
-/**
- * @param {string[]} argv
- * @returns {number}
- */
-export function cmdExplain(argv) {
-    const args = parse(argv);
-    if (args.help || args._[0] === 'help') {
-        printHelp();
-        return 0;
-    }
+export function registerExplainCommand(cli) {
+    cli.command('explain', 'cli.cmd.explain')
+        .option('--json', 'cli.opt.json')
+        .option('--out-dir, -o <dir>', 'cli.opt.out-dir')
+        .option('--target <id>', 'cli.opt.explain.target')
+        .option('--path <dir>', 'cli.opt.root')
+        .action((options) => cmdExplain(options));
+}
+export function cmdExplain(args) {
     let target;
     let pathArg = '.';
     if (args._[0] === 'style') {
         const node = args._[1];
         if (!node) {
-            log.error('usage: vmz explain style <node> [path]');
+            log.errorId('cli.err.explain_style_usage');
             return 1;
         }
         target = `style:${node}`;
-        pathArg = args._[2] ?? args.path ?? '.';
+        pathArg = args._[2] ?? (typeof args.path === 'string' ? args.path : '.');
     }
     else if (args._[0]) {
         target = String(args._[0]);
-        pathArg = args._[1] ?? args.path ?? '.';
+        pathArg = args._[1] ?? (typeof args.path === 'string' ? args.path : '.');
     }
     else if (args.target) {
         target = String(args.target);
-        pathArg = args.path ?? '.';
+        pathArg = typeof args.path === 'string' ? args.path : '.';
     }
     else {
-        printHelp();
+        log.errorId('cli.err.explain_usage');
         return 1;
     }
     const { project, outDir } = resolveWorkspaceDirs({
         path: String(pathArg),
-        outDir: args['out-dir'] ?? 'dist',
+        outDir: typeof args['out-dir'] === 'string' ? args['out-dir'] : 'dist',
     });
     const ws = createWorkspace({ root: project, outDir });
     if (typeof ws.explain !== 'function') {
@@ -76,48 +72,3 @@ export function cmdExplain(argv) {
     }
     return 0;
 }
-function printHelp() {
-    console.log(`vmz explain — causal explain (DX)
-
-Usage:
-  vmz explain style <node> [path]   Style Theme / style:tw / global styles
-  vmz explain <target> [path]       Generic Workspace.explain target
-
-Style nodes:
-  bg-action | colors.action | --vmz-colors-action
-  designs/styles/index.scss
-
-Options:
-  --json                 Print raw ExplainDocument JSON
-  --out-dir, -o <dir>    Dist directory (default: dist)
-`);
-}
-/**
- * @param {string[]} argv
- */
-function parse(argv) {
-    /** @type {Record<string, string | boolean> & { _: string[] }} */
-    const out = { _: [] };
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a.startsWith('--')) {
-            const eq = a.indexOf('=');
-            if (eq !== -1) {
-                out[a.slice(2, eq)] = a.slice(eq + 1);
-                continue;
-            }
-            const key = a.slice(2);
-            const next = argv[i + 1];
-            if (next && !next.startsWith('-') && key !== 'json' && key !== 'help') {
-                out[key] = next;
-                i += 1;
-            }
-            else {
-                out[key] = true;
-            }
-            continue;
-        }
-        out._.push(a);
-    }
-    return out;
-}

package/dist/index.d.ts

@@ -4,166 +4,93 @@
  */
 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 { targetCatalog, profileCatalog, nativeHostCatalog, localeCatalog } from '@vmz/protocol';
-/**
- * @returns {{ hostProtocol: string, compilerProtocol: string, programIrSchema: string, pluginProtocol: string }}
- */
-export declare function expectedProtocol(): {
+export interface ProtocolVersions {
     hostProtocol: string;
     compilerProtocol: string;
     programIrSchema: string;
     pluginProtocol: string;
-};
+}
+export interface WorkspaceOptions {
+    root: string;
+    outDir?: string;
+    /** Absolute path to `@vmz/core` dist/; Node resolves when omitted. */
+    runtimeDist?: string;
+    protocol?: ProtocolVersions;
+}
+/** N-API addon surface — opaque blob with workspace / protocol entry points. */
+export type VmzNativeAddon = any;
+export declare function expectedProtocol(): ProtocolVersions;
 /**
  * Resolve native `.node` via the platform optionalDependency
  * (`@vmz/vmz-<short>`; transitional fallback `@vmz/vmz-<short>`).
- * @returns {string}
- */
-export declare function resolveNativePath(): any;
-/**
- * @returns {typeof import('./index.js') extends never ? any : any}
- */
-export declare function loadNative(): any;
-/**
- * @typedef {object} ProtocolVersions
- * @property {string} hostProtocol
- * @property {string} compilerProtocol
- * @property {string} programIrSchema
- * @property {string} pluginProtocol
- */
-/**
- * @returns {ProtocolVersions}
- */
-export declare function getProtocolVersions(): {
-    hostProtocol: any;
-    compilerProtocol: any;
-    programIrSchema: any;
-    pluginProtocol: any;
-};
-/**
- * @param {ProtocolVersions} [host]
- */
-export declare function handshake(host?: {
-    hostProtocol: string;
-    compilerProtocol: string;
-    programIrSchema: string;
-    pluginProtocol: string;
-}): void;
-/**
- * Resolve `@vmz/core` package `dist/` for runtime JS copies into app outDir.
- * @returns {string | null}
  */
-export declare function resolveCoreRuntimeDist(): string;
+export declare function resolveNativePath(): string;
+export declare function loadNative(): VmzNativeAddon;
+export declare function getProtocolVersions(): ProtocolVersions;
+export declare function handshake(host?: ProtocolVersions): void;
+/** Resolve `@vmz/core` package `dist/` for runtime JS copies into app outDir. */
+export declare function resolveCoreRuntimeDist(): string | null;
 /** 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
- * @property {string} [outDir]
- * @property {string} [runtimeDist]
- * @property {ProtocolVersions} [protocol]
- */
-/**
- * Create a long-lived compile workspace .
- * @param {WorkspaceOptions} options
- */
-export declare function createWorkspace(options: any): any;
-/**
- * frozen application composition protocol catalog.
- * @returns {string}
- */
-export declare function queryApplicationProtocolCatalog(): any;
-/**
- * check host applications.config.json5 against workspace package descriptors.
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @returns {string} ApplicationCheckReport JSON
- */
-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;
+export declare const SERVE_HOST_RUNTIME_FILES: ReadonlyArray<readonly [string, string]>;
+/** Copy serve-host + registry bootstrap modules from `@vmz/core` into app outDir. */
+export declare function materializeServeHostRuntime(outDir: string, coreDist?: string | null): void;
+/** Create a long-lived compile workspace. */
+export declare function createWorkspace(options: WorkspaceOptions): VmzNativeAddon;
+/** frozen application composition protocol catalog. */
+export declare function queryApplicationProtocolCatalog(): string;
+/** check host applications.config.json5 against workspace package descriptors. */
+export declare function checkApplicationsJson(hostRoot: string, packageRoots: string[]): string;
+export declare function queryTargetProtocolCatalog(): string;
+export declare function checkMiniprogramTargetContractJson(rootPath: string): string;
+export declare function lowerMiniprogramStaticSliceJson(rootPath: string): string;
+export declare function lowerMiniprogramBindingEventJson(rootPath: string): string;
+export declare function lowerMiniprogramStructureJson(rootPath: string): string;
+export declare function lowerMiniprogramRouteServerStyleJson(rootPath: string): string;
+export declare function lowerMiniprogramToolingDeployJson(rootPath: string): string;
+export declare function lowerMiniprogramWechatPackagingJson(rootPath: string): string;
+export declare function lowerMiniprogramMultiAdapterJson(rootPath: string): string;
 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;
-export declare function checkUnifiedExecutorJson(rootPath: any): any;
-export declare function checkLifecycleRecoveryJson(rootPath: any): any;
-export declare function checkDeliveryProofJson(rootPath: any): any;
-export declare function checkCrossHostConformanceJson(rootPath: any): any;
-export declare function queryNativeHostProtocolCatalog(): any;
-export declare function checkNativeHostContractJson(rootPath: any): any;
-export declare function checkNativeShellContractJson(rootPath: any): any;
-export declare function checkNativeBridgeContractJson(rootPath: any): any;
-export declare function checkNativeLifecycleContractJson(rootPath: any): any;
-export declare function checkNativeFullstackContractJson(rootPath: any): any;
-export declare function checkNativeSurfaceContractJson(rootPath: any): any;
-export declare function checkMultiPlatformContractJson(rootPath: any): any;
-/**
- * prove independent `/` + non-root ApplicationBase; scan non-relocatable URLs.
- * @param {string} packageRoot
- * @param {string} [relocateBase]
- * @returns {string}
- */
-export declare function checkApplicationRelocatableJson(packageRoot: any, relocateBase: any): any;
-/**
- * apply ApplicationBase to a logical relocation manifest.
- * @param {string} manifestJson
- * @param {string} base
- * @returns {string}
- */
-export declare function relocateApplicationManifestJson(manifestJson: any, base: any): any;
-/**
- * independent ApplicationArtifact + MountTable/Catalog boundary (refs only).
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @returns {string}
- */
-export declare function checkApplicationArtifactBoundaryJson(hostRoot: any, packageRoots: any): any;
-/**
- * absolute isolation namespaces + failure containment.
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @returns {string}
- */
-export declare function checkApplicationIsolationJson(hostRoot: any, packageRoots: any): any;
-/**
- * host catalog consumption + cross-application Link resolution.
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @returns {string}
- */
-export declare function checkApplicationHostCompositionJson(hostRoot: any, packageRoots: any): any;
-/**
- * multi-session affected rebuild + MountTable proxy + mounted tests + deploy adapter.
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @param {string[]} [dirtyPaths]
- * @returns {string}
- */
-export declare function checkApplicationDevTestDeployJson(hostRoot: any, packageRoots: any, dirtyPaths?: any[]): any;
+export declare function queryProfileProtocolCatalog(): string;
+export declare function checkHostProfileProtocolJson(rootPath: string): string;
+export declare function checkProfileSolverJson(rootPath: string): string;
+export declare function checkUnifiedExecutorJson(rootPath: string): string;
+export declare function checkLifecycleRecoveryJson(rootPath: string): string;
+export declare function checkDeliveryProofJson(rootPath: string): string;
+export declare function checkCrossHostConformanceJson(rootPath: string): string;
+export declare function queryNativeHostProtocolCatalog(): string;
+export declare function checkNativeHostContractJson(rootPath: string): string;
+export declare function checkNativeShellContractJson(rootPath: string): string;
+export declare function checkNativeBridgeContractJson(rootPath: string): string;
+export declare function checkNativeLifecycleContractJson(rootPath: string): string;
+export declare function checkNativeFullstackContractJson(rootPath: string): string;
+export declare function checkNativeSurfaceContractJson(rootPath: string): string;
+export declare function checkMultiPlatformContractJson(rootPath: string): string;
+/** prove independent `/` + non-root ApplicationBase; scan non-relocatable URLs. */
+export declare function checkApplicationRelocatableJson(packageRoot: string, relocateBase?: string): string;
+/** apply ApplicationBase to a logical relocation manifest. */
+export declare function relocateApplicationManifestJson(manifestJson: string, base: string): string;
+/** independent ApplicationArtifact + MountTable/Catalog boundary (refs only). */
+export declare function checkApplicationArtifactBoundaryJson(hostRoot: string, packageRoots: string[]): string;
+/** absolute isolation namespaces + failure containment. */
+export declare function checkApplicationIsolationJson(hostRoot: string, packageRoots: string[]): string;
+/** host catalog consumption + cross-application Link resolution. */
+export declare function checkApplicationHostCompositionJson(hostRoot: string, packageRoots: string[]): string;
+/** multi-session affected rebuild + MountTable proxy + mounted tests + deploy adapter. */
+export declare function checkApplicationDevTestDeployJson(hostRoot: string, packageRoots: string[], dirtyPaths?: string[]): string;
 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 { runCli, printHelp, printGlobalHelp, printProjectHelp } from './cli.js';
+export { createCli, formatDiagnostic, formatDiagnostics, t } from './toolchain-dx.js';
+export type { LocalizePlugin } from './toolchain-dx.js';
+export { VMZ_CLI_CATALOG_EN_US, createVmzCliLocalize, flattenCatalog, loadCliCatalog, loadCliLocalesManifest, resolveCliLocalesRoot, resolveVmzLocale, translateCatalog, vmzCliLocalize, } from './toolchain-dx.js';
 export { findNearestProjectVmz, getInvocationContext, isGlobalAllowedCommand, isUnderNodeModules, resolveThisPackageRoot, resolveVmzBin, gateGlobalProjectCommand, } from './invocation.js';
 export { resolveWorkspaceDirs, findPackageJson, readPackageMeta } from './resolve.js';
 export { resolvePackageRoot, resolveWorkspacePackages } from './packages.js';
 export { log } from './log.js';
-export { cmdApplication, runCheck as runApplicationCheck } from './application-cmd.js';
-export { cmdArtifact } from './release-cmd.js';
+export { registerApplicationCommands, runCheck as runApplicationCheck } from './application-cmd.js';
+export { registerArtifactCommands, runArtifact } 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, rewriteCssImports, rewriteJsEntryRelativeImports, } from './content-addressed-assets.js';
@@ -245,7 +172,7 @@ declare const _default: {
     resolveNativePath: typeof resolveNativePath;
     resolveCoreRuntimeDist: typeof resolveCoreRuntimeDist;
     materializeServeHostRuntime: typeof materializeServeHostRuntime;
-    SERVE_HOST_RUNTIME_FILES: string[][];
+    SERVE_HOST_RUNTIME_FILES: readonly (readonly [string, string])[];
     loadNative: typeof loadNative;
     getProtocolVersions: typeof getProtocolVersions;
     handshake: typeof handshake;