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

package/src/migrations/dev-server-support/helpers/project-analyzer.d.ts

@@ -0,0 +1,74 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+import { ProjectConfiguration, Tree } from "@nx/devkit";
+/**
+ * Zone 3: Project analysis utilities
+ */
+export interface KosJson {
+    name?: string;
+    type?: string;
+    version?: string;
+    generator?: {
+        projectType?: string;
+        defaults?: any;
+    };
+    test?: {
+        plugin?: {
+            context?: string;
+        };
+    };
+    development?: any;
+    kosdev?: any;
+    kos?: any;
+    models?: any;
+}
+export interface ProjectInfo {
+    name: string;
+    root: string;
+    kosJson: KosJson | null;
+}
+/**
+ * Checks if a project is a UI project.
+ */
+export declare function isUiProject(kosJson: KosJson | null): boolean;
+/**
+ * Checks if a project is a plugin project.
+ */
+export declare function isPluginProject(kosJson: KosJson | null): boolean;
+/**
+ * Checks if a project is a model project.
+ */
+export declare function isModelProject(kosJson: KosJson | null): boolean;
+/**
+ * Reads project's .kos.json file.
+ */
+export declare function readProjectKosJson(tree: Tree, projectRoot: string): KosJson | null;
+/**
+ * Categorizes projects by type.
+ */
+export declare function categorizeProjects(tree: Tree, projects: Map<string, ProjectConfiguration>): {
+    uiProjects: ProjectInfo[];
+    pluginProjects: ProjectInfo[];
+    modelProjects: ProjectInfo[];
+};
+/**
+ * Determines the plugin context for a UI project.
+ */
+export declare function derivePluginContext(projectInfo: ProjectInfo): string;
+/**
+ * Determines the UI type for a host configuration.
+ */
+export declare function deriveUiType(kosJson: KosJson | null): string;
+/**
+ * Finds the first available default project of each type.
+ */
+export declare function findDefaultProjects(categorized: {
+    uiProjects: ProjectInfo[];
+    modelProjects: ProjectInfo[];
+}): {
+    defaultModel: string;
+    defaultModelComponent: string;
+    defaultUi: string;
+};
+//# sourceMappingURL=project-analyzer.d.ts.map

package/src/migrations/dev-server-support/helpers/project-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-analyzer.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/helpers/project-analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGxD;;GAEG;AAEH,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;KAChB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE;YACP,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;IACF,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAO5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAMhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAK/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,GAClB,OAAO,GAAG,IAAI,CAEhB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC1C;IACD,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B,CAwBA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAKpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAU5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE;IAC/C,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B,GAAG;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,CAeA"}

