@kosdev-code/kos-ui-plugin 0.1.0-dev.5053

package/lib/utils/discovery/documentation-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-generator.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/discovery/documentation-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,yBAAyB,EAAE,MAAM,CAAC;QAClC,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAC9B,UAAU,EAAE,oBAAoB,GAAG,SAAS,EAC5C,OAAO,GAAE,oBAAyB,GACjC,sBAAsB;IAkDzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAkB7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAqBtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA0BtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IA6D5C;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,cAAc,EAAE,kBAAkB,GAAG,MAAM;IA8ExE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAsCjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAwC1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IA4G5C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IAuC7C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IA4CxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IA6C7C,OAAO,CAAC,MAAM,CAAC,2BAA2B;IA6B1C,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAIxC,OAAO,CAAC,MAAM,CAAC,cAAc;IAa7B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA+BnC,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAexC,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAevC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IAkB7C,OAAO,CAAC,MAAM,CAAC,iBAAiB;CA8BjC"}

package/lib/utils/discovery/plugin-discovery-service.d.ts

@@ -0,0 +1,109 @@
+import { PluginExtension, PluginExtensionsType } from '../../../types/plugins';
+
+export interface ExtensionPointInfo {
+    id: string;
+    displayName?: string;
+    description?: string;
+    source: "simplified" | "legacy";
+    metadata?: {
+        category?: string;
+        tags?: string[];
+        since?: string;
+        deprecated?: boolean;
+        owner?: string;
+    };
+    pluginCount: number;
+    plugins: PluginExtension[];
+}
+export interface PluginHealthStats {
+    totalExtensionPoints: number;
+    extensionPointsWithPlugins: number;
+    totalPlugins: number;
+    simplifiedExtensionPoints: number;
+    legacyExtensionPoints: number;
+    deprecatedExtensionPoints: number;
+}
+export interface PluginDiscoveryOptions {
+    includeLegacyExtensions?: boolean;
+    includeEmptyExtensionPoints?: boolean;
+}
+export interface PluginDescriptorValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    missingRequired: string[];
+    suggestions: string[];
+}
+export interface CompatibilityCheckResult {
+    isCompatible: boolean;
+    issues: string[];
+    missingExtensionPoints: string[];
+    incompatibleTypes: string[];
+    suggestions: string[];
+}
+export interface PluginDescriptor {
+    id: string;
+    init?: boolean;
+    contributes?: {
+        [key: string]: any[];
+    };
+}
+/**
+ * Plugin Discovery Service - Core business logic for plugin analysis
+ */
+export declare class PluginDiscoveryService {
+    /**
+     * Get all extension points with their plugin information
+     */
+    static getExtensionPoints(extensions: PluginExtensionsType | undefined, options?: PluginDiscoveryOptions): ExtensionPointInfo[];
+    /**
+     * Filter extension points based on search criteria
+     */
+    static filterExtensionPoints(extensionPoints: ExtensionPointInfo[], searchTerm: string): ExtensionPointInfo[];
+    /**
+     * Calculate health statistics for the plugin system
+     */
+    static calculateHealthStats(extensionPoints: ExtensionPointInfo[]): PluginHealthStats;
+    /**
+     * Analyze a specific plugin for health and capabilities
+     */
+    static analyzePlugin(plugin: PluginExtension): {
+        hasComponent: boolean;
+        hasRank: boolean;
+        healthStatus: "healthy" | "warning" | "error";
+        capabilities: string[];
+    };
+    /**
+     * Get extension point by ID with detailed information
+     */
+    static getExtensionPointById(extensionPoints: ExtensionPointInfo[], id: string): ExtensionPointInfo | undefined;
+    /**
+     * Validate if an extension point ID follows conventions
+     */
+    static validateExtensionPointId(id: string): {
+        isValid: boolean;
+        issues: string[];
+        suggestions: string[];
+    };
+    /**
+     * Validate a plugin descriptor structure and content
+     */
+    static validatePluginDescriptor(descriptor: PluginDescriptor): PluginDescriptorValidationResult;
+    /**
+     * Check compatibility between plugin contributions and available extension points
+     */
+    static checkPluginCompatibility(pluginDescriptor: PluginDescriptor, availableExtensionPoints: ExtensionPointInfo[]): CompatibilityCheckResult;
+    /**
+     * Map contribution keys to their expected extension point IDs
+     */
+    private static getExpectedExtensionPoints;
+    /**
+     * Get comprehensive plugin analysis including validation and compatibility
+     */
+    static analyzePluginDescriptor(descriptor: PluginDescriptor, availableExtensionPoints: ExtensionPointInfo[]): {
+        validation: PluginDescriptorValidationResult;
+        compatibility: CompatibilityCheckResult;
+        recommendations: string[];
+    };
+}
+//# sourceMappingURL=plugin-discovery-service.d.ts.map

