@bleedingdev/modern-js-create 3.5.0-ultramodern.9 → 3.5.0-ultramodern.90

package/dist/cjs/ultramodern-workspace/add-vertical.cjs

@@ -1,14 +1,5 @@
 "use strict";
 var __webpack_require__ = {};
-(()=>{
-    __webpack_require__.n = (module)=>{
-        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
-        __webpack_require__.d(getter, {
-            a: getter
-        });
-        return getter;
-    };
-})();
 (()=>{
     __webpack_require__.d = (exports1, getters, values)=>{
         var define = (defs, kind)=>{
@@ -37,569 +28,29 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    addShellWorkspaceDependency: ()=>addShellWorkspaceDependency,
-    addShellZephyrDependency: ()=>addShellZephyrDependency,
-    addUltramodernVertical: ()=>addUltramodernVertical,
-    assertCanCreate: ()=>assertCanCreate,
-    assertValidVerticalName: ()=>assertValidVerticalName,
-    existingBridgeConfig: ()=>existingBridgeConfig,
-    existingPackageSource: ()=>existingPackageSource,
-    existingTailwindEnabled: ()=>existingTailwindEnabled,
-    nextAvailablePort: ()=>nextAvailablePort,
-    ownershipEntry: ()=>ownershipEntry,
-    planUltramodernVertical: ()=>planUltramodernVertical,
-    prepareAddUltramodernVertical: ()=>prepareAddUltramodernVertical,
-    rewriteShellAppFiles: ()=>rewriteShellAppFiles,
-    updateRootWorkspaceScripts: ()=>updateRootWorkspaceScripts,
-    verticalTopologyEntry: ()=>verticalTopologyEntry,
-    verticalsFromTopology: ()=>verticalsFromTopology
+    addShellWorkspaceDependency: ()=>shell_files_cjs_namespaceObject.addShellWorkspaceDependency,
+    addShellZephyrDependency: ()=>shell_files_cjs_namespaceObject.addShellZephyrDependency,
+    addUltramodernVertical: ()=>execute_cjs_namespaceObject.addUltramodernVertical,
+    assertCanCreate: ()=>workspace_state_cjs_namespaceObject.assertCanCreate,
+    assertValidVerticalName: ()=>workspace_state_cjs_namespaceObject.assertValidVerticalName,
+    existingBridgeConfig: ()=>workspace_state_cjs_namespaceObject.existingBridgeConfig,
+    existingPackageSource: ()=>workspace_state_cjs_namespaceObject.existingPackageSource,
+    existingTailwindEnabled: ()=>workspace_state_cjs_namespaceObject.existingTailwindEnabled,
+    nextAvailablePort: ()=>workspace_state_cjs_namespaceObject.nextAvailablePort,
+    ownershipEntry: ()=>topology_cjs_namespaceObject.ownershipEntry,
+    planUltramodernVertical: ()=>plan_cjs_namespaceObject.planUltramodernVertical,
+    prepareAddUltramodernVertical: ()=>preflight_cjs_namespaceObject.prepareAddUltramodernVertical,
+    rewriteShellAppFiles: ()=>shell_files_cjs_namespaceObject.rewriteShellAppFiles,
+    updateRootWorkspaceScripts: ()=>shell_files_cjs_namespaceObject.updateRootWorkspaceScripts,
+    verticalTopologyEntry: ()=>topology_cjs_namespaceObject.verticalTopologyEntry,
+    verticalsFromTopology: ()=>topology_cjs_namespaceObject.verticalsFromTopology
 });
-const external_node_fs_namespaceObject = require("node:fs");
-var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
-const external_node_os_namespaceObject = require("node:os");
-var external_node_os_default = /*#__PURE__*/ __webpack_require__.n(external_node_os_namespaceObject);
-const external_node_path_namespaceObject = require("node:path");
-var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
-const external_ultramodern_package_source_cjs_namespaceObject = require("../ultramodern-package-source.cjs");
-const config_cjs_namespaceObject = require("../ultramodern-tooling/config.cjs");
-const external_api_cjs_namespaceObject = require("./api.cjs");
-const external_app_files_cjs_namespaceObject = require("./app-files.cjs");
-const external_demo_components_cjs_namespaceObject = require("./demo-components.cjs");
-const external_descriptors_cjs_namespaceObject = require("./descriptors.cjs");
-const external_fs_io_cjs_namespaceObject = require("./fs-io.cjs");
-const external_generation_result_cjs_namespaceObject = require("./generation-result.cjs");
-const external_locales_cjs_namespaceObject = require("./locales.cjs");
-const external_module_federation_cjs_namespaceObject = require("./module-federation.cjs");
-const external_naming_cjs_namespaceObject = require("./naming.cjs");
-const external_overlays_cjs_namespaceObject = require("./overlays.cjs");
-const external_package_json_cjs_namespaceObject = require("./package-json.cjs");
-const external_package_source_cjs_namespaceObject = require("./package-source.cjs");
-const external_policy_cjs_namespaceObject = require("./policy.cjs");
-const external_public_surface_cjs_namespaceObject = require("./public-surface.cjs");
-const external_types_cjs_namespaceObject = require("./types.cjs");
-const external_workspace_scripts_cjs_namespaceObject = require("./workspace-scripts.cjs");
-const external_write_workspace_cjs_namespaceObject = require("./write-workspace.cjs");
-const FIRST_VERTICAL_PORT = 4101;
-const TOPOLOGY_PATH = 'topology/reference-topology.json';
-const OWNERSHIP_PATH = 'topology/ownership.json';
-const DEVELOPMENT_OVERLAY_PATH = 'topology/local-overlays/development.json';
-function existingPackageSource(workspaceRoot, modernVersion, packageSource) {
-    if (packageSource) return (0, external_package_source_cjs_namespaceObject.resolvePackageSource)({
-        targetDir: workspaceRoot,
-        packageName: external_node_path_default().basename(workspaceRoot),
-        modernVersion,
-        packageSource
-    });
-    const compactPath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
-    if (external_node_fs_default().existsSync(compactPath)) {
-        const compactConfig = (0, config_cjs_namespaceObject.readUltramodernConfig)(workspaceRoot);
-        if (compactConfig.packageSource) return compactConfig.packageSource;
-    }
-    throw new Error(`Missing UltraModern workspace file: ${compactPath}`);
-}
-function existingTailwindEnabled(workspaceRoot) {
-    const compactPath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
-    if (external_node_fs_default().existsSync(compactPath)) return (0, config_cjs_namespaceObject.readUltramodernConfig)(workspaceRoot).features.tailwind;
-    throw new Error(`Missing UltraModern workspace file: ${compactPath}`);
-}
-function existingBridgeConfig(workspaceRoot) {
-    const compactPath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
-    return external_node_fs_default().existsSync(compactPath) ? (0, config_cjs_namespaceObject.readUltramodernConfig)(workspaceRoot).bridge : void 0;
-}
-function assertValidVerticalName(name) {
-    const normalized = (0, external_naming_cjs_namespaceObject.toKebabCase)(name);
-    if (!normalized || normalized !== name) throw new Error(`Invalid Vertical name "${name}". Use lowercase kebab-case.`);
-    return normalized;
-}
-function nextAvailablePort(ports) {
-    const numericPorts = Object.values(ports).filter((value)=>'number' == typeof value && Number.isFinite(value));
-    return Math.max(FIRST_VERTICAL_PORT - 1, ...numericPorts) + 1;
-}
-function assertCanCreate(workspaceRoot, relativePath) {
-    if (external_node_fs_default().existsSync(external_node_path_default().join(workspaceRoot, relativePath))) throw new Error(`Refusing to overwrite existing path: ${relativePath}`);
-}
-function updateRootWorkspaceScripts(workspaceRoot, scope, packageSource, remotes, bridge) {
-    const packagePath = external_node_path_default().join(workspaceRoot, 'package.json');
-    const rootPackage = (0, external_fs_io_cjs_namespaceObject.readJsonFile)(packagePath);
-    const generatedRootPackage = (0, external_package_json_cjs_namespaceObject.createRootPackageJson)(scope, packageSource, remotes, bridge);
-    rootPackage.scripts = generatedRootPackage.scripts;
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(packagePath, rootPackage);
-}
-function rewriteShellAppFiles(workspaceRoot, scope, packageSource, enableTailwind, remotes, bridge) {
-    const shellHost = (0, external_descriptors_cjs_namespaceObject.createShellHost)(remotes);
-    const publicWeb = (0, external_public_surface_cjs_namespaceObject.createPublicWebAppArtifacts)(shellHost);
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/package.json`), (0, external_package_json_cjs_namespaceObject.createAppPackage)(scope, shellHost, packageSource, enableTailwind, remotes, bridge));
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/tsconfig.json`), (0, external_package_json_cjs_namespaceObject.createAppTsConfig)(shellHost, remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/tsconfig.mf-types.json`), (0, external_package_json_cjs_namespaceObject.createAppMfTypesTsConfig)(shellHost));
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/modern-app-env.d.ts`, (0, external_app_files_cjs_namespaceObject.createAppEnvDts)(shellHost, remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, publicWeb.jsonLdHelperFile.path, publicWeb.jsonLdHelperFile.content);
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, publicWeb.routeMetadataFile.path, publicWeb.routeMetadataFile.content);
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
-    for (const generatedFile of publicWeb.routeMetaFiles)(0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, generatedFile.path, generatedFile.content);
-    (0, external_public_surface_cjs_namespaceObject.rewriteWorkspaceAssetsForApp)(workspaceRoot, shellHost);
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/modern.runtime.ts`, (0, external_app_files_cjs_namespaceObject.createAppRuntimeConfig)(shellHost, scope, remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/locales/en/translation.json`), (0, external_locales_cjs_namespaceObject.createAppPublicLocaleMessages)(shellHost, 'en', remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/locales/en/${(0, external_descriptors_cjs_namespaceObject.appI18nNamespace)(shellHost)}.json`), (0, external_locales_cjs_namespaceObject.createAppPublicLocaleMessages)(shellHost, 'en', remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/locales/cs/translation.json`), (0, external_locales_cjs_namespaceObject.createAppPublicLocaleMessages)(shellHost, 'cs', remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/locales/cs/${(0, external_descriptors_cjs_namespaceObject.appI18nNamespace)(shellHost)}.json`), (0, external_locales_cjs_namespaceObject.createAppPublicLocaleMessages)(shellHost, 'cs', remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/module-federation.config.ts`, (0, external_module_federation_cjs_namespaceObject.createShellModuleFederationConfig)(scope, remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/routes/[lang]/page.tsx`, (0, external_demo_components_cjs_namespaceObject.createShellPage)(remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/routes/vertical-components.tsx`, (0, external_demo_components_cjs_namespaceObject.createShellRemoteComponents)(scope, remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/routes/shell-frame.tsx`, (0, external_app_files_cjs_namespaceObject.createShellFrameComponent)());
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/api/vertical-clients.ts`, (0, external_api_cjs_namespaceObject.createShellApiClient)(scope, remotes));
-}
-function addShellZephyrDependency(workspaceRoot, scope, remote) {
-    const packagePath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.shellApp.directory, 'package.json');
-    const shellPackage = (0, external_fs_io_cjs_namespaceObject.readJsonFile)(packagePath);
-    shellPackage['zephyr:dependencies'] ??= {};
-    shellPackage['zephyr:dependencies'][(0, external_descriptors_cjs_namespaceObject.remoteDependencyAlias)(remote)] = (0, external_descriptors_cjs_namespaceObject.zephyrRemoteDependency)(scope, remote);
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(packagePath, shellPackage);
-}
-function addShellWorkspaceDependency(workspaceRoot, scope, remote) {
-    if (!(0, external_descriptors_cjs_namespaceObject.appHasApi)(remote)) return;
-    const packagePath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.shellApp.directory, 'package.json');
-    const shellPackage = (0, external_fs_io_cjs_namespaceObject.readJsonFile)(packagePath);
-    shellPackage.dependencies ??= {};
-    shellPackage.dependencies[(0, external_naming_cjs_namespaceObject.packageName)(scope, remote.packageSuffix)] = external_ultramodern_package_source_cjs_namespaceObject.WORKSPACE_PACKAGE_VERSION;
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(packagePath, shellPackage);
-}
-function verticalTopologyEntry(scope, vertical, remotes = []) {
-    return {
-        id: vertical.id,
-        kind: vertical.kind,
-        domain: vertical.domain,
-        package: (0, external_naming_cjs_namespaceObject.packageName)(scope, vertical.packageSuffix),
-        path: vertical.directory,
-        moduleFederation: {
-            role: 'remote',
-            name: vertical.mfName,
-            manifestUrl: `http://localhost:${vertical.port}/mf-manifest.json`,
-            exposes: Object.keys(vertical.exposes ?? {}),
-            ...vertical.verticalRefs?.length ? {
-                verticalRefs: vertical.verticalRefs,
-                remotes: (0, external_descriptors_cjs_namespaceObject.createModuleFederationRemoteContracts)(vertical, remotes)
-            } : {},
-            ssr: true,
-            fallbackTelemetryEvent: 'modernjs:mv-runtime-parity',
-            sharedContractVersion: 'mf-ssr-contract-v1'
-        },
-        ...(0, external_api_cjs_namespaceObject.apiTopologyMetadata)(vertical) ? {
-            api: (0, external_api_cjs_namespaceObject.apiTopologyMetadata)(vertical)
-        } : {},
-        cloudflare: (0, external_policy_cjs_namespaceObject.createCloudflareDeployContract)(scope, vertical),
-        ownership: vertical.ownership
-    };
-}
-function ownershipEntry(scope, owner) {
-    return {
-        id: owner.id,
-        package: (0, external_naming_cjs_namespaceObject.packageName)(scope, owner.packageSuffix),
-        path: owner.directory,
-        ownership: owner.ownership
-    };
-}
-function verticalsFromTopology(topology, ports) {
-    return (topology.verticals ?? []).map((vertical)=>{
-        const domain = vertical.domain ?? String(vertical.id);
-        const packageSuffix = vertical.package?.split('/').at(-1) ?? domain;
-        const apiTopology = vertical.api;
-        const api = apiTopology?.runtime === 'effect' ? {
-            stem: 'string' == typeof apiTopology.basePath ? apiTopology.basePath.split('/').filter(Boolean).at(-1) ?? domain : domain,
-            prefix: apiTopology.bff?.prefix ?? `/${domain}-api`,
-            consumedBy: Array.isArray(apiTopology.consumedBy) ? apiTopology.consumedBy : [
-                external_descriptors_cjs_namespaceObject.shellApp.id,
-                vertical.id
-            ]
-        } : void 0;
-        return {
-            id: vertical.id,
-            directory: 'string' == typeof vertical.path ? vertical.path : `verticals/${domain}`,
-            packageSuffix,
-            displayName: vertical.displayName ?? `${(0, external_naming_cjs_namespaceObject.toPascalCase)(domain)} Vertical`,
-            kind: 'vertical',
-            domain,
-            portEnv: `VERTICAL_${(0, external_naming_cjs_namespaceObject.toEnvSegment)(domain)}_PORT`,
-            port: 'number' == typeof ports[vertical.id] ? ports[vertical.id] : 0,
-            mfName: vertical.moduleFederation?.name ?? `vertical${(0, external_naming_cjs_namespaceObject.toPascalCase)(domain)}`,
-            ...Array.isArray(vertical.moduleFederation?.exposes) ? {
-                exposes: Object.fromEntries(vertical.moduleFederation.exposes.map((expose)=>[
-                        expose,
-                        './Route' === expose ? './src/federation-entry.tsx' : './Widget' === expose ? `./src/components/${domain}-widget.tsx` : ''
-                    ]))
-            } : {},
-            ...Array.isArray(vertical.moduleFederation?.verticalRefs) ? {
-                verticalRefs: vertical.moduleFederation.verticalRefs
-            } : Array.isArray(vertical.moduleFederation?.remotes) ? {
-                verticalRefs: vertical.moduleFederation.remotes.map((entry)=>entry.id).filter((id)=>'string' == typeof id)
-            } : {},
-            ...api ? {
-                api
-            } : {},
-            ownership: vertical.ownership ?? (0, external_descriptors_cjs_namespaceObject.createNeutralOwnership)(vertical.id)
-        };
-    });
-}
-function prepareAddUltramodernVertical(options) {
-    const name = assertValidVerticalName(options.name);
-    const topologyPath = external_node_path_default().join(options.workspaceRoot, TOPOLOGY_PATH);
-    const ownershipPath = external_node_path_default().join(options.workspaceRoot, OWNERSHIP_PATH);
-    const overlayPath = external_node_path_default().join(options.workspaceRoot, DEVELOPMENT_OVERLAY_PATH);
-    const rootPackage = readRequiredJsonObject(external_node_path_default().join(options.workspaceRoot, 'package.json'));
-    const topology = readRequiredJsonObject(topologyPath);
-    const ownership = readRequiredJsonObject(ownershipPath);
-    const overlay = readRequiredJsonObject(overlayPath);
-    readRequiredWorkspaceConfig(options.workspaceRoot);
-    assertOptionalJsonObject(topology.shell, 'topology.shell', topologyPath);
-    assertOptionalJsonArray(topology.verticals, 'topology.verticals', topologyPath);
-    assertOptionalJsonArray(ownership.owners, 'ownership.owners', ownershipPath);
-    assertOptionalJsonObject(overlay.ports, 'overlay.ports', overlayPath);
-    assertOptionalJsonObject(overlay.manifests, 'overlay.manifests', overlayPath);
-    assertOptionalJsonObject(overlay.apis, 'overlay.apis', overlayPath);
-    overlay.ports ??= {};
-    const scope = (0, external_naming_cjs_namespaceObject.toPackageScope)(String(rootPackage.name ?? external_node_path_default().basename(options.workspaceRoot)));
-    const packageSource = existingPackageSource(options.workspaceRoot, options.modernVersion, options.packageSource);
-    const enableTailwind = options.enableTailwind ?? existingTailwindEnabled(options.workspaceRoot);
-    const bridge = existingBridgeConfig(options.workspaceRoot);
-    const existingVerticals = verticalsFromTopology(topology, overlay.ports);
-    const port = nextAvailablePort(overlay.ports);
-    const vertical = (0, external_descriptors_cjs_namespaceObject.createVerticalDescriptor)(name, port);
-    const updatedVerticals = [
-        ...existingVerticals,
-        vertical
-    ];
-    const allApps = [
-        external_descriptors_cjs_namespaceObject.shellApp,
-        ...updatedVerticals
-    ];
-    assertCanCreate(options.workspaceRoot, vertical.directory);
-    validateWorkspaceAppDescriptors(allApps);
-    validateUniqueWorkspaceAppDescriptors(allApps);
-    (0, external_naming_cjs_namespaceObject.assertUniqueTailwindPrefixes)(allApps);
-    return {
-        name,
-        scope,
-        topologyPath,
-        ownershipPath,
-        overlayPath,
-        rootPackage,
-        topology,
-        ownership,
-        overlay,
-        packageSource,
-        enableTailwind,
-        bridge,
-        vertical,
-        updatedVerticals
-    };
-}
-function readRequiredJsonObject(filePath) {
-    if (!external_node_fs_default().existsSync(filePath)) throw new Error(`Missing UltraModern workspace file: ${filePath}`);
-    const value = (0, external_fs_io_cjs_namespaceObject.readJsonFile)(filePath);
-    if (!(0, external_types_cjs_namespaceObject.isRecord)(value)) throw new Error(`UltraModern workspace file must contain a JSON object: ${filePath}`);
-    return value;
-}
-function readRequiredWorkspaceConfig(workspaceRoot) {
-    const compactPath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
-    readRequiredJsonObject(compactPath);
-}
-function assertOptionalJsonObject(value, label, filePath) {
-    if (void 0 !== value && !(0, external_types_cjs_namespaceObject.isRecord)(value)) throw new Error(`${label} in ${filePath} must be a JSON object`);
-}
-function assertOptionalJsonArray(value, label, filePath) {
-    if (void 0 !== value && !Array.isArray(value)) throw new Error(`${label} in ${filePath} must be a JSON array`);
-}
-function validateWorkspaceAppDescriptors(apps) {
-    for (const app of apps){
-        const appLabel = 'string' == typeof app.id && app.id ? app.id : '<unknown>';
-        assertNonEmptyString(app.id, `app id for ${appLabel}`);
-        assertNonEmptyString(app.directory, `directory for ${appLabel}`);
-        assertSafeOutputPath(app.directory, appLabel);
-        assertNonEmptyString(app.packageSuffix, `package suffix for ${appLabel}`);
-        assertNonEmptyString(app.displayName, `display name for ${appLabel}`);
-        if ('shell' !== app.kind && 'vertical' !== app.kind) throw new Error(`Invalid app kind for ${appLabel}: ${String(app.kind)}`);
-        assertNonEmptyString(app.portEnv, `port env for ${appLabel}`);
-        if ('number' != typeof app.port || !Number.isFinite(app.port) || app.port <= 0) throw new Error(`Invalid development port for ${appLabel}`);
-        assertNonEmptyString(app.mfName, `Module Federation name for ${appLabel}`);
-        if (app.api) {
-            assertNonEmptyString(app.api.prefix, `API prefix for ${appLabel}`);
-            if (!app.api.prefix.startsWith('/')) throw new Error(`API prefix for ${appLabel} must start with "/"`);
-        }
-    }
-}
-function validateUniqueWorkspaceAppDescriptors(apps) {
-    assertUniqueAppField(apps, 'app id', (app)=>app.id);
-    assertUniqueAppField(apps, 'package suffix', (app)=>app.packageSuffix);
-    assertUniqueAppField(apps, 'output path', (app)=>(0, external_naming_cjs_namespaceObject.normalizePath)(app.directory));
-    assertUniqueAppField(apps, 'Module Federation name', (app)=>app.mfName);
-    assertUniqueAppField(apps, 'development port', (app)=>String(app.port));
-    assertUniqueAppField(apps, 'API prefix', (app)=>app.api?.prefix);
-    assertUniqueAppField(apps, 'manifest environment name', (app)=>'vertical' === app.kind ? (0, external_descriptors_cjs_namespaceObject.createRemoteManifestEnv)(app) : void 0);
-}
-function assertUniqueAppField(apps, label, readValue) {
-    const seen = new Map();
-    for (const app of apps){
-        const value = readValue(app);
-        if (!value) continue;
-        const previousId = seen.get(value);
-        if (previousId) throw new Error(`Duplicate ${label} "${value}" for ${previousId} and ${app.id}`);
-        seen.set(value, app.id);
-    }
-}
-function assertNonEmptyString(value, label) {
-    if ('string' != typeof value || 0 === value.length) throw new Error(`Invalid ${label}`);
-}
-function assertSafeOutputPath(relativePath, appId) {
-    if (external_node_path_default().isAbsolute(relativePath) || relativePath.split(/[\\/]+/u).includes('..')) throw new Error(`Unsafe output path for ${appId}: ${relativePath}`);
-}
-function planUltramodernVertical(options) {
-    const preflight = prepareAddUltramodernVertical(options);
-    const tempRoot = external_node_fs_default().mkdtempSync(external_node_path_default().join(external_node_os_default().tmpdir(), 'um-vertical-plan-'));
-    const copiedWorkspaceRoot = external_node_path_default().join(tempRoot, 'workspace');
-    try {
-        copyWorkspaceForPlan(options.workspaceRoot, copiedWorkspaceRoot);
-        const plannedResult = addUltramodernVertical({
-            ...options,
-            workspaceRoot: copiedWorkspaceRoot,
-            overlays: void 0
-        });
-        return createVerticalPlan(preflight, {
-            ...plannedResult,
-            workspaceRoot: options.workspaceRoot
-        });
-    } finally{
-        external_node_fs_default().rmSync(tempRoot, {
-            recursive: true,
-            force: true
-        });
-    }
-}
-function copyWorkspaceForPlan(workspaceRoot, copiedWorkspaceRoot) {
-    const skippedDirectories = new Set([
-        '.git',
-        '.nx',
-        '.output',
-        'coverage',
-        'dist',
-        'node_modules'
-    ]);
-    external_node_fs_default().cpSync(workspaceRoot, copiedWorkspaceRoot, {
-        recursive: true,
-        filter: (sourcePath)=>!skippedDirectories.has(external_node_path_default().basename(sourcePath))
-    });
-}
-function createVerticalPlan(preflight, result) {
-    const { scope, vertical, updatedVerticals } = preflight;
-    const manifestUrl = `http://localhost:${vertical.port}/mf-manifest.json`;
-    return {
-        ...result,
-        dryRun: true,
-        selectedPort: vertical.port,
-        moduleFederationRemote: {
-            id: vertical.id,
-            name: vertical.mfName,
-            manifestUrl
-        },
-        ...vertical.api ? {
-            apiPrefix: (0, external_descriptors_cjs_namespaceObject.resolveApiPrefix)(vertical)
-        } : {},
-        jsonMutations: createDryRunJsonMutations(preflight, manifestUrl),
-        shellDependencyChanges: createShellDependencyChanges(scope, vertical),
-        generatedContractChanges: [
-            {
-                path: external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH,
-                addedAppIds: [
-                    vertical.id
-                ],
-                shellVerticalRefs: updatedVerticals.map((vertical)=>vertical.id)
-            }
-        ]
-    };
-}
-function createDryRunJsonMutations(preflight, manifestUrl) {
-    const { scope, vertical } = preflight;
-    const apiMutation = (0, external_descriptors_cjs_namespaceObject.appHasApi)(vertical) ? [
-        {
-            path: DEVELOPMENT_OVERLAY_PATH,
-            pointer: `/apis/${vertical.id}`,
-            description: `Add local API URL for ${vertical.id}`,
-            value: `http://localhost:${vertical.port}${(0, external_descriptors_cjs_namespaceObject.resolveApiPrefix)(vertical)}`
-        }
-    ] : [];
-    return [
-        {
-            path: TOPOLOGY_PATH,
-            pointer: '/shell/verticalRefs/-',
-            description: `Add ${vertical.id} to the shell vertical references`,
-            value: vertical.id
-        },
-        {
-            path: TOPOLOGY_PATH,
-            pointer: '/shell/moduleFederation/remotes/-',
-            description: `Register ${vertical.id} as a Module Federation remote`,
-            value: {
-                id: vertical.id,
-                name: vertical.mfName,
-                manifestUrl
-            }
-        },
-        {
-            path: TOPOLOGY_PATH,
-            pointer: '/verticals/-',
-            description: `Add topology entry for ${vertical.id}`,
-            value: verticalTopologyEntry(scope, vertical)
-        },
-        {
-            path: OWNERSHIP_PATH,
-            pointer: '/owners/-',
-            description: `Add ownership entry for ${vertical.id}`,
-            value: ownershipEntry(scope, vertical)
-        },
-        {
-            path: DEVELOPMENT_OVERLAY_PATH,
-            pointer: `/ports/${vertical.id}`,
-            description: `Reserve development port ${vertical.port}`,
-            value: vertical.port
-        },
-        {
-            path: DEVELOPMENT_OVERLAY_PATH,
-            pointer: `/manifests/${vertical.id}`,
-            description: `Add local Module Federation manifest URL for ${vertical.id}`,
-            value: manifestUrl
-        },
-        ...apiMutation,
-        {
-            path: 'package.json',
-            pointer: "/scripts",
-            description: "Regenerate workspace scripts for the new vertical set"
-        },
-        {
-            path: `${external_descriptors_cjs_namespaceObject.shellApp.directory}/package.json`,
-            pointer: '/dependencies',
-            description: `Wire shell dependencies for ${vertical.id}`
-        },
-        {
-            path: 'tsconfig.json',
-            pointer: '/references',
-            description: `Add ${vertical.id} to the root TS-Go build graph`
-        },
-        {
-            path: `${external_descriptors_cjs_namespaceObject.shellApp.directory}/tsconfig.json`,
-            pointer: '/references',
-            description: `Add ${vertical.id} to the shell TS-Go project references`
-        },
-        {
-            path: `${external_descriptors_cjs_namespaceObject.shellApp.directory}/tsconfig.mf-types.json`,
-            pointer: '/include',
-            description: 'Keep shell Module Federation DTS compilation scoped'
-        },
-        {
-            path: external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH,
-            pointer: '/topology/apps',
-            description: `Regenerate compact config with ${vertical.id}`
-        }
-    ];
-}
-function createShellDependencyChanges(scope, vertical) {
-    return [
-        {
-            path: `${external_descriptors_cjs_namespaceObject.shellApp.directory}/package.json`,
-            section: 'zephyr:dependencies',
-            packageName: (0, external_descriptors_cjs_namespaceObject.remoteDependencyAlias)(vertical),
-            version: (0, external_descriptors_cjs_namespaceObject.zephyrRemoteDependency)(scope, vertical)
-        },
-        ...(0, external_descriptors_cjs_namespaceObject.appHasApi)(vertical) ? [
-            {
-                path: `${external_descriptors_cjs_namespaceObject.shellApp.directory}/package.json`,
-                section: 'dependencies',
-                packageName: (0, external_naming_cjs_namespaceObject.packageName)(scope, vertical.packageSuffix),
-                version: external_ultramodern_package_source_cjs_namespaceObject.WORKSPACE_PACKAGE_VERSION
-            }
-        ] : []
-    ];
-}
-function addUltramodernVertical(options) {
-    const beforeFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.workspaceRoot);
-    const { scope, topologyPath, ownershipPath, overlayPath, topology, ownership, overlay, packageSource, enableTailwind, bridge, vertical, updatedVerticals } = prepareAddUltramodernVertical(options);
-    (0, external_write_workspace_cjs_namespaceObject.writeApp)(options.workspaceRoot, scope, vertical, packageSource, enableTailwind, updatedVerticals, bridge);
-    topology.shell ??= {};
-    topology.shell.verticalRefs ??= [];
-    topology.shell.verticalRefs.push(vertical.id);
-    topology.shell.moduleFederation ??= {};
-    topology.shell.moduleFederation.remotes ??= [];
-    topology.shell.moduleFederation.remotes.push({
-        id: vertical.id,
-        name: vertical.mfName,
-        manifestUrl: `http://localhost:${vertical.port}/mf-manifest.json`
-    });
-    topology.verticals ??= [];
-    topology.verticals.push(verticalTopologyEntry(scope, vertical));
-    ownership.owners ??= [];
-    ownership.owners.push(ownershipEntry(scope, vertical));
-    overlay.ports[vertical.id] = vertical.port;
-    overlay.manifests ??= {};
-    overlay.manifests[vertical.id] = `http://localhost:${vertical.port}/mf-manifest.json`;
-    overlay.apis ??= {};
-    overlay.apis[vertical.id] = `http://localhost:${vertical.port}${(0, external_descriptors_cjs_namespaceObject.resolveApiPrefix)(vertical)}`;
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(topologyPath, topology);
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(ownershipPath, ownership);
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(overlayPath, overlay);
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(options.workspaceRoot, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH), (0, external_write_workspace_cjs_namespaceObject.createCompactUltramodernConfig)(scope, options.modernVersion, packageSource, [
-        {
-            ...external_descriptors_cjs_namespaceObject.shellApp,
-            verticalRefs: updatedVerticals.map((vertical)=>vertical.id)
-        },
-        ...updatedVerticals
-    ], enableTailwind, bridge));
-    rewriteShellAppFiles(options.workspaceRoot, scope, packageSource, enableTailwind, updatedVerticals, bridge);
-    (0, external_workspace_scripts_cjs_namespaceObject.writeGeneratedWorkspaceScripts)(options.workspaceRoot, scope, enableTailwind, updatedVerticals);
-    addShellZephyrDependency(options.workspaceRoot, scope, vertical);
-    addShellWorkspaceDependency(options.workspaceRoot, scope, vertical);
-    updateRootWorkspaceScripts(options.workspaceRoot, scope, packageSource, updatedVerticals, bridge);
-    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(external_node_path_default().join(options.workspaceRoot, 'tsconfig.json'), (0, external_package_json_cjs_namespaceObject.createRootTsConfig)([
-        {
-            ...external_descriptors_cjs_namespaceObject.shellApp,
-            verticalRefs: updatedVerticals.map((vertical)=>vertical.id)
-        },
-        ...updatedVerticals
-    ]));
-    const preliminaryAfterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.workspaceRoot);
-    const preliminaryDiff = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, preliminaryAfterFiles);
-    const preliminaryResult = (0, external_generation_result_cjs_namespaceObject.createGenerationResult)({
-        operation: 'vertical',
-        workspaceRoot: options.workspaceRoot,
-        packageScope: scope,
-        packageSource,
-        createdApps: [
-            vertical
-        ],
-        createdPaths: preliminaryDiff.createdPaths,
-        rewrittenPaths: preliminaryDiff.rewrittenPaths
-    });
-    (0, external_overlays_cjs_namespaceObject.runCodeSmithOverlays)({
-        workspaceRoot: options.workspaceRoot,
-        overlays: options.overlays,
-        result: preliminaryResult
-    });
-    const afterOverlaysFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.workspaceRoot);
-    const changedPaths = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, afterOverlaysFiles);
-    (0, external_fs_io_cjs_namespaceObject.formatGeneratedWorkspaceFiles)(options.workspaceRoot, [
-        ...changedPaths.createdPaths,
-        ...changedPaths.rewrittenPaths
-    ]);
-    const afterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.workspaceRoot);
-    const { createdPaths, rewrittenPaths } = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, afterFiles);
-    return (0, external_generation_result_cjs_namespaceObject.createGenerationResult)({
-        operation: 'vertical',
-        workspaceRoot: options.workspaceRoot,
-        packageScope: scope,
-        packageSource,
-        createdApps: [
-            vertical
-        ],
-        createdPaths,
-        rewrittenPaths
-    });
-}
+const execute_cjs_namespaceObject = require("./add-vertical/execute.cjs");
+const plan_cjs_namespaceObject = require("./add-vertical/plan.cjs");
+const preflight_cjs_namespaceObject = require("./add-vertical/preflight.cjs");
+const shell_files_cjs_namespaceObject = require("./add-vertical/shell-files.cjs");
+const topology_cjs_namespaceObject = require("./add-vertical/topology.cjs");
+const workspace_state_cjs_namespaceObject = require("./add-vertical/workspace-state.cjs");
 exports.addShellWorkspaceDependency = __webpack_exports__.addShellWorkspaceDependency;
 exports.addShellZephyrDependency = __webpack_exports__.addShellZephyrDependency;
 exports.addUltramodernVertical = __webpack_exports__.addUltramodernVertical;