@framework-m/plugin-sdk 0.2.3

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 contributors (see contributors.json)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/context/PluginRegistryContext.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import { PluginRegistry } from '../core/PluginRegistry';
+export declare const PluginRegistryContext: import('react').Context<PluginRegistry | null>;
+export interface PluginRegistryProviderProps {
+    readonly children: ReactNode;
+    /** Optional pre-configured PluginRegistry instance */
+    readonly registry?: PluginRegistry;
+}
+/**
+ * Provider component that makes the PluginRegistry available to child components.
+ *
+ * @example
+ * ```tsx
+ * const registry = new PluginRegistry();
+ * await registry.register(wmsPlugin);
+ *
+ * <PluginRegistryProvider registry={registry}>
+ *   <App />
+ * </PluginRegistryProvider>
+ * ```
+ */
+export declare function PluginRegistryProvider({ children, registry, }: PluginRegistryProviderProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=PluginRegistryContext.d.ts.map

package/dist/context/PluginRegistryContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginRegistryContext.d.ts","sourceRoot":"","sources":["../../src/context/PluginRegistryContext.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,eAAO,MAAM,qBAAqB,gDAA6C,CAAC;AAEhF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,QAAQ,GACT,EAAE,2BAA2B,kDAmB7B"}

package/dist/core/PluginRegistry.d.ts

@@ -0,0 +1,130 @@
+import { FrameworkMPlugin, MenuItem, RouteDefinition, CompatibilityReport, PluginRegistryDiagnostic, PluginRegistryDiagnosticSeverity, PermissionChecker, Widget } from '../types/plugin';
+import { ServiceContainer } from './ServiceContainer';
+type PluginRegistryEvent = "plugin:registered" | "plugin:error";
+type PluginRegistryEventPayloadMap = {
+    "plugin:registered": {
+        plugin: FrameworkMPlugin;
+    };
+    "plugin:error": {
+        plugin: FrameworkMPlugin;
+        error: unknown;
+    };
+};
+type PluginRegistryEventHandler<E extends PluginRegistryEvent> = (payload: PluginRegistryEventPayloadMap[E]) => void;
+/**
+ * SDK version — used for compatibility checking.
+ */
+export declare const SDK_VERSION = "0.1.0";
+export declare class PluginRegistry {
+    private readonly plugins;
+    private menuCache;
+    private readonly serviceContainer;
+    private readonly routeOwners;
+    private readonly menuNameOwners;
+    private readonly menuRouteOwners;
+    private readonly serviceOwners;
+    private diagnostics;
+    private permissionChecker;
+    private readonly eventListeners;
+    /**
+     * Register a plugin with the registry.
+     *
+     * validates that the plugin has name and version, checks collisions,
+     * stores it, registers any services into the ServiceContainer,
+     * and invalidates the menu cache.
+     *
+     * @throws Error if plugin has no name or version
+     */
+    register(plugin: FrameworkMPlugin): Promise<void>;
+    /**
+     * Get merged menu tree from all plugins.
+     *
+     * Collects all MenuItem entries, groups them by `module` (default: "Other"),
+     * optionally sub-groups by `category`, and sorts by `order`.
+     * Result is cached until a new plugin is registered.
+     */
+    getMenu(): MenuItem[];
+    /**
+     * Get aggregated routes from all plugins.
+     */
+    getRoutes(): RouteDefinition[];
+    /**
+     * Get a specific plugin by name.
+     */
+    getPlugin(name: string): FrameworkMPlugin | undefined;
+    /**
+     * Get all registered plugins.
+     */
+    getAllPlugins(): FrameworkMPlugin[];
+    /**
+     * Get the service container for DI.
+     */
+    getServiceContainer(): ServiceContainer;
+    /**
+     * Unregister a plugin by name and run cleanup lifecycle if provided.
+     */
+    unregister(pluginName: string): Promise<boolean>;
+    /**
+     * Resolve a service instance from the registry-level DI container.
+     */
+    getService<T = unknown>(name: string): Promise<T>;
+    /**
+     * Aggregate all widgets contributed by registered plugins.
+     */
+    getWidgets(): Widget[];
+    /**
+     * Configure a permission checker used by consumer hooks.
+     */
+    setPermissionChecker(checker: PermissionChecker | null): void;
+    /**
+     * Get the configured permission checker.
+     */
+    getPermissionChecker(): PermissionChecker | null;
+    /**
+     * Subscribe to plugin lifecycle events.
+     */
+    on<E extends PluginRegistryEvent>(event: E, handler: PluginRegistryEventHandler<E>): () => void;
+    /**
+     * Get emitted diagnostics.
+     */
+    getDiagnostics(severity?: PluginRegistryDiagnosticSeverity): PluginRegistryDiagnostic[];
+    /**
+     * Clear diagnostics.
+     */
+    clearDiagnostics(): void;
+    /**
+     * Check compatibility of all registered plugins.
+     *
+     * Returns a report of all plugins with their compatibility status:
+     * - SDK version compatibility
+     * - Peer plugin dependency satisfaction
+     */
+    checkCompatibility(): CompatibilityReport[];
+    /**
+     * Simple semver compatibility check.
+     * Checks if `current` satisfies `>=required`.
+     */
+    private checkSemverCompat;
+    private validateRegistration;
+    private validateSdkCompatibility;
+    private validateDuplicatePlugin;
+    private validateRouteCollisions;
+    private validateMenuCollisions;
+    private validateServiceCollisions;
+    private addDiagnostic;
+    /**
+     * Merge flat menu items into a grouped tree:
+     *   Module → (optional) Category → Items
+     *
+     * Items without a `module` are placed under "Other".
+     */
+    private mergeMenus;
+    private getModuleIcon;
+    private rebuildIndexesAndServices;
+    private registerPluginServices;
+    private registerPluginRoutes;
+    private registerPluginMenuItems;
+    private emit;
+}
+export {};
+//# sourceMappingURL=PluginRegistry.d.ts.map

package/dist/core/PluginRegistry.d.ts.map

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

package/dist/core/ServiceContainer.d.ts

@@ -0,0 +1,31 @@
+import { ServiceFactory } from '../types/plugin';
+export declare class ServiceContainer {
+    private readonly factories;
+    private readonly instances;
+    /**
+     * Register a service factory.
+     *
+     * @param name — unique service name
+     * @param factory — factory function (sync or async)
+     */
+    register<T>(name: string, factory: ServiceFactory<T>): void;
+    /**
+     * Get a service by name. Lazily instantiates on first call (singleton).
+     *
+     * @throws Error if service is not registered
+     */
+    get<T = unknown>(name: string): Promise<T>;
+    /**
+     * Check if a service is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered service names.
+     */
+    getAll(): string[];
+    /**
+     * Clear all registered factories and cached instances.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ServiceContainer.d.ts.map

package/dist/core/ServiceContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceContainer.d.ts","sourceRoot":"","sources":["../../src/core/ServiceContainer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IAExD;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAM3D;;;;OAIG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBhD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;IAIlB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/hooks/usePlugin.d.ts

@@ -0,0 +1,3 @@
+import { FrameworkMPlugin } from '../types/plugin';
+export declare function usePlugin(name: string): FrameworkMPlugin | undefined;
+//# sourceMappingURL=usePlugin.d.ts.map

package/dist/hooks/usePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlugin.d.ts","sourceRoot":"","sources":["../../src/hooks/usePlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAQpE"}

package/dist/hooks/usePluginMenu.d.ts

@@ -0,0 +1,3 @@
+import { MenuItem } from '../types/plugin';
+export declare function usePluginMenu(): MenuItem[];
+//# sourceMappingURL=usePluginMenu.d.ts.map

package/dist/hooks/usePluginMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePluginMenu.d.ts","sourceRoot":"","sources":["../../src/hooks/usePluginMenu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAkChD,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAoC1C"}

package/dist/hooks/useService.d.ts

@@ -0,0 +1,24 @@
+/**
+ * useService — React hook for accessing a service from the ServiceContainer.
+ *
+ * Returns the service instance (lazily loaded), loading state, and error.
+ * Must be used within a PluginRegistryProvider.
+ *
+ * @example
+ * ```tsx
+ * function WarehouseDashboard() {
+ *   const { service, isLoading, error } = useService<WarehouseService>("warehouseService");
+ *   if (isLoading) return <Spinner />;
+ *   if (error) return <Error message={error.message} />;
+ *   return <div>{service.getWarehouses()}</div>;
+ * }
+ * ```
+ */
+interface UseServiceResult<T> {
+    service: T | null;
+    isLoading: boolean;
+    error: Error | null;
+}
+export declare function useService<T = unknown>(name: string): UseServiceResult<T>;
+export {};
+//# sourceMappingURL=useService.d.ts.map

package/dist/hooks/useService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useService.d.ts","sourceRoot":"","sources":["../../src/hooks/useService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,UAAU,gBAAgB,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAwCzE"}

package/dist/hooks/useWidgets.d.ts

@@ -0,0 +1,3 @@
+import { Widget } from '../types/plugin';
+export declare function useWidgets(): Widget[];
+//# sourceMappingURL=useWidgets.d.ts.map

package/dist/hooks/useWidgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWidgets.d.ts","sourceRoot":"","sources":["../../src/hooks/useWidgets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAsB9C,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAoCrC"}

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var p=Object.defineProperty;var P=(r,e,t)=>e in r?p(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t;var u=(r,e,t)=>P(r,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("react/jsx-runtime"),a=require("react");class v{constructor(){u(this,"factories",new Map);u(this,"instances",new Map)}register(e,t){this.factories.set(e,t),this.instances.delete(e)}async get(e){if(this.instances.has(e))return this.instances.get(e);const t=this.factories.get(e);if(!t)throw new Error(`Service "${e}" is not registered`);const i=await Promise.resolve(t());return this.instances.set(e,i),i}has(e){return this.factories.has(e)}getAll(){return Array.from(this.factories.keys())}clear(){this.factories.clear(),this.instances.clear()}}const d="0.1.0",f={Sales:"shopping-cart",Inventory:"package",HR:"users",Finance:"dollar-sign",Core:"settings",Other:"folder"};function C(){const r=globalThis.__FRAMEWORK_M_PLUGIN_DEBUG__;if(typeof r=="boolean")return r;if(typeof r=="string")return["1","true","yes","on"].includes(r.toLowerCase());const e=globalThis.process;if(e!=null&&e.env){const t=e.env.FRAMEWORK_M_PLUGIN_DEBUG;if(typeof t=="string")return["1","true","yes","on"].includes(t.toLowerCase())}return!1}const O={debug(r,...e){C()&&console.debug(`[PluginRegistry] ${r}`,...e)}};class w{constructor(){u(this,"plugins",new Map);u(this,"menuCache",null);u(this,"serviceContainer",new v);u(this,"routeOwners",new Map);u(this,"menuNameOwners",new Map);u(this,"menuRouteOwners",new Map);u(this,"serviceOwners",new Map);u(this,"diagnostics",[]);u(this,"permissionChecker",null);u(this,"eventListeners",{"plugin:registered":new Set,"plugin:error":new Set})}async register(e){if(!e.name||!e.version)throw new Error("Plugin must have name and version");const t=this.validateRegistration(e),i=t.filter(o=>o.severity==="error");if(i.length>0){const o=new Error(`Plugin "${e.name}" registration failed: ${i.map(c=>c.message).join("; ")}`);throw this.emit("plugin:error",{plugin:e,error:o}),o}const s=this.plugins.get(e.name);this.plugins.set(e.name,e),this.rebuildIndexesAndServices(),this.menuCache=null;try{e.onInit&&await Promise.resolve(e.onInit())}catch(o){throw s?this.plugins.set(e.name,s):this.plugins.delete(e.name),this.rebuildIndexesAndServices(),this.menuCache=null,this.emit("plugin:error",{plugin:e,error:o}),o}s!=null&&s.onDestroy&&s!==e&&await Promise.resolve(s.onDestroy()),this.emit("plugin:registered",{plugin:e});const n=t.filter(o=>o.severity==="warning");n.length>0&&O.debug(`Registered plugin "${e.name}" with warnings`,n)}getMenu(){if(this.menuCache)return this.menuCache;const e=[];for(const t of this.plugins.values())t.menu&&e.push(...t.menu);return e.length===0?(this.menuCache=[],this.menuCache):(this.menuCache=this.mergeMenus(e),this.menuCache)}getRoutes(){const e=[];for(const t of this.plugins.values())t.routes&&e.push(...t.routes);return e}getPlugin(e){return this.plugins.get(e)}getAllPlugins(){return Array.from(this.plugins.values())}getServiceContainer(){return this.serviceContainer}async unregister(e){const t=this.plugins.get(e);return t?(this.plugins.delete(e),this.rebuildIndexesAndServices(),this.menuCache=null,t.onDestroy&&await Promise.resolve(t.onDestroy()),!0):!1}async getService(e){return this.serviceContainer.get(e)}getWidgets(){const e=[];for(const t of this.plugins.values())t.widgets&&e.push(...t.widgets);return e}setPermissionChecker(e){this.permissionChecker=e}getPermissionChecker(){return this.permissionChecker}on(e,t){return this.eventListeners[e].add(t),()=>{this.eventListeners[e].delete(t)}}getDiagnostics(e){return e?this.diagnostics.filter(t=>t.severity===e):[...this.diagnostics]}clearDiagnostics(){this.diagnostics=[]}checkCompatibility(){const e=[];for(const t of this.plugins.values()){const i={name:t.name,version:t.version,sdkCompatible:!0,missingPeerPlugins:[]};if(t.minSdkVersion&&(i.sdkCompatible=this.checkSemverCompat(d,t.minSdkVersion)),t.peerPlugins)for(const s of t.peerPlugins)this.plugins.has(s)||i.missingPeerPlugins.push(s);e.push(i)}return e}checkSemverCompat(e,t){const i=t.replace(/^>=?/,""),[s,n=0,o=0]=e.split(".").map(Number),[c,l=0,m=0]=i.split(".").map(Number);return s!==c?s>c:n!==l?n>l:o>=m}validateRegistration(e){return[...this.validateSdkCompatibility(e),...this.validateDuplicatePlugin(e),...this.validateRouteCollisions(e),...this.validateMenuCollisions(e),...this.validateServiceCollisions(e)]}validateSdkCompatibility(e){const t=[];return e.minSdkVersion&&(this.checkSemverCompat(d,e.minSdkVersion)||t.push(this.addDiagnostic({code:"SDK_INCOMPATIBLE",severity:"warning",message:`Plugin ${e.name} requires SDK >=${e.minSdkVersion}, current SDK is ${d}. Plugin may not work correctly.`,pluginName:e.name,key:e.minSdkVersion}))),t}validateDuplicatePlugin(e){const t=[];return this.plugins.has(e.name)&&t.push(this.addDiagnostic({code:"PLUGIN_DUPLICATE",severity:"warning",message:`Plugin ${e.name} is already registered and will be replaced`,pluginName:e.name,conflictingPluginName:e.name,key:e.name})),t}validateRouteCollisions(e){const t=[],i=new Set;for(const s of e.routes??[]){if(i.has(s.path)){t.push(this.addDiagnostic({code:"ROUTE_COLLISION",severity:"error",message:`Duplicate route path "${s.path}" inside plugin ${e.name}`,pluginName:e.name,conflictingPluginName:e.name,key:s.path}));continue}i.add(s.path);const n=this.routeOwners.get(s.path);n&&n!==e.name&&t.push(this.addDiagnostic({code:"ROUTE_COLLISION",severity:"error",message:`Route path "${s.path}" from plugin ${e.name} conflicts with plugin ${n}`,pluginName:e.name,conflictingPluginName:n,key:s.path}))}return t}validateMenuCollisions(e){const t=[],i=new Set,s=new Set;for(const n of e.menu??[]){if(i.has(n.name))t.push(this.addDiagnostic({code:"MENU_NAME_COLLISION",severity:"error",message:`Duplicate menu name "${n.name}" inside plugin ${e.name}`,pluginName:e.name,conflictingPluginName:e.name,key:n.name}));else{i.add(n.name);const o=this.menuNameOwners.get(n.name);o&&o!==e.name&&t.push(this.addDiagnostic({code:"MENU_NAME_COLLISION",severity:"error",message:`Menu name "${n.name}" from plugin ${e.name} conflicts with plugin ${o}`,pluginName:e.name,conflictingPluginName:o,key:n.name}))}if(s.has(n.route))t.push(this.addDiagnostic({code:"MENU_ROUTE_COLLISION",severity:"error",message:`Duplicate menu route "${n.route}" inside plugin ${e.name}`,pluginName:e.name,conflictingPluginName:e.name,key:n.route}));else{s.add(n.route);const o=this.menuRouteOwners.get(n.route);o&&o!==e.name&&t.push(this.addDiagnostic({code:"MENU_ROUTE_COLLISION",severity:"error",message:`Menu route "${n.route}" from plugin ${e.name} conflicts with plugin ${o}`,pluginName:e.name,conflictingPluginName:o,key:n.route}))}}return t}validateServiceCollisions(e){const t=[],i=new Set;for(const s of Object.keys(e.services??{})){if(i.has(s)){t.push(this.addDiagnostic({code:"SERVICE_COLLISION",severity:"error",message:`Duplicate service "${s}" inside plugin ${e.name}`,pluginName:e.name,conflictingPluginName:e.name,key:s}));continue}i.add(s);const n=this.serviceOwners.get(s);n&&n!==e.name&&t.push(this.addDiagnostic({code:"SERVICE_COLLISION",severity:"error",message:`Service "${s}" from plugin ${e.name} conflicts with plugin ${n}`,pluginName:e.name,conflictingPluginName:n,key:s}))}return t}addDiagnostic(e){const t={...e,timestamp:new Date().toISOString()};return this.diagnostics.push(t),t}mergeMenus(e){var i;const t=new Map;for(const s of e){const n=s.module||"Other";t.has(n)||t.set(n,{name:n.toLowerCase(),label:n,route:`/${n.toLowerCase()}`,icon:this.getModuleIcon(n),order:s.order,children:[]});const o=t.get(n);if(s.order!==void 0&&(o.order===void 0||s.order<o.order)&&(o.order=s.order),s.category){let c=(i=o.children)==null?void 0:i.find(l=>l.label===s.category);c||(c={name:s.category.toLowerCase(),label:s.category,route:`/${n.toLowerCase()}/${s.category.toLowerCase()}`,children:[]},o.children.push(c)),c.children.push(s)}else o.children.push(s)}return Array.from(t.values()).sort((s,n)=>(s.order??999)-(n.order??999))}getModuleIcon(e){return f[e]||f.Other}rebuildIndexesAndServices(){this.routeOwners.clear(),this.menuNameOwners.clear(),this.menuRouteOwners.clear(),this.serviceOwners.clear(),this.serviceContainer.clear();for(const e of this.plugins.values())this.registerPluginServices(e),this.registerPluginRoutes(e),this.registerPluginMenuItems(e)}registerPluginServices(e){for(const[t,i]of Object.entries(e.services??{}))this.serviceContainer.register(t,i),this.serviceOwners.set(t,e.name)}registerPluginRoutes(e){for(const t of e.routes??[])this.routeOwners.set(t.path,e.name)}registerPluginMenuItems(e){for(const t of e.menu??[])this.menuNameOwners.set(t.name,e.name),this.menuRouteOwners.set(t.route,e.name)}emit(e,t){for(const i of this.eventListeners[e])i(t)}}const g=a.createContext(null);function N({children:r,registry:e}){const[t]=a.useState(()=>e??new w),[i,s]=a.useState(!1);return a.useEffect(()=>{s(!0)},[]),i?S.jsx(g.Provider,{value:t,children:r}):null}async function y(r,e){const t=[];for(const i of r){if(i.hidden||i.permissions&&i.permissions.length>0&&!await Promise.resolve(e(i.permissions)))continue;const s=i.children?await y(i.children,e):void 0;i.children&&((s==null?void 0:s.length)??0)===0||t.push({...i,children:s})}return t}function M(){const r=a.useContext(g),[e,t]=a.useState([]);if(!r)throw new Error("usePluginMenu must be used within PluginRegistryProvider");return a.useEffect(()=>{let i=!1;return(async()=>{const n=r.getMenu(),o=r.getPermissionChecker();if(!o){i||t(n.filter(l=>!l.hidden));return}const c=await y(n,o);i||t(c)})(),()=>{i=!0}},[r]),e}function R(r){const e=a.useContext(g);if(!e)throw new Error("usePlugin must be used within PluginRegistryProvider");return a.useMemo(()=>e.getPlugin(r),[e,r])}function I(r){const e=a.useContext(g);if(!e)throw new Error("useService must be used within PluginRegistryProvider");const[t,i]=a.useState(null),[s,n]=a.useState(!0),[o,c]=a.useState(null),l=a.useMemo(()=>e.getService(r),[e,r]);return a.useEffect(()=>{let m=!1;return n(!0),c(null),l.then(h=>{m||(i(h),n(!1))}).catch(h=>{m||(c(h instanceof Error?h:new Error(String(h))),n(!1))}),()=>{m=!0}},[l]),{service:t,isLoading:s,error:o}}async function E(r,e){const t=[];for(const i of r)i.permissions&&i.permissions.length>0&&!await Promise.resolve(e(i.permissions))||t.push(i);return t}function k(){const r=a.useContext(g),[e,t]=a.useState([]);if(!r)throw new Error("useWidgets must be used within PluginRegistryProvider");return a.useEffect(()=>{let i=!1;return(async()=>{const n=r.getWidgets(),o=r.getPermissionChecker();if(!o){i||t(n);return}const c=await E(n,o);i||t(c)})(),()=>{i=!0}},[r]),e}exports.PluginRegistry=w;exports.PluginRegistryContext=g;exports.PluginRegistryProvider=N;exports.SDK_VERSION=d;exports.ServiceContainer=v;exports.usePlugin=R;exports.usePluginMenu=M;exports.useService=I;exports.useWidgets=k;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","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/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @framework-m/plugin-sdk
+ *
+ * Plugin infrastructure and runtime for Framework M multi-app composition.
+ *
+ * This package provides the contract, registry, DI container, and React hooks
+ * that enable multiple apps to compose into a single UI.
+ *
+ * @example
+ * ```tsx
+ * import { PluginRegistry, PluginRegistryProvider, usePluginMenu } from "@framework-m/plugin-sdk";
+ *
+ * const registry = new PluginRegistry();
+ * await registry.register(wmsPlugin);
+ *
+ * function App() {
+ *   return (
+ *     <PluginRegistryProvider registry={registry}>
+ *       <Sidebar />
+ *     </PluginRegistryProvider>
+ *   );
+ * }
+ *
+ * function Sidebar() {
+ *   const menu = usePluginMenu();
+ *   return <nav>{menu.map(m => <div key={m.name}>{m.label}</div>)}</nav>;
+ * }
+ * ```
+ */
+export type { MenuItem, RouteDefinition, ServiceFactory, PermissionChecker, Provider, DocTypeExtension, Widget, FrameworkMPlugin, CompatibilityReport, PluginRegistryDiagnostic, PluginRegistryDiagnosticSeverity, } from './types/plugin';
+export { PluginRegistry, SDK_VERSION } from './core/PluginRegistry';
+export { ServiceContainer } from './core/ServiceContainer';
+export { PluginRegistryContext, PluginRegistryProvider, } from './context/PluginRegistryContext';
+export type { PluginRegistryProviderProps } from './context/PluginRegistryContext';
+export { usePluginMenu } from './hooks/usePluginMenu';
+export { usePlugin } from './hooks/usePlugin';
+export { useService } from './hooks/useService';
+export { useWidgets } from './hooks/useWidgets';
+//# sourceMappingURL=index.d.ts.map