@kosdev-code/kos-nx-plugin 2.1.19 → 2.1.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-nx-plugin",
-  "version": "2.1.19",
+  "version": "2.1.21",
   "type": "commonjs",
   "generators": "./generators.json",
   "publishConfig": {
@@ -19,7 +19,7 @@
   "main": "./src/index.js",
   "kos": {
     "build": {
-      "gitHash": "6a8e249e4d22e16b7c678edf286c58258f65b6db"
+      "gitHash": "ad41d22bfee8c28adb7ca01b7a9685d5b9e46f35"
     }
   }
 }

package/src/generators/kos-plugin-project/files/.kos.json.template

@@ -30,6 +30,11 @@
       "namespaces": {}
     }
   },
+  "test": {
+    "plugin": {
+      "context": "<%= pluginContext %>"
+    }
+  },
   "generator": {
     "projectType": "plugin",
     "defaults": {

package/src/generators/kos-plugin-project/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/kos-plugin-project/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,IAAI,EAEL,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAC3D,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,+BAA+B,iBA6HzC;AAED,eAAe,yBAAyB,CAAC"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/kos-plugin-project/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,IAAI,EAEL,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAG3D,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,+BAA+B,iBAgNzC;AAED,eAAe,yBAAyB,CAAC"}

package/src/generators/kos-plugin-project/generator.js

@@ -6,9 +6,50 @@ const eslint_1 = require("@nx/eslint");
 const react_1 = require("@nx/react");
 const path = require("path");
 const normalize_value_1 = require("../kos-model/lib/normalize-value");
+const kos_config_helpers_1 = require("../../utils/kos-config-helpers");
 async function kosPluginProjectGenerator(tree, options) {
+    // Read root .kos.json to get available hosts
+    let rootConfig;
+    let hostName = options.host;
+    if (tree.exists('.kos.json')) {
+        const rootConfigContent = tree.read('.kos.json', 'utf-8');
+        if (rootConfigContent) {
+            rootConfig = JSON.parse(rootConfigContent);
+        }
+    }
+    // Validate host if provided, or use first available host
+    if (rootConfig && (0, kos_config_helpers_1.hasDevelopmentConfig)(rootConfig)) {
+        if (hostName) {
+            // Validate that the specified host exists
+            const hostConfig = (0, kos_config_helpers_1.findHost)(rootConfig, hostName);
+            if (!hostConfig) {
+                const availableHosts = rootConfig.development.hosts.map(h => h.name).join(', ');
+                throw new Error(`Host '${hostName}' not found in .kos.json. Available hosts: ${availableHosts}`);
+            }
+        }
+        else {
+            // Use first host as default if not specified
+            hostName = rootConfig.development.hosts[0].name;
+            console.log(`No host specified, using default host: ${hostName}`);
+        }
+    }
+    else if (hostName) {
+        // Host was specified but no development config exists
+        console.warn('Warning: Host specified but .kos.json has no development configuration. ' +
+            'Plugin will be created but not registered with a host.');
+        hostName = undefined;
+    }
+    // Get plugin context from host if available
+    let pluginContextValue = 'kosdev.ddk'; // Default
+    if (rootConfig && (0, kos_config_helpers_1.hasDevelopmentConfig)(rootConfig) && hostName) {
+        const hostConfig = (0, kos_config_helpers_1.findHost)(rootConfig, hostName);
+        if (hostConfig) {
+            pluginContextValue = hostConfig.pluginContext;
+        }
+    }
     const normalizedOptions = (0, normalize_value_1.normalizeAllValues)({
         name: options.name,
+        pluginContext: pluginContextValue,
     });
     const normalized = {
         ...normalizedOptions,
@@ -38,6 +79,32 @@ async function kosPluginProjectGenerator(tree, options) {
         interactionTests: false,
     });
     const projectConfiguration = (0, devkit_1.readProjectConfiguration)(tree, normalized.projectName);
+    // Auto-assign port and register plugin with host
+    let pluginPort;
+    if (rootConfig && (0, kos_config_helpers_1.hasDevelopmentConfig)(rootConfig) && hostName) {
+        const hostConfig = (0, kos_config_helpers_1.findHost)(rootConfig, hostName);
+        if (hostConfig) {
+            // Auto-assign port from host's port range
+            pluginPort = rootConfig.development.portRanges[hostName].next;
+            rootConfig.development.portRanges[hostName].next++;
+            // Generate plugin alias from project name
+            // Convert project name to kebab-case alias (e.g., "beverage-pour" -> "beverage")
+            const pluginAlias = normalized.nameDashCase.replace(/-plugin$/, '');
+            // Register plugin with host
+            hostConfig.plugins.push({
+                project: normalized.name,
+                port: pluginPort,
+                alias: pluginAlias,
+                enabled: true,
+            });
+            // Write updated .kos.json
+            tree.write('.kos.json', JSON.stringify(rootConfig, null, 2) + '\n');
+            console.log(`✓ Registered plugin '${normalized.name}' with host '${hostName}'`);
+            console.log(`  - Port: ${pluginPort}`);
+            console.log(`  - Alias: ${pluginAlias}`);
+            console.log(`  - Context: ${normalized.pluginContext}`);
+        }
+    }
     const externalJson = {
         kab: {
             command: `node tools/scripts/kabtool.mjs build ${normalized.nameDashCase} && node tools/scripts/kabtool.mjs list ${normalized.nameDashCase} `,
@@ -73,6 +140,10 @@ async function kosPluginProjectGenerator(tree, options) {
         if (json.targets?.build?.configurations?.production) {
             json.targets.build.configurations.production.webpackConfig = `plugins/${normalized.nameDashCase}/webpack.config.prod.ts`;
         }
+        // Update serve target with assigned port
+        if (pluginPort && json.targets?.serve?.options) {
+            json.targets.serve.options.port = pluginPort;
+        }
         return json;
     });
     (0, devkit_1.updateJson)(tree, `${projectConfiguration.root}/tsconfig.json`, (json) => {

package/src/generators/kos-plugin-project/generator.js.map

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

package/src/generators/kos-plugin-project/schema.d.ts

@@ -2,4 +2,5 @@ export interface KosPluginProjectGeneratorSchema {
   name: string;
   directory?: string;
   uiType?: string;
+  host?: string;
 }

package/src/generators/kos-plugin-project/schema.json

@@ -27,6 +27,11 @@
       "type": "string",
       "description": "KAB type of UI",
       "default": "ddk.ncui.plugin"
+    },
+    "host": {
+      "type": "string",
+      "description": "Which host application should this plugin serve?",
+      "x-prompt": "Which host app should this plugin serve?"
     }
   },
   "required": ["name"]

package/src/generators/preset/files/src/app/app.tsx.template

@@ -4,7 +4,11 @@ import {
   LoadingMessage,
   getLogLevel,
   initKosProvider,
-} from "@kosdev-code/kos-ui-sdk";
+} from "@kosdev-code/kos-ui-sdk";<% if (enablePlugins) { %>
+import {
+  FloatingPluginExplorer,
+  KosPluginProvider,
+} from "@kosdev-code/kos-ui-plugin";<% } %>
 import log from "loglevel";
 import { Suspense } from "react";
 import { KosCoreContextProvider } from "./registration";
@@ -14,25 +18,54 @@ import { MainView } from "./components/main-view";
 
 const level = getLogLevel();
 
-log.setLevel(level);
-
-const App = () => (
-  <ErrorBoundaryWithFallback>
-    <Suspense fallback={<LoadingMessage theme={"dark"}></LoadingMessage>}>
-      <KosCoreContextProvider>
-        <KosTranslationProvider>
-          <div className="App">
-            <Router window={window}>
-              <Routes>
-                <Route index element={<MainView />} />
-                <Route path="/main" element={<MainView />} />
-              </Routes>
-            </Router>
-          </div>
-         </KosTranslationProvider>
-      </KosCoreContextProvider>
-    </Suspense>
-  </ErrorBoundaryWithFallback>
-);
+log.setLevel(level);<% if (enablePlugins) { %>
+
+// Configure plugin loading based on environment and URL parameters
+// This supports both internal development (via `kosui dev`) and third-party development (via query params)
+const getPluginConfig = () => {
+  // Check environment variable (set by `kosui dev` command)
+  const useLocalPlugins = process.env.USE_LOCAL_PLUGINS === 'true';
+
+  // Check URL parameter for third-party dev: ?pluginDevServers=http://localhost:4201,...
+  const params = new URLSearchParams(window.location.search);
+  const devServers = params.get('pluginDevServers');
+
+  if (useLocalPlugins || devServers) {
+    return {
+      // Explicitly set pluginBaseUrl to prevent ?host= query param from overriding
+      pluginBaseUrl: window.location.origin,
+      pluginApiPath: '/api/kos/ui/plugins/contexts',
+      pluginContext: { group: '<%= nameDashCase %>' }, // Plugin context from .kos.json
+    };
+  }
+
+  return undefined;
+};<% } %>
+
+const App = () => {<% if (enablePlugins) { %>
+  const pluginConfig = getPluginConfig();<% } %>
+
+  return (
+    <ErrorBoundaryWithFallback>
+      <Suspense fallback={<LoadingMessage theme={"dark"}></LoadingMessage>}>
+        <KosCoreContextProvider><% if (enablePlugins) { %>
+          <KosPluginProvider pluginConfig={pluginConfig}>
+            <FloatingPluginExplorer /><% } %>
+            <KosTranslationProvider>
+              <div className="App">
+                <Router window={window}>
+                  <Routes>
+                    <Route index element={<MainView />} />
+                    <Route path="/main" element={<MainView />} />
+                  </Routes>
+                </Router>
+              </div>
+            </KosTranslationProvider><% if (enablePlugins) { %>
+          </KosPluginProvider><% } %>
+        </KosCoreContextProvider>
+      </Suspense>
+    </ErrorBoundaryWithFallback>
+  );
+};
 
 export default App;

package/src/generators/preset/files/webpack.config.ts.template

@@ -2,8 +2,10 @@ import { composePlugins, withNx } from '@nx/webpack';
 import { withReact } from '@nx/react';
 import * as webpack from 'webpack';
 import { withModuleFederation } from '@nx/react/module-federation';
+import { merge } from 'webpack-merge';
 
-import baseConfig from './module-federation.config';
+import baseConfig from './module-federation.config';<% if (enablePlugins) { %>
+import { withPluginDevAggregator } from '@kosdev-code/kos-ui-plugin/webpack';<% } %>
 
 import * as dotenv from 'dotenv';
 
@@ -20,26 +22,67 @@ function getKosEnv() {
     key.startsWith('KOS_')
   );
   return kosKeys;
-}
+}<% if (enablePlugins) { %>
+
+// 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}`;
+  });<% } %>
 
 // Nx plugins for webpack to build config object from Nx options and context.
 export default composePlugins(
   withNx({}),
   withReact(),
-  withModuleFederation(config),
-  (config, { options, context }) => {
-    if (config) {
-      config.resolve = config.resolve || {};
-      config.resolve.fallback = {
-        ...config.resolve.fallback,
-        path: false,
-      };
-    }
-    config.mode = (process.env.NODE_ENV || config.mode) as any;
-    // customize webpack config here
-    config?.plugins?.push(
-      new webpack.EnvironmentPlugin(['NODE_ENV', ...getKosEnv()])
-    );
-    return config;
-  }
+  withModuleFederation(config),<% if (enablePlugins) { %>
+  // 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,<% } %>
+  (config, { options, context }) =>
+    merge(config, {
+      resolve: {
+        fallback: {
+          path: false,
+          os: false,
+          crypto: false,
+        },
+      },
+      module: {
+        rules: [
+          {
+            test: /\.svg$/i,
+            issuer: /\.[jt]sx?$/,
+            use: [{ loader: '@svgr/webpack' }],
+          },
+        ],
+      },
+      mode: (process.env.NODE_ENV || config.mode) as any,
+      plugins: [
+        new webpack.EnvironmentPlugin({
+          NODE_ENV: 'production',<% if (enablePlugins) { %>
+          USE_LOCAL_PLUGINS: 'false', // Default to false, set to 'true' in dev mode<% } %>
+          ...Object.fromEntries(getKosEnv().map((key) => [key, process.env[key]])),
+        }),
+      ],
+    })
 );

package/src/generators/preset/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/preset/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAOL,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAYjD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,qBAAqB,iBAsT/B;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/preset/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAOL,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAYjD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,qBAAqB,iBAwT/B;AAED,eAAe,eAAe,CAAC"}

package/src/generators/preset/generator.js

@@ -256,6 +256,8 @@ async function presetGenerator(tree, options) {
             "update:nx": "nx migrate @kosdev-code/kos-nx-plugin",
             zip: "nx run-many --target=zip",
             build: "nx run-many --target=build",
+            dev: "kosui dev",
+            "dev:verbose": "VERBOSE_PLUGIN_DEV=true kosui dev",
             ...json.scripts,
         };
         return json;

package/src/generators/preset/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/preset/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../packages/plugins/kos-nx-plugin/src/generators/preset/generator.ts"],"names":[],"mappings":"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"}

package/src/generators/preset/root/.kos.json.template

@@ -6,5 +6,24 @@
       "model-component": "model-components",
       "ui": "<%= nameDashCase %>-ui"
     }
+  },
+  "development": {
+    "hosts": [
+      {
+        "name": "<%= nameDashCase %>-ui",
+        "project": "<%= nameDashCase %>-ui",
+        "port": 4200,
+        "type": "cui",
+        "pluginContext": "<%= nameDashCase %>",
+        "plugins": []
+      }
+    ],
+    "portRanges": {
+      "<%= nameDashCase %>-ui": {
+        "start": 4200,
+        "next": 4201
+      }
+    },
+    "logDir": "/tmp/<%= nameDashCase %>-logs"
   }
 }

