@kosdev-code/kos-ui-plugin 2.1.18 → 2.1.20

package/types/plugins.d.ts

@@ -39,3 +39,11 @@ export type ProcessedContributions = {
   controlPourDefinitions: Record<string, ProcessedControlPourDefinition>;
   experiences: Record<string, ProcessedExperience>;
 };
+
+// Export contribution enablement types
+export type {
+  ContributionStateChangeEvent,
+  DynamicContribution,
+  EnablementContext,
+  IContributionRegistry,
+} from './contribution-enablement';

package/utils.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./documentation-generator-DFaIDo0E.cjs");require("zod");function m(n,e,...t){return[n,e,...t].filter(Boolean).join(".")}function V(n){const e=n.match(/^(\d+)\.(\d+)\.\d+(?:-\S+)?$/);if(!e)throw new Error(`Invalid version format: ${n}`);const[t,s,l]=e;return`${s}.${l}.0`}function h(n,e){var c,u;e!=null&&e.sdkVersion&&console.log("sdkVersion",e.sdkVersion),e!=null&&e.ddkVersion&&console.log("ddkVersion",e.ddkVersion);const t=V((e==null?void 0:e.sdkVersion)||"0.2.0"),s=V((e==null?void 0:e.ddkVersion)||"0.2.0");console.log(`Using DDK version: ${s}`),console.log(`Using SDK version: ${t}`);const l=n==null?void 0:n.name;if(!l)throw new Error("KOS Configuration should be added.  Project name not found in config");const i=((e==null?void 0:e.pluginPath)||"kos.ui.plugin").split(".").reduce((a,o)=>(console.log(`Accessing key: ${o}`),a&&a[o]?a[o]:void 0),n),g=i==null?void 0:i.id;if(!g)throw new Error("KOS Configuration should be added.  Plugin ID not found in config");const d=Object.keys(((c=i==null?void 0:i.contributes)==null?void 0:c.views)||{}).reduce((a,o)=>(i.contributes.views[o].forEach(f=>{a[`./${f.component}`]=f.location}),a),{});return Object.values(((u=i==null?void 0:i.contributes)==null?void 0:u.experiences)||{}).forEach(a=>{d[`./${a.component}`]=a.location}),i!=null&&i.init&&(d["./InitPlugin"]="./src/app/init.ts"),{name:l,exposes:d,library:{type:"var",name:g},additionalShared:[{libraryName:"@kosdev-code/kos-ui-plugin",sharedConfig:{singleton:!0,eager:!1,requiredVersion:`~${s}`}},{libraryName:"react",sharedConfig:{singleton:!0,eager:!1,strictVersion:!0,requiredVersion:"18.2.0"}},{libraryName:"react-dom",sharedConfig:{singleton:!0,eager:!1,strictVersion:!0,requiredVersion:"18.2.0"}},{libraryName:"@kosdev-code/kos-ui-sdk",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:`~${t}`}},{libraryName:"@kosdev-code/kos-dispense-sdk",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:`~${t}`}},{libraryName:"@kosdev-code/kos-freestyle-sdk",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:`~${t}`}},{libraryName:"@kosdev-code/kos-ddk-components",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:`~${s}`}},{libraryName:"@kosdev-code/kos-ddk-model-components",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:`~${s}`}},{libraryName:"@kosdev-code/kos-ddk-models",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:`~${s}`}},{libraryName:"@kosdev-code/kos-ddk",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:`~${s}`}},{libraryName:"@kosdev-code/kos-ddk-styles",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:`~${s}`}},{libraryName:"@emotion/styled",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"~11.11.0"}},{libraryName:"@emotion/react",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"~11.11.0"}},{libraryName:"reflect-metadata",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^0.2.2"}},{libraryName:"mobx",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^6.9.0"}},{libraryName:"loglevel",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^1.8.1"}},{libraryName:"robot3",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^0.4.0"}},{libraryName:"mobx-react-lite",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^3.4.3"}},{libraryName:"react-router-dom",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^6.11.2"}},{libraryName:"date-fns",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^2.30.0"}},{libraryName:"@use-gesture/react",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^10.3.0"}},{libraryName:"@react-spring/web",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^9.7.3"}},{libraryName:"react-simple-keyboard",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^3.6.13"}},{libraryName:"expr-eval",sharedConfig:{singleton:!0,eager:!1,strictVersion:!1,requiredVersion:"^2.0.2"}},{libraryName:"zod",sharedConfig:{singleton:!0,eager:!0,strictVersion:!1,requiredVersion:"^3.25.0"}}]}}exports.BaseViewExtensionSchema=r.BaseViewExtensionSchema;exports.DocumentationGenerator=r.DocumentationGenerator;exports.PluginDiscoveryService=r.PluginDiscoveryService;exports.RankableViewExtensionSchema=r.RankableViewExtensionSchema;exports.contributionReducer=r.contributionReducer;exports.createExtensionSchema=r.createExtensionSchema;exports.createViewAwareTransform=r.createViewAwareTransform;exports.defineExtensionPoint=r.defineExtensionPoint;exports.getContributions=r.getContributions;exports.getExtensionPointRegistry=r.getExtensionPointRegistry;exports.getExtensionPointSchema=r.getExtensionPointSchema;exports.getExtensions=r.getExtensions;exports.getValidationResults=r.getValidationResults;exports.initPluginManager=r.initPluginManager;exports.initializeKosPlugins=r.initializeKosPlugins;exports.loadExtensions=r.loadExtensions;exports.registry=r.registry;exports.resolveBestExtension=r.resolveBestExtension;exports.validateDescriptorFormat=r.validateDescriptorFormat;exports.validateRank=r.validateRank;exports.validateRankIfPresent=r.validateRankIfPresent;exports.validateWithSchema=r.validateWithSchema;exports.extensionPointId=m;exports.generatePluginConfiguration=h;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./documentation-generator-CAlVz5vA.cjs");require("zod");function o(i,t,...n){return[i,t,...n].filter(Boolean).join(".")}exports.BaseViewExtensionSchema=e.BaseViewExtensionSchema;exports.ContributionRegistry=e.ContributionRegistry;exports.DocumentationGenerator=e.DocumentationGenerator;exports.PluginDiscoveryService=e.PluginDiscoveryService;exports.RankableViewExtensionSchema=e.RankableViewExtensionSchema;exports.ReactiveExtensionRegistry=e.ReactiveExtensionRegistry;exports.contributionReducer=e.contributionReducer;exports.createExtensionSchema=e.createExtensionSchema;exports.createViewAwareTransform=e.createViewAwareTransform;exports.defineExtensionPoint=e.defineExtensionPoint;exports.generatePluginConfiguration=e.generatePluginConfiguration;exports.getContributions=e.getContributions;exports.getExtensionPointRegistry=e.getExtensionPointRegistry;exports.getExtensionPointSchema=e.getExtensionPointSchema;exports.getExtensions=e.getExtensions;exports.getValidationResults=e.getValidationResults;exports.initPluginManager=e.initPluginManager;exports.initializeKosPlugins=e.initializeKosPlugins;exports.loadExtensions=e.loadExtensions;exports.registry=e.registry;exports.resolveBestExtension=e.resolveBestExtension;exports.validateDescriptorFormat=e.validateDescriptorFormat;exports.validateRank=e.validateRank;exports.validateRankIfPresent=e.validateRankIfPresent;exports.validateWithSchema=e.validateWithSchema;exports.extensionPointId=o;
 //# sourceMappingURL=utils.cjs.map

