@kosdev-code/kos-ui-plugin 2.0.1 → 2.0.19

package/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("./emotion-react-jsx-runtime.browser.esm-UFFvJLiS.cjs"),u=require("@emotion/styled"),p=require("@kosdev-code/kos-ui-sdk"),s=require("react"),f=require("./plugin-extension-manager-D9aw-mUM.cjs");require("react/jsx-runtime");const d=s.createContext(void 0),b=u.div`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("./emotion-react-jsx-runtime.browser.esm-UFFvJLiS.cjs"),d=require("@emotion/styled"),v=require("@kosdev-code/kos-ui-sdk"),i=require("react"),a=require("./resolve-best-extension-D5Ord7XK.cjs");require("react/jsx-runtime");const h=i.createContext(void 0),P=d.div`
   padding-inline: 20px;
   width: 100%;
   height: 100vh;
@@ -11,19 +11,19 @@
   top: 0;
   left: 0;
   z-index: 10000;
-`,R=({remotesOverride:n,children:e})=>{const[t,c]=s.useState();return s.useEffect(()=>{f.initPluginManager(n).then(o=>{c(o)})},[n]),l.jsx(d.Provider,{value:t,children:t?e:l.jsx(b,{children:"Loading remote plugins..."})})},x=()=>{const n=s.useContext(d);if(!n)throw new Error("useKosPluginsContext must be used within a KosPluginProvider");return n},S=n=>{var e;return((e=n==null?void 0:n.view)==null?void 0:e.component)!==void 0},K=n=>n.sort((e,t)=>{const c=e.rank||0,o=t.rank||0;return c===o?(p.KosLog.info(`found same rank for extension ${e.id} and ${t.id} using id to sort`),e.id.localeCompare(t.id)):c-o}),C=({extension:n,module:e})=>{const{extensions:t}=x(),[c,o]=s.useState(null),[r,a]=s.useState(null);return s.useEffect(()=>{async function y(){var g,h;const P=K(Object.values((t==null?void 0:t[n])??{})),v=e??((g=P[0])==null?void 0:g.id)??"",i=(h=t==null?void 0:t[n])==null?void 0:h[v];a(i??null);const k=(i==null?void 0:i.remote)||"",m=S(i)?i.view.component:i==null?void 0:i.component,w=m?`./${m}`:"",j=s.lazy(()=>f.mf.loadRemoteModule(k,w));o(j)}y()},[t,e,n]),[c,r]},M=u.div`
+`,w=({remotesOverride:e,children:t})=>{const[n,l]=i.useState();return i.useEffect(()=>{a.initPluginManager(e).then(r=>{l(r)})},[e]),c.jsx(h.Provider,{value:n,children:n?t:c.jsx(P,{children:"Loading remote plugins..."})})},p=()=>{const e=i.useContext(h);if(!e)throw new Error("useKosPluginsContext must be used within a KosPluginProvider");return e},j=e=>{var t;return((t=e==null?void 0:e.view)==null?void 0:t.component)!==void 0},x=({extension:e,module:t})=>{const{extensions:n}=p(),[l,r]=i.useState(null),[s,u]=i.useState(null);return i.useEffect(()=>{async function g(){const o=a.resolveBestExtension(n==null?void 0:n[e],t);u(o??null);const f=(o==null?void 0:o.remote)||"",m=j(o)?o.view.component:o==null?void 0:o.component,C=m?`./${m}`:"",y=i.lazy(()=>a.mf.loadRemoteModule(f,C));r(y)}g()},[n,t,e]),[l,s]},b=d.div`
   align-items: center;
   display: flex;
   height: 100%;
   justify-content: center;
   width: 100%;
-`,q=u.div`
+`,S=d.div`
   align-items: center;
   background-color: transparent;
   display: flex;
   flex-direction: column;
-  height: ${n=>n.height};
+  height: ${e=>e.height};
   justify-content: center;
-  width: ${n=>n.width};
-`,z=({extension:n,fallback:e,module:t,props:c})=>{const[o,r]=C({extension:n,module:t});if(!o)return null;const a=e||l.jsx(M,{children:`Dynamic component, ${n}, not found...`});return l.jsx(p.ErrorBoundaryWithFallback,{fallback:a,children:l.jsx(s.Suspense,{fallback:r!=null&&r.size?l.jsx(q,{width:r.size.width,height:r.size.height}):null,children:l.jsx(o,{...c})})})};exports.DynamicComponent=z;exports.KosPluginProvider=R;exports.RemotesContext=d;exports.useDynamicComponent=C;exports.useKosPluginsContext=x;
+  width: ${e=>e.width};
+`,k=({extension:e,fallback:t,module:n,props:l})=>{const[r,s]=x({extension:e,module:n});if(!r)return null;const u=t||c.jsx(b,{children:`Dynamic component, ${e}, not found...`});return c.jsx(v.ErrorBoundaryWithFallback,{fallback:u,children:c.jsx(i.Suspense,{fallback:s!=null&&s.size?c.jsx(S,{width:s.size.width,height:s.size.height}):null,children:c.jsx(r,{...l})})})};exports.DynamicComponent=k;exports.KosPluginProvider=w;exports.RemotesContext=h;exports.useDynamicComponent=x;exports.useKosPluginsContext=p;
 //# sourceMappingURL=index.cjs.map