package/lib/utils/discovery/plugin-discovery-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-discovery-service.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/discovery/plugin-discovery-service.ts"],"names":[],"mappings":"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"}

package/lib/utils/extension-points/define-extension-point.d.ts

@@ -0,0 +1,58 @@
+import { ExtensionPointConfig, ExtensionPointDefinition, ViewExtensionPointDefinition } from './extension-point-types';
+
+export type { ExtensionComponentProps, ExtensionPointConfig, ExtensionPointDefinition, SchemaFieldInfo, TransformContext, ValidationContext, ViewExtensionPointDefinition, } from './extension-point-types';
+export { getExtensionPointRegistry, getExtensionPointSchema, registry, } from './extension-point-registry';
+export { createViewAwareTransform } from './extension-point-transforms';
+export { extensionPointId } from './extension-point-types';
+export { getValidationResults } from './extension-point-validation';
+/**
+ * Define a new extension point with simplified API
+ *
+ * Returns an extension point definition that must be explicitly registered
+ * by calling the register() method. This prevents automatic registration
+ * and circular dependency issues.
+ *
+ * @example
+ * ```typescript
+ * // Simple extension point
+ * export const MyFeatureExtension = defineExtensionPoint({
+ *   id: 'ddk.myFeature',
+ *   contributionKey: 'myFeature',
+ *   displayName: 'My Feature',
+ *   description: 'Extension point for custom features'
+ * });
+ *
+ * // Register it explicitly in your app initialization
+ * MyFeatureExtension.register();
+ *
+ * // Extension point with view support
+ * export const MyViewExtension = defineExtensionPoint({
+ *   id: 'ddk.myView.config',
+ *   contributionKey: 'myView',
+ *   hasView: true,
+ *   relatedPoints: {
+ *     view: 'ddk.myView.view',
+ *     definition: 'ddk.myView'
+ *   },
+ *   transform: (data, context) => ({
+ *     ...data,
+ *     processedAt: Date.now()
+ *   })
+ * });
+ *
+ * // Register it explicitly in your app initialization
+ * MyViewExtension.register();
+ *
+ * // Use the pre-configured component (for view-based extensions)
+ * <MyViewExtension.Component
+ *   module="specific-module-id"
+ *   fallback={<div>Loading...</div>}
+ *   customProp="value"
+ * />
+ * ```
+ */
+export declare function defineExtensionPoint<TData = any, TProcessed = TData, TProps = any>(config: ExtensionPointConfig<TData, TProcessed, TProps> & {
+    hasView: true;
+}): ViewExtensionPointDefinition<TData, TProcessed, TProps>;
+export declare function defineExtensionPoint<TData = any, TProcessed = TData, TProps = any>(config: ExtensionPointConfig<TData, TProcessed, TProps>): ExtensionPointDefinition<TData, TProcessed, TProps>;
+//# sourceMappingURL=define-extension-point.d.ts.map

package/lib/utils/extension-points/define-extension-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-extension-point.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/define-extension-point.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,QAAQ,GACT,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAGH,wBAAgB,oBAAoB,CAClC,KAAK,GAAG,GAAG,EACX,UAAU,GAAG,KAAK,EAClB,MAAM,GAAG,GAAG,EAEZ,MAAM,EAAE,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAC1E,4BAA4B,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAG3D,wBAAgB,oBAAoB,CAClC,KAAK,GAAG,GAAG,EACX,UAAU,GAAG,KAAK,EAClB,MAAM,GAAG,GAAG,EAEZ,MAAM,EAAE,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,GACtD,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC"}