package/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","sources":["../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/extension-point-types.ts","../../../../packages/sdk/kos-ui-plugin/src/lib/utils/processors/process-kos-config.ts"],"sourcesContent":["/**\n * Core types and interfaces for extension point system\n */\n\n// React import removed - component creation happens at runtime via hooks\nimport type { z } from \"zod\";\nimport type {\n  BasePluginExtension,\n  PluginExtensionsType,\n  ProcessedContributions,\n} from \"../../../types/plugins\";\n\n/**\n * Validation context for collecting validation issues\n */\nexport interface ValidationContext {\n  addError(message: string): void;\n  addWarning(message: string): void;\n  addInfo(message: string): void;\n  hasErrors(): boolean;\n  hasIssues(): boolean;\n  getIssues(): { type: \"error\" | \"warning\" | \"info\"; message: string }[];\n}\n\n/**\n * Context provided to transform functions\n */\nexport interface TransformContext {\n  remote: string;\n  sectionId: string;\n  experiences?: Record<string, any>;\n  contributions: ProcessedContributions;\n}\n\n/**\n * Schema field information for documentation\n */\nexport interface SchemaFieldInfo {\n  name: string;\n  description?: string;\n  type?: string;\n  required?: boolean;\n}\n\n/**\n * Configuration for defining a new extension point\n */\nexport interface ExtensionPointConfig<\n  TData = any,\n  TProcessed = TData,\n  _TProps = any\n> {\n  /**\n   * Unique identifier for this extension point\n   * Convention: \"ddk.{feature}\" or \"ddk.{feature}.{sub-feature}\"\n   */\n  id: string;\n\n  /**\n   * Optional display name for documentation/discovery\n   */\n  displayName?: string;\n\n  /**\n   * Optional description for documentation/discovery\n   */\n  description?: string;\n\n  /**\n   * The contribution key in the plugin descriptor\n   * e.g., \"myFeature\" maps to contributes.myFeature in kosdev-plugin.json\n   */\n  contributionKey: string;\n\n  /**\n   * Optional related extension points\n   * For example, a main extension might have .view and .definition variants\n   */\n  relatedPoints?: {\n    view?: string;\n    definition?: string;\n    [key: string]: string | undefined;\n  };\n\n  /**\n   * Transform function to process raw contribution data\n   * Allows custom processing logic while maintaining type safety\n   */\n  transform?: (data: TData, context: TransformContext) => TProcessed;\n\n  /**\n   * Optional validation function\n   * Use context.addError/addWarning/addInfo to collect validation issues\n   * Return \"skip\" to skip processing this contribution\n   */\n  validate?: (data: TData, context: ValidationContext) => \"skip\" | void;\n\n  /**\n   * Whether this extension point uses view/experience pattern\n   * Default: false\n   */\n  hasView?: boolean;\n\n  /**\n   * Whether contributions should be ranked\n   * Default: false\n   */\n  isRankable?: boolean;\n\n  /**\n   * Optional Zod schema for runtime validation and documentation\n   * Provides both type safety and field introspection for Plugin Explorer\n   */\n  schema?: z.ZodSchema<TData>;\n\n  /**\n   * Metadata for discovery/documentation\n   */\n  metadata?: {\n    category?: string;\n    tags?: string[];\n    since?: string;\n    deprecated?: boolean;\n    replacedBy?: string;\n    owner?: string;\n    /**\n     * The actual export name of this extension point in the code\n     * Used for documentation generation to show correct import statements\n     */\n    exportName?: string;\n  };\n}\n\n/**\n * Props for extension point components\n */\nexport interface ExtensionComponentProps {\n  /** Specific module to load (optional) */\n  module?: string;\n  /** Fallback component when extension not found */\n  fallback?: React.ReactNode;\n}\n\n/**\n * Result of defining an extension point\n */\nexport interface ExtensionPointDefinition<\n  TData = any,\n  TProcessed = TData,\n  TProps = any\n> {\n  /**\n   * The extension point configuration\n   */\n  config: ExtensionPointConfig<TData, TProcessed, TProps>;\n\n  /**\n   * Extension point ID for use in components\n   */\n  id: string;\n\n  /**\n   * Helper to get typed extensions (for future use with hooks)\n   */\n  getExtensions?: (\n    extensions: PluginExtensionsType\n  ) => Record<string, BasePluginExtension & { data: TProcessed }>;\n\n  /**\n   * Registration status\n   */\n  isRegistered: boolean;\n\n  /**\n   * Method to register this extension point\n   */\n  register: () => void;\n\n  // Component property removed - use useExtensionComponent hook or createExtensionComponent factory at runtime\n\n  /**\n   * Get schema field information for documentation purposes\n   * Returns field info that can be safely displayed by Plugin Explorer\n   */\n  getSchemaFieldInfo?: () => SchemaFieldInfo[];\n}\n\n/**\n * Extension point with hasView: true, guarantees Component property\n */\nexport interface ViewExtensionPointDefinition<\n  TData = any,\n  TProcessed = TData,\n  TProps = any\n> extends ExtensionPointDefinition<TData, TProcessed, TProps> {\n  Component: React.ComponentType<ExtensionComponentProps & TProps>;\n}\n\n/**\n * Type-safe extension point ID helper\n * Ensures consistent naming and helps with refactoring\n */\nexport function extensionPointId(\n  namespace: string,\n  feature: string,\n  ...subFeatures: string[]\n): string {\n  const parts = [namespace, feature, ...subFeatures].filter(Boolean);\n  return parts.join(\".\");\n}\n","/* eslint-disable max-lines-per-function */\nimport type { Contributions } from \"../../../types/global\";\n\ninterface KosConfigView {\n  id: string;\n  title: string;\n  component: string;\n  location: string;\n}\n\ninterface KosPluginConfig {\n  id: string;\n  init?: boolean;\n  contributes: Contributions;\n}\n\ninterface DDKConfig {\n  name: string;\n  kosdev: {\n    ddk: {\n      ncui: {\n        plugin: KosPluginConfig;\n      };\n    };\n  };\n}\n\ninterface CoreKosConfig {\n  name: string;\n  kos: {\n    ui: {\n      plugin: KosPluginConfig;\n    };\n  };\n}\n\nexport type KosConfig = DDKConfig | CoreKosConfig;\n\nfunction normalizeVersion(version: string): string {\n  const match = version.match(/^(\\d+)\\.(\\d+)\\.\\d+(?:-\\S+)?$/);\n  if (!match) {\n    throw new Error(`Invalid version format: ${version}`);\n  }\n  const [_, major, minor] = match;\n  return `${major}.${minor}.0`;\n}\n\nexport interface PluginOptions {\n  sdkVersion?: string;\n  ddkVersion?: string;\n  pluginPath?: string;\n}\nexport function generatePluginConfiguration(\n  config: KosConfig,\n  options?: PluginOptions\n): any {\n  if (options?.sdkVersion) {\n    console.log(\"sdkVersion\", options.sdkVersion);\n  }\n  if (options?.ddkVersion) {\n    console.log(\"ddkVersion\", options.ddkVersion);\n  }\n  const sdkVersion = normalizeVersion(options?.sdkVersion || \"0.2.0\");\n  const ddkVersion = normalizeVersion(options?.ddkVersion || \"0.2.0\");\n\n  console.log(`Using DDK version: ${ddkVersion}`);\n  console.log(`Using SDK version: ${sdkVersion}`);\n  const projectId = config?.name;\n  if (!projectId) {\n    throw new Error(\n      \"KOS Configuration should be added.  Project name not found in config\"\n    );\n  }\n  const pluginPath = options?.pluginPath || \"kos.ui.plugin\";\n  const pluginObj = pluginPath\n    .split(\".\")\n    .reduce<KosPluginConfig>((obj, key) => {\n      console.log(`Accessing key: ${key}`);\n      return obj && obj[key] ? obj[key] : undefined;\n    }, config as unknown as KosPluginConfig);\n\n  const pluginId = pluginObj?.id;\n  if (!pluginId) {\n    throw new Error(\n      \"KOS Configuration should be added.  Plugin ID not found in config\"\n    );\n  }\n  const mfConfig = Object.keys(pluginObj?.contributes?.views || {}).reduce(\n    (acc, key) => {\n      const views = pluginObj.contributes.views[key];\n\n      views.forEach((view) => {\n        acc[`./${view.component}`] = view.location;\n      });\n      return acc;\n    },\n    {}\n  );\n\n  Object.values(pluginObj?.contributes?.experiences || {}).forEach(\n    (experience) => {\n      mfConfig[`./${experience.component}`] = experience.location;\n    }\n  );\n\n  if (pluginObj?.init) {\n    mfConfig[\"./InitPlugin\"] = \"./src/app/init.ts\";\n  }\n\n  return {\n    name: projectId,\n    exposes: mfConfig,\n    library: { type: \"var\", name: pluginId },\n    additionalShared: [\n      {\n        libraryName: \"@kosdev-code/kos-ui-plugin\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"react\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: true,\n          requiredVersion: \"18.2.0\",\n        },\n      },\n\n      {\n        libraryName: \"react-dom\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: true,\n          requiredVersion: \"18.2.0\",\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ui-sdk\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${sdkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-dispense-sdk\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${sdkVersion}`,\n        },\n      },\n\n      {\n        libraryName: \"@kosdev-code/kos-freestyle-sdk\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${sdkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk-components\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk-model-components\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk-models\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk-styles\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@emotion/styled\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"~11.11.0\",\n        },\n      },\n      {\n        libraryName: \"@emotion/react\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"~11.11.0\",\n        },\n      },\n      {\n        libraryName: \"reflect-metadata\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^0.2.2\",\n        },\n      },\n      {\n        libraryName: \"mobx\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^6.9.0\",\n        },\n      },\n\n      {\n        libraryName: \"loglevel\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^1.8.1\",\n        },\n      },\n      {\n        libraryName: \"robot3\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^0.4.0\",\n        },\n      },\n      {\n        libraryName: \"mobx-react-lite\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^3.4.3\",\n        },\n      },\n      {\n        libraryName: \"react-router-dom\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^6.11.2\",\n        },\n      },\n      {\n        libraryName: \"date-fns\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^2.30.0\",\n        },\n      },\n      {\n        libraryName: \"@use-gesture/react\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^10.3.0\",\n        },\n      },\n      {\n        libraryName: \"@react-spring/web\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^9.7.3\",\n        },\n      },\n      {\n        libraryName: \"react-simple-keyboard\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^3.6.13\",\n        },\n      },\n      {\n        libraryName: \"expr-eval\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^2.0.2\",\n        },\n      },\n      {\n        libraryName: \"zod\",\n        sharedConfig: {\n          singleton: true,\n          eager: true,\n          strictVersion: false,\n          requiredVersion: \"^3.25.0\",\n        },\n      },\n    ],\n  };\n}\n"],"names":["extensionPointId","namespace","feature","subFeatures","normalizeVersion","version","match","_","major","minor","generatePluginConfiguration","config","options","sdkVersion","ddkVersion","projectId","pluginObj","obj","key","pluginId","mfConfig","_a","acc","view","_b","experience"],"mappings":"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"}
+{"version":3,"file":"utils.cjs","sources":["../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/extension-point-types.ts"],"sourcesContent":["/**\n * Core types and interfaces for extension point system\n */\n\n// React import removed - component creation happens at runtime via hooks\nimport type { z } from \"zod\";\nimport type {\n  BasePluginExtension,\n  PluginExtensionsType,\n  ProcessedContributions,\n} from \"../../../types/plugins\";\n\n/**\n * Validation context for collecting validation issues\n */\nexport interface ValidationContext {\n  addError(message: string): void;\n  addWarning(message: string): void;\n  addInfo(message: string): void;\n  hasErrors(): boolean;\n  hasIssues(): boolean;\n  getIssues(): { type: \"error\" | \"warning\" | \"info\"; message: string }[];\n}\n\n/**\n * Context provided to transform functions\n */\nexport interface TransformContext {\n  remote: string;\n  sectionId: string;\n  experiences?: Record<string, any>;\n  contributions: ProcessedContributions;\n}\n\n/**\n * Schema field information for documentation\n */\nexport interface SchemaFieldInfo {\n  name: string;\n  description?: string;\n  type?: string;\n  required?: boolean;\n}\n\n/**\n * Configuration for defining a new extension point\n */\nexport interface ExtensionPointConfig<\n  TData = any,\n  TProcessed = TData,\n  _TProps = any\n> {\n  /**\n   * Unique identifier for this extension point\n   * Convention: \"ddk.{feature}\" or \"ddk.{feature}.{sub-feature}\"\n   */\n  id: string;\n\n  /**\n   * Optional display name for documentation/discovery\n   */\n  displayName?: string;\n\n  /**\n   * Optional description for documentation/discovery\n   */\n  description?: string;\n\n  /**\n   * The contribution key in the plugin descriptor\n   * e.g., \"myFeature\" maps to contributes.myFeature in kosdev-plugin.json\n   */\n  contributionKey: string;\n\n  /**\n   * Optional related extension points\n   * For example, a main extension might have .view and .definition variants\n   */\n  relatedPoints?: {\n    view?: string;\n    definition?: string;\n    [key: string]: string | undefined;\n  };\n\n  /**\n   * Transform function to process raw contribution data\n   * Allows custom processing logic while maintaining type safety\n   */\n  transform?: (data: TData, context: TransformContext) => TProcessed;\n\n  /**\n   * Optional validation function\n   * Use context.addError/addWarning/addInfo to collect validation issues\n   * Return \"skip\" to skip processing this contribution\n   */\n  validate?: (data: TData, context: ValidationContext) => \"skip\" | void;\n\n  /**\n   * Whether this extension point uses view/experience pattern\n   * Default: false\n   */\n  hasView?: boolean;\n\n  /**\n   * Whether contributions should be ranked\n   * Default: false\n   */\n  isRankable?: boolean;\n\n  /**\n   * Optional Zod schema for runtime validation and documentation\n   * Provides both type safety and field introspection for Plugin Explorer\n   */\n  schema?: z.ZodSchema<TData>;\n\n  /**\n   * Metadata for discovery/documentation\n   */\n  metadata?: {\n    category?: string;\n    tags?: string[];\n    since?: string;\n    deprecated?: boolean;\n    replacedBy?: string;\n    owner?: string;\n    /**\n     * The actual export name of this extension point in the code\n     * Used for documentation generation to show correct import statements\n     */\n    exportName?: string;\n  };\n}\n\n/**\n * Props for extension point components\n */\nexport interface ExtensionComponentProps {\n  /** Specific module to load (optional) */\n  module?: string;\n  /** Fallback component when extension not found */\n  fallback?: React.ReactNode;\n}\n\n/**\n * Result of defining an extension point\n */\nexport interface ExtensionPointDefinition<\n  TData = any,\n  TProcessed = TData,\n  TProps = any\n> {\n  /**\n   * The extension point configuration\n   */\n  config: ExtensionPointConfig<TData, TProcessed, TProps>;\n\n  /**\n   * Extension point ID for use in components\n   */\n  id: string;\n\n  /**\n   * Helper to get typed extensions (for future use with hooks)\n   */\n  getExtensions?: (\n    extensions: PluginExtensionsType\n  ) => Record<string, BasePluginExtension & { data: TProcessed }>;\n\n  /**\n   * Registration status\n   */\n  isRegistered: boolean;\n\n  /**\n   * Method to register this extension point\n   */\n  register: () => void;\n\n  // Component property removed - use useExtensionComponent hook or createExtensionComponent factory at runtime\n\n  /**\n   * Get schema field information for documentation purposes\n   * Returns field info that can be safely displayed by Plugin Explorer\n   */\n  getSchemaFieldInfo?: () => SchemaFieldInfo[];\n}\n\n/**\n * Extension point with hasView: true, guarantees Component property\n */\nexport interface ViewExtensionPointDefinition<\n  TData = any,\n  TProcessed = TData,\n  TProps = any\n> extends ExtensionPointDefinition<TData, TProcessed, TProps> {\n  Component: React.ComponentType<ExtensionComponentProps & TProps>;\n}\n\n/**\n * Type-safe extension point ID helper\n * Ensures consistent naming and helps with refactoring\n */\nexport function extensionPointId(\n  namespace: string,\n  feature: string,\n  ...subFeatures: string[]\n): string {\n  const parts = [namespace, feature, ...subFeatures].filter(Boolean);\n  return parts.join(\".\");\n}\n"],"names":["extensionPointId","namespace","feature","subFeatures"],"mappings":"yJA0MO,SAASA,EACdC,EACAC,KACGC,EACK,CAER,MADc,CAACF,EAAWC,EAAS,GAAGC,CAAW,EAAE,OAAO,OAAO,EACpD,KAAK,GAAG,CACvB"}