package/src/migrations/dev-server-support/helpers/project-analyzer.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findDefaultProjects = exports.deriveUiType = exports.derivePluginContext = exports.categorizeProjects = exports.readProjectKosJson = exports.isModelProject = exports.isPluginProject = exports.isUiProject = void 0;
+const config_updater_1 = require("./config-updater");
+/**
+ * Checks if a project is a UI project.
+ */
+function isUiProject(kosJson) {
+    if (!kosJson)
+        return false;
+    return (kosJson.type === "kos.ui" ||
+        kosJson.type?.includes("ui") ||
+        kosJson.generator?.projectType === "ui");
+}
+exports.isUiProject = isUiProject;
+/**
+ * Checks if a project is a plugin project.
+ */
+function isPluginProject(kosJson) {
+    if (!kosJson)
+        return false;
+    return (kosJson.type === "ddk.ncui.plugin" ||
+        kosJson.generator?.projectType === "plugin");
+}
+exports.isPluginProject = isPluginProject;
+/**
+ * Checks if a project is a model project.
+ */
+function isModelProject(kosJson) {
+    if (!kosJson)
+        return false;
+    return (kosJson.type === "kos.model" || kosJson.generator?.projectType === "model");
+}
+exports.isModelProject = isModelProject;
+/**
+ * Reads project's .kos.json file.
+ */
+function readProjectKosJson(tree, projectRoot) {
+    return (0, config_updater_1.readJsonConfigSafe)(tree, `${projectRoot}/.kos.json`);
+}
+exports.readProjectKosJson = readProjectKosJson;
+/**
+ * Categorizes projects by type.
+ */
+function categorizeProjects(tree, projects) {
+    const uiProjects = [];
+    const pluginProjects = [];
+    const modelProjects = [];
+    projects.forEach((project, projectName) => {
+        const kosJson = readProjectKosJson(tree, project.root);
+        const projectInfo = {
+            name: projectName,
+            root: project.root,
+            kosJson,
+        };
+        if (isUiProject(kosJson)) {
+            uiProjects.push(projectInfo);
+        }
+        else if (isPluginProject(kosJson)) {
+            pluginProjects.push(projectInfo);
+        }
+        else if (isModelProject(kosJson)) {
+            modelProjects.push(projectInfo);
+        }
+    });
+    return { uiProjects, pluginProjects, modelProjects };
+}
+exports.categorizeProjects = categorizeProjects;
+/**
+ * Determines the plugin context for a UI project.
+ */
+function derivePluginContext(projectInfo) {
+    if (projectInfo.kosJson?.test?.plugin?.context) {
+        return projectInfo.kosJson.test.plugin.context;
+    }
+    return projectInfo.name;
+}
+exports.derivePluginContext = derivePluginContext;
+/**
+ * Determines the UI type for a host configuration.
+ */
+function deriveUiType(kosJson) {
+    if (!kosJson)
+        return "cui";
+    if (kosJson.type?.includes("ncui")) {
+        return "ncui";
+    }
+    else if (kosJson.type?.includes("admin")) {
+        return "admin";
+    }
+    return "cui";
+}
+exports.deriveUiType = deriveUiType;
+/**
+ * Finds the first available default project of each type.
+ */
+function findDefaultProjects(categorized) {
+    const defaultModel = categorized.modelProjects.find((p) => p.kosJson?.type === "kos.model")
+        ?.name || "";
+    const defaultModelComponent = categorized.modelProjects.find((p) => p.kosJson?.type === "kos.model-component")?.name || "";
+    const defaultUi = categorized.uiProjects.find((p) => p.kosJson?.type === "kos.ui")?.name ||
+        "";
+    return { defaultModel, defaultModelComponent, defaultUi };
+}
+exports.findDefaultProjects = findDefaultProjects;
+//# sourceMappingURL=project-analyzer.js.map

package/src/migrations/dev-server-support/helpers/project-analyzer.js.map

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

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

