@kosdev-code/kos-nx-plugin 2.1.26 → 2.1.28

package/migrations.json

@@ -75,6 +75,11 @@
       "version": "2.0.0",
       "description": "Migration for v2.0.0",
       "implementation": "./src/migrations/update-sdk-2.0/update"
+    },
+    "dev-server-support": {
+      "version": "2.1.28",
+      "description": "Adds kosui dev server support to .kos.json, webpack configs, and model projects",
+      "implementation": "./src/migrations/dev-server-support/migrate"
     }
   },
   "packageJsonUpdates": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-nx-plugin",
-  "version": "2.1.26",
+  "version": "2.1.28",
   "type": "commonjs",
   "generators": "./generators.json",
   "publishConfig": {
@@ -19,7 +19,7 @@
   "main": "./src/index.js",
   "kos": {
     "build": {
-      "gitHash": "5af05d3d902c4ddbee74f34723b5acd86dfbdeb7"
+      "gitHash": "de3ec24ed2fd4a39115ae0c10eeb3876aedb2c22"
     }
   }
 }

package/src/migrations/dev-server-support/coordinators/migration-analyzer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+import { Tree } from "@nx/devkit";
+import type { MigrationRequirements } from "../types";
+/**
+ * Zone 2: Migration analysis coordinator
+ */
+/**
+ * Analyzes the workspace to determine what migrations are needed.
+ */
+export declare function analyzeMigrationRequirements(tree: Tree): MigrationRequirements;
+//# sourceMappingURL=migration-analyzer.d.ts.map

package/src/migrations/dev-server-support/coordinators/migration-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-analyzer.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/coordinators/migration-analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAyB,IAAI,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,KAAK,EAAgB,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEpE;;GAEG;AAEH;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,IAAI,GACT,qBAAqB,CAmBvB"}

package/src/migrations/dev-server-support/coordinators/migration-analyzer.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeMigrationRequirements = void 0;
+const devkit_1 = require("@nx/devkit");
+const kos_config_helpers_1 = require("../../../utils/kos-config-helpers");
+const project_analyzer_1 = require("../helpers/project-analyzer");
+/**
+ * Zone 2: Migration analysis coordinator
+ */
+/**
+ * Analyzes the workspace to determine what migrations are needed.
+ */
+function analyzeMigrationRequirements(tree) {
+    const projects = (0, devkit_1.getProjects)(tree);
+    // Check if root config needs migration
+    const needsRootConfig = determineIfRootConfigNeedsMigration(tree);
+    // Categorize all projects
+    const categorized = (0, project_analyzer_1.categorizeProjects)(tree, projects);
+    // Get workspace name
+    const workspaceName = determineWorkspaceName(tree);
+    return {
+        needsRootConfig,
+        uiProjects: categorized.uiProjects,
+        pluginProjects: categorized.pluginProjects,
+        modelProjects: categorized.modelProjects,
+        workspaceName,
+    };
+}
+exports.analyzeMigrationRequirements = analyzeMigrationRequirements;
+/**
+ * Determines if root .kos.json needs development configuration.
+ */
+function determineIfRootConfigNeedsMigration(tree) {
+    if (!tree.exists(".kos.json")) {
+        return false;
+    }
+    const rootConfig = (0, devkit_1.readJson)(tree, ".kos.json");
+    return !(0, kos_config_helpers_1.hasDevelopmentConfig)(rootConfig);
+}
+/**
+ * Determines workspace name from package.json or uses default.
+ */
+function determineWorkspaceName(tree) {
+    if (tree.exists("package.json")) {
+        const packageJson = (0, devkit_1.readJson)(tree, "package.json");
+        return packageJson.name || "kos-workspace";
+    }
+    return "kos-workspace";
+}
+//# sourceMappingURL=migration-analyzer.js.map

