@framework-m/plugin-sdk 0.2.3

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/core/ServiceContainer.ts","../src/core/PluginRegistry.ts","../src/context/PluginRegistryContext.tsx","../src/hooks/usePluginMenu.ts","../src/hooks/usePlugin.ts","../src/hooks/useService.ts","../src/hooks/useWidgets.ts"],"sourcesContent":["/**\n * ServiceContainer — Simple dependency injection for plugin services.\n *\n * Services are registered as factories and lazily instantiated as singletons\n * on first `get()` call. Supports both sync and async factories.\n *\n * @example\n * ```ts\n * const container = new ServiceContainer();\n * container.register(\"warehouseService\", () => new WarehouseService());\n * const svc = await container.get<WarehouseService>(\"warehouseService\");\n * ```\n */\n\nimport type { ServiceFactory } from \"../types/plugin\";\n\nexport class ServiceContainer {\n  private readonly factories = new Map<string, ServiceFactory>();\n  private readonly instances = new Map<string, unknown>();\n\n  /**\n   * Register a service factory.\n   *\n   * @param name — unique service name\n   * @param factory — factory function (sync or async)\n   */\n  register<T>(name: string, factory: ServiceFactory<T>): void {\n    this.factories.set(name, factory as ServiceFactory);\n    // Clear cached instance if re-registering\n    this.instances.delete(name);\n  }\n\n  /**\n   * Get a service by name. Lazily instantiates on first call (singleton).\n   *\n   * @throws Error if service is not registered\n   */\n  async get<T = unknown>(name: string): Promise<T> {\n    // Return cached singleton\n    if (this.instances.has(name)) {\n      return this.instances.get(name) as T;\n    }\n\n    const factory = this.factories.get(name);\n    if (!factory) {\n      throw new Error(`Service \"${name}\" is not registered`);\n    }\n\n    // Create instance (may be async)\n    const instance = await Promise.resolve(factory());\n    this.instances.set(name, instance);\n    return instance as T;\n  }\n\n  /**\n   * Check if a service is registered.\n   */\n  has(name: string): boolean {\n    return this.factories.has(name);\n  }\n\n  /**\n   * Get all registered service names.\n   */\n  getAll(): string[] {\n    return Array.from(this.factories.keys());\n  }\n\n  /**\n   * Clear all registered factories and cached instances.\n   */\n  clear(): void {\n    this.factories.clear();\n    this.instances.clear();\n  }\n}\n","/**\n * PluginRegistry — Central registry for Framework M plugins.\n *\n * Handles plugin registration, menu merging (by module/category),\n * route aggregation, and service container population.\n *\n * Per ADR-0008: this is the core runtime that the shell app bootstraps\n * and provides to all components via React Context.\n */\n\nimport type {\n  FrameworkMPlugin,\n  MenuItem,\n  RouteDefinition,\n  CompatibilityReport,\n  PluginRegistryDiagnostic,\n  PluginRegistryDiagnosticSeverity,\n  PermissionChecker,\n  Widget,\n} from \"../types/plugin\";\nimport { ServiceContainer } from \"./ServiceContainer\";\n\ntype PluginRegistryEvent = \"plugin:registered\" | \"plugin:error\";\n\ntype PluginRegistryEventPayloadMap = {\n  \"plugin:registered\": { plugin: FrameworkMPlugin };\n  \"plugin:error\": { plugin: FrameworkMPlugin; error: unknown };\n};\n\ntype PluginRegistryEventHandler<E extends PluginRegistryEvent> = (\n  payload: PluginRegistryEventPayloadMap[E],\n) => void;\n\n/**\n * SDK version — used for compatibility checking.\n */\nexport const SDK_VERSION = \"0.1.0\";\n\n/**\n * Default icon mapping for well-known module names.\n */\nconst MODULE_ICONS: Record<string, string> = {\n  Sales: \"shopping-cart\",\n  Inventory: \"package\",\n  HR: \"users\",\n  Finance: \"dollar-sign\",\n  Core: \"settings\",\n  Other: \"folder\",\n};\n\nfunction isDebugEnabled(): boolean {\n  const globalFlag = (globalThis as { __FRAMEWORK_M_PLUGIN_DEBUG__?: unknown })\n    .__FRAMEWORK_M_PLUGIN_DEBUG__;\n  if (typeof globalFlag === \"boolean\") {\n    return globalFlag;\n  }\n  if (typeof globalFlag === \"string\") {\n    return [\"1\", \"true\", \"yes\", \"on\"].includes(globalFlag.toLowerCase());\n  }\n\n  const processRef = (\n    globalThis as { process?: { env?: Record<string, string | undefined> } }\n  ).process;\n  if (processRef?.env) {\n    const envFlag = processRef.env.FRAMEWORK_M_PLUGIN_DEBUG;\n    if (typeof envFlag === \"string\") {\n      return [\"1\", \"true\", \"yes\", \"on\"].includes(envFlag.toLowerCase());\n    }\n  }\n\n  return false;\n}\n\nconst registryLogger = {\n  debug(message: string, ...args: unknown[]) {\n    if (isDebugEnabled()) {\n      console.debug(`[PluginRegistry] ${message}`, ...args);\n    }\n  },\n};\n\nexport class PluginRegistry {\n  private readonly plugins = new Map<string, FrameworkMPlugin>();\n  private menuCache: MenuItem[] | null = null;\n  private readonly serviceContainer = new ServiceContainer();\n  private readonly routeOwners = new Map<string, string>();\n  private readonly menuNameOwners = new Map<string, string>();\n  private readonly menuRouteOwners = new Map<string, string>();\n  private readonly serviceOwners = new Map<string, string>();\n  private diagnostics: PluginRegistryDiagnostic[] = [];\n  private permissionChecker: PermissionChecker | null = null;\n  private readonly eventListeners: {\n    [E in PluginRegistryEvent]: Set<PluginRegistryEventHandler<E>>;\n  } = {\n    \"plugin:registered\": new Set(),\n    \"plugin:error\": new Set(),\n  };\n\n  /**\n   * Register a plugin with the registry.\n   *\n   * validates that the plugin has name and version, checks collisions,\n   * stores it, registers any services into the ServiceContainer,\n   * and invalidates the menu cache.\n   *\n   * @throws Error if plugin has no name or version\n   */\n  async register(plugin: FrameworkMPlugin): Promise<void> {\n    if (!plugin.name || !plugin.version) {\n      throw new Error(\"Plugin must have name and version\");\n    }\n\n    const diagnostics = this.validateRegistration(plugin);\n    const errors = diagnostics.filter(d => d.severity === \"error\");\n\n    if (errors.length > 0) {\n      const error = new Error(\n        `Plugin \"${plugin.name}\" registration failed: ${errors.map(d => d.message).join(\"; \")}`,\n      );\n      this.emit(\"plugin:error\", { plugin, error });\n      throw error;\n    }\n\n    const previous = this.plugins.get(plugin.name);\n    this.plugins.set(plugin.name, plugin);\n    this.rebuildIndexesAndServices();\n\n    // Invalidate menu cache\n    this.menuCache = null;\n\n    try {\n      if (plugin.onInit) {\n        await Promise.resolve(plugin.onInit());\n      }\n    } catch (error) {\n      if (previous) {\n        this.plugins.set(plugin.name, previous);\n      } else {\n        this.plugins.delete(plugin.name);\n      }\n      this.rebuildIndexesAndServices();\n      this.menuCache = null;\n      this.emit(\"plugin:error\", { plugin, error });\n      throw error;\n    }\n\n    if (previous?.onDestroy && previous !== plugin) {\n      await Promise.resolve(previous.onDestroy());\n    }\n\n    this.emit(\"plugin:registered\", { plugin });\n\n    const warnings = diagnostics.filter(d => d.severity === \"warning\");\n    if (warnings.length > 0) {\n      registryLogger.debug(\n        `Registered plugin \"${plugin.name}\" with warnings`,\n        warnings,\n      );\n    }\n  }\n\n  /**\n   * Get merged menu tree from all plugins.\n   *\n   * Collects all MenuItem entries, groups them by `module` (default: \"Other\"),\n   * optionally sub-groups by `category`, and sorts by `order`.\n   * Result is cached until a new plugin is registered.\n   */\n  getMenu(): MenuItem[] {\n    if (this.menuCache) return this.menuCache;\n\n    const allMenus: MenuItem[] = [];\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.menu) {\n        allMenus.push(...plugin.menu);\n      }\n    }\n\n    if (allMenus.length === 0) {\n      this.menuCache = [];\n      return this.menuCache;\n    }\n\n    this.menuCache = this.mergeMenus(allMenus);\n    return this.menuCache;\n  }\n\n  /**\n   * Get aggregated routes from all plugins.\n   */\n  getRoutes(): RouteDefinition[] {\n    const routes: RouteDefinition[] = [];\n    for (const plugin of this.plugins.values()) {\n      if (plugin.routes) {\n        routes.push(...plugin.routes);\n      }\n    }\n    return routes;\n  }\n\n  /**\n   * Get a specific plugin by name.\n   */\n  getPlugin(name: string): FrameworkMPlugin | undefined {\n    return this.plugins.get(name);\n  }\n\n  /**\n   * Get all registered plugins.\n   */\n  getAllPlugins(): FrameworkMPlugin[] {\n    return Array.from(this.plugins.values());\n  }\n\n  /**\n   * Get the service container for DI.\n   */\n  getServiceContainer(): ServiceContainer {\n    return this.serviceContainer;\n  }\n\n  /**\n   * Unregister a plugin by name and run cleanup lifecycle if provided.\n   */\n  async unregister(pluginName: string): Promise<boolean> {\n    const plugin = this.plugins.get(pluginName);\n    if (!plugin) {\n      return false;\n    }\n\n    this.plugins.delete(pluginName);\n    this.rebuildIndexesAndServices();\n    this.menuCache = null;\n\n    if (plugin.onDestroy) {\n      await Promise.resolve(plugin.onDestroy());\n    }\n\n    return true;\n  }\n\n  /**\n   * Resolve a service instance from the registry-level DI container.\n   */\n  async getService<T = unknown>(name: string): Promise<T> {\n    return this.serviceContainer.get<T>(name);\n  }\n\n  /**\n   * Aggregate all widgets contributed by registered plugins.\n   */\n  getWidgets(): Widget[] {\n    const widgets: Widget[] = [];\n    for (const plugin of this.plugins.values()) {\n      if (plugin.widgets) {\n        widgets.push(...plugin.widgets);\n      }\n    }\n    return widgets;\n  }\n\n  /**\n   * Configure a permission checker used by consumer hooks.\n   */\n  setPermissionChecker(checker: PermissionChecker | null): void {\n    this.permissionChecker = checker;\n  }\n\n  /**\n   * Get the configured permission checker.\n   */\n  getPermissionChecker(): PermissionChecker | null {\n    return this.permissionChecker;\n  }\n\n  /**\n   * Subscribe to plugin lifecycle events.\n   */\n  on<E extends PluginRegistryEvent>(\n    event: E,\n    handler: PluginRegistryEventHandler<E>,\n  ): () => void {\n    this.eventListeners[event].add(\n      handler as unknown as PluginRegistryEventHandler<PluginRegistryEvent>,\n    );\n    return () => {\n      this.eventListeners[event].delete(\n        handler as unknown as PluginRegistryEventHandler<PluginRegistryEvent>,\n      );\n    };\n  }\n\n  /**\n   * Get emitted diagnostics.\n   */\n  getDiagnostics(\n    severity?: PluginRegistryDiagnosticSeverity,\n  ): PluginRegistryDiagnostic[] {\n    if (!severity) {\n      return [...this.diagnostics];\n    }\n    return this.diagnostics.filter(d => d.severity === severity);\n  }\n\n  /**\n   * Clear diagnostics.\n   */\n  clearDiagnostics(): void {\n    this.diagnostics = [];\n  }\n\n  // -------------------------------------------------------------------------\n  // Version Compatibility\n  // -------------------------------------------------------------------------\n\n  /**\n   * Check compatibility of all registered plugins.\n   *\n   * Returns a report of all plugins with their compatibility status:\n   * - SDK version compatibility\n   * - Peer plugin dependency satisfaction\n   */\n  checkCompatibility(): CompatibilityReport[] {\n    const reports: CompatibilityReport[] = [];\n\n    for (const plugin of this.plugins.values()) {\n      const report: CompatibilityReport = {\n        name: plugin.name,\n        version: plugin.version,\n        sdkCompatible: true,\n        missingPeerPlugins: [],\n      };\n\n      // Check SDK version\n      if (plugin.minSdkVersion) {\n        report.sdkCompatible = this.checkSemverCompat(\n          SDK_VERSION,\n          plugin.minSdkVersion,\n        );\n      }\n\n      // Check peer plugins\n      if (plugin.peerPlugins) {\n        for (const peerName of plugin.peerPlugins) {\n          if (!this.plugins.has(peerName)) {\n            report.missingPeerPlugins.push(peerName);\n          }\n        }\n      }\n\n      reports.push(report);\n    }\n\n    return reports;\n  }\n\n  // -------------------------------------------------------------------------\n  // Private helpers\n  // -------------------------------------------------------------------------\n\n  /**\n   * Simple semver compatibility check.\n   * Checks if `current` satisfies `>=required`.\n   */\n  private checkSemverCompat(current: string, required: string): boolean {\n    const clean = required.replace(/^>=?/, \"\");\n    const [cMajor, cMinor = 0, cPatch = 0] = current.split(\".\").map(Number);\n    const [rMajor, rMinor = 0, rPatch = 0] = clean.split(\".\").map(Number);\n\n    if (cMajor !== rMajor) return cMajor > rMajor;\n    if (cMinor !== rMinor) return cMinor > rMinor;\n    return cPatch >= rPatch;\n  }\n\n  private validateRegistration(\n    plugin: FrameworkMPlugin,\n  ): PluginRegistryDiagnostic[] {\n    return [\n      ...this.validateSdkCompatibility(plugin),\n      ...this.validateDuplicatePlugin(plugin),\n      ...this.validateRouteCollisions(plugin),\n      ...this.validateMenuCollisions(plugin),\n      ...this.validateServiceCollisions(plugin),\n    ];\n  }\n\n  private validateSdkCompatibility(\n    plugin: FrameworkMPlugin,\n  ): PluginRegistryDiagnostic[] {\n    const diagnostics: PluginRegistryDiagnostic[] = [];\n\n    if (plugin.minSdkVersion) {\n      const compatible = this.checkSemverCompat(\n        SDK_VERSION,\n        plugin.minSdkVersion,\n      );\n      if (!compatible) {\n        diagnostics.push(\n          this.addDiagnostic({\n            code: \"SDK_INCOMPATIBLE\",\n            severity: \"warning\",\n            message:\n              `Plugin ${plugin.name} requires SDK >=${plugin.minSdkVersion}, ` +\n              `current SDK is ${SDK_VERSION}. Plugin may not work correctly.`,\n            pluginName: plugin.name,\n            key: plugin.minSdkVersion,\n          }),\n        );\n      }\n    }\n\n    return diagnostics;\n  }\n\n  private validateDuplicatePlugin(\n    plugin: FrameworkMPlugin,\n  ): PluginRegistryDiagnostic[] {\n    const diagnostics: PluginRegistryDiagnostic[] = [];\n\n    if (this.plugins.has(plugin.name)) {\n      diagnostics.push(\n        this.addDiagnostic({\n          code: \"PLUGIN_DUPLICATE\",\n          severity: \"warning\",\n          message: `Plugin ${plugin.name} is already registered and will be replaced`,\n          pluginName: plugin.name,\n          conflictingPluginName: plugin.name,\n          key: plugin.name,\n        }),\n      );\n    }\n\n    return diagnostics;\n  }\n\n  private validateRouteCollisions(\n    plugin: FrameworkMPlugin,\n  ): PluginRegistryDiagnostic[] {\n    const diagnostics: PluginRegistryDiagnostic[] = [];\n\n    const seenRoutePaths = new Set<string>();\n    for (const route of plugin.routes ?? []) {\n      if (seenRoutePaths.has(route.path)) {\n        diagnostics.push(\n          this.addDiagnostic({\n            code: \"ROUTE_COLLISION\",\n            severity: \"error\",\n            message: `Duplicate route path \"${route.path}\" inside plugin ${plugin.name}`,\n            pluginName: plugin.name,\n            conflictingPluginName: plugin.name,\n            key: route.path,\n          }),\n        );\n        continue;\n      }\n\n      seenRoutePaths.add(route.path);\n      const existingRouteOwner = this.routeOwners.get(route.path);\n      if (existingRouteOwner && existingRouteOwner !== plugin.name) {\n        diagnostics.push(\n          this.addDiagnostic({\n            code: \"ROUTE_COLLISION\",\n            severity: \"error\",\n            message:\n              `Route path \"${route.path}\" from plugin ${plugin.name} ` +\n              `conflicts with plugin ${existingRouteOwner}`,\n            pluginName: plugin.name,\n            conflictingPluginName: existingRouteOwner,\n            key: route.path,\n          }),\n        );\n      }\n    }\n\n    return diagnostics;\n  }\n\n  private validateMenuCollisions(\n    plugin: FrameworkMPlugin,\n  ): PluginRegistryDiagnostic[] {\n    const diagnostics: PluginRegistryDiagnostic[] = [];\n\n    const seenMenuNames = new Set<string>();\n    const seenMenuRoutes = new Set<string>();\n    for (const item of plugin.menu ?? []) {\n      if (seenMenuNames.has(item.name)) {\n        diagnostics.push(\n          this.addDiagnostic({\n            code: \"MENU_NAME_COLLISION\",\n            severity: \"error\",\n            message: `Duplicate menu name \"${item.name}\" inside plugin ${plugin.name}`,\n            pluginName: plugin.name,\n            conflictingPluginName: plugin.name,\n            key: item.name,\n          }),\n        );\n      } else {\n        seenMenuNames.add(item.name);\n        const existingNameOwner = this.menuNameOwners.get(item.name);\n        if (existingNameOwner && existingNameOwner !== plugin.name) {\n          diagnostics.push(\n            this.addDiagnostic({\n              code: \"MENU_NAME_COLLISION\",\n              severity: \"error\",\n              message:\n                `Menu name \"${item.name}\" from plugin ${plugin.name} ` +\n                `conflicts with plugin ${existingNameOwner}`,\n              pluginName: plugin.name,\n              conflictingPluginName: existingNameOwner,\n              key: item.name,\n            }),\n          );\n        }\n      }\n\n      if (seenMenuRoutes.has(item.route)) {\n        diagnostics.push(\n          this.addDiagnostic({\n            code: \"MENU_ROUTE_COLLISION\",\n            severity: \"error\",\n            message: `Duplicate menu route \"${item.route}\" inside plugin ${plugin.name}`,\n            pluginName: plugin.name,\n            conflictingPluginName: plugin.name,\n            key: item.route,\n          }),\n        );\n      } else {\n        seenMenuRoutes.add(item.route);\n        const existingRouteOwner = this.menuRouteOwners.get(item.route);\n        if (existingRouteOwner && existingRouteOwner !== plugin.name) {\n          diagnostics.push(\n            this.addDiagnostic({\n              code: \"MENU_ROUTE_COLLISION\",\n              severity: \"error\",\n              message:\n                `Menu route \"${item.route}\" from plugin ${plugin.name} ` +\n                `conflicts with plugin ${existingRouteOwner}`,\n              pluginName: plugin.name,\n              conflictingPluginName: existingRouteOwner,\n              key: item.route,\n            }),\n          );\n        }\n      }\n    }\n\n    return diagnostics;\n  }\n\n  private validateServiceCollisions(\n    plugin: FrameworkMPlugin,\n  ): PluginRegistryDiagnostic[] {\n    const diagnostics: PluginRegistryDiagnostic[] = [];\n\n    const seenServiceNames = new Set<string>();\n    for (const serviceName of Object.keys(plugin.services ?? {})) {\n      if (seenServiceNames.has(serviceName)) {\n        diagnostics.push(\n          this.addDiagnostic({\n            code: \"SERVICE_COLLISION\",\n            severity: \"error\",\n            message: `Duplicate service \"${serviceName}\" inside plugin ${plugin.name}`,\n            pluginName: plugin.name,\n            conflictingPluginName: plugin.name,\n            key: serviceName,\n          }),\n        );\n        continue;\n      }\n\n      seenServiceNames.add(serviceName);\n      const existingServiceOwner = this.serviceOwners.get(serviceName);\n      if (existingServiceOwner && existingServiceOwner !== plugin.name) {\n        diagnostics.push(\n          this.addDiagnostic({\n            code: \"SERVICE_COLLISION\",\n            severity: \"error\",\n            message:\n              `Service \"${serviceName}\" from plugin ${plugin.name} ` +\n              `conflicts with plugin ${existingServiceOwner}`,\n            pluginName: plugin.name,\n            conflictingPluginName: existingServiceOwner,\n            key: serviceName,\n          }),\n        );\n      }\n    }\n\n    return diagnostics;\n  }\n\n  private addDiagnostic(\n    diagnostic: Omit<PluginRegistryDiagnostic, \"timestamp\">,\n  ): PluginRegistryDiagnostic {\n    const fullDiagnostic: PluginRegistryDiagnostic = {\n      ...diagnostic,\n      timestamp: new Date().toISOString(),\n    };\n    this.diagnostics.push(fullDiagnostic);\n    return fullDiagnostic;\n  }\n\n  /**\n   * Merge flat menu items into a grouped tree:\n   *   Module → (optional) Category → Items\n   *\n   * Items without a `module` are placed under \"Other\".\n   */\n  private mergeMenus(items: MenuItem[]): MenuItem[] {\n    const moduleMap = new Map<string, MenuItem>();\n\n    for (const item of items) {\n      const moduleName = item.module || \"Other\";\n\n      if (!moduleMap.has(moduleName)) {\n        moduleMap.set(moduleName, {\n          name: moduleName.toLowerCase(),\n          label: moduleName,\n          route: `/${moduleName.toLowerCase()}`,\n          icon: this.getModuleIcon(moduleName),\n          order: item.order,\n          children: [],\n        });\n      }\n\n      const moduleGroup = moduleMap.get(moduleName)!;\n\n      // Track lowest order value for module-level sorting\n      if (item.order !== undefined) {\n        if (moduleGroup.order === undefined || item.order < moduleGroup.order) {\n          moduleGroup.order = item.order;\n        }\n      }\n\n      if (item.category) {\n        // Find or create category sub-group\n        let categoryGroup = moduleGroup.children?.find(\n          c => c.label === item.category,\n        );\n\n        if (!categoryGroup) {\n          categoryGroup = {\n            name: item.category.toLowerCase(),\n            label: item.category,\n            route: `/${moduleName.toLowerCase()}/${item.category.toLowerCase()}`,\n            children: [],\n          };\n          moduleGroup.children!.push(categoryGroup);\n        }\n\n        categoryGroup.children!.push(item);\n      } else {\n        // No category — add directly to module\n        moduleGroup.children!.push(item);\n      }\n    }\n\n    // Sort module groups by order (lower first, undefined last)\n    return Array.from(moduleMap.values()).sort(\n      (a, b) => (a.order ?? 999) - (b.order ?? 999),\n    );\n  }\n\n  private getModuleIcon(moduleName: string): string {\n    return MODULE_ICONS[moduleName] || MODULE_ICONS.Other;\n  }\n\n  private rebuildIndexesAndServices(): void {\n    this.routeOwners.clear();\n    this.menuNameOwners.clear();\n    this.menuRouteOwners.clear();\n    this.serviceOwners.clear();\n    this.serviceContainer.clear();\n\n    for (const plugin of this.plugins.values()) {\n      this.registerPluginServices(plugin);\n      this.registerPluginRoutes(plugin);\n      this.registerPluginMenuItems(plugin);\n    }\n  }\n\n  private registerPluginServices(plugin: FrameworkMPlugin): void {\n    for (const [name, factory] of Object.entries(plugin.services ?? {})) {\n      this.serviceContainer.register(name, factory);\n      this.serviceOwners.set(name, plugin.name);\n    }\n  }\n\n  private registerPluginRoutes(plugin: FrameworkMPlugin): void {\n    for (const route of plugin.routes ?? []) {\n      this.routeOwners.set(route.path, plugin.name);\n    }\n  }\n\n  private registerPluginMenuItems(plugin: FrameworkMPlugin): void {\n    for (const item of plugin.menu ?? []) {\n      this.menuNameOwners.set(item.name, plugin.name);\n      this.menuRouteOwners.set(item.route, plugin.name);\n    }\n  }\n\n  private emit<E extends PluginRegistryEvent>(\n    event: E,\n    payload: PluginRegistryEventPayloadMap[E],\n  ): void {\n    for (const handler of this.eventListeners[event]) {\n      handler(payload as never);\n    }\n  }\n}\n","/**\n * PluginRegistryContext — React context for the PluginRegistry.\n *\n * Provides the PluginRegistry to all child components via React Context.\n * Must wrap any component that uses usePluginMenu(), usePlugin(), or useService().\n */\n\nimport { createContext, useEffect, useState, type ReactNode } from \"react\";\nimport { PluginRegistry } from \"../core/PluginRegistry\";\n\nexport const PluginRegistryContext = createContext<PluginRegistry | null>(null);\n\nexport interface PluginRegistryProviderProps {\n  readonly children: ReactNode;\n  /** Optional pre-configured PluginRegistry instance */\n  readonly registry?: PluginRegistry;\n}\n\n/**\n * Provider component that makes the PluginRegistry available to child components.\n *\n * @example\n * ```tsx\n * const registry = new PluginRegistry();\n * await registry.register(wmsPlugin);\n *\n * <PluginRegistryProvider registry={registry}>\n *   <App />\n * </PluginRegistryProvider>\n * ```\n */\nexport function PluginRegistryProvider({\n  children,\n  registry,\n}: PluginRegistryProviderProps) {\n  const [registryInstance] = useState<PluginRegistry>(\n    () => registry ?? new PluginRegistry(),\n  );\n  const [isReady, setIsReady] = useState(false);\n\n  useEffect(() => {\n    setIsReady(true);\n  }, []);\n\n  if (!isReady) {\n    return null;\n  }\n\n  return (\n    <PluginRegistryContext.Provider value={registryInstance}>\n      {children}\n    </PluginRegistryContext.Provider>\n  );\n}\n","/**\n * usePluginMenu — React hook for accessing the merged menu tree.\n *\n * Returns the merged MenuItem[] from all registered plugins.\n * Must be used within a PluginRegistryProvider.\n *\n * @example\n * ```tsx\n * function Sidebar() {\n *   const menu = usePluginMenu();\n *   return <nav>{menu.map(m => <ModuleGroup key={m.name} {...m} />)}</nav>;\n * }\n * ```\n */\n\nimport { useContext, useEffect, useState } from \"react\";\nimport { PluginRegistryContext } from \"../context/PluginRegistryContext\";\nimport type { MenuItem } from \"../types/plugin\";\n\nasync function filterMenuByPermissions(\n  items: MenuItem[],\n  checker: (permissions: string[]) => boolean | Promise<boolean>,\n): Promise<MenuItem[]> {\n  const filtered: MenuItem[] = [];\n\n  for (const item of items) {\n    if (item.hidden) {\n      continue;\n    }\n\n    if (item.permissions && item.permissions.length > 0) {\n      const allowed = await Promise.resolve(checker(item.permissions));\n      if (!allowed) {\n        continue;\n      }\n    }\n\n    const children = item.children\n      ? await filterMenuByPermissions(item.children, checker)\n      : undefined;\n\n    if (item.children && (children?.length ?? 0) === 0) {\n      continue;\n    }\n\n    filtered.push({ ...item, children });\n  }\n\n  return filtered;\n}\n\nexport function usePluginMenu(): MenuItem[] {\n  const registry = useContext(PluginRegistryContext);\n  const [menu, setMenu] = useState<MenuItem[]>([]);\n\n  if (!registry) {\n    throw new Error(\"usePluginMenu must be used within PluginRegistryProvider\");\n  }\n\n  useEffect(() => {\n    let cancelled = false;\n\n    const load = async () => {\n      const source = registry.getMenu();\n      const checker = registry.getPermissionChecker();\n\n      if (!checker) {\n        if (!cancelled) {\n          setMenu(source.filter(item => !item.hidden));\n        }\n        return;\n      }\n\n      const filtered = await filterMenuByPermissions(source, checker);\n      if (!cancelled) {\n        setMenu(filtered);\n      }\n    };\n\n    void load();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [registry]);\n\n  return menu;\n}\n","/**\n * usePlugin — React hook for accessing a specific plugin by name.\n *\n * Returns the FrameworkMPlugin or undefined if not found.\n * Must be used within a PluginRegistryProvider.\n *\n * @example\n * ```tsx\n * function WMSStatus() {\n *   const wms = usePlugin(\"wms\");\n *   if (!wms) return <p>WMS not installed</p>;\n *   return <p>WMS v{wms.version}</p>;\n * }\n * ```\n */\n\nimport { useContext, useMemo } from \"react\";\nimport { PluginRegistryContext } from \"../context/PluginRegistryContext\";\nimport type { FrameworkMPlugin } from \"../types/plugin\";\n\nexport function usePlugin(name: string): FrameworkMPlugin | undefined {\n  const registry = useContext(PluginRegistryContext);\n\n  if (!registry) {\n    throw new Error(\"usePlugin must be used within PluginRegistryProvider\");\n  }\n\n  return useMemo(() => registry.getPlugin(name), [registry, name]);\n}\n","/**\n * useService — React hook for accessing a service from the ServiceContainer.\n *\n * Returns the service instance (lazily loaded), loading state, and error.\n * Must be used within a PluginRegistryProvider.\n *\n * @example\n * ```tsx\n * function WarehouseDashboard() {\n *   const { service, isLoading, error } = useService<WarehouseService>(\"warehouseService\");\n *   if (isLoading) return <Spinner />;\n *   if (error) return <Error message={error.message} />;\n *   return <div>{service.getWarehouses()}</div>;\n * }\n * ```\n */\n\nimport { useContext, useEffect, useMemo, useState } from \"react\";\nimport { PluginRegistryContext } from \"../context/PluginRegistryContext\";\n\ninterface UseServiceResult<T> {\n  service: T | null;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nexport function useService<T = unknown>(name: string): UseServiceResult<T> {\n  const registry = useContext(PluginRegistryContext);\n\n  if (!registry) {\n    throw new Error(\"useService must be used within PluginRegistryProvider\");\n  }\n\n  const [service, setService] = useState<T | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n  const servicePromise = useMemo(\n    () => registry.getService<T>(name),\n    [registry, name],\n  );\n\n  useEffect(() => {\n    let cancelled = false;\n    setIsLoading(true);\n    setError(null);\n\n    servicePromise\n      .then(instance => {\n        if (!cancelled) {\n          setService(instance);\n          setIsLoading(false);\n        }\n      })\n      .catch((err: unknown) => {\n        if (!cancelled) {\n          setError(err instanceof Error ? err : new Error(String(err)));\n          setIsLoading(false);\n        }\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [servicePromise]);\n\n  return { service, isLoading, error };\n}\n","/**\n * useWidgets — React hook for accessing plugin-provided dashboard widgets.\n */\n\nimport { useContext, useEffect, useState } from \"react\";\nimport { PluginRegistryContext } from \"../context/PluginRegistryContext\";\nimport type { Widget } from \"../types/plugin\";\n\nasync function filterWidgetsByPermissions(\n  widgets: Widget[],\n  checker: (permissions: string[]) => boolean | Promise<boolean>,\n): Promise<Widget[]> {\n  const filtered: Widget[] = [];\n\n  for (const widget of widgets) {\n    if (widget.permissions && widget.permissions.length > 0) {\n      const allowed = await Promise.resolve(checker(widget.permissions));\n      if (!allowed) {\n        continue;\n      }\n    }\n\n    filtered.push(widget);\n  }\n\n  return filtered;\n}\n\nexport function useWidgets(): Widget[] {\n  const registry = useContext(PluginRegistryContext);\n  const [widgets, setWidgets] = useState<Widget[]>([]);\n\n  if (!registry) {\n    throw new Error(\"useWidgets must be used within PluginRegistryProvider\");\n  }\n\n  useEffect(() => {\n    let cancelled = false;\n\n    const load = async () => {\n      const source = registry.getWidgets();\n      const checker = registry.getPermissionChecker();\n\n      if (!checker) {\n        if (!cancelled) {\n          setWidgets(source);\n        }\n        return;\n      }\n\n      const filtered = await filterWidgetsByPermissions(source, checker);\n      if (!cancelled) {\n        setWidgets(filtered);\n      }\n    };\n\n    void load();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [registry]);\n\n  return widgets;\n}\n"],"names":["ServiceContainer","__publicField","name","factory","instance","SDK_VERSION","MODULE_ICONS","isDebugEnabled","globalFlag","processRef","envFlag","registryLogger","message","args","PluginRegistry","plugin","diagnostics","errors","d","error","previous","warnings","allMenus","routes","pluginName","widgets","checker","event","handler","severity","reports","report","peerName","current","required","clean","cMajor","cMinor","cPatch","rMajor","rMinor","rPatch","seenRoutePaths","route","existingRouteOwner","seenMenuNames","seenMenuRoutes","item","existingNameOwner","seenServiceNames","serviceName","existingServiceOwner","diagnostic","fullDiagnostic","items","moduleMap","moduleName","moduleGroup","categoryGroup","_a","c","a","b","payload","PluginRegistryContext","createContext","PluginRegistryProvider","children","registry","registryInstance","useState","isReady","setIsReady","useEffect","filterMenuByPermissions","filtered","usePluginMenu","useContext","menu","setMenu","cancelled","source","usePlugin","useMemo","useService","service","setService","isLoading","setIsLoading","setError","servicePromise","err","filterWidgetsByPermissions","widget","useWidgets","setWidgets"],"mappings":"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"}