package/utils.js

@@ -1,296 +1,34 @@
-import { B as v, D as q, P as N, R as $, d as x, q as P, n as w, h as E, e as S, c as D, j as I, f as R, g as K, b as B, a as z, l as A, k as U, r as F, o as G, p as M, s as T, v as W } from "./documentation-generator-auruIa_o.js";
+import { B as c, C as g, D as l, P as u, p as x, R as d, j as m, t as E, o as P, f as R, h as v, e as f, c as h, k as p, d as S, g as b, b as y, a as k, l as w, n as B, r as C, q as D, s as V, u as j, v as I } from "./documentation-generator-Di4c9D9P.js";
 import "zod";
-function k(i, e, ...n) {
-  return [i, e, ...n].filter(Boolean).join(".");
-}
-function u(i) {
-  const e = i.match(/^(\d+)\.(\d+)\.\d+(?:-\S+)?$/);
-  if (!e)
-    throw new Error(`Invalid version format: ${i}`);
-  const [n, s, t] = e;
-  return `${s}.${t}.0`;
-}
-function y(i, e) {
-  var g, f;
-  e != null && e.sdkVersion && console.log("sdkVersion", e.sdkVersion), e != null && e.ddkVersion && console.log("ddkVersion", e.ddkVersion);
-  const n = u((e == null ? void 0 : e.sdkVersion) || "0.2.0"), s = u((e == null ? void 0 : e.ddkVersion) || "0.2.0");
-  console.log(`Using DDK version: ${s}`), console.log(`Using SDK version: ${n}`);
-  const t = i == null ? void 0 : i.name;
-  if (!t)
-    throw new Error(
-      "KOS Configuration should be added.  Project name not found in config"
-    );
-  const r = ((e == null ? void 0 : e.pluginPath) || "kos.ui.plugin").split(".").reduce((a, o) => (console.log(`Accessing key: ${o}`), a && a[o] ? a[o] : void 0), i), d = r == null ? void 0 : r.id;
-  if (!d)
-    throw new Error(
-      "KOS Configuration should be added.  Plugin ID not found in config"
-    );
-  const l = Object.keys(((g = r == null ? void 0 : r.contributes) == null ? void 0 : g.views) || {}).reduce(
-    (a, o) => (r.contributes.views[o].forEach((c) => {
-      a[`./${c.component}`] = c.location;
-    }), a),
-    {}
-  );
-  return Object.values(((f = r == null ? void 0 : r.contributes) == null ? void 0 : f.experiences) || {}).forEach(
-    (a) => {
-      l[`./${a.component}`] = a.location;
-    }
-  ), r != null && r.init && (l["./InitPlugin"] = "./src/app/init.ts"), {
-    name: t,
-    exposes: l,
-    library: { type: "var", name: d },
-    additionalShared: [
-      {
-        libraryName: "@kosdev-code/kos-ui-plugin",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          requiredVersion: `~${s}`
-        }
-      },
-      {
-        libraryName: "react",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !0,
-          requiredVersion: "18.2.0"
-        }
-      },
-      {
-        libraryName: "react-dom",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !0,
-          requiredVersion: "18.2.0"
-        }
-      },
-      {
-        libraryName: "@kosdev-code/kos-ui-sdk",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: `~${n}`
-        }
-      },
-      {
-        libraryName: "@kosdev-code/kos-dispense-sdk",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: `~${n}`
-        }
-      },
-      {
-        libraryName: "@kosdev-code/kos-freestyle-sdk",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: `~${n}`
-        }
-      },
-      {
-        libraryName: "@kosdev-code/kos-ddk-components",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: `~${s}`
-        }
-      },
-      {
-        libraryName: "@kosdev-code/kos-ddk-model-components",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: `~${s}`
-        }
-      },
-      {
-        libraryName: "@kosdev-code/kos-ddk-models",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: `~${s}`
-        }
-      },
-      {
-        libraryName: "@kosdev-code/kos-ddk",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: `~${s}`
-        }
-      },
-      {
-        libraryName: "@kosdev-code/kos-ddk-styles",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: `~${s}`
-        }
-      },
-      {
-        libraryName: "@emotion/styled",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "~11.11.0"
-        }
-      },
-      {
-        libraryName: "@emotion/react",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "~11.11.0"
-        }
-      },
-      {
-        libraryName: "reflect-metadata",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^0.2.2"
-        }
-      },
-      {
-        libraryName: "mobx",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^6.9.0"
-        }
-      },
-      {
-        libraryName: "loglevel",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^1.8.1"
-        }
-      },
-      {
-        libraryName: "robot3",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^0.4.0"
-        }
-      },
-      {
-        libraryName: "mobx-react-lite",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^3.4.3"
-        }
-      },
-      {
-        libraryName: "react-router-dom",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^6.11.2"
-        }
-      },
-      {
-        libraryName: "date-fns",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^2.30.0"
-        }
-      },
-      {
-        libraryName: "@use-gesture/react",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^10.3.0"
-        }
-      },
-      {
-        libraryName: "@react-spring/web",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^9.7.3"
-        }
-      },
-      {
-        libraryName: "react-simple-keyboard",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^3.6.13"
-        }
-      },
-      {
-        libraryName: "expr-eval",
-        sharedConfig: {
-          singleton: !0,
-          eager: !1,
-          strictVersion: !1,
-          requiredVersion: "^2.0.2"
-        }
-      },
-      {
-        libraryName: "zod",
-        sharedConfig: {
-          singleton: !0,
-          eager: !0,
-          strictVersion: !1,
-          requiredVersion: "^3.25.0"
-        }
-      }
-    ]
-  };
+function i(e, a, ...t) {
+  return [e, a, ...t].filter(Boolean).join(".");
 }
 export {
-  v as BaseViewExtensionSchema,
-  q as DocumentationGenerator,
-  N as PluginDiscoveryService,
-  $ as RankableViewExtensionSchema,
-  x as contributionReducer,
-  P as createExtensionSchema,
-  w as createViewAwareTransform,
-  E as defineExtensionPoint,
-  k as extensionPointId,
-  y as generatePluginConfiguration,
-  S as getContributions,
-  D as getExtensionPointRegistry,
-  I as getExtensionPointSchema,
-  R as getExtensions,
-  K as getValidationResults,
-  B as initPluginManager,
-  z as initializeKosPlugins,
-  A as loadExtensions,
-  U as registry,
-  F as resolveBestExtension,
-  G as validateDescriptorFormat,
-  M as validateRank,
-  T as validateRankIfPresent,
-  W as validateWithSchema
+  c as BaseViewExtensionSchema,
+  g as ContributionRegistry,
+  l as DocumentationGenerator,
+  u as PluginDiscoveryService,
+  x as RankableViewExtensionSchema,
+  d as ReactiveExtensionRegistry,
+  m as contributionReducer,
+  E as createExtensionSchema,
+  P as createViewAwareTransform,
+  R as defineExtensionPoint,
+  i as extensionPointId,
+  v as generatePluginConfiguration,
+  f as getContributions,
+  h as getExtensionPointRegistry,
+  p as getExtensionPointSchema,
+  S as getExtensions,
+  b as getValidationResults,
+  y as initPluginManager,
+  k as initializeKosPlugins,
+  w as loadExtensions,
+  B as registry,
+  C as resolveBestExtension,
+  D as validateDescriptorFormat,
+  V as validateRank,
+  j as validateRankIfPresent,
+  I as validateWithSchema
 };
 //# sourceMappingURL=utils.js.map

