@bleedingdev/modern-js-create 3.5.0-ultramodern.3 → 3.5.0-ultramodern.31

package/dist/esm-node/ultramodern-workspace/write-app.js

@@ -0,0 +1,91 @@
+import "node:module";
+import { createApiClient, createApiServiceEntry, createBackendEffectApiExpose, createSharedApi, createShellApiClient } from "./api.js";
+import { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createPostcssConfig, createShellFrameComponent, createTailwindConfig } from "./app-files.js";
+import { createBackendFederationContractFile } from "./backend-federation.js";
+import { createLayout, createRemoteEntry, createRemoteExposeComponent, createRemotePage, createShellPage, createShellRemoteComponents, remoteComponentOutputPath } from "./demo-components.js";
+import { appHasApi, appI18nNamespace, createShellHost } from "./descriptors.js";
+import { writeFile, writeJson } from "./fs-io.js";
+import { createAppPublicLocaleMessages } from "./locales.js";
+import { createAppModernConfig, createBackendModuleFederationConfig, createRemoteModuleFederationConfig, createShellModuleFederationConfig, createUltramodernBuildArtifactJson, createUltramodernBuildModule, createUltramodernBuildReexportModule } from "./module-federation.js";
+import { createAppMfTypesTsConfig, createAppPackage, createAppTsConfig } from "./package-json.js";
+import { createPublicWebAppArtifacts } from "./public-surface.js";
+function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = [], bridge) {
+    const resolvedApp = 'shell' === app.kind ? createShellHost(remotes) : app;
+    const publicWeb = createPublicWebAppArtifacts(resolvedApp);
+    const writeAppFile = (relativePath, content)=>{
+        writeFile(targetDir, `${resolvedApp.directory}/${relativePath}`, content);
+    };
+    const context = {
+        targetDir,
+        scope,
+        resolvedApp,
+        packageSource,
+        enableTailwind,
+        remotes,
+        bridge,
+        publicWeb,
+        writeAppFile
+    };
+    writeAppConfigFiles(context);
+    writeAppLocaleAndStyleFiles(context);
+    writeAppFederationConfigFiles(context);
+    writeAppRouteAndShellFiles(context);
+    writeAppApiAndRemoteExposeFiles(context);
+}
+function writeAppConfigFiles({ targetDir, scope, resolvedApp, packageSource, enableTailwind, remotes, bridge, publicWeb }) {
+    writeJson(targetDir, `${resolvedApp.directory}/package.json`, createAppPackage(scope, resolvedApp, packageSource, enableTailwind, remotes, bridge));
+    writeJson(targetDir, `${resolvedApp.directory}/tsconfig.json`, createAppTsConfig(resolvedApp, remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/tsconfig.mf-types.json`, createAppMfTypesTsConfig(resolvedApp));
+    writeFile(targetDir, `${resolvedApp.directory}/src/modern-app-env.d.ts`, createAppEnvDts(resolvedApp, remotes));
+    writeFile(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, createUltramodernBuildReexportModule());
+    writeFile(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.ts`, createUltramodernBuildModule());
+    writeFile(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.json`, createUltramodernBuildArtifactJson(scope, resolvedApp));
+    writeFile(targetDir, publicWeb.jsonLdHelperFile.path, publicWeb.jsonLdHelperFile.content);
+    writeFile(targetDir, publicWeb.routeMetadataFile.path, publicWeb.routeMetadataFile.content);
+    writeFile(targetDir, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
+    writeFile(targetDir, `${resolvedApp.directory}/modern.config.ts`, createAppModernConfig(scope, resolvedApp, remotes));
+    writeFile(targetDir, `${resolvedApp.directory}/src/modern.runtime.ts`, createAppRuntimeConfig(resolvedApp, scope, remotes));
+}
+function writeAppLocaleAndStyleFiles({ targetDir, scope, resolvedApp, enableTailwind, remotes }) {
+    writeJson(targetDir, `${resolvedApp.directory}/locales/en/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/en/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
+    writeFile(targetDir, `${resolvedApp.directory}/src/routes/index.css`, createAppStyles(enableTailwind, scope, resolvedApp));
+    if (enableTailwind) {
+        writeFile(targetDir, `${resolvedApp.directory}/postcss.config.mjs`, createPostcssConfig());
+        writeFile(targetDir, `${resolvedApp.directory}/tailwind.config.ts`, createTailwindConfig());
+    }
+}
+function writeAppFederationConfigFiles({ targetDir, scope, resolvedApp, remotes }) {
+    writeFile(targetDir, `${resolvedApp.directory}/module-federation.config.ts`, 'shell' === resolvedApp.kind ? createShellModuleFederationConfig(scope, remotes) : createRemoteModuleFederationConfig(scope, resolvedApp, remotes));
+    if (appHasApi(resolvedApp)) writeFile(targetDir, `${resolvedApp.directory}/backend-federation.config.ts`, createBackendModuleFederationConfig(resolvedApp));
+}
+function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, remotes, publicWeb, writeAppFile }) {
+    writeAppFile('src/routes/layout.tsx', createLayout(resolvedApp.id));
+    writeAppFile('src/routes/[lang]/page.tsx', 'shell' === resolvedApp.kind ? createShellPage(remotes) : createRemotePage(resolvedApp));
+    for (const generatedFile of publicWeb.routeMetaFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
+    for (const generatedFile of publicWeb.routeAliasFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
+    if ('shell' === resolvedApp.kind) {
+        writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(scope, remotes));
+        writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent());
+        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellApiClient(scope, remotes));
+    }
+}
+function writeAppApiAndRemoteExposeFiles({ targetDir, scope, resolvedApp, writeAppFile }) {
+    if (appHasApi(resolvedApp)) {
+        writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createSharedApi(resolvedApp));
+        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createApiServiceEntry(resolvedApp, '../shared/api.ts'));
+        writeFile(targetDir, `${resolvedApp.directory}/api/backend-federation.ts`, createBackendFederationContractFile(resolvedApp));
+        writeFile(targetDir, `${resolvedApp.directory}/api/effect-api.ts`, createBackendEffectApiExpose(scope, resolvedApp));
+        writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, createApiClient(resolvedApp, '../../shared/api'));
+    }
+    if ('vertical' === resolvedApp.kind) {
+        writeAppFile('src/federation-entry.tsx', createRemoteEntry(resolvedApp));
+        for (const expose of Object.keys(resolvedApp.exposes ?? {})){
+            const outputPath = remoteComponentOutputPath(resolvedApp, expose);
+            if (outputPath) writeAppFile(outputPath.slice(resolvedApp.directory.length + 1), createRemoteExposeComponent(resolvedApp, expose));
+        }
+    }
+}
+export { writeApp };

