@ethisyscore/plugin-ui 1.23.0 → 1.25.0

package/dist/platform-react/index.cjs

@@ -42,9 +42,12 @@ function definePlatformReactPluginPage(Page, options) {
     rootClassName,
     styleId,
     css,
-    queryClient = defaultQueryClient
+    queryClient = defaultQueryClient,
+    wrapPage
   } = options;
   function PluginPage(props) {
+    const page = react.createElement(Page, props);
+    const body = wrapPage ? wrapPage(page) : page;
     return react.createElement(
       reactQuery.QueryClientProvider,
       { client: queryClient },
@@ -55,7 +58,7 @@ function definePlatformReactPluginPage(Page, options) {
         react.createElement(
           "div",
           { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },
-          react.createElement(Page, props)
+          body
         )
       )
     );
@@ -167,8 +170,42 @@ function useAuthenticatedQuery(options) {
 function useAuthenticatedQueries(queries) {
   return reactQuery.useQueries({ queries });
 }
+function matchRouteParams(pathname, routes, basePath) {
+  const prefix = basePath.length > 1 && basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+  const norm = pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname;
+  const rest = norm.startsWith(prefix) ? norm.slice(prefix.length).replace(/^\/+/, "") : "";
+  const segments = rest.length > 0 ? rest.split("/") : [];
+  let best = null;
+  let bestLiterals = -1;
+  for (const route of routes) {
+    const pattern = route.split("/").filter(Boolean);
+    if (pattern.length !== segments.length) {
+      continue;
+    }
+    const params = {};
+    let literals = 0;
+    let ok = true;
+    for (let i = 0; i < pattern.length; i++) {
+      if (pattern[i].startsWith(":")) {
+        params[pattern[i].slice(1)] = segments[i];
+      } else if (pattern[i] !== segments[i]) {
+        ok = false;
+        break;
+      } else {
+        literals++;
+      }
+    }
+    if (ok && literals > bestLiterals) {
+      best = params;
+      bestLiterals = literals;
+    }
+  }
+  return best;
+}
 function createReactRouterShim(options = {}) {
   const paramKeys = options.paramKeys ?? ["id"];
+  const routes = options.routes;
+  const basePath = options.basePath ?? "";
   function useNavigate() {
     return (to) => {
       if (typeof to === "number") {
@@ -180,6 +217,12 @@ function createReactRouterShim(options = {}) {
   }
   function useParams() {
     const path = typeof window !== "undefined" ? window.location.pathname : "";
+    if (routes != null && routes.length > 0) {
+      const matched = matchRouteParams(path, routes, basePath);
+      if (matched != null) {
+        return matched;
+      }
+    }
     const segments = path.split("/").filter(Boolean);
     const last = segments[segments.length - 1];
     const params = {};

package/dist/platform-react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/platform-react/templateContext.ts","../../src/platform-react/injectStyles.ts","../../src/platform-react/definePlatformReactPluginPage.tsx","../../src/platform-react/MissingViewFallback.tsx","../../src/platform-react/useView.ts","../../src/platform-react/mcpService.ts","../../src/platform-react/useAuthenticatedQuery.ts","../../src/platform-react/reactRouterShim.tsx"],"names":["createContext","useEffect","QueryClient","createElement","QueryClientProvider","definePlatformReactPage","useView","useContext","useMcpTool","useMemo","useQuery","useQueries","emitNavigation"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createContext, type ComponentType } from \"react\";\n\n/** A view component resolved from the template manifest. Props are open. */\nexport type ViewComponent = ComponentType<Record<string, unknown>>;\n\n/**\n * Static port of the monolith's gogo-ui adapter mechanism for PlatformReact.\n *\n * A monolith feature picks its adapter view at runtime via `import.meta.glob`;\n * a PlatformReact page is a single self-contained ESM bundle where that glob is\n * unavailable, so each page declares its view slice statically and provides it\n * through this context. The shape is `manifest[module][viewName] = Component`.\n */\nexport type TemplateManifest = Record<string, Partial<Record<string, ViewComponent>>>;\n\nexport const TemplateContext = createContext<TemplateManifest | null>(null);\n","import { useEffect } from \"react\";\n\n/**\n * Injects a plugin's compiled CSS into the host document once, keyed by a\n * stable element id (idempotent across pages and re-mounts).\n *\n * Each PlatformReact page is a separate ESM bundle with no companion CSS asset\n * the host would load, so the styles travel inside the bundle (typically via a\n * `*.css?inline` import) and are mounted at runtime. Scope the CSS to a plugin\n * root class (never `:root`) so it cannot override the host theme.\n */\nexport function injectPluginStyles(id: string, css: string): void {\n  if (typeof document === \"undefined\") return;\n  if (document.getElementById(id)) return;\n  const el = document.createElement(\"style\");\n  el.id = id;\n  el.textContent = css;\n  document.head.appendChild(el);\n}\n\n/** Component form of {@link injectPluginStyles}; renders nothing. */\nexport function PluginStyleScope({ id, css }: { id: string; css: string }): null {\n  useEffect(() => {\n    injectPluginStyles(id, css);\n  }, [id, css]);\n  return null;\n}\n","import { createElement, type ComponentType } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport {\n  definePlatformReactPage,\n  type PlatformReactPageProps,\n} from \"@ethisyscore/components-react\";\nimport { TemplateContext, type TemplateManifest, type ViewComponent } from \"./templateContext\";\nimport { PluginStyleScope } from \"./injectStyles\";\n\n/**\n * Default per-page `QueryClient`. Each PlatformReact page is an isolated ESM\n * bundle, so this module-level singleton is scoped to that page — exactly the\n * lifetime a page wants. Plugins needing different options pass their own.\n */\nfunction makeDefaultQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        retry: 1,\n        refetchOnWindowFocus: false,\n        staleTime: 30_000,\n      },\n    },\n  });\n}\n\nconst defaultQueryClient = makeDefaultQueryClient();\n\n/**\n * Shared root class applied to every plugin page wrapper, in addition to the\n * plugin's own `rootClassName`. The SDK's `plugin-base.css` (scoped resets +\n * component overrides) targets this class, so host-parity styling reaches a\n * plugin's surface deterministically regardless of its plugin-specific class.\n */\nexport const EHX_PLUGIN_ROOT_CLASS = \"ehx-plugin-root\";\n\nexport interface DefinePlatformReactPluginPageOptions {\n  /** The page's static `useView` manifest slice (no `import.meta.glob` in a single-file bundle). */\n  manifest?: TemplateManifest;\n  /** Scoped style-root class wrapped around the page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element (idempotent across pages). */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n}\n\n/**\n * Wraps a lifted page as a PlatformReact entry with the providers the monolith\n * took for granted: react-query, the static `useView` manifest, and the scoped\n * style root. The host already provides the MCP transport (it mounts pages\n * inside its own runtime provider), so this adds only the in-page providers.\n */\nexport function definePlatformReactPluginPage(\n  Page: ComponentType<PlatformReactPageProps>,\n  options: DefinePlatformReactPluginPageOptions,\n): ComponentType<PlatformReactPageProps> {\n  const {\n    manifest = {},\n    rootClassName,\n    styleId,\n    css,\n    queryClient = defaultQueryClient,\n  } = options;\n\n  function PluginPage(props: PlatformReactPageProps) {\n    return createElement(\n      QueryClientProvider,\n      { client: queryClient },\n      createElement(\n        TemplateContext.Provider,\n        { value: manifest },\n        createElement(PluginStyleScope, { id: styleId, css }),\n        createElement(\n          \"div\",\n          { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },\n          createElement(Page, props),\n        ),\n      ),\n    );\n  }\n\n  return definePlatformReactPage(PluginPage);\n}\n\nexport interface PluginPageDefinerConfig {\n  /**\n   * The plugin's `useView` module key (e.g. `\"timesheets\"`). Each page's `views`\n   * are registered under it, so a page's `useView(module, name)` resolves them.\n   */\n  module: string;\n  /** Scoped style-root class wrapped around every page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element. */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n}\n\n/**\n * Builds a plugin-bound `definePluginPage(Page, views)` from one config, so a\n * plugin writes the four plugin-specific values (module key, root class, style\n * id, CSS) ONCE instead of in every page entry. Each surface entry then calls\n * `definePluginPage(Page, { ViewName })`; the flat `views` map is wrapped into\n * the `{ [module]: views }` manifest slice the page's `useView(module, name)`\n * reads. The generic provider/manifest/style wrapping stays in\n * {@link definePlatformReactPluginPage}.\n */\nexport function createPluginPageDefiner(config: PluginPageDefinerConfig) {\n  const { module, ...rest } = config;\n  return function definePluginPage(\n    Page: ComponentType<PlatformReactPageProps>,\n    views: Record<string, ViewComponent> = {},\n  ): ComponentType<PlatformReactPageProps> {\n    return definePlatformReactPluginPage(Page, { ...rest, manifest: { [module]: views } });\n  };\n}\n","import { createElement, type ComponentType } from \"react\";\n\n/**\n * Dependency-light fallback rendered when a view is not present in the current\n * template manifest. Kept to plain elements + inline styles so the foundation\n * package carries no UI-library dependency; plugins that want a branded\n * fallback pass their own via {@link createUseView}.\n */\nexport const MissingViewFallback: ComponentType<Record<string, unknown>> = () =>\n  createElement(\n    \"div\",\n    {\n      style: {\n        display: \"flex\",\n        alignItems: \"center\",\n        justifyContent: \"center\",\n        padding: \"2rem\",\n      },\n    },\n    createElement(\n      \"div\",\n      {\n        style: {\n          maxWidth: \"28rem\",\n          padding: \"1.5rem\",\n          border: \"1px solid rgba(0,0,0,0.12)\",\n          borderRadius: \"0.5rem\",\n          textAlign: \"center\",\n        },\n      },\n      createElement(\"p\", { style: { margin: \"0 0 0.5rem\", fontWeight: 600 } }, \"View not available\"),\n      createElement(\n        \"p\",\n        { style: { margin: 0, opacity: 0.7, fontSize: \"0.875rem\" } },\n        \"This view has not been implemented by the current template.\",\n      ),\n    ),\n  );\n","import { useContext, type ComponentType } from \"react\";\nimport { TemplateContext } from \"./templateContext\";\nimport { MissingViewFallback } from \"./MissingViewFallback\";\n\nconst REACT_LAZY_TYPE = Symbol.for(\"react.lazy\");\n\n/** Matches regular function components and `React.lazy` wrappers. */\nexport function isComponent(value: unknown): value is ComponentType {\n  if (typeof value === \"function\") return true;\n  if (typeof value === \"object\" && value !== null) {\n    return (value as Record<string, unknown>).$$typeof === REACT_LAZY_TYPE;\n  }\n  return false;\n}\n\n/**\n * Builds a `useView` hook bound to a fallback component. The hook is a safe\n * view accessor that never throws: it returns `manifest[module][viewName]` when\n * present, or the supplied fallback when the manifest, module slice, or view is\n * missing or is not a component.\n */\nexport function createUseView(fallback: ComponentType<Record<string, unknown>>) {\n  return function useView(\n    module: string,\n    viewName: string,\n  ): ComponentType<Record<string, unknown>> {\n    const manifest = useContext(TemplateContext);\n    if (!manifest) {\n      return fallback;\n    }\n\n    const slice = manifest[module];\n    if (slice && typeof slice === \"object\" && viewName in (slice as Record<string, unknown>)) {\n      const component = (slice as Record<string, unknown>)[viewName];\n      if (isComponent(component)) {\n        return component as ComponentType<Record<string, unknown>>;\n      }\n    }\n\n    return fallback;\n  };\n}\n\n/** Default `useView` bound to the built-in {@link MissingViewFallback}. */\nexport const useView = createUseView(MissingViewFallback);\n","import { useMemo } from \"react\";\nimport { useMcpTool } from \"@ethisyscore/extension-runtime/plugin\";\n\n/** Dispatches an MCP tool call by name. The seam a lifted REST service binds to. */\nexport type ToolInvoker = (toolName: string, args: unknown) => Promise<unknown>;\n\n/**\n * Base for service classes lifted from a monolith REST plane onto MCP.\n *\n * The monolith versions extend a REST base (`this.get`/`this.post` over axios).\n * The plugin runtime exposes no imperative MCP transport — only the\n * `useMcpTool` hook — so a `useXService()` hook composes per-tool invokers (see\n * {@link useToolInvokerMap}) into a single {@link ToolInvoker} and constructs\n * the class with it. Method bodies call `this.tool(\"<tool-name>\", args)`.\n */\nexport abstract class BaseMcpService {\n  constructor(private readonly invoker: ToolInvoker) {}\n\n  protected async tool<TRes>(name: string, args: unknown = {}): Promise<TRes> {\n    return (await this.invoker(name, args)) as TRes;\n  }\n}\n\n/**\n * Thrown by a lifted service method whose monolith REST route has no MCP tool\n * yet (typically because it needs client-side aggregation over a coarser tool).\n */\nexport function notViaMcp(serviceName: string, method: string): never {\n  throw new Error(`${serviceName}.${method} has no MCP tool — pending per-surface aggregation.`);\n}\n\n/** Imperative invoker for a single MCP tool (the hook's `.invoke`, stable across renders). */\nexport function useToolInvoker<TReq, TRes>(toolName: string): (req: TReq) => Promise<TRes> {\n  return useMcpTool<TReq, TRes>(toolName).invoke;\n}\n\n/**\n * Composes one {@link ToolInvoker} dispatching over every tool in `tools`, so a\n * service class can call tools by name.\n *\n * Rules of hooks: `tools` MUST be a frozen, constant-length list (e.g. a\n * module-level `as const` array) so the per-tool `useMcpTool` calls run in a\n * stable order on every render. Passing a list whose length varies between\n * renders is a violation and will break.\n */\nexport function useToolInvokerMap(tools: readonly string[]): ToolInvoker {\n  const invokers: Record<string, (args: unknown) => Promise<unknown>> = {};\n  for (const name of tools) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks -- `tools` is required to be frozen; call order is stable.\n    invokers[name] = useMcpTool(name).invoke;\n  }\n  return useMemo<ToolInvoker>(\n    () => (name, args) => {\n      const fn = invokers[name];\n      if (!fn) {\n        throw new Error(`No MCP invoker registered for tool \"${name}\"`);\n      }\n      return fn(args);\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- per-tool invoke refs are stable; rebuild only if one changes.\n    tools.map((t) => invokers[t]),\n  );\n}\n","import {\n  useQueries,\n  useQuery,\n  type QueryKey,\n  type UseQueryOptions,\n  type UseQueryResult,\n} from \"@tanstack/react-query\";\n\n/**\n * Plugin shim for the monolith's `useAuthenticatedQuery`.\n *\n * In the host realm the MCP transport is already authenticated and scoped to\n * the active organisation, so there is no auth gate to apply. The hook keeps\n * the monolith's return shape (`isLoading` + `isAuthLoading`) so lifted data\n * hooks and pages consume it unchanged — `isAuthLoading` is always `false`.\n */\nexport interface AuthenticatedQueryResult<TData, TError>\n  extends Omit<UseQueryResult<TData, TError>, \"isLoading\"> {\n  isLoading: boolean;\n  isAuthLoading: boolean;\n}\n\nexport function useAuthenticatedQuery<\n  TQueryFnData = unknown,\n  TError = Error,\n  TData = TQueryFnData,\n  TQueryKey extends QueryKey = QueryKey,\n>(\n  options: UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n): AuthenticatedQueryResult<TData, TError> {\n  const result = useQuery(options);\n  return {\n    ...result,\n    isLoading: result.isLoading,\n    isAuthLoading: false,\n  };\n}\n\nexport function useAuthenticatedQueries<TQueryFnData = unknown, TError = Error>(\n  queries: UseQueryOptions<TQueryFnData, TError>[],\n) {\n  return useQueries({ queries });\n}\n","import { createElement, type AnchorHTMLAttributes, type MouseEvent, type ReactNode } from \"react\";\nimport { emitNavigation } from \"@ethisyscore/components-react\";\n\n/**\n * Minimal `react-router-dom` compatibility shim for lifted monolith code.\n *\n * A PlatformReact plugin has no client router — navigation is brokered to the\n * host via {@link emitNavigation}, and route params come from the surface URL's\n * trailing segment(s). {@link createReactRouterShim} returns a module-shaped\n * object of the hooks/components lifted code expects; alias `react-router-dom`\n * to a tiny file that re-exports this object's members so call sites resolve\n * unchanged.\n *\n * `paramKeys` names the keys the single trailing path segment is exposed under,\n * so a route like `/…/<page>/<value>` satisfies `useParams<{ id }>()` /\n * `useParams<{ date }>()` regardless of which key the lifted code destructures.\n */\nexport interface ReactRouterShimOptions {\n  /** Keys the trailing path segment is exposed under (default: `[\"id\"]`). */\n  paramKeys?: readonly string[];\n}\n\ntype LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {\n  to: string;\n  children?: ReactNode;\n};\n\nexport function createReactRouterShim(options: ReactRouterShimOptions = {}) {\n  const paramKeys = options.paramKeys ?? [\"id\"];\n\n  function useNavigate(): (to: string | number) => void {\n    return (to) => {\n      if (typeof to === \"number\") {\n        if (typeof window !== \"undefined\") window.history.go(to);\n        return;\n      }\n      emitNavigation(to);\n    };\n  }\n\n  function useParams<\n    T extends Record<string, string | undefined> = Record<string, string | undefined>,\n  >(): T {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"\";\n    const segments = path.split(\"/\").filter(Boolean);\n    const last = segments[segments.length - 1];\n    const params: Record<string, string | undefined> = {};\n    if (last) {\n      for (const key of paramKeys) {\n        params[key] = last;\n      }\n    }\n    return params as T;\n  }\n\n  function useSearchParams(): [\n    URLSearchParams,\n    (next: URLSearchParams | Record<string, string>) => void,\n  ] {\n    const search = typeof window !== \"undefined\" ? window.location.search : \"\";\n    const params = new URLSearchParams(search);\n    const setSearchParams = (next: URLSearchParams | Record<string, string>) => {\n      const usp = next instanceof URLSearchParams ? next : new URLSearchParams(next);\n      const qs = usp.toString();\n      if (typeof window !== \"undefined\") {\n        window.history.replaceState(\n          {},\n          \"\",\n          qs ? `${window.location.pathname}?${qs}` : window.location.pathname,\n        );\n      }\n    };\n    return [params, setSearchParams];\n  }\n\n  function useMatch(\n    _pattern: string,\n  ): { params: Record<string, string | undefined>; pathname: string } | null {\n    return null;\n  }\n\n  function useLocation() {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"/\";\n    return { pathname: path, search: \"\", hash: \"\", state: null, key: \"default\" };\n  }\n\n  function Link({ to, children, onClick, ...rest }: LinkProps) {\n    return createElement(\n      \"a\",\n      {\n        href: to,\n        onClick: (e: MouseEvent<HTMLAnchorElement>) => {\n          e.preventDefault();\n          onClick?.(e);\n          emitNavigation(to);\n        },\n        ...rest,\n      },\n      children,\n    );\n  }\n\n  return { useNavigate, useParams, useSearchParams, useMatch, useLocation, Link, NavLink: Link };\n}\n"]}
+{"version":3,"sources":["../../src/platform-react/templateContext.ts","../../src/platform-react/injectStyles.ts","../../src/platform-react/definePlatformReactPluginPage.tsx","../../src/platform-react/MissingViewFallback.tsx","../../src/platform-react/useView.ts","../../src/platform-react/mcpService.ts","../../src/platform-react/useAuthenticatedQuery.ts","../../src/platform-react/reactRouterShim.tsx"],"names":["createContext","useEffect","QueryClient","createElement","QueryClientProvider","definePlatformReactPage","useView","useContext","useMcpTool","useMemo","useQuery","useQueries","emitNavigation"],"mappings":";;;;;;;;AAeO,IAAM,eAAA,GAAkBA,oBAAuC,IAAI;ACJnE,SAAS,kBAAA,CAAmB,IAAY,GAAA,EAAmB;AAChE,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACrC,EAAA,IAAI,QAAA,CAAS,cAAA,CAAe,EAAE,CAAA,EAAG;AACjC,EAAA,MAAM,EAAA,GAAK,QAAA,CAAS,aAAA,CAAc,OAAO,CAAA;AACzC,EAAA,EAAA,CAAG,EAAA,GAAK,EAAA;AACR,EAAA,EAAA,CAAG,WAAA,GAAc,GAAA;AACjB,EAAA,QAAA,CAAS,IAAA,CAAK,YAAY,EAAE,CAAA;AAC9B;AAGO,SAAS,gBAAA,CAAiB,EAAE,EAAA,EAAI,GAAA,EAAI,EAAsC;AAC/E,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,kBAAA,CAAmB,IAAI,GAAG,CAAA;AAAA,EAC5B,CAAA,EAAG,CAAC,EAAA,EAAI,GAAG,CAAC,CAAA;AACZ,EAAA,OAAO,IAAA;AACT;;;ACZA,SAAS,sBAAA,GAAsC;AAC7C,EAAA,OAAO,IAAIC,sBAAA,CAAY;AAAA,IACrB,cAAA,EAAgB;AAAA,MACd,OAAA,EAAS;AAAA,QACP,KAAA,EAAO,CAAA;AAAA,QACP,oBAAA,EAAsB,KAAA;AAAA,QACtB,SAAA,EAAW;AAAA;AACb;AACF,GACD,CAAA;AACH;AAEA,IAAM,qBAAqB,sBAAA,EAAuB;AAQ3C,IAAM,qBAAA,GAAwB;AAkC9B,SAAS,6BAAA,CACd,MACA,OAAA,EACuC;AACvC,EAAA,MAAM;AAAA,IACJ,WAAW,EAAC;AAAA,IACZ,aAAA;AAAA,IACA,OAAA;AAAA,IACA,GAAA;AAAA,IACA,WAAA,GAAc,kBAAA;AAAA,IACd;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,SAAS,WAAW,KAAA,EAA+B;AACjD,IAAA,MAAM,IAAA,GAAOC,mBAAA,CAAc,IAAA,EAAM,KAAK,CAAA;AACtC,IAAA,MAAM,IAAA,GAAO,QAAA,GAAW,QAAA,CAAS,IAAI,CAAA,GAAI,IAAA;AACzC,IAAA,OAAOA,mBAAA;AAAA,MACLC,8BAAA;AAAA,MACA,EAAE,QAAQ,WAAA,EAAY;AAAA,MACtBD,mBAAA;AAAA,QACE,eAAA,CAAgB,QAAA;AAAA,QAChB,EAAE,OAAO,QAAA,EAAS;AAAA,QAClBA,oBAAc,gBAAA,EAAkB,EAAE,EAAA,EAAI,OAAA,EAAS,KAAK,CAAA;AAAA,QACpDA,mBAAA;AAAA,UACE,KAAA;AAAA,UACA,EAAE,SAAA,EAAW,CAAA,EAAG,qBAAqB,CAAA,CAAA,EAAI,aAAa,CAAA,CAAA,EAAG;AAAA,UACzD;AAAA;AACF;AACF,KACF;AAAA,EACF;AAEA,EAAA,OAAOE,wCAAwB,UAAU,CAAA;AAC3C;AAiCO,SAAS,wBAAwB,MAAA,EAAiC;AACvE,EAAA,MAAM,EAAE,MAAA,EAAQ,GAAG,IAAA,EAAK,GAAI,MAAA;AAC5B,EAAA,OAAO,SAAS,gBAAA,CACd,IAAA,EACA,KAAA,GAAuC,EAAC,EACD;AACvC,IAAA,OAAO,6BAAA,CAA8B,IAAA,EAAM,EAAE,GAAG,IAAA,EAAM,QAAA,EAAU,EAAE,CAAC,MAAM,GAAG,KAAA,EAAM,EAAG,CAAA;AAAA,EACvF,CAAA;AACF;ACtIO,IAAM,sBAA8D,MACzEF,mBAAAA;AAAA,EACE,KAAA;AAAA,EACA;AAAA,IACE,KAAA,EAAO;AAAA,MACL,OAAA,EAAS,MAAA;AAAA,MACT,UAAA,EAAY,QAAA;AAAA,MACZ,cAAA,EAAgB,QAAA;AAAA,MAChB,OAAA,EAAS;AAAA;AACX,GACF;AAAA,EACAA,mBAAAA;AAAA,IACE,KAAA;AAAA,IACA;AAAA,MACE,KAAA,EAAO;AAAA,QACL,QAAA,EAAU,OAAA;AAAA,QACV,OAAA,EAAS,QAAA;AAAA,QACT,MAAA,EAAQ,4BAAA;AAAA,QACR,YAAA,EAAc,QAAA;AAAA,QACd,SAAA,EAAW;AAAA;AACb,KACF;AAAA,IACAA,mBAAAA,CAAc,GAAA,EAAK,EAAE,KAAA,EAAO,EAAE,MAAA,EAAQ,YAAA,EAAc,UAAA,EAAY,GAAA,EAAI,EAAE,EAAG,oBAAoB,CAAA;AAAA,IAC7FA,mBAAAA;AAAA,MACE,GAAA;AAAA,MACA,EAAE,OAAO,EAAE,MAAA,EAAQ,GAAG,OAAA,EAAS,GAAA,EAAK,QAAA,EAAU,UAAA,EAAW,EAAE;AAAA,MAC3D;AAAA;AACF;AAEJ;;;ACjCF,IAAM,eAAA,mBAAkB,MAAA,CAAO,GAAA,CAAI,YAAY,CAAA;AAGxC,SAAS,YAAY,KAAA,EAAwC;AAClE,EAAA,IAAI,OAAO,KAAA,KAAU,UAAA,EAAY,OAAO,IAAA;AACxC,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,EAAM;AAC/C,IAAA,OAAQ,MAAkC,QAAA,KAAa,eAAA;AAAA,EACzD;AACA,EAAA,OAAO,KAAA;AACT;AAQO,SAAS,cAAc,QAAA,EAAkD;AAC9E,EAAA,OAAO,SAASG,QAAAA,CACd,MAAA,EACA,QAAA,EACwC;AACxC,IAAA,MAAM,QAAA,GAAWC,iBAAW,eAAe,CAAA;AAC3C,IAAA,IAAI,CAAC,QAAA,EAAU;AACb,MAAA,OAAO,QAAA;AAAA,IACT;AAEA,IAAA,MAAM,KAAA,GAAQ,SAAS,MAAM,CAAA;AAC7B,IAAA,IAAI,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,IAAY,YAAa,KAAA,EAAmC;AACxF,MAAA,MAAM,SAAA,GAAa,MAAkC,QAAQ,CAAA;AAC7D,MAAA,IAAI,WAAA,CAAY,SAAS,CAAA,EAAG;AAC1B,QAAA,OAAO,SAAA;AAAA,MACT;AAAA,IACF;AAEA,IAAA,OAAO,QAAA;AAAA,EACT,CAAA;AACF;AAGO,IAAM,OAAA,GAAU,cAAc,mBAAmB;AC7BjD,IAAe,iBAAf,MAA8B;AAAA,EACnC,YAA6B,OAAA,EAAsB;AAAtB,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAAA,EAAuB;AAAA,EAAvB,OAAA;AAAA,EAE7B,MAAgB,IAAA,CAAW,IAAA,EAAc,IAAA,GAAgB,EAAC,EAAkB;AAC1E,IAAA,OAAQ,MAAM,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,IAAI,CAAA;AAAA,EACvC;AACF;AAMO,SAAS,SAAA,CAAU,aAAqB,MAAA,EAAuB;AACpE,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,WAAW,CAAA,CAAA,EAAI,MAAM,CAAA,wDAAA,CAAqD,CAAA;AAC/F;AAGO,SAAS,eAA2B,QAAA,EAAgD;AACzF,EAAA,OAAOC,iBAAA,CAAuB,QAAQ,CAAA,CAAE,MAAA;AAC1C;AAWO,SAAS,kBAAkB,KAAA,EAAuC;AACvE,EAAA,MAAM,WAAgE,EAAC;AACvE,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AAExB,IAAA,QAAA,CAAS,IAAI,CAAA,GAAIA,iBAAA,CAAW,IAAI,CAAA,CAAE,MAAA;AAAA,EACpC;AACA,EAAA,OAAOC,aAAA;AAAA,IACL,MAAM,CAAC,IAAA,EAAM,IAAA,KAAS;AACpB,MAAA,MAAM,EAAA,GAAK,SAAS,IAAI,CAAA;AACxB,MAAA,IAAI,CAAC,EAAA,EAAI;AACP,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oCAAA,EAAuC,IAAI,CAAA,CAAA,CAAG,CAAA;AAAA,MAChE;AACA,MAAA,OAAO,GAAG,IAAI,CAAA;AAAA,IAChB,CAAA;AAAA;AAAA,IAEA,MAAM,GAAA,CAAI,CAAC,CAAA,KAAM,QAAA,CAAS,CAAC,CAAC;AAAA,GAC9B;AACF;ACxCO,SAAS,sBAMd,OAAA,EACyC;AACzC,EAAA,MAAM,MAAA,GAASC,oBAAS,OAAO,CAAA;AAC/B,EAAA,OAAO;AAAA,IACL,GAAG,MAAA;AAAA,IACH,WAAW,MAAA,CAAO,SAAA;AAAA,IAClB,aAAA,EAAe;AAAA,GACjB;AACF;AAEO,SAAS,wBACd,OAAA,EACA;AACA,EAAA,OAAOC,qBAAA,CAAW,EAAE,OAAA,EAAS,CAAA;AAC/B;ACLA,SAAS,gBAAA,CACP,QAAA,EACA,MAAA,EACA,QAAA,EAC+B;AAC/B,EAAA,MAAM,MAAA,GAAS,QAAA,CAAS,MAAA,GAAS,CAAA,IAAK,QAAA,CAAS,QAAA,CAAS,GAAG,CAAA,GAAI,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,QAAA;AACvF,EAAA,MAAM,IAAA,GAAO,QAAA,CAAS,MAAA,GAAS,CAAA,IAAK,QAAA,CAAS,QAAA,CAAS,GAAG,CAAA,GAAI,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,QAAA;AACrF,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,MAAA,CAAO,MAAM,CAAA,CAAE,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA,GAAI,EAAA;AACvF,EAAA,MAAM,QAAA,GAAW,KAAK,MAAA,GAAS,CAAA,GAAI,KAAK,KAAA,CAAM,GAAG,IAAI,EAAC;AAEtD,EAAA,IAAI,IAAA,GAAsC,IAAA;AAC1C,EAAA,IAAI,YAAA,GAAe,EAAA;AACnB,EAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,IAAA,MAAM,UAAU,KAAA,CAAM,KAAA,CAAM,GAAG,CAAA,CAAE,OAAO,OAAO,CAAA;AAC/C,IAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,QAAA,CAAS,MAAA,EAAQ;AACtC,MAAA;AAAA,IACF;AACA,IAAA,MAAM,SAAiC,EAAC;AACxC,IAAA,IAAI,QAAA,GAAW,CAAA;AACf,IAAA,IAAI,EAAA,GAAK,IAAA;AACT,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,OAAA,CAAQ,QAAQ,CAAA,EAAA,EAAK;AACvC,MAAA,IAAI,OAAA,CAAQ,CAAC,CAAA,CAAE,UAAA,CAAW,GAAG,CAAA,EAAG;AAC9B,QAAA,MAAA,CAAO,OAAA,CAAQ,CAAC,CAAA,CAAE,KAAA,CAAM,CAAC,CAAC,CAAA,GAAI,SAAS,CAAC,CAAA;AAAA,MAC1C,WAAW,OAAA,CAAQ,CAAC,CAAA,KAAM,QAAA,CAAS,CAAC,CAAA,EAAG;AACrC,QAAA,EAAA,GAAK,KAAA;AACL,QAAA;AAAA,MACF,CAAA,MAAO;AACL,QAAA,QAAA,EAAA;AAAA,MACF;AAAA,IACF;AACA,IAAA,IAAI,EAAA,IAAM,WAAW,YAAA,EAAc;AACjC,MAAA,IAAA,GAAO,MAAA;AACP,MAAA,YAAA,GAAe,QAAA;AAAA,IACjB;AAAA,EACF;AACA,EAAA,OAAO,IAAA;AACT;AAOO,SAAS,qBAAA,CAAsB,OAAA,GAAkC,EAAC,EAAG;AAC1E,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,SAAA,IAAa,CAAC,IAAI,CAAA;AAC5C,EAAA,MAAM,SAAS,OAAA,CAAQ,MAAA;AACvB,EAAA,MAAM,QAAA,GAAW,QAAQ,QAAA,IAAY,EAAA;AAErC,EAAA,SAAS,WAAA,GAA6C;AACpD,IAAA,OAAO,CAAC,EAAA,KAAO;AACb,MAAA,IAAI,OAAO,OAAO,QAAA,EAAU;AAC1B,QAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,MAAA,CAAO,OAAA,CAAQ,GAAG,EAAE,CAAA;AACvD,QAAA;AAAA,MACF;AACA,MAAAC,8BAAA,CAAe,EAAE,CAAA;AAAA,IACnB,CAAA;AAAA,EACF;AAEA,EAAA,SAAS,SAAA,GAEF;AACL,IAAA,MAAM,OAAO,OAAO,MAAA,KAAW,WAAA,GAAc,MAAA,CAAO,SAAS,QAAA,GAAW,EAAA;AAGxE,IAAA,IAAI,MAAA,IAAU,IAAA,IAAQ,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG;AACvC,MAAA,MAAM,OAAA,GAAU,gBAAA,CAAiB,IAAA,EAAM,MAAA,EAAQ,QAAQ,CAAA;AACvD,MAAA,IAAI,WAAW,IAAA,EAAM;AACnB,QAAA,OAAO,OAAA;AAAA,MACT;AAAA,IACF;AAEA,IAAA,MAAM,WAAW,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA,CAAE,OAAO,OAAO,CAAA;AAC/C,IAAA,MAAM,IAAA,GAAO,QAAA,CAAS,QAAA,CAAS,MAAA,GAAS,CAAC,CAAA;AACzC,IAAA,MAAM,SAA6C,EAAC;AACpD,IAAA,IAAI,IAAA,EAAM;AACR,MAAA,KAAA,MAAW,OAAO,SAAA,EAAW;AAC3B,QAAA,MAAA,CAAO,GAAG,CAAA,GAAI,IAAA;AAAA,MAChB;AAAA,IACF;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,SAAS,eAAA,GAGP;AACA,IAAA,MAAM,SAAS,OAAO,MAAA,KAAW,WAAA,GAAc,MAAA,CAAO,SAAS,MAAA,GAAS,EAAA;AACxE,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,CAAgB,MAAM,CAAA;AACzC,IAAA,MAAM,eAAA,GAAkB,CAAC,IAAA,KAAmD;AAC1E,MAAA,MAAM,MAAM,IAAA,YAAgB,eAAA,GAAkB,IAAA,GAAO,IAAI,gBAAgB,IAAI,CAAA;AAC7E,MAAA,MAAM,EAAA,GAAK,IAAI,QAAA,EAAS;AACxB,MAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,QAAA,MAAA,CAAO,OAAA,CAAQ,YAAA;AAAA,UACb,EAAC;AAAA,UACD,EAAA;AAAA,UACA,EAAA,GAAK,GAAG,MAAA,CAAO,QAAA,CAAS,QAAQ,CAAA,CAAA,EAAI,EAAE,CAAA,CAAA,GAAK,MAAA,CAAO,QAAA,CAAS;AAAA,SAC7D;AAAA,MACF;AAAA,IACF,CAAA;AACA,IAAA,OAAO,CAAC,QAAQ,eAAe,CAAA;AAAA,EACjC;AAEA,EAAA,SAAS,SACP,QAAA,EACyE;AACzE,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,SAAS,WAAA,GAAc;AACrB,IAAA,MAAM,OAAO,OAAO,MAAA,KAAW,WAAA,GAAc,MAAA,CAAO,SAAS,QAAA,GAAW,GAAA;AACxE,IAAA,OAAO,EAAE,QAAA,EAAU,IAAA,EAAM,MAAA,EAAQ,EAAA,EAAI,MAAM,EAAA,EAAI,KAAA,EAAO,IAAA,EAAM,GAAA,EAAK,SAAA,EAAU;AAAA,EAC7E;AAEA,EAAA,SAAS,KAAK,EAAE,EAAA,EAAI,UAAU,OAAA,EAAS,GAAG,MAAK,EAAc;AAC3D,IAAA,OAAOT,mBAAAA;AAAA,MACL,GAAA;AAAA,MACA;AAAA,QACE,IAAA,EAAM,EAAA;AAAA,QACN,OAAA,EAAS,CAAC,CAAA,KAAqC;AAC7C,UAAA,CAAA,CAAE,cAAA,EAAe;AACjB,UAAA,OAAA,GAAU,CAAC,CAAA;AACX,UAAAS,8BAAA,CAAe,EAAE,CAAA;AAAA,QACnB,CAAA;AAAA,QACA,GAAG;AAAA,OACL;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,aAAa,SAAA,EAAW,eAAA,EAAiB,UAAU,WAAA,EAAa,IAAA,EAAM,SAAS,IAAA,EAAK;AAC/F","file":"index.cjs","sourcesContent":["import { createContext, type ComponentType } from \"react\";\n\n/** A view component resolved from the template manifest. Props are open. */\nexport type ViewComponent = ComponentType<Record<string, unknown>>;\n\n/**\n * Static port of the monolith's gogo-ui adapter mechanism for PlatformReact.\n *\n * A monolith feature picks its adapter view at runtime via `import.meta.glob`;\n * a PlatformReact page is a single self-contained ESM bundle where that glob is\n * unavailable, so each page declares its view slice statically and provides it\n * through this context. The shape is `manifest[module][viewName] = Component`.\n */\nexport type TemplateManifest = Record<string, Partial<Record<string, ViewComponent>>>;\n\nexport const TemplateContext = createContext<TemplateManifest | null>(null);\n","import { useEffect } from \"react\";\n\n/**\n * Injects a plugin's compiled CSS into the host document once, keyed by a\n * stable element id (idempotent across pages and re-mounts).\n *\n * Each PlatformReact page is a separate ESM bundle with no companion CSS asset\n * the host would load, so the styles travel inside the bundle (typically via a\n * `*.css?inline` import) and are mounted at runtime. Scope the CSS to a plugin\n * root class (never `:root`) so it cannot override the host theme.\n */\nexport function injectPluginStyles(id: string, css: string): void {\n  if (typeof document === \"undefined\") return;\n  if (document.getElementById(id)) return;\n  const el = document.createElement(\"style\");\n  el.id = id;\n  el.textContent = css;\n  document.head.appendChild(el);\n}\n\n/** Component form of {@link injectPluginStyles}; renders nothing. */\nexport function PluginStyleScope({ id, css }: { id: string; css: string }): null {\n  useEffect(() => {\n    injectPluginStyles(id, css);\n  }, [id, css]);\n  return null;\n}\n","import { createElement, type ComponentType, type ReactElement } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport {\n  definePlatformReactPage,\n  type PlatformReactPageProps,\n} from \"@ethisyscore/components-react\";\nimport { TemplateContext, type TemplateManifest, type ViewComponent } from \"./templateContext\";\nimport { PluginStyleScope } from \"./injectStyles\";\n\n/**\n * Default per-page `QueryClient`. Each PlatformReact page is an isolated ESM\n * bundle, so this module-level singleton is scoped to that page — exactly the\n * lifetime a page wants. Plugins needing different options pass their own.\n */\nfunction makeDefaultQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        retry: 1,\n        refetchOnWindowFocus: false,\n        staleTime: 30_000,\n      },\n    },\n  });\n}\n\nconst defaultQueryClient = makeDefaultQueryClient();\n\n/**\n * Shared root class applied to every plugin page wrapper, in addition to the\n * plugin's own `rootClassName`. The SDK's `plugin-base.css` (scoped resets +\n * component overrides) targets this class, so host-parity styling reaches a\n * plugin's surface deterministically regardless of its plugin-specific class.\n */\nexport const EHX_PLUGIN_ROOT_CLASS = \"ehx-plugin-root\";\n\nexport interface DefinePlatformReactPluginPageOptions {\n  /** The page's static `useView` manifest slice (no `import.meta.glob` in a single-file bundle). */\n  manifest?: TemplateManifest;\n  /** Scoped style-root class wrapped around the page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element (idempotent across pages). */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n  /**\n   * Optional wrapper applied around the page element, inside the style root. Use\n   * to add a plugin-specific in-page provider — e.g. `withPageHeader(config)` from\n   * `@ethisyscore/plugin-ui/components/layout` to restore list-page header CTAs.\n   *\n   * The wrapper is supplied as a ready-made function (not a config object) so this\n   * entry stays free of the page-header React context — the provider and the\n   * page's `usePageHeader` must resolve to the SAME `components/layout` module\n   * instance, which they only do when both come from that entry (bundlers inline a\n   * separate context copy per entry otherwise).\n   */\n  wrapPage?: (page: ReactElement) => ReactElement;\n}\n\n/**\n * Wraps a lifted page as a PlatformReact entry with the providers the monolith\n * took for granted: react-query, the static `useView` manifest, the scoped style\n * root, and — when `wrapPage` is supplied — a plugin-specific in-page provider\n * (e.g. the page-header). The host already provides the MCP transport (it mounts\n * pages inside its own runtime provider), so this adds only the in-page providers.\n */\nexport function definePlatformReactPluginPage(\n  Page: ComponentType<PlatformReactPageProps>,\n  options: DefinePlatformReactPluginPageOptions,\n): ComponentType<PlatformReactPageProps> {\n  const {\n    manifest = {},\n    rootClassName,\n    styleId,\n    css,\n    queryClient = defaultQueryClient,\n    wrapPage,\n  } = options;\n\n  function PluginPage(props: PlatformReactPageProps) {\n    const page = createElement(Page, props);\n    const body = wrapPage ? wrapPage(page) : page;\n    return createElement(\n      QueryClientProvider,\n      { client: queryClient },\n      createElement(\n        TemplateContext.Provider,\n        { value: manifest },\n        createElement(PluginStyleScope, { id: styleId, css }),\n        createElement(\n          \"div\",\n          { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },\n          body,\n        ),\n      ),\n    );\n  }\n\n  return definePlatformReactPage(PluginPage);\n}\n\nexport interface PluginPageDefinerConfig {\n  /**\n   * The plugin's `useView` module key (e.g. `\"timesheets\"`). Each page's `views`\n   * are registered under it, so a page's `useView(module, name)` resolves them.\n   */\n  module: string;\n  /** Scoped style-root class wrapped around every page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element. */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n  /**\n   * Optional wrapper applied around every page (see\n   * {@link DefinePlatformReactPluginPageOptions.wrapPage}) — e.g.\n   * `withPageHeader(<feature>MenuConfig)` to restore list-page header CTAs.\n   */\n  wrapPage?: (page: ReactElement) => ReactElement;\n}\n\n/**\n * Builds a plugin-bound `definePluginPage(Page, views)` from one config, so a\n * plugin writes the four plugin-specific values (module key, root class, style\n * id, CSS) ONCE instead of in every page entry. Each surface entry then calls\n * `definePluginPage(Page, { ViewName })`; the flat `views` map is wrapped into\n * the `{ [module]: views }` manifest slice the page's `useView(module, name)`\n * reads. The generic provider/manifest/style wrapping stays in\n * {@link definePlatformReactPluginPage}.\n */\nexport function createPluginPageDefiner(config: PluginPageDefinerConfig) {\n  const { module, ...rest } = config;\n  return function definePluginPage(\n    Page: ComponentType<PlatformReactPageProps>,\n    views: Record<string, ViewComponent> = {},\n  ): ComponentType<PlatformReactPageProps> {\n    return definePlatformReactPluginPage(Page, { ...rest, manifest: { [module]: views } });\n  };\n}\n","import { createElement, type ComponentType } from \"react\";\n\n/**\n * Dependency-light fallback rendered when a view is not present in the current\n * template manifest. Kept to plain elements + inline styles so the foundation\n * package carries no UI-library dependency; plugins that want a branded\n * fallback pass their own via {@link createUseView}.\n */\nexport const MissingViewFallback: ComponentType<Record<string, unknown>> = () =>\n  createElement(\n    \"div\",\n    {\n      style: {\n        display: \"flex\",\n        alignItems: \"center\",\n        justifyContent: \"center\",\n        padding: \"2rem\",\n      },\n    },\n    createElement(\n      \"div\",\n      {\n        style: {\n          maxWidth: \"28rem\",\n          padding: \"1.5rem\",\n          border: \"1px solid rgba(0,0,0,0.12)\",\n          borderRadius: \"0.5rem\",\n          textAlign: \"center\",\n        },\n      },\n      createElement(\"p\", { style: { margin: \"0 0 0.5rem\", fontWeight: 600 } }, \"View not available\"),\n      createElement(\n        \"p\",\n        { style: { margin: 0, opacity: 0.7, fontSize: \"0.875rem\" } },\n        \"This view has not been implemented by the current template.\",\n      ),\n    ),\n  );\n","import { useContext, type ComponentType } from \"react\";\nimport { TemplateContext } from \"./templateContext\";\nimport { MissingViewFallback } from \"./MissingViewFallback\";\n\nconst REACT_LAZY_TYPE = Symbol.for(\"react.lazy\");\n\n/** Matches regular function components and `React.lazy` wrappers. */\nexport function isComponent(value: unknown): value is ComponentType {\n  if (typeof value === \"function\") return true;\n  if (typeof value === \"object\" && value !== null) {\n    return (value as Record<string, unknown>).$$typeof === REACT_LAZY_TYPE;\n  }\n  return false;\n}\n\n/**\n * Builds a `useView` hook bound to a fallback component. The hook is a safe\n * view accessor that never throws: it returns `manifest[module][viewName]` when\n * present, or the supplied fallback when the manifest, module slice, or view is\n * missing or is not a component.\n */\nexport function createUseView(fallback: ComponentType<Record<string, unknown>>) {\n  return function useView(\n    module: string,\n    viewName: string,\n  ): ComponentType<Record<string, unknown>> {\n    const manifest = useContext(TemplateContext);\n    if (!manifest) {\n      return fallback;\n    }\n\n    const slice = manifest[module];\n    if (slice && typeof slice === \"object\" && viewName in (slice as Record<string, unknown>)) {\n      const component = (slice as Record<string, unknown>)[viewName];\n      if (isComponent(component)) {\n        return component as ComponentType<Record<string, unknown>>;\n      }\n    }\n\n    return fallback;\n  };\n}\n\n/** Default `useView` bound to the built-in {@link MissingViewFallback}. */\nexport const useView = createUseView(MissingViewFallback);\n","import { useMemo } from \"react\";\nimport { useMcpTool } from \"@ethisyscore/extension-runtime/plugin\";\n\n/** Dispatches an MCP tool call by name. The seam a lifted REST service binds to. */\nexport type ToolInvoker = (toolName: string, args: unknown) => Promise<unknown>;\n\n/**\n * Base for service classes lifted from a monolith REST plane onto MCP.\n *\n * The monolith versions extend a REST base (`this.get`/`this.post` over axios).\n * The plugin runtime exposes no imperative MCP transport — only the\n * `useMcpTool` hook — so a `useXService()` hook composes per-tool invokers (see\n * {@link useToolInvokerMap}) into a single {@link ToolInvoker} and constructs\n * the class with it. Method bodies call `this.tool(\"<tool-name>\", args)`.\n */\nexport abstract class BaseMcpService {\n  constructor(private readonly invoker: ToolInvoker) {}\n\n  protected async tool<TRes>(name: string, args: unknown = {}): Promise<TRes> {\n    return (await this.invoker(name, args)) as TRes;\n  }\n}\n\n/**\n * Thrown by a lifted service method whose monolith REST route has no MCP tool\n * yet (typically because it needs client-side aggregation over a coarser tool).\n */\nexport function notViaMcp(serviceName: string, method: string): never {\n  throw new Error(`${serviceName}.${method} has no MCP tool — pending per-surface aggregation.`);\n}\n\n/** Imperative invoker for a single MCP tool (the hook's `.invoke`, stable across renders). */\nexport function useToolInvoker<TReq, TRes>(toolName: string): (req: TReq) => Promise<TRes> {\n  return useMcpTool<TReq, TRes>(toolName).invoke;\n}\n\n/**\n * Composes one {@link ToolInvoker} dispatching over every tool in `tools`, so a\n * service class can call tools by name.\n *\n * Rules of hooks: `tools` MUST be a frozen, constant-length list (e.g. a\n * module-level `as const` array) so the per-tool `useMcpTool` calls run in a\n * stable order on every render. Passing a list whose length varies between\n * renders is a violation and will break.\n */\nexport function useToolInvokerMap(tools: readonly string[]): ToolInvoker {\n  const invokers: Record<string, (args: unknown) => Promise<unknown>> = {};\n  for (const name of tools) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks -- `tools` is required to be frozen; call order is stable.\n    invokers[name] = useMcpTool(name).invoke;\n  }\n  return useMemo<ToolInvoker>(\n    () => (name, args) => {\n      const fn = invokers[name];\n      if (!fn) {\n        throw new Error(`No MCP invoker registered for tool \"${name}\"`);\n      }\n      return fn(args);\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- per-tool invoke refs are stable; rebuild only if one changes.\n    tools.map((t) => invokers[t]),\n  );\n}\n","import {\n  useQueries,\n  useQuery,\n  type QueryKey,\n  type UseQueryOptions,\n  type UseQueryResult,\n} from \"@tanstack/react-query\";\n\n/**\n * Plugin shim for the monolith's `useAuthenticatedQuery`.\n *\n * In the host realm the MCP transport is already authenticated and scoped to\n * the active organisation, so there is no auth gate to apply. The hook keeps\n * the monolith's return shape (`isLoading` + `isAuthLoading`) so lifted data\n * hooks and pages consume it unchanged — `isAuthLoading` is always `false`.\n */\nexport interface AuthenticatedQueryResult<TData, TError>\n  extends Omit<UseQueryResult<TData, TError>, \"isLoading\"> {\n  isLoading: boolean;\n  isAuthLoading: boolean;\n}\n\nexport function useAuthenticatedQuery<\n  TQueryFnData = unknown,\n  TError = Error,\n  TData = TQueryFnData,\n  TQueryKey extends QueryKey = QueryKey,\n>(\n  options: UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n): AuthenticatedQueryResult<TData, TError> {\n  const result = useQuery(options);\n  return {\n    ...result,\n    isLoading: result.isLoading,\n    isAuthLoading: false,\n  };\n}\n\nexport function useAuthenticatedQueries<TQueryFnData = unknown, TError = Error>(\n  queries: UseQueryOptions<TQueryFnData, TError>[],\n) {\n  return useQueries({ queries });\n}\n","import { createElement, type AnchorHTMLAttributes, type MouseEvent, type ReactNode } from \"react\";\nimport { emitNavigation } from \"@ethisyscore/components-react\";\n\n/**\n * Minimal `react-router-dom` compatibility shim for lifted monolith code.\n *\n * A PlatformReact plugin has no client router — navigation is brokered to the\n * host via {@link emitNavigation}, and route params come from the surface URL's\n * trailing segment(s). {@link createReactRouterShim} returns a module-shaped\n * object of the hooks/components lifted code expects; alias `react-router-dom`\n * to a tiny file that re-exports this object's members so call sites resolve\n * unchanged.\n *\n * `paramKeys` names the keys the single trailing path segment is exposed under,\n * so a route like `/…/<page>/<value>` satisfies `useParams<{ id }>()` /\n * `useParams<{ date }>()` regardless of which key the lifted code destructures.\n */\nexport interface ReactRouterShimOptions {\n  /** Keys the trailing path segment is exposed under (default: `[\"id\"]`). Used as\n   *  the fallback when `routes` is not supplied or no route matches. */\n  paramKeys?: readonly string[];\n  /**\n   * Route patterns (sub-paths relative to `basePath`, e.g. `invoices/:id/edit`)\n   * for precise param extraction. When set, `useParams` matches the current path\n   * against them (most-specific wins) and returns the captured params by name —\n   * so a param in the MIDDLE of the path (`:id/edit`) resolves correctly, unlike\n   * the trailing-segment fallback.\n   */\n  routes?: readonly string[];\n  /** Base path stripped before matching `routes` (e.g. `/extensions/finance`). */\n  basePath?: string;\n}\n\n/**\n * Matches `pathname` (minus `basePath`) against `routes` (most literal segments\n * wins) and returns the captured `:param` values, or `null` when none match.\n */\nfunction matchRouteParams(\n  pathname: string,\n  routes: readonly string[],\n  basePath: string,\n): Record<string, string> | null {\n  const prefix = basePath.length > 1 && basePath.endsWith(\"/\") ? basePath.slice(0, -1) : basePath;\n  const norm = pathname.length > 1 && pathname.endsWith(\"/\") ? pathname.slice(0, -1) : pathname;\n  const rest = norm.startsWith(prefix) ? norm.slice(prefix.length).replace(/^\\/+/, \"\") : \"\";\n  const segments = rest.length > 0 ? rest.split(\"/\") : [];\n\n  let best: Record<string, string> | null = null;\n  let bestLiterals = -1;\n  for (const route of routes) {\n    const pattern = route.split(\"/\").filter(Boolean);\n    if (pattern.length !== segments.length) {\n      continue;\n    }\n    const params: Record<string, string> = {};\n    let literals = 0;\n    let ok = true;\n    for (let i = 0; i < pattern.length; i++) {\n      if (pattern[i].startsWith(\":\")) {\n        params[pattern[i].slice(1)] = segments[i];\n      } else if (pattern[i] !== segments[i]) {\n        ok = false;\n        break;\n      } else {\n        literals++;\n      }\n    }\n    if (ok && literals > bestLiterals) {\n      best = params;\n      bestLiterals = literals;\n    }\n  }\n  return best;\n}\n\ntype LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {\n  to: string;\n  children?: ReactNode;\n};\n\nexport function createReactRouterShim(options: ReactRouterShimOptions = {}) {\n  const paramKeys = options.paramKeys ?? [\"id\"];\n  const routes = options.routes;\n  const basePath = options.basePath ?? \"\";\n\n  function useNavigate(): (to: string | number) => void {\n    return (to) => {\n      if (typeof to === \"number\") {\n        if (typeof window !== \"undefined\") window.history.go(to);\n        return;\n      }\n      emitNavigation(to);\n    };\n  }\n\n  function useParams<\n    T extends Record<string, string | undefined> = Record<string, string | undefined>,\n  >(): T {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"\";\n    // Precise param extraction from the declared route patterns (handles params\n    // in any position, e.g. `invoices/:id/edit`).\n    if (routes != null && routes.length > 0) {\n      const matched = matchRouteParams(path, routes, basePath);\n      if (matched != null) {\n        return matched as T;\n      }\n    }\n    // Fallback: expose the trailing segment under each `paramKey`.\n    const segments = path.split(\"/\").filter(Boolean);\n    const last = segments[segments.length - 1];\n    const params: Record<string, string | undefined> = {};\n    if (last) {\n      for (const key of paramKeys) {\n        params[key] = last;\n      }\n    }\n    return params as T;\n  }\n\n  function useSearchParams(): [\n    URLSearchParams,\n    (next: URLSearchParams | Record<string, string>) => void,\n  ] {\n    const search = typeof window !== \"undefined\" ? window.location.search : \"\";\n    const params = new URLSearchParams(search);\n    const setSearchParams = (next: URLSearchParams | Record<string, string>) => {\n      const usp = next instanceof URLSearchParams ? next : new URLSearchParams(next);\n      const qs = usp.toString();\n      if (typeof window !== \"undefined\") {\n        window.history.replaceState(\n          {},\n          \"\",\n          qs ? `${window.location.pathname}?${qs}` : window.location.pathname,\n        );\n      }\n    };\n    return [params, setSearchParams];\n  }\n\n  function useMatch(\n    _pattern: string,\n  ): { params: Record<string, string | undefined>; pathname: string } | null {\n    return null;\n  }\n\n  function useLocation() {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"/\";\n    return { pathname: path, search: \"\", hash: \"\", state: null, key: \"default\" };\n  }\n\n  function Link({ to, children, onClick, ...rest }: LinkProps) {\n    return createElement(\n      \"a\",\n      {\n        href: to,\n        onClick: (e: MouseEvent<HTMLAnchorElement>) => {\n          e.preventDefault();\n          onClick?.(e);\n          emitNavigation(to);\n        },\n        ...rest,\n      },\n      children,\n    );\n  }\n\n  return { useNavigate, useParams, useSearchParams, useMatch, useLocation, Link, NavLink: Link };\n}\n"]}

package/dist/platform-react/index.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ComponentType, AnchorHTMLAttributes, ReactNode, MouseEvent } from 'react';
+import { ComponentType, ReactElement, AnchorHTMLAttributes, ReactNode, MouseEvent } from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, UseQueryResult, UseQueryOptions, QueryKey } from '@tanstack/react-query';
 import { PlatformReactPageProps } from '@ethisyscore/components-react';
@@ -36,12 +36,25 @@ interface DefinePlatformReactPluginPageOptions {
     css: string;
     /** Override the per-page `QueryClient`. */
     queryClient?: QueryClient;
+    /**
+     * Optional wrapper applied around the page element, inside the style root. Use
+     * to add a plugin-specific in-page provider — e.g. `withPageHeader(config)` from
+     * `@ethisyscore/plugin-ui/components/layout` to restore list-page header CTAs.
+     *
+     * The wrapper is supplied as a ready-made function (not a config object) so this
+     * entry stays free of the page-header React context — the provider and the
+     * page's `usePageHeader` must resolve to the SAME `components/layout` module
+     * instance, which they only do when both come from that entry (bundlers inline a
+     * separate context copy per entry otherwise).
+     */
+    wrapPage?: (page: ReactElement) => ReactElement;
 }
 /**
  * Wraps a lifted page as a PlatformReact entry with the providers the monolith
- * took for granted: react-query, the static `useView` manifest, and the scoped
- * style root. The host already provides the MCP transport (it mounts pages
- * inside its own runtime provider), so this adds only the in-page providers.
+ * took for granted: react-query, the static `useView` manifest, the scoped style
+ * root, and — when `wrapPage` is supplied — a plugin-specific in-page provider
+ * (e.g. the page-header). The host already provides the MCP transport (it mounts
+ * pages inside its own runtime provider), so this adds only the in-page providers.
  */
 declare function definePlatformReactPluginPage(Page: ComponentType<PlatformReactPageProps>, options: DefinePlatformReactPluginPageOptions): ComponentType<PlatformReactPageProps>;
 interface PluginPageDefinerConfig {
@@ -58,6 +71,12 @@ interface PluginPageDefinerConfig {
     css: string;
     /** Override the per-page `QueryClient`. */
     queryClient?: QueryClient;
+    /**
+     * Optional wrapper applied around every page (see
+     * {@link DefinePlatformReactPluginPageOptions.wrapPage}) — e.g.
+     * `withPageHeader(<feature>MenuConfig)` to restore list-page header CTAs.
+     */
+    wrapPage?: (page: ReactElement) => ReactElement;
 }
 /**
  * Builds a plugin-bound `definePluginPage(Page, views)` from one config, so a
@@ -170,8 +189,19 @@ declare function PluginStyleScope({ id, css }: {
  * `useParams<{ date }>()` regardless of which key the lifted code destructures.
  */
 interface ReactRouterShimOptions {
-    /** Keys the trailing path segment is exposed under (default: `["id"]`). */
+    /** Keys the trailing path segment is exposed under (default: `["id"]`). Used as
+     *  the fallback when `routes` is not supplied or no route matches. */
     paramKeys?: readonly string[];
+    /**
+     * Route patterns (sub-paths relative to `basePath`, e.g. `invoices/:id/edit`)
+     * for precise param extraction. When set, `useParams` matches the current path
+     * against them (most-specific wins) and returns the captured params by name —
+     * so a param in the MIDDLE of the path (`:id/edit`) resolves correctly, unlike
+     * the trailing-segment fallback.
+     */
+    routes?: readonly string[];
+    /** Base path stripped before matching `routes` (e.g. `/extensions/finance`). */
+    basePath?: string;
 }
 type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     to: string;

package/dist/platform-react/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ComponentType, AnchorHTMLAttributes, ReactNode, MouseEvent } from 'react';
+import { ComponentType, ReactElement, AnchorHTMLAttributes, ReactNode, MouseEvent } from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient, UseQueryResult, UseQueryOptions, QueryKey } from '@tanstack/react-query';
 import { PlatformReactPageProps } from '@ethisyscore/components-react';
@@ -36,12 +36,25 @@ interface DefinePlatformReactPluginPageOptions {
     css: string;
     /** Override the per-page `QueryClient`. */
     queryClient?: QueryClient;
+    /**
+     * Optional wrapper applied around the page element, inside the style root. Use
+     * to add a plugin-specific in-page provider — e.g. `withPageHeader(config)` from
+     * `@ethisyscore/plugin-ui/components/layout` to restore list-page header CTAs.
+     *
+     * The wrapper is supplied as a ready-made function (not a config object) so this
+     * entry stays free of the page-header React context — the provider and the
+     * page's `usePageHeader` must resolve to the SAME `components/layout` module
+     * instance, which they only do when both come from that entry (bundlers inline a
+     * separate context copy per entry otherwise).
+     */
+    wrapPage?: (page: ReactElement) => ReactElement;
 }
 /**
  * Wraps a lifted page as a PlatformReact entry with the providers the monolith
- * took for granted: react-query, the static `useView` manifest, and the scoped
- * style root. The host already provides the MCP transport (it mounts pages
- * inside its own runtime provider), so this adds only the in-page providers.
+ * took for granted: react-query, the static `useView` manifest, the scoped style
+ * root, and — when `wrapPage` is supplied — a plugin-specific in-page provider
+ * (e.g. the page-header). The host already provides the MCP transport (it mounts
+ * pages inside its own runtime provider), so this adds only the in-page providers.
  */
 declare function definePlatformReactPluginPage(Page: ComponentType<PlatformReactPageProps>, options: DefinePlatformReactPluginPageOptions): ComponentType<PlatformReactPageProps>;
 interface PluginPageDefinerConfig {
@@ -58,6 +71,12 @@ interface PluginPageDefinerConfig {
     css: string;
     /** Override the per-page `QueryClient`. */
     queryClient?: QueryClient;
+    /**
+     * Optional wrapper applied around every page (see
+     * {@link DefinePlatformReactPluginPageOptions.wrapPage}) — e.g.
+     * `withPageHeader(<feature>MenuConfig)` to restore list-page header CTAs.
+     */
+    wrapPage?: (page: ReactElement) => ReactElement;
 }
 /**
  * Builds a plugin-bound `definePluginPage(Page, views)` from one config, so a
@@ -170,8 +189,19 @@ declare function PluginStyleScope({ id, css }: {
  * `useParams<{ date }>()` regardless of which key the lifted code destructures.
  */
 interface ReactRouterShimOptions {
-    /** Keys the trailing path segment is exposed under (default: `["id"]`). */
+    /** Keys the trailing path segment is exposed under (default: `["id"]`). Used as
+     *  the fallback when `routes` is not supplied or no route matches. */
     paramKeys?: readonly string[];
+    /**
+     * Route patterns (sub-paths relative to `basePath`, e.g. `invoices/:id/edit`)
+     * for precise param extraction. When set, `useParams` matches the current path
+     * against them (most-specific wins) and returns the captured params by name —
+     * so a param in the MIDDLE of the path (`:id/edit`) resolves correctly, unlike
+     * the trailing-segment fallback.
+     */
+    routes?: readonly string[];
+    /** Base path stripped before matching `routes` (e.g. `/extensions/finance`). */
+    basePath?: string;
 }
 type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     to: string;

package/dist/platform-react/index.js

@@ -40,9 +40,12 @@ function definePlatformReactPluginPage(Page, options) {
     rootClassName,
     styleId,
     css,
-    queryClient = defaultQueryClient
+    queryClient = defaultQueryClient,
+    wrapPage
   } = options;
   function PluginPage(props) {
+    const page = createElement(Page, props);
+    const body = wrapPage ? wrapPage(page) : page;
     return createElement(
       QueryClientProvider,
       { client: queryClient },
@@ -53,7 +56,7 @@ function definePlatformReactPluginPage(Page, options) {
         createElement(
           "div",
           { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },
-          createElement(Page, props)
+          body
         )
       )
     );
@@ -165,8 +168,42 @@ function useAuthenticatedQuery(options) {
 function useAuthenticatedQueries(queries) {
   return useQueries({ queries });
 }
+function matchRouteParams(pathname, routes, basePath) {
+  const prefix = basePath.length > 1 && basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+  const norm = pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname;
+  const rest = norm.startsWith(prefix) ? norm.slice(prefix.length).replace(/^\/+/, "") : "";
+  const segments = rest.length > 0 ? rest.split("/") : [];
+  let best = null;
+  let bestLiterals = -1;
+  for (const route of routes) {
+    const pattern = route.split("/").filter(Boolean);
+    if (pattern.length !== segments.length) {
+      continue;
+    }
+    const params = {};
+    let literals = 0;
+    let ok = true;
+    for (let i = 0; i < pattern.length; i++) {
+      if (pattern[i].startsWith(":")) {
+        params[pattern[i].slice(1)] = segments[i];
+      } else if (pattern[i] !== segments[i]) {
+        ok = false;
+        break;
+      } else {
+        literals++;
+      }
+    }
+    if (ok && literals > bestLiterals) {
+      best = params;
+      bestLiterals = literals;
+    }
+  }
+  return best;
+}
 function createReactRouterShim(options = {}) {
   const paramKeys = options.paramKeys ?? ["id"];
+  const routes = options.routes;
+  const basePath = options.basePath ?? "";
   function useNavigate() {
     return (to) => {
       if (typeof to === "number") {
@@ -178,6 +215,12 @@ function createReactRouterShim(options = {}) {
   }
   function useParams() {
     const path = typeof window !== "undefined" ? window.location.pathname : "";
+    if (routes != null && routes.length > 0) {
+      const matched = matchRouteParams(path, routes, basePath);
+      if (matched != null) {
+        return matched;
+      }
+    }
     const segments = path.split("/").filter(Boolean);
     const last = segments[segments.length - 1];
     const params = {};

package/dist/platform-react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/platform-react/templateContext.ts","../../src/platform-react/injectStyles.ts","../../src/platform-react/definePlatformReactPluginPage.tsx","../../src/platform-react/MissingViewFallback.tsx","../../src/platform-react/useView.ts","../../src/platform-react/mcpService.ts","../../src/platform-react/useAuthenticatedQuery.ts","../../src/platform-react/reactRouterShim.tsx"],"names":["createElement","useView"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext, type ComponentType } from \"react\";\n\n/** A view component resolved from the template manifest. Props are open. */\nexport type ViewComponent = ComponentType<Record<string, unknown>>;\n\n/**\n * Static port of the monolith's gogo-ui adapter mechanism for PlatformReact.\n *\n * A monolith feature picks its adapter view at runtime via `import.meta.glob`;\n * a PlatformReact page is a single self-contained ESM bundle where that glob is\n * unavailable, so each page declares its view slice statically and provides it\n * through this context. The shape is `manifest[module][viewName] = Component`.\n */\nexport type TemplateManifest = Record<string, Partial<Record<string, ViewComponent>>>;\n\nexport const TemplateContext = createContext<TemplateManifest | null>(null);\n","import { useEffect } from \"react\";\n\n/**\n * Injects a plugin's compiled CSS into the host document once, keyed by a\n * stable element id (idempotent across pages and re-mounts).\n *\n * Each PlatformReact page is a separate ESM bundle with no companion CSS asset\n * the host would load, so the styles travel inside the bundle (typically via a\n * `*.css?inline` import) and are mounted at runtime. Scope the CSS to a plugin\n * root class (never `:root`) so it cannot override the host theme.\n */\nexport function injectPluginStyles(id: string, css: string): void {\n  if (typeof document === \"undefined\") return;\n  if (document.getElementById(id)) return;\n  const el = document.createElement(\"style\");\n  el.id = id;\n  el.textContent = css;\n  document.head.appendChild(el);\n}\n\n/** Component form of {@link injectPluginStyles}; renders nothing. */\nexport function PluginStyleScope({ id, css }: { id: string; css: string }): null {\n  useEffect(() => {\n    injectPluginStyles(id, css);\n  }, [id, css]);\n  return null;\n}\n","import { createElement, type ComponentType } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport {\n  definePlatformReactPage,\n  type PlatformReactPageProps,\n} from \"@ethisyscore/components-react\";\nimport { TemplateContext, type TemplateManifest, type ViewComponent } from \"./templateContext\";\nimport { PluginStyleScope } from \"./injectStyles\";\n\n/**\n * Default per-page `QueryClient`. Each PlatformReact page is an isolated ESM\n * bundle, so this module-level singleton is scoped to that page — exactly the\n * lifetime a page wants. Plugins needing different options pass their own.\n */\nfunction makeDefaultQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        retry: 1,\n        refetchOnWindowFocus: false,\n        staleTime: 30_000,\n      },\n    },\n  });\n}\n\nconst defaultQueryClient = makeDefaultQueryClient();\n\n/**\n * Shared root class applied to every plugin page wrapper, in addition to the\n * plugin's own `rootClassName`. The SDK's `plugin-base.css` (scoped resets +\n * component overrides) targets this class, so host-parity styling reaches a\n * plugin's surface deterministically regardless of its plugin-specific class.\n */\nexport const EHX_PLUGIN_ROOT_CLASS = \"ehx-plugin-root\";\n\nexport interface DefinePlatformReactPluginPageOptions {\n  /** The page's static `useView` manifest slice (no `import.meta.glob` in a single-file bundle). */\n  manifest?: TemplateManifest;\n  /** Scoped style-root class wrapped around the page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element (idempotent across pages). */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n}\n\n/**\n * Wraps a lifted page as a PlatformReact entry with the providers the monolith\n * took for granted: react-query, the static `useView` manifest, and the scoped\n * style root. The host already provides the MCP transport (it mounts pages\n * inside its own runtime provider), so this adds only the in-page providers.\n */\nexport function definePlatformReactPluginPage(\n  Page: ComponentType<PlatformReactPageProps>,\n  options: DefinePlatformReactPluginPageOptions,\n): ComponentType<PlatformReactPageProps> {\n  const {\n    manifest = {},\n    rootClassName,\n    styleId,\n    css,\n    queryClient = defaultQueryClient,\n  } = options;\n\n  function PluginPage(props: PlatformReactPageProps) {\n    return createElement(\n      QueryClientProvider,\n      { client: queryClient },\n      createElement(\n        TemplateContext.Provider,\n        { value: manifest },\n        createElement(PluginStyleScope, { id: styleId, css }),\n        createElement(\n          \"div\",\n          { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },\n          createElement(Page, props),\n        ),\n      ),\n    );\n  }\n\n  return definePlatformReactPage(PluginPage);\n}\n\nexport interface PluginPageDefinerConfig {\n  /**\n   * The plugin's `useView` module key (e.g. `\"timesheets\"`). Each page's `views`\n   * are registered under it, so a page's `useView(module, name)` resolves them.\n   */\n  module: string;\n  /** Scoped style-root class wrapped around every page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element. */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n}\n\n/**\n * Builds a plugin-bound `definePluginPage(Page, views)` from one config, so a\n * plugin writes the four plugin-specific values (module key, root class, style\n * id, CSS) ONCE instead of in every page entry. Each surface entry then calls\n * `definePluginPage(Page, { ViewName })`; the flat `views` map is wrapped into\n * the `{ [module]: views }` manifest slice the page's `useView(module, name)`\n * reads. The generic provider/manifest/style wrapping stays in\n * {@link definePlatformReactPluginPage}.\n */\nexport function createPluginPageDefiner(config: PluginPageDefinerConfig) {\n  const { module, ...rest } = config;\n  return function definePluginPage(\n    Page: ComponentType<PlatformReactPageProps>,\n    views: Record<string, ViewComponent> = {},\n  ): ComponentType<PlatformReactPageProps> {\n    return definePlatformReactPluginPage(Page, { ...rest, manifest: { [module]: views } });\n  };\n}\n","import { createElement, type ComponentType } from \"react\";\n\n/**\n * Dependency-light fallback rendered when a view is not present in the current\n * template manifest. Kept to plain elements + inline styles so the foundation\n * package carries no UI-library dependency; plugins that want a branded\n * fallback pass their own via {@link createUseView}.\n */\nexport const MissingViewFallback: ComponentType<Record<string, unknown>> = () =>\n  createElement(\n    \"div\",\n    {\n      style: {\n        display: \"flex\",\n        alignItems: \"center\",\n        justifyContent: \"center\",\n        padding: \"2rem\",\n      },\n    },\n    createElement(\n      \"div\",\n      {\n        style: {\n          maxWidth: \"28rem\",\n          padding: \"1.5rem\",\n          border: \"1px solid rgba(0,0,0,0.12)\",\n          borderRadius: \"0.5rem\",\n          textAlign: \"center\",\n        },\n      },\n      createElement(\"p\", { style: { margin: \"0 0 0.5rem\", fontWeight: 600 } }, \"View not available\"),\n      createElement(\n        \"p\",\n        { style: { margin: 0, opacity: 0.7, fontSize: \"0.875rem\" } },\n        \"This view has not been implemented by the current template.\",\n      ),\n    ),\n  );\n","import { useContext, type ComponentType } from \"react\";\nimport { TemplateContext } from \"./templateContext\";\nimport { MissingViewFallback } from \"./MissingViewFallback\";\n\nconst REACT_LAZY_TYPE = Symbol.for(\"react.lazy\");\n\n/** Matches regular function components and `React.lazy` wrappers. */\nexport function isComponent(value: unknown): value is ComponentType {\n  if (typeof value === \"function\") return true;\n  if (typeof value === \"object\" && value !== null) {\n    return (value as Record<string, unknown>).$$typeof === REACT_LAZY_TYPE;\n  }\n  return false;\n}\n\n/**\n * Builds a `useView` hook bound to a fallback component. The hook is a safe\n * view accessor that never throws: it returns `manifest[module][viewName]` when\n * present, or the supplied fallback when the manifest, module slice, or view is\n * missing or is not a component.\n */\nexport function createUseView(fallback: ComponentType<Record<string, unknown>>) {\n  return function useView(\n    module: string,\n    viewName: string,\n  ): ComponentType<Record<string, unknown>> {\n    const manifest = useContext(TemplateContext);\n    if (!manifest) {\n      return fallback;\n    }\n\n    const slice = manifest[module];\n    if (slice && typeof slice === \"object\" && viewName in (slice as Record<string, unknown>)) {\n      const component = (slice as Record<string, unknown>)[viewName];\n      if (isComponent(component)) {\n        return component as ComponentType<Record<string, unknown>>;\n      }\n    }\n\n    return fallback;\n  };\n}\n\n/** Default `useView` bound to the built-in {@link MissingViewFallback}. */\nexport const useView = createUseView(MissingViewFallback);\n","import { useMemo } from \"react\";\nimport { useMcpTool } from \"@ethisyscore/extension-runtime/plugin\";\n\n/** Dispatches an MCP tool call by name. The seam a lifted REST service binds to. */\nexport type ToolInvoker = (toolName: string, args: unknown) => Promise<unknown>;\n\n/**\n * Base for service classes lifted from a monolith REST plane onto MCP.\n *\n * The monolith versions extend a REST base (`this.get`/`this.post` over axios).\n * The plugin runtime exposes no imperative MCP transport — only the\n * `useMcpTool` hook — so a `useXService()` hook composes per-tool invokers (see\n * {@link useToolInvokerMap}) into a single {@link ToolInvoker} and constructs\n * the class with it. Method bodies call `this.tool(\"<tool-name>\", args)`.\n */\nexport abstract class BaseMcpService {\n  constructor(private readonly invoker: ToolInvoker) {}\n\n  protected async tool<TRes>(name: string, args: unknown = {}): Promise<TRes> {\n    return (await this.invoker(name, args)) as TRes;\n  }\n}\n\n/**\n * Thrown by a lifted service method whose monolith REST route has no MCP tool\n * yet (typically because it needs client-side aggregation over a coarser tool).\n */\nexport function notViaMcp(serviceName: string, method: string): never {\n  throw new Error(`${serviceName}.${method} has no MCP tool — pending per-surface aggregation.`);\n}\n\n/** Imperative invoker for a single MCP tool (the hook's `.invoke`, stable across renders). */\nexport function useToolInvoker<TReq, TRes>(toolName: string): (req: TReq) => Promise<TRes> {\n  return useMcpTool<TReq, TRes>(toolName).invoke;\n}\n\n/**\n * Composes one {@link ToolInvoker} dispatching over every tool in `tools`, so a\n * service class can call tools by name.\n *\n * Rules of hooks: `tools` MUST be a frozen, constant-length list (e.g. a\n * module-level `as const` array) so the per-tool `useMcpTool` calls run in a\n * stable order on every render. Passing a list whose length varies between\n * renders is a violation and will break.\n */\nexport function useToolInvokerMap(tools: readonly string[]): ToolInvoker {\n  const invokers: Record<string, (args: unknown) => Promise<unknown>> = {};\n  for (const name of tools) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks -- `tools` is required to be frozen; call order is stable.\n    invokers[name] = useMcpTool(name).invoke;\n  }\n  return useMemo<ToolInvoker>(\n    () => (name, args) => {\n      const fn = invokers[name];\n      if (!fn) {\n        throw new Error(`No MCP invoker registered for tool \"${name}\"`);\n      }\n      return fn(args);\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- per-tool invoke refs are stable; rebuild only if one changes.\n    tools.map((t) => invokers[t]),\n  );\n}\n","import {\n  useQueries,\n  useQuery,\n  type QueryKey,\n  type UseQueryOptions,\n  type UseQueryResult,\n} from \"@tanstack/react-query\";\n\n/**\n * Plugin shim for the monolith's `useAuthenticatedQuery`.\n *\n * In the host realm the MCP transport is already authenticated and scoped to\n * the active organisation, so there is no auth gate to apply. The hook keeps\n * the monolith's return shape (`isLoading` + `isAuthLoading`) so lifted data\n * hooks and pages consume it unchanged — `isAuthLoading` is always `false`.\n */\nexport interface AuthenticatedQueryResult<TData, TError>\n  extends Omit<UseQueryResult<TData, TError>, \"isLoading\"> {\n  isLoading: boolean;\n  isAuthLoading: boolean;\n}\n\nexport function useAuthenticatedQuery<\n  TQueryFnData = unknown,\n  TError = Error,\n  TData = TQueryFnData,\n  TQueryKey extends QueryKey = QueryKey,\n>(\n  options: UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n): AuthenticatedQueryResult<TData, TError> {\n  const result = useQuery(options);\n  return {\n    ...result,\n    isLoading: result.isLoading,\n    isAuthLoading: false,\n  };\n}\n\nexport function useAuthenticatedQueries<TQueryFnData = unknown, TError = Error>(\n  queries: UseQueryOptions<TQueryFnData, TError>[],\n) {\n  return useQueries({ queries });\n}\n","import { createElement, type AnchorHTMLAttributes, type MouseEvent, type ReactNode } from \"react\";\nimport { emitNavigation } from \"@ethisyscore/components-react\";\n\n/**\n * Minimal `react-router-dom` compatibility shim for lifted monolith code.\n *\n * A PlatformReact plugin has no client router — navigation is brokered to the\n * host via {@link emitNavigation}, and route params come from the surface URL's\n * trailing segment(s). {@link createReactRouterShim} returns a module-shaped\n * object of the hooks/components lifted code expects; alias `react-router-dom`\n * to a tiny file that re-exports this object's members so call sites resolve\n * unchanged.\n *\n * `paramKeys` names the keys the single trailing path segment is exposed under,\n * so a route like `/…/<page>/<value>` satisfies `useParams<{ id }>()` /\n * `useParams<{ date }>()` regardless of which key the lifted code destructures.\n */\nexport interface ReactRouterShimOptions {\n  /** Keys the trailing path segment is exposed under (default: `[\"id\"]`). */\n  paramKeys?: readonly string[];\n}\n\ntype LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {\n  to: string;\n  children?: ReactNode;\n};\n\nexport function createReactRouterShim(options: ReactRouterShimOptions = {}) {\n  const paramKeys = options.paramKeys ?? [\"id\"];\n\n  function useNavigate(): (to: string | number) => void {\n    return (to) => {\n      if (typeof to === \"number\") {\n        if (typeof window !== \"undefined\") window.history.go(to);\n        return;\n      }\n      emitNavigation(to);\n    };\n  }\n\n  function useParams<\n    T extends Record<string, string | undefined> = Record<string, string | undefined>,\n  >(): T {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"\";\n    const segments = path.split(\"/\").filter(Boolean);\n    const last = segments[segments.length - 1];\n    const params: Record<string, string | undefined> = {};\n    if (last) {\n      for (const key of paramKeys) {\n        params[key] = last;\n      }\n    }\n    return params as T;\n  }\n\n  function useSearchParams(): [\n    URLSearchParams,\n    (next: URLSearchParams | Record<string, string>) => void,\n  ] {\n    const search = typeof window !== \"undefined\" ? window.location.search : \"\";\n    const params = new URLSearchParams(search);\n    const setSearchParams = (next: URLSearchParams | Record<string, string>) => {\n      const usp = next instanceof URLSearchParams ? next : new URLSearchParams(next);\n      const qs = usp.toString();\n      if (typeof window !== \"undefined\") {\n        window.history.replaceState(\n          {},\n          \"\",\n          qs ? `${window.location.pathname}?${qs}` : window.location.pathname,\n        );\n      }\n    };\n    return [params, setSearchParams];\n  }\n\n  function useMatch(\n    _pattern: string,\n  ): { params: Record<string, string | undefined>; pathname: string } | null {\n    return null;\n  }\n\n  function useLocation() {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"/\";\n    return { pathname: path, search: \"\", hash: \"\", state: null, key: \"default\" };\n  }\n\n  function Link({ to, children, onClick, ...rest }: LinkProps) {\n    return createElement(\n      \"a\",\n      {\n        href: to,\n        onClick: (e: MouseEvent<HTMLAnchorElement>) => {\n          e.preventDefault();\n          onClick?.(e);\n          emitNavigation(to);\n        },\n        ...rest,\n      },\n      children,\n    );\n  }\n\n  return { useNavigate, useParams, useSearchParams, useMatch, useLocation, Link, NavLink: Link };\n}\n"]}
+{"version":3,"sources":["../../src/platform-react/templateContext.ts","../../src/platform-react/injectStyles.ts","../../src/platform-react/definePlatformReactPluginPage.tsx","../../src/platform-react/MissingViewFallback.tsx","../../src/platform-react/useView.ts","../../src/platform-react/mcpService.ts","../../src/platform-react/useAuthenticatedQuery.ts","../../src/platform-react/reactRouterShim.tsx"],"names":["createElement","useView"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext, type ComponentType } from \"react\";\n\n/** A view component resolved from the template manifest. Props are open. */\nexport type ViewComponent = ComponentType<Record<string, unknown>>;\n\n/**\n * Static port of the monolith's gogo-ui adapter mechanism for PlatformReact.\n *\n * A monolith feature picks its adapter view at runtime via `import.meta.glob`;\n * a PlatformReact page is a single self-contained ESM bundle where that glob is\n * unavailable, so each page declares its view slice statically and provides it\n * through this context. The shape is `manifest[module][viewName] = Component`.\n */\nexport type TemplateManifest = Record<string, Partial<Record<string, ViewComponent>>>;\n\nexport const TemplateContext = createContext<TemplateManifest | null>(null);\n","import { useEffect } from \"react\";\n\n/**\n * Injects a plugin's compiled CSS into the host document once, keyed by a\n * stable element id (idempotent across pages and re-mounts).\n *\n * Each PlatformReact page is a separate ESM bundle with no companion CSS asset\n * the host would load, so the styles travel inside the bundle (typically via a\n * `*.css?inline` import) and are mounted at runtime. Scope the CSS to a plugin\n * root class (never `:root`) so it cannot override the host theme.\n */\nexport function injectPluginStyles(id: string, css: string): void {\n  if (typeof document === \"undefined\") return;\n  if (document.getElementById(id)) return;\n  const el = document.createElement(\"style\");\n  el.id = id;\n  el.textContent = css;\n  document.head.appendChild(el);\n}\n\n/** Component form of {@link injectPluginStyles}; renders nothing. */\nexport function PluginStyleScope({ id, css }: { id: string; css: string }): null {\n  useEffect(() => {\n    injectPluginStyles(id, css);\n  }, [id, css]);\n  return null;\n}\n","import { createElement, type ComponentType, type ReactElement } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport {\n  definePlatformReactPage,\n  type PlatformReactPageProps,\n} from \"@ethisyscore/components-react\";\nimport { TemplateContext, type TemplateManifest, type ViewComponent } from \"./templateContext\";\nimport { PluginStyleScope } from \"./injectStyles\";\n\n/**\n * Default per-page `QueryClient`. Each PlatformReact page is an isolated ESM\n * bundle, so this module-level singleton is scoped to that page — exactly the\n * lifetime a page wants. Plugins needing different options pass their own.\n */\nfunction makeDefaultQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        retry: 1,\n        refetchOnWindowFocus: false,\n        staleTime: 30_000,\n      },\n    },\n  });\n}\n\nconst defaultQueryClient = makeDefaultQueryClient();\n\n/**\n * Shared root class applied to every plugin page wrapper, in addition to the\n * plugin's own `rootClassName`. The SDK's `plugin-base.css` (scoped resets +\n * component overrides) targets this class, so host-parity styling reaches a\n * plugin's surface deterministically regardless of its plugin-specific class.\n */\nexport const EHX_PLUGIN_ROOT_CLASS = \"ehx-plugin-root\";\n\nexport interface DefinePlatformReactPluginPageOptions {\n  /** The page's static `useView` manifest slice (no `import.meta.glob` in a single-file bundle). */\n  manifest?: TemplateManifest;\n  /** Scoped style-root class wrapped around the page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element (idempotent across pages). */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n  /**\n   * Optional wrapper applied around the page element, inside the style root. Use\n   * to add a plugin-specific in-page provider — e.g. `withPageHeader(config)` from\n   * `@ethisyscore/plugin-ui/components/layout` to restore list-page header CTAs.\n   *\n   * The wrapper is supplied as a ready-made function (not a config object) so this\n   * entry stays free of the page-header React context — the provider and the\n   * page's `usePageHeader` must resolve to the SAME `components/layout` module\n   * instance, which they only do when both come from that entry (bundlers inline a\n   * separate context copy per entry otherwise).\n   */\n  wrapPage?: (page: ReactElement) => ReactElement;\n}\n\n/**\n * Wraps a lifted page as a PlatformReact entry with the providers the monolith\n * took for granted: react-query, the static `useView` manifest, the scoped style\n * root, and — when `wrapPage` is supplied — a plugin-specific in-page provider\n * (e.g. the page-header). The host already provides the MCP transport (it mounts\n * pages inside its own runtime provider), so this adds only the in-page providers.\n */\nexport function definePlatformReactPluginPage(\n  Page: ComponentType<PlatformReactPageProps>,\n  options: DefinePlatformReactPluginPageOptions,\n): ComponentType<PlatformReactPageProps> {\n  const {\n    manifest = {},\n    rootClassName,\n    styleId,\n    css,\n    queryClient = defaultQueryClient,\n    wrapPage,\n  } = options;\n\n  function PluginPage(props: PlatformReactPageProps) {\n    const page = createElement(Page, props);\n    const body = wrapPage ? wrapPage(page) : page;\n    return createElement(\n      QueryClientProvider,\n      { client: queryClient },\n      createElement(\n        TemplateContext.Provider,\n        { value: manifest },\n        createElement(PluginStyleScope, { id: styleId, css }),\n        createElement(\n          \"div\",\n          { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },\n          body,\n        ),\n      ),\n    );\n  }\n\n  return definePlatformReactPage(PluginPage);\n}\n\nexport interface PluginPageDefinerConfig {\n  /**\n   * The plugin's `useView` module key (e.g. `\"timesheets\"`). Each page's `views`\n   * are registered under it, so a page's `useView(module, name)` resolves them.\n   */\n  module: string;\n  /** Scoped style-root class wrapped around every page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element. */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n  /**\n   * Optional wrapper applied around every page (see\n   * {@link DefinePlatformReactPluginPageOptions.wrapPage}) — e.g.\n   * `withPageHeader(<feature>MenuConfig)` to restore list-page header CTAs.\n   */\n  wrapPage?: (page: ReactElement) => ReactElement;\n}\n\n/**\n * Builds a plugin-bound `definePluginPage(Page, views)` from one config, so a\n * plugin writes the four plugin-specific values (module key, root class, style\n * id, CSS) ONCE instead of in every page entry. Each surface entry then calls\n * `definePluginPage(Page, { ViewName })`; the flat `views` map is wrapped into\n * the `{ [module]: views }` manifest slice the page's `useView(module, name)`\n * reads. The generic provider/manifest/style wrapping stays in\n * {@link definePlatformReactPluginPage}.\n */\nexport function createPluginPageDefiner(config: PluginPageDefinerConfig) {\n  const { module, ...rest } = config;\n  return function definePluginPage(\n    Page: ComponentType<PlatformReactPageProps>,\n    views: Record<string, ViewComponent> = {},\n  ): ComponentType<PlatformReactPageProps> {\n    return definePlatformReactPluginPage(Page, { ...rest, manifest: { [module]: views } });\n  };\n}\n","import { createElement, type ComponentType } from \"react\";\n\n/**\n * Dependency-light fallback rendered when a view is not present in the current\n * template manifest. Kept to plain elements + inline styles so the foundation\n * package carries no UI-library dependency; plugins that want a branded\n * fallback pass their own via {@link createUseView}.\n */\nexport const MissingViewFallback: ComponentType<Record<string, unknown>> = () =>\n  createElement(\n    \"div\",\n    {\n      style: {\n        display: \"flex\",\n        alignItems: \"center\",\n        justifyContent: \"center\",\n        padding: \"2rem\",\n      },\n    },\n    createElement(\n      \"div\",\n      {\n        style: {\n          maxWidth: \"28rem\",\n          padding: \"1.5rem\",\n          border: \"1px solid rgba(0,0,0,0.12)\",\n          borderRadius: \"0.5rem\",\n          textAlign: \"center\",\n        },\n      },\n      createElement(\"p\", { style: { margin: \"0 0 0.5rem\", fontWeight: 600 } }, \"View not available\"),\n      createElement(\n        \"p\",\n        { style: { margin: 0, opacity: 0.7, fontSize: \"0.875rem\" } },\n        \"This view has not been implemented by the current template.\",\n      ),\n    ),\n  );\n","import { useContext, type ComponentType } from \"react\";\nimport { TemplateContext } from \"./templateContext\";\nimport { MissingViewFallback } from \"./MissingViewFallback\";\n\nconst REACT_LAZY_TYPE = Symbol.for(\"react.lazy\");\n\n/** Matches regular function components and `React.lazy` wrappers. */\nexport function isComponent(value: unknown): value is ComponentType {\n  if (typeof value === \"function\") return true;\n  if (typeof value === \"object\" && value !== null) {\n    return (value as Record<string, unknown>).$$typeof === REACT_LAZY_TYPE;\n  }\n  return false;\n}\n\n/**\n * Builds a `useView` hook bound to a fallback component. The hook is a safe\n * view accessor that never throws: it returns `manifest[module][viewName]` when\n * present, or the supplied fallback when the manifest, module slice, or view is\n * missing or is not a component.\n */\nexport function createUseView(fallback: ComponentType<Record<string, unknown>>) {\n  return function useView(\n    module: string,\n    viewName: string,\n  ): ComponentType<Record<string, unknown>> {\n    const manifest = useContext(TemplateContext);\n    if (!manifest) {\n      return fallback;\n    }\n\n    const slice = manifest[module];\n    if (slice && typeof slice === \"object\" && viewName in (slice as Record<string, unknown>)) {\n      const component = (slice as Record<string, unknown>)[viewName];\n      if (isComponent(component)) {\n        return component as ComponentType<Record<string, unknown>>;\n      }\n    }\n\n    return fallback;\n  };\n}\n\n/** Default `useView` bound to the built-in {@link MissingViewFallback}. */\nexport const useView = createUseView(MissingViewFallback);\n","import { useMemo } from \"react\";\nimport { useMcpTool } from \"@ethisyscore/extension-runtime/plugin\";\n\n/** Dispatches an MCP tool call by name. The seam a lifted REST service binds to. */\nexport type ToolInvoker = (toolName: string, args: unknown) => Promise<unknown>;\n\n/**\n * Base for service classes lifted from a monolith REST plane onto MCP.\n *\n * The monolith versions extend a REST base (`this.get`/`this.post` over axios).\n * The plugin runtime exposes no imperative MCP transport — only the\n * `useMcpTool` hook — so a `useXService()` hook composes per-tool invokers (see\n * {@link useToolInvokerMap}) into a single {@link ToolInvoker} and constructs\n * the class with it. Method bodies call `this.tool(\"<tool-name>\", args)`.\n */\nexport abstract class BaseMcpService {\n  constructor(private readonly invoker: ToolInvoker) {}\n\n  protected async tool<TRes>(name: string, args: unknown = {}): Promise<TRes> {\n    return (await this.invoker(name, args)) as TRes;\n  }\n}\n\n/**\n * Thrown by a lifted service method whose monolith REST route has no MCP tool\n * yet (typically because it needs client-side aggregation over a coarser tool).\n */\nexport function notViaMcp(serviceName: string, method: string): never {\n  throw new Error(`${serviceName}.${method} has no MCP tool — pending per-surface aggregation.`);\n}\n\n/** Imperative invoker for a single MCP tool (the hook's `.invoke`, stable across renders). */\nexport function useToolInvoker<TReq, TRes>(toolName: string): (req: TReq) => Promise<TRes> {\n  return useMcpTool<TReq, TRes>(toolName).invoke;\n}\n\n/**\n * Composes one {@link ToolInvoker} dispatching over every tool in `tools`, so a\n * service class can call tools by name.\n *\n * Rules of hooks: `tools` MUST be a frozen, constant-length list (e.g. a\n * module-level `as const` array) so the per-tool `useMcpTool` calls run in a\n * stable order on every render. Passing a list whose length varies between\n * renders is a violation and will break.\n */\nexport function useToolInvokerMap(tools: readonly string[]): ToolInvoker {\n  const invokers: Record<string, (args: unknown) => Promise<unknown>> = {};\n  for (const name of tools) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks -- `tools` is required to be frozen; call order is stable.\n    invokers[name] = useMcpTool(name).invoke;\n  }\n  return useMemo<ToolInvoker>(\n    () => (name, args) => {\n      const fn = invokers[name];\n      if (!fn) {\n        throw new Error(`No MCP invoker registered for tool \"${name}\"`);\n      }\n      return fn(args);\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- per-tool invoke refs are stable; rebuild only if one changes.\n    tools.map((t) => invokers[t]),\n  );\n}\n","import {\n  useQueries,\n  useQuery,\n  type QueryKey,\n  type UseQueryOptions,\n  type UseQueryResult,\n} from \"@tanstack/react-query\";\n\n/**\n * Plugin shim for the monolith's `useAuthenticatedQuery`.\n *\n * In the host realm the MCP transport is already authenticated and scoped to\n * the active organisation, so there is no auth gate to apply. The hook keeps\n * the monolith's return shape (`isLoading` + `isAuthLoading`) so lifted data\n * hooks and pages consume it unchanged — `isAuthLoading` is always `false`.\n */\nexport interface AuthenticatedQueryResult<TData, TError>\n  extends Omit<UseQueryResult<TData, TError>, \"isLoading\"> {\n  isLoading: boolean;\n  isAuthLoading: boolean;\n}\n\nexport function useAuthenticatedQuery<\n  TQueryFnData = unknown,\n  TError = Error,\n  TData = TQueryFnData,\n  TQueryKey extends QueryKey = QueryKey,\n>(\n  options: UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n): AuthenticatedQueryResult<TData, TError> {\n  const result = useQuery(options);\n  return {\n    ...result,\n    isLoading: result.isLoading,\n    isAuthLoading: false,\n  };\n}\n\nexport function useAuthenticatedQueries<TQueryFnData = unknown, TError = Error>(\n  queries: UseQueryOptions<TQueryFnData, TError>[],\n) {\n  return useQueries({ queries });\n}\n","import { createElement, type AnchorHTMLAttributes, type MouseEvent, type ReactNode } from \"react\";\nimport { emitNavigation } from \"@ethisyscore/components-react\";\n\n/**\n * Minimal `react-router-dom` compatibility shim for lifted monolith code.\n *\n * A PlatformReact plugin has no client router — navigation is brokered to the\n * host via {@link emitNavigation}, and route params come from the surface URL's\n * trailing segment(s). {@link createReactRouterShim} returns a module-shaped\n * object of the hooks/components lifted code expects; alias `react-router-dom`\n * to a tiny file that re-exports this object's members so call sites resolve\n * unchanged.\n *\n * `paramKeys` names the keys the single trailing path segment is exposed under,\n * so a route like `/…/<page>/<value>` satisfies `useParams<{ id }>()` /\n * `useParams<{ date }>()` regardless of which key the lifted code destructures.\n */\nexport interface ReactRouterShimOptions {\n  /** Keys the trailing path segment is exposed under (default: `[\"id\"]`). Used as\n   *  the fallback when `routes` is not supplied or no route matches. */\n  paramKeys?: readonly string[];\n  /**\n   * Route patterns (sub-paths relative to `basePath`, e.g. `invoices/:id/edit`)\n   * for precise param extraction. When set, `useParams` matches the current path\n   * against them (most-specific wins) and returns the captured params by name —\n   * so a param in the MIDDLE of the path (`:id/edit`) resolves correctly, unlike\n   * the trailing-segment fallback.\n   */\n  routes?: readonly string[];\n  /** Base path stripped before matching `routes` (e.g. `/extensions/finance`). */\n  basePath?: string;\n}\n\n/**\n * Matches `pathname` (minus `basePath`) against `routes` (most literal segments\n * wins) and returns the captured `:param` values, or `null` when none match.\n */\nfunction matchRouteParams(\n  pathname: string,\n  routes: readonly string[],\n  basePath: string,\n): Record<string, string> | null {\n  const prefix = basePath.length > 1 && basePath.endsWith(\"/\") ? basePath.slice(0, -1) : basePath;\n  const norm = pathname.length > 1 && pathname.endsWith(\"/\") ? pathname.slice(0, -1) : pathname;\n  const rest = norm.startsWith(prefix) ? norm.slice(prefix.length).replace(/^\\/+/, \"\") : \"\";\n  const segments = rest.length > 0 ? rest.split(\"/\") : [];\n\n  let best: Record<string, string> | null = null;\n  let bestLiterals = -1;\n  for (const route of routes) {\n    const pattern = route.split(\"/\").filter(Boolean);\n    if (pattern.length !== segments.length) {\n      continue;\n    }\n    const params: Record<string, string> = {};\n    let literals = 0;\n    let ok = true;\n    for (let i = 0; i < pattern.length; i++) {\n      if (pattern[i].startsWith(\":\")) {\n        params[pattern[i].slice(1)] = segments[i];\n      } else if (pattern[i] !== segments[i]) {\n        ok = false;\n        break;\n      } else {\n        literals++;\n      }\n    }\n    if (ok && literals > bestLiterals) {\n      best = params;\n      bestLiterals = literals;\n    }\n  }\n  return best;\n}\n\ntype LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {\n  to: string;\n  children?: ReactNode;\n};\n\nexport function createReactRouterShim(options: ReactRouterShimOptions = {}) {\n  const paramKeys = options.paramKeys ?? [\"id\"];\n  const routes = options.routes;\n  const basePath = options.basePath ?? \"\";\n\n  function useNavigate(): (to: string | number) => void {\n    return (to) => {\n      if (typeof to === \"number\") {\n        if (typeof window !== \"undefined\") window.history.go(to);\n        return;\n      }\n      emitNavigation(to);\n    };\n  }\n\n  function useParams<\n    T extends Record<string, string | undefined> = Record<string, string | undefined>,\n  >(): T {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"\";\n    // Precise param extraction from the declared route patterns (handles params\n    // in any position, e.g. `invoices/:id/edit`).\n    if (routes != null && routes.length > 0) {\n      const matched = matchRouteParams(path, routes, basePath);\n      if (matched != null) {\n        return matched as T;\n      }\n    }\n    // Fallback: expose the trailing segment under each `paramKey`.\n    const segments = path.split(\"/\").filter(Boolean);\n    const last = segments[segments.length - 1];\n    const params: Record<string, string | undefined> = {};\n    if (last) {\n      for (const key of paramKeys) {\n        params[key] = last;\n      }\n    }\n    return params as T;\n  }\n\n  function useSearchParams(): [\n    URLSearchParams,\n    (next: URLSearchParams | Record<string, string>) => void,\n  ] {\n    const search = typeof window !== \"undefined\" ? window.location.search : \"\";\n    const params = new URLSearchParams(search);\n    const setSearchParams = (next: URLSearchParams | Record<string, string>) => {\n      const usp = next instanceof URLSearchParams ? next : new URLSearchParams(next);\n      const qs = usp.toString();\n      if (typeof window !== \"undefined\") {\n        window.history.replaceState(\n          {},\n          \"\",\n          qs ? `${window.location.pathname}?${qs}` : window.location.pathname,\n        );\n      }\n    };\n    return [params, setSearchParams];\n  }\n\n  function useMatch(\n    _pattern: string,\n  ): { params: Record<string, string | undefined>; pathname: string } | null {\n    return null;\n  }\n\n  function useLocation() {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"/\";\n    return { pathname: path, search: \"\", hash: \"\", state: null, key: \"default\" };\n  }\n\n  function Link({ to, children, onClick, ...rest }: LinkProps) {\n    return createElement(\n      \"a\",\n      {\n        href: to,\n        onClick: (e: MouseEvent<HTMLAnchorElement>) => {\n          e.preventDefault();\n          onClick?.(e);\n          emitNavigation(to);\n        },\n        ...rest,\n      },\n      children,\n    );\n  }\n\n  return { useNavigate, useParams, useSearchParams, useMatch, useLocation, Link, NavLink: Link };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethisyscore/plugin-ui",
-  "version": "1.23.0",
+  "version": "1.25.0",
   "description": "Plugin-UI umbrella SDK: client bridge + a11y/l10n primitives + brokered-MCP client (WI 4858).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -83,7 +83,8 @@
   "peerDependencies": {
     "@mui/material": ">=5",
     "@tanstack/react-query": ">=5",
-    "react": ">=18"
+    "react": ">=18",
+    "react-router-dom": ">=6"
   },
   "peerDependenciesMeta": {
     "@mui/material": {
@@ -91,6 +92,9 @@
     },
     "@tanstack/react-query": {
       "optional": true
+    },
+    "react-router-dom": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -106,6 +110,7 @@
     "jsdom": "^25.0.0",
     "react": "^18.3.0",
     "react-dom": "^18.3.0",
+    "react-router-dom": "^6.30.0",
     "tsup": "^8.5.0",
     "typescript": "^5.9.0",
     "vitest": "^4.1.0"