package/src/migrations/dev-server-support/coordinators/migration-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-analyzer.js","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/coordinators/migration-analyzer.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAAyD;AACzD,0EAAyE;AACzE,kEAAiE;AAGjE;;GAEG;AAEH;;GAEG;AACH,SAAgB,4BAA4B,CAC1C,IAAU;IAEV,MAAM,QAAQ,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAEnC,uCAAuC;IACvC,MAAM,eAAe,GAAG,mCAAmC,CAAC,IAAI,CAAC,CAAC;IAElE,0BAA0B;IAC1B,MAAM,WAAW,GAAG,IAAA,qCAAkB,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEvD,qBAAqB;IACrB,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAEnD,OAAO;QACL,eAAe;QACf,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,cAAc,EAAE,WAAW,CAAC,cAAc;QAC1C,aAAa,EAAE,WAAW,CAAC,aAAa;QACxC,aAAa;KACd,CAAC;AACJ,CAAC;AArBD,oEAqBC;AAED;;GAEG;AACH,SAAS,mCAAmC,CAAC,IAAU;IACrD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAiB,IAAA,iBAAQ,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAA,yCAAoB,EAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,IAAU;IACxC,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,IAAA,iBAAQ,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACnD,OAAO,WAAW,CAAC,IAAI,IAAI,eAAe,CAAC;IAC7C,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/src/migrations/dev-server-support/coordinators/migration-executor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+import { Tree } from "@nx/devkit";
+import type { MigrationRequirements, MigrationResults } from "../types";
+/**
+ * Zone 2: Migration execution coordinator
+ */
+/**
+ * Executes all migration updates based on requirements.
+ */
+export declare function executeMigrationPlan(tree: Tree, requirements: MigrationRequirements): MigrationResults;
+//# sourceMappingURL=migration-executor.d.ts.map

package/src/migrations/dev-server-support/coordinators/migration-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-executor.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/coordinators/migration-executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAY,IAAI,EAAc,MAAM,YAAY,CAAC;AAiBxD,OAAO,KAAK,EAGV,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB;;GAEG;AAEH;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,qBAAqB,GAClC,gBAAgB,CAkDlB"}

package/src/migrations/dev-server-support/coordinators/migration-executor.js