package/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../../packages/sdk/kos-ui-plugin/src/lib/contexts/plugins-provider/plugins-provider.tsx","../../../../packages/sdk/kos-ui-plugin/src/lib/hooks/use-dynamic-component.tsx","../../../../packages/sdk/kos-ui-plugin/src/lib/components/dynamic-component/dynamic-component.tsx"],"sourcesContent":["/**\n *\n *\n * @module remotes-provider\n * @description Provides a context for managing dynamic remotes and extensions in a React application.\n */\n\nimport styled from \"@emotion/styled\";\nimport {\n  PropsWithChildren,\n  createContext,\n  useContext,\n  useEffect,\n  useState,\n} from \"react\";\nimport type { DynamicRemotes } from \"../../../types/global\";\nimport type { PluginExtension } from \"../../../types/plugins\";\nimport { initPluginManager } from \"../../utils/plugin-extension-manager\";\n\ninterface PluginsType {\n  remotes?: DynamicRemotes;\n  extensions?: PluginExtensionsType;\n  extensionPoints?: Record<string, PluginExtension[]>;\n  getExtensions: (extensionPointId: string) => PluginExtension[];\n}\n\nexport interface PluginExtensionsType {\n  [k: string]: {\n    [k: string]: PluginExtension;\n  };\n}\n\n/**\n * The context for managing dynamic remotes and extensions.\n */\nexport const RemotesContext = createContext<PluginsType | undefined>(undefined);\n\ninterface Props {\n  remotesOverride?: DynamicRemotes;\n}\n\nconst MessageContainer = styled.div`\n  padding-inline: 20px;\n  width: 100%;\n  height: 100vh;\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  position: fixed;\n  font-size: 14px;\n  top: 0;\n  left: 0;\n  z-index: 10000;\n`;\n/**\n * The provider component for the RemotesContext.\n */\nexport const KosPluginProvider: React.FunctionComponent<\n  PropsWithChildren<Props>\n> = ({ remotesOverride, children }) => {\n  const [contextValue, setContextValue] = useState<PluginsType | undefined>();\n\n  useEffect(() => {\n    initPluginManager(remotesOverride).then((value) => {\n      setContextValue(value);\n    });\n  }, [remotesOverride]);\n\n  return (\n    <RemotesContext.Provider value={contextValue}>\n      {contextValue ? (\n        children\n      ) : (\n        <MessageContainer>Loading remote plugins...</MessageContainer>\n      )}\n    </RemotesContext.Provider>\n  );\n};\n\n/**\n * Custom hook for accessing the RemotesContext.\n */\nexport const useKosPluginsContext = () => {\n  const context = useContext(RemotesContext);\n  if (!context) {\n    throw new Error(\n      \"useKosPluginsContext must be used within a KosPluginProvider\"\n    );\n  }\n  return context;\n};\n","import { KosLog } from \"@kosdev-code/kos-ui-sdk\";\nimport { loadRemoteModule } from \"@nx/react/mf\";\n\nimport React, { useEffect, useState } from \"react\";\nimport type {\n  BasePluginExtension,\n  BaseViewPluginExtension,\n} from \"../../types/plugins\";\nimport { useKosPluginsContext } from \"../contexts\";\n\ninterface Props {\n  extension: string;\n  module?: string;\n}\n\nconst isViewPlugin = (module: any): module is BaseViewPluginExtension =>\n  module?.view?.component !== undefined;\n\nconst sortModulesByRank = (modules: any[]) =>\n  modules.sort((a, b) => {\n    const aRank = a.rank || 0;\n    const bRank = b.rank || 0;\n    if (aRank === bRank) {\n      KosLog.info(\n        `found same rank for extension ${a.id} and ${b.id} using id to sort`\n      );\n      return a.id.localeCompare(b.id);\n    }\n    return aRank - bRank;\n  });\n\ntype DynamicComponentResult = [\n  React.FunctionComponent | null,\n  BasePluginExtension | null\n];\nexport const useDynamicComponent = ({\n  extension,\n  module,\n}: Props): DynamicComponentResult => {\n  const { extensions } = useKosPluginsContext();\n  const [Component, setComponent] = useState<React.FunctionComponent | null>(\n    null\n  );\n\n  const [extensionPoint, setExtensionPoint] =\n    useState<BasePluginExtension | null>(null);\n\n  useEffect(() => {\n    async function loadComponent() {\n      const allModules = sortModulesByRank(\n        Object.values(extensions?.[extension] ?? {})\n      );\n\n      const moduleId = module ?? allModules[0]?.id ?? \"\";\n      const _module = extensions?.[extension]?.[moduleId];\n      setExtensionPoint(_module ?? null);\n      const remote = _module?.remote || \"\";\n\n      const componentName = isViewPlugin(_module)\n        ? _module.view.component\n        : _module?.component;\n\n      const componentPath = componentName ? `./${componentName}` : \"\";\n\n      const Comp = React.lazy(() => loadRemoteModule(remote, componentPath));\n\n      setComponent(Comp);\n    }\n    loadComponent();\n  }, [extensions, module, extension]);\n\n  return [Component, extensionPoint];\n};\n","import styled from \"@emotion/styled\";\nimport { ErrorBoundaryWithFallback } from \"@kosdev-code/kos-ui-sdk\";\nimport React, { Suspense } from \"react\";\nimport { useDynamicComponent } from \"../../hooks\";\n\nconst NotFound = styled.div`\n  align-items: center;\n  display: flex;\n  height: 100%;\n  justify-content: center;\n  width: 100%;\n`;\ninterface Props {\n  extension: string;\n  fallback?: React.ReactNode;\n  module?: string;\n  props?: any;\n}\n\nconst Skeleton = styled.div<{ width: string; height: string }>`\n  align-items: center;\n  background-color: transparent;\n  display: flex;\n  flex-direction: column;\n  height: ${(props) => props.height};\n  justify-content: center;\n  width: ${(props) => props.width};\n`;\n\nexport const DynamicComponent: React.FunctionComponent<Props> = ({\n  extension,\n  fallback,\n  module,\n  props,\n}) => {\n  // get the list of extensions from the context\n  const [Component, extensionPoint] = useDynamicComponent({\n    extension,\n    module,\n  });\n  // get the module from the extension\n\n  if (!Component) {\n    return null;\n  }\n\n  const fb = fallback || (\n    <NotFound>{`Dynamic component, ${extension}, not found...`}</NotFound>\n  );\n\n  return (\n    <ErrorBoundaryWithFallback fallback={fb}>\n      <Suspense\n        fallback={\n          extensionPoint?.size ? (\n            <Skeleton\n              width={extensionPoint.size.width}\n              height={extensionPoint.size.height}\n            />\n          ) : null\n        }\n      >\n        <Component {...props} />\n      </Suspense>\n    </ErrorBoundaryWithFallback>\n  );\n};\n"],"names":["RemotesContext","createContext","MessageContainer","styled","KosPluginProvider","remotesOverride","children","contextValue","setContextValue","useState","useEffect","initPluginManager","value","jsx","useKosPluginsContext","context","useContext","isViewPlugin","module","_a","sortModulesByRank","modules","a","b","aRank","bRank","KosLog","useDynamicComponent","extension","extensions","Component","setComponent","extensionPoint","setExtensionPoint","loadComponent","allModules","moduleId","_module","_b","remote","componentName","componentPath","Comp","React","loadRemoteModule","NotFound","Skeleton","props","DynamicComponent","fallback","fb","ErrorBoundaryWithFallback","Suspense"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../../../packages/sdk/kos-ui-plugin/src/lib/contexts/plugins-provider/plugins-provider.tsx","../../../../packages/sdk/kos-ui-plugin/src/lib/hooks/use-dynamic-component.tsx","../../../../packages/sdk/kos-ui-plugin/src/lib/components/dynamic-component/dynamic-component.tsx"],"sourcesContent":["/**\n *\n *\n * @module remotes-provider\n * @description Provides a context for managing dynamic remotes and extensions in a React application.\n */\n\nimport styled from \"@emotion/styled\";\nimport {\n  PropsWithChildren,\n  createContext,\n  useContext,\n  useEffect,\n  useState,\n} from \"react\";\nimport type { DynamicRemotes } from \"../../../types/global\";\nimport type { PluginExtension } from \"../../../types/plugins\";\nimport { initPluginManager } from \"../../utils/plugin-extension-manager\";\n\ninterface PluginsType {\n  remotes?: DynamicRemotes;\n  extensions?: PluginExtensionsType;\n  extensionPoints?: Record<string, PluginExtension[]>;\n  getExtensions: (extensionPointId: string) => PluginExtension[];\n}\n\nexport interface PluginExtensionsType {\n  [k: string]: {\n    [k: string]: PluginExtension;\n  };\n}\n\n/**\n * The context for managing dynamic remotes and extensions.\n */\nexport const RemotesContext = createContext<PluginsType | undefined>(undefined);\n\ninterface Props {\n  remotesOverride?: DynamicRemotes;\n}\n\nconst MessageContainer = styled.div`\n  padding-inline: 20px;\n  width: 100%;\n  height: 100vh;\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  position: fixed;\n  font-size: 14px;\n  top: 0;\n  left: 0;\n  z-index: 10000;\n`;\n/**\n * The provider component for the RemotesContext.\n */\nexport const KosPluginProvider: React.FunctionComponent<\n  PropsWithChildren<Props>\n> = ({ remotesOverride, children }) => {\n  const [contextValue, setContextValue] = useState<PluginsType | undefined>();\n\n  useEffect(() => {\n    initPluginManager(remotesOverride).then((value) => {\n      setContextValue(value);\n    });\n  }, [remotesOverride]);\n\n  return (\n    <RemotesContext.Provider value={contextValue}>\n      {contextValue ? (\n        children\n      ) : (\n        <MessageContainer>Loading remote plugins...</MessageContainer>\n      )}\n    </RemotesContext.Provider>\n  );\n};\n\n/**\n * Custom hook for accessing the RemotesContext.\n */\nexport const useKosPluginsContext = () => {\n  const context = useContext(RemotesContext);\n  if (!context) {\n    throw new Error(\n      \"useKosPluginsContext must be used within a KosPluginProvider\"\n    );\n  }\n  return context;\n};\n","import { loadRemoteModule } from \"@nx/react/mf\";\n\nimport React, { useEffect, useState } from \"react\";\nimport type {\n  BasePluginExtension,\n  BaseViewPluginExtension,\n} from \"../../types/plugins\";\nimport { useKosPluginsContext } from \"../contexts\";\nimport { resolveBestExtension } from \"../utils/resolve-best-extension\";\n\ninterface Props {\n  /**\n   * The extension point ID to resolve plugin modules from.\n   * Example: \"ddk.ncui.settings.tabView\"\n   */\n  extension: string;\n\n  /**\n   * Optional module ID to load a specific plugin.\n   * If not provided, the plugin with the **lowest rank** for the extension point is used.\n   */\n  module?: string;\n}\n\ntype DynamicComponentResult = [\n  React.FunctionComponent | null,\n  BasePluginExtension | null\n];\n\n/**\n * Determines whether a plugin extension follows the \"view\" structure.\n * This allows resolving the correct field (`view.component` vs `component`) when loading.\n */\nconst isViewPlugin = (module: any): module is BaseViewPluginExtension =>\n  module?.view?.component !== undefined;\n\n/**\n * React hook to resolve and lazily load a plugin component for a given extension point.\n *\n * - If `module` is provided, it directly loads that plugin.\n * - If `module` is not provided, it uses the **lowest-ranked plugin** from the extension point.\n * - Supports both standard plugins (`component`) and view-style plugins (`view.component`)\n * - Uses React.lazy + Module Federation to dynamically import the remote component.\n *\n * @param props.extension The extension point to resolve plugins from\n * @param props.module (Optional) Specific module ID to use, otherwise the highest-priority plugin is loaded\n * @returns A tuple: `[Component, PluginExtension]`\n */\nexport const useDynamicComponent = ({\n  extension,\n  module,\n}: Props): DynamicComponentResult => {\n  const { extensions } = useKosPluginsContext();\n\n  const [Component, setComponent] = useState<React.FunctionComponent | null>(\n    null\n  );\n  const [extensionPoint, setExtensionPoint] =\n    useState<BasePluginExtension | null>(null);\n\n  useEffect(() => {\n    async function loadComponent() {\n      // Determine which plugin to use\n\n      const _module = resolveBestExtension(extensions?.[extension], module);\n\n      setExtensionPoint(_module ?? null);\n\n      const remote = _module?.remote || \"\";\n\n      // Resolve the component path for the module\n      const componentName = isViewPlugin(_module)\n        ? _module.view.component\n        : _module?.component;\n\n      const componentPath = componentName ? `./${componentName}` : \"\";\n\n      // Load the component using Module Federation\n      const Comp = React.lazy(() => loadRemoteModule(remote, componentPath));\n      setComponent(Comp);\n    }\n\n    loadComponent();\n  }, [extensions, module, extension]);\n\n  return [Component, extensionPoint];\n};\n","import styled from \"@emotion/styled\";\nimport { ErrorBoundaryWithFallback } from \"@kosdev-code/kos-ui-sdk\";\nimport React, { Suspense } from \"react\";\nimport { useDynamicComponent } from \"../../hooks\";\n\nconst NotFound = styled.div`\n  align-items: center;\n  display: flex;\n  height: 100%;\n  justify-content: center;\n  width: 100%;\n`;\ninterface Props {\n  extension: string;\n  fallback?: React.ReactNode;\n  module?: string;\n  props?: any;\n}\n\nconst Skeleton = styled.div<{ width: string; height: string }>`\n  align-items: center;\n  background-color: transparent;\n  display: flex;\n  flex-direction: column;\n  height: ${(props) => props.height};\n  justify-content: center;\n  width: ${(props) => props.width};\n`;\n\nexport const DynamicComponent: React.FunctionComponent<Props> = ({\n  extension,\n  fallback,\n  module,\n  props,\n}) => {\n  // get the list of extensions from the context\n  const [Component, extensionPoint] = useDynamicComponent({\n    extension,\n    module,\n  });\n  // get the module from the extension\n\n  if (!Component) {\n    return null;\n  }\n\n  const fb = fallback || (\n    <NotFound>{`Dynamic component, ${extension}, not found...`}</NotFound>\n  );\n\n  return (\n    <ErrorBoundaryWithFallback fallback={fb}>\n      <Suspense\n        fallback={\n          extensionPoint?.size ? (\n            <Skeleton\n              width={extensionPoint.size.width}\n              height={extensionPoint.size.height}\n            />\n          ) : null\n        }\n      >\n        <Component {...props} />\n      </Suspense>\n    </ErrorBoundaryWithFallback>\n  );\n};\n"],"names":["RemotesContext","createContext","MessageContainer","styled","KosPluginProvider","remotesOverride","children","contextValue","setContextValue","useState","useEffect","initPluginManager","value","jsx","useKosPluginsContext","context","useContext","isViewPlugin","module","_a","useDynamicComponent","extension","extensions","Component","setComponent","extensionPoint","setExtensionPoint","loadComponent","_module","resolveBestExtension","remote","componentName","componentPath","Comp","React","loadRemoteModule","NotFound","Skeleton","props","DynamicComponent","fallback","fb","ErrorBoundaryWithFallback","Suspense"],"mappings":"6TAmCa,MAAAA,EAAiBC,EAAAA,cAAuC,MAAS,EAMxEC,EAAmBC,EAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBnBC,EAET,CAAC,CAAE,gBAAAC,EAAiB,SAAAC,KAAe,CACrC,KAAM,CAACC,EAAcC,CAAe,EAAIC,EAAkC,SAAA,EAE1EC,OAAAA,EAAAA,UAAU,IAAM,CACdC,EAAAA,kBAAkBN,CAAe,EAAE,KAAMO,GAAU,CACjDJ,EAAgBI,CAAK,CAAA,CACtB,CAAA,EACA,CAACP,CAAe,CAAC,EAGlBQ,EAAAA,IAACb,EAAe,SAAf,CAAwB,MAAOO,EAC7B,SAAAA,EACCD,EAEAO,EAAAA,IAACX,EAAiB,CAAA,SAAA,2BAAA,CAAyB,CAE/C,CAAA,CAEJ,EAKaY,EAAuB,IAAM,CAClC,MAAAC,EAAUC,aAAWhB,CAAc,EACzC,GAAI,CAACe,EACH,MAAM,IAAI,MACR,8DAAA,EAGG,OAAAA,CACT,EC1DME,EAAgBC,GACpB,OAAA,QAAAC,EAAAD,GAAA,YAAAA,EAAQ,OAAR,YAAAC,EAAc,aAAc,QAcjBC,EAAsB,CAAC,CAClC,UAAAC,EACA,OAAAH,CACF,IAAqC,CAC7B,KAAA,CAAE,WAAAI,GAAeR,IAEjB,CAACS,EAAWC,CAAY,EAAIf,EAAA,SAChC,IAAA,EAEI,CAACgB,EAAgBC,CAAiB,EACtCjB,WAAqC,IAAI,EAE3CC,OAAAA,EAAAA,UAAU,IAAM,CACd,eAAeiB,GAAgB,CAG7B,MAAMC,EAAUC,EAAAA,qBAAqBP,GAAA,YAAAA,EAAaD,GAAYH,CAAM,EAEpEQ,EAAkBE,GAAW,IAAI,EAE3B,MAAAE,GAASF,GAAA,YAAAA,EAAS,SAAU,GAG5BG,EAAgBd,EAAaW,CAAO,EACtCA,EAAQ,KAAK,UACbA,GAAA,YAAAA,EAAS,UAEPI,EAAgBD,EAAgB,KAAKA,CAAa,GAAK,GAGvDE,EAAOC,EAAM,KAAK,IAAMC,EAAAA,GAAAA,iBAAiBL,EAAQE,CAAa,CAAC,EACrER,EAAaS,CAAI,CACnB,CAEcN,GACb,EAAA,CAACL,EAAYJ,EAAQG,CAAS,CAAC,EAE3B,CAACE,EAAWE,CAAc,CACnC,ECjFMW,EAAWjC,EAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAclBkC,EAAWlC,EAAO;AAAA;AAAA;AAAA;AAAA;AAAA,YAKXmC,GAAUA,EAAM,MAAM;AAAA;AAAA,WAEvBA,GAAUA,EAAM,KAAK;AAAA,EAGpBC,EAAmD,CAAC,CAC/D,UAAAlB,EACA,SAAAmB,EACA,OAAAtB,EACA,MAAAoB,CACF,IAAM,CAEJ,KAAM,CAACf,EAAWE,CAAc,EAAIL,EAAoB,CACtD,UAAAC,EACA,OAAAH,CAAA,CACD,EAGD,GAAI,CAACK,EACI,OAAA,KAGT,MAAMkB,EAAKD,GACT3B,EAAA,IAACuB,EAAU,CAAA,SAAA,sBAAsBf,CAAS,gBAAiB,CAAA,EAI3D,OAAAR,EAAAA,IAAC6B,EAAAA,0BAA0B,CAAA,SAAUD,EACnC,SAAA5B,EAAA,IAAC8B,EAAA,SAAA,CACC,SACElB,GAAA,MAAAA,EAAgB,KACdZ,EAAA,IAACwB,EAAA,CACC,MAAOZ,EAAe,KAAK,MAC3B,OAAQA,EAAe,KAAK,MAAA,CAAA,EAE5B,KAGN,SAAAZ,EAAAA,IAACU,EAAW,CAAA,GAAGe,CAAO,CAAA,CAAA,CAE1B,CAAA,CAAA,CAEJ"}