package/src/generators/preset/schema.d.ts

@@ -1,8 +1,10 @@
 export interface PresetGeneratorSchema {
   name: string;
+  enablePlugins?: boolean;
 }
 export interface NormalizedKosBaseGeneratorSchema<
   T extends PresetGeneratorSchema
 > extends T {
   template: string;
+  enablePlugins: boolean;
 }

package/src/generators/preset/schema.json

@@ -6,8 +6,13 @@
   "properties": {
     "name": {
       "type": "string",
-      "description": "",
+      "description": "The name of the workspace",
       "x-prompt": "What name would you like to use?"
+    },
+    "enablePlugins": {
+      "type": "boolean",
+      "description": "Enable plugin support for this workspace (includes plugin system, dev aggregator, and FloatingPluginExplorer)",
+      "default": true
     }
   },
   "required": ["name"]

package/src/types/kos-config.d.ts

@@ -0,0 +1,295 @@
+/**
+ * KOS Configuration Schema
+ *
+ * Defines the structure for .kos.json files in KOS workspaces.
+ * Supports metadata-driven plugin development with automatic registration
+ * and port management.
+ *
+ * @module kos-config
+ */
+/**
+ * Port range configuration for automatic port allocation.
+ *
+ * Tracks available port ranges for a host application to prevent conflicts
+ * when multiple plugins are registered.
+ *
+ * @example
+ * ```json
+ * {
+ *   "start": 4200,
+ *   "next": 4203
+ * }
+ * ```
+ */
+export interface PortRange {
+    /**
+     * Starting port number for this host's range.
+     * The host app typically uses this port.
+     */
+    start: number;
+    /**
+     * Next available port to assign to a new plugin.
+     * Automatically incremented when plugins are registered.
+     */
+    next: number;
+}
+/**
+ * Plugin configuration metadata.
+ *
+ * Defines how a plugin integrates with its host application,
+ * including dev server port assignment and CLI alias.
+ *
+ * @example
+ * ```json
+ * {
+ *   "project": "beverage-pour",
+ *   "port": 4201,
+ *   "alias": "beverage",
+ *   "enabled": true
+ * }
+ * ```
+ */
+export interface PluginConfig {
+    /**
+     * NX project name of the plugin.
+     * Must match the project name in workspace.json/project.json.
+     */
+    project: string;
+    /**
+     * Dev server port for this plugin.
+     * Auto-assigned from host's port range during plugin creation.
+     */
+    port: number;
+    /**
+     * Short CLI-friendly alias for the plugin (kebab-case).
+     * Used with --plugins and --disable flags.
+     *
+     * @example "beverage", "pos", "crew"
+     */
+    alias: string;
+    /**
+     * Whether this plugin should start by default.
+     * Can be overridden via CLI flags.
+     *
+     * @default true
+     */
+    enabled: boolean;
+}
+/**
+ * Host application configuration.
+ *
+ * Defines a host application that can load plugins, including
+ * its dev server settings and associated plugin registrations.
+ *
+ * @example
+ * ```json
+ * {
+ *   "name": "ddk-app",
+ *   "project": "kos-ddk-app",
+ *   "port": 4200,
+ *   "type": "ncui",
+ *   "pluginContext": "kosdev.ddk",
+ *   "plugins": [
+ *     {
+ *       "project": "beverage-pour",
+ *       "port": 4201,
+ *       "alias": "beverage",
+ *       "enabled": true
+ *     }
+ *   ]
+ * }
+ * ```
+ */
+export interface HostConfig {
+    /**
+     * Identifier for this host (kebab-case).
+     * Used with --host flag in dev script.
+     *
+     * @example "ddk-app", "drive-thru-ui"
+     */
+    name: string;
+    /**
+     * NX project name of the host application.
+     * Must match the project name in workspace.json/project.json.
+     */
+    project: string;
+    /**
+     * Dev server port for the host application.
+     */
+    port: number;
+    /**
+     * Type/category of host application.
+     *
+     * Common values:
+     * - "cui" - Consumer User Interface
+     * - "ncui" - Non-Consumer User Interface (standard)
+     * - "ncui.compact" - Non-Consumer User Interface (compact mode)
+     * - "admin" - Administrative interface
+     *
+     * @example "ncui", "cui", "admin"
+     */
+    type: string;
+    /**
+     * Plugin context group identifier.
+     *
+     * Determines which plugins are compatible with this host.
+     * Plugins register with a matching context in their .kos.json.
+     *
+     * @example "kosdev.ddk", "cui", "tccc.drive-thru"
+     */
+    pluginContext: string;
+    /**
+     * Array of plugins registered for this host.
+     *
+     * Plugins are automatically added to this array when created
+     * via the plugin generator with --host flag.
+     */
+    plugins: PluginConfig[];
+}
+/**
+ * Development configuration section.
+ *
+ * Contains all metadata needed for the universal development script
+ * to start host applications and their plugins.
+ *
+ * @example
+ * ```json
+ * {
+ *   "hosts": [
+ *     {
+ *       "name": "ddk-app",
+ *       "project": "kos-ddk-app",
+ *       "port": 4200,
+ *       "type": "ncui",
+ *       "pluginContext": "kosdev.ddk",
+ *       "plugins": []
+ *     }
+ *   ],
+ *   "portRanges": {
+ *     "ddk-app": {
+ *       "start": 4200,
+ *       "next": 4201
+ *     }
+ *   },
+ *   "logDir": "/tmp/ddk-logs"
+ * }
+ * ```
+ */
+export interface DevelopmentConfig {
+    /**
+     * Array of host applications in this workspace.
+     *
+     * Multiple hosts can be defined for workspaces that contain
+     * different application types (CUI, NCUI, admin panels, etc.).
+     */
+    hosts: HostConfig[];
+    /**
+     * Port range allocations for each host.
+     *
+     * Keys are host names, values are PortRange objects.
+     * Used to auto-assign ports when plugins are created.
+     *
+     * @example
+     * ```json
+     * {
+     *   "ddk-app": { "start": 4200, "next": 4203 },
+     *   "drive-thru-ui": { "start": 4300, "next": 4306 }
+     * }
+     * ```
+     */
+    portRanges: Record<string, PortRange>;
+    /**
+     * Optional directory for dev server logs.
+     *
+     * If specified, stdout/stderr from dev servers will be
+     * written to files in this directory.
+     *
+     * @example "/tmp/ddk-logs", "./logs"
+     */
+    logDir?: string;
+}
+/**
+ * Root KOS configuration.
+ *
+ * Complete schema for .kos.json files at workspace root.
+ * Extends the existing generator defaults with development metadata.
+ *
+ * @example
+ * ```json
+ * {
+ *   "type": "root",
+ *   "generator": {
+ *     "defaults": {
+ *       "model": "my-workspace-models",
+ *       "model-component": "model-components",
+ *       "ui": "my-workspace-ui"
+ *     }
+ *   },
+ *   "development": {
+ *     "hosts": [
+ *       {
+ *         "name": "my-workspace-ui",
+ *         "project": "my-workspace-ui",
+ *         "port": 4200,
+ *         "type": "cui",
+ *         "pluginContext": "my-workspace",
+ *         "plugins": []
+ *       }
+ *     ],
+ *     "portRanges": {
+ *       "my-workspace-ui": {
+ *         "start": 4200,
+ *         "next": 4201
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export interface KosDevConfig {
+    /**
+     * Configuration type identifier.
+     * Must be "root" for workspace-level .kos.json files.
+     */
+    type: "root";
+    /**
+     * Generator default configurations.
+     *
+     * Specifies default project names for different generator types.
+     */
+    generator: {
+        /**
+         * Default project names by generator type.
+         */
+        defaults: {
+            /**
+             * Default model project name.
+             */
+            model?: string;
+            /**
+             * Default model-component project name.
+             */
+            "model-component"?: string;
+            /**
+             * Default UI project name.
+             */
+            ui?: string;
+            /**
+             * Default plugin project name.
+             */
+            plugin?: string;
+            /**
+             * Additional custom defaults.
+             */
+            [key: string]: string | undefined;
+        };
+    };
+    /**
+     * Development configuration for plugin development workflow.
+     *
+     * Optional - if not present, workspace uses legacy development patterns.
+     * When present, enables metadata-driven development with universal dev script.
+     */
+    development?: DevelopmentConfig;
+}
+//# sourceMappingURL=kos-config.d.ts.map