@@ -0,0 +1,239 @@
+"use strict";
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeMigrationPlan = void 0;
+const devkit_1 = require("@nx/devkit");
+const config_updater_1 = require("../helpers/config-updater");
+const port_allocator_1 = require("../helpers/port-allocator");
+const project_analyzer_1 = require("../helpers/project-analyzer");
+const webpack_updater_1 = require("../helpers/webpack-updater");
+/**
+ * Zone 2: Migration execution coordinator
+ */
+/**
+ * Executes all migration updates based on requirements.
+ */
+function executeMigrationPlan(tree, requirements) {
+    const results = {
+        rootConfigUpdated: false,
+        pluginConfigsUpdated: 0,
+        uiConfigsUpdated: 0,
+        pluginWebpackUpdated: 0,
+        uiWebpackUpdated: 0,
+        modelProjectsUpdated: 0,
+        totalChanges: 0,
+    };
+    // Step 1: Migrate root configuration
+    if (requirements.needsRootConfig) {
+        results.rootConfigUpdated = migrateRootConfiguration(tree, requirements);
+        if (results.rootConfigUpdated)
+            results.totalChanges++;
+    }
+    // Step 2: Migrate plugin .kos.json files
+    results.pluginConfigsUpdated = migratePluginConfigurations(tree, requirements.pluginProjects);
+    results.totalChanges += results.pluginConfigsUpdated;
+    // Step 3: Migrate UI .kos.json files
+    results.uiConfigsUpdated = migrateUiConfigurations(tree, requirements.uiProjects);
+    results.totalChanges += results.uiConfigsUpdated;
+    // Step 4: Migrate plugin webpack configs
+    results.pluginWebpackUpdated = migratePluginWebpackConfigs(tree, requirements.pluginProjects);
+    results.totalChanges += results.pluginWebpackUpdated;
+    // Step 5: Migrate UI webpack configs
+    results.uiWebpackUpdated = migrateUiWebpackConfigs(tree, requirements);
+    results.totalChanges += results.uiWebpackUpdated;
+    // Step 6: Migrate model project.json files
+    results.modelProjectsUpdated = migrateModelProjects(tree, requirements.modelProjects);
+    results.totalChanges += results.modelProjectsUpdated;
+    return results;
+}
+exports.executeMigrationPlan = executeMigrationPlan;
+/**
+ * Migrates root .kos.json to add development configuration.
+ */
+function migrateRootConfiguration(tree, requirements) {
+    const rootConfig = (0, devkit_1.readJson)(tree, ".kos.json");
+    // Create host configurations
+    const hosts = createHostConfigurations(requirements.uiProjects, requirements.pluginProjects);
+    // Create port ranges
+    const portRanges = createPortRanges(hosts);
+    // Find default projects
+    const defaults = (0, project_analyzer_1.findDefaultProjects)(requirements);
+    // Update root config
+    const updatedConfig = {
+        ...rootConfig,
+        type: "root",
+        generator: {
+            defaults: {
+                model: defaults.defaultModel,
+                "model-component": defaults.defaultModelComponent,
+                ui: defaults.defaultUi,
+            },
+        },
+        development: {
+            hosts,
+            portRanges,
+            logDir: `/tmp/${requirements.workspaceName.replace(/^@[^/]+\//, "")}-logs`,
+        },
+    };
+    (0, config_updater_1.writeJsonConfig)(tree, ".kos.json", updatedConfig);
+    return true;
+}
+/**
+ * Creates host configurations from UI projects.
+ */
+function createHostConfigurations(uiProjects, pluginProjects) {
+    const hosts = uiProjects.map((ui, index) => {
+        const port = (0, port_allocator_1.calculateHostPort)(index);
+        const pluginContext = (0, project_analyzer_1.derivePluginContext)(ui);
+        const type = (0, project_analyzer_1.deriveUiType)(ui.kosJson);
+        return {
+            name: ui.name,
+            project: ui.name,
+            port,
+            type,
+            pluginContext,
+            plugins: [],
+        };
+    });
+    // Assign plugins to first available host
+    if (hosts.length > 0 && pluginProjects.length > 0) {
+        const primaryHost = hosts[0];
+        const plugins = (0, port_allocator_1.allocatePluginPorts)(primaryHost.port + 1, pluginProjects);
+        primaryHost.plugins = plugins;
+    }
+    return hosts;
+}
+/**
+ * Creates port range configurations for all hosts.
+ */
+function createPortRanges(hosts) {
+    const ranges = {};
+    hosts.forEach((host) => {
+        const maxPluginPort = (0, port_allocator_1.findMaxPluginPort)(host.port, host.plugins);
+        ranges[host.name] = (0, port_allocator_1.createPortRange)(host.port, host.plugins.length);
+    });
+    return ranges;
+}
+/**
+ * Migrates plugin .kos.json files.
+ */
+function migratePluginConfigurations(tree, pluginProjects) {
+    let updated = 0;
+    pluginProjects.forEach((plugin) => {
+        const kosJsonPath = `${plugin.root}/.kos.json`;
+        if (!tree.exists(kosJsonPath))
+            return;
+        const kosJson = (0, devkit_1.readJson)(tree, kosJsonPath);
+        if (!kosJson.test?.plugin?.context) {
+            kosJson.test = kosJson.test || {};
+            kosJson.test.plugin = kosJson.test.plugin || {};
+            // Derive context from root config or project name
+            let pluginContext = plugin.name;
+            if (tree.exists(".kos.json")) {
+                const rootConfig = (0, devkit_1.readJson)(tree, ".kos.json");
+                if (rootConfig.development?.hosts) {
+                    const host = rootConfig.development.hosts.find((h) => h.plugins?.some((p) => p.project === plugin.name));
+                    if (host) {
+                        pluginContext = host.pluginContext;
+                    }
+                }
+            }
+            kosJson.test.plugin.context = pluginContext;
+            (0, config_updater_1.writeJsonConfig)(tree, kosJsonPath, kosJson);
+            updated++;
+        }
+    });
+    return updated;
+}
+/**
+ * Migrates UI .kos.json files.
+ */
+function migrateUiConfigurations(tree, uiProjects) {
+    let updated = 0;
+    uiProjects.forEach((ui) => {
+        const kosJsonPath = `${ui.root}/.kos.json`;
+        if (!tree.exists(kosJsonPath))
+            return;
+        const kosJson = (0, devkit_1.readJson)(tree, kosJsonPath);
+        if (!kosJson.test?.plugin?.context) {
+            kosJson.test = kosJson.test || {};
+            kosJson.test.plugin = kosJson.test.plugin || {};
+            kosJson.test.plugin.context = ui.name;
+            (0, config_updater_1.writeJsonConfig)(tree, kosJsonPath, kosJson);
+            updated++;
+        }
+    });
+    return updated;
+}
+/**
+ * Migrates plugin webpack configs.
+ */
+function migratePluginWebpackConfigs(tree, pluginProjects) {
+    let updated = 0;
+    pluginProjects.forEach((plugin) => {
+        const webpackPath = `${plugin.root}/webpack.config.ts`;
+        if (tree.exists(webpackPath)) {
+            if ((0, webpack_updater_1.updatePluginWebpackConfig)(tree, webpackPath)) {
+                updated++;
+            }
+        }
+    });
+    return updated;
+}
+/**
+ * Migrates UI webpack configs for plugin-enabled UIs.
+ */
+function migrateUiWebpackConfigs(tree, requirements) {
+    let updated = 0;
+    requirements.uiProjects.forEach((ui) => {
+        // Check if this UI has plugins
+        let hasPlugins = false;
+        if (tree.exists(".kos.json")) {
+            const rootConfig = (0, devkit_1.readJson)(tree, ".kos.json");
+            if (rootConfig.development?.hosts) {
+                const host = rootConfig.development.hosts.find((h) => h.name === ui.name);
+                if (host && host.plugins?.length > 0) {
+                    hasPlugins = true;
+                }
+            }
+        }
+        if (!hasPlugins)
+            return; // Skip UIs without plugins
+        const webpackPath = `${ui.root}/webpack.config.ts`;
+        if (tree.exists(webpackPath)) {
+            if ((0, webpack_updater_1.updateUiWebpackConfig)(tree, webpackPath)) {
+                updated++;
+            }
+        }
+    });
+    return updated;
+}
+/**
+ * Migrates model project.json files to add api target.
+ */
+function migrateModelProjects(tree, modelProjects) {
+    let updated = 0;
+    modelProjects.forEach((model) => {
+        const projectJsonPath = `${model.root}/project.json`;
+        if (!tree.exists(projectJsonPath))
+            return;
+        (0, devkit_1.updateJson)(tree, projectJsonPath, (json) => {
+            if (!json.targets?.api) {
+                json.targets = json.targets || {};
+                json.targets.api = {
+                    command: `kosui api:generate --project=${model.name}`,
+                    options: {
+                        host: "http://127.0.0.1:8081",
+                        defaultVersion: "snapshot",
+                    },
+                };
+                updated++;
+            }
+            return json;
+        });
+    });
+    return updated;
+}
+//# sourceMappingURL=migration-executor.js.map