package/lib/utils/extension-points/example-extension-point.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Example: Creating a new extension point using the simplified API
+ *
+ * This file demonstrates how to create an extension point with the new
+ * defineExtensionPoint API. This is just for reference and testing.
+ */
+export declare const AnalyticsWidgetExtension: import('./extension-point-types').ExtensionPointDefinition<any, any, any>;
+export declare const CustomReportExtension: import('./extension-point-types').ViewExtensionPointDefinition<any, any, any>;
+interface NotificationConfig {
+    id: string;
+    type: "info" | "warning" | "error" | "success";
+    title: string;
+    message?: string;
+    duration?: number;
+    actions?: Array<{
+        label: string;
+        action: string;
+    }>;
+}
+interface ProcessedNotificationConfig extends NotificationConfig {
+    _meta: {
+        registeredAt: number;
+        source: string;
+    };
+}
+export declare const NotificationExtension: import('./extension-point-types').ExtensionPointDefinition<NotificationConfig, ProcessedNotificationConfig, any>;
+export {};
+/**
+ * How to use these extension points in a component:
+ *
+ * ```tsx
+ * import { DynamicComponent } from '@kosdev-code/kos-ui-plugin';
+ * import { AnalyticsWidgetExtension } from './example-extension-point';
+ *
+ * function MyDashboard() {
+ *   return (
+ *     <div>
+ *       <DynamicComponent
+ *         extension={AnalyticsWidgetExtension.id}
+ *         props={{ dashboardId: 'main' }}
+ *         fallback={<div>Loading analytics...</div>}
+ *       />
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * How a plugin would contribute to this extension point:
+ *
+ * kosdev-plugin.json:
+ * ```json
+ * {
+ *   "id": "my-analytics-plugin",
+ *   "contributes": {
+ *     "analyticsWidgets": [
+ *       {
+ *         "id": "sales-widget",
+ *         "title": "Sales Analytics",
+ *         "rank": 10,
+ *         "component": "./SalesWidget"
+ *       }
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+//# sourceMappingURL=example-extension-point.d.ts.map

package/lib/utils/extension-points/example-extension-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-extension-point.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/example-extension-point.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,eAAO,MAAM,wBAAwB,2EAWnC,CAAC;AAGH,eAAO,MAAM,qBAAqB,+EA8BhC,CAAC;AAGH,UAAU,kBAAkB;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,UAAU,2BAA4B,SAAQ,kBAAkB;IAC9D,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,eAAO,MAAM,qBAAqB,kHA4BhC,CAAC;;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG"}

package/lib/utils/extension-points/extension-point-registry.d.ts

@@ -0,0 +1,59 @@
+import { ExtensionPointConfig, ExtensionPointDefinition } from './extension-point-types';
+
+/**
+ * Registry for simplified extension points
+ * Keeps track of all extension points defined via this API
+ */
+export declare class SimplifiedExtensionPointRegistry {
+    private extensionPoints;
+    define<TData = any, TProcessed = TData, TProps = any>(config: ExtensionPointConfig<TData, TProcessed, TProps>): ExtensionPointDefinition<TData, TProcessed, TProps>;
+    private createReducer;
+    /**
+     * Get all registered extension points (for discovery/documentation)
+     */
+    getAllExtensionPoints(): ExtensionPointDefinition[];
+    /**
+     * Get all defined extension points (registered and unregistered)
+     */
+    getAllDefinedExtensionPoints(): ExtensionPointDefinition[];
+    /**
+     * Get a specific extension point definition
+     */
+    getExtensionPoint(id: string): ExtensionPointDefinition | undefined;
+    /**
+     * Check if an extension point is registered
+     */
+    hasExtensionPoint(id: string): boolean;
+    /**
+     * Get the Zod schema for an extension point
+     * Returns undefined if the extension point doesn't have a schema
+     */
+    getExtensionPointSchema(id: string): any | undefined;
+}
+export declare const registry: SimplifiedExtensionPointRegistry;
+/**
+ * Get the simplified extension point registry
+ * Useful for discovery tools and documentation generation
+ */
+export declare function getExtensionPointRegistry(): SimplifiedExtensionPointRegistry;
+/**
+ * Get the Zod schema for an extension point by ID
+ * Useful for inferring TypeScript types from JSON-defined extension points
+ *
+ * @example
+ * ```typescript
+ * import { getExtensionPointSchema } from '@kosdev-code/kos-ui-plugin';
+ * import { z } from 'zod';
+ *
+ * // Get the schema
+ * const schema = getExtensionPointSchema('app.navigation.link');
+ *
+ * // Infer the TypeScript type
+ * type NavLinkData = z.infer<typeof schema>;
+ *
+ * // Use it with hooks
+ * const { extensions, t } = useExtensionI18n<NavLinkData>(EXTENSION_ID_NAV_LINK);
+ * ```
+ */
+export declare function getExtensionPointSchema(id: string): any | undefined;
+//# sourceMappingURL=extension-point-registry.d.ts.map