package/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/extension-point-types.ts","../../../../packages/sdk/kos-ui-plugin/src/lib/utils/processors/process-kos-config.ts"],"sourcesContent":["/**\n * Core types and interfaces for extension point system\n */\n\n// React import removed - component creation happens at runtime via hooks\nimport type { z } from \"zod\";\nimport type {\n  BasePluginExtension,\n  PluginExtensionsType,\n  ProcessedContributions,\n} from \"../../../types/plugins\";\n\n/**\n * Validation context for collecting validation issues\n */\nexport interface ValidationContext {\n  addError(message: string): void;\n  addWarning(message: string): void;\n  addInfo(message: string): void;\n  hasErrors(): boolean;\n  hasIssues(): boolean;\n  getIssues(): { type: \"error\" | \"warning\" | \"info\"; message: string }[];\n}\n\n/**\n * Context provided to transform functions\n */\nexport interface TransformContext {\n  remote: string;\n  sectionId: string;\n  experiences?: Record<string, any>;\n  contributions: ProcessedContributions;\n}\n\n/**\n * Schema field information for documentation\n */\nexport interface SchemaFieldInfo {\n  name: string;\n  description?: string;\n  type?: string;\n  required?: boolean;\n}\n\n/**\n * Configuration for defining a new extension point\n */\nexport interface ExtensionPointConfig<\n  TData = any,\n  TProcessed = TData,\n  _TProps = any\n> {\n  /**\n   * Unique identifier for this extension point\n   * Convention: \"ddk.{feature}\" or \"ddk.{feature}.{sub-feature}\"\n   */\n  id: string;\n\n  /**\n   * Optional display name for documentation/discovery\n   */\n  displayName?: string;\n\n  /**\n   * Optional description for documentation/discovery\n   */\n  description?: string;\n\n  /**\n   * The contribution key in the plugin descriptor\n   * e.g., \"myFeature\" maps to contributes.myFeature in kosdev-plugin.json\n   */\n  contributionKey: string;\n\n  /**\n   * Optional related extension points\n   * For example, a main extension might have .view and .definition variants\n   */\n  relatedPoints?: {\n    view?: string;\n    definition?: string;\n    [key: string]: string | undefined;\n  };\n\n  /**\n   * Transform function to process raw contribution data\n   * Allows custom processing logic while maintaining type safety\n   */\n  transform?: (data: TData, context: TransformContext) => TProcessed;\n\n  /**\n   * Optional validation function\n   * Use context.addError/addWarning/addInfo to collect validation issues\n   * Return \"skip\" to skip processing this contribution\n   */\n  validate?: (data: TData, context: ValidationContext) => \"skip\" | void;\n\n  /**\n   * Whether this extension point uses view/experience pattern\n   * Default: false\n   */\n  hasView?: boolean;\n\n  /**\n   * Whether contributions should be ranked\n   * Default: false\n   */\n  isRankable?: boolean;\n\n  /**\n   * Optional Zod schema for runtime validation and documentation\n   * Provides both type safety and field introspection for Plugin Explorer\n   */\n  schema?: z.ZodSchema<TData>;\n\n  /**\n   * Metadata for discovery/documentation\n   */\n  metadata?: {\n    category?: string;\n    tags?: string[];\n    since?: string;\n    deprecated?: boolean;\n    replacedBy?: string;\n    owner?: string;\n    /**\n     * The actual export name of this extension point in the code\n     * Used for documentation generation to show correct import statements\n     */\n    exportName?: string;\n  };\n}\n\n/**\n * Props for extension point components\n */\nexport interface ExtensionComponentProps {\n  /** Specific module to load (optional) */\n  module?: string;\n  /** Fallback component when extension not found */\n  fallback?: React.ReactNode;\n}\n\n/**\n * Result of defining an extension point\n */\nexport interface ExtensionPointDefinition<\n  TData = any,\n  TProcessed = TData,\n  TProps = any\n> {\n  /**\n   * The extension point configuration\n   */\n  config: ExtensionPointConfig<TData, TProcessed, TProps>;\n\n  /**\n   * Extension point ID for use in components\n   */\n  id: string;\n\n  /**\n   * Helper to get typed extensions (for future use with hooks)\n   */\n  getExtensions?: (\n    extensions: PluginExtensionsType\n  ) => Record<string, BasePluginExtension & { data: TProcessed }>;\n\n  /**\n   * Registration status\n   */\n  isRegistered: boolean;\n\n  /**\n   * Method to register this extension point\n   */\n  register: () => void;\n\n  // Component property removed - use useExtensionComponent hook or createExtensionComponent factory at runtime\n\n  /**\n   * Get schema field information for documentation purposes\n   * Returns field info that can be safely displayed by Plugin Explorer\n   */\n  getSchemaFieldInfo?: () => SchemaFieldInfo[];\n}\n\n/**\n * Extension point with hasView: true, guarantees Component property\n */\nexport interface ViewExtensionPointDefinition<\n  TData = any,\n  TProcessed = TData,\n  TProps = any\n> extends ExtensionPointDefinition<TData, TProcessed, TProps> {\n  Component: React.ComponentType<ExtensionComponentProps & TProps>;\n}\n\n/**\n * Type-safe extension point ID helper\n * Ensures consistent naming and helps with refactoring\n */\nexport function extensionPointId(\n  namespace: string,\n  feature: string,\n  ...subFeatures: string[]\n): string {\n  const parts = [namespace, feature, ...subFeatures].filter(Boolean);\n  return parts.join(\".\");\n}\n","/* eslint-disable max-lines-per-function */\nimport type { Contributions } from \"../../../types/global\";\n\ninterface KosConfigView {\n  id: string;\n  title: string;\n  component: string;\n  location: string;\n}\n\ninterface KosPluginConfig {\n  id: string;\n  init?: boolean;\n  contributes: Contributions;\n}\n\ninterface DDKConfig {\n  name: string;\n  kosdev: {\n    ddk: {\n      ncui: {\n        plugin: KosPluginConfig;\n      };\n    };\n  };\n}\n\ninterface CoreKosConfig {\n  name: string;\n  kos: {\n    ui: {\n      plugin: KosPluginConfig;\n    };\n  };\n}\n\nexport type KosConfig = DDKConfig | CoreKosConfig;\n\nfunction normalizeVersion(version: string): string {\n  const match = version.match(/^(\\d+)\\.(\\d+)\\.\\d+(?:-\\S+)?$/);\n  if (!match) {\n    throw new Error(`Invalid version format: ${version}`);\n  }\n  const [_, major, minor] = match;\n  return `${major}.${minor}.0`;\n}\n\nexport interface PluginOptions {\n  sdkVersion?: string;\n  ddkVersion?: string;\n  pluginPath?: string;\n}\nexport function generatePluginConfiguration(\n  config: KosConfig,\n  options?: PluginOptions\n): any {\n  if (options?.sdkVersion) {\n    console.log(\"sdkVersion\", options.sdkVersion);\n  }\n  if (options?.ddkVersion) {\n    console.log(\"ddkVersion\", options.ddkVersion);\n  }\n  const sdkVersion = normalizeVersion(options?.sdkVersion || \"0.2.0\");\n  const ddkVersion = normalizeVersion(options?.ddkVersion || \"0.2.0\");\n\n  console.log(`Using DDK version: ${ddkVersion}`);\n  console.log(`Using SDK version: ${sdkVersion}`);\n  const projectId = config?.name;\n  if (!projectId) {\n    throw new Error(\n      \"KOS Configuration should be added.  Project name not found in config\"\n    );\n  }\n  const pluginPath = options?.pluginPath || \"kos.ui.plugin\";\n  const pluginObj = pluginPath\n    .split(\".\")\n    .reduce<KosPluginConfig>((obj, key) => {\n      console.log(`Accessing key: ${key}`);\n      return obj && obj[key] ? obj[key] : undefined;\n    }, config as unknown as KosPluginConfig);\n\n  const pluginId = pluginObj?.id;\n  if (!pluginId) {\n    throw new Error(\n      \"KOS Configuration should be added.  Plugin ID not found in config\"\n    );\n  }\n  const mfConfig = Object.keys(pluginObj?.contributes?.views || {}).reduce(\n    (acc, key) => {\n      const views = pluginObj.contributes.views[key];\n\n      views.forEach((view) => {\n        acc[`./${view.component}`] = view.location;\n      });\n      return acc;\n    },\n    {}\n  );\n\n  Object.values(pluginObj?.contributes?.experiences || {}).forEach(\n    (experience) => {\n      mfConfig[`./${experience.component}`] = experience.location;\n    }\n  );\n\n  if (pluginObj?.init) {\n    mfConfig[\"./InitPlugin\"] = \"./src/app/init.ts\";\n  }\n\n  return {\n    name: projectId,\n    exposes: mfConfig,\n    library: { type: \"var\", name: pluginId },\n    additionalShared: [\n      {\n        libraryName: \"@kosdev-code/kos-ui-plugin\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"react\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: true,\n          requiredVersion: \"18.2.0\",\n        },\n      },\n\n      {\n        libraryName: \"react-dom\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: true,\n          requiredVersion: \"18.2.0\",\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ui-sdk\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${sdkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-dispense-sdk\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${sdkVersion}`,\n        },\n      },\n\n      {\n        libraryName: \"@kosdev-code/kos-freestyle-sdk\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${sdkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk-components\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk-model-components\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk-models\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@kosdev-code/kos-ddk-styles\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: `~${ddkVersion}`,\n        },\n      },\n      {\n        libraryName: \"@emotion/styled\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"~11.11.0\",\n        },\n      },\n      {\n        libraryName: \"@emotion/react\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"~11.11.0\",\n        },\n      },\n      {\n        libraryName: \"reflect-metadata\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^0.2.2\",\n        },\n      },\n      {\n        libraryName: \"mobx\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^6.9.0\",\n        },\n      },\n\n      {\n        libraryName: \"loglevel\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^1.8.1\",\n        },\n      },\n      {\n        libraryName: \"robot3\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^0.4.0\",\n        },\n      },\n      {\n        libraryName: \"mobx-react-lite\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^3.4.3\",\n        },\n      },\n      {\n        libraryName: \"react-router-dom\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^6.11.2\",\n        },\n      },\n      {\n        libraryName: \"date-fns\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^2.30.0\",\n        },\n      },\n      {\n        libraryName: \"@use-gesture/react\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^10.3.0\",\n        },\n      },\n      {\n        libraryName: \"@react-spring/web\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^9.7.3\",\n        },\n      },\n      {\n        libraryName: \"react-simple-keyboard\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^3.6.13\",\n        },\n      },\n      {\n        libraryName: \"expr-eval\",\n        sharedConfig: {\n          singleton: true,\n          eager: false,\n          strictVersion: false,\n          requiredVersion: \"^2.0.2\",\n        },\n      },\n      {\n        libraryName: \"zod\",\n        sharedConfig: {\n          singleton: true,\n          eager: true,\n          strictVersion: false,\n          requiredVersion: \"^3.25.0\",\n        },\n      },\n    ],\n  };\n}\n"],"names":["extensionPointId","namespace","feature","subFeatures","normalizeVersion","version","match","_","major","minor","generatePluginConfiguration","config","options","sdkVersion","ddkVersion","projectId","pluginObj","obj","key","pluginId","mfConfig","_a","acc","view","_b","experience"],"mappings":"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"}
+{"version":3,"file":"utils.js","sources":["../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/extension-point-types.ts"],"sourcesContent":["/**\n * Core types and interfaces for extension point system\n */\n\n// React import removed - component creation happens at runtime via hooks\nimport type { z } from \"zod\";\nimport type {\n  BasePluginExtension,\n  PluginExtensionsType,\n  ProcessedContributions,\n} from \"../../../types/plugins\";\n\n/**\n * Validation context for collecting validation issues\n */\nexport interface ValidationContext {\n  addError(message: string): void;\n  addWarning(message: string): void;\n  addInfo(message: string): void;\n  hasErrors(): boolean;\n  hasIssues(): boolean;\n  getIssues(): { type: \"error\" | \"warning\" | \"info\"; message: string }[];\n}\n\n/**\n * Context provided to transform functions\n */\nexport interface TransformContext {\n  remote: string;\n  sectionId: string;\n  experiences?: Record<string, any>;\n  contributions: ProcessedContributions;\n}\n\n/**\n * Schema field information for documentation\n */\nexport interface SchemaFieldInfo {\n  name: string;\n  description?: string;\n  type?: string;\n  required?: boolean;\n}\n\n/**\n * Configuration for defining a new extension point\n */\nexport interface ExtensionPointConfig<\n  TData = any,\n  TProcessed = TData,\n  _TProps = any\n> {\n  /**\n   * Unique identifier for this extension point\n   * Convention: \"ddk.{feature}\" or \"ddk.{feature}.{sub-feature}\"\n   */\n  id: string;\n\n  /**\n   * Optional display name for documentation/discovery\n   */\n  displayName?: string;\n\n  /**\n   * Optional description for documentation/discovery\n   */\n  description?: string;\n\n  /**\n   * The contribution key in the plugin descriptor\n   * e.g., \"myFeature\" maps to contributes.myFeature in kosdev-plugin.json\n   */\n  contributionKey: string;\n\n  /**\n   * Optional related extension points\n   * For example, a main extension might have .view and .definition variants\n   */\n  relatedPoints?: {\n    view?: string;\n    definition?: string;\n    [key: string]: string | undefined;\n  };\n\n  /**\n   * Transform function to process raw contribution data\n   * Allows custom processing logic while maintaining type safety\n   */\n  transform?: (data: TData, context: TransformContext) => TProcessed;\n\n  /**\n   * Optional validation function\n   * Use context.addError/addWarning/addInfo to collect validation issues\n   * Return \"skip\" to skip processing this contribution\n   */\n  validate?: (data: TData, context: ValidationContext) => \"skip\" | void;\n\n  /**\n   * Whether this extension point uses view/experience pattern\n   * Default: false\n   */\n  hasView?: boolean;\n\n  /**\n   * Whether contributions should be ranked\n   * Default: false\n   */\n  isRankable?: boolean;\n\n  /**\n   * Optional Zod schema for runtime validation and documentation\n   * Provides both type safety and field introspection for Plugin Explorer\n   */\n  schema?: z.ZodSchema<TData>;\n\n  /**\n   * Metadata for discovery/documentation\n   */\n  metadata?: {\n    category?: string;\n    tags?: string[];\n    since?: string;\n    deprecated?: boolean;\n    replacedBy?: string;\n    owner?: string;\n    /**\n     * The actual export name of this extension point in the code\n     * Used for documentation generation to show correct import statements\n     */\n    exportName?: string;\n  };\n}\n\n/**\n * Props for extension point components\n */\nexport interface ExtensionComponentProps {\n  /** Specific module to load (optional) */\n  module?: string;\n  /** Fallback component when extension not found */\n  fallback?: React.ReactNode;\n}\n\n/**\n * Result of defining an extension point\n */\nexport interface ExtensionPointDefinition<\n  TData = any,\n  TProcessed = TData,\n  TProps = any\n> {\n  /**\n   * The extension point configuration\n   */\n  config: ExtensionPointConfig<TData, TProcessed, TProps>;\n\n  /**\n   * Extension point ID for use in components\n   */\n  id: string;\n\n  /**\n   * Helper to get typed extensions (for future use with hooks)\n   */\n  getExtensions?: (\n    extensions: PluginExtensionsType\n  ) => Record<string, BasePluginExtension & { data: TProcessed }>;\n\n  /**\n   * Registration status\n   */\n  isRegistered: boolean;\n\n  /**\n   * Method to register this extension point\n   */\n  register: () => void;\n\n  // Component property removed - use useExtensionComponent hook or createExtensionComponent factory at runtime\n\n  /**\n   * Get schema field information for documentation purposes\n   * Returns field info that can be safely displayed by Plugin Explorer\n   */\n  getSchemaFieldInfo?: () => SchemaFieldInfo[];\n}\n\n/**\n * Extension point with hasView: true, guarantees Component property\n */\nexport interface ViewExtensionPointDefinition<\n  TData = any,\n  TProcessed = TData,\n  TProps = any\n> extends ExtensionPointDefinition<TData, TProcessed, TProps> {\n  Component: React.ComponentType<ExtensionComponentProps & TProps>;\n}\n\n/**\n * Type-safe extension point ID helper\n * Ensures consistent naming and helps with refactoring\n */\nexport function extensionPointId(\n  namespace: string,\n  feature: string,\n  ...subFeatures: string[]\n): string {\n  const parts = [namespace, feature, ...subFeatures].filter(Boolean);\n  return parts.join(\".\");\n}\n"],"names":["extensionPointId","namespace","feature","subFeatures"],"mappings":";;AA0MO,SAASA,EACdC,GACAC,MACGC,GACK;AAER,SADc,CAACF,GAAWC,GAAS,GAAGC,CAAW,EAAE,OAAO,OAAO,EACpD,KAAK,GAAG;AACvB;"}