package/index.js

@@ -1,10 +1,10 @@
-import { j as c } from "./emotion-react-jsx-runtime.browser.esm-vwuMB3sI.js";
-import d from "@emotion/styled";
-import { KosLog as k, ErrorBoundaryWithFallback as P } from "@kosdev-code/kos-ui-sdk";
-import b, { createContext as j, useState as a, useEffect as f, useContext as z, Suspense as R } from "react";
-import { i as $, m as K } from "./plugin-extension-manager-7xDx0VSt.js";
+import { j as s } from "./emotion-react-jsx-runtime.browser.esm-vwuMB3sI.js";
+import u from "@emotion/styled";
+import { ErrorBoundaryWithFallback as C } from "@kosdev-code/kos-ui-sdk";
+import y, { createContext as v, useState as a, useEffect as p, useContext as w, Suspense as P } from "react";
+import { i as b, r as z, m as j } from "./resolve-best-extension-DAJIkfJh.js";
 import "react/jsx-runtime";
-const h = j(void 0), M = d.div`
+const d = v(void 0), k = u.div`
   padding-inline: 20px;
   width: 100%;
   height: 100vh;
@@ -17,54 +17,46 @@ const h = j(void 0), M = d.div`
   top: 0;
   left: 0;
   z-index: 10000;
-`, G = ({ remotesOverride: t, children: o }) => {
-  const [n, s] = a();
-  return f(() => {
-    $(t).then((e) => {
-      s(e);
+`, L = ({ remotesOverride: t, children: n }) => {
+  const [e, r] = a();
+  return p(() => {
+    b(t).then((c) => {
+      r(c);
     });
-  }, [t]), /* @__PURE__ */ c(h.Provider, { value: n, children: n ? o : /* @__PURE__ */ c(M, { children: "Loading remote plugins..." }) });
+  }, [t]), /* @__PURE__ */ s(d.Provider, { value: e, children: e ? n : /* @__PURE__ */ s(k, { children: "Loading remote plugins..." }) });
 }, E = () => {
-  const t = z(h);
+  const t = w(d);
   if (!t)
     throw new Error(
       "useKosPluginsContext must be used within a KosPluginProvider"
     );
   return t;
-}, D = (t) => {
-  var o;
-  return ((o = t == null ? void 0 : t.view) == null ? void 0 : o.component) !== void 0;
-}, S = (t) => t.sort((o, n) => {
-  const s = o.rank || 0, e = n.rank || 0;
-  return s === e ? (k.info(
-    `found same rank for extension ${o.id} and ${n.id} using id to sort`
-  ), o.id.localeCompare(n.id)) : s - e;
-}), V = ({
+}, K = (t) => {
+  var n;
+  return ((n = t == null ? void 0 : t.view) == null ? void 0 : n.component) !== void 0;
+}, $ = ({
   extension: t,
-  module: o
+  module: n
 }) => {
-  const { extensions: n } = E(), [s, e] = a(
+  const { extensions: e } = E(), [r, c] = a(
     null
-  ), [r, l] = a(null);
-  return f(() => {
-    async function g() {
-      var m, p;
-      const x = S(
-        Object.values((n == null ? void 0 : n[t]) ?? {})
-      ), C = o ?? ((m = x[0]) == null ? void 0 : m.id) ?? "", i = (p = n == null ? void 0 : n[t]) == null ? void 0 : p[C];
-      l(i ?? null);
-      const y = (i == null ? void 0 : i.remote) || "", u = D(i) ? i.view.component : i == null ? void 0 : i.component, v = u ? `./${u}` : "", w = b.lazy(() => K.loadRemoteModule(y, v));
-      e(w);
+  ), [i, l] = a(null);
+  return p(() => {
+    async function h() {
+      const o = z(e == null ? void 0 : e[t], n);
+      l(o ?? null);
+      const f = (o == null ? void 0 : o.remote) || "", m = K(o) ? o.view.component : o == null ? void 0 : o.component, g = m ? `./${m}` : "", x = y.lazy(() => j.loadRemoteModule(f, g));
+      c(x);
     }
-    g();
-  }, [n, o, t]), [s, r];
-}, B = d.div`
+    h();
+  }, [e, n, t]), [r, i];
+}, D = u.div`
   align-items: center;
   display: flex;
   height: 100%;
   justify-content: center;
   width: 100%;
-`, F = d.div`
+`, M = u.div`
   align-items: center;
   background-color: transparent;
   display: flex;
@@ -72,38 +64,38 @@ const h = j(void 0), M = d.div`
   height: ${(t) => t.height};
   justify-content: center;
   width: ${(t) => t.width};
-`, H = ({
+`, W = ({
   extension: t,
-  fallback: o,
-  module: n,
-  props: s
+  fallback: n,
+  module: e,
+  props: r
 }) => {
-  const [e, r] = V({
+  const [c, i] = $({
     extension: t,
-    module: n
+    module: e
   });
-  if (!e)
+  if (!c)
     return null;
-  const l = o || /* @__PURE__ */ c(B, { children: `Dynamic component, ${t}, not found...` });
-  return /* @__PURE__ */ c(P, { fallback: l, children: /* @__PURE__ */ c(
-    R,
+  const l = n || /* @__PURE__ */ s(D, { children: `Dynamic component, ${t}, not found...` });
+  return /* @__PURE__ */ s(C, { fallback: l, children: /* @__PURE__ */ s(
+    P,
     {
-      fallback: r != null && r.size ? /* @__PURE__ */ c(
-        F,
+      fallback: i != null && i.size ? /* @__PURE__ */ s(
+        M,
         {
-          width: r.size.width,
-          height: r.size.height
+          width: i.size.width,
+          height: i.size.height
         }
       ) : null,
-      children: /* @__PURE__ */ c(e, { ...s })
+      children: /* @__PURE__ */ s(c, { ...r })
     }
   ) });
 };
 export {
-  H as DynamicComponent,
-  G as KosPluginProvider,
-  h as RemotesContext,
-  V as useDynamicComponent,
+  W as DynamicComponent,
+  L as KosPluginProvider,
+  d as RemotesContext,
+  $ as useDynamicComponent,
   E as useKosPluginsContext
 };
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../packages/sdk/kos-ui-plugin/src/lib/contexts/plugins-provider/plugins-provider.tsx","../../../../packages/sdk/kos-ui-plugin/src/lib/hooks/use-dynamic-component.tsx","../../../../packages/sdk/kos-ui-plugin/src/lib/components/dynamic-component/dynamic-component.tsx"],"sourcesContent":["/**\n *\n *\n * @module remotes-provider\n * @description Provides a context for managing dynamic remotes and extensions in a React application.\n */\n\nimport styled from \"@emotion/styled\";\nimport {\n  PropsWithChildren,\n  createContext,\n  useContext,\n  useEffect,\n  useState,\n} from \"react\";\nimport type { DynamicRemotes } from \"../../../types/global\";\nimport type { PluginExtension } from \"../../../types/plugins\";\nimport { initPluginManager } from \"../../utils/plugin-extension-manager\";\n\ninterface PluginsType {\n  remotes?: DynamicRemotes;\n  extensions?: PluginExtensionsType;\n  extensionPoints?: Record<string, PluginExtension[]>;\n  getExtensions: (extensionPointId: string) => PluginExtension[];\n}\n\nexport interface PluginExtensionsType {\n  [k: string]: {\n    [k: string]: PluginExtension;\n  };\n}\n\n/**\n * The context for managing dynamic remotes and extensions.\n */\nexport const RemotesContext = createContext<PluginsType | undefined>(undefined);\n\ninterface Props {\n  remotesOverride?: DynamicRemotes;\n}\n\nconst MessageContainer = styled.div`\n  padding-inline: 20px;\n  width: 100%;\n  height: 100vh;\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  position: fixed;\n  font-size: 14px;\n  top: 0;\n  left: 0;\n  z-index: 10000;\n`;\n/**\n * The provider component for the RemotesContext.\n */\nexport const KosPluginProvider: React.FunctionComponent<\n  PropsWithChildren<Props>\n> = ({ remotesOverride, children }) => {\n  const [contextValue, setContextValue] = useState<PluginsType | undefined>();\n\n  useEffect(() => {\n    initPluginManager(remotesOverride).then((value) => {\n      setContextValue(value);\n    });\n  }, [remotesOverride]);\n\n  return (\n    <RemotesContext.Provider value={contextValue}>\n      {contextValue ? (\n        children\n      ) : (\n        <MessageContainer>Loading remote plugins...</MessageContainer>\n      )}\n    </RemotesContext.Provider>\n  );\n};\n\n/**\n * Custom hook for accessing the RemotesContext.\n */\nexport const useKosPluginsContext = () => {\n  const context = useContext(RemotesContext);\n  if (!context) {\n    throw new Error(\n      \"useKosPluginsContext must be used within a KosPluginProvider\"\n    );\n  }\n  return context;\n};\n","import { KosLog } from \"@kosdev-code/kos-ui-sdk\";\nimport { loadRemoteModule } from \"@nx/react/mf\";\n\nimport React, { useEffect, useState } from \"react\";\nimport type {\n  BasePluginExtension,\n  BaseViewPluginExtension,\n} from \"../../types/plugins\";\nimport { useKosPluginsContext } from \"../contexts\";\n\ninterface Props {\n  extension: string;\n  module?: string;\n}\n\nconst isViewPlugin = (module: any): module is BaseViewPluginExtension =>\n  module?.view?.component !== undefined;\n\nconst sortModulesByRank = (modules: any[]) =>\n  modules.sort((a, b) => {\n    const aRank = a.rank || 0;\n    const bRank = b.rank || 0;\n    if (aRank === bRank) {\n      KosLog.info(\n        `found same rank for extension ${a.id} and ${b.id} using id to sort`\n      );\n      return a.id.localeCompare(b.id);\n    }\n    return aRank - bRank;\n  });\n\ntype DynamicComponentResult = [\n  React.FunctionComponent | null,\n  BasePluginExtension | null\n];\nexport const useDynamicComponent = ({\n  extension,\n  module,\n}: Props): DynamicComponentResult => {\n  const { extensions } = useKosPluginsContext();\n  const [Component, setComponent] = useState<React.FunctionComponent | null>(\n    null\n  );\n\n  const [extensionPoint, setExtensionPoint] =\n    useState<BasePluginExtension | null>(null);\n\n  useEffect(() => {\n    async function loadComponent() {\n      const allModules = sortModulesByRank(\n        Object.values(extensions?.[extension] ?? {})\n      );\n\n      const moduleId = module ?? allModules[0]?.id ?? \"\";\n      const _module = extensions?.[extension]?.[moduleId];\n      setExtensionPoint(_module ?? null);\n      const remote = _module?.remote || \"\";\n\n      const componentName = isViewPlugin(_module)\n        ? _module.view.component\n        : _module?.component;\n\n      const componentPath = componentName ? `./${componentName}` : \"\";\n\n      const Comp = React.lazy(() => loadRemoteModule(remote, componentPath));\n\n      setComponent(Comp);\n    }\n    loadComponent();\n  }, [extensions, module, extension]);\n\n  return [Component, extensionPoint];\n};\n","import styled from \"@emotion/styled\";\nimport { ErrorBoundaryWithFallback } from \"@kosdev-code/kos-ui-sdk\";\nimport React, { Suspense } from \"react\";\nimport { useDynamicComponent } from \"../../hooks\";\n\nconst NotFound = styled.div`\n  align-items: center;\n  display: flex;\n  height: 100%;\n  justify-content: center;\n  width: 100%;\n`;\ninterface Props {\n  extension: string;\n  fallback?: React.ReactNode;\n  module?: string;\n  props?: any;\n}\n\nconst Skeleton = styled.div<{ width: string; height: string }>`\n  align-items: center;\n  background-color: transparent;\n  display: flex;\n  flex-direction: column;\n  height: ${(props) => props.height};\n  justify-content: center;\n  width: ${(props) => props.width};\n`;\n\nexport const DynamicComponent: React.FunctionComponent<Props> = ({\n  extension,\n  fallback,\n  module,\n  props,\n}) => {\n  // get the list of extensions from the context\n  const [Component, extensionPoint] = useDynamicComponent({\n    extension,\n    module,\n  });\n  // get the module from the extension\n\n  if (!Component) {\n    return null;\n  }\n\n  const fb = fallback || (\n    <NotFound>{`Dynamic component, ${extension}, not found...`}</NotFound>\n  );\n\n  return (\n    <ErrorBoundaryWithFallback fallback={fb}>\n      <Suspense\n        fallback={\n          extensionPoint?.size ? (\n            <Skeleton\n              width={extensionPoint.size.width}\n              height={extensionPoint.size.height}\n            />\n          ) : null\n        }\n      >\n        <Component {...props} />\n      </Suspense>\n    </ErrorBoundaryWithFallback>\n  );\n};\n"],"names":["RemotesContext","createContext","MessageContainer","styled","KosPluginProvider","remotesOverride","children","contextValue","setContextValue","useState","useEffect","initPluginManager","value","jsx","useKosPluginsContext","context","useContext","isViewPlugin","module","_a","sortModulesByRank","modules","a","b","aRank","bRank","KosLog","useDynamicComponent","extension","extensions","Component","setComponent","extensionPoint","setExtensionPoint","loadComponent","allModules","moduleId","_module","_b","remote","componentName","componentPath","Comp","React","loadRemoteModule","NotFound","Skeleton","props","DynamicComponent","fallback","fb","ErrorBoundaryWithFallback","Suspense"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../packages/sdk/kos-ui-plugin/src/lib/contexts/plugins-provider/plugins-provider.tsx","../../../../packages/sdk/kos-ui-plugin/src/lib/hooks/use-dynamic-component.tsx","../../../../packages/sdk/kos-ui-plugin/src/lib/components/dynamic-component/dynamic-component.tsx"],"sourcesContent":["/**\n *\n *\n * @module remotes-provider\n * @description Provides a context for managing dynamic remotes and extensions in a React application.\n */\n\nimport styled from \"@emotion/styled\";\nimport {\n  PropsWithChildren,\n  createContext,\n  useContext,\n  useEffect,\n  useState,\n} from \"react\";\nimport type { DynamicRemotes } from \"../../../types/global\";\nimport type { PluginExtension } from \"../../../types/plugins\";\nimport { initPluginManager } from \"../../utils/plugin-extension-manager\";\n\ninterface PluginsType {\n  remotes?: DynamicRemotes;\n  extensions?: PluginExtensionsType;\n  extensionPoints?: Record<string, PluginExtension[]>;\n  getExtensions: (extensionPointId: string) => PluginExtension[];\n}\n\nexport interface PluginExtensionsType {\n  [k: string]: {\n    [k: string]: PluginExtension;\n  };\n}\n\n/**\n * The context for managing dynamic remotes and extensions.\n */\nexport const RemotesContext = createContext<PluginsType | undefined>(undefined);\n\ninterface Props {\n  remotesOverride?: DynamicRemotes;\n}\n\nconst MessageContainer = styled.div`\n  padding-inline: 20px;\n  width: 100%;\n  height: 100vh;\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  position: fixed;\n  font-size: 14px;\n  top: 0;\n  left: 0;\n  z-index: 10000;\n`;\n/**\n * The provider component for the RemotesContext.\n */\nexport const KosPluginProvider: React.FunctionComponent<\n  PropsWithChildren<Props>\n> = ({ remotesOverride, children }) => {\n  const [contextValue, setContextValue] = useState<PluginsType | undefined>();\n\n  useEffect(() => {\n    initPluginManager(remotesOverride).then((value) => {\n      setContextValue(value);\n    });\n  }, [remotesOverride]);\n\n  return (\n    <RemotesContext.Provider value={contextValue}>\n      {contextValue ? (\n        children\n      ) : (\n        <MessageContainer>Loading remote plugins...</MessageContainer>\n      )}\n    </RemotesContext.Provider>\n  );\n};\n\n/**\n * Custom hook for accessing the RemotesContext.\n */\nexport const useKosPluginsContext = () => {\n  const context = useContext(RemotesContext);\n  if (!context) {\n    throw new Error(\n      \"useKosPluginsContext must be used within a KosPluginProvider\"\n    );\n  }\n  return context;\n};\n","import { loadRemoteModule } from \"@nx/react/mf\";\n\nimport React, { useEffect, useState } from \"react\";\nimport type {\n  BasePluginExtension,\n  BaseViewPluginExtension,\n} from \"../../types/plugins\";\nimport { useKosPluginsContext } from \"../contexts\";\nimport { resolveBestExtension } from \"../utils/resolve-best-extension\";\n\ninterface Props {\n  /**\n   * The extension point ID to resolve plugin modules from.\n   * Example: \"ddk.ncui.settings.tabView\"\n   */\n  extension: string;\n\n  /**\n   * Optional module ID to load a specific plugin.\n   * If not provided, the plugin with the **lowest rank** for the extension point is used.\n   */\n  module?: string;\n}\n\ntype DynamicComponentResult = [\n  React.FunctionComponent | null,\n  BasePluginExtension | null\n];\n\n/**\n * Determines whether a plugin extension follows the \"view\" structure.\n * This allows resolving the correct field (`view.component` vs `component`) when loading.\n */\nconst isViewPlugin = (module: any): module is BaseViewPluginExtension =>\n  module?.view?.component !== undefined;\n\n/**\n * React hook to resolve and lazily load a plugin component for a given extension point.\n *\n * - If `module` is provided, it directly loads that plugin.\n * - If `module` is not provided, it uses the **lowest-ranked plugin** from the extension point.\n * - Supports both standard plugins (`component`) and view-style plugins (`view.component`)\n * - Uses React.lazy + Module Federation to dynamically import the remote component.\n *\n * @param props.extension The extension point to resolve plugins from\n * @param props.module (Optional) Specific module ID to use, otherwise the highest-priority plugin is loaded\n * @returns A tuple: `[Component, PluginExtension]`\n */\nexport const useDynamicComponent = ({\n  extension,\n  module,\n}: Props): DynamicComponentResult => {\n  const { extensions } = useKosPluginsContext();\n\n  const [Component, setComponent] = useState<React.FunctionComponent | null>(\n    null\n  );\n  const [extensionPoint, setExtensionPoint] =\n    useState<BasePluginExtension | null>(null);\n\n  useEffect(() => {\n    async function loadComponent() {\n      // Determine which plugin to use\n\n      const _module = resolveBestExtension(extensions?.[extension], module);\n\n      setExtensionPoint(_module ?? null);\n\n      const remote = _module?.remote || \"\";\n\n      // Resolve the component path for the module\n      const componentName = isViewPlugin(_module)\n        ? _module.view.component\n        : _module?.component;\n\n      const componentPath = componentName ? `./${componentName}` : \"\";\n\n      // Load the component using Module Federation\n      const Comp = React.lazy(() => loadRemoteModule(remote, componentPath));\n      setComponent(Comp);\n    }\n\n    loadComponent();\n  }, [extensions, module, extension]);\n\n  return [Component, extensionPoint];\n};\n","import styled from \"@emotion/styled\";\nimport { ErrorBoundaryWithFallback } from \"@kosdev-code/kos-ui-sdk\";\nimport React, { Suspense } from \"react\";\nimport { useDynamicComponent } from \"../../hooks\";\n\nconst NotFound = styled.div`\n  align-items: center;\n  display: flex;\n  height: 100%;\n  justify-content: center;\n  width: 100%;\n`;\ninterface Props {\n  extension: string;\n  fallback?: React.ReactNode;\n  module?: string;\n  props?: any;\n}\n\nconst Skeleton = styled.div<{ width: string; height: string }>`\n  align-items: center;\n  background-color: transparent;\n  display: flex;\n  flex-direction: column;\n  height: ${(props) => props.height};\n  justify-content: center;\n  width: ${(props) => props.width};\n`;\n\nexport const DynamicComponent: React.FunctionComponent<Props> = ({\n  extension,\n  fallback,\n  module,\n  props,\n}) => {\n  // get the list of extensions from the context\n  const [Component, extensionPoint] = useDynamicComponent({\n    extension,\n    module,\n  });\n  // get the module from the extension\n\n  if (!Component) {\n    return null;\n  }\n\n  const fb = fallback || (\n    <NotFound>{`Dynamic component, ${extension}, not found...`}</NotFound>\n  );\n\n  return (\n    <ErrorBoundaryWithFallback fallback={fb}>\n      <Suspense\n        fallback={\n          extensionPoint?.size ? (\n            <Skeleton\n              width={extensionPoint.size.width}\n              height={extensionPoint.size.height}\n            />\n          ) : null\n        }\n      >\n        <Component {...props} />\n      </Suspense>\n    </ErrorBoundaryWithFallback>\n  );\n};\n"],"names":["RemotesContext","createContext","MessageContainer","styled","KosPluginProvider","remotesOverride","children","contextValue","setContextValue","useState","useEffect","initPluginManager","value","jsx","useKosPluginsContext","context","useContext","isViewPlugin","module","_a","useDynamicComponent","extension","extensions","Component","setComponent","extensionPoint","setExtensionPoint","loadComponent","_module","resolveBestExtension","remote","componentName","componentPath","Comp","React","loadRemoteModule","NotFound","Skeleton","props","DynamicComponent","fallback","fb","ErrorBoundaryWithFallback","Suspense"],"mappings":"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"}

package/lib/dev/components/storybook/control-pour-story-container/control-pour-story-container.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+
+interface ControlPourStoryContainerProps {
+    children: ReactNode;
+}
+export declare const ControlPourStoryContainer: ({ children, }: ControlPourStoryContainerProps) => ReactNode;
+export {};
+//# sourceMappingURL=control-pour-story-container.d.ts.map

package/lib/dev/components/storybook/control-pour-story-container/control-pour-story-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-pour-story-container.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/sdk/kos-ui-plugin/src/lib/dev/components/storybook/control-pour-story-container/control-pour-story-container.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,UAAU,8BAA8B;IACtC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,eAAO,MAAM,yBAAyB,kBAEnC,8BAA8B,cAAa,CAAC"}

package/lib/dev/components/storybook/control-pour-story-container/index.d.ts

@@ -0,0 +1,2 @@
+export * from './control-pour-story-container';
+//# sourceMappingURL=index.d.ts.map

package/lib/dev/components/storybook/control-pour-story-container/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../packages/sdk/kos-ui-plugin/src/lib/dev/components/storybook/control-pour-story-container/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}

package/lib/dev/components/storybook/index.d.ts

@@ -1,3 +1,4 @@
+export * from './control-pour-story-container';
 export * from './cui-story-container';
 export * from './nav-story-container';
 export * from './setting-story-container';

package/lib/dev/components/storybook/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-plugin/src/lib/dev/components/storybook/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/sdk/kos-ui-plugin/src/lib/dev/components/storybook/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC"}

package/lib/hooks/use-dynamic-component.d.ts

@@ -2,13 +2,33 @@ import { BasePluginExtension } from '../../types/plugins';
 import { default as React } from 'react';
 
 interface Props {
+    /**
+     * The extension point ID to resolve plugin modules from.
+     * Example: "ddk.ncui.settings.tabView"
+     */
     extension: string;
+    /**
+     * Optional module ID to load a specific plugin.
+     * If not provided, the plugin with the **lowest rank** for the extension point is used.
+     */
     module?: string;
 }
 type DynamicComponentResult = [
     React.FunctionComponent | null,
     BasePluginExtension | null
 ];
+/**
+ * React hook to resolve and lazily load a plugin component for a given extension point.
+ *
+ * - If `module` is provided, it directly loads that plugin.
+ * - If `module` is not provided, it uses the **lowest-ranked plugin** from the extension point.
+ * - Supports both standard plugins (`component`) and view-style plugins (`view.component`)
+ * - Uses React.lazy + Module Federation to dynamically import the remote component.
+ *
+ * @param props.extension The extension point to resolve plugins from
+ * @param props.module (Optional) Specific module ID to use, otherwise the highest-priority plugin is loaded
+ * @returns A tuple: `[Component, PluginExtension]`
+ */
 export declare const useDynamicComponent: ({ extension, module, }: Props) => DynamicComponentResult;
 export {};
 //# sourceMappingURL=use-dynamic-component.d.ts.map

package/lib/hooks/use-dynamic-component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-dynamic-component.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/hooks/use-dynamic-component.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAG7B,UAAU,KAAK;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkBD,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,iBAAiB,GAAG,IAAI;IAC9B,mBAAmB,GAAG,IAAI;CAC3B,CAAC;AACF,eAAO,MAAM,mBAAmB,2BAG7B,KAAK,2BAkCP,CAAC"}
+{"version":3,"file":"use-dynamic-component.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/hooks/use-dynamic-component.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAI7B,UAAU,KAAK;IACb;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,iBAAiB,GAAG,IAAI;IAC9B,mBAAmB,GAAG,IAAI;CAC3B,CAAC;AASF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,2BAG7B,KAAK,2BAmCP,CAAC"}

package/lib/utils/contribution-reducer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contribution-reducer.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/contribution-reducer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,eAAO,MAAM,mBAAmB,YACpB,cAAc,WAAW,sBAAsB,OAAO,MAAM,2BAqIrE,CAAC"}
+{"version":3,"file":"contribution-reducer.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/contribution-reducer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,eAAO,MAAM,mBAAmB,YACpB,cAAc,WAAW,sBAAsB,OAAO,MAAM,2BA+IrE,CAAC"}

package/lib/utils/control-pour-reducer.d.ts

@@ -0,0 +1,5 @@
+export declare const EXTENSION_POINT_CONTROL_POUR_DEF = "cui.control.pour";
+export declare const EXTENSION_POINT_CONTROL_POUR_VIEW = "cui.control.pour.view";
+export declare const EXTENSION_POINT_CONTROL_POUR = "cui.control.pour.config";
+export declare const controlPourReducer: (experiences: Record<string, any>, contributions: import('../../types/plugins').ProcessedContributions) => (acc: import('../..').PluginExtensionsType, key: string) => import('../..').PluginExtensionsType;
+//# sourceMappingURL=control-pour-reducer.d.ts.map

package/lib/utils/control-pour-reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-pour-reducer.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/control-pour-reducer.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gCAAgC,qBAAqB,CAAC;AACnE,eAAO,MAAM,iCAAiC,0BAA0B,CAAC;AACzE,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE,eAAO,MAAM,kBAAkB,6MAQ7B,CAAC"}

package/lib/utils/index.d.ts

@@ -8,6 +8,7 @@ export * from './initialize-plugins';
 export * from './nav-view-reducer';
 export * from './plugin-extension-manager';
 export * from './process-kos-config';
+export * from './resolve-best-extension';
 export * from './settings-reducer';
 export * from './setup-reducer';
 export * from './state-action-reducer';

package/lib/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC"}

package/lib/utils/initialize-plugins.d.ts

@@ -30,7 +30,46 @@ interface KosPluginsProps {
     pluginApiPath?: string;
     overrides?: Record<string, string>;
 }
+/**
+ * Parses the query string from the URL or a provided string and returns an object
+ * representing the key-value pairs in the query string.
+ *
+ * @param query - An optional query string to parse. If not provided, the function
+ *                will use the current window's `location.search` string.
+ *                The query string should not include the leading "?" character.
+ *
+ * @returns An object where each key is a parameter name from the query string,
+ *          and each value is the corresponding decoded parameter value.
+ *
+ * @example
+ * // Assuming the URL is: https://example.com/?name=John&age=30
+ * getQueryParams();
+ * // Returns: { name: "John", age: "30" }
+ *
+ * @example
+ * getQueryParams("foo=bar&baz=qux");
+ * // Returns: { foo: "bar", baz: "qux" }
+ */
 export declare const getQueryParams: (query?: null) => {};
+/**
+ * Initializes KOS plugins by fetching plugin metadata and configuring dynamic remotes.
+ *
+ * @param props - Optional properties to configure the plugin initialization.
+ * @param props.pluginBaseUrl - The base URL for the plugins. Defaults to the result of `getDefaultHost()`.
+ * @param props.pluginApiPath - The API path to fetch plugin metadata. Defaults to `"/api/app/kosdev.ddk/ncui/plugins"`.
+ * @param props.overrides - An object containing overrides for plugin base URLs, keyed by plugin ID.
+ *
+ * @returns A promise that resolves to a record of remote definitions, where the keys are remote IDs
+ * and the values are the corresponding base paths for the remote entries.
+ *
+ * @remarks
+ * - This function fetches plugin metadata from the specified API endpoint and processes the data
+ *   to configure dynamic remotes for the KOS plugin system.
+ * - If a plugin does not have a descriptor, an error is logged to the console.
+ * - The remote definitions are also set using the `setRemoteDefinitions` function.
+ *
+ * @throws Will throw an error if the fetch request fails or if the response cannot be parsed as JSON.
+ */
 export declare const initializeKosPlugins: (props?: KosPluginsProps) => Promise<Record<string, string>>;
 export {};
 //# sourceMappingURL=initialize-plugins.d.ts.map

package/lib/utils/initialize-plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialize-plugins.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/initialize-plugins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,WAAW,cAAc;IAC9B,gBAAgB,EAAE,cAAc,CAAC;IACjC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;CAChD;AACD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE,cAAc,CAAC;KAC5B;CACF;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,UAAU,EAAE,CAAC;QACzB,WAAW,EAAE,aAAa,CAAC;KAC5B,CAAC;CACH;AAED,UAAU,eAAe;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,cAAc,sBAiBjB,CAAC;AAWX,eAAO,MAAM,oBAAoB,WAAkB,eAAe,oCAoCjE,CAAC"}
+{"version":3,"file":"initialize-plugins.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/initialize-plugins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,kCAAkC,CAAC;AAE1C,OAAO,WAAW,cAAc;IAC9B,gBAAgB,EAAE,cAAc,CAAC;IACjC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;CAChD;AACD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,UAAU,EAAE,cAAc,CAAC;KAC5B;CACF;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,UAAU,EAAE,CAAC;QACzB,WAAW,EAAE,aAAa,CAAC;KAC5B,CAAC;CACH;AAED,UAAU,eAAe;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,sBAiBjB,CAAC;AAWX;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,WAAkB,eAAe,oCAoCjE,CAAC"}

package/lib/utils/plugin-extension-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-extension-manager.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/plugin-extension-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAc7B,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IACpD,aAAa,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,eAAe,EAAE,CAAC;CAChE;AACD,wBAAsB,iBAAiB,CACrC,eAAe,CAAC,EAAE,cAAc,GAC/B,OAAO,CAAC,WAAW,CAAC,CAmCtB;AAeD,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,sBAAsB,CAUxB;AACD,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,iCAuI5D;AAED,wBAAsB,aAAa,CAAC,gBAAgB,EAAE,MAAM;;MAG3D"}
+{"version":3,"file":"plugin-extension-manager.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/plugin-extension-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAK7B,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IACpD,aAAa,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,eAAe,EAAE,CAAC;CAChE;AAED,wBAAsB,iBAAiB,CACrC,eAAe,CAAC,EAAE,cAAc,GAC/B,OAAO,CAAC,WAAW,CAAC,CAgCtB;AAkBD,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,sBAAsB,CAOxB;AAED,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,iCA8D5D;AAED,wBAAsB,aAAa,CAAC,gBAAgB,EAAE,MAAM;;MAG3D"}

package/lib/utils/plugin-extension-registry-init.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-extension-registry-init.d.ts.map

package/lib/utils/plugin-extension-registry-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-extension-registry-init.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/plugin-extension-registry-init.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,6 @@
+import { PluginExtensionsType, ProcessedContributions } from '../../types/plugins';
+
+export type ExtensionReducer = (extensions: PluginExtensionsType, contributions: ProcessedContributions, experiences: any) => PluginExtensionsType;
+export declare function registerExtensionReducer(reducer: ExtensionReducer): void;
+export declare function applyExtensionReducers(base: PluginExtensionsType, contributions: ProcessedContributions, experiences: any): PluginExtensionsType;
+//# sourceMappingURL=plugin-extension-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-extension-registry.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/plugin-extension-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,gBAAgB,GAAG,CAC7B,UAAU,EAAE,oBAAoB,EAChC,aAAa,EAAE,sBAAsB,EACrC,WAAW,EAAE,GAAG,KACb,oBAAoB,CAAC;AAI1B,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,QAEjE;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,EAC1B,aAAa,EAAE,sBAAsB,EACrC,WAAW,EAAE,GAAG,GACf,oBAAoB,CAKtB"}

package/lib/utils/resolve-best-extension.d.ts

@@ -0,0 +1,12 @@
+import { PluginExtension } from '../../types/plugins';
+
+/**
+ * Resolves the best plugin extension for a given extension point.
+ *
+ * @param extensions A map of plugin extensions keyed by module/plugin ID
+ * @param module Optional module ID to resolve
+ * @param exact If true, only returns a plugin if the given `module` matches exactly. If false (default), falls back to the best-ranked plugin if no match is found.
+ * @returns The resolved PluginExtension or null
+ */
+export declare function resolveBestExtension<T extends PluginExtension>(extensions: Record<string, T> | undefined, module?: string, exact?: boolean): T | null;
+//# sourceMappingURL=resolve-best-extension.d.ts.map

package/lib/utils/resolve-best-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-best-extension.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-plugin/src/lib/utils/resolve-best-extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAC5D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,EACzC,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,UAAQ,GACZ,CAAC,GAAG,IAAI,CAgCV"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosdev-code/kos-ui-plugin",
-  "version": "2.0.1",
+  "version": "2.0.19",
   "type": "module",
   "exports": {
     ".": {
@@ -26,7 +26,7 @@
   },
   "kos": {
     "build": {
-      "gitHash": "26743490ccd3555641529b81d803612636a8eba3"
+      "gitHash": "e0c503e557110d60c4da6b5f600eed0298c35d01"
     }
   },
   "publishConfig": {

package/resolve-best-extension-D5Ord7XK.cjs

@@ -0,0 +1,2 @@
+"use strict";var R={},f={};Object.defineProperty(f,"__esModule",{value:!0});f.loadRemoteModule=f.setRemoteDefinitions=f.setRemoteUrlResolver=void 0;let h,w;const D=new Map,g=new Map;let S=!1;function W(n){w=n}f.setRemoteUrlResolver=W;function z(n){h=n}f.setRemoteDefinitions=z;async function L(n,t){const o=`${n}:${t}`;if(D.has(o))return D.get(o);const d=(await(g.has(n)?g.get(n):await H(n)).get(t))();return D.set(o,d),d}f.loadRemoteModule=L;const q=(n,t)=>new Promise((o,s)=>{const i=document.createElement("script");i.src=n,i.type="text/javascript",i.async=!0,i.onload=()=>{o({get:r=>window[t].get(r),init:r=>{try{window[t].init(r)}catch(a){console.error(`Failed to initialize remote ${t}`,a),s(a)}}})},i.onerror=()=>s(new Error(`Remote ${t} not found`)),document.head.appendChild(i)});async function H(n){if(!w&&!h)throw new Error("Call setRemoteDefinitions or setRemoteUrlResolver to allow Dynamic Federation to find the remote apps correctly.");S||(S=!0,await __webpack_init_sharing__("default"));const t=h?h[n]:await w(n);let o=t;!t.endsWith(".mjs")&&!t.endsWith(".js")&&(o=`${t}${t.endsWith("/")?"":"/"}remoteEntry.js`);const s=await q(o,n);return await s.init(__webpack_share_scopes__.default),g.set(n,s),s}(function(n){Object.defineProperty(n,"__esModule",{value:!0}),n.setRemoteUrlResolver=n.setRemoteDefinitions=n.loadRemoteModule=void 0;var t=f;Object.defineProperty(n,"loadRemoteModule",{enumerable:!0,get:function(){return t.loadRemoteModule}}),Object.defineProperty(n,"setRemoteDefinitions",{enumerable:!0,get:function(){return t.setRemoteDefinitions}}),Object.defineProperty(n,"setRemoteUrlResolver",{enumerable:!0,get:function(){return t.setRemoteUrlResolver}})})(R);const V=n=>(t,o)=>{var m,x,E,v,C,_,K,M,j,O,I,U;t.cuiDefinitions=t.cuiDefinitions||{};const s=n[o].remote,i=o;(((m=n[o].contributes)==null?void 0:m.cui)||[]).forEach(e=>{t.cuiDefinitions[e.id]={...e,cuiDescriptor:i,remote:s,sectionId:i}}),(((x=n[o].contributes)==null?void 0:x.navViews)||[]).forEach(e=>{t.navViewDefinitions[e.id]={...e,remote:s,sectionId:i}}),(((E=n[o].contributes)==null?void 0:E.utilities)||[]).forEach(e=>{t.utilDefinitions[e.id]={...e,remote:s,sectionId:i}}),(((v=n[o].contributes)==null?void 0:v.setupStep)||[]).forEach(e=>{t.setupDefinitions[e.id]={...e,remote:s,sectionId:i}}),(((C=n[o].contributes)==null?void 0:C.troubleActions)||[]).forEach(e=>{t.troubleActionDefinitions[e.id]={...e,remote:s,sectionId:i}}),(((_=n[o].contributes)==null?void 0:_.controlPour)||[]).forEach(e=>{t.controlPourDefinitions[e.id]={...e,remote:s,sectionId:i}}),(((K=n[o].contributes)==null?void 0:K.settingsGroup)||[]).forEach(e=>{t.settingsGroupDefinitions[e.id]={...e,settings:[],remote:s,sectionId:i}}),(((M=n[o].contributes)==null?void 0:M.settings)||[]).forEach(e=>{t.settingsDefinitions[e.id]={...e,remote:s,sectionId:i}}),(((j=n[o].contributes)==null?void 0:j.dashboardSummary)||[]).forEach(e=>{t.dashboardDefinitions[e.dashboardKey]=t.dashboardDefinitions[e.dashboardKey]||{},t.dashboardDefinitions[e.dashboardKey].summary={...e,remote:s,sectionId:i},t.dashboardSummaryDefinitions[e.id]={...e,remote:s,sectionId:i}}),(((O=n[o].contributes)==null?void 0:O.dashboardDetail)||[]).forEach(e=>{t.dashboardDefinitions[e.dashboardKey]=t.dashboardDefinitions[e.dashboardKey]||{},t.dashboardDefinitions[e.dashboardKey].detail={...e,remote:s,sectionId:i},t.dashboardDetailDefinitions[e.id]={...e,remote:s,sectionId:i}}),(((I=n[o].contributes)==null?void 0:I.dashboardPumpDetail)||[]).forEach(e=>{t.dashboardDefinitions[e.dashboardKey]=t.dashboardDefinitions[e.dashboardKey]||{},t.dashboardDefinitions[e.dashboardKey].pumpDetail={...e,remote:s,sectionId:i},t.dashboardPumpDetailDefinitions[e.id]={...e,remote:s,sectionId:i}});const y=(U=n[o].contributes)==null?void 0:U.experiences;return Object.keys(y).forEach(e=>{const T=y[e];t.experiences[e]={...T,remote:s,sectionId:i}}),t},$=[];function J(n){$.push(n)}function Q(n,t,o){return $.reduce((s,i)=>i(s,t,o),n)}async function G(n){const t=n??window.KosPlugins.__dynamicRemotes;if(window.KosPlugins.extensions){const d=window.KosPlugins.extensions;return{extensionPoints:d,getExtensions:r=>d[r]||[],remotes:t,extensions:window.KosPlugins.__extensions}}const o=window.KosPlugins.__extensions??await F(t),s={};if(o)for(const d of Object.keys(o))s[d]=Object.values(o[d]||{});return window.KosPlugins.extensions=s,{extensionPoints:s,getExtensions:d=>s[d]||[],remotes:t,extensions:o}}const A={cuiDefinitions:{},controlPourDefinitions:{},utilDefinitions:{},setupDefinitions:{},settingsGroupDefinitions:{},settingsDefinitions:{},dashboardSummaryDefinitions:{},dashboardDetailDefinitions:{},dashboardPumpDetailDefinitions:{},dashboardDefinitions:{},navViewDefinitions:{},troubleActionDefinitions:{},experiences:{}};function B(n){return n?Object.keys(n).reduce(V(n),{...A}):A}async function F(n){if(!n)return window.KosPlugins=window.KosPlugins||{},{};const t=B(n),o=t.experiences,i=Q({},t,o);for(const r of Object.values(n))if(r.init){const a=await R.loadRemoteModule(r.remote,"./InitPlugin");if(a.default){const l=new a.default;l==null||l.register()}}const d=Object.keys(n).reduce((r,a)=>{var p;const l=((p=n[a].contributes)==null?void 0:p.views)??{};for(const u of Object.keys(l)){const P=l[u];r[u]=r[u]||{};for(const c of P)r[u][c.id]={id:c.id,type:"view",component:c.component,remote:n[a].remote,sectionId:a,data:c}}const b=n[a].extensions??[];for(const u of b)r[u.extensionPointId]=r[u.extensionPointId]||{},r[u.extensionPointId][u.id]={id:u.id,type:u.type,component:u.component,remote:n[a].remote,sectionId:a,data:u};return r},i);return window.KosPlugins=window.KosPlugins||{},window.KosPlugins.__extensions=d,d}async function X(n){const{getExtensions:t}=await G();return t(n)}function Y(n,t,o=!1){return!n||Object.keys(n).length===0?null:o?t&&n[t]?n[t]:null:t&&n[t]?n[t]:Object.values(n).filter(i=>typeof i.id=="string").sort((i,d)=>{const r=typeof i.rank=="number"?i.rank:1/0,a=typeof d.rank=="number"?d.rank:1/0;if(r===a){const l=i.id??"",b=d.id??"";return l.localeCompare(b)}return r-a})[0]??null}exports.contributionReducer=V;exports.getContributions=B;exports.getExtensions=X;exports.initPluginManager=G;exports.loadExtensions=F;exports.mf=R;exports.registerExtensionReducer=J;exports.resolveBestExtension=Y;
+//# sourceMappingURL=resolve-best-extension-D5Ord7XK.cjs.map