package/lib/utils/extension-points/extension-point-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-point-registry.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/extension-point-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AAMjC;;;GAGG;AACH,qBAAa,gCAAgC;IAC3C,OAAO,CAAC,eAAe,CAAoD;IAE3E,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,UAAU,GAAG,KAAK,EAAE,MAAM,GAAG,GAAG,EAClD,MAAM,EAAE,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,GACtD,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC;IAiDtD,OAAO,CAAC,aAAa;IAgKrB;;OAEG;IACH,qBAAqB,IAAI,wBAAwB,EAAE;IAMnD;;OAEG;IACH,4BAA4B,IAAI,wBAAwB,EAAE;IAI1D;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS;IAInE;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAItC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;CAIrD;AAGD,eAAO,MAAM,QAAQ,kCAAyC,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,gCAAgC,CAE5E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAEnE"}

package/lib/utils/extension-points/extension-point-schema.d.ts

@@ -0,0 +1,9 @@
+import { SchemaFieldInfo } from './extension-point-types';
+import { z } from 'zod';
+
+/**
+ * Extract field information from a Zod schema for documentation purposes
+ * Returns field information that is safe to display in Plugin Explorer
+ */
+export declare function extractSchemaFieldInfo(schema: z.ZodSchema): SchemaFieldInfo[];
+//# sourceMappingURL=extension-point-schema.d.ts.map

package/lib/utils/extension-points/extension-point-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-point-schema.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/extension-point-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,GAAG,eAAe,EAAE,CA4C7E"}

package/lib/utils/extension-points/extension-point-schemas.d.ts

@@ -0,0 +1,92 @@
+import { ValidationContext } from './define-extension-point';
+import { z } from 'zod';
+
+/**
+ * Base schema for view-based DDK extension points
+ * Contains common fields that all DDK extension points share
+ */
+export declare const BaseViewExtensionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    namespace: z.ZodString;
+    experienceId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    experienceId: string;
+    id: string;
+    title: string;
+    namespace: string;
+}, {
+    experienceId: string;
+    id: string;
+    title: string;
+    namespace: string;
+}>;
+/**
+ * Base schema with optional ranking support
+ */
+export declare const RankableViewExtensionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    namespace: z.ZodString;
+    experienceId: z.ZodString;
+} & {
+    rank: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    experienceId: string;
+    id: string;
+    title: string;
+    namespace: string;
+    rank?: number | undefined;
+}, {
+    experienceId: string;
+    id: string;
+    title: string;
+    namespace: string;
+    rank?: number | undefined;
+}>;
+/**
+ * Performs standard Zod validation and adds errors to the validation context
+ *
+ * @param schema The Zod schema to validate against
+ * @param data The data to validate
+ * @param context The validation context to add errors to
+ * @returns true if validation passed, false if errors were added
+ */
+export declare function validateWithSchema<T>(schema: z.ZodSchema<T>, data: unknown, context: ValidationContext): boolean;
+/**
+ * Common validation for descriptor fields that should use dot notation
+ *
+ * @param descriptorField The name of the descriptor field (e.g., "setupDescriptor", "cuiDescriptor")
+ * @param descriptorValue The value of the descriptor field
+ * @param context The validation context to add warnings to
+ */
+export declare function validateDescriptorFormat(descriptorField: string, descriptorValue: string | undefined, context: ValidationContext): void;
+/**
+ * Common validation for rank values to ensure they're reasonable
+ *
+ * @param rank The rank value to validate
+ * @param context The validation context to add warnings to
+ * @param maxReasonableRank The maximum reasonable rank value (default 1000)
+ */
+export declare function validateRank(rank: number | undefined, context: ValidationContext, maxReasonableRank?: number): void;
+/**
+ * Helper to create extension-specific schemas by extending the base
+ * and adding custom fields
+ *
+ * @param additionalFields Additional fields specific to this extension point
+ * @param options Options for schema creation
+ * @returns Extended schema with base fields and additional fields
+ */
+export declare function createExtensionSchema<T extends z.ZodRawShape>(additionalFields: T, options?: {
+    rankable?: boolean;
+}): z.ZodObject<z.objectUtil.extendShape<(typeof BaseViewExtensionSchema)["shape"] | (typeof RankableViewExtensionSchema)["shape"], T>>;
+/**
+ * Type-safe validation for rankable extensions
+ * Only validates rank if the data has a rank property
+ */
+export declare function validateRankIfPresent(data: unknown, context: ValidationContext, maxReasonableRank?: number): void;
+/**
+ * Type helper for inferring types from extension schemas
+ */
+export type InferExtensionSchema<T extends z.ZodTypeAny> = z.infer<T>;
+//# sourceMappingURL=extension-point-schemas.d.ts.map

