@framework-m/plugin-sdk 0.2.9 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/dist/index.cjs +1 -1
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.ts +2 -0
  4. package/dist/index.d.ts.map +1 -1
  5. package/dist/index.js +142 -105
  6. package/dist/index.js.map +1 -1
  7. package/dist/loader/federation.d.ts +24 -0
  8. package/dist/loader/federation.d.ts.map +1 -0
  9. package/package.json +2 -2
package/dist/index.cjs CHANGED
@@ -1,2 +1,2 @@
1
- "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;
1
+ "use strict";var P=Object.defineProperty;var S=(n,e,t)=>e in n?P(n,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):n[e]=t;var u=(n,e,t)=>S(n,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const C=require("react/jsx-runtime"),c=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 O(){const n=globalThis.__FRAMEWORK_M_PLUGIN_DEBUG__;if(typeof n=="boolean")return n;if(typeof n=="string")return["1","true","yes","on"].includes(n.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 N={debug(n,...e){O()&&console.debug(`[PluginRegistry] ${n}`,...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(a=>a.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 r=t.filter(o=>o.severity==="warning");r.length>0&&N.debug(`Registered plugin "${e.name}" with warnings`,r)}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,r=0,o=0]=e.split(".").map(Number),[a,l=0,h=0]=i.split(".").map(Number);return s!==a?s>a:r!==l?r>l:o>=h}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 r=this.routeOwners.get(s.path);r&&r!==e.name&&t.push(this.addDiagnostic({code:"ROUTE_COLLISION",severity:"error",message:`Route path "${s.path}" from plugin ${e.name} conflicts with plugin ${r}`,pluginName:e.name,conflictingPluginName:r,key:s.path}))}return t}validateMenuCollisions(e){const t=[],i=new Set,s=new Set;for(const r of e.menu??[]){if(i.has(r.name))t.push(this.addDiagnostic({code:"MENU_NAME_COLLISION",severity:"error",message:`Duplicate menu name "${r.name}" inside plugin ${e.name}`,pluginName:e.name,conflictingPluginName:e.name,key:r.name}));else{i.add(r.name);const o=this.menuNameOwners.get(r.name);o&&o!==e.name&&t.push(this.addDiagnostic({code:"MENU_NAME_COLLISION",severity:"error",message:`Menu name "${r.name}" from plugin ${e.name} conflicts with plugin ${o}`,pluginName:e.name,conflictingPluginName:o,key:r.name}))}if(s.has(r.route))t.push(this.addDiagnostic({code:"MENU_ROUTE_COLLISION",severity:"error",message:`Duplicate menu route "${r.route}" inside plugin ${e.name}`,pluginName:e.name,conflictingPluginName:e.name,key:r.route}));else{s.add(r.route);const o=this.menuRouteOwners.get(r.route);o&&o!==e.name&&t.push(this.addDiagnostic({code:"MENU_ROUTE_COLLISION",severity:"error",message:`Menu route "${r.route}" from plugin ${e.name} conflicts with plugin ${o}`,pluginName:e.name,conflictingPluginName:o,key:r.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 r=this.serviceOwners.get(s);r&&r!==e.name&&t.push(this.addDiagnostic({code:"SERVICE_COLLISION",severity:"error",message:`Service "${s}" from plugin ${e.name} conflicts with plugin ${r}`,pluginName:e.name,conflictingPluginName:r,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 r=s.module||"Other";t.has(r)||t.set(r,{name:r.toLowerCase(),label:r,route:`/${r.toLowerCase()}`,icon:this.getModuleIcon(r),order:s.order,children:[]});const o=t.get(r);if(s.order!==void 0&&(o.order===void 0||s.order<o.order)&&(o.order=s.order),s.category){let a=(i=o.children)==null?void 0:i.find(l=>l.label===s.category);a||(a={name:s.category.toLowerCase(),label:s.category,route:`/${r.toLowerCase()}/${s.category.toLowerCase()}`,children:[]},o.children.push(a)),a.children.push(s)}else o.children.push(s)}return Array.from(t.values()).sort((s,r)=>(s.order??999)-(r.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 m=c.createContext(null);function R({children:n,registry:e}){const[t]=c.useState(()=>e??new w),[i,s]=c.useState(!1);return c.useEffect(()=>{s(!0)},[]),i?C.jsx(m.Provider,{value:t,children:n}):null}async function y(n,e){const t=[];for(const i of n){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 n=c.useContext(m),[e,t]=c.useState([]);if(!n)throw new Error("usePluginMenu must be used within PluginRegistryProvider");return c.useEffect(()=>{let i=!1;return(async()=>{const r=n.getMenu(),o=n.getPermissionChecker();if(!o){i||t(r.filter(l=>!l.hidden));return}const a=await y(r,o);i||t(a)})(),()=>{i=!0}},[n]),e}function I(n){const e=c.useContext(m);if(!e)throw new Error("usePlugin must be used within PluginRegistryProvider");return c.useMemo(()=>e.getPlugin(n),[e,n])}function E(n){const e=c.useContext(m);if(!e)throw new Error("useService must be used within PluginRegistryProvider");const[t,i]=c.useState(null),[s,r]=c.useState(!0),[o,a]=c.useState(null),l=c.useMemo(()=>e.getService(n),[e,n]);return c.useEffect(()=>{let h=!1;return r(!0),a(null),l.then(g=>{h||(i(g),r(!1))}).catch(g=>{h||(a(g instanceof Error?g:new Error(String(g))),r(!1))}),()=>{h=!0}},[l]),{service:t,isLoading:s,error:o}}async function k(n,e){const t=[];for(const i of n)i.permissions&&i.permissions.length>0&&!await Promise.resolve(e(i.permissions))||t.push(i);return t}function L(){const n=c.useContext(m),[e,t]=c.useState([]);if(!n)throw new Error("useWidgets must be used within PluginRegistryProvider");return c.useEffect(()=>{let i=!1;return(async()=>{const r=n.getWidgets(),o=n.getPermissionChecker();if(!o){i||t(r);return}const a=await k(r,o);i||t(a)})(),()=>{i=!0}},[n]),e}const p={apiUrl:"/api/v1/frontend/remotes",shareScope:"default"},D=async n=>{const e=(n==null?void 0:n.apiUrl)??p.apiUrl;try{const t=await fetch(e);if(!t.ok)throw new Error(`Failed to fetch remotes: ${t.status}`);return await t.json()}catch(t){throw console.error("Error fetching remotes:",t),t}},b=n=>{const e=document.createElement("script");e.src=n,e.async=!0,document.body.appendChild(e)},$=async(n,e)=>{const t=(e==null?void 0:e.shareScope)??p.shareScope;return new Promise((i,s)=>{const r=setInterval(()=>{const o=window;if(o[n]){clearInterval(r);try{o[n].init({shareScope:t}),i()}catch(a){console.error(`Failed to initialize remote module ${n}:`,a),s(a)}}},50)})};exports.PluginRegistry=w;exports.PluginRegistryContext=m;exports.PluginRegistryProvider=R;exports.SDK_VERSION=d;exports.ServiceContainer=v;exports.fetchRemotes=D;exports.initializeRemote=$;exports.loadRemoteScript=b;exports.usePlugin=I;exports.usePluginMenu=M;exports.useService=E;exports.useWidgets=L;
2
2
  //# sourceMappingURL=index.cjs.map
package/dist/index.cjs.map CHANGED
@@ -1 +1 @@
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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"}
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","../src/loader/federation.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","export interface RemoteModule {\n init: (args: { shareScope: string }) => void;\n}\n\nexport interface FederationOptions {\n /** Discovery API URL, defaults to /api/v1/frontend/remotes */\n apiUrl?: string;\n /** Share scope for federation, defaults to 'default' */\n shareScope?: string;\n}\n\nconst DEFAULT_OPTIONS: FederationOptions = {\n apiUrl: \"/api/v1/frontend/remotes\",\n shareScope: \"default\",\n};\n\n/**\n * Fetch remote plugin definitions from the backend discovery API.\n */\nexport const fetchRemotes = async (options?: FederationOptions): Promise<Record<string, string>> => {\n const apiUrl = options?.apiUrl ?? DEFAULT_OPTIONS.apiUrl!;\n try {\n const response = await fetch(apiUrl);\n if (!response.ok) {\n throw new Error(`Failed to fetch remotes: ${response.status}`);\n }\n return await response.json();\n } catch (error: unknown) {\n console.error('Error fetching remotes:', error);\n throw error;\n }\n};\n\n/**\n * Dynamically load a remote script into the browser runtime.\n */\nexport const loadRemoteScript = (remoteUrl: string): void => {\n const script = document.createElement('script');\n script.src = remoteUrl;\n script.async = true;\n document.body.appendChild(script);\n};\n\n/**\n * Initialize a federated remote module on the global window scope.\n */\nexport const initializeRemote = async (scope: string, options?: FederationOptions): Promise<void> => {\n const shareScope = options?.shareScope ?? DEFAULT_OPTIONS.shareScope!;\n \n return new Promise((resolve, reject) => {\n interface WindowWithRemote {\n [key: string]: {\n init: (args: { shareScope: string }) => void;\n } | undefined;\n }\n \n const checkInterval = setInterval(() => {\n const w = window as unknown as WindowWithRemote;\n if (w[scope]) {\n clearInterval(checkInterval);\n try {\n w[scope]!.init({\n shareScope,\n });\n resolve();\n } catch (error: unknown) {\n console.error(`Failed to initialize remote module ${scope}:`, error);\n reject(error);\n }\n }\n }, 50);\n });\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","DEFAULT_OPTIONS","fetchRemotes","options","apiUrl","response","loadRemoteScript","remoteUrl","script","initializeRemote","scope","shareScope","resolve","reject","checkInterval","w"],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -36,4 +36,6 @@ export { usePluginMenu } from './hooks/usePluginMenu';
36
36
  export { usePlugin } from './hooks/usePlugin';
37
37
  export { useService } from './hooks/useService';
38
38
  export { useWidgets } from './hooks/useWidgets';
39
+ export { fetchRemotes, loadRemoteScript, initializeRemote, } from './loader/federation';
40
+ export type { RemoteModule, FederationOptions, } from './loader/federation';
39
41
  //# sourceMappingURL=index.d.ts.map
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,YAAY,EACV,QAAQ,EACR,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,EAChB,MAAM,EACN,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAGnF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,YAAY,EACV,QAAQ,EACR,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,EAChB,MAAM,EACN,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAGnF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}
package/dist/index.js CHANGED
@@ -1,9 +1,9 @@
1
- var P = Object.defineProperty;
2
- var C = (r, e, t) => e in r ? P(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
3
- var c = (r, e, t) => C(r, typeof e != "symbol" ? e + "" : e, t);
4
- import { jsx as S } from "react/jsx-runtime";
5
- import { createContext as O, useState as l, useEffect as d, useContext as f, useMemo as p } from "react";
6
- class N {
1
+ var C = Object.defineProperty;
2
+ var S = (n, e, t) => e in n ? C(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
3
+ var c = (n, e, t) => S(n, typeof e != "symbol" ? e + "" : e, t);
4
+ import { jsx as O } from "react/jsx-runtime";
5
+ import { createContext as N, useState as l, useEffect as g, useContext as f, useMemo as p } from "react";
6
+ class I {
7
7
  constructor() {
8
8
  c(this, "factories", /* @__PURE__ */ new Map());
9
9
  c(this, "instances", /* @__PURE__ */ new Map());
@@ -50,7 +50,7 @@ class N {
50
50
  this.factories.clear(), this.instances.clear();
51
51
  }
52
52
  }
53
- const v = "0.1.0", w = {
53
+ const w = "0.1.0", v = {
54
54
  Sales: "shopping-cart",
55
55
  Inventory: "package",
56
56
  HR: "users",
@@ -59,11 +59,11 @@ const v = "0.1.0", w = {
59
59
  Other: "folder"
60
60
  };
61
61
  function M() {
62
- const r = globalThis.__FRAMEWORK_M_PLUGIN_DEBUG__;
63
- if (typeof r == "boolean")
64
- return r;
65
- if (typeof r == "string")
66
- return ["1", "true", "yes", "on"].includes(r.toLowerCase());
62
+ const n = globalThis.__FRAMEWORK_M_PLUGIN_DEBUG__;
63
+ if (typeof n == "boolean")
64
+ return n;
65
+ if (typeof n == "string")
66
+ return ["1", "true", "yes", "on"].includes(n.toLowerCase());
67
67
  const e = globalThis.process;
68
68
  if (e != null && e.env) {
69
69
  const t = e.env.FRAMEWORK_M_PLUGIN_DEBUG;
@@ -72,16 +72,16 @@ function M() {
72
72
  }
73
73
  return !1;
74
74
  }
75
- const I = {
76
- debug(r, ...e) {
77
- M() && console.debug(`[PluginRegistry] ${r}`, ...e);
75
+ const R = {
76
+ debug(n, ...e) {
77
+ M() && console.debug(`[PluginRegistry] ${n}`, ...e);
78
78
  }
79
79
  };
80
- class R {
80
+ class k {
81
81
  constructor() {
82
82
  c(this, "plugins", /* @__PURE__ */ new Map());
83
83
  c(this, "menuCache", null);
84
- c(this, "serviceContainer", new N());
84
+ c(this, "serviceContainer", new I());
85
85
  c(this, "routeOwners", /* @__PURE__ */ new Map());
86
86
  c(this, "menuNameOwners", /* @__PURE__ */ new Map());
87
87
  c(this, "menuRouteOwners", /* @__PURE__ */ new Map());
@@ -120,10 +120,10 @@ class R {
120
120
  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;
121
121
  }
122
122
  s != null && s.onDestroy && s !== e && await Promise.resolve(s.onDestroy()), this.emit("plugin:registered", { plugin: e });
123
- const n = t.filter((o) => o.severity === "warning");
124
- n.length > 0 && I.debug(
123
+ const r = t.filter((o) => o.severity === "warning");
124
+ r.length > 0 && R.debug(
125
125
  `Registered plugin "${e.name}" with warnings`,
126
- n
126
+ r
127
127
  );
128
128
  }
129
129
  /**
@@ -245,7 +245,7 @@ class R {
245
245
  missingPeerPlugins: []
246
246
  };
247
247
  if (t.minSdkVersion && (i.sdkCompatible = this.checkSemverCompat(
248
- v,
248
+ w,
249
249
  t.minSdkVersion
250
250
  )), t.peerPlugins)
251
251
  for (const s of t.peerPlugins)
@@ -262,8 +262,8 @@ class R {
262
262
  * Checks if `current` satisfies `>=required`.
263
263
  */
264
264
  checkSemverCompat(e, t) {
265
- const i = t.replace(/^>=?/, ""), [s, n = 0, o = 0] = e.split(".").map(Number), [a, u = 0, m = 0] = i.split(".").map(Number);
266
- return s !== a ? s > a : n !== u ? n > u : o >= m;
265
+ const i = t.replace(/^>=?/, ""), [s, r = 0, o = 0] = e.split(".").map(Number), [a, u = 0, h = 0] = i.split(".").map(Number);
266
+ return s !== a ? s > a : r !== u ? r > u : o >= h;
267
267
  }
268
268
  validateRegistration(e) {
269
269
  return [
@@ -277,13 +277,13 @@ class R {
277
277
  validateSdkCompatibility(e) {
278
278
  const t = [];
279
279
  return e.minSdkVersion && (this.checkSemverCompat(
280
- v,
280
+ w,
281
281
  e.minSdkVersion
282
282
  ) || t.push(
283
283
  this.addDiagnostic({
284
284
  code: "SDK_INCOMPATIBLE",
285
285
  severity: "warning",
286
- message: `Plugin ${e.name} requires SDK >=${e.minSdkVersion}, current SDK is ${v}. Plugin may not work correctly.`,
286
+ message: `Plugin ${e.name} requires SDK >=${e.minSdkVersion}, current SDK is ${w}. Plugin may not work correctly.`,
287
287
  pluginName: e.name,
288
288
  key: e.minSdkVersion
289
289
  })
@@ -319,14 +319,14 @@ class R {
319
319
  continue;
320
320
  }
321
321
  i.add(s.path);
322
- const n = this.routeOwners.get(s.path);
323
- n && n !== e.name && t.push(
322
+ const r = this.routeOwners.get(s.path);
323
+ r && r !== e.name && t.push(
324
324
  this.addDiagnostic({
325
325
  code: "ROUTE_COLLISION",
326
326
  severity: "error",
327
- message: `Route path "${s.path}" from plugin ${e.name} conflicts with plugin ${n}`,
327
+ message: `Route path "${s.path}" from plugin ${e.name} conflicts with plugin ${r}`,
328
328
  pluginName: e.name,
329
- conflictingPluginName: n,
329
+ conflictingPluginName: r,
330
330
  key: s.path
331
331
  })
332
332
  );
@@ -335,54 +335,54 @@ class R {
335
335
  }
336
336
  validateMenuCollisions(e) {
337
337
  const t = [], i = /* @__PURE__ */ new Set(), s = /* @__PURE__ */ new Set();
338
- for (const n of e.menu ?? []) {
339
- if (i.has(n.name))
338
+ for (const r of e.menu ?? []) {
339
+ if (i.has(r.name))
340
340
  t.push(
341
341
  this.addDiagnostic({
342
342
  code: "MENU_NAME_COLLISION",
343
343
  severity: "error",
344
- message: `Duplicate menu name "${n.name}" inside plugin ${e.name}`,
344
+ message: `Duplicate menu name "${r.name}" inside plugin ${e.name}`,
345
345
  pluginName: e.name,
346
346
  conflictingPluginName: e.name,
347
- key: n.name
347
+ key: r.name
348
348
  })
349
349
  );
350
350
  else {
351
- i.add(n.name);
352
- const o = this.menuNameOwners.get(n.name);
351
+ i.add(r.name);
352
+ const o = this.menuNameOwners.get(r.name);
353
353
  o && o !== e.name && t.push(
354
354
  this.addDiagnostic({
355
355
  code: "MENU_NAME_COLLISION",
356
356
  severity: "error",
357
- message: `Menu name "${n.name}" from plugin ${e.name} conflicts with plugin ${o}`,
357
+ message: `Menu name "${r.name}" from plugin ${e.name} conflicts with plugin ${o}`,
358
358
  pluginName: e.name,
359
359
  conflictingPluginName: o,
360
- key: n.name
360
+ key: r.name
361
361
  })
362
362
  );
363
363
  }
364
- if (s.has(n.route))
364
+ if (s.has(r.route))
365
365
  t.push(
366
366
  this.addDiagnostic({
367
367
  code: "MENU_ROUTE_COLLISION",
368
368
  severity: "error",
369
- message: `Duplicate menu route "${n.route}" inside plugin ${e.name}`,
369
+ message: `Duplicate menu route "${r.route}" inside plugin ${e.name}`,
370
370
  pluginName: e.name,
371
371
  conflictingPluginName: e.name,
372
- key: n.route
372
+ key: r.route
373
373
  })
374
374
  );
375
375
  else {
376
- s.add(n.route);
377
- const o = this.menuRouteOwners.get(n.route);
376
+ s.add(r.route);
377
+ const o = this.menuRouteOwners.get(r.route);
378
378
  o && o !== e.name && t.push(
379
379
  this.addDiagnostic({
380
380
  code: "MENU_ROUTE_COLLISION",
381
381
  severity: "error",
382
- message: `Menu route "${n.route}" from plugin ${e.name} conflicts with plugin ${o}`,
382
+ message: `Menu route "${r.route}" from plugin ${e.name} conflicts with plugin ${o}`,
383
383
  pluginName: e.name,
384
384
  conflictingPluginName: o,
385
- key: n.route
385
+ key: r.route
386
386
  })
387
387
  );
388
388
  }
@@ -406,14 +406,14 @@ class R {
406
406
  continue;
407
407
  }
408
408
  i.add(s);
409
- const n = this.serviceOwners.get(s);
410
- n && n !== e.name && t.push(
409
+ const r = this.serviceOwners.get(s);
410
+ r && r !== e.name && t.push(
411
411
  this.addDiagnostic({
412
412
  code: "SERVICE_COLLISION",
413
413
  severity: "error",
414
- message: `Service "${s}" from plugin ${e.name} conflicts with plugin ${n}`,
414
+ message: `Service "${s}" from plugin ${e.name} conflicts with plugin ${r}`,
415
415
  pluginName: e.name,
416
- conflictingPluginName: n,
416
+ conflictingPluginName: r,
417
417
  key: s
418
418
  })
419
419
  );
@@ -437,16 +437,16 @@ class R {
437
437
  var i;
438
438
  const t = /* @__PURE__ */ new Map();
439
439
  for (const s of e) {
440
- const n = s.module || "Other";
441
- t.has(n) || t.set(n, {
442
- name: n.toLowerCase(),
443
- label: n,
444
- route: `/${n.toLowerCase()}`,
445
- icon: this.getModuleIcon(n),
440
+ const r = s.module || "Other";
441
+ t.has(r) || t.set(r, {
442
+ name: r.toLowerCase(),
443
+ label: r,
444
+ route: `/${r.toLowerCase()}`,
445
+ icon: this.getModuleIcon(r),
446
446
  order: s.order,
447
447
  children: []
448
448
  });
449
- const o = t.get(n);
449
+ const o = t.get(r);
450
450
  if (s.order !== void 0 && (o.order === void 0 || s.order < o.order) && (o.order = s.order), s.category) {
451
451
  let a = (i = o.children) == null ? void 0 : i.find(
452
452
  (u) => u.label === s.category
@@ -454,18 +454,18 @@ class R {
454
454
  a || (a = {
455
455
  name: s.category.toLowerCase(),
456
456
  label: s.category,
457
- route: `/${n.toLowerCase()}/${s.category.toLowerCase()}`,
457
+ route: `/${r.toLowerCase()}/${s.category.toLowerCase()}`,
458
458
  children: []
459
459
  }, o.children.push(a)), a.children.push(s);
460
460
  } else
461
461
  o.children.push(s);
462
462
  }
463
463
  return Array.from(t.values()).sort(
464
- (s, n) => (s.order ?? 999) - (n.order ?? 999)
464
+ (s, r) => (s.order ?? 999) - (r.order ?? 999)
465
465
  );
466
466
  }
467
467
  getModuleIcon(e) {
468
- return w[e] || w.Other;
468
+ return v[e] || v.Other;
469
469
  }
470
470
  rebuildIndexesAndServices() {
471
471
  this.routeOwners.clear(), this.menuNameOwners.clear(), this.menuRouteOwners.clear(), this.serviceOwners.clear(), this.serviceContainer.clear();
@@ -489,21 +489,21 @@ class R {
489
489
  i(t);
490
490
  }
491
491
  }
492
- const h = O(null);
492
+ const d = N(null);
493
493
  function b({
494
- children: r,
494
+ children: n,
495
495
  registry: e
496
496
  }) {
497
497
  const [t] = l(
498
- () => e ?? new R()
498
+ () => e ?? new k()
499
499
  ), [i, s] = l(!1);
500
- return d(() => {
500
+ return g(() => {
501
501
  s(!0);
502
- }, []), i ? /* @__PURE__ */ S(h.Provider, { value: t, children: r }) : null;
502
+ }, []), i ? /* @__PURE__ */ O(d.Provider, { value: t, children: n }) : null;
503
503
  }
504
- async function y(r, e) {
504
+ async function y(n, e) {
505
505
  const t = [];
506
- for (const i of r) {
506
+ for (const i of n) {
507
507
  if (i.hidden || i.permissions && i.permissions.length > 0 && !await Promise.resolve(e(i.permissions)))
508
508
  continue;
509
509
  const s = i.children ? await y(i.children, e) : void 0;
@@ -511,84 +511,121 @@ async function y(r, e) {
511
511
  }
512
512
  return t;
513
513
  }
514
- function $() {
515
- const r = f(h), [e, t] = l([]);
516
- if (!r)
514
+ function _() {
515
+ const n = f(d), [e, t] = l([]);
516
+ if (!n)
517
517
  throw new Error("usePluginMenu must be used within PluginRegistryProvider");
518
- return d(() => {
518
+ return g(() => {
519
519
  let i = !1;
520
520
  return (async () => {
521
- const n = r.getMenu(), o = r.getPermissionChecker();
521
+ const r = n.getMenu(), o = n.getPermissionChecker();
522
522
  if (!o) {
523
- i || t(n.filter((u) => !u.hidden));
523
+ i || t(r.filter((u) => !u.hidden));
524
524
  return;
525
525
  }
526
- const a = await y(n, o);
526
+ const a = await y(r, o);
527
527
  i || t(a);
528
528
  })(), () => {
529
529
  i = !0;
530
530
  };
531
- }, [r]), e;
531
+ }, [n]), e;
532
532
  }
533
- function _(r) {
534
- const e = f(h);
533
+ function U(n) {
534
+ const e = f(d);
535
535
  if (!e)
536
536
  throw new Error("usePlugin must be used within PluginRegistryProvider");
537
- return p(() => e.getPlugin(r), [e, r]);
537
+ return p(() => e.getPlugin(n), [e, n]);
538
538
  }
539
- function A(r) {
540
- const e = f(h);
539
+ function A(n) {
540
+ const e = f(d);
541
541
  if (!e)
542
542
  throw new Error("useService must be used within PluginRegistryProvider");
543
- const [t, i] = l(null), [s, n] = l(!0), [o, a] = l(null), u = p(
544
- () => e.getService(r),
545
- [e, r]
543
+ const [t, i] = l(null), [s, r] = l(!0), [o, a] = l(null), u = p(
544
+ () => e.getService(n),
545
+ [e, n]
546
546
  );
547
- return d(() => {
548
- let m = !1;
549
- return n(!0), a(null), u.then((g) => {
550
- m || (i(g), n(!1));
551
- }).catch((g) => {
552
- m || (a(g instanceof Error ? g : new Error(String(g))), n(!1));
547
+ return g(() => {
548
+ let h = !1;
549
+ return r(!0), a(null), u.then((m) => {
550
+ h || (i(m), r(!1));
551
+ }).catch((m) => {
552
+ h || (a(m instanceof Error ? m : new Error(String(m))), r(!1));
553
553
  }), () => {
554
- m = !0;
554
+ h = !0;
555
555
  };
556
556
  }, [u]), { service: t, isLoading: s, error: o };
557
557
  }
558
- async function k(r, e) {
558
+ async function E(n, e) {
559
559
  const t = [];
560
- for (const i of r)
560
+ for (const i of n)
561
561
  i.permissions && i.permissions.length > 0 && !await Promise.resolve(e(i.permissions)) || t.push(i);
562
562
  return t;
563
563
  }
564
- function U() {
565
- const r = f(h), [e, t] = l([]);
566
- if (!r)
564
+ function x() {
565
+ const n = f(d), [e, t] = l([]);
566
+ if (!n)
567
567
  throw new Error("useWidgets must be used within PluginRegistryProvider");
568
- return d(() => {
568
+ return g(() => {
569
569
  let i = !1;
570
570
  return (async () => {
571
- const n = r.getWidgets(), o = r.getPermissionChecker();
571
+ const r = n.getWidgets(), o = n.getPermissionChecker();
572
572
  if (!o) {
573
- i || t(n);
573
+ i || t(r);
574
574
  return;
575
575
  }
576
- const a = await k(n, o);
576
+ const a = await E(r, o);
577
577
  i || t(a);
578
578
  })(), () => {
579
579
  i = !0;
580
580
  };
581
- }, [r]), e;
581
+ }, [n]), e;
582
582
  }
583
+ const P = {
584
+ apiUrl: "/api/v1/frontend/remotes",
585
+ shareScope: "default"
586
+ }, T = async (n) => {
587
+ const e = (n == null ? void 0 : n.apiUrl) ?? P.apiUrl;
588
+ try {
589
+ const t = await fetch(e);
590
+ if (!t.ok)
591
+ throw new Error(`Failed to fetch remotes: ${t.status}`);
592
+ return await t.json();
593
+ } catch (t) {
594
+ throw console.error("Error fetching remotes:", t), t;
595
+ }
596
+ }, V = (n) => {
597
+ const e = document.createElement("script");
598
+ e.src = n, e.async = !0, document.body.appendChild(e);
599
+ }, F = async (n, e) => {
600
+ const t = (e == null ? void 0 : e.shareScope) ?? P.shareScope;
601
+ return new Promise((i, s) => {
602
+ const r = setInterval(() => {
603
+ const o = window;
604
+ if (o[n]) {
605
+ clearInterval(r);
606
+ try {
607
+ o[n].init({
608
+ shareScope: t
609
+ }), i();
610
+ } catch (a) {
611
+ console.error(`Failed to initialize remote module ${n}:`, a), s(a);
612
+ }
613
+ }
614
+ }, 50);
615
+ });
616
+ };
583
617
  export {
584
- R as PluginRegistry,
585
- h as PluginRegistryContext,
618
+ k as PluginRegistry,
619
+ d as PluginRegistryContext,
586
620
  b as PluginRegistryProvider,
587
- v as SDK_VERSION,
588
- N as ServiceContainer,
589
- _ as usePlugin,
590
- $ as usePluginMenu,
621
+ w as SDK_VERSION,
622
+ I as ServiceContainer,
623
+ T as fetchRemotes,
624
+ F as initializeRemote,
625
+ V as loadRemoteScript,
626
+ U as usePlugin,
627
+ _ as usePluginMenu,
591
628
  A as useService,
592
- U as useWidgets
629
+ x as useWidgets
593
630
  };
594
631
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
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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"}
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","../src/loader/federation.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","export interface RemoteModule {\n init: (args: { shareScope: string }) => void;\n}\n\nexport interface FederationOptions {\n /** Discovery API URL, defaults to /api/v1/frontend/remotes */\n apiUrl?: string;\n /** Share scope for federation, defaults to 'default' */\n shareScope?: string;\n}\n\nconst DEFAULT_OPTIONS: FederationOptions = {\n apiUrl: \"/api/v1/frontend/remotes\",\n shareScope: \"default\",\n};\n\n/**\n * Fetch remote plugin definitions from the backend discovery API.\n */\nexport const fetchRemotes = async (options?: FederationOptions): Promise<Record<string, string>> => {\n const apiUrl = options?.apiUrl ?? DEFAULT_OPTIONS.apiUrl!;\n try {\n const response = await fetch(apiUrl);\n if (!response.ok) {\n throw new Error(`Failed to fetch remotes: ${response.status}`);\n }\n return await response.json();\n } catch (error: unknown) {\n console.error('Error fetching remotes:', error);\n throw error;\n }\n};\n\n/**\n * Dynamically load a remote script into the browser runtime.\n */\nexport const loadRemoteScript = (remoteUrl: string): void => {\n const script = document.createElement('script');\n script.src = remoteUrl;\n script.async = true;\n document.body.appendChild(script);\n};\n\n/**\n * Initialize a federated remote module on the global window scope.\n */\nexport const initializeRemote = async (scope: string, options?: FederationOptions): Promise<void> => {\n const shareScope = options?.shareScope ?? DEFAULT_OPTIONS.shareScope!;\n \n return new Promise((resolve, reject) => {\n interface WindowWithRemote {\n [key: string]: {\n init: (args: { shareScope: string }) => void;\n } | undefined;\n }\n \n const checkInterval = setInterval(() => {\n const w = window as unknown as WindowWithRemote;\n if (w[scope]) {\n clearInterval(checkInterval);\n try {\n w[scope]!.init({\n shareScope,\n });\n resolve();\n } catch (error: unknown) {\n console.error(`Failed to initialize remote module ${scope}:`, error);\n reject(error);\n }\n }\n }, 50);\n });\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","DEFAULT_OPTIONS","fetchRemotes","options","apiUrl","response","loadRemoteScript","remoteUrl","script","initializeRemote","scope","shareScope","resolve","reject","checkInterval","w"],"mappings":"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"}
package/dist/loader/federation.d.ts ADDED
@@ -0,0 +1,24 @@
1
+ export interface RemoteModule {
2
+ init: (args: {
3
+ shareScope: string;
4
+ }) => void;
5
+ }
6
+ export interface FederationOptions {
7
+ /** Discovery API URL, defaults to /api/v1/frontend/remotes */
8
+ apiUrl?: string;
9
+ /** Share scope for federation, defaults to 'default' */
10
+ shareScope?: string;
11
+ }
12
+ /**
13
+ * Fetch remote plugin definitions from the backend discovery API.
14
+ */
15
+ export declare const fetchRemotes: (options?: FederationOptions) => Promise<Record<string, string>>;
16
+ /**
17
+ * Dynamically load a remote script into the browser runtime.
18
+ */
19
+ export declare const loadRemoteScript: (remoteUrl: string) => void;
20
+ /**
21
+ * Initialize a federated remote module on the global window scope.
22
+ */
23
+ export declare const initializeRemote: (scope: string, options?: FederationOptions) => Promise<void>;
24
+ //# sourceMappingURL=federation.d.ts.map
package/dist/loader/federation.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../../src/loader/federation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;GAEG;AACH,eAAO,MAAM,YAAY,GAAU,UAAU,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY9F,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,IAKpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAU,OAAO,MAAM,EAAE,UAAU,iBAAiB,KAAG,OAAO,CAAC,IAAI,CA0B/F,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@framework-m/plugin-sdk",
3
- "version": "0.2.9",
3
+ "version": "0.3.0",
4
4
  "description": "Plugin infrastructure and runtime for Framework M multi-app composition",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -32,7 +32,7 @@
32
32
  "directory": "libs/framework-m-plugin-sdk"
33
33
  },
34
34
  "peerDependencies": {
35
- "@framework-m/desk": "^0.6.0",
35
+ "@framework-m/desk": "^0.6.2",
36
36
  "react": "^19.0.0"
37
37
  },
38
38
  "dependencies": {