package/dist/types/plugin.d.ts

@@ -0,0 +1,157 @@
+import { ComponentType, LazyExoticComponent } from 'react';
+/**
+ * A single menu item contributed by a plugin.
+ *
+ * Menu items are merged across all plugins by `module` and optionally
+ * grouped by `category` within each module.
+ */
+export interface MenuItem {
+    /** Unique identifier, e.g. "wms.warehouse" */
+    name: string;
+    /** Display label, e.g. "Warehouse" */
+    label: string;
+    /** Route path, e.g. "/doctypes/wms.warehouse" */
+    route: string;
+    /** Icon name (lucide-react icon key) */
+    icon?: string;
+    /** Module group, e.g. "Inventory" — used for sidebar grouping */
+    module?: string;
+    /** Category within module, e.g. "Masters", "Transactions" */
+    category?: string;
+    /** Sort order (lower = first). Default: 999 */
+    order?: number;
+    /** Nested child menu items */
+    children?: MenuItem[];
+    /** Optional visibility flag for menu composition */
+    hidden?: boolean;
+    /** Optional permission keys required to display this menu item */
+    permissions?: string[];
+}
+/**
+ * A route contributed by a plugin. Uses lazy loading for code-splitting.
+ */
+export interface RouteDefinition {
+    /** URL path, e.g. "/wms/dashboard" */
+    path: string;
+    /** Lazy-loaded component */
+    element: LazyExoticComponent<ComponentType> | (() => Promise<{
+        default: ComponentType;
+    }>);
+}
+/**
+ * Factory function for creating a service instance.
+ * Can be sync or async (e.g. dynamic import).
+ */
+export type ServiceFactory<T = unknown> = () => T | Promise<T>;
+/**
+ * Checks whether a user is allowed to access an item guarded by permissions.
+ */
+export type PermissionChecker = (permissions: string[]) => boolean | Promise<boolean>;
+/**
+ * Optional React provider contribution from a plugin.
+ */
+export interface Provider {
+    component: () => Promise<{
+        default: ComponentType;
+    }>;
+    props?: Record<string, unknown>;
+}
+/**
+ * Optional DocType extension contribution from a plugin.
+ */
+export interface DocTypeExtension {
+    doctype: string;
+    fields?: Record<string, unknown>;
+    actions?: Array<Record<string, unknown>>;
+    components?: Record<string, ComponentType>;
+}
+/**
+ * Optional dashboard widget contribution from a plugin.
+ */
+export interface Widget {
+    id: string;
+    title: string;
+    component: () => Promise<{
+        default: ComponentType;
+    }>;
+    size?: "small" | "medium" | "large";
+    permissions?: string[];
+}
+/**
+ * The main plugin contract. Every Framework M plugin must satisfy this interface.
+ *
+ * @example
+ * ```ts
+ * // apps/wms/frontend/plugin.config.ts
+ * export default {
+ *   name: "wms",
+ *   version: "1.0.0",
+ *   menu: [
+ *     { name: "wms.warehouse", label: "Warehouse", route: "/doctypes/wms.warehouse", module: "Inventory" },
+ *   ],
+ * } satisfies FrameworkMPlugin;
+ * ```
+ */
+export interface FrameworkMPlugin {
+    /** Unique plugin name */
+    name: string;
+    /** Semver version */
+    version: string;
+    /** Minimum SDK version required (semver range, e.g. ">=0.1.0") */
+    minSdkVersion?: string;
+    /** Other plugins this plugin depends on */
+    peerPlugins?: string[];
+    /** Menu items contributed by this plugin */
+    menu?: MenuItem[];
+    /** Routes contributed by this plugin */
+    routes?: RouteDefinition[];
+    /** Named service factories for DI */
+    services?: Record<string, ServiceFactory>;
+    /** Optional provider contributions */
+    providers?: Provider[];
+    /** Optional DocType extension contributions */
+    doctypes?: DocTypeExtension[];
+    /** Optional dashboard widget contributions */
+    widgets?: Widget[];
+    /** Optional initialization lifecycle hook */
+    onInit?: () => Promise<void> | void;
+    /** Optional cleanup lifecycle hook */
+    onDestroy?: () => Promise<void> | void;
+}
+/**
+ * Result of checking a plugin's compatibility with the current SDK.
+ */
+export interface CompatibilityReport {
+    /** Plugin name */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Whether the plugin is compatible with the current SDK version */
+    sdkCompatible: boolean;
+    /** Peer plugins that are required but not registered */
+    missingPeerPlugins: string[];
+}
+/**
+ * Severity level for plugin registry diagnostics.
+ */
+export type PluginRegistryDiagnosticSeverity = "info" | "warning" | "error";
+/**
+ * Structured diagnostic emitted by PluginRegistry during registration.
+ */
+export interface PluginRegistryDiagnostic {
+    /** Machine-readable diagnostic code */
+    code: "SDK_INCOMPATIBLE" | "PLUGIN_DUPLICATE" | "ROUTE_COLLISION" | "MENU_NAME_COLLISION" | "MENU_ROUTE_COLLISION" | "SERVICE_COLLISION";
+    /** Diagnostic severity */
+    severity: PluginRegistryDiagnosticSeverity;
+    /** Human-readable message */
+    message: string;
+    /** Plugin that triggered the diagnostic */
+    pluginName: string;
+    /** Optional key involved in the diagnostic (route path, service name, etc.) */
+    key?: string;
+    /** Existing plugin that conflicts with pluginName */
+    conflictingPluginName?: string;
+    /** ISO timestamp when generated */
+    timestamp: string;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@framework-m/plugin-sdk",
+  "version": "0.2.3",
+  "description": "Plugin infrastructure and runtime for Framework M multi-app composition",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "framework-m",
+    "plugin",
+    "sdk",
+    "plugin-system",
+    "multi-app"
+  ],
+  "author": "Framework M Team",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/castlecraft/framework-m.git",
+    "directory": "libs/framework-m-plugin-sdk"
+  },
+  "peerDependencies": {
+    "@framework-m/desk": "^0.1.0",
+    "react": "^19.0.0"
+  },
+  "dependencies": {
+    "react-router-dom": "^7.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.14",
+    "@vitejs/plugin-react": "^4.7.0",
+    "happy-dom": "^20.8.4",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "^5.9.3",
+    "vite": "^6.4.1",
+    "vite-plugin-dts": "^4.5.1",
+    "vitest": "^4.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && vite build",
+    "dev": "vite build --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}