package/dist/esm-node/ultramodern-workspace/write-workspace.js

@@ -1,71 +1,19 @@
 import "node:module";
 import node_fs from "node:fs";
-import { createApiClient, createApiServiceEntry, createSharedApi, createShellApiClient } from "./api.js";
-import { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createPostcssConfig, createSharedDesignTokensCss, createShellFrameComponent, createTailwindConfig } from "./app-files.js";
+import { createSharedDesignTokensCss } from "./app-files.js";
 import { normalizeUltramodernBridgeConfig } from "./bridge-config.js";
 import { createDevelopmentOverlay, createOwnership, createTopology, createUltramodernConfig } from "./contracts.js";
-import { createLayout, createRemoteEntry, createRemoteExposeComponent, createRemotePage, createShellPage, createShellRemoteComponents, remoteComponentOutputPath } from "./demo-components.js";
-import { ULTRAMODERN_CONFIG_PATH, appHasApi, appI18nNamespace, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
+import { ULTRAMODERN_CONFIG_PATH, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
 import { copyRootTemplate, formatGeneratedWorkspaceFiles, writeFile, writeFileReplacing, writeJson } from "./fs-io.js";
 import { createFileSnapshot, createGenerationResult, diffFileSnapshots } from "./generation-result.js";
-import { createAppPublicLocaleMessages } from "./locales.js";
-import { createAppModernConfig, createRemoteModuleFederationConfig, createShellModuleFederationConfig, createUltramodernBuildModule, createUltramodernBuildReexportModule } from "./module-federation.js";
 import { assertUniqueTailwindPrefixes, toPackageScope } from "./naming.js";
 import { runCodeSmithOverlays } from "./overlays.js";
-import { createAppMfTypesTsConfig, createAppPackage, createAppTsConfig, createRootPackageJson, createRootTsConfig, createSharedContractsIndex, createSharedPackage, createSharedPackageTsConfig, createTsConfigBase } from "./package-json.js";
+import { createRootPackageJson, createRootTsConfig, createSharedContractsIndex, createSharedPackage, createSharedPackageTsConfig, createTsConfigBase } from "./package-json.js";
 import { resolvePackageSource } from "./package-source.js";
-import { createPublicWebAppArtifacts } from "./public-surface.js";
-import { EFFECT_VERSION, EFFECT_VITEST_VERSION, NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION } from "./versions.js";
+import { DRIZZLE_ORM_VERSION, EFFECT_VERSION, EFFECT_VITEST_VERSION, MODULE_FEDERATION_VERSION, NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION } from "./versions.js";
 import { writeGeneratedWorkspaceScripts } from "./workspace-scripts.js";
-function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = [], bridge) {
-    const resolvedApp = 'shell' === app.kind ? createShellHost(remotes) : app;
-    const publicWeb = createPublicWebAppArtifacts(resolvedApp);
-    const writeAppFile = (relativePath, content)=>{
-        writeFile(targetDir, `${resolvedApp.directory}/${relativePath}`, content);
-    };
-    writeJson(targetDir, `${resolvedApp.directory}/package.json`, createAppPackage(scope, resolvedApp, packageSource, enableTailwind, remotes, bridge));
-    writeJson(targetDir, `${resolvedApp.directory}/tsconfig.json`, createAppTsConfig(resolvedApp, remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/tsconfig.mf-types.json`, createAppMfTypesTsConfig(resolvedApp));
-    writeFile(targetDir, `${resolvedApp.directory}/src/modern-app-env.d.ts`, createAppEnvDts(resolvedApp, remotes));
-    writeFile(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, createUltramodernBuildReexportModule());
-    writeFile(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.ts`, createUltramodernBuildModule(scope, resolvedApp));
-    writeFile(targetDir, publicWeb.jsonLdHelperFile.path, publicWeb.jsonLdHelperFile.content);
-    writeFile(targetDir, publicWeb.routeMetadataFile.path, publicWeb.routeMetadataFile.content);
-    writeFile(targetDir, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
-    writeFile(targetDir, `${resolvedApp.directory}/modern.config.ts`, createAppModernConfig(scope, resolvedApp));
-    writeFile(targetDir, `${resolvedApp.directory}/src/modern.runtime.ts`, createAppRuntimeConfig(resolvedApp, scope, remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/locales/en/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/locales/en/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
-    writeFile(targetDir, `${resolvedApp.directory}/src/routes/index.css`, createAppStyles(enableTailwind, scope, resolvedApp));
-    if (enableTailwind) {
-        writeFile(targetDir, `${resolvedApp.directory}/postcss.config.mjs`, createPostcssConfig());
-        writeFile(targetDir, `${resolvedApp.directory}/tailwind.config.ts`, createTailwindConfig());
-    }
-    writeFile(targetDir, `${resolvedApp.directory}/module-federation.config.ts`, 'shell' === resolvedApp.kind ? createShellModuleFederationConfig(scope, remotes) : createRemoteModuleFederationConfig(scope, resolvedApp, remotes));
-    writeAppFile('src/routes/layout.tsx', createLayout(resolvedApp.id));
-    writeAppFile('src/routes/[lang]/page.tsx', 'shell' === resolvedApp.kind ? createShellPage(remotes) : createRemotePage(resolvedApp));
-    for (const generatedFile of publicWeb.routeMetaFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
-    for (const generatedFile of publicWeb.routeAliasFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
-    if ('shell' === resolvedApp.kind) {
-        writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(scope, remotes));
-        writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent());
-        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellApiClient(scope, remotes));
-    }
-    if (appHasApi(resolvedApp)) {
-        writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createSharedApi(resolvedApp));
-        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createApiServiceEntry(resolvedApp, '../shared/api.ts'));
-        writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, createApiClient(resolvedApp, '../../shared/api'));
-    }
-    if ('vertical' === resolvedApp.kind) {
-        writeAppFile('src/federation-entry.tsx', createRemoteEntry(resolvedApp));
-        for (const expose of Object.keys(resolvedApp.exposes ?? {})){
-            const outputPath = remoteComponentOutputPath(resolvedApp, expose);
-            if (outputPath) writeAppFile(outputPath.slice(resolvedApp.directory.length + 1), createRemoteExposeComponent(resolvedApp, expose));
-        }
-    }
-}
+import { writeApp } from "./write-app.js";
+import { createZeropsYaml } from "./zerops.js";
 function writeSharedPackages(targetDir, scope) {
     for (const sharedPackage of sharedPackages){
         writeJson(targetDir, `${sharedPackage.directory}/package.json`, createSharedPackage(scope, sharedPackage.id, sharedPackage.description));
@@ -105,7 +53,7 @@ function writePnpmWorkspacePackages(targetDir, bridge) {
         ...bridge.workspacePackages.map((entry)=>entry.pattern)
     ];
     const renderedPackages = packages.map((pattern)=>`  - ${pattern}`).join('\n');
-    writeFileReplacing(targetDir, 'pnpm-workspace.yaml', pnpmWorkspace.replace(/^packages:\n(?: {2}- .+\n)+/u, `packages:\n${renderedPackages}\n`));
+    writeFileReplacing(targetDir, 'pnpm-workspace.yaml', pnpmWorkspace.replace(/^packages:\r?\n(?: {2}- .+\r?\n)+/u, `packages:\n${renderedPackages}\n`));
 }
 function generateUltramodernWorkspace(options) {
     const beforeFiles = createFileSnapshot(options.targetDir);
@@ -131,8 +79,10 @@ function generateUltramodernWorkspace(options) {
         nodeVersion: NODE_VERSION,
         pnpmVersion: PNPM_VERSION,
         nodeFetchVersion: NODE_FETCH_VERSION,
+        drizzleOrmVersion: DRIZZLE_ORM_VERSION,
         effectVersion: EFFECT_VERSION,
         effectVitestVersion: EFFECT_VITEST_VERSION,
+        moduleFederationVersion: MODULE_FEDERATION_VERSION,
         tanstackRouterCoreVersion: TANSTACK_ROUTER_CORE_VERSION,
         tanstackRouterVersion: TANSTACK_ROUTER_VERSION,
         typescriptVersion: TYPESCRIPT_VERSION,
@@ -140,11 +90,12 @@ function generateUltramodernWorkspace(options) {
     });
     writePnpmWorkspacePackages(options.targetDir, bridge);
     writeJson(options.targetDir, 'package.json', createCompactRootPackageJson(scope, packageSource, initialVerticals, bridge));
+    writeFile(options.targetDir, 'zerops.yaml', `${createZeropsYaml(scope, createdApps)}\n`);
     writeJson(options.targetDir, 'tsconfig.base.json', createTsConfigBase());
     writeJson(options.targetDir, 'tsconfig.json', createRootTsConfig(createdApps));
     writeJson(options.targetDir, 'topology/reference-topology.json', createTopology(scope, initialVerticals));
     writeJson(options.targetDir, 'topology/ownership.json', createOwnership(scope, initialVerticals));
-    writeJson(options.targetDir, 'topology/local-overlays/development.json', createDevelopmentOverlay(initialVerticals));
+    writeJson(options.targetDir, 'topology/local-overlays/development.json', createDevelopmentOverlay(scope, initialVerticals));
     writeJson(options.targetDir, ULTRAMODERN_CONFIG_PATH, createCompactUltramodernConfig(scope, options.modernVersion, packageSource, createdApps, enableTailwind, bridge));
     writeApp(options.targetDir, scope, shellApp, packageSource, enableTailwind, initialVerticals, bridge);
     for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);

package/dist/esm-node/ultramodern-workspace/zerops.js

@@ -0,0 +1,66 @@
+import "node:module";
+import { appHasApi, resolveApiPrefix, resolveApiStem } from "./descriptors.js";
+import { packageName } from "./naming.js";
+import { NODE_VERSION } from "./versions.js";
+const zeropsNodeRuntime = `nodejs@${NODE_VERSION.split('.')[0]}`;
+function quoteYamlString(value) {
+    return `'${value.replace(/'/gu, "''")}'`;
+}
+function quoteShellValue(value) {
+    return `'${value.replace(/'/gu, "'\\''")}'`;
+}
+function readinessPath(app) {
+    if (!appHasApi(app)) return '/';
+    return `${resolveApiPrefix(app)}/${resolveApiStem(app)}/readiness`;
+}
+function createZeropsService(scope, app) {
+    const runtimeDirectory = `.zerops/runtime/${app.id}`;
+    const appPackageName = packageName(scope, app.packageSuffix);
+    const commands = [
+        'curl https://mise.run | sh',
+        '~/.local/bin/mise install',
+        '~/.local/bin/mise exec -- pnpm install --frozen-lockfile',
+        `~/.local/bin/mise exec -- pnpm --filter ${quoteShellValue(appPackageName)} run build`,
+        `~/.local/bin/mise exec -- pnpm run zerops:materialize -- --app ${quoteShellValue(app.id)} --package ${quoteShellValue(appPackageName)} --package-dir ${quoteShellValue(app.directory)}`,
+        `cp ${quoteShellValue('topology/reference-topology.json')} ${quoteShellValue(`${runtimeDirectory}/topology.json`)}`,
+        `cp ${quoteShellValue('topology/local-overlays/development.json')} ${quoteShellValue(`${runtimeDirectory}/local-overlay.json`)}`
+    ];
+    return [
+        `  - setup: ${quoteYamlString(app.id)}`,
+        '    build:',
+        `      base: ${quoteYamlString(zeropsNodeRuntime)}`,
+        '      buildCommands:',
+        '        - |',
+        ...commands.map((command)=>`          ${command}`),
+        '      deployFiles:',
+        `        - ${quoteYamlString(runtimeDirectory)}`,
+        '    deploy:',
+        '      temporaryShutdown: false',
+        '      readinessCheck:',
+        '        httpGet:',
+        `          port: ${app.port}`,
+        `          path: ${quoteYamlString(readinessPath(app))}`,
+        '        failureTimeout: 120',
+        '        retryPeriod: 10',
+        '    run:',
+        `      base: ${quoteYamlString(zeropsNodeRuntime)}`,
+        '      ports:',
+        `        - port: ${app.port}`,
+        '          protocol: TCP',
+        '          httpSupport: true',
+        '      envVariables:',
+        '        NODE_ENV: production',
+        `        ${app.portEnv}: ${quoteYamlString(String(app.port))}`,
+        `        ULTRAMODERN_ZEROPS_SERVICE: ${quoteYamlString(app.id)}`,
+        `      start: cd ${quoteShellValue(runtimeDirectory)} && npm run serve`
+    ].join('\n');
+}
+function createZeropsYaml(scope, apps) {
+    return [
+        '# Generated by Modern.js UltraModern workspace tooling.',
+        '# Zerops runs each full-stack MicroVertical as a package-owned Node service.',
+        'zerops:',
+        ...apps.map((app)=>createZeropsService(scope, app))
+    ].join('\n\n');
+}
+export { createZeropsYaml };

package/dist/types/cli/flags.d.ts

@@ -0,0 +1,30 @@
+export declare const LEGACY_MODERN_JS_FLAG = "--legacy-modern-js";
+export declare const LEGACY_MODERN_JS_CONFIRMATION = "USE LEGACY MODERN.JS";
+export declare const WORKSPACE_PROTOCOL_FLAG = "--workspace";
+export declare const DRY_RUN_FLAG = "--dry-run";
+export declare const VERTICAL_FLAG = "--vertical";
+export declare const VERTICAL_NAME_FLAG = "--vertical-name";
+export declare const CODESMITH_OVERLAY_FLAG = "--codesmith-overlay";
+export declare const BFF_FLAG = "--bff";
+export declare const BFF_RUNTIME_OPTION = "--bff-runtime";
+export declare const SUPPORTED_BFF_RUNTIMES: readonly ['effect'];
+export type SupportedBffRuntime = (typeof SUPPORTED_BFF_RUNTIMES)[number];
+export declare function getOptionValue(args: string[], names: string[]): string | undefined;
+export declare const detectLanguage: () => 'zh' | 'en';
+export declare function detectLegacyModernJsFlag(args: string[]): boolean;
+export declare function detectBffRuntime(args: string[]): SupportedBffRuntime;
+export declare function detectTailwindFlag(): boolean;
+export declare function detectExplicitTailwindFlag(): boolean | undefined;
+export type VerticalCliInput = {
+    addVertical: false;
+} | {
+    addVertical: true;
+    name: string;
+};
+export declare function collectPositionalArgs(args: string[]): string[];
+export declare function resolveVerticalCliInput(args: string[]): VerticalCliInput;
+export declare function detectDryRunFlag(args: string[]): boolean;
+export declare function detectCodeSmithOverlays(args: string[]): {
+    generator: string;
+}[] | undefined;
+export declare function readBridgeCliOptions(args: string[]): import("../ultramodern-workspace").UltramodernBridgeConfig | undefined;

package/dist/types/cli/help.d.ts

@@ -0,0 +1,2 @@
+export declare function showVersion(): void;
+export declare function showHelp(): void;

package/dist/types/cli/package-source.d.ts

@@ -0,0 +1,15 @@
+import { type ResolvedUltramodernPackageSource } from '../ultramodern-package-source';
+export type UltramodernPackageSource = ResolvedUltramodernPackageSource;
+export type CreatePackageJson = {
+    name?: string;
+    version?: string;
+    ultramodern?: {
+        frameworkVersion?: string;
+    };
+};
+export declare function readCreatePackageJson(): CreatePackageJson;
+export declare function isBleedingDevCreatePackage(createPackage: CreatePackageJson): boolean;
+export declare function getBleedingDevFrameworkVersion(createPackage: CreatePackageJson, fallbackVersion: string): string;
+export declare function detectUltramodernPackageSource(args: string[], defaultPackageVersion: string, createPackage: CreatePackageJson): UltramodernPackageSource;
+export declare function resolveInstallBackedPackageSource(args: string[], createPackage: CreatePackageJson, packageSource: UltramodernPackageSource): UltramodernPackageSource;
+export declare function resolveWorkspacePackageSource(args: string[], createPackage: CreatePackageJson, packageSource: UltramodernPackageSource): UltramodernPackageSource;

package/dist/types/cli/project-setup.d.ts

@@ -0,0 +1,8 @@
+export declare function runSetupCommand(command: string, args: string[], options?: {
+    cwd?: string;
+    stdio?: 'ignore' | 'inherit';
+    timeoutMs?: number;
+}): any;
+export declare function commandExists(command: string): boolean;
+export declare function initializeGeneratedGitRepository(targetDir: string): void;
+export declare function isDirectoryEmpty(dirPath: string): boolean;

package/dist/types/cli/prompts.d.ts

@@ -0,0 +1,6 @@
+export declare function promptInput(question: string): Promise<string>;
+export declare function confirmLegacyModernJsSetup(): Promise<void>;
+export declare function getProjectName(): Promise<{
+    name: string;
+    useCurrentDir: boolean;
+}>;

package/dist/types/ultramodern-tooling/commands/cloudflare-output-verify.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext } from './context';
+export declare function runCloudflareOutputVerify(args: string[], context: CommandContext): any;

package/dist/types/ultramodern-tooling/commands/context.d.ts

@@ -0,0 +1,11 @@
+export declare const createPackageRoot: string;
+export type CommandContext = {
+    workspaceRoot: string;
+    invocationCwd: string;
+};
+export declare function printHelp(): void;
+export declare function spawnNodeScript(relativeScriptPath: string, args: string[], context: CommandContext, options?: {
+    cwd?: string;
+}): any;
+export declare function runTemplateBackedToolingCommand(command: string, args: string[], context: CommandContext): any;
+export declare function runRenderedModule(source: string, context: CommandContext): any;

package/dist/types/ultramodern-tooling/commands/mf-types.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from './context';
+export declare function runMfTypes(args: string[], context: CommandContext): number;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/api-metadata.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedUltramodernPackageSource } from '../../../ultramodern-package-source';
+import { type MigrationIo } from './io';
+export declare function updateUltramodernConfig(io: MigrationIo, config: Record<string, any>, packageSource: ResolvedUltramodernPackageSource): void;
+export declare function updateReferenceTopology(io: MigrationIo): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/declaration-patches.d.ts