package/lib/utils/extension-points/extension-point-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-point-schemas.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/extension-point-schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAiBlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;EAOtC,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAST;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAMN;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,iBAAiB,EAC1B,iBAAiB,SAAO,GACvB,IAAI,CAMN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAC3D,gBAAgB,EAAE,CAAC,EACnB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,CAAC,CAAC,SAAS,CACZ,CAAC,CAAC,UAAU,CAAC,WAAW,CACpB,CAAC,OAAO,uBAAuB,CAAC,CAAC,OAAO,CAAC,GACzC,CAAC,OAAO,2BAA2B,CAAC,CAAC,OAAO,CAAC,EAC/C,CAAC,CACF,CACF,CAKA;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,iBAAiB,EAC1B,iBAAiB,SAAO,GACvB,IAAI,CAKN;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/lib/utils/extension-points/extension-point-transforms.d.ts

@@ -0,0 +1,21 @@
+import { TransformContext } from './extension-point-types';
+
+/**
+ * Generic transform helper for extension points that use the experience/view pattern
+ * Handles mapping experience IDs to experience data and flattening component properties
+ */
+export declare function createViewAwareTransform<TData extends Record<string, any>>(options?: {
+    /**
+     * Property name that contains the experience ID (default: "experienceId")
+     */
+    experienceIdProperty?: keyof TData;
+    /**
+     * Whether to flatten component properties to root level for useDynamicComponent compatibility (default: true)
+     */
+    flattenComponentProperties?: boolean;
+    /**
+     * Additional transform logic to apply after view mapping
+     */
+    customTransform?: (data: TData, view: any, context: TransformContext) => any;
+}): (data: TData, context: TransformContext) => any;
+//# sourceMappingURL=extension-point-transforms.d.ts.map

package/lib/utils/extension-points/extension-point-transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-point-transforms.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/extension-point-transforms.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxE,OAAO,GAAE;IACP;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,KAAK,CAAC;IACnC;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;OAEG;IACH,eAAe,CAAC,EAAE,CAChB,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,gBAAgB,KACtB,GAAG,CAAC;CACL,UAQQ,KAAK,WAAW,gBAAgB,SA4B/C"}

package/lib/utils/extension-points/extension-point-types.d.ts