package/webpack.cjs

@@ -1,13 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var he=typeof globalThis<"u"?globalThis:typeof window<"u"?window:typeof global<"u"?global:typeof self<"u"?self:{};function me(e){if(e.__esModule)return e;var r=e.default;if(typeof r=="function"){var t=function o(){return this instanceof o?Reflect.construct(r,arguments,this.constructor):r.apply(this,arguments)};t.prototype=r.prototype}else t={};return Object.defineProperty(t,"__esModule",{value:!0}),Object.keys(e).forEach(function(o){var u=Object.getOwnPropertyDescriptor(e,o);Object.defineProperty(t,o,u.get?u:{enumerable:!0,get:function(){return e[o]}})}),t}var A={exports:{}};const be={},Ee=Object.freeze(Object.defineProperty({__proto__:null,default:be},Symbol.toStringTag,{value:"Module"})),Z=me(Ee);var V={exports:{}},ne={},we=function(r){return r&&typeof r=="object"&&typeof r.copy=="function"&&typeof r.fill=="function"&&typeof r.readUInt8=="function"},G={exports:{}};typeof Object.create=="function"?G.exports=function(r,t){r.super_=t,r.prototype=Object.create(t.prototype,{constructor:{value:r,enumerable:!1,writable:!0,configurable:!0}})}:G.exports=function(r,t){r.super_=t;var o=function(){};o.prototype=t.prototype,r.prototype=new o,r.prototype.constructor=r};var _e=G.exports;(function(e){var r=/%[sdj%]/g;e.format=function(n){if(!z(n)){for(var i=[],s=0;s<arguments.length;s++)i.push(u(arguments[s]));return i.join(" ")}for(var s=1,p=arguments,_=p.length,g=String(n).replace(r,function(d){if(d==="%%")return"%";if(s>=_)return d;switch(d){case"%s":return String(p[s++]);case"%d":return Number(p[s++]);case"%j":try{return JSON.stringify(p[s++])}catch{return"[Circular]"}default:return d}}),c=p[s];s<_;c=p[++s])I(c)||!T(c)?g+=" "+c:g+=" "+u(c);return g},e.deprecate=function(n,i){if(D(he.process))return function(){return e.deprecate(n,i).apply(this,arguments)};if(process.noDeprecation===!0)return n;var s=!1;function p(){if(!s){if(process.throwDeprecation)throw new Error(i);process.traceDeprecation?console.trace(i):console.error(i),s=!0}return n.apply(this,arguments)}return p};var t={},o;e.debuglog=function(n){if(D(o)&&(o=process.env.NODE_DEBUG||""),n=n.toUpperCase(),!t[n])if(new RegExp("\\b"+n+"\\b","i").test(o)){var i=process.pid;t[n]=function(){var s=e.format.apply(e,arguments);console.error("%s %d: %s",n,i,s)}}else t[n]=function(){};return t[n]};function u(n,i){var s={seen:[],stylize:l};return arguments.length>=3&&(s.depth=arguments[2]),arguments.length>=4&&(s.colors=arguments[3]),M(i)?s.showHidden=i:i&&e._extend(s,i),D(s.showHidden)&&(s.showHidden=!1),D(s.depth)&&(s.depth=2),D(s.colors)&&(s.colors=!1),D(s.customInspect)&&(s.customInspect=!0),s.colors&&(s.stylize=a),v(s,n,s.depth)}e.inspect=u,u.colors={bold:[1,22],italic:[3,23],underline:[4,24],inverse:[7,27],white:[37,39],grey:[90,39],black:[30,39],blue:[34,39],cyan:[36,39],green:[32,39],magenta:[35,39],red:[31,39],yellow:[33,39]},u.styles={special:"cyan",number:"yellow",boolean:"yellow",undefined:"grey",null:"bold",string:"green",date:"magenta",regexp:"red"};function a(n,i){var s=u.styles[i];return s?"\x1B["+u.colors[s][0]+"m"+n+"\x1B["+u.colors[s][1]+"m":n}function l(n,i){return n}function f(n){var i={};return n.forEach(function(s,p){i[s]=!0}),i}function v(n,i,s){if(n.customInspect&&i&&L(i.inspect)&&i.inspect!==e.inspect&&!(i.constructor&&i.constructor.prototype===i)){var p=i.inspect(s,n);return z(p)||(p=v(n,p,s)),p}var _=h(n,i);if(_)return _;var g=Object.keys(i),c=f(g);if(n.showHidden&&(g=Object.getOwnPropertyNames(i)),R(i)&&(g.indexOf("message")>=0||g.indexOf("description")>=0))return y(i);if(g.length===0){if(L(i)){var d=i.name?": "+i.name:"";return n.stylize("[Function"+d+"]","special")}if(k(i))return n.stylize(RegExp.prototype.toString.call(i),"regexp");if(F(i))return n.stylize(Date.prototype.toString.call(i),"date");if(R(i))return y(i)}var w="",S=!1,U=["{","}"];if(x(i)&&(S=!0,U=["[","]"]),L(i)){var ve=i.name?": "+i.name:"";w=" [Function"+ve+"]"}if(k(i)&&(w=" "+RegExp.prototype.toString.call(i)),F(i)&&(w=" "+Date.prototype.toUTCString.call(i)),R(i)&&(w=" "+y(i)),g.length===0&&(!S||i.length==0))return U[0]+w+U[1];if(s<0)return k(i)?n.stylize(RegExp.prototype.toString.call(i),"regexp"):n.stylize("[Object]","special");n.seen.push(i);var W;return S?W=$(n,i,s,c,g):W=g.map(function(ye){return N(n,i,s,c,ye,S)}),n.seen.pop(),le(W,w,U)}function h(n,i){if(D(i))return n.stylize("undefined","undefined");if(z(i)){var s="'"+JSON.stringify(i).replace(/^"|"$/g,"").replace(/'/g,"\\'").replace(/\\"/g,'"')+"'";return n.stylize(s,"string")}if(ee(i))return n.stylize(""+i,"number");if(M(i))return n.stylize(""+i,"boolean");if(I(i))return n.stylize("null","null")}function y(n){return"["+Error.prototype.toString.call(n)+"]"}function $(n,i,s,p,_){for(var g=[],c=0,d=i.length;c<d;++c)re(i,String(c))?g.push(N(n,i,s,p,String(c),!0)):g.push("");return _.forEach(function(w){w.match(/^\d+$/)||g.push(N(n,i,s,p,w,!0))}),g}function N(n,i,s,p,_,g){var c,d,w;if(w=Object.getOwnPropertyDescriptor(i,_)||{value:i[_]},w.get?w.set?d=n.stylize("[Getter/Setter]","special"):d=n.stylize("[Getter]","special"):w.set&&(d=n.stylize("[Setter]","special")),re(p,_)||(c="["+_+"]"),d||(n.seen.indexOf(w.value)<0?(I(s)?d=v(n,w.value,null):d=v(n,w.value,s-1),d.indexOf(`
-`)>-1&&(g?d=d.split(`
-`).map(function(S){return"  "+S}).join(`
-`).substr(2):d=`
-`+d.split(`
-`).map(function(S){return"   "+S}).join(`
-`))):d=n.stylize("[Circular]","special")),D(c)){if(g&&_.match(/^\d+$/))return d;c=JSON.stringify(""+_),c.match(/^"([a-zA-Z_][a-zA-Z_0-9]*)"$/)?(c=c.substr(1,c.length-2),c=n.stylize(c,"name")):(c=c.replace(/'/g,"\\'").replace(/\\"/g,'"').replace(/(^"|"$)/g,"'"),c=n.stylize(c,"string"))}return c+": "+d}function le(n,i,s){var p=n.reduce(function(_,g){return g.indexOf(`
-`)>=0,_+g.replace(/\u001b\[\d\d?m/g,"").length+1},0);return p>60?s[0]+(i===""?"":i+`
- `)+" "+n.join(`,
-  `)+" "+s[1]:s[0]+i+" "+n.join(", ")+" "+s[1]}function x(n){return Array.isArray(n)}e.isArray=x;function M(n){return typeof n=="boolean"}e.isBoolean=M;function I(n){return n===null}e.isNull=I;function fe(n){return n==null}e.isNullOrUndefined=fe;function ee(n){return typeof n=="number"}e.isNumber=ee;function z(n){return typeof n=="string"}e.isString=z;function ce(n){return typeof n=="symbol"}e.isSymbol=ce;function D(n){return n===void 0}e.isUndefined=D;function k(n){return T(n)&&J(n)==="[object RegExp]"}e.isRegExp=k;function T(n){return typeof n=="object"&&n!==null}e.isObject=T;function F(n){return T(n)&&J(n)==="[object Date]"}e.isDate=F;function R(n){return T(n)&&(J(n)==="[object Error]"||n instanceof Error)}e.isError=R;function L(n){return typeof n=="function"}e.isFunction=L;function pe(n){return n===null||typeof n=="boolean"||typeof n=="number"||typeof n=="string"||typeof n=="symbol"||typeof n>"u"}e.isPrimitive=pe,e.isBuffer=we;function J(n){return Object.prototype.toString.call(n)}function q(n){return n<10?"0"+n.toString(10):n.toString(10)}var ge=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];function de(){var n=new Date,i=[q(n.getHours()),q(n.getMinutes()),q(n.getSeconds())].join(":");return[n.getDate(),ge[n.getMonth()],i].join(" ")}e.log=function(){console.log("%s - %s",de(),e.format.apply(e,arguments))},e.inherits=_e,e._extend=function(n,i){if(!i||!T(i))return n;for(var s=Object.keys(i),p=s.length;p--;)n[s[p]]=i[s[p]];return n};function re(n,i){return Object.prototype.hasOwnProperty.call(n,i)}})(ne);var Oe=process.platform==="win32",O=ne;function C(e,r){for(var t=[],o=0;o<e.length;o++){var u=e[o];!u||u==="."||(u===".."?t.length&&t[t.length-1]!==".."?t.pop():r&&t.push(".."):t.push(u))}return t}function j(e){for(var r=e.length-1,t=0;t<=r&&!e[t];t++);for(var o=r;o>=0&&!e[o];o--);return t===0&&o===r?e:t>o?[]:e.slice(t,o+1)}var oe=/^([a-zA-Z]:|[\\\/]{2}[^\\\/]+[\\\/]+[^\\\/]+)?([\\\/])?([\s\S]*?)$/,De=/^([\s\S]*?)((?:\.{1,2}|[^\\\/]+?|)(\.[^.\/\\]*|))(?:[\\\/]*)$/,m={};function Y(e){var r=oe.exec(e),t=(r[1]||"")+(r[2]||""),o=r[3]||"",u=De.exec(o),a=u[1],l=u[2],f=u[3];return[t,a,l,f]}function Q(e){var r=oe.exec(e),t=r[1]||"",o=!!t&&t[1]!==":";return{device:t,isUnc:o,isAbsolute:o||!!r[2],tail:r[3]}}function ie(e){return"\\\\"+e.replace(/^[\\\/]+/,"").replace(/[\\\/]+/g,"\\")}m.resolve=function(){for(var e="",r="",t=!1,o=arguments.length-1;o>=-1;o--){var u;if(o>=0?u=arguments[o]:e?(u=process.env["="+e],(!u||u.substr(0,3).toLowerCase()!==e.toLowerCase()+"\\")&&(u=e+"\\")):u=process.cwd(),O.isString(u)){if(!u)continue}else throw new TypeError("Arguments to path.resolve must be strings");var a=Q(u),l=a.device,f=a.isUnc,v=a.isAbsolute,h=a.tail;if(!(l&&e&&l.toLowerCase()!==e.toLowerCase())&&(e||(e=l),t||(r=h+"\\"+r,t=v),e&&t))break}return f&&(e=ie(e)),r=C(r.split(/[\\\/]+/),!t).join("\\"),e+(t?"\\":"")+r||"."};m.normalize=function(e){var r=Q(e),t=r.device,o=r.isUnc,u=r.isAbsolute,a=r.tail,l=/[\\\/]$/.test(a);return a=C(a.split(/[\\\/]+/),!u).join("\\"),!a&&!u&&(a="."),a&&l&&(a+="\\"),o&&(t=ie(t)),t+(u?"\\":"")+a};m.isAbsolute=function(e){return Q(e).isAbsolute};m.join=function(){for(var e=[],r=0;r<arguments.length;r++){var t=arguments[r];if(!O.isString(t))throw new TypeError("Arguments to path.join must be strings");t&&e.push(t)}var o=e.join("\\");return/^[\\\/]{2}[^\\\/]/.test(e[0])||(o=o.replace(/^[\\\/]{2,}/,"\\")),m.normalize(o)};m.relative=function(e,r){e=m.resolve(e),r=m.resolve(r);for(var t=e.toLowerCase(),o=r.toLowerCase(),u=j(r.split("\\")),a=j(t.split("\\")),l=j(o.split("\\")),f=Math.min(a.length,l.length),v=f,h=0;h<f;h++)if(a[h]!==l[h]){v=h;break}if(v==0)return r;for(var y=[],h=v;h<a.length;h++)y.push("..");return y=y.concat(u.slice(v)),y.join("\\")};m._makeLong=function(e){if(!O.isString(e))return e;if(!e)return"";var r=m.resolve(e);return/^[a-zA-Z]\:\\/.test(r)?"\\\\?\\"+r:/^\\\\[^?.]/.test(r)?"\\\\?\\UNC\\"+r.substring(2):e};m.dirname=function(e){var r=Y(e),t=r[0],o=r[1];return!t&&!o?".":(o&&(o=o.substr(0,o.length-1)),t+o)};m.basename=function(e,r){var t=Y(e)[2];return r&&t.substr(-1*r.length)===r&&(t=t.substr(0,t.length-r.length)),t};m.extname=function(e){return Y(e)[3]};m.format=function(e){if(!O.isObject(e))throw new TypeError("Parameter 'pathObject' must be an object, not "+typeof e);var r=e.root||"";if(!O.isString(r))throw new TypeError("'pathObject.root' must be a string or undefined, not "+typeof e.root);var t=e.dir,o=e.base||"";return t?t[t.length-1]===m.sep?t+o:t+m.sep+o:o};m.parse=function(e){if(!O.isString(e))throw new TypeError("Parameter 'pathString' must be a string, not "+typeof e);var r=Y(e);if(!r||r.length!==4)throw new TypeError("Invalid path '"+e+"'");return{root:r[0],dir:r[0]+r[1].slice(0,-1),base:r[2],ext:r[3],name:r[2].slice(0,r[2].length-r[3].length)}};m.sep="\\";m.delimiter=";";var Ne=/^(\/?|)([\s\S]*?)((?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/,b={};function B(e){return Ne.exec(e).slice(1)}b.resolve=function(){for(var e="",r=!1,t=arguments.length-1;t>=-1&&!r;t--){var o=t>=0?arguments[t]:process.cwd();if(O.isString(o)){if(!o)continue}else throw new TypeError("Arguments to path.resolve must be strings");e=o+"/"+e,r=o[0]==="/"}return e=C(e.split("/"),!r).join("/"),(r?"/":"")+e||"."};b.normalize=function(e){var r=b.isAbsolute(e),t=e&&e[e.length-1]==="/";return e=C(e.split("/"),!r).join("/"),!e&&!r&&(e="."),e&&t&&(e+="/"),(r?"/":"")+e};b.isAbsolute=function(e){return e.charAt(0)==="/"};b.join=function(){for(var e="",r=0;r<arguments.length;r++){var t=arguments[r];if(!O.isString(t))throw new TypeError("Arguments to path.join must be strings");t&&(e?e+="/"+t:e+=t)}return b.normalize(e)};b.relative=function(e,r){e=b.resolve(e).substr(1),r=b.resolve(r).substr(1);for(var t=j(e.split("/")),o=j(r.split("/")),u=Math.min(t.length,o.length),a=u,l=0;l<u;l++)if(t[l]!==o[l]){a=l;break}for(var f=[],l=a;l<t.length;l++)f.push("..");return f=f.concat(o.slice(a)),f.join("/")};b._makeLong=function(e){return e};b.dirname=function(e){var r=B(e),t=r[0],o=r[1];return!t&&!o?".":(o&&(o=o.substr(0,o.length-1)),t+o)};b.basename=function(e,r){var t=B(e)[2];return r&&t.substr(-1*r.length)===r&&(t=t.substr(0,t.length-r.length)),t};b.extname=function(e){return B(e)[3]};b.format=function(e){if(!O.isObject(e))throw new TypeError("Parameter 'pathObject' must be an object, not "+typeof e);var r=e.root||"";if(!O.isString(r))throw new TypeError("'pathObject.root' must be a string or undefined, not "+typeof e.root);var t=e.dir?e.dir+b.sep:"",o=e.base||"";return t+o};b.parse=function(e){if(!O.isString(e))throw new TypeError("Parameter 'pathString' must be a string, not "+typeof e);var r=B(e);if(!r||r.length!==4)throw new TypeError("Invalid path '"+e+"'");return r[1]=r[1]||"",r[2]=r[2]||"",r[3]=r[3]||"",{root:r[0],dir:r[0]+r[1].slice(0,-1),base:r[2],ext:r[3],name:r[2].slice(0,r[2].length-r[3].length)}};b.sep="/";b.delimiter=":";Oe?V.exports=m:V.exports=b;V.exports.posix=b;V.exports.win32=m;var Se=V.exports;const Ae="16.6.1",Te={version:Ae},H=Z,K=Se,je=Z,Pe=Z,Ve=Te,X=Ve.version,$e=/(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/mg;function Ie(e){const r={};let t=e.toString();t=t.replace(/\r\n?/mg,`
-`);let o;for(;(o=$e.exec(t))!=null;){const u=o[1];let a=o[2]||"";a=a.trim();const l=a[0];a=a.replace(/^(['"`])([\s\S]*)\1$/mg,"$2"),l==='"'&&(a=a.replace(/\\n/g,`
-`),a=a.replace(/\\r/g,"\r")),r[u]=a}return r}function ze(e){e=e||{};const r=ue(e);e.path=r;const t=E.configDotenv(e);if(!t.parsed){const l=new Error(`MISSING_DATA: Cannot parse ${r} for an unknown reason`);throw l.code="MISSING_DATA",l}const o=ae(e).split(","),u=o.length;let a;for(let l=0;l<u;l++)try{const f=o[l].trim(),v=Re(t,f);a=E.decrypt(v.ciphertext,v.key);break}catch(f){if(l+1>=u)throw f}return E.parse(a)}function ke(e){console.log(`[dotenv@${X}][WARN] ${e}`)}function P(e){console.log(`[dotenv@${X}][DEBUG] ${e}`)}function se(e){console.log(`[dotenv@${X}] ${e}`)}function ae(e){return e&&e.DOTENV_KEY&&e.DOTENV_KEY.length>0?e.DOTENV_KEY:process.env.DOTENV_KEY&&process.env.DOTENV_KEY.length>0?process.env.DOTENV_KEY:""}function Re(e,r){let t;try{t=new URL(r)}catch(f){if(f.code==="ERR_INVALID_URL"){const v=new Error("INVALID_DOTENV_KEY: Wrong format. Must be in valid uri format like dotenv://:key_1234@dotenvx.com/vault/.env.vault?environment=development");throw v.code="INVALID_DOTENV_KEY",v}throw f}const o=t.password;if(!o){const f=new Error("INVALID_DOTENV_KEY: Missing key part");throw f.code="INVALID_DOTENV_KEY",f}const u=t.searchParams.get("environment");if(!u){const f=new Error("INVALID_DOTENV_KEY: Missing environment part");throw f.code="INVALID_DOTENV_KEY",f}const a=`DOTENV_VAULT_${u.toUpperCase()}`,l=e.parsed[a];if(!l){const f=new Error(`NOT_FOUND_DOTENV_ENVIRONMENT: Cannot locate environment ${a} in your .env.vault file.`);throw f.code="NOT_FOUND_DOTENV_ENVIRONMENT",f}return{ciphertext:l,key:o}}function ue(e){let r=null;if(e&&e.path&&e.path.length>0)if(Array.isArray(e.path))for(const t of e.path)H.existsSync(t)&&(r=t.endsWith(".vault")?t:`${t}.vault`);else r=e.path.endsWith(".vault")?e.path:`${e.path}.vault`;else r=K.resolve(process.cwd(),".env.vault");return H.existsSync(r)?r:null}function te(e){return e[0]==="~"?K.join(je.homedir(),e.slice(1)):e}function Le(e){const r=!!(e&&e.debug),t=e&&"quiet"in e?e.quiet:!0;(r||!t)&&se("Loading env from encrypted .env.vault");const o=E._parseVault(e);let u=process.env;return e&&e.processEnv!=null&&(u=e.processEnv),E.populate(u,o,e),{parsed:o}}function Ue(e){const r=K.resolve(process.cwd(),".env");let t="utf8";const o=!!(e&&e.debug),u=e&&"quiet"in e?e.quiet:!0;e&&e.encoding?t=e.encoding:o&&P("No encoding is specified. UTF-8 is used by default");let a=[r];if(e&&e.path)if(!Array.isArray(e.path))a=[te(e.path)];else{a=[];for(const h of e.path)a.push(te(h))}let l;const f={};for(const h of a)try{const y=E.parse(H.readFileSync(h,{encoding:t}));E.populate(f,y,e)}catch(y){o&&P(`Failed to load ${h} ${y.message}`),l=y}let v=process.env;if(e&&e.processEnv!=null&&(v=e.processEnv),E.populate(v,f,e),o||!u){const h=Object.keys(f).length,y=[];for(const $ of a)try{const N=K.relative(process.cwd(),$);y.push(N)}catch(N){o&&P(`Failed to load ${$} ${N.message}`),l=N}se(`injecting env (${h}) from ${y.join(",")}`)}return l?{parsed:f,error:l}:{parsed:f}}function Ke(e){if(ae(e).length===0)return E.configDotenv(e);const r=ue(e);return r?E._configVault(e):(ke(`You set DOTENV_KEY but you are missing a .env.vault file at ${r}. Did you forget to build it?`),E.configDotenv(e))}function Ce(e,r){const t=Buffer.from(r.slice(-64),"hex");let o=Buffer.from(e,"base64");const u=o.subarray(0,12),a=o.subarray(-16);o=o.subarray(12,-16);try{const l=Pe.createDecipheriv("aes-256-gcm",t,u);return l.setAuthTag(a),`${l.update(o)}${l.final()}`}catch(l){const f=l instanceof RangeError,v=l.message==="Invalid key length",h=l.message==="Unsupported state or unable to authenticate data";if(f||v){const y=new Error("INVALID_DOTENV_KEY: It must be 64 characters long (or more)");throw y.code="INVALID_DOTENV_KEY",y}else if(h){const y=new Error("DECRYPTION_FAILED: Please check your DOTENV_KEY");throw y.code="DECRYPTION_FAILED",y}else throw l}}function Ye(e,r,t={}){const o=!!(t&&t.debug),u=!!(t&&t.override);if(typeof r!="object"){const a=new Error("OBJECT_REQUIRED: Please check the processEnv argument being passed to populate");throw a.code="OBJECT_REQUIRED",a}for(const a of Object.keys(r))Object.prototype.hasOwnProperty.call(e,a)?(u===!0&&(e[a]=r[a]),o&&P(u===!0?`"${a}" is already defined and WAS overwritten`:`"${a}" is already defined and was NOT overwritten`)):e[a]=r[a]}const E={configDotenv:Ue,_configVault:Le,_parseVault:ze,config:Ke,decrypt:Ce,parse:Ie,populate:Ye};A.exports.configDotenv=E.configDotenv;A.exports._configVault=E._configVault;A.exports._parseVault=E._parseVault;var Be=A.exports.config=E.config;A.exports.decrypt=E.decrypt;A.exports.parse=E.parse;A.exports.populate=E.populate;A.exports=E;function Me(){return Object.keys(process.env).filter(r=>r.startsWith("KOS_"))}Be({path:".env"});const Fe=e=>r=>{var t;return r&&(r.resolve=r.resolve||{},r.resolve.fallback={...r.resolve.fallback,path:!1}),r.mode=process.env.NODE_ENV||r.mode,(t=r==null?void 0:r.plugins)==null||t.push(new e.EnvironmentPlugin(["NODE_ENV",...Me()])),r};exports.withKosConfig=Fe;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const B=require("fs"),M=require("path"),re=require("os"),oe=require("crypto"),F=require("uuid");function G(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const s in e)if(s!=="default"){const a=Object.getOwnPropertyDescriptor(e,s);Object.defineProperty(t,s,a.get?a:{enumerable:!0,get:()=>e[s]})}}return t.default=e,Object.freeze(t)}const Q=G(B),H=G(M);var N={exports:{}};const ne="16.6.1",se={version:ne},J=B,Y=M,ae=re,ie=oe,ce=se,U=ce.version,le=/(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/mg;function ue(e){const t={};let s=e.toString();s=s.replace(/\r\n?/mg,`
+`);let a;for(;(a=le.exec(s))!=null;){const u=a[1];let r=a[2]||"";r=r.trim();const n=r[0];r=r.replace(/^(['"`])([\s\S]*)\1$/mg,"$2"),n==='"'&&(r=r.replace(/\\n/g,`
+`),r=r.replace(/\\r/g,"\r")),t[u]=r}return t}function ge(e){e=e||{};const t=ee(e);e.path=t;const s=p.configDotenv(e);if(!s.parsed){const n=new Error(`MISSING_DATA: Cannot parse ${t} for an unknown reason`);throw n.code="MISSING_DATA",n}const a=Z(e).split(","),u=a.length;let r;for(let n=0;n<u;n++)try{const o=a[n].trim(),c=pe(s,o);r=p.decrypt(c.ciphertext,c.key);break}catch(o){if(n+1>=u)throw o}return p.parse(r)}function de(e){console.log(`[dotenv@${U}][WARN] ${e}`)}function R(e){console.log(`[dotenv@${U}][DEBUG] ${e}`)}function X(e){console.log(`[dotenv@${U}] ${e}`)}function Z(e){return e&&e.DOTENV_KEY&&e.DOTENV_KEY.length>0?e.DOTENV_KEY:process.env.DOTENV_KEY&&process.env.DOTENV_KEY.length>0?process.env.DOTENV_KEY:""}function pe(e,t){let s;try{s=new URL(t)}catch(o){if(o.code==="ERR_INVALID_URL"){const c=new Error("INVALID_DOTENV_KEY: Wrong format. Must be in valid uri format like dotenv://:key_1234@dotenvx.com/vault/.env.vault?environment=development");throw c.code="INVALID_DOTENV_KEY",c}throw o}const a=s.password;if(!a){const o=new Error("INVALID_DOTENV_KEY: Missing key part");throw o.code="INVALID_DOTENV_KEY",o}const u=s.searchParams.get("environment");if(!u){const o=new Error("INVALID_DOTENV_KEY: Missing environment part");throw o.code="INVALID_DOTENV_KEY",o}const r=`DOTENV_VAULT_${u.toUpperCase()}`,n=e.parsed[r];if(!n){const o=new Error(`NOT_FOUND_DOTENV_ENVIRONMENT: Cannot locate environment ${r} in your .env.vault file.`);throw o.code="NOT_FOUND_DOTENV_ENVIRONMENT",o}return{ciphertext:n,key:a}}function ee(e){let t=null;if(e&&e.path&&e.path.length>0)if(Array.isArray(e.path))for(const s of e.path)J.existsSync(s)&&(t=s.endsWith(".vault")?s:`${s}.vault`);else t=e.path.endsWith(".vault")?e.path:`${e.path}.vault`;else t=Y.resolve(process.cwd(),".env.vault");return J.existsSync(t)?t:null}function z(e){return e[0]==="~"?Y.join(ae.homedir(),e.slice(1)):e}function fe(e){const t=!!(e&&e.debug),s=e&&"quiet"in e?e.quiet:!0;(t||!s)&&X("Loading env from encrypted .env.vault");const a=p._parseVault(e);let u=process.env;return e&&e.processEnv!=null&&(u=e.processEnv),p.populate(u,a,e),{parsed:a}}function ve(e){const t=Y.resolve(process.cwd(),".env");let s="utf8";const a=!!(e&&e.debug),u=e&&"quiet"in e?e.quiet:!0;e&&e.encoding?s=e.encoding:a&&R("No encoding is specified. UTF-8 is used by default");let r=[t];if(e&&e.path)if(!Array.isArray(e.path))r=[z(e.path)];else{r=[];for(const d of e.path)r.push(z(d))}let n;const o={};for(const d of r)try{const g=p.parse(J.readFileSync(d,{encoding:s}));p.populate(o,g,e)}catch(g){a&&R(`Failed to load ${d} ${g.message}`),n=g}let c=process.env;if(e&&e.processEnv!=null&&(c=e.processEnv),p.populate(c,o,e),a||!u){const d=Object.keys(o).length,g=[];for(const m of r)try{const v=Y.relative(process.cwd(),m);g.push(v)}catch(v){a&&R(`Failed to load ${m} ${v.message}`),n=v}X(`injecting env (${d}) from ${g.join(",")}`)}return n?{parsed:o,error:n}:{parsed:o}}function he(e){if(Z(e).length===0)return p.configDotenv(e);const t=ee(e);return t?p._configVault(e):(de(`You set DOTENV_KEY but you are missing a .env.vault file at ${t}. Did you forget to build it?`),p.configDotenv(e))}function De(e,t){const s=Buffer.from(t.slice(-64),"hex");let a=Buffer.from(e,"base64");const u=a.subarray(0,12),r=a.subarray(-16);a=a.subarray(12,-16);try{const n=ie.createDecipheriv("aes-256-gcm",s,u);return n.setAuthTag(r),`${n.update(a)}${n.final()}`}catch(n){const o=n instanceof RangeError,c=n.message==="Invalid key length",d=n.message==="Unsupported state or unable to authenticate data";if(o||c){const g=new Error("INVALID_DOTENV_KEY: It must be 64 characters long (or more)");throw g.code="INVALID_DOTENV_KEY",g}else if(d){const g=new Error("DECRYPTION_FAILED: Please check your DOTENV_KEY");throw g.code="DECRYPTION_FAILED",g}else throw n}}function Ee(e,t,s={}){const a=!!(s&&s.debug),u=!!(s&&s.override);if(typeof t!="object"){const r=new Error("OBJECT_REQUIRED: Please check the processEnv argument being passed to populate");throw r.code="OBJECT_REQUIRED",r}for(const r of Object.keys(t))Object.prototype.hasOwnProperty.call(e,r)?(u===!0&&(e[r]=t[r]),a&&R(u===!0?`"${r}" is already defined and WAS overwritten`:`"${r}" is already defined and was NOT overwritten`)):e[r]=t[r]}const p={configDotenv:ve,_configVault:fe,_parseVault:ge,config:he,decrypt:De,parse:ue,populate:Ee};N.exports.configDotenv=p.configDotenv;N.exports._configVault=p._configVault;N.exports._parseVault=p._parseVault;var ke=N.exports.config=p.config;N.exports.decrypt=p.decrypt;N.exports.parse=p.parse;N.exports.populate=p.populate;N.exports=p;function we(){return Object.keys(process.env).filter(t=>t.startsWith("KOS_"))}ke({path:".env"});const ye=e=>t=>{var s;return t&&(t.resolve=t.resolve||{},t.resolve.fallback={...t.resolve.fallback,path:!1}),t.mode=process.env.NODE_ENV||t.mode,(s=t==null?void 0:t.plugins)==null||s.push(new e.EnvironmentPlugin(["NODE_ENV",...we()])),t},me=(e={})=>{const{kosJsonPath:t=".kos.json",projectRoot:s,defaultContext:a="kosdev.ddk",verbose:u=!1}=e;return(r,n)=>{var g,m;if(!r.devServer)return u&&console.log("[withPluginDevServer] No devServer config found, skipping middleware"),r;let o=s||process.cwd();s||(r!=null&&r.context&&typeof r.context=="string"?o=r.context:(g=n==null?void 0:n.options)!=null&&g.root&&((m=n==null?void 0:n.options)!=null&&m.projectRoot)&&(o=H.join(n.options.root,n.options.projectRoot)));const c=H.resolve(o,t);u&&console.log("[withPluginDevServer] Configuration:",{kosJsonPath:c,projectRoot:o,defaultContext:a});const d=r.devServer.setupMiddlewares;return r.devServer.setupMiddlewares=(v,O)=>(d&&(v=d(v,O)),O.app.get("/api/kos/ui/plugins/contexts",(L,_)=>{var S,q,E,V;try{if(!Q.existsSync(c)){const b=`.kos.json not found at ${c}`;return console.error(`[withPluginDevServer] ${b}`),_.status(404).json({status:404,error:b,hint:"Ensure .kos.json exists in your plugin project root"})}const k=Q.readFileSync(c,"utf-8"),T=JSON.parse(k),P=(q=(S=T.kos)==null?void 0:S.ui)==null?void 0:q.plugin;if(!P){const b="kos.ui.plugin section not found in .kos.json";return console.error(`[withPluginDevServer] ${b}`),_.status(400).json({status:400,error:b,hint:"Ensure .kos.json has kos.ui.plugin section defined"})}const j=(E=T.test)==null?void 0:E.plugin,I=(j==null?void 0:j.context)||a,K=F.v4(),$={status:200,version:{major:1,minor:0},data:[{name:I,plugins:[{descriptor:P,id:K,path:"/"}]}]};u&&console.log("[withPluginDevServer] Serving plugin metadata:",{pluginId:P.id,context:I,extensionsCount:((V=P.extensions)==null?void 0:V.length)||0}),_.json($)}catch(k){console.error("[withPluginDevServer] Error serving plugin metadata:",k),_.status(500).json({status:500,error:"Failed to serve plugin metadata",details:k instanceof Error?k.message:String(k)})}}),u&&console.log("[withPluginDevServer] Plugin metadata endpoint registered at /api/kos/ui/plugins/contexts"),v),r}},_e=e=>{const{pluginServers:t,includeHostPlugins:s=!0,kosJsonPath:a=".kos.json",mergeWithBackend:u=!1,fallbackToBackend:r=!0,backendUrl:n="http://localhost:8081",verbose:o=!1}=e;return(c,d)=>{var O,L;let g=process.cwd();c!=null&&c.context&&typeof c.context=="string"?g=c.context:(O=d==null?void 0:d.options)!=null&&O.root&&((L=d==null?void 0:d.options)!=null&&L.projectRoot)&&(g=M.join(d.options.root,d.options.projectRoot));const m=M.join(g,a);if(!c.devServer)return o&&console.log("[withPluginDevAggregator] No devServer config found, skipping middleware"),c;o&&console.log("[withPluginDevAggregator] Configuration:",{pluginServers:t,fallbackToBackend:r,backendUrl:n,projectRoot:g,kosJsonPath:m});const v=c.devServer.setupMiddlewares;return c.devServer.setupMiddlewares=(_,S)=>(v&&(_=v(_,S)),S.app.get("/api/kos/ui/plugins/contexts",async(q,E)=>{var V,k,T,P,j,I,K;try{if(t.length===0)if(r){o&&console.log("[withPluginDevAggregator] No plugin servers, proxying to backend:",n);const l=await(await fetch(`${n}/api/kos/ui/plugins/contexts`)).json();return E.json(l)}else return E.status(404).json({status:404,error:"No plugin servers configured",hint:"Add plugin server URLs to withPluginDevAggregator options or enable fallbackToBackend"});const b=(await Promise.all(t.map(async i=>{try{const l=await fetch(`${i}/api/kos/ui/plugins/contexts`);if(!l.ok)return o&&console.warn(`[withPluginDevAggregator] Failed to fetch from ${i}: ${l.status}`),null;const f=await l.json();return{serverUrl:i,data:f}}catch(l){return o&&console.warn(`[withPluginDevAggregator] Error fetching from ${i}:`,l),null}}))).filter(i=>i&&i.data&&i.data.status===200);if(b.length===0&&r){o&&console.log("[withPluginDevAggregator] No plugin servers responded, falling back to backend");try{const l=await(await fetch(`${n}/api/kos/ui/plugins/contexts`)).json();return E.json(l)}catch(i){return E.status(503).json({status:503,error:"No plugin servers available and backend unreachable",details:i instanceof Error?i.message:String(i)})}}const D={},C={};if(u)try{o&&console.log("[withPluginDevAggregator] Fetching backend plugins from:",n);const i=await fetch(`${n}/api/kos/ui/plugins/contexts`);if(i.ok){const l=await i.json();l.status===200&&l.data&&(l.data.forEach(f=>{const w=f.name;D[w]||(D[w]=[]),f.plugins.forEach(y=>{var h;D[w].push(y),o&&console.log(`[withPluginDevAggregator] Added backend plugin: ${(h=y.descriptor)==null?void 0:h.id} (no override)`)})}),o&&console.log("[withPluginDevAggregator] Successfully merged backend plugins"))}else o&&console.warn(`[withPluginDevAggregator] Backend fetch failed: ${i.status}`)}catch(i){o&&console.warn("[withPluginDevAggregator] Error fetching backend plugins:",i)}if(s)try{const i=B.readFileSync(m,"utf-8"),l=JSON.parse(i),f=(k=(V=l.kos)==null?void 0:V.ui)==null?void 0:k.plugin,w=(j=(P=(T=l.kosdev)==null?void 0:T.ddk)==null?void 0:P.ncui)==null?void 0:j.plugin,y=[];f&&y.push({name:((K=(I=l.test)==null?void 0:I.plugin)==null?void 0:K.context)||"kos.ui",plugin:{descriptor:f,id:F.v4(),path:"/"}}),w&&y.push({name:"kosdev.ddk",plugin:{descriptor:w,id:F.v4(),path:"/"}}),y.forEach(({name:h,plugin:A})=>{D[h]||(D[h]=[]),D[h].push(A),o&&console.log(`[withPluginDevAggregator] Added host plugin: ${A.descriptor.id} to context ${h}`)})}catch(i){o&&console.warn("[withPluginDevAggregator] Failed to read host .kos.json:",i)}b.forEach(i=>{var w;if(!i)return;const{serverUrl:l,data:f}=i;(w=f.data)==null||w.forEach(y=>{const h=y.name;D[h]||(D[h]=[]),y.plugins.forEach(A=>{var W;D[h].push(A),C[A.id]=`${l}/`,o&&console.log(`[withPluginDevAggregator] Added local dev plugin: ${(W=A.descriptor)==null?void 0:W.id} with override to ${l}/`)})})});const x=Object.entries(D).map(([i,l])=>({name:i,plugins:l})),te={status:200,version:{major:1,minor:0},data:x,overrides:C};o&&console.log("[withPluginDevAggregator] Aggregated plugins:",{contexts:x.length,totalPlugins:x.reduce((i,l)=>i+l.plugins.length,0),pluginIds:x.flatMap(i=>i.plugins.map(l=>{var f;return(f=l.descriptor)==null?void 0:f.id})),overrides:C}),E.json(te)}catch($){console.error("[withPluginDevAggregator] Error aggregating plugins:",$),E.status(500).json({status:500,error:"Failed to aggregate plugin metadata",details:$ instanceof Error?$.message:String($)})}}),o&&console.log("[withPluginDevAggregator] Plugin aggregation endpoint registered at /api/kos/ui/plugins/contexts"),_),c}};exports.withKosConfig=ye;exports.withPluginDevAggregator=_e;exports.withPluginDevServer=me;
 //# sourceMappingURL=webpack.cjs.map