@bleedingdev/modern-js-create 3.2.0-ultramodern.99 → 3.4.0-ultramodern.0

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

@@ -0,0 +1,603 @@
+"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)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    addShellWorkspaceDependency: ()=>addShellWorkspaceDependency,
+    addShellZephyrDependency: ()=>addShellZephyrDependency,
+    addUltramodernVertical: ()=>addUltramodernVertical,
+    assertCanCreate: ()=>assertCanCreate,
+    assertValidVerticalName: ()=>assertValidVerticalName,
+    existingPackageSource: ()=>existingPackageSource,
+    existingTailwindEnabled: ()=>existingTailwindEnabled,
+    nextAvailablePort: ()=>nextAvailablePort,
+    ownershipEntry: ()=>ownershipEntry,
+    planUltramodernVertical: ()=>planUltramodernVertical,
+    prepareAddUltramodernVertical: ()=>prepareAddUltramodernVertical,
+    rewriteShellAppFiles: ()=>rewriteShellAppFiles,
+    updateRootWorkspaceScripts: ()=>updateRootWorkspaceScripts,
+    verticalTopologyEntry: ()=>verticalTopologyEntry,
+    verticalsFromTopology: ()=>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 external_app_files_cjs_namespaceObject = require("./app-files.cjs");
+const external_contracts_cjs_namespaceObject = require("./contracts.cjs");
+const external_demo_components_cjs_namespaceObject = require("./demo-components.cjs");
+const external_descriptors_cjs_namespaceObject = require("./descriptors.cjs");
+const external_effect_api_cjs_namespaceObject = require("./effect-api.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';
+const PACKAGE_SOURCE_METADATA_PATH = '.modernjs/ultramodern-package-source.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 metadataPath = external_node_path_default().join(workspaceRoot, '.modernjs/ultramodern-package-source.json');
+    if (!external_node_fs_default().existsSync(metadataPath)) return (0, external_package_source_cjs_namespaceObject.resolvePackageSource)({
+        targetDir: workspaceRoot,
+        packageName: external_node_path_default().basename(workspaceRoot),
+        modernVersion
+    });
+    const metadata = (0, external_fs_io_cjs_namespaceObject.readJsonFile)(metadataPath);
+    const aliases = metadata.modernPackages?.aliases ?? {};
+    const firstAlias = Object.values(aliases).find((value)=>'string' == typeof value);
+    const firstPackage = Object.keys(aliases)[0];
+    const aliasScope = firstAlias?.match(/^@([^/]+)\//)?.[1];
+    const unscopedName = firstPackage?.split('/').at(-1) ?? '';
+    const aliasUnscopedName = firstAlias?.split('/').at(-1) ?? '';
+    const aliasPackageNamePrefix = aliasUnscopedName && unscopedName && aliasUnscopedName.endsWith(unscopedName) ? aliasUnscopedName.slice(0, -unscopedName.length) : void 0;
+    return {
+        strategy: 'install' === metadata.strategy ? 'install' : 'workspace',
+        modernPackageVersion: 'string' == typeof metadata.modernPackages?.specifier ? metadata.modernPackages.specifier : modernVersion,
+        registry: metadata.modernPackages?.registry,
+        aliasScope,
+        aliasPackageNamePrefix
+    };
+}
+function existingTailwindEnabled(workspaceRoot) {
+    const contractPath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.GENERATED_CONTRACT_PATH);
+    if (!external_node_fs_default().existsSync(contractPath)) return true;
+    const contract = (0, external_fs_io_cjs_namespaceObject.readJsonFile)(contractPath);
+    const apps = (0, external_types_cjs_namespaceObject.isRecord)(contract) && Array.isArray(contract.apps) ? contract.apps : [];
+    const shell = apps.find((app)=>(0, external_types_cjs_namespaceObject.isRecord)(app) && app.id === external_descriptors_cjs_namespaceObject.shellApp.id);
+    return shell?.styling && (0, external_types_cjs_namespaceObject.isRecord)(shell.styling) ? false !== shell.styling.tailwind : true;
+}
+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) {
+    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);
+    rootPackage.scripts = generatedRootPackage.scripts;
+    (0, external_fs_io_cjs_namespaceObject.writeJsonFile)(packagePath, rootPackage);
+}
+function rewriteShellAppFiles(workspaceRoot, scope, packageSource, enableTailwind, remotes) {
+    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));
+    (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/effect/vertical-clients.ts`, (0, external_effect_api_cjs_namespaceObject.createShellEffectClient)(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.appHasEffectApi)(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_effect_api_cjs_namespaceObject.effectApiTopologyMetadata)(vertical) ? {
+            api: (0, external_effect_api_cjs_namespaceObject.effectApiTopologyMetadata)(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 effectApi = vertical.api?.effect ? {
+            stem: 'string' == typeof vertical.api.effect.basePath ? vertical.api.effect.basePath.split('/').filter(Boolean).at(-1) ?? domain : domain,
+            prefix: vertical.api.effect.bff?.prefix ?? `/${domain}-api`,
+            consumedBy: Array.isArray(vertical.api.effect.consumedBy) ? vertical.api.effect.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)
+            } : {},
+            ...effectApi ? {
+                effectApi
+            } : {},
+            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);
+    readRequiredJsonObject(external_node_path_default().join(options.workspaceRoot, external_descriptors_cjs_namespaceObject.GENERATED_CONTRACT_PATH));
+    readRequiredJsonObject(external_node_path_default().join(options.workspaceRoot, PACKAGE_SOURCE_METADATA_PATH));
+    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 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,
+        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 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.effectApi) {
+            assertNonEmptyString(app.effectApi.prefix, `Effect API prefix for ${appLabel}`);
+            if (!app.effectApi.prefix.startsWith('/')) throw new Error(`Effect 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, 'Effect API prefix', (app)=>app.effectApi?.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.effectApi ? {
+            effectApiPrefix: (0, external_descriptors_cjs_namespaceObject.effectApiPrefix)(vertical)
+        } : {},
+        jsonMutations: createDryRunJsonMutations(preflight, manifestUrl),
+        shellDependencyChanges: createShellDependencyChanges(scope, vertical),
+        generatedContractChanges: [
+            {
+                path: external_descriptors_cjs_namespaceObject.GENERATED_CONTRACT_PATH,
+                addedAppIds: [
+                    vertical.id
+                ],
+                shellVerticalRefs: updatedVerticals.map((vertical)=>vertical.id)
+            }
+        ]
+    };
+}
+function createDryRunJsonMutations(preflight, manifestUrl) {
+    const { scope, vertical } = preflight;
+    const effectApiMutation = (0, external_descriptors_cjs_namespaceObject.appHasEffectApi)(vertical) ? [
+        {
+            path: DEVELOPMENT_OVERLAY_PATH,
+            pointer: `/apis/${vertical.id}`,
+            description: `Add local Effect API URL for ${vertical.id}`,
+            value: `http://localhost:${vertical.port}${(0, external_descriptors_cjs_namespaceObject.effectApiPrefix)(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
+        },
+        ...effectApiMutation,
+        {
+            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: external_descriptors_cjs_namespaceObject.GENERATED_CONTRACT_PATH,
+            pointer: '/apps',
+            description: `Regenerate contract 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.appHasEffectApi)(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, vertical, updatedVerticals } = prepareAddUltramodernVertical(options);
+    (0, external_write_workspace_cjs_namespaceObject.writeApp)(options.workspaceRoot, scope, vertical, packageSource, enableTailwind);
+    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.effectApiPrefix)(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.GENERATED_CONTRACT_PATH), (0, external_contracts_cjs_namespaceObject.createGeneratedContract)(scope, [
+        {
+            ...external_descriptors_cjs_namespaceObject.shellApp,
+            verticalRefs: updatedVerticals.map((vertical)=>vertical.id)
+        },
+        ...updatedVerticals
+    ], enableTailwind));
+    rewriteShellAppFiles(options.workspaceRoot, scope, packageSource, enableTailwind, updatedVerticals);
+    (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);
+    const afterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.workspaceRoot);
+    const { createdPaths, rewrittenPaths } = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, afterFiles);
+    const result = (0, external_generation_result_cjs_namespaceObject.createGenerationResult)({
+        operation: 'vertical',
+        workspaceRoot: options.workspaceRoot,
+        packageScope: scope,
+        packageSource,
+        createdApps: [
+            vertical
+        ],
+        createdPaths,
+        rewrittenPaths
+    });
+    (0, external_overlays_cjs_namespaceObject.runCodeSmithOverlays)({
+        workspaceRoot: options.workspaceRoot,
+        overlays: options.overlays,
+        result
+    });
+    return result;
+}
+exports.addShellWorkspaceDependency = __webpack_exports__.addShellWorkspaceDependency;
+exports.addShellZephyrDependency = __webpack_exports__.addShellZephyrDependency;
+exports.addUltramodernVertical = __webpack_exports__.addUltramodernVertical;
+exports.assertCanCreate = __webpack_exports__.assertCanCreate;
+exports.assertValidVerticalName = __webpack_exports__.assertValidVerticalName;
+exports.existingPackageSource = __webpack_exports__.existingPackageSource;
+exports.existingTailwindEnabled = __webpack_exports__.existingTailwindEnabled;
+exports.nextAvailablePort = __webpack_exports__.nextAvailablePort;
+exports.ownershipEntry = __webpack_exports__.ownershipEntry;
+exports.planUltramodernVertical = __webpack_exports__.planUltramodernVertical;
+exports.prepareAddUltramodernVertical = __webpack_exports__.prepareAddUltramodernVertical;
+exports.rewriteShellAppFiles = __webpack_exports__.rewriteShellAppFiles;
+exports.updateRootWorkspaceScripts = __webpack_exports__.updateRootWorkspaceScripts;
+exports.verticalTopologyEntry = __webpack_exports__.verticalTopologyEntry;
+exports.verticalsFromTopology = __webpack_exports__.verticalsFromTopology;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "addShellWorkspaceDependency",
+    "addShellZephyrDependency",
+    "addUltramodernVertical",
+    "assertCanCreate",
+    "assertValidVerticalName",
+    "existingPackageSource",
+    "existingTailwindEnabled",
+    "nextAvailablePort",
+    "ownershipEntry",
+    "planUltramodernVertical",
+    "prepareAddUltramodernVertical",
+    "rewriteShellAppFiles",
+    "updateRootWorkspaceScripts",
+    "verticalTopologyEntry",
+    "verticalsFromTopology"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});