@@ -0,0 +1,162 @@
+import { BasePluginExtension, PluginExtensionsType, ProcessedContributions } from '../../../types/plugins';
+import { z } from 'zod';
+
+/**
+ * Validation context for collecting validation issues
+ */
+export interface ValidationContext {
+    addError(message: string): void;
+    addWarning(message: string): void;
+    addInfo(message: string): void;
+    hasErrors(): boolean;
+    hasIssues(): boolean;
+    getIssues(): {
+        type: "error" | "warning" | "info";
+        message: string;
+    }[];
+}
+/**
+ * Context provided to transform functions
+ */
+export interface TransformContext {
+    remote: string;
+    sectionId: string;
+    experiences?: Record<string, any>;
+    contributions: ProcessedContributions;
+}
+/**
+ * Schema field information for documentation
+ */
+export interface SchemaFieldInfo {
+    name: string;
+    description?: string;
+    type?: string;
+    required?: boolean;
+}
+/**
+ * Configuration for defining a new extension point
+ */
+export interface ExtensionPointConfig<TData = any, TProcessed = TData, _TProps = any> {
+    /**
+     * Unique identifier for this extension point
+     * Convention: "ddk.{feature}" or "ddk.{feature}.{sub-feature}"
+     */
+    id: string;
+    /**
+     * Optional display name for documentation/discovery
+     */
+    displayName?: string;
+    /**
+     * Optional description for documentation/discovery
+     */
+    description?: string;
+    /**
+     * The contribution key in the plugin descriptor
+     * e.g., "myFeature" maps to contributes.myFeature in kosdev-plugin.json
+     */
+    contributionKey: string;
+    /**
+     * Optional related extension points
+     * For example, a main extension might have .view and .definition variants
+     */
+    relatedPoints?: {
+        view?: string;
+        definition?: string;
+        [key: string]: string | undefined;
+    };
+    /**
+     * Transform function to process raw contribution data
+     * Allows custom processing logic while maintaining type safety
+     */
+    transform?: (data: TData, context: TransformContext) => TProcessed;
+    /**
+     * Optional validation function
+     * Use context.addError/addWarning/addInfo to collect validation issues
+     * Return "skip" to skip processing this contribution
+     */
+    validate?: (data: TData, context: ValidationContext) => "skip" | void;
+    /**
+     * Whether this extension point uses view/experience pattern
+     * Default: false
+     */
+    hasView?: boolean;
+    /**
+     * Whether contributions should be ranked
+     * Default: false
+     */
+    isRankable?: boolean;
+    /**
+     * Optional Zod schema for runtime validation and documentation
+     * Provides both type safety and field introspection for Plugin Explorer
+     */
+    schema?: z.ZodSchema<TData>;
+    /**
+     * Metadata for discovery/documentation
+     */
+    metadata?: {
+        category?: string;
+        tags?: string[];
+        since?: string;
+        deprecated?: boolean;
+        replacedBy?: string;
+        owner?: string;
+        /**
+         * The actual export name of this extension point in the code
+         * Used for documentation generation to show correct import statements
+         */
+        exportName?: string;
+    };
+}
+/**
+ * Props for extension point components
+ */
+export interface ExtensionComponentProps {
+    /** Specific module to load (optional) */
+    module?: string;
+    /** Fallback component when extension not found */
+    fallback?: React.ReactNode;
+}
+/**
+ * Result of defining an extension point
+ */
+export interface ExtensionPointDefinition<TData = any, TProcessed = TData, TProps = any> {
+    /**
+     * The extension point configuration
+     */
+    config: ExtensionPointConfig<TData, TProcessed, TProps>;
+    /**
+     * Extension point ID for use in components
+     */
+    id: string;
+    /**
+     * Helper to get typed extensions (for future use with hooks)
+     */
+    getExtensions?: (extensions: PluginExtensionsType) => Record<string, BasePluginExtension & {
+        data: TProcessed;
+    }>;
+    /**
+     * Registration status
+     */
+    isRegistered: boolean;
+    /**
+     * Method to register this extension point
+     */
+    register: () => void;
+    /**
+     * Get schema field information for documentation purposes
+     * Returns field info that can be safely displayed by Plugin Explorer
+     */
+    getSchemaFieldInfo?: () => SchemaFieldInfo[];
+}
+/**
+ * Extension point with hasView: true, guarantees Component property
+ */
+export interface ViewExtensionPointDefinition<TData = any, TProcessed = TData, TProps = any> extends ExtensionPointDefinition<TData, TProcessed, TProps> {
+    Component: React.ComponentType<ExtensionComponentProps & TProps>;
+}
+/**
+ * Type-safe extension point ID helper
+ * Ensures consistent naming and helps with refactoring
+ */
+export declare function extensionPointId(namespace: string, feature: string, ...subFeatures: string[]): string;
+//# sourceMappingURL=extension-point-types.d.ts.map

package/lib/utils/extension-points/extension-point-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-point-types.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/extension-points/extension-point-types.ts"],"names":[],"mappings":"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"}