package/src/types/kos-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kos-config.d.ts","sourceRoot":"","sources":["../../../../../../packages/plugins/kos-nx-plugin/src/types/kos-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;OAUG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;;OAOG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,KAAK,EAAE,UAAU,EAAE,CAAC;IAEpB;;;;;;;;;;;;;OAaG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEtC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,EAAE;QACT;;WAEG;QACH,QAAQ,EAAE;YACR;;eAEG;YACH,KAAK,CAAC,EAAE,MAAM,CAAC;YAEf;;eAEG;YACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAE3B;;eAEG;YACH,EAAE,CAAC,EAAE,MAAM,CAAC;YAEZ;;eAEG;YACH,MAAM,CAAC,EAAE,MAAM,CAAC;YAEhB;;eAEG;YACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;SACnC,CAAC;KACH,CAAC;IAEF;;;;;OAKG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC"}

package/src/types/kos-config.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * KOS Configuration Schema
+ *
+ * Defines the structure for .kos.json files in KOS workspaces.
+ * Supports metadata-driven plugin development with automatic registration
+ * and port management.
+ *
+ * @module kos-config
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=kos-config.js.map

package/src/types/kos-config.js.map

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

package/src/utils/kos-config-helpers.d.ts

@@ -0,0 +1,72 @@
+/**
+ * KOS Configuration Helper Functions
+ *
+ * Utility functions for working with .kos.json configuration files.
+ * Provides type-safe access to development configuration.
+ *
+ * @module kos-config-helpers
+ */
+import type { DevelopmentConfig, HostConfig, KosDevConfig, PluginConfig } from "../types/kos-config";
+/**
+ * Type guard to check if a config has development section.
+ *
+ * @param config - Configuration object to check
+ * @returns True if config has development section with hosts
+ *
+ * @example
+ * ```typescript
+ * if (hasDevelopmentConfig(config)) {
+ *   // Safe to access config.development.hosts
+ *   const hosts = config.development.hosts;
+ * }
+ * ```
+ */
+export declare function hasDevelopmentConfig(config: KosDevConfig): config is KosDevConfig & {
+    development: DevelopmentConfig;
+};
+/**
+ * Find a host configuration by name.
+ *
+ * @param config - Root KOS configuration
+ * @param hostName - Name of the host to find
+ * @returns Host configuration or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const host = findHost(config, 'ddk-app');
+ * if (host) {
+ *   console.log(`Host ${host.name} runs on port ${host.port}`);
+ * }
+ * ```
+ */
+export declare function findHost(config: KosDevConfig, hostName: string): HostConfig | undefined;
+/**
+ * Get all plugin aliases for a host.
+ *
+ * @param hostConfig - Host configuration
+ * @returns Array of plugin aliases
+ *
+ * @example
+ * ```typescript
+ * const aliases = getPluginAliases(hostConfig);
+ * // ['beverage', 'ddk-standard', 'ddk-compact']
+ * ```
+ */
+export declare function getPluginAliases(hostConfig: HostConfig): string[];
+/**
+ * Find a plugin configuration by alias within a host.
+ *
+ * @param hostConfig - Host configuration
+ * @param alias - Plugin alias to find
+ * @returns Plugin configuration or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const plugin = findPluginByAlias(hostConfig, 'beverage');
+ * if (plugin) {
+ *   console.log(`Plugin ${plugin.project} on port ${plugin.port}`);
+ * }
+ * ```
+ */
+export declare function findPluginByAlias(hostConfig: HostConfig, alias: string): PluginConfig | undefined;
+//# sourceMappingURL=kos-config-helpers.d.ts.map