@@ -0,0 +1,4 @@
+import type { MigrationIo } from './io';
+export declare function ensureGeneratedDeclarationPatches(io: MigrationIo, options: {
+    includeDrizzleOrmPatch: boolean;
+}): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/dependency-usage.d.ts

@@ -0,0 +1 @@
+export declare function workspaceUsesDependency(workspaceRoot: string, packageName: string): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-backend-federation.d.ts

@@ -0,0 +1,3 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function updateGeneratedBackendFederationContractFiles(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-build-identity.d.ts

@@ -0,0 +1,3 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function updateGeneratedBuildIdentityModules(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-modern-configs.d.ts

@@ -0,0 +1,3 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function updateGeneratedModernConfigs(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-oxfmt.d.ts

@@ -0,0 +1,2 @@
+import { type MigrationIo } from './io';
+export declare function ensureGeneratedOxfmtIgnorePatterns(io: MigrationIo): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-removal.d.ts

@@ -0,0 +1,4 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function removeGeneratedFileIfExists(io: MigrationIo, relativePath: string): boolean;
+export declare function removeStaleBackendFederationArtifacts(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-typescript.d.ts

@@ -0,0 +1,3 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function updateGeneratedTypeScriptSurfaces(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts-zerops.d.ts

@@ -0,0 +1,3 @@
+import { type UltramodernToolingConfig } from '../../config';
+import { type MigrationIo } from './io';
+export declare function updateGeneratedZeropsArtifacts(io: MigrationIo, config: UltramodernToolingConfig): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-artifacts.d.ts

@@ -0,0 +1,7 @@
+export { updateGeneratedBackendFederationContractFiles } from './generated-artifacts-backend-federation';
+export { updateGeneratedBuildIdentityModules } from './generated-artifacts-build-identity';
+export { updateGeneratedModernConfigs } from './generated-artifacts-modern-configs';
+export { ensureGeneratedOxfmtIgnorePatterns } from './generated-artifacts-oxfmt';
+export { removeGeneratedFileIfExists, removeStaleBackendFederationArtifacts, } from './generated-artifacts-removal';
+export { updateGeneratedTypeScriptSurfaces } from './generated-artifacts-typescript';
+export { updateGeneratedZeropsArtifacts } from './generated-artifacts-zerops';

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/generated-patches.d.ts

@@ -0,0 +1,3 @@
+import type { MigrationIo } from './io';
+export declare function ensureGeneratedPatchFile(io: MigrationIo, relativePatchPath: string, sourcePatchPath: string): boolean;
+export declare function removeGeneratedPatchFileIfUnchanged(io: MigrationIo, relativePatchPath: string, sourcePatchPath: string): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/help.d.ts

@@ -0,0 +1 @@
+export declare const migrateStrictEffectHelp = "Usage:\n  modern-js-create ultramodern migrate-strict-effect --version <version> [--dry-run] [--skip-install]\n\nUpdates generated UltraModern package-source metadata, Modern package aliases,\nframework-owned toolchain pins, direct Effect API topology metadata, strict\nEffect pnpm overrides/trust policy, framework-owned TypeScript config\nsurfaces, and the pnpm lockfile. Source code still has to pass pnpm api:check\nand pnpm contract:check.\n\nWhen the compact config is absent but legacy UltraModern 3.2 metadata is\npresent, the compact config is synthesized from it first. Shell-only\nworkspaces skip the backend-federation and Zerops runtime stages. Pass\n--dry-run to print the planned filesystem changes without writing anything\n(implies --skip-install).\n";

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/install.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from '../context';
+export declare function runPnpmLockfileRefresh(context: CommandContext): any;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/io.d.ts

@@ -0,0 +1,14 @@
+export type MigrationIo = {
+    workspaceRoot: string;
+    dryRun: boolean;
+    plan: string[];
+    write(filePath: string, content: string): boolean;
+    remove(filePath: string): boolean;
+    log(message: string): void;
+};
+export declare function createMigrationIo(workspaceRoot: string, dryRun: boolean): MigrationIo;
+export declare function readJsonFile(filePath: string): any;
+export declare function writeJsonFile(io: MigrationIo, filePath: string, value: unknown): boolean;
+export declare function writeJsonIfChanged(io: MigrationIo, filePath: string, value: unknown): boolean;
+export declare function writeTextIfChanged(io: MigrationIo, filePath: string, value: string): boolean;
+export declare function listWorkspacePackageFiles(workspaceRoot: string): string[];

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/package-cohort.d.ts

@@ -0,0 +1,9 @@
+import { type ResolvedUltramodernPackageSource } from '../../../ultramodern-package-source';
+import type { WorkspaceApp } from '../../../ultramodern-workspace/types';
+export declare function updateModernDependencies(packageJson: Record<string, any>, packageSource: ResolvedUltramodernPackageSource): boolean;
+export declare function updateGeneratedToolingDependencies(packageJson: Record<string, any>): boolean;
+export declare function updateGeneratedPackageScripts(packageJson: Record<string, any>, options?: {
+    relativePackageFile?: string;
+    apps?: WorkspaceApp[];
+    shellOnly?: boolean;
+}): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/package-source.d.ts

@@ -0,0 +1,3 @@
+import { type ResolvedUltramodernPackageSource } from '../../../ultramodern-package-source';
+import { readUltramodernConfig } from '../../config';
+export declare function createMigrationPackageSource(args: string[], current: ReturnType<typeof readUltramodernConfig>): ResolvedUltramodernPackageSource;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/pnpm-policy.d.ts

@@ -0,0 +1,4 @@
+import type { MigrationIo } from './io';
+export { ensureGeneratedDeclarationPatches } from './declaration-patches';
+export { workspaceUsesDependency } from './dependency-usage';
+export declare function updateGeneratedPnpmWorkspacePolicy(io: MigrationIo): boolean;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/pnpm-yaml.d.ts

@@ -0,0 +1,25 @@
+export declare function replaceYamlLine(source: string, pattern: RegExp, replacement: string): {
+    source: string;
+    changed: boolean;
+};
+export declare function ensureYamlListItem(source: string, key: string, item: string): {
+    source: string;
+    changed: boolean;
+};
+export declare function yamlEntryPattern(entryKey: string, scalar?: boolean): RegExp;
+export declare function upsertYamlEntry(source: string, key: string, entryLine: string, pattern: RegExp): {
+    source: string;
+    changed: boolean;
+};
+export declare function ensureYamlMapEntry(source: string, key: string, entryKey: string, value: string): {
+    source: string;
+    changed: boolean;
+};
+export declare function ensureYamlScalarMapEntry(source: string, key: string, entryKey: string, value: string): {
+    source: string;
+    changed: boolean;
+};
+export declare function removeYamlMapEntry(source: string, entryKey: string): {
+    source: string;
+    changed: boolean;
+};

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect/policy-constants.d.ts

@@ -0,0 +1,9 @@
+export declare const strictEffectPackageVersionPolicyExclusions: string[];
+export declare const moduleFederationModernJsPatchPath = "patches/@module-federation__modern-js-v3@2.6.0.patch";
+export declare const moduleFederationModernJsPatchSourcePath: any;
+export declare const moduleFederationBridgeReactPatchPath = "patches/@module-federation__bridge-react@2.6.0.patch";
+export declare const moduleFederationBridgeReactPatchSourcePath: any;
+export declare const effectDeclarationPatchPath = "patches/effect-schema-error-type-id.patch";
+export declare const effectDeclarationPatchSourcePath: any;
+export declare const drizzleOrmDeclarationPatchPath = "patches/drizzle-orm-ts7-strict-declarations.patch";
+export declare const drizzleOrmDeclarationPatchSourcePath: any;

package/dist/types/ultramodern-tooling/commands/migrate-strict-effect.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from './context';
+export declare function runMigrateStrictEffect(args: string[], context: CommandContext): any;

package/dist/types/ultramodern-tooling/commands/options.d.ts

@@ -0,0 +1,2 @@
+export declare function readOption(args: string[], name: string): string | undefined;
+export declare function hasFlag(args: string[], name: string): boolean;

package/dist/types/ultramodern-tooling/commands/routes-generate.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext } from './context';
+export declare function runRoutesGenerate(args: string[], context: CommandContext): any;

package/dist/types/ultramodern-tooling/commands/skills.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext } from './context';
+export declare function runSkills(args: string[], context: CommandContext): any;

package/dist/types/ultramodern-tooling/commands/sync-delivery-unit.d.ts

@@ -0,0 +1 @@
+export { runSyncDeliveryUnit } from '../../ultramodern-workspace/delivery-unit-sync';

package/dist/types/ultramodern-tooling/commands/validate.d.ts

@@ -0,0 +1,2 @@
+import { type CommandContext } from './context';
+export declare function runValidate(context: CommandContext): any;

package/dist/types/ultramodern-tooling/config/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const LEGACY_GENERATED_CONTRACT_PATH = ".modernjs/ultramodern-generated-contract.json";
+export declare const LEGACY_PACKAGE_SOURCE_METADATA_PATH = ".modernjs/ultramodern-package-source.json";
+export declare const LEGACY_DEVELOPMENT_OVERLAY_PATH = "topology/local-overlays/development.json";

package/dist/types/ultramodern-tooling/config/index.d.ts

@@ -0,0 +1,7 @@
+export * from './constants';
+export * from './json';
+export * from './load';
+export * from './metadata';
+export * from './normalize';
+export * from './synthesize';
+export * from './types';

package/dist/types/ultramodern-tooling/config/json.d.ts

@@ -0,0 +1,2 @@
+export declare function readJsonObject(filePath: string): Record<string, any>;
+export declare function readOptionalJsonObject(filePath: string): Record<string, any>;

package/dist/types/ultramodern-tooling/config/load.d.ts

@@ -0,0 +1,2 @@
+import type { UltramodernToolingConfig } from './types';
+export declare function readUltramodernConfig(workspaceRoot?: any): UltramodernToolingConfig;

package/dist/types/ultramodern-tooling/config/metadata.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedPackageSource } from '../../ultramodern-workspace/types';
+export declare function packageScopeFromRoot(workspaceRoot: string): string;
+export declare function packageSourceFromMetadata(workspaceRoot: string): ResolvedPackageSource | undefined;
+export declare function readOverlayPorts(workspaceRoot: string): Record<string, number>;

package/dist/types/ultramodern-tooling/config/normalize.d.ts

@@ -0,0 +1,5 @@
+import type { WorkspaceApp } from '../../ultramodern-workspace/types';
+import type { UltramodernToolingConfig } from './types';
+export declare function normalizeCompactConfig(workspaceRoot: string, sourcePath: string, config: Record<string, any>): UltramodernToolingConfig;
+export declare function normalizeCompactUltramodernConfig(workspaceRoot: string, compact: Record<string, any>): UltramodernToolingConfig;
+export declare function workspaceAppsFromToolingConfig(config: UltramodernToolingConfig): WorkspaceApp[];

package/dist/types/ultramodern-tooling/config/synthesize.d.ts

@@ -0,0 +1,5 @@
+export declare function synthesizeCompactUltramodernConfig(workspaceRoot: string): {
+    compact: Record<string, any>;
+    missing: string[];
+    sources: string[];
+} | undefined;