package/src/migrations/dev-server-support/coordinators/migration-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-executor.js","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/coordinators/migration-executor.ts"],"names":[],"mappings":"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"}

package/src/migrations/dev-server-support/coordinators/migration-reporter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+import type { MigrationRequirements, MigrationResults } from "../types";
+/**
+ * Zone 2: Migration reporting coordinator
+ */
+/**
+ * Announces the start of migration.
+ */
+export declare function announceMigrationStart(): void;
+/**
+ * Reports the completion of migration with detailed results.
+ */
+export declare function reportMigrationCompletion(requirements: MigrationRequirements, results: MigrationResults): void;
+//# sourceMappingURL=migration-reporter.d.ts.map

package/src/migrations/dev-server-support/coordinators/migration-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-reporter.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/coordinators/migration-reporter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAExE;;GAEG;AAEH;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,gBAAgB,GACxB,IAAI,CA+CN"}

package/src/migrations/dev-server-support/coordinators/migration-reporter.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportMigrationCompletion = exports.announceMigrationStart = void 0;
+const devkit_1 = require("@nx/devkit");
+/**
+ * Zone 2: Migration reporting coordinator
+ */
+/**
+ * Announces the start of migration.
+ */
+function announceMigrationStart() {
+    devkit_1.logger.info("Running dev-server-support migration...");
+}
+exports.announceMigrationStart = announceMigrationStart;
+/**
+ * Reports the completion of migration with detailed results.
+ */
+function reportMigrationCompletion(requirements, results) {
+    if (results.totalChanges === 0) {
+        devkit_1.logger.info("No migrations needed - workspace already up to date.");
+        return;
+    }
+    if (results.rootConfigUpdated) {
+        const hostCount = requirements.uiProjects.length;
+        const pluginCount = requirements.pluginProjects.length;
+        devkit_1.logger.info(`✓ Added development configuration with ${hostCount} host(s) and ${pluginCount} plugin(s)`);
+    }
+    if (results.pluginConfigsUpdated > 0) {
+        devkit_1.logger.info(`✓ Updated ${results.pluginConfigsUpdated} plugin .kos.json file(s) with test.plugin.context`);
+    }
+    if (results.uiConfigsUpdated > 0) {
+        devkit_1.logger.info(`✓ Updated ${results.uiConfigsUpdated} UI .kos.json file(s) with test.plugin.context`);
+    }
+    if (results.pluginWebpackUpdated > 0) {
+        devkit_1.logger.info(`✓ Updated ${results.pluginWebpackUpdated} plugin webpack.config.ts file(s) with dev server support`);
+    }
+    if (results.uiWebpackUpdated > 0) {
+        devkit_1.logger.info(`✓ Updated ${results.uiWebpackUpdated} UI webpack.config.ts file(s) with plugin dev aggregator`);
+    }
+    if (results.modelProjectsUpdated > 0) {
+        devkit_1.logger.info(`✓ Added api target to ${results.modelProjectsUpdated} model project.json file(s)`);
+    }
+    devkit_1.logger.info(`✅ Dev server support migration completed. Updated ${results.totalChanges} file(s).`);
+}
+exports.reportMigrationCompletion = reportMigrationCompletion;
+//# sourceMappingURL=migration-reporter.js.map