package/src/utils/kos-config-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kos-config-helpers.d.ts","sourceRoot":"","sources":["../../../../../../packages/plugins/kos-nx-plugin/src/utils/kos-config-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,GACnB,MAAM,IAAI,YAAY,GAAG;IAAE,WAAW,EAAE,iBAAiB,CAAA;CAAE,CAM7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,SAAS,CAKxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAEjE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,SAAS,CAE1B"}

package/src/utils/kos-config-helpers.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * KOS Configuration Helper Functions
+ *
+ * Utility functions for working with .kos.json configuration files.
+ * Provides type-safe access to development configuration.
+ *
+ * @module kos-config-helpers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findPluginByAlias = exports.getPluginAliases = exports.findHost = exports.hasDevelopmentConfig = void 0;
+/**
+ * Type guard to check if a config has development section.
+ *
+ * @param config - Configuration object to check
+ * @returns True if config has development section with hosts
+ *
+ * @example
+ * ```typescript
+ * if (hasDevelopmentConfig(config)) {
+ *   // Safe to access config.development.hosts
+ *   const hosts = config.development.hosts;
+ * }
+ * ```
+ */
+function hasDevelopmentConfig(config) {
+    return (config.development !== undefined &&
+        Array.isArray(config.development.hosts) &&
+        config.development.hosts.length > 0);
+}
+exports.hasDevelopmentConfig = hasDevelopmentConfig;
+/**
+ * Find a host configuration by name.
+ *
+ * @param config - Root KOS configuration
+ * @param hostName - Name of the host to find
+ * @returns Host configuration or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const host = findHost(config, 'ddk-app');
+ * if (host) {
+ *   console.log(`Host ${host.name} runs on port ${host.port}`);
+ * }
+ * ```
+ */
+function findHost(config, hostName) {
+    if (!hasDevelopmentConfig(config)) {
+        return undefined;
+    }
+    return config.development.hosts.find((h) => h.name === hostName);
+}
+exports.findHost = findHost;
+/**
+ * Get all plugin aliases for a host.
+ *
+ * @param hostConfig - Host configuration
+ * @returns Array of plugin aliases
+ *
+ * @example
+ * ```typescript
+ * const aliases = getPluginAliases(hostConfig);
+ * // ['beverage', 'ddk-standard', 'ddk-compact']
+ * ```
+ */
+function getPluginAliases(hostConfig) {
+    return hostConfig.plugins.map((p) => p.alias);
+}
+exports.getPluginAliases = getPluginAliases;
+/**
+ * Find a plugin configuration by alias within a host.
+ *
+ * @param hostConfig - Host configuration
+ * @param alias - Plugin alias to find
+ * @returns Plugin configuration or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const plugin = findPluginByAlias(hostConfig, 'beverage');
+ * if (plugin) {
+ *   console.log(`Plugin ${plugin.project} on port ${plugin.port}`);
+ * }
+ * ```
+ */
+function findPluginByAlias(hostConfig, alias) {
+    return hostConfig.plugins.find((p) => p.alias === alias);
+}
+exports.findPluginByAlias = findPluginByAlias;
+//# sourceMappingURL=kos-config-helpers.js.map

package/src/utils/kos-config-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kos-config-helpers.js","sourceRoot":"","sources":["../../../../../../packages/plugins/kos-nx-plugin/src/utils/kos-config-helpers.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AASH;;;;;;;;;;;;;GAaG;AACH,SAAgB,oBAAoB,CAClC,MAAoB;IAEpB,OAAO,CACL,MAAM,CAAC,WAAW,KAAK,SAAS;QAChC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;QACvC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CACpC,CAAC;AACJ,CAAC;AARD,oDAQC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,QAAQ,CACtB,MAAoB,EACpB,QAAgB;IAEhB,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACnE,CAAC;AARD,4BAQC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,gBAAgB,CAAC,UAAsB;IACrD,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAFD,4CAEC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,iBAAiB,CAC/B,UAAsB,EACtB,KAAa;IAEb,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AAC3D,CAAC;AALD,8CAKC"}