@@ -0,0 +1,48 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+import { Tree } from "@nx/devkit";
+/**
+ * Zone 3: Webpack configuration update utilities
+ */
+/**
+ * Checks if webpack config already has plugin dev server support.
+ */
+export declare function hasPluginDevServer(webpackContent: string): boolean;
+/**
+ * Checks if webpack config already has plugin dev aggregator support.
+ */
+export declare function hasPluginDevAggregator(webpackContent: string): boolean;
+/**
+ * Adds plugin dev server imports to webpack config.
+ */
+export declare function addPluginDevServerImports(webpackContent: string): string;
+/**
+ * Adds plugin dev server to webpack composition.
+ */
+export declare function addPluginDevServerComposition(webpackContent: string): string;
+/**
+ * Adds plugin dev aggregator import to UI webpack config.
+ */
+export declare function addPluginAggregatorImport(webpackContent: string): string;
+/**
+ * Adds plugin dev configuration section to UI webpack config.
+ */
+export declare function addPluginDevConfiguration(webpackContent: string): string;
+/**
+ * Adds plugin dev aggregator to webpack composition.
+ */
+export declare function addPluginAggregatorComposition(webpackContent: string): string;
+/**
+ * Adds USE_LOCAL_PLUGINS to environment plugin.
+ */
+export declare function addUseLocalPluginsEnv(webpackContent: string): string;
+/**
+ * Updates plugin webpack configuration file.
+ */
+export declare function updatePluginWebpackConfig(tree: Tree, webpackPath: string): boolean;
+/**
+ * Updates UI webpack configuration file for plugin support.
+ */
+export declare function updateUiWebpackConfig(tree: Tree, webpackPath: string): boolean;
+//# sourceMappingURL=webpack-updater.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webpack-updater.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/helpers/webpack-updater.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC;;GAEG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAMxE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAa5E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAMxE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CA2BxE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAe7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,GAClB,OAAO,CAeT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,GAClB,OAAO,CAiBT"}

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

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateUiWebpackConfig = exports.updatePluginWebpackConfig = exports.addUseLocalPluginsEnv = exports.addPluginAggregatorComposition = exports.addPluginDevConfiguration = exports.addPluginAggregatorImport = exports.addPluginDevServerComposition = exports.addPluginDevServerImports = exports.hasPluginDevAggregator = exports.hasPluginDevServer = void 0;
+/**
+ * Zone 3: Webpack configuration update utilities
+ */
+/**
+ * Checks if webpack config already has plugin dev server support.
+ */
+function hasPluginDevServer(webpackContent) {
+    return webpackContent.includes("withPluginDevServer");
+}
+exports.hasPluginDevServer = hasPluginDevServer;
+/**
+ * Checks if webpack config already has plugin dev aggregator support.
+ */
+function hasPluginDevAggregator(webpackContent) {
+    return webpackContent.includes("withPluginDevAggregator");
+}
+exports.hasPluginDevAggregator = hasPluginDevAggregator;
+/**
+ * Adds plugin dev server imports to webpack config.
+ */
+function addPluginDevServerImports(webpackContent) {
+    return webpackContent.replace(/import { generatePluginConfiguration } from "@kosdev-code\/kos-ui-plugin\/utilities";/, `import { generatePluginConfiguration } from "@kosdev-code/kos-ui-plugin/utilities";
+import { withKosConfig, withPluginDevServer } from "@kosdev-code/kos-ui-plugin/webpack";`);
+}
+exports.addPluginDevServerImports = addPluginDevServerImports;
+/**
+ * Adds plugin dev server to webpack composition.
+ */
+function addPluginDevServerComposition(webpackContent) {
+    return webpackContent.replace(/export default composePlugins\(\s*withNx\(\),\s*withReact\(\{\}\),\s*withModuleFederation\(config\)\s*\);/, `export default composePlugins(
+  withNx(),
+  withReact({}),
+  withModuleFederation(config),
+  withKosConfig(webpack),
+  withPluginDevServer({
+    verbose: process.env.VERBOSE_PLUGIN_DEV === 'true'
+  })
+);`);
+}
+exports.addPluginDevServerComposition = addPluginDevServerComposition;
+/**
+ * Adds plugin dev aggregator import to UI webpack config.
+ */
+function addPluginAggregatorImport(webpackContent) {
+    return webpackContent.replace(/import { merge } from 'webpack-merge';/, `import { merge } from 'webpack-merge';
+import { withPluginDevAggregator } from '@kosdev-code/kos-ui-plugin/webpack';`);
+}
+exports.addPluginAggregatorImport = addPluginAggregatorImport;
+/**
+ * Adds plugin dev configuration section to UI webpack config.
+ */
+function addPluginDevConfiguration(webpackContent) {
+    const pluginDevConfig = `
+// Configure plugin dev servers based on environment variables
+// These are set automatically by \`kosui dev\` command
+const useLocalPlugins = process.env.USE_LOCAL_PLUGINS === 'true';
+const mergeWithBackend = process.env.MERGE_WITH_BACKEND === 'true';
+
+// Plugin dev servers are configured via environment variables
+// Format: <PLUGIN_ALIAS>_DEV=true where alias is from .kos.json
+// Example: BEVERAGE_POUR_DEV=true
+const pluginServers = Object.keys(process.env)
+  .filter(key => key.endsWith('_DEV') && process.env[key] === 'true')
+  .map(key => {
+    // Extract plugin alias from env var (e.g., BEVERAGE_POUR_DEV -> beverage-pour)
+    const alias = key.replace(/_DEV$/, '').toLowerCase().replace(/_/g, '-');
+    // Port is set via <PLUGIN_ALIAS>_PORT env var
+    const portKey = key.replace(/_DEV$/, '_PORT');
+    const port = process.env[portKey] || '4201';
+    return \`http://localhost:\${port}\`;
+  });
+`;
+    return webpackContent.replace(/\/\/ Nx plugins for webpack to build config object from Nx options and context\./, `${pluginDevConfig}
+// Nx plugins for webpack to build config object from Nx options and context.`);
+}
+exports.addPluginDevConfiguration = addPluginDevConfiguration;
+/**
+ * Adds plugin dev aggregator to webpack composition.
+ */
+function addPluginAggregatorComposition(webpackContent) {
+    return webpackContent.replace(/withModuleFederation\(config\),/, `withModuleFederation(config),
+  // Add plugin dev aggregator for multi-plugin development
+  useLocalPlugins
+    ? withPluginDevAggregator({
+        pluginServers,
+        mergeWithBackend,
+        fallbackToBackend: pluginServers.length === 0,
+        backendUrl: 'http://localhost:8081',
+        verbose: process.env.VERBOSE_PLUGIN_DEV === 'true',
+      })
+    : (config) => config,`);
+}
+exports.addPluginAggregatorComposition = addPluginAggregatorComposition;
+/**
+ * Adds USE_LOCAL_PLUGINS to environment plugin.
+ */
+function addUseLocalPluginsEnv(webpackContent) {
+    return webpackContent.replace(/new webpack\.EnvironmentPlugin\(\{/, `new webpack.EnvironmentPlugin({
+          USE_LOCAL_PLUGINS: 'false', // Default to false, set to 'true' in dev mode`);
+}
+exports.addUseLocalPluginsEnv = addUseLocalPluginsEnv;
+/**
+ * Updates plugin webpack configuration file.
+ */
+function updatePluginWebpackConfig(tree, webpackPath) {
+    let content = tree.read(webpackPath, "utf-8");
+    if (!content) {
+        return false;
+    }
+    if (hasPluginDevServer(content)) {
+        return false; // Already migrated
+    }
+    content = addPluginDevServerImports(content);
+    content = addPluginDevServerComposition(content);
+    tree.write(webpackPath, content);
+    return true;
+}
+exports.updatePluginWebpackConfig = updatePluginWebpackConfig;
+/**
+ * Updates UI webpack configuration file for plugin support.
+ */
+function updateUiWebpackConfig(tree, webpackPath) {
+    let content = tree.read(webpackPath, "utf-8");
+    if (!content) {
+        return false;
+    }
+    if (hasPluginDevAggregator(content)) {
+        return false; // Already migrated
+    }
+    content = addPluginAggregatorImport(content);
+    content = addPluginDevConfiguration(content);
+    content = addPluginAggregatorComposition(content);
+    content = addUseLocalPluginsEnv(content);
+    tree.write(webpackPath, content);
+    return true;
+}
+exports.updateUiWebpackConfig = updateUiWebpackConfig;
+//# sourceMappingURL=webpack-updater.js.map

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

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

package/src/migrations/dev-server-support/migrate.d.ts

@@ -0,0 +1,57 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+import { Tree } from "@nx/devkit";
+/**
+ * Automatic migration to add dev server support to existing KOS workspaces.
+ *
+ * This migration runs automatically when users upgrade to
+ * @kosdev-code/kos-nx-plugin@2.1.28+ via `nx migrate`.
+ *
+ * ## What This Migration Does
+ *
+ * 1. **Root .kos.json** - Adds development configuration with auto-detected hosts/plugins
+ * 2. **Plugin .kos.json** - Adds test.plugin.context for plugin testing
+ * 3. **Plugin webpack** - Adds withKosConfig and withPluginDevServer
+ * 4. **UI webpack** - Adds withPluginDevAggregator for plugin-enabled UIs
+ * 5. **Model project.json** - Adds api target for kosui api:generate
+ *
+ * ## Migration Safety
+ *
+ * - Idempotent: Can run multiple times safely
+ * - Non-destructive: Preserves existing configurations
+ * - Checks before modifying files
+ * - Reports all changes via logger
+ *
+ * ## Post-Migration Verification
+ *
+ * After migration completes, users should:
+ * 1. Review `.kos.json` development configuration
+ * 2. Verify port assignments match existing setup
+ * 3. Test `npm run dev` or `kosui dev` command
+ * 4. Check that all expected plugins are registered
+ *
+ * ## Troubleshooting
+ *
+ * If migration causes issues:
+ * - Check migration output for any errors or warnings
+ * - Verify Nx workspace structure is valid
+ * - Confirm all projects have .kos.json files
+ * - Review generated .kos.json against workspace structure
+ *
+ * @param tree - Nx virtual file system tree
+ * @returns Promise that resolves when migration completes
+ *
+ * @category Migrations
+ * @version 2.1.28
+ *
+ * @example
+ * ```typescript
+ * // Migration runs automatically via nx migrate
+ * // Users execute:
+ * // $ nx migrate @kosdev-code/kos-nx-plugin@latest
+ * // $ nx migrate --run-migrations
+ * ```
+ */
+export default function migrate(tree: Tree): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/src/migrations/dev-server-support/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/migrate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAQlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAA8B,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/D"}

package/src/migrations/dev-server-support/migrate.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const migration_analyzer_1 = require("./coordinators/migration-analyzer");
+const migration_executor_1 = require("./coordinators/migration-executor");
+const migration_reporter_1 = require("./coordinators/migration-reporter");
+/**
+ * Automatic migration to add dev server support to existing KOS workspaces.
+ *
+ * This migration runs automatically when users upgrade to
+ * @kosdev-code/kos-nx-plugin@2.1.28+ via `nx migrate`.
+ *
+ * ## What This Migration Does
+ *
+ * 1. **Root .kos.json** - Adds development configuration with auto-detected hosts/plugins
+ * 2. **Plugin .kos.json** - Adds test.plugin.context for plugin testing
+ * 3. **Plugin webpack** - Adds withKosConfig and withPluginDevServer
+ * 4. **UI webpack** - Adds withPluginDevAggregator for plugin-enabled UIs
+ * 5. **Model project.json** - Adds api target for kosui api:generate
+ *
+ * ## Migration Safety
+ *
+ * - Idempotent: Can run multiple times safely
+ * - Non-destructive: Preserves existing configurations
+ * - Checks before modifying files
+ * - Reports all changes via logger
+ *
+ * ## Post-Migration Verification
+ *
+ * After migration completes, users should:
+ * 1. Review `.kos.json` development configuration
+ * 2. Verify port assignments match existing setup
+ * 3. Test `npm run dev` or `kosui dev` command
+ * 4. Check that all expected plugins are registered
+ *
+ * ## Troubleshooting
+ *
+ * If migration causes issues:
+ * - Check migration output for any errors or warnings
+ * - Verify Nx workspace structure is valid
+ * - Confirm all projects have .kos.json files
+ * - Review generated .kos.json against workspace structure
+ *
+ * @param tree - Nx virtual file system tree
+ * @returns Promise that resolves when migration completes
+ *
+ * @category Migrations
+ * @version 2.1.28
+ *
+ * @example
+ * ```typescript
+ * // Migration runs automatically via nx migrate
+ * // Users execute:
+ * // $ nx migrate @kosdev-code/kos-nx-plugin@latest
+ * // $ nx migrate --run-migrations
+ * ```
+ */
+async function migrate(tree) {
+    // Zone 1: High-level orchestration
+    (0, migration_reporter_1.announceMigrationStart)();
+    const requirements = (0, migration_analyzer_1.analyzeMigrationRequirements)(tree);
+    const results = (0, migration_executor_1.executeMigrationPlan)(tree, requirements);
+    (0, migration_reporter_1.reportMigrationCompletion)(requirements, results);
+}
+exports.default = migrate;
+//# sourceMappingURL=migrate.js.map

package/src/migrations/dev-server-support/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/migrate.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAGH,0EAAiF;AACjF,0EAAyE;AACzE,0EAG2C;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACY,KAAK,UAAU,OAAO,CAAC,IAAU;IAC9C,mCAAmC;IACnC,IAAA,2CAAsB,GAAE,CAAC;IAEzB,MAAM,YAAY,GAAG,IAAA,iDAA4B,EAAC,IAAI,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAA,yCAAoB,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAEzD,IAAA,8CAAyB,EAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AARD,0BAQC"}

package/src/migrations/dev-server-support/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+import type { KosDevConfig } from "../../types/kos-config";
+import type { ProjectInfo } from "./helpers/project-analyzer";
+/**
+ * Migration type definitions
+ */
+export interface MigrationRequirements {
+    needsRootConfig: boolean;
+    uiProjects: ProjectInfo[];
+    pluginProjects: ProjectInfo[];
+    modelProjects: ProjectInfo[];
+    workspaceName: string;
+}
+export interface HostConfiguration {
+    name: string;
+    project: string;
+    port: number;
+    type: string;
+    pluginContext: string;
+    plugins: Array<{
+        project: string;
+        port: number;
+        alias: string;
+        enabled: boolean;
+    }>;
+}
+export interface MigrationResults {
+    rootConfigUpdated: boolean;
+    pluginConfigsUpdated: number;
+    uiConfigsUpdated: number;
+    pluginWebpackUpdated: number;
+    uiWebpackUpdated: number;
+    modelProjectsUpdated: number;
+    totalChanges: number;
+}
+export { KosDevConfig, ProjectInfo };
+//# sourceMappingURL=types.d.ts.map

package/src/migrations/dev-server-support/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;GAEG;AAEH,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/src/migrations/dev-server-support/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * (C) Copyright 2025, TCCC, All rights reserved.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/src/migrations/dev-server-support/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/migrations/dev-server-support/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}