package/src/migrations/dev-server-support/coordinators/migration-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-reporter.js","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/coordinators/migration-reporter.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAAoC;AAGpC;;GAEG;AAEH;;GAEG;AACH,SAAgB,sBAAsB;IACpC,eAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;AACzD,CAAC;AAFD,wDAEC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CACvC,YAAmC,EACnC,OAAyB;IAEzB,IAAI,OAAO,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QAC/B,eAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC;QACjD,MAAM,WAAW,GAAG,YAAY,CAAC,cAAc,CAAC,MAAM,CAAC;QACvD,eAAM,CAAC,IAAI,CACT,0CAA0C,SAAS,gBAAgB,WAAW,YAAY,CAC3F,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACrC,eAAM,CAAC,IAAI,CACT,aAAa,OAAO,CAAC,oBAAoB,oDAAoD,CAC9F,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACjC,eAAM,CAAC,IAAI,CACT,aAAa,OAAO,CAAC,gBAAgB,gDAAgD,CACtF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACrC,eAAM,CAAC,IAAI,CACT,aAAa,OAAO,CAAC,oBAAoB,2DAA2D,CACrG,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACjC,eAAM,CAAC,IAAI,CACT,aAAa,OAAO,CAAC,gBAAgB,0DAA0D,CAChG,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACrC,eAAM,CAAC,IAAI,CACT,yBAAyB,OAAO,CAAC,oBAAoB,6BAA6B,CACnF,CAAC;IACJ,CAAC;IAED,eAAM,CAAC,IAAI,CACT,qDAAqD,OAAO,CAAC,YAAY,WAAW,CACrF,CAAC;AACJ,CAAC;AAlDD,8DAkDC"}

package/src/migrations/dev-server-support/helpers/config-updater.d.ts

@@ -0,0 +1,24 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+import { Tree } from "@nx/devkit";
+/**
+ * Zone 3: Configuration file update utilities
+ */
+/**
+ * Writes a JSON configuration file with consistent formatting.
+ */
+export declare function writeJsonConfig(tree: Tree, path: string, content: object): void;
+/**
+ * Reads and parses a JSON file, returning null if file doesn't exist.
+ */
+export declare function readJsonConfigSafe<T>(tree: Tree, path: string): T | null;
+/**
+ * Checks if a .kos.json file exists for a project.
+ */
+export declare function hasKosConfig(tree: Tree, projectRoot: string): boolean;
+/**
+ * Updates a text file with string replacement.
+ */
+export declare function updateTextFile(tree: Tree, path: string, oldString: string, newString: string): boolean;
+//# sourceMappingURL=config-updater.d.ts.map

package/src/migrations/dev-server-support/helpers/config-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-updater.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/helpers/config-updater.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAWxE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAErE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAaT"}

package/src/migrations/dev-server-support/helpers/config-updater.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateTextFile = exports.hasKosConfig = exports.readJsonConfigSafe = exports.writeJsonConfig = void 0;
+/**
+ * Zone 3: Configuration file update utilities
+ */
+/**
+ * Writes a JSON configuration file with consistent formatting.
+ */
+function writeJsonConfig(tree, path, content) {
+    tree.write(path, JSON.stringify(content, null, 2) + "\n");
+}
+exports.writeJsonConfig = writeJsonConfig;
+/**
+ * Reads and parses a JSON file, returning null if file doesn't exist.
+ */
+function readJsonConfigSafe(tree, path) {
+    if (!tree.exists(path)) {
+        return null;
+    }
+    const content = tree.read(path, "utf-8");
+    if (!content) {
+        return null;
+    }
+    return JSON.parse(content);
+}
+exports.readJsonConfigSafe = readJsonConfigSafe;
+/**
+ * Checks if a .kos.json file exists for a project.
+ */
+function hasKosConfig(tree, projectRoot) {
+    return tree.exists(`${projectRoot}/.kos.json`);
+}
+exports.hasKosConfig = hasKosConfig;
+/**
+ * Updates a text file with string replacement.
+ */
+function updateTextFile(tree, path, oldString, newString) {
+    const content = tree.read(path, "utf-8");
+    if (!content) {
+        return false;
+    }
+    if (!content.includes(oldString)) {
+        return false;
+    }
+    const updated = content.replace(oldString, newString);
+    tree.write(path, updated);
+    return true;
+}
+exports.updateTextFile = updateTextFile;
+//# sourceMappingURL=config-updater.js.map

package/src/migrations/dev-server-support/helpers/config-updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-updater.js","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/helpers/config-updater.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH;;GAEG;AAEH;;GAEG;AACH,SAAgB,eAAe,CAC7B,IAAU,EACV,IAAY,EACZ,OAAe;IAEf,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC5D,CAAC;AAND,0CAMC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAI,IAAU,EAAE,IAAY;IAC5D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC;AAXD,gDAWC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,IAAU,EAAE,WAAmB;IAC1D,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,YAAY,CAAC,CAAC;AACjD,CAAC;AAFD,oCAEC;AAED;;GAEG;AACH,SAAgB,cAAc,CAC5B,IAAU,EACV,IAAY,EACZ,SAAiB,EACjB,SAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAlBD,wCAkBC"}

