@kosdev-code/kos-ui-plugin 0.1.0-dev.5101 → 0.1.0-dev.5105

package/lib/utils/reactive-extension-registry.d.ts

@@ -0,0 +1,140 @@
+import { PluginExtension, PluginExtensionsType } from '../../types/plugins';
+
+/**
+ * Event emitted when extension point changes
+ */
+export interface ExtensionPointChangeEvent {
+    extensionPoint: string;
+    changeType: "contribution-enabled" | "contribution-disabled" | "best-changed";
+    affectedContribution: string;
+    newBest?: string;
+    timestamp: number;
+}
+/**
+ * Reactive extension registry that monitors contribution state
+ *
+ * Bridges the gap between ContributionRegistry (state management) and
+ * React components by providing filtered extension lists and change notifications.
+ *
+ * This registry:
+ * - Filters extensions based on enabled state
+ * - Subscribes to ContributionRegistry for state changes
+ * - Emits ExtensionPointChangeEvent when contributions change
+ * - Manages extension point-scoped subscriptions
+ * - Handles cleanup to prevent memory leaks
+ *
+ * @example
+ * ```typescript
+ * const registry = new ReactiveExtensionRegistry(extensions);
+ *
+ * // Get only enabled extensions
+ * const enabledExtensions = registry.getExtensions('ddk.settings.view');
+ *
+ * // Subscribe to changes
+ * const unsubscribe = registry.subscribe('ddk.settings.view', (event) => {
+ *   console.log('Extension point changed:', event);
+ * });
+ *
+ * // Cleanup when done
+ * registry.destroy();
+ * ```
+ */
+export declare class ReactiveExtensionRegistry {
+    /**
+     * Reference to all plugin extensions (unfiltered)
+     */
+    private extensions;
+    /**
+     * Map of extension point to listeners
+     * Each extension point can have multiple components listening for changes
+     */
+    private listeners;
+    /**
+     * Unsubscribe function for ContributionRegistry subscription
+     * Used during cleanup to remove listener
+     */
+    private contributionUnsubscribe;
+    constructor(extensions: PluginExtensionsType);
+    /**
+     * Get extensions for an extension point (filtered by enabled state)
+     *
+     * By default, only returns enabled contributions. Use `includeDisabled: true`
+     * to get all contributions regardless of state.
+     *
+     * @param extensionPoint - Extension point identifier
+     * @param includeDisabled - If true, include disabled contributions (default: false)
+     * @returns Record of extension ID to extension object
+     *
+     * @example
+     * ```typescript
+     * // Get only enabled settings extensions
+     * const enabled = registry.getExtensions('ddk.settings.view');
+     *
+     * // Get all settings extensions (including disabled)
+     * const all = registry.getExtensions('ddk.settings.view', true);
+     * ```
+     */
+    getExtensions(extensionPoint: string, includeDisabled?: boolean): Record<string, PluginExtension>;
+    /**
+     * Subscribe to changes for a specific extension point
+     *
+     * Registers a listener that will be called whenever contributions for
+     * the specified extension point change state (enabled/disabled) or when
+     * the best contribution for that point changes.
+     *
+     * @param extensionPoint - Extension point identifier to monitor
+     * @param listener - Callback function to handle change events
+     * @returns Unsubscribe function to stop receiving events
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = registry.subscribe('ddk.settings.view', (event) => {
+     *   if (event.changeType === 'best-changed') {
+     *     console.log('New best contribution:', event.newBest);
+     *   }
+     * });
+     *
+     * // Later...
+     * unsubscribe();
+     * ```
+     */
+    subscribe(extensionPoint: string, listener: (event: ExtensionPointChangeEvent) => void): () => void;
+    /**
+     * Internal: Subscribe to contribution state changes
+     *
+     * Sets up subscription to ContributionRegistry to receive notifications
+     * when any contribution's enabled state changes. Routes these events to
+     * extension point-specific listeners.
+     *
+     * @private
+     */
+    private subscribeToContributionChanges;
+    /**
+     * Internal: Handle contribution state change
+     *
+     * Called when ContributionRegistry emits a state change event.
+     * Determines if the "best" contribution has changed and emits
+     * ExtensionPointChangeEvent to all listeners for that extension point.
+     *
+     * @param event - Contribution state change event from ContributionRegistry
+     * @private
+     */
+    private handleContributionChange;
+    /**
+     * Cleanup subscriptions and listeners
+     *
+     * Call this when the registry is no longer needed to prevent memory leaks.
+     * Typically called when the PluginsProvider is unmounted.
+     *
+     * @example
+     * ```typescript
+     * useEffect(() => {
+     *   const registry = new ReactiveExtensionRegistry(extensions);
+     *   // Use registry...
+     *   return () => registry.destroy();
+     * }, []);
+     * ```
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=reactive-extension-registry.d.ts.map

package/lib/utils/reactive-extension-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive-extension-registry.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/reactive-extension-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAI7B;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,sBAAsB,GAAG,uBAAuB,GAAG,cAAc,CAAC;IAC9E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;OAGG;IACH,OAAO,CAAC,SAAS,CAGf;IAEF;;;OAGG;IACH,OAAO,CAAC,uBAAuB,CAA6B;gBAEhD,UAAU,EAAE,oBAAoB;IAM5C;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,eAAe,UAAQ,GACtB,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAgBlC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAS,CACP,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GACnD,MAAM,IAAI;IAuBb;;;;;;;;OAQG;IACH,OAAO,CAAC,8BAA8B;IAMtC;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;IA6ChC;;;;;;;;;;;;;;OAcG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-ui-plugin",
-  "version": "0.1.0-dev.5101",
+  "version": "0.1.0-dev.5105",
   "type": "module",
   "exports": {
     ".": {
@@ -21,7 +21,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "96dbc64113639eae888fbbd86d1258fbd6a9795f"
+      "gitHash": "3cb1fbf425504408f84cd704914a2f328bbb8fab"
     }
   },
   "publishConfig": {

package/types/contribution-enablement.d.ts

@@ -0,0 +1,293 @@
+import { BaseContribution, PluginExtensionsType, ProcessedContributions } from './plugins';
+
+/**
+ * Enhanced contribution interface with runtime enablement state
+ *
+ * Extends BaseContribution with fields that enable dynamic runtime control
+ * over contribution visibility and availability. This allows plugins to
+ * respond to events (feature flags, device state, etc.) and update which
+ * contributions are visible to the plugin system.
+ *
+ * @example
+ * ```typescript
+ * const contribution: DynamicContribution = {
+ *   id: 'advanced-settings',
+ *   remote: 'settingsPlugin',
+ *   sectionId: 'settings',
+ *   enabled: true,
+ *   enabledCondition: (context) => {
+ *     return context.context?.userRole === 'admin';
+ *   }
+ * };
+ * ```
+ */
+export interface DynamicContribution extends BaseContribution {
+    /**
+     * Whether this contribution is currently enabled
+     *
+     * When false, the contribution will be filtered out by resolveBestExtension
+     * and will not be visible to DynamicComponent or other plugin consumers.
+     *
+     * @default true
+     */
+    enabled: boolean;
+    /**
+     * Optional reason for disabled state
+     *
+     * Useful for debugging, logging, and displaying to users why a contribution
+     * is unavailable. Should be a human-readable string.
+     *
+     * @example "Feature flag 'advanced-mode' is disabled"
+     * @example "User lacks premium license"
+     * @example "Device mode: basic"
+     */
+    disabledReason?: string;
+    /**
+     * Optional timestamp when enabled state last changed
+     *
+     * Unix timestamp (milliseconds) of the last state transition.
+     * Useful for debugging, auditing, and temporal queries.
+     *
+     * @example Date.now() // 1705780800000
+     */
+    lastStateChange?: number;
+    /**
+     * Optional conditional enablement function
+     *
+     * Evaluated when contribution is accessed via isEnabled().
+     * Allows for dynamic enablement based on runtime context.
+     *
+     * If provided, this function is called in addition to checking the
+     * `enabled` boolean field. Both must be true for the contribution
+     * to be considered enabled.
+     *
+     * @param context - Current runtime context including extensions, contributions, and custom data
+     * @returns true if contribution should be enabled, false otherwise
+     *
+     * @example
+     * ```typescript
+     * enabledCondition: (context) => {
+     *   const licenseModel = context.context?.licenseModel;
+     *   return licenseModel?.hasPremiumLicense === true;
+     * }
+     * ```
+     */
+    enabledCondition?: (context: EnablementContext) => boolean;
+}
+/**
+ * Context provided to enablement condition functions
+ *
+ * Provides runtime information that enablement conditions can use to
+ * determine whether a contribution should be enabled. This includes
+ * the current plugin system state and custom application data.
+ */
+export interface EnablementContext {
+    /**
+     * Current extensions state
+     *
+     * The full PluginExtensionsType object representing all registered
+     * extension points and their contributions.
+     */
+    extensions: PluginExtensionsType;
+    /**
+     * Current contributions state
+     *
+     * Processed contributions including experiences and other contribution types.
+     */
+    contributions: ProcessedContributions;
+    /**
+     * Custom context data
+     *
+     * Application-specific context that can be used in enablement conditions.
+     * For example, user model, license model, device state, etc.
+     *
+     * @example
+     * ```typescript
+     * {
+     *   userModel: { role: 'admin', id: '123' },
+     *   licenseModel: { hasPremiumLicense: true },
+     *   deviceState: { mode: 'advanced' }
+     * }
+     * ```
+     */
+    context?: Record<string, any>;
+}
+/**
+ * Event emitted when a contribution's enabled state changes
+ *
+ * This event is emitted by ContributionRegistry whenever setEnabled()
+ * or batchUpdate() changes a contribution's state. Listeners can subscribe
+ * to these events to react to enablement changes.
+ */
+export interface ContributionStateChangeEvent {
+    /**
+     * Unique identifier of the contribution that changed
+     */
+    contributionId: string;
+    /**
+     * Extension point this contribution belongs to
+     *
+     * @example "ddk.features"
+     * @example "ddk.settings.view"
+     */
+    extensionPoint: string;
+    /**
+     * New enabled state (true = enabled, false = disabled)
+     */
+    enabled: boolean;
+    /**
+     * Previous enabled state before this change
+     */
+    previousState: boolean;
+    /**
+     * Optional reason for the state change
+     *
+     * @example "Feature flag 'advanced-mode' changed to enabled"
+     * @example "App unloaded"
+     */
+    reason?: string;
+    /**
+     * Unix timestamp (milliseconds) when this change occurred
+     */
+    timestamp: number;
+}
+/**
+ * Centralized contribution enablement registry interface
+ *
+ * The ContributionRegistry manages the enabled/disabled state of all
+ * contributions in the plugin system. It provides methods to:
+ * - Update contribution state
+ * - Query contribution state
+ * - Subscribe to state changes
+ * - Perform batch atomic updates
+ *
+ * This is the primary API for implementing dynamic contribution enablement.
+ */
+export interface IContributionRegistry {
+    /**
+     * Set enabled state for a contribution
+     *
+     * Updates the contribution's enabled state and emits a
+     * ContributionStateChangeEvent to all subscribers.
+     *
+     * @param contributionId - Unique identifier of the contribution
+     * @param enabled - New enabled state (true = enabled, false = disabled)
+     * @param reason - Optional human-readable reason for the change
+     *
+     * @throws Error if contribution does not exist
+     *
+     * @example
+     * ```typescript
+     * ContributionRegistry.setEnabled(
+     *   'advanced-settings',
+     *   false,
+     *   'Device mode changed to basic'
+     * );
+     * ```
+     */
+    setEnabled(contributionId: string, enabled: boolean, reason?: string): void;
+    /**
+     * Get enabled state for a contribution
+     *
+     * Checks both the enabled boolean field and evaluates any
+     * enabledCondition function if present. Returns true only if
+     * both checks pass.
+     *
+     * @param contributionId - Unique identifier of the contribution
+     * @returns true if contribution is enabled, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (ContributionRegistry.isEnabled('advanced-settings')) {
+     *   // Show advanced settings UI
+     * }
+     * ```
+     */
+    isEnabled(contributionId: string): boolean;
+    /**
+     * Subscribe to all contribution state changes
+     *
+     * Registers a listener that will be called whenever any contribution's
+     * enabled state changes. The listener receives a ContributionStateChangeEvent.
+     *
+     * @param listener - Callback function to handle state change events
+     * @returns Unsubscribe function to stop receiving events
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = ContributionRegistry.subscribe((event) => {
+     *   console.log(`${event.contributionId} ${event.enabled ? 'enabled' : 'disabled'}`);
+     * });
+     *
+     * // Later: stop listening
+     * unsubscribe();
+     * ```
+     */
+    subscribe(listener: (event: ContributionStateChangeEvent) => void): () => void;
+    /**
+     * Subscribe to changes for a specific extension point
+     *
+     * Like subscribe(), but only emits events for contributions
+     * belonging to the specified extension point.
+     *
+     * @param extensionPoint - Extension point identifier to monitor
+     * @param listener - Callback function to handle state change events
+     * @returns Unsubscribe function to stop receiving events
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = ContributionRegistry.subscribeToExtensionPoint(
+     *   'ddk.settings.view',
+     *   (event) => {
+     *     console.log(`Settings contribution changed: ${event.contributionId}`);
+     *   }
+     * );
+     * ```
+     */
+    subscribeToExtensionPoint(extensionPoint: string, listener: (event: ContributionStateChangeEvent) => void): () => void;
+    /**
+     * Batch update multiple contributions atomically
+     *
+     * Updates multiple contribution states in a single atomic operation.
+     * All updates succeed or all fail together. Emits one event per
+     * contribution that changed state.
+     *
+     * @param updates - Array of contribution updates to apply
+     *
+     * @example
+     * ```typescript
+     * // Disable all advanced features at once
+     * ContributionRegistry.batchUpdate([
+     *   { contributionId: 'advanced-settings', enabled: false, reason: 'Basic mode' },
+     *   { contributionId: 'diagnostics', enabled: false, reason: 'Basic mode' },
+     *   { contributionId: 'dev-tools', enabled: false, reason: 'Basic mode' }
+     * ]);
+     * ```
+     */
+    batchUpdate(updates: Array<{
+        contributionId: string;
+        enabled: boolean;
+        reason?: string;
+    }>): void;
+    /**
+     * Get all contributions for an extension point
+     *
+     * Returns an array of DynamicContribution objects for the specified
+     * extension point. By default, only returns enabled contributions.
+     *
+     * @param extensionPoint - Extension point identifier
+     * @param includeDisabled - If true, include disabled contributions in results
+     * @returns Array of contributions for the extension point
+     *
+     * @example
+     * ```typescript
+     * // Get only enabled settings contributions
+     * const enabledSettings = ContributionRegistry.getContributions('ddk.settings.view');
+     *
+     * // Get all settings contributions (including disabled)
+     * const allSettings = ContributionRegistry.getContributions('ddk.settings.view', true);
+     * ```
+     */
+    getContributions(extensionPoint: string, includeDisabled?: boolean): DynamicContribution[];
+}
+//# sourceMappingURL=contribution-enablement.d.ts.map

package/types/contribution-enablement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-enablement.d.ts","sourceRoot":"","sources":["../../../../../packages/sdk/kos-ui-plugin/src/types/contribution-enablement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D;;;;;;;OAOG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;CAC5D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,UAAU,EAAE,oBAAoB,CAAC;IAEjC;;;;OAIG;IACH,aAAa,EAAE,sBAAsB,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5E;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3C;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CACP,QAAQ,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,GACtD,MAAM,IAAI,CAAC;IAEd;;;;;;;;;;;;;;;;;;;OAmBG;IACH,yBAAyB,CACvB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,GACtD,MAAM,IAAI,CAAC;IAEd;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAAW,CACT,OAAO,EAAE,KAAK,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,GACD,IAAI,CAAC;IAER;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CACd,cAAc,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,OAAO,GACxB,mBAAmB,EAAE,CAAC;CAC1B"}

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-D1Yzvcw3.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"}