package/src/migrations/dev-server-support/helpers/port-allocator.d.ts

@@ -0,0 +1,37 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+/**
+ * Zone 3: Port allocation utilities
+ */
+export interface PortRange {
+    start: number;
+    next: number;
+}
+export interface PluginPortAssignment {
+    project: string;
+    port: number;
+    alias: string;
+    enabled: boolean;
+}
+/**
+ * Calculates the starting port for a host based on index.
+ */
+export declare function calculateHostPort(hostIndex: number): number;
+/**
+ * Allocates sequential ports for plugins.
+ */
+export declare function allocatePluginPorts(startPort: number, pluginProjects: Array<{
+    name: string;
+}>): PluginPortAssignment[];
+/**
+ * Creates a port range configuration for a host.
+ */
+export declare function createPortRange(startPort: number, pluginCount: number): PortRange;
+/**
+ * Finds the maximum plugin port for a host configuration.
+ */
+export declare function findMaxPluginPort(hostPort: number, plugins: Array<{
+    port: number;
+}>): number;
+//# sourceMappingURL=port-allocator.d.ts.map

package/src/migrations/dev-server-support/helpers/port-allocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-allocator.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/helpers/port-allocator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACtC,oBAAoB,EAAE,CAcxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,SAAS,CAKX;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/B,MAAM,CAER"}

package/src/migrations/dev-server-support/helpers/port-allocator.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findMaxPluginPort = exports.createPortRange = exports.allocatePluginPorts = exports.calculateHostPort = void 0;
+/**
+ * Calculates the starting port for a host based on index.
+ */
+function calculateHostPort(hostIndex) {
+    return 4200 + hostIndex * 100;
+}
+exports.calculateHostPort = calculateHostPort;
+/**
+ * Allocates sequential ports for plugins.
+ */
+function allocatePluginPorts(startPort, pluginProjects) {
+    let currentPort = startPort;
+    return pluginProjects.map((plugin) => {
+        const pluginAlias = plugin.name.replace(/-plugin$/, "");
+        const assignment = {
+            project: plugin.name,
+            port: currentPort,
+            alias: pluginAlias,
+            enabled: true,
+        };
+        currentPort++;
+        return assignment;
+    });
+}
+exports.allocatePluginPorts = allocatePluginPorts;
+/**
+ * Creates a port range configuration for a host.
+ */
+function createPortRange(startPort, pluginCount) {
+    return {
+        start: startPort,
+        next: startPort + pluginCount + 1,
+    };
+}
+exports.createPortRange = createPortRange;
+/**
+ * Finds the maximum plugin port for a host configuration.
+ */
+function findMaxPluginPort(hostPort, plugins) {
+    return plugins.reduce((max, plugin) => Math.max(max, plugin.port), hostPort);
+}
+exports.findMaxPluginPort = findMaxPluginPort;
+//# sourceMappingURL=port-allocator.js.map

package/src/migrations/dev-server-support/helpers/port-allocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-allocator.js","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/helpers/port-allocator.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAkBH;;GAEG;AACH,SAAgB,iBAAiB,CAAC,SAAiB;IACjD,OAAO,IAAI,GAAG,SAAS,GAAG,GAAG,CAAC;AAChC,CAAC;AAFD,8CAEC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,SAAiB,EACjB,cAAuC;IAEvC,IAAI,WAAW,GAAG,SAAS,CAAC;IAE5B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACnC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG;YACjB,OAAO,EAAE,MAAM,CAAC,IAAI;YACpB,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,IAAI;SACd,CAAC;QACF,WAAW,EAAE,CAAC;QACd,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC;AAjBD,kDAiBC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC7B,SAAiB,EACjB,WAAmB;IAEnB,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,CAAC;KAClC,CAAC;AACJ,CAAC;AARD,0CAQC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,QAAgB,EAChB,OAAgC;IAEhC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC/E,CAAC;AALD,8CAKC"}