@ethisyscore/plugin-ui 1.31.0 → 1.33.0

package/dist/platform-react/index.cjs

@@ -102,11 +102,16 @@ var MissingViewFallback = () => react.createElement(
 );
 
 // src/platform-react/useView.ts
-var REACT_LAZY_TYPE = /* @__PURE__ */ Symbol.for("react.lazy");
+var RENDERABLE_COMPONENT_TYPEOFS = /* @__PURE__ */ new Set([
+  /* @__PURE__ */ Symbol.for("react.lazy"),
+  /* @__PURE__ */ Symbol.for("react.forward_ref"),
+  /* @__PURE__ */ Symbol.for("react.memo")
+]);
 function isComponent(value) {
   if (typeof value === "function") return true;
   if (typeof value === "object" && value !== null) {
-    return value.$$typeof === REACT_LAZY_TYPE;
+    const tag = value.$$typeof;
+    return typeof tag === "symbol" && RENDERABLE_COMPONENT_TYPEOFS.has(tag);
   }
   return false;
 }
@@ -282,21 +287,108 @@ function usePluginRealtime(typeCode, handler) {
     return source.subscribe(typeCode, (payload) => ref.current(payload));
   }, [source, typeCode]);
 }
+var OVERLAY_HOST_CONTRACT_VERSION = "1.0.0";
+var OverlayHostContext = react.createContext(null);
+function useOverlayHost() {
+  const api = react.useContext(OverlayHostContext);
+  if (api === null) {
+    throw new Error("useOverlayHost must be used within a host-mounted PlatformReact overlay.");
+  }
+  return api;
+}
+function definePlatformReactPluginOverlay(Overlay, options) {
+  const { rootClassName, styleId, css, manifest = {}, wrapOverlay } = options;
+  return function MountedOverlay(props) {
+    const tree = react.createElement(
+      OverlayHostContext.Provider,
+      { value: props.overlayHost },
+      react.createElement(
+        TemplateContext.Provider,
+        { value: manifest },
+        react.createElement(PluginStyleScope, { id: styleId, css }),
+        react.createElement(
+          "div",
+          { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },
+          react.createElement(Overlay, props)
+        )
+      )
+    );
+    return wrapOverlay ? wrapOverlay(tree) : tree;
+  };
+}
+function createPluginOverlayDefiner(config) {
+  const { module, ...rest } = config;
+  return function definePluginOverlay(Overlay, views = {}) {
+    return definePlatformReactPluginOverlay(Overlay, { ...rest, manifest: { [module]: views } });
+  };
+}
+function useManagedLifecycle() {
+  const entriesRef = react.useRef([]);
+  const lifecycle = react.useMemo(() => {
+    const addEventListener = (target, type, listener, options) => {
+      target.addEventListener(type, listener, options);
+      entriesRef.current.push({ kind: "listener", target, type, listener, options });
+    };
+    const setInterval = (handler, ms) => {
+      const id = globalThis.setInterval(handler, ms);
+      entriesRef.current.push({ kind: "interval", id });
+      return id;
+    };
+    const setTimeout = (handler, ms) => {
+      const id = globalThis.setTimeout(handler, ms);
+      entriesRef.current.push({ kind: "timeout", id });
+      return id;
+    };
+    const createAbortController = () => {
+      const controller = new AbortController();
+      entriesRef.current.push({ kind: "controller", controller });
+      return controller;
+    };
+    const disposeAll = () => {
+      const entries = entriesRef.current.splice(0);
+      for (const entry of entries) {
+        switch (entry.kind) {
+          case "listener":
+            entry.target.removeEventListener(entry.type, entry.listener, entry.options);
+            break;
+          case "interval":
+            globalThis.clearInterval(entry.id);
+            break;
+          case "timeout":
+            globalThis.clearTimeout(entry.id);
+            break;
+          case "controller":
+            entry.controller.abort();
+            break;
+        }
+      }
+    };
+    return { addEventListener, setInterval, setTimeout, createAbortController, disposeAll };
+  }, []);
+  react.useEffect(() => () => lifecycle.disposeAll(), [lifecycle]);
+  return lifecycle;
+}
 
 exports.BaseMcpService = BaseMcpService;
 exports.EHX_PLUGIN_ROOT_CLASS = EHX_PLUGIN_ROOT_CLASS;
 exports.MissingViewFallback = MissingViewFallback;
+exports.OVERLAY_HOST_CONTRACT_VERSION = OVERLAY_HOST_CONTRACT_VERSION;
+exports.OverlayHostContext = OverlayHostContext;
 exports.PluginStyleScope = PluginStyleScope;
 exports.TemplateContext = TemplateContext;
+exports.createPluginOverlayDefiner = createPluginOverlayDefiner;
 exports.createPluginPageDefiner = createPluginPageDefiner;
 exports.createReactRouterShim = createReactRouterShim;
 exports.createUseView = createUseView;
+exports.definePlatformReactPluginOverlay = definePlatformReactPluginOverlay;
 exports.definePlatformReactPluginPage = definePlatformReactPluginPage;
 exports.injectPluginStyles = injectPluginStyles;
 exports.isComponent = isComponent;
 exports.notViaMcp = notViaMcp;
 exports.useAuthenticatedQueries = useAuthenticatedQueries;
 exports.useAuthenticatedQuery = useAuthenticatedQuery;
+exports.useManagedLifecycle = useManagedLifecycle;
+exports.useOverlayHost = useOverlayHost;
 exports.usePluginRealtime = usePluginRealtime;
 exports.useToolInvoker = useToolInvoker;
 exports.useToolInvokerMap = useToolInvokerMap;

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","../../src/platform-react/usePluginRealtime.ts"],"names":["createContext","useEffect","QueryClient","createElement","QueryClientProvider","definePlatformReactPage","useView","useContext","useMcpTool","useMemo","useQuery","useQueries","emitNavigation","usePluginRealtimeSource","useRef"],"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, 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","import { useEffect, useRef } from \"react\";\nimport { usePluginRealtimeSource } from \"@ethisyscore/extension-runtime/plugin\";\n\n/**\n * Subscribe to realtime push notifications of a given `typeCode`.\n *\n * Subscribes on mount and unsubscribes on unmount. The `handler` is kept in a\n * ref so re-renders with a new closure do not churn the underlying subscription\n * — the latest handler is always used without needing to re-subscribe.\n *\n * No-ops cleanly when the plugin runtime has no realtime source (dev/mock\n * environments, or plugins that have not been given a SignalR connection by\n * the host).\n *\n * @param typeCode  Application-level event type to filter on (e.g.\n *                  `\"HelpdeskTicketCreated\"`). Filtering by extensionId is the\n *                  host's responsibility.\n * @param handler   Called with the raw notification payload each time a\n *                  matching notification arrives.\n */\nexport function usePluginRealtime(\n    typeCode: string,\n    handler: (payload: unknown) => void,\n): void\n{\n    const source = usePluginRealtimeSource();\n    const ref = useRef(handler);\n    ref.current = handler;\n\n    useEffect(() =>\n    {\n        if (!source) return; // dev/mock: no connection — no-op\n\n        return source.subscribe(typeCode, (payload: unknown) => ref.current(payload));\n    }, [source, typeCode]);\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","../../src/platform-react/usePluginRealtime.ts","../../src/platform-react/overlayHostContext.ts","../../src/platform-react/useOverlayHost.ts","../../src/platform-react/definePlatformReactPluginOverlay.tsx","../../src/platform-react/managedLifecycle.ts"],"names":["createContext","useEffect","QueryClient","createElement","QueryClientProvider","definePlatformReactPage","useView","useContext","useMcpTool","useMemo","useQuery","useQueries","emitNavigation","usePluginRealtimeSource","useRef"],"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;;;AC5BF,IAAM,4BAAA,uBAAmC,GAAA,CAAY;AAAA,kBACnD,MAAA,CAAO,IAAI,YAAY,CAAA;AAAA,kBACvB,MAAA,CAAO,IAAI,mBAAmB,CAAA;AAAA,kBAC9B,MAAA,CAAO,IAAI,YAAY;AACzB,CAAC,CAAA;AAUM,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,MAAM,MAAO,KAAA,CAAkC,QAAA;AAC/C,IAAA,OAAO,OAAO,GAAA,KAAQ,QAAA,IAAY,4BAAA,CAA6B,IAAI,GAAG,CAAA;AAAA,EACxE;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;AC9CjD,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;ACnJO,SAAS,iBAAA,CACZ,UACA,OAAA,EAEJ;AACI,EAAA,MAAM,SAASC,8BAAA,EAAwB;AACvC,EAAA,MAAM,GAAA,GAAMC,aAAO,OAAO,CAAA;AAC1B,EAAA,GAAA,CAAI,OAAA,GAAU,OAAA;AAEd,EAAAb,gBAAU,MACV;AACI,IAAA,IAAI,CAAC,MAAA,EAAQ;AAEb,IAAA,OAAO,MAAA,CAAO,UAAU,QAAA,EAAU,CAAC,YAAqB,GAAA,CAAI,OAAA,CAAQ,OAAO,CAAC,CAAA;AAAA,EAChF,CAAA,EAAG,CAAC,MAAA,EAAQ,QAAQ,CAAC,CAAA;AACzB;ACjCO,IAAM,6BAAA,GAAgC;AAiDtC,IAAM,kBAAA,GAAqBD,oBAAqC,IAAI;AC3CpE,SAAS,cAAA,GAAiC;AAC/C,EAAA,MAAM,GAAA,GAAMO,iBAAW,kBAAkB,CAAA;AACzC,EAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,IAAA,MAAM,IAAI,MAAM,0EAA0E,CAAA;AAAA,EAC5F;AACA,EAAA,OAAO,GAAA;AACT;ACeO,SAAS,gCAAA,CACd,SACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,EAAE,eAAe,OAAA,EAAS,GAAA,EAAK,WAAW,EAAC,EAAG,aAAY,GAAI,OAAA;AACpE,EAAA,OAAO,SAAS,eAAe,KAAA,EAAkC;AAI/D,IAAA,MAAM,IAAA,GAAOJ,mBAAAA;AAAA,MACX,kBAAA,CAAmB,QAAA;AAAA,MACnB,EAAE,KAAA,EAAO,KAAA,CAAM,WAAA,EAAY;AAAA,MAC3BA,mBAAAA;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,mBAAAA;AAAA,UACE,KAAA;AAAA,UACA,EAAE,SAAA,EAAW,CAAA,EAAG,qBAAqB,CAAA,CAAA,EAAI,aAAa,CAAA,CAAA,EAAG;AAAA,UACzDA,mBAAAA,CAAc,SAAS,KAAK;AAAA;AAC9B;AACF,KACF;AACA,IAAA,OAAO,WAAA,GAAc,WAAA,CAAY,IAAI,CAAA,GAAI,IAAA;AAAA,EAC3C,CAAA;AACF;AAiBO,SAAS,2BAA2B,MAAA,EAAoC;AAC7E,EAAA,MAAM,EAAE,MAAA,EAAQ,GAAG,IAAA,EAAK,GAAI,MAAA;AAC5B,EAAA,OAAO,SAAS,mBAAA,CACd,OAAA,EACA,KAAA,GAAuC,EAAC,EACE;AAC1C,IAAA,OAAO,gCAAA,CAAiC,OAAA,EAAS,EAAE,GAAG,IAAA,EAAM,QAAA,EAAU,EAAE,CAAC,MAAM,GAAG,KAAA,EAAM,EAAG,CAAA;AAAA,EAC7F,CAAA;AACF;ACsCO,SAAS,mBAAA,GAAwC;AAKtD,EAAA,MAAM,UAAA,GAAaW,YAAAA,CAAwB,EAAE,CAAA;AAK7C,EAAA,MAAM,SAAA,GAAYL,cAA0B,MAAM;AAChD,IAAA,MAAM,gBAAA,GAAmB,CACvB,MAAA,EACA,IAAA,EACA,UACA,OAAA,KACS;AACT,MAAA,MAAA,CAAO,gBAAA,CAAiB,IAAA,EAAM,QAAA,EAAU,OAAO,CAAA;AAC/C,MAAA,UAAA,CAAW,OAAA,CAAQ,KAAK,EAAE,IAAA,EAAM,YAAY,MAAA,EAAQ,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,CAAA;AAAA,IAC/E,CAAA;AAEA,IAAA,MAAM,WAAA,GAAc,CAAC,OAAA,EAAqB,EAAA,KAAuB;AAC/D,MAAA,MAAM,EAAA,GAAK,UAAA,CAAW,WAAA,CAAY,OAAA,EAAS,EAAE,CAAA;AAC7C,MAAA,UAAA,CAAW,QAAQ,IAAA,CAAK,EAAE,IAAA,EAAM,UAAA,EAAY,IAAI,CAAA;AAChD,MAAA,OAAO,EAAA;AAAA,IACT,CAAA;AAEA,IAAA,MAAM,UAAA,GAAa,CAAC,OAAA,EAAqB,EAAA,KAAuB;AAC9D,MAAA,MAAM,EAAA,GAAK,UAAA,CAAW,UAAA,CAAW,OAAA,EAAS,EAAE,CAAA;AAC5C,MAAA,UAAA,CAAW,QAAQ,IAAA,CAAK,EAAE,IAAA,EAAM,SAAA,EAAW,IAAI,CAAA;AAC/C,MAAA,OAAO,EAAA;AAAA,IACT,CAAA;AAEA,IAAA,MAAM,wBAAwB,MAAuB;AACnD,MAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,MAAA,UAAA,CAAW,QAAQ,IAAA,CAAK,EAAE,IAAA,EAAM,YAAA,EAAc,YAAY,CAAA;AAC1D,MAAA,OAAO,UAAA;AAAA,IACT,CAAA;AAEA,IAAA,MAAM,aAAa,MAAY;AAE7B,MAAA,MAAM,OAAA,GAAU,UAAA,CAAW,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA;AAC3C,MAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,QAAA,QAAQ,MAAM,IAAA;AAAM,UAClB,KAAK,UAAA;AACH,YAAA,KAAA,CAAM,OAAO,mBAAA,CAAoB,KAAA,CAAM,MAAM,KAAA,CAAM,QAAA,EAAU,MAAM,OAAO,CAAA;AAC1E,YAAA;AAAA,UACF,KAAK,UAAA;AACH,YAAA,UAAA,CAAW,aAAA,CAAc,MAAM,EAAE,CAAA;AACjC,YAAA;AAAA,UACF,KAAK,SAAA;AACH,YAAA,UAAA,CAAW,YAAA,CAAa,MAAM,EAAE,CAAA;AAChC,YAAA;AAAA,UACF,KAAK,YAAA;AACH,YAAA,KAAA,CAAM,WAAW,KAAA,EAAM;AACvB,YAAA;AAAA;AACJ,MACF;AAAA,IACF,CAAA;AAEA,IAAA,OAAO,EAAE,gBAAA,EAAkB,WAAA,EAAa,UAAA,EAAY,uBAAuB,UAAA,EAAW;AAAA,EAExF,CAAA,EAAG,EAAE,CAAA;AAIL,EAAAR,eAAAA,CAAU,MAAM,MAAM,SAAA,CAAU,YAAW,EAAG,CAAC,SAAS,CAAC,CAAA;AAEzD,EAAA,OAAO,SAAA;AACT","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\n// Renderable component object-types keyed by their `$$typeof` tag. Plain function\n// (and class) components are matched by `typeof === \"function\"`; the wrappers below\n// are objects, not functions, so they need an explicit tag check. `forwardRef` and\n// `memo` were previously omitted — a `forwardRef`/`memo` view registered in the\n// manifest failed `isComponent` and `useView` fell back to \"View not available\".\nconst RENDERABLE_COMPONENT_TYPEOFS = new Set<symbol>([\n  Symbol.for(\"react.lazy\"),\n  Symbol.for(\"react.forward_ref\"),\n  Symbol.for(\"react.memo\"),\n]);\n\n/**\n * Matches component types renderable via `useView`: plain function/class\n * components plus the object wrappers `React.lazy`, `React.forwardRef`, and\n * `React.memo` (incl. `memo(forwardRef(...))`, whose outer tag is `react.memo`).\n * Deliberately narrower than `react-is`'s `isValidElementType`, which also accepts\n * host-tag strings and Fragment/Suspense symbols — a manifest view value is always\n * a component, never a bare string.\n */\nexport function isComponent(value: unknown): value is ComponentType {\n  if (typeof value === \"function\") return true;\n  if (typeof value === \"object\" && value !== null) {\n    const tag = (value as Record<string, unknown>).$$typeof;\n    return typeof tag === \"symbol\" && RENDERABLE_COMPONENT_TYPEOFS.has(tag);\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","import { useEffect, useRef } from \"react\";\nimport { usePluginRealtimeSource } from \"@ethisyscore/extension-runtime/plugin\";\n\n/**\n * Subscribe to realtime push notifications of a given `typeCode`.\n *\n * Subscribes on mount and unsubscribes on unmount. The `handler` is kept in a\n * ref so re-renders with a new closure do not churn the underlying subscription\n * — the latest handler is always used without needing to re-subscribe.\n *\n * No-ops cleanly when the plugin runtime has no realtime source (dev/mock\n * environments, or plugins that have not been given a SignalR connection by\n * the host).\n *\n * @param typeCode  Application-level event type to filter on (e.g.\n *                  `\"HelpdeskTicketCreated\"`). Filtering by extensionId is the\n *                  host's responsibility.\n * @param handler   Called with the raw notification payload each time a\n *                  matching notification arrives.\n */\nexport function usePluginRealtime(\n    typeCode: string,\n    handler: (payload: unknown) => void,\n): void\n{\n    const source = usePluginRealtimeSource();\n    const ref = useRef(handler);\n    ref.current = handler;\n\n    useEffect(() =>\n    {\n        if (!source) return; // dev/mock: no connection — no-op\n\n        return source.subscribe(typeCode, (payload: unknown) => ref.current(payload));\n    }, [source, typeCode]);\n}\n","import { createContext } from \"react\";\n\nexport const OVERLAY_HOST_CONTRACT_VERSION = \"1.0.0\";\n\n/** Canonical inset-lease identity — the SAME shape the web host layout store uses (Codex R2 M1:\n *  one lease shape across SDK/web/store, no adapter). The store's handle extends this with `source`. */\nexport interface InsetLease {\n  readonly leaseId: string;\n  readonly generation: number;\n}\n\nexport interface OverlayHostCapabilities {\n  readonly contractVersion: string; // OVERLAY_HOST_CONTRACT_VERSION the host implements\n  readonly contentInset: boolean; // side-by-side inset supported\n  readonly focusHelpers: boolean; // focus-handoff + Escape helpers present\n  readonly safeArea: boolean; // mobile safe-area insets provided\n}\n\n/** The host-provided API. The host constructs this object; the plugin receives it as a prop and\n *  reads it via useOverlayHost(). Shape is additive-only — add optional fields, never remove. */\nexport interface OverlayHostApi {\n  /** Reserve host content space. Returns a lease on grant, or NULL when the request is rejected\n   *  (invalid px) or YIELDED (a higher-precedence source holds the inset) — Codex R2: the contract\n   *  represents reject/yield deterministically so the overlay can fall back to float mode. */\n  requestContentInset(inset: { side: \"right\"; px: number }): InsetLease | null;\n  releaseContentInset(lease: InsetLease): void; // idempotent; stale handle = no-op\n  readonly viewport: { width: number; height: number };\n  readonly breakpoint: \"mobile\" | \"tablet\" | \"desktop\"; // host-authoritative\n  readonly capabilities: OverlayHostCapabilities;\n  /** Register a cancellation callback the host invokes during an identity transition (§6.1) BEFORE it\n   *  unmounts the overlay — the overlay uses it to cancel its in-flight server-side assistant turn so\n   *  no run continues under stale authority. Returns an unsubscribe. Additive; the host guarantees\n   *  every registered callback runs (awaited best-effort) before the remount. (Codex R1 H4 — this is\n   *  the concrete registration path Task 4.6's transition protocol invokes.) */\n  registerActivityCancellation(cancel: () => void | Promise<void>): () => void;\n  /** Focus-handoff helpers (§7.3). Return focus to the launcher on close/Escape. */\n  readonly focus: {\n    onEscape(handler: () => void): () => void; // returns an unsubscribe\n    returnFocusToLauncher(): void;\n  };\n}\n\n/** Props the host injects into the overlay component (mirrors PlatformReactPageProps + overlayHost). */\nexport interface PlatformReactOverlayProps {\n  extensionId: string;\n  organisationId: string;\n  tenantId?: string;\n  overlayId: string;\n  overlayHost: OverlayHostApi;\n}\n\nexport const OverlayHostContext = createContext<OverlayHostApi | null>(null);\n","import { useContext } from \"react\";\nimport { OverlayHostContext, type OverlayHostApi } from \"./overlayHostContext\";\n\n/**\n * Reads the host-provided overlay API. Must be called inside a PlatformReact overlay mounted by the\n * host (the host injects the API via the `overlayHost` prop, which\n * `definePlatformReactPluginOverlay` bridges into {@link OverlayHostContext}).\n */\nexport function useOverlayHost(): OverlayHostApi {\n  const api = useContext(OverlayHostContext);\n  if (api === null) {\n    throw new Error(\"useOverlayHost must be used within a host-mounted PlatformReact overlay.\");\n  }\n  return api;\n}\n","import { createElement, type ComponentType, type ReactElement } from \"react\";\nimport {\n  OverlayHostContext,\n  type PlatformReactOverlayProps,\n} from \"./overlayHostContext\";\nimport { TemplateContext, type ViewComponent } from \"./templateContext\";\nimport { PluginStyleScope } from \"./injectStyles\";\nimport { EHX_PLUGIN_ROOT_CLASS } from \"./definePlatformReactPluginPage\";\n\nexport interface DefinePlatformReactPluginOverlayOptions {\n  rootClassName: string;\n  styleId: string;\n  css: string;\n  manifest?: Record<string, Partial<Record<string, ViewComponent>>>;\n  wrapOverlay?: (overlay: ReactElement) => ReactElement;\n}\n\n/**\n * Wraps an overlay component as a PlatformReact entry with the providers the host\n * needs: the `OverlayHostContext` (bridging the `overlayHost` prop into a plugin-side\n * context for `useOverlayHost()`), the static `useView` manifest, and the scoped style\n * root. Mirrors `definePlatformReactPluginPage`; the key difference is the\n * `OverlayHostContext.Provider` wrapping the `overlayHost` prop.\n *\n * @ethisyscore/plugin-ui is BUNDLED into the plugin (not externalized), so a React\n * context created in the host's module copy would not be identity-equal to the\n * plugin's copy. Passing the API as a prop and bridging it here is the correct seam\n * (D-2 design decision).\n */\nexport function definePlatformReactPluginOverlay(\n  Overlay: ComponentType<PlatformReactOverlayProps>,\n  options: DefinePlatformReactPluginOverlayOptions,\n): ComponentType<PlatformReactOverlayProps> {\n  const { rootClassName, styleId, css, manifest = {}, wrapOverlay } = options;\n  return function MountedOverlay(props: PlatformReactOverlayProps) {\n    // Inject styles via <PluginStyleScope> (effect-based, idempotent under\n    // StrictMode) rather than calling injectPluginStyles() during render — keeps\n    // render pure and mirrors definePlatformReactPluginPage.\n    const tree = createElement(\n      OverlayHostContext.Provider,\n      { value: props.overlayHost },\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(Overlay, props),\n        ),\n      ),\n    );\n    return wrapOverlay ? wrapOverlay(tree) : tree;\n  };\n}\n\nexport interface PluginOverlayDefinerConfig {\n  module: string;\n  rootClassName: string;\n  styleId: string;\n  css: string;\n  wrapOverlay?: (overlay: ReactElement) => ReactElement;\n}\n\n/**\n * Builds a plugin-bound `definePluginOverlay(Overlay, views)` from one config, so a\n * plugin writes the four plugin-specific values (module key, root class, style id, CSS)\n * ONCE instead of in every overlay entry. The flat `views` map is wrapped into the\n * `{ [module]: views }` manifest slice that `useView(module, name)` reads. Mirrors\n * `createPluginPageDefiner`.\n */\nexport function createPluginOverlayDefiner(config: PluginOverlayDefinerConfig) {\n  const { module, ...rest } = config;\n  return function definePluginOverlay(\n    Overlay: ComponentType<PlatformReactOverlayProps>,\n    views: Record<string, ViewComponent> = {},\n  ): ComponentType<PlatformReactOverlayProps> {\n    return definePlatformReactPluginOverlay(Overlay, { ...rest, manifest: { [module]: views } });\n  };\n}\n","import { useEffect, useMemo, useRef } from \"react\";\n\n/**\n * A managed cleanup registry the overlay uses to register event listeners,\n * timers, and AbortControllers. All registrations are torn down deterministically\n * when the host component unmounts.\n *\n * **Teardown semantics (R2 decision):** the HOST does NOT call `disposeAll()`.\n * Teardown rides on React's unmount cleanup (`useEffect(() => () => disposeAll(), [])`),\n * which the host guarantees by forcing unmount via the identity-key change at\n * the remount boundary. `disposeAll()` is exposed as an OPTIONAL early-teardown\n * affordance for the overlay's own use only — not the host's teardown path.\n *\n * @example\n * ```tsx\n * function MyOverlay() {\n *   const lifecycle = useManagedLifecycle();\n *   useEffect(() => {\n *     lifecycle.addEventListener(window, \"resize\", handleResize);\n *     const ctrl = lifecycle.createAbortController();\n *     fetch(\"/api/data\", { signal: ctrl.signal });\n *   }, [lifecycle]);\n *   return <div />;\n * }\n * ```\n */\nexport interface ManagedLifecycle {\n  /**\n   * Registers an event listener on `target`. The listener is automatically\n   * removed when the host component unmounts (or when `disposeAll()` is called).\n   */\n  addEventListener(\n    target: Window | Document | HTMLElement,\n    type: string,\n    listener: EventListenerOrEventListenerObject,\n    options?: AddEventListenerOptions,\n  ): void;\n\n  /**\n   * Schedules a repeating callback. The interval is automatically cleared when\n   * the host component unmounts (or when `disposeAll()` is called).\n   *\n   * @returns The interval ID (mirrors the native return value).\n   */\n  setInterval(handler: () => void, ms: number): number;\n\n  /**\n   * Schedules a one-shot callback. The timeout is automatically cleared when\n   * the host component unmounts (or when `disposeAll()` is called).\n   *\n   * @returns The timeout ID (mirrors the native return value).\n   */\n  setTimeout(handler: () => void, ms: number): number;\n\n  /**\n   * Creates an AbortController whose signal is aborted when the host component\n   * unmounts (or when `disposeAll()` is called).\n   *\n   * @returns The AbortController. The caller may pass `.signal` to fetch/streams.\n   */\n  createAbortController(): AbortController;\n\n  /**\n   * Optional early-teardown affordance for the overlay's own use. Removes all\n   * registered listeners, clears all timers, and aborts all controllers\n   * immediately.\n   *\n   * Idempotent: subsequent calls (including the React unmount cleanup) are safe\n   * and do not throw.\n   *\n   * **The host does NOT call this.** Host-driven teardown is guaranteed by\n   * React unmount cleanup via the identity-key remount mechanism.\n   */\n  disposeAll(): void;\n}\n\n// ---------------------------------------------------------------------------\n// Internal registry entries\n// ---------------------------------------------------------------------------\n\ninterface ListenerEntry {\n  kind: \"listener\";\n  target: Window | Document | HTMLElement;\n  type: string;\n  listener: EventListenerOrEventListenerObject;\n  options?: AddEventListenerOptions;\n}\n\ninterface IntervalEntry {\n  kind: \"interval\";\n  id: number;\n}\n\ninterface TimeoutEntry {\n  kind: \"timeout\";\n  id: number;\n}\n\ninterface ControllerEntry {\n  kind: \"controller\";\n  controller: AbortController;\n}\n\ntype RegistryEntry = ListenerEntry | IntervalEntry | TimeoutEntry | ControllerEntry;\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\n/**\n * Returns a {@link ManagedLifecycle} registry. All registered event listeners,\n * timers, and AbortControllers are automatically torn down when the host\n * component unmounts.\n *\n * The returned object has stable identity across re-renders (backed by `useMemo`\n * / `useRef`) so it can be placed in dependency arrays without causing churn.\n */\nexport function useManagedLifecycle(): ManagedLifecycle {\n  // Ref holds the live registry so it is shared across all renders without\n  // causing re-renders. We use an Array (not a Set) for deterministic teardown\n  // order and because entries are not deduplicated — the same listener may be\n  // registered with different options.\n  const entriesRef = useRef<RegistryEntry[]>([]);\n\n  // Stable lifecycle object. `useMemo` with an empty dep array gives us a\n  // single object identity for the lifetime of the component, which means\n  // callers can safely include `lifecycle` in useEffect dependency arrays.\n  const lifecycle = useMemo<ManagedLifecycle>(() => {\n    const addEventListener = (\n      target: Window | Document | HTMLElement,\n      type: string,\n      listener: EventListenerOrEventListenerObject,\n      options?: AddEventListenerOptions,\n    ): void => {\n      target.addEventListener(type, listener, options);\n      entriesRef.current.push({ kind: \"listener\", target, type, listener, options });\n    };\n\n    const setInterval = (handler: () => void, ms: number): number => {\n      const id = globalThis.setInterval(handler, ms) as unknown as number;\n      entriesRef.current.push({ kind: \"interval\", id });\n      return id;\n    };\n\n    const setTimeout = (handler: () => void, ms: number): number => {\n      const id = globalThis.setTimeout(handler, ms) as unknown as number;\n      entriesRef.current.push({ kind: \"timeout\", id });\n      return id;\n    };\n\n    const createAbortController = (): AbortController => {\n      const controller = new AbortController();\n      entriesRef.current.push({ kind: \"controller\", controller });\n      return controller;\n    };\n\n    const disposeAll = (): void => {\n      // Drain the registry atomically so concurrent / re-entrant calls are safe.\n      const entries = entriesRef.current.splice(0);\n      for (const entry of entries) {\n        switch (entry.kind) {\n          case \"listener\":\n            entry.target.removeEventListener(entry.type, entry.listener, entry.options);\n            break;\n          case \"interval\":\n            globalThis.clearInterval(entry.id);\n            break;\n          case \"timeout\":\n            globalThis.clearTimeout(entry.id);\n            break;\n          case \"controller\":\n            entry.controller.abort();\n            break;\n        }\n      }\n    };\n\n    return { addEventListener, setInterval, setTimeout, createAbortController, disposeAll };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // Teardown on unmount. The host guarantees unmount via the identity-key change;\n  // `disposeAll()` is also an optional early-teardown path for the overlay itself.\n  useEffect(() => () => lifecycle.disposeAll(), [lifecycle]);\n\n  return lifecycle;\n}\n"]}

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

@@ -89,7 +89,14 @@ interface PluginPageDefinerConfig {
  */
 declare function createPluginPageDefiner(config: PluginPageDefinerConfig): (Page: ComponentType<PlatformReactPageProps>, views?: Record<string, ViewComponent>) => ComponentType<PlatformReactPageProps>;
 
-/** Matches regular function components and `React.lazy` wrappers. */
+/**
+ * Matches component types renderable via `useView`: plain function/class
+ * components plus the object wrappers `React.lazy`, `React.forwardRef`, and
+ * `React.memo` (incl. `memo(forwardRef(...))`, whose outer tag is `react.memo`).
+ * Deliberately narrower than `react-is`'s `isValidElementType`, which also accepts
+ * host-tag strings and Fragment/Suspense symbols — a manifest view value is always
+ * a component, never a bare string.
+ */
 declare function isComponent(value: unknown): value is ComponentType;
 /**
  * Builds a `useView` hook bound to a fallback component. The hook is a safe
@@ -793,4 +800,173 @@ declare function createReactRouterShim(options?: ReactRouterShimOptions): {
  */
 declare function usePluginRealtime(typeCode: string, handler: (payload: unknown) => void): void;
 
-export { type AuthenticatedQueryResult, BaseMcpService, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, MissingViewFallback, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, TemplateContext, type TemplateManifest, type ToolInvoker, type ViewComponent, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, usePluginRealtime, useToolInvoker, useToolInvokerMap, useView };
+declare const OVERLAY_HOST_CONTRACT_VERSION = "1.0.0";
+/** Canonical inset-lease identity — the SAME shape the web host layout store uses (Codex R2 M1:
+ *  one lease shape across SDK/web/store, no adapter). The store's handle extends this with `source`. */
+interface InsetLease {
+    readonly leaseId: string;
+    readonly generation: number;
+}
+interface OverlayHostCapabilities {
+    readonly contractVersion: string;
+    readonly contentInset: boolean;
+    readonly focusHelpers: boolean;
+    readonly safeArea: boolean;
+}
+/** The host-provided API. The host constructs this object; the plugin receives it as a prop and
+ *  reads it via useOverlayHost(). Shape is additive-only — add optional fields, never remove. */
+interface OverlayHostApi {
+    /** Reserve host content space. Returns a lease on grant, or NULL when the request is rejected
+     *  (invalid px) or YIELDED (a higher-precedence source holds the inset) — Codex R2: the contract
+     *  represents reject/yield deterministically so the overlay can fall back to float mode. */
+    requestContentInset(inset: {
+        side: "right";
+        px: number;
+    }): InsetLease | null;
+    releaseContentInset(lease: InsetLease): void;
+    readonly viewport: {
+        width: number;
+        height: number;
+    };
+    readonly breakpoint: "mobile" | "tablet" | "desktop";
+    readonly capabilities: OverlayHostCapabilities;
+    /** Register a cancellation callback the host invokes during an identity transition (§6.1) BEFORE it
+     *  unmounts the overlay — the overlay uses it to cancel its in-flight server-side assistant turn so
+     *  no run continues under stale authority. Returns an unsubscribe. Additive; the host guarantees
+     *  every registered callback runs (awaited best-effort) before the remount. (Codex R1 H4 — this is
+     *  the concrete registration path Task 4.6's transition protocol invokes.) */
+    registerActivityCancellation(cancel: () => void | Promise<void>): () => void;
+    /** Focus-handoff helpers (§7.3). Return focus to the launcher on close/Escape. */
+    readonly focus: {
+        onEscape(handler: () => void): () => void;
+        returnFocusToLauncher(): void;
+    };
+}
+/** Props the host injects into the overlay component (mirrors PlatformReactPageProps + overlayHost). */
+interface PlatformReactOverlayProps {
+    extensionId: string;
+    organisationId: string;
+    tenantId?: string;
+    overlayId: string;
+    overlayHost: OverlayHostApi;
+}
+declare const OverlayHostContext: react.Context<OverlayHostApi | null>;
+
+/**
+ * Reads the host-provided overlay API. Must be called inside a PlatformReact overlay mounted by the
+ * host (the host injects the API via the `overlayHost` prop, which
+ * `definePlatformReactPluginOverlay` bridges into {@link OverlayHostContext}).
+ */
+declare function useOverlayHost(): OverlayHostApi;
+
+interface DefinePlatformReactPluginOverlayOptions {
+    rootClassName: string;
+    styleId: string;
+    css: string;
+    manifest?: Record<string, Partial<Record<string, ViewComponent>>>;
+    wrapOverlay?: (overlay: ReactElement) => ReactElement;
+}
+/**
+ * Wraps an overlay component as a PlatformReact entry with the providers the host
+ * needs: the `OverlayHostContext` (bridging the `overlayHost` prop into a plugin-side
+ * context for `useOverlayHost()`), the static `useView` manifest, and the scoped style
+ * root. Mirrors `definePlatformReactPluginPage`; the key difference is the
+ * `OverlayHostContext.Provider` wrapping the `overlayHost` prop.
+ *
+ * @ethisyscore/plugin-ui is BUNDLED into the plugin (not externalized), so a React
+ * context created in the host's module copy would not be identity-equal to the
+ * plugin's copy. Passing the API as a prop and bridging it here is the correct seam
+ * (D-2 design decision).
+ */
+declare function definePlatformReactPluginOverlay(Overlay: ComponentType<PlatformReactOverlayProps>, options: DefinePlatformReactPluginOverlayOptions): ComponentType<PlatformReactOverlayProps>;
+interface PluginOverlayDefinerConfig {
+    module: string;
+    rootClassName: string;
+    styleId: string;
+    css: string;
+    wrapOverlay?: (overlay: ReactElement) => ReactElement;
+}
+/**
+ * Builds a plugin-bound `definePluginOverlay(Overlay, views)` from one config, so a
+ * plugin writes the four plugin-specific values (module key, root class, style id, CSS)
+ * ONCE instead of in every overlay entry. The flat `views` map is wrapped into the
+ * `{ [module]: views }` manifest slice that `useView(module, name)` reads. Mirrors
+ * `createPluginPageDefiner`.
+ */
+declare function createPluginOverlayDefiner(config: PluginOverlayDefinerConfig): (Overlay: ComponentType<PlatformReactOverlayProps>, views?: Record<string, ViewComponent>) => ComponentType<PlatformReactOverlayProps>;
+
+/**
+ * A managed cleanup registry the overlay uses to register event listeners,
+ * timers, and AbortControllers. All registrations are torn down deterministically
+ * when the host component unmounts.
+ *
+ * **Teardown semantics (R2 decision):** the HOST does NOT call `disposeAll()`.
+ * Teardown rides on React's unmount cleanup (`useEffect(() => () => disposeAll(), [])`),
+ * which the host guarantees by forcing unmount via the identity-key change at
+ * the remount boundary. `disposeAll()` is exposed as an OPTIONAL early-teardown
+ * affordance for the overlay's own use only — not the host's teardown path.
+ *
+ * @example
+ * ```tsx
+ * function MyOverlay() {
+ *   const lifecycle = useManagedLifecycle();
+ *   useEffect(() => {
+ *     lifecycle.addEventListener(window, "resize", handleResize);
+ *     const ctrl = lifecycle.createAbortController();
+ *     fetch("/api/data", { signal: ctrl.signal });
+ *   }, [lifecycle]);
+ *   return <div />;
+ * }
+ * ```
+ */
+interface ManagedLifecycle {
+    /**
+     * Registers an event listener on `target`. The listener is automatically
+     * removed when the host component unmounts (or when `disposeAll()` is called).
+     */
+    addEventListener(target: Window | Document | HTMLElement, type: string, listener: EventListenerOrEventListenerObject, options?: AddEventListenerOptions): void;
+    /**
+     * Schedules a repeating callback. The interval is automatically cleared when
+     * the host component unmounts (or when `disposeAll()` is called).
+     *
+     * @returns The interval ID (mirrors the native return value).
+     */
+    setInterval(handler: () => void, ms: number): number;
+    /**
+     * Schedules a one-shot callback. The timeout is automatically cleared when
+     * the host component unmounts (or when `disposeAll()` is called).
+     *
+     * @returns The timeout ID (mirrors the native return value).
+     */
+    setTimeout(handler: () => void, ms: number): number;
+    /**
+     * Creates an AbortController whose signal is aborted when the host component
+     * unmounts (or when `disposeAll()` is called).
+     *
+     * @returns The AbortController. The caller may pass `.signal` to fetch/streams.
+     */
+    createAbortController(): AbortController;
+    /**
+     * Optional early-teardown affordance for the overlay's own use. Removes all
+     * registered listeners, clears all timers, and aborts all controllers
+     * immediately.
+     *
+     * Idempotent: subsequent calls (including the React unmount cleanup) are safe
+     * and do not throw.
+     *
+     * **The host does NOT call this.** Host-driven teardown is guaranteed by
+     * React unmount cleanup via the identity-key remount mechanism.
+     */
+    disposeAll(): void;
+}
+/**
+ * Returns a {@link ManagedLifecycle} registry. All registered event listeners,
+ * timers, and AbortControllers are automatically torn down when the host
+ * component unmounts.
+ *
+ * The returned object has stable identity across re-renders (backed by `useMemo`
+ * / `useRef`) so it can be placed in dependency arrays without causing churn.
+ */
+declare function useManagedLifecycle(): ManagedLifecycle;
+
+export { type AuthenticatedQueryResult, BaseMcpService, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, type InsetLease, type ManagedLifecycle, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, TemplateContext, type TemplateManifest, type ToolInvoker, type ViewComponent, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useOverlayHost, usePluginRealtime, useToolInvoker, useToolInvokerMap, useView };

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

@@ -89,7 +89,14 @@ interface PluginPageDefinerConfig {
  */
 declare function createPluginPageDefiner(config: PluginPageDefinerConfig): (Page: ComponentType<PlatformReactPageProps>, views?: Record<string, ViewComponent>) => ComponentType<PlatformReactPageProps>;
 
-/** Matches regular function components and `React.lazy` wrappers. */
+/**
+ * Matches component types renderable via `useView`: plain function/class
+ * components plus the object wrappers `React.lazy`, `React.forwardRef`, and
+ * `React.memo` (incl. `memo(forwardRef(...))`, whose outer tag is `react.memo`).
+ * Deliberately narrower than `react-is`'s `isValidElementType`, which also accepts
+ * host-tag strings and Fragment/Suspense symbols — a manifest view value is always
+ * a component, never a bare string.
+ */
 declare function isComponent(value: unknown): value is ComponentType;
 /**
  * Builds a `useView` hook bound to a fallback component. The hook is a safe
@@ -793,4 +800,173 @@ declare function createReactRouterShim(options?: ReactRouterShimOptions): {
  */
 declare function usePluginRealtime(typeCode: string, handler: (payload: unknown) => void): void;
 
-export { type AuthenticatedQueryResult, BaseMcpService, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, MissingViewFallback, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, TemplateContext, type TemplateManifest, type ToolInvoker, type ViewComponent, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, usePluginRealtime, useToolInvoker, useToolInvokerMap, useView };
+declare const OVERLAY_HOST_CONTRACT_VERSION = "1.0.0";
+/** Canonical inset-lease identity — the SAME shape the web host layout store uses (Codex R2 M1:
+ *  one lease shape across SDK/web/store, no adapter). The store's handle extends this with `source`. */
+interface InsetLease {
+    readonly leaseId: string;
+    readonly generation: number;
+}
+interface OverlayHostCapabilities {
+    readonly contractVersion: string;
+    readonly contentInset: boolean;
+    readonly focusHelpers: boolean;
+    readonly safeArea: boolean;
+}
+/** The host-provided API. The host constructs this object; the plugin receives it as a prop and
+ *  reads it via useOverlayHost(). Shape is additive-only — add optional fields, never remove. */
+interface OverlayHostApi {
+    /** Reserve host content space. Returns a lease on grant, or NULL when the request is rejected
+     *  (invalid px) or YIELDED (a higher-precedence source holds the inset) — Codex R2: the contract
+     *  represents reject/yield deterministically so the overlay can fall back to float mode. */
+    requestContentInset(inset: {
+        side: "right";
+        px: number;
+    }): InsetLease | null;
+    releaseContentInset(lease: InsetLease): void;
+    readonly viewport: {
+        width: number;
+        height: number;
+    };
+    readonly breakpoint: "mobile" | "tablet" | "desktop";
+    readonly capabilities: OverlayHostCapabilities;
+    /** Register a cancellation callback the host invokes during an identity transition (§6.1) BEFORE it
+     *  unmounts the overlay — the overlay uses it to cancel its in-flight server-side assistant turn so
+     *  no run continues under stale authority. Returns an unsubscribe. Additive; the host guarantees
+     *  every registered callback runs (awaited best-effort) before the remount. (Codex R1 H4 — this is
+     *  the concrete registration path Task 4.6's transition protocol invokes.) */
+    registerActivityCancellation(cancel: () => void | Promise<void>): () => void;
+    /** Focus-handoff helpers (§7.3). Return focus to the launcher on close/Escape. */
+    readonly focus: {
+        onEscape(handler: () => void): () => void;
+        returnFocusToLauncher(): void;
+    };
+}
+/** Props the host injects into the overlay component (mirrors PlatformReactPageProps + overlayHost). */
+interface PlatformReactOverlayProps {
+    extensionId: string;
+    organisationId: string;
+    tenantId?: string;
+    overlayId: string;
+    overlayHost: OverlayHostApi;
+}
+declare const OverlayHostContext: react.Context<OverlayHostApi | null>;
+
+/**
+ * Reads the host-provided overlay API. Must be called inside a PlatformReact overlay mounted by the
+ * host (the host injects the API via the `overlayHost` prop, which
+ * `definePlatformReactPluginOverlay` bridges into {@link OverlayHostContext}).
+ */
+declare function useOverlayHost(): OverlayHostApi;
+
+interface DefinePlatformReactPluginOverlayOptions {
+    rootClassName: string;
+    styleId: string;
+    css: string;
+    manifest?: Record<string, Partial<Record<string, ViewComponent>>>;
+    wrapOverlay?: (overlay: ReactElement) => ReactElement;
+}
+/**
+ * Wraps an overlay component as a PlatformReact entry with the providers the host
+ * needs: the `OverlayHostContext` (bridging the `overlayHost` prop into a plugin-side
+ * context for `useOverlayHost()`), the static `useView` manifest, and the scoped style
+ * root. Mirrors `definePlatformReactPluginPage`; the key difference is the
+ * `OverlayHostContext.Provider` wrapping the `overlayHost` prop.
+ *
+ * @ethisyscore/plugin-ui is BUNDLED into the plugin (not externalized), so a React
+ * context created in the host's module copy would not be identity-equal to the
+ * plugin's copy. Passing the API as a prop and bridging it here is the correct seam
+ * (D-2 design decision).
+ */
+declare function definePlatformReactPluginOverlay(Overlay: ComponentType<PlatformReactOverlayProps>, options: DefinePlatformReactPluginOverlayOptions): ComponentType<PlatformReactOverlayProps>;
+interface PluginOverlayDefinerConfig {
+    module: string;
+    rootClassName: string;
+    styleId: string;
+    css: string;
+    wrapOverlay?: (overlay: ReactElement) => ReactElement;
+}
+/**
+ * Builds a plugin-bound `definePluginOverlay(Overlay, views)` from one config, so a
+ * plugin writes the four plugin-specific values (module key, root class, style id, CSS)
+ * ONCE instead of in every overlay entry. The flat `views` map is wrapped into the
+ * `{ [module]: views }` manifest slice that `useView(module, name)` reads. Mirrors
+ * `createPluginPageDefiner`.
+ */
+declare function createPluginOverlayDefiner(config: PluginOverlayDefinerConfig): (Overlay: ComponentType<PlatformReactOverlayProps>, views?: Record<string, ViewComponent>) => ComponentType<PlatformReactOverlayProps>;
+
+/**
+ * A managed cleanup registry the overlay uses to register event listeners,
+ * timers, and AbortControllers. All registrations are torn down deterministically
+ * when the host component unmounts.
+ *
+ * **Teardown semantics (R2 decision):** the HOST does NOT call `disposeAll()`.
+ * Teardown rides on React's unmount cleanup (`useEffect(() => () => disposeAll(), [])`),
+ * which the host guarantees by forcing unmount via the identity-key change at
+ * the remount boundary. `disposeAll()` is exposed as an OPTIONAL early-teardown
+ * affordance for the overlay's own use only — not the host's teardown path.
+ *
+ * @example
+ * ```tsx
+ * function MyOverlay() {
+ *   const lifecycle = useManagedLifecycle();
+ *   useEffect(() => {
+ *     lifecycle.addEventListener(window, "resize", handleResize);
+ *     const ctrl = lifecycle.createAbortController();
+ *     fetch("/api/data", { signal: ctrl.signal });
+ *   }, [lifecycle]);
+ *   return <div />;
+ * }
+ * ```
+ */
+interface ManagedLifecycle {
+    /**
+     * Registers an event listener on `target`. The listener is automatically
+     * removed when the host component unmounts (or when `disposeAll()` is called).
+     */
+    addEventListener(target: Window | Document | HTMLElement, type: string, listener: EventListenerOrEventListenerObject, options?: AddEventListenerOptions): void;
+    /**
+     * Schedules a repeating callback. The interval is automatically cleared when
+     * the host component unmounts (or when `disposeAll()` is called).
+     *
+     * @returns The interval ID (mirrors the native return value).
+     */
+    setInterval(handler: () => void, ms: number): number;
+    /**
+     * Schedules a one-shot callback. The timeout is automatically cleared when
+     * the host component unmounts (or when `disposeAll()` is called).
+     *
+     * @returns The timeout ID (mirrors the native return value).
+     */
+    setTimeout(handler: () => void, ms: number): number;
+    /**
+     * Creates an AbortController whose signal is aborted when the host component
+     * unmounts (or when `disposeAll()` is called).
+     *
+     * @returns The AbortController. The caller may pass `.signal` to fetch/streams.
+     */
+    createAbortController(): AbortController;
+    /**
+     * Optional early-teardown affordance for the overlay's own use. Removes all
+     * registered listeners, clears all timers, and aborts all controllers
+     * immediately.
+     *
+     * Idempotent: subsequent calls (including the React unmount cleanup) are safe
+     * and do not throw.
+     *
+     * **The host does NOT call this.** Host-driven teardown is guaranteed by
+     * React unmount cleanup via the identity-key remount mechanism.
+     */
+    disposeAll(): void;
+}
+/**
+ * Returns a {@link ManagedLifecycle} registry. All registered event listeners,
+ * timers, and AbortControllers are automatically torn down when the host
+ * component unmounts.
+ *
+ * The returned object has stable identity across re-renders (backed by `useMemo`
+ * / `useRef`) so it can be placed in dependency arrays without causing churn.
+ */
+declare function useManagedLifecycle(): ManagedLifecycle;
+
+export { type AuthenticatedQueryResult, BaseMcpService, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, type InsetLease, type ManagedLifecycle, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, TemplateContext, type TemplateManifest, type ToolInvoker, type ViewComponent, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useOverlayHost, usePluginRealtime, useToolInvoker, useToolInvokerMap, useView };

package/dist/platform-react/index.js

@@ -100,11 +100,16 @@ var MissingViewFallback = () => createElement(
 );
 
 // src/platform-react/useView.ts
-var REACT_LAZY_TYPE = /* @__PURE__ */ Symbol.for("react.lazy");
+var RENDERABLE_COMPONENT_TYPEOFS = /* @__PURE__ */ new Set([
+  /* @__PURE__ */ Symbol.for("react.lazy"),
+  /* @__PURE__ */ Symbol.for("react.forward_ref"),
+  /* @__PURE__ */ Symbol.for("react.memo")
+]);
 function isComponent(value) {
   if (typeof value === "function") return true;
   if (typeof value === "object" && value !== null) {
-    return value.$$typeof === REACT_LAZY_TYPE;
+    const tag = value.$$typeof;
+    return typeof tag === "symbol" && RENDERABLE_COMPONENT_TYPEOFS.has(tag);
   }
   return false;
 }
@@ -280,7 +285,88 @@ function usePluginRealtime(typeCode, handler) {
     return source.subscribe(typeCode, (payload) => ref.current(payload));
   }, [source, typeCode]);
 }
+var OVERLAY_HOST_CONTRACT_VERSION = "1.0.0";
+var OverlayHostContext = createContext(null);
+function useOverlayHost() {
+  const api = useContext(OverlayHostContext);
+  if (api === null) {
+    throw new Error("useOverlayHost must be used within a host-mounted PlatformReact overlay.");
+  }
+  return api;
+}
+function definePlatformReactPluginOverlay(Overlay, options) {
+  const { rootClassName, styleId, css, manifest = {}, wrapOverlay } = options;
+  return function MountedOverlay(props) {
+    const tree = createElement(
+      OverlayHostContext.Provider,
+      { value: props.overlayHost },
+      createElement(
+        TemplateContext.Provider,
+        { value: manifest },
+        createElement(PluginStyleScope, { id: styleId, css }),
+        createElement(
+          "div",
+          { className: `${EHX_PLUGIN_ROOT_CLASS} ${rootClassName}` },
+          createElement(Overlay, props)
+        )
+      )
+    );
+    return wrapOverlay ? wrapOverlay(tree) : tree;
+  };
+}
+function createPluginOverlayDefiner(config) {
+  const { module, ...rest } = config;
+  return function definePluginOverlay(Overlay, views = {}) {
+    return definePlatformReactPluginOverlay(Overlay, { ...rest, manifest: { [module]: views } });
+  };
+}
+function useManagedLifecycle() {
+  const entriesRef = useRef([]);
+  const lifecycle = useMemo(() => {
+    const addEventListener = (target, type, listener, options) => {
+      target.addEventListener(type, listener, options);
+      entriesRef.current.push({ kind: "listener", target, type, listener, options });
+    };
+    const setInterval = (handler, ms) => {
+      const id = globalThis.setInterval(handler, ms);
+      entriesRef.current.push({ kind: "interval", id });
+      return id;
+    };
+    const setTimeout = (handler, ms) => {
+      const id = globalThis.setTimeout(handler, ms);
+      entriesRef.current.push({ kind: "timeout", id });
+      return id;
+    };
+    const createAbortController = () => {
+      const controller = new AbortController();
+      entriesRef.current.push({ kind: "controller", controller });
+      return controller;
+    };
+    const disposeAll = () => {
+      const entries = entriesRef.current.splice(0);
+      for (const entry of entries) {
+        switch (entry.kind) {
+          case "listener":
+            entry.target.removeEventListener(entry.type, entry.listener, entry.options);
+            break;
+          case "interval":
+            globalThis.clearInterval(entry.id);
+            break;
+          case "timeout":
+            globalThis.clearTimeout(entry.id);
+            break;
+          case "controller":
+            entry.controller.abort();
+            break;
+        }
+      }
+    };
+    return { addEventListener, setInterval, setTimeout, createAbortController, disposeAll };
+  }, []);
+  useEffect(() => () => lifecycle.disposeAll(), [lifecycle]);
+  return lifecycle;
+}
 
-export { BaseMcpService, EHX_PLUGIN_ROOT_CLASS, MissingViewFallback, PluginStyleScope, TemplateContext, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, usePluginRealtime, useToolInvoker, useToolInvokerMap, useView };
+export { BaseMcpService, EHX_PLUGIN_ROOT_CLASS, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginStyleScope, TemplateContext, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useOverlayHost, usePluginRealtime, useToolInvoker, useToolInvokerMap, useView };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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","../../src/platform-react/usePluginRealtime.ts"],"names":["createElement","useView","useEffect"],"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","import { useEffect, useRef } from \"react\";\nimport { usePluginRealtimeSource } from \"@ethisyscore/extension-runtime/plugin\";\n\n/**\n * Subscribe to realtime push notifications of a given `typeCode`.\n *\n * Subscribes on mount and unsubscribes on unmount. The `handler` is kept in a\n * ref so re-renders with a new closure do not churn the underlying subscription\n * — the latest handler is always used without needing to re-subscribe.\n *\n * No-ops cleanly when the plugin runtime has no realtime source (dev/mock\n * environments, or plugins that have not been given a SignalR connection by\n * the host).\n *\n * @param typeCode  Application-level event type to filter on (e.g.\n *                  `\"HelpdeskTicketCreated\"`). Filtering by extensionId is the\n *                  host's responsibility.\n * @param handler   Called with the raw notification payload each time a\n *                  matching notification arrives.\n */\nexport function usePluginRealtime(\n    typeCode: string,\n    handler: (payload: unknown) => void,\n): void\n{\n    const source = usePluginRealtimeSource();\n    const ref = useRef(handler);\n    ref.current = handler;\n\n    useEffect(() =>\n    {\n        if (!source) return; // dev/mock: no connection — no-op\n\n        return source.subscribe(typeCode, (payload: unknown) => ref.current(payload));\n    }, [source, typeCode]);\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","../../src/platform-react/usePluginRealtime.ts","../../src/platform-react/overlayHostContext.ts","../../src/platform-react/useOverlayHost.ts","../../src/platform-react/definePlatformReactPluginOverlay.tsx","../../src/platform-react/managedLifecycle.ts"],"names":["createElement","useView","useEffect","createContext","useContext","useRef","useMemo"],"mappings":";;;;;;AAeO,IAAM,eAAA,GAAkB,cAAuC,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,EAAA,SAAA,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,IAAI,WAAA,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,GAAO,aAAA,CAAc,IAAA,EAAM,KAAK,CAAA;AACtC,IAAA,MAAM,IAAA,GAAO,QAAA,GAAW,QAAA,CAAS,IAAI,CAAA,GAAI,IAAA;AACzC,IAAA,OAAO,aAAA;AAAA,MACL,mBAAA;AAAA,MACA,EAAE,QAAQ,WAAA,EAAY;AAAA,MACtB,aAAA;AAAA,QACE,eAAA,CAAgB,QAAA;AAAA,QAChB,EAAE,OAAO,QAAA,EAAS;AAAA,QAClB,cAAc,gBAAA,EAAkB,EAAE,EAAA,EAAI,OAAA,EAAS,KAAK,CAAA;AAAA,QACpD,aAAA;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,OAAO,wBAAwB,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,MACzEA,aAAAA;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,aAAAA;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,aAAAA,CAAc,GAAA,EAAK,EAAE,KAAA,EAAO,EAAE,MAAA,EAAQ,YAAA,EAAc,UAAA,EAAY,GAAA,EAAI,EAAE,EAAG,oBAAoB,CAAA;AAAA,IAC7FA,aAAAA;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;;;AC5BF,IAAM,4BAAA,uBAAmC,GAAA,CAAY;AAAA,kBACnD,MAAA,CAAO,IAAI,YAAY,CAAA;AAAA,kBACvB,MAAA,CAAO,IAAI,mBAAmB,CAAA;AAAA,kBAC9B,MAAA,CAAO,IAAI,YAAY;AACzB,CAAC,CAAA;AAUM,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,MAAM,MAAO,KAAA,CAAkC,QAAA;AAC/C,IAAA,OAAO,OAAO,GAAA,KAAQ,QAAA,IAAY,4BAAA,CAA6B,IAAI,GAAG,CAAA;AAAA,EACxE;AACA,EAAA,OAAO,KAAA;AACT;AAQO,SAAS,cAAc,QAAA,EAAkD;AAC9E,EAAA,OAAO,SAASC,QAAAA,CACd,MAAA,EACA,QAAA,EACwC;AACxC,IAAA,MAAM,QAAA,GAAW,WAAW,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;AC9CjD,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,OAAO,UAAA,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,GAAI,UAAA,CAAW,IAAI,CAAA,CAAE,MAAA;AAAA,EACpC;AACA,EAAA,OAAO,OAAA;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,GAAS,SAAS,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,OAAO,UAAA,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,MAAA,cAAA,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,OAAOD,aAAAA;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,UAAA,cAAA,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;ACnJO,SAAS,iBAAA,CACZ,UACA,OAAA,EAEJ;AACI,EAAA,MAAM,SAAS,uBAAA,EAAwB;AACvC,EAAA,MAAM,GAAA,GAAM,OAAO,OAAO,CAAA;AAC1B,EAAA,GAAA,CAAI,OAAA,GAAU,OAAA;AAEd,EAAAE,UAAU,MACV;AACI,IAAA,IAAI,CAAC,MAAA,EAAQ;AAEb,IAAA,OAAO,MAAA,CAAO,UAAU,QAAA,EAAU,CAAC,YAAqB,GAAA,CAAI,OAAA,CAAQ,OAAO,CAAC,CAAA;AAAA,EAChF,CAAA,EAAG,CAAC,MAAA,EAAQ,QAAQ,CAAC,CAAA;AACzB;ACjCO,IAAM,6BAAA,GAAgC;AAiDtC,IAAM,kBAAA,GAAqBC,cAAqC,IAAI;AC3CpE,SAAS,cAAA,GAAiC;AAC/C,EAAA,MAAM,GAAA,GAAMC,WAAW,kBAAkB,CAAA;AACzC,EAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,IAAA,MAAM,IAAI,MAAM,0EAA0E,CAAA;AAAA,EAC5F;AACA,EAAA,OAAO,GAAA;AACT;ACeO,SAAS,gCAAA,CACd,SACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,EAAE,eAAe,OAAA,EAAS,GAAA,EAAK,WAAW,EAAC,EAAG,aAAY,GAAI,OAAA;AACpE,EAAA,OAAO,SAAS,eAAe,KAAA,EAAkC;AAI/D,IAAA,MAAM,IAAA,GAAOJ,aAAAA;AAAA,MACX,kBAAA,CAAmB,QAAA;AAAA,MACnB,EAAE,KAAA,EAAO,KAAA,CAAM,WAAA,EAAY;AAAA,MAC3BA,aAAAA;AAAA,QACE,eAAA,CAAgB,QAAA;AAAA,QAChB,EAAE,OAAO,QAAA,EAAS;AAAA,QAClBA,cAAc,gBAAA,EAAkB,EAAE,EAAA,EAAI,OAAA,EAAS,KAAK,CAAA;AAAA,QACpDA,aAAAA;AAAA,UACE,KAAA;AAAA,UACA,EAAE,SAAA,EAAW,CAAA,EAAG,qBAAqB,CAAA,CAAA,EAAI,aAAa,CAAA,CAAA,EAAG;AAAA,UACzDA,aAAAA,CAAc,SAAS,KAAK;AAAA;AAC9B;AACF,KACF;AACA,IAAA,OAAO,WAAA,GAAc,WAAA,CAAY,IAAI,CAAA,GAAI,IAAA;AAAA,EAC3C,CAAA;AACF;AAiBO,SAAS,2BAA2B,MAAA,EAAoC;AAC7E,EAAA,MAAM,EAAE,MAAA,EAAQ,GAAG,IAAA,EAAK,GAAI,MAAA;AAC5B,EAAA,OAAO,SAAS,mBAAA,CACd,OAAA,EACA,KAAA,GAAuC,EAAC,EACE;AAC1C,IAAA,OAAO,gCAAA,CAAiC,OAAA,EAAS,EAAE,GAAG,IAAA,EAAM,QAAA,EAAU,EAAE,CAAC,MAAM,GAAG,KAAA,EAAM,EAAG,CAAA;AAAA,EAC7F,CAAA;AACF;ACsCO,SAAS,mBAAA,GAAwC;AAKtD,EAAA,MAAM,UAAA,GAAaK,MAAAA,CAAwB,EAAE,CAAA;AAK7C,EAAA,MAAM,SAAA,GAAYC,QAA0B,MAAM;AAChD,IAAA,MAAM,gBAAA,GAAmB,CACvB,MAAA,EACA,IAAA,EACA,UACA,OAAA,KACS;AACT,MAAA,MAAA,CAAO,gBAAA,CAAiB,IAAA,EAAM,QAAA,EAAU,OAAO,CAAA;AAC/C,MAAA,UAAA,CAAW,OAAA,CAAQ,KAAK,EAAE,IAAA,EAAM,YAAY,MAAA,EAAQ,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,CAAA;AAAA,IAC/E,CAAA;AAEA,IAAA,MAAM,WAAA,GAAc,CAAC,OAAA,EAAqB,EAAA,KAAuB;AAC/D,MAAA,MAAM,EAAA,GAAK,UAAA,CAAW,WAAA,CAAY,OAAA,EAAS,EAAE,CAAA;AAC7C,MAAA,UAAA,CAAW,QAAQ,IAAA,CAAK,EAAE,IAAA,EAAM,UAAA,EAAY,IAAI,CAAA;AAChD,MAAA,OAAO,EAAA;AAAA,IACT,CAAA;AAEA,IAAA,MAAM,UAAA,GAAa,CAAC,OAAA,EAAqB,EAAA,KAAuB;AAC9D,MAAA,MAAM,EAAA,GAAK,UAAA,CAAW,UAAA,CAAW,OAAA,EAAS,EAAE,CAAA;AAC5C,MAAA,UAAA,CAAW,QAAQ,IAAA,CAAK,EAAE,IAAA,EAAM,SAAA,EAAW,IAAI,CAAA;AAC/C,MAAA,OAAO,EAAA;AAAA,IACT,CAAA;AAEA,IAAA,MAAM,wBAAwB,MAAuB;AACnD,MAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,MAAA,UAAA,CAAW,QAAQ,IAAA,CAAK,EAAE,IAAA,EAAM,YAAA,EAAc,YAAY,CAAA;AAC1D,MAAA,OAAO,UAAA;AAAA,IACT,CAAA;AAEA,IAAA,MAAM,aAAa,MAAY;AAE7B,MAAA,MAAM,OAAA,GAAU,UAAA,CAAW,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA;AAC3C,MAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,QAAA,QAAQ,MAAM,IAAA;AAAM,UAClB,KAAK,UAAA;AACH,YAAA,KAAA,CAAM,OAAO,mBAAA,CAAoB,KAAA,CAAM,MAAM,KAAA,CAAM,QAAA,EAAU,MAAM,OAAO,CAAA;AAC1E,YAAA;AAAA,UACF,KAAK,UAAA;AACH,YAAA,UAAA,CAAW,aAAA,CAAc,MAAM,EAAE,CAAA;AACjC,YAAA;AAAA,UACF,KAAK,SAAA;AACH,YAAA,UAAA,CAAW,YAAA,CAAa,MAAM,EAAE,CAAA;AAChC,YAAA;AAAA,UACF,KAAK,YAAA;AACH,YAAA,KAAA,CAAM,WAAW,KAAA,EAAM;AACvB,YAAA;AAAA;AACJ,MACF;AAAA,IACF,CAAA;AAEA,IAAA,OAAO,EAAE,gBAAA,EAAkB,WAAA,EAAa,UAAA,EAAY,uBAAuB,UAAA,EAAW;AAAA,EAExF,CAAA,EAAG,EAAE,CAAA;AAIL,EAAAJ,SAAAA,CAAU,MAAM,MAAM,SAAA,CAAU,YAAW,EAAG,CAAC,SAAS,CAAC,CAAA;AAEzD,EAAA,OAAO,SAAA;AACT","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\n// Renderable component object-types keyed by their `$$typeof` tag. Plain function\n// (and class) components are matched by `typeof === \"function\"`; the wrappers below\n// are objects, not functions, so they need an explicit tag check. `forwardRef` and\n// `memo` were previously omitted — a `forwardRef`/`memo` view registered in the\n// manifest failed `isComponent` and `useView` fell back to \"View not available\".\nconst RENDERABLE_COMPONENT_TYPEOFS = new Set<symbol>([\n  Symbol.for(\"react.lazy\"),\n  Symbol.for(\"react.forward_ref\"),\n  Symbol.for(\"react.memo\"),\n]);\n\n/**\n * Matches component types renderable via `useView`: plain function/class\n * components plus the object wrappers `React.lazy`, `React.forwardRef`, and\n * `React.memo` (incl. `memo(forwardRef(...))`, whose outer tag is `react.memo`).\n * Deliberately narrower than `react-is`'s `isValidElementType`, which also accepts\n * host-tag strings and Fragment/Suspense symbols — a manifest view value is always\n * a component, never a bare string.\n */\nexport function isComponent(value: unknown): value is ComponentType {\n  if (typeof value === \"function\") return true;\n  if (typeof value === \"object\" && value !== null) {\n    const tag = (value as Record<string, unknown>).$$typeof;\n    return typeof tag === \"symbol\" && RENDERABLE_COMPONENT_TYPEOFS.has(tag);\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","import { useEffect, useRef } from \"react\";\nimport { usePluginRealtimeSource } from \"@ethisyscore/extension-runtime/plugin\";\n\n/**\n * Subscribe to realtime push notifications of a given `typeCode`.\n *\n * Subscribes on mount and unsubscribes on unmount. The `handler` is kept in a\n * ref so re-renders with a new closure do not churn the underlying subscription\n * — the latest handler is always used without needing to re-subscribe.\n *\n * No-ops cleanly when the plugin runtime has no realtime source (dev/mock\n * environments, or plugins that have not been given a SignalR connection by\n * the host).\n *\n * @param typeCode  Application-level event type to filter on (e.g.\n *                  `\"HelpdeskTicketCreated\"`). Filtering by extensionId is the\n *                  host's responsibility.\n * @param handler   Called with the raw notification payload each time a\n *                  matching notification arrives.\n */\nexport function usePluginRealtime(\n    typeCode: string,\n    handler: (payload: unknown) => void,\n): void\n{\n    const source = usePluginRealtimeSource();\n    const ref = useRef(handler);\n    ref.current = handler;\n\n    useEffect(() =>\n    {\n        if (!source) return; // dev/mock: no connection — no-op\n\n        return source.subscribe(typeCode, (payload: unknown) => ref.current(payload));\n    }, [source, typeCode]);\n}\n","import { createContext } from \"react\";\n\nexport const OVERLAY_HOST_CONTRACT_VERSION = \"1.0.0\";\n\n/** Canonical inset-lease identity — the SAME shape the web host layout store uses (Codex R2 M1:\n *  one lease shape across SDK/web/store, no adapter). The store's handle extends this with `source`. */\nexport interface InsetLease {\n  readonly leaseId: string;\n  readonly generation: number;\n}\n\nexport interface OverlayHostCapabilities {\n  readonly contractVersion: string; // OVERLAY_HOST_CONTRACT_VERSION the host implements\n  readonly contentInset: boolean; // side-by-side inset supported\n  readonly focusHelpers: boolean; // focus-handoff + Escape helpers present\n  readonly safeArea: boolean; // mobile safe-area insets provided\n}\n\n/** The host-provided API. The host constructs this object; the plugin receives it as a prop and\n *  reads it via useOverlayHost(). Shape is additive-only — add optional fields, never remove. */\nexport interface OverlayHostApi {\n  /** Reserve host content space. Returns a lease on grant, or NULL when the request is rejected\n   *  (invalid px) or YIELDED (a higher-precedence source holds the inset) — Codex R2: the contract\n   *  represents reject/yield deterministically so the overlay can fall back to float mode. */\n  requestContentInset(inset: { side: \"right\"; px: number }): InsetLease | null;\n  releaseContentInset(lease: InsetLease): void; // idempotent; stale handle = no-op\n  readonly viewport: { width: number; height: number };\n  readonly breakpoint: \"mobile\" | \"tablet\" | \"desktop\"; // host-authoritative\n  readonly capabilities: OverlayHostCapabilities;\n  /** Register a cancellation callback the host invokes during an identity transition (§6.1) BEFORE it\n   *  unmounts the overlay — the overlay uses it to cancel its in-flight server-side assistant turn so\n   *  no run continues under stale authority. Returns an unsubscribe. Additive; the host guarantees\n   *  every registered callback runs (awaited best-effort) before the remount. (Codex R1 H4 — this is\n   *  the concrete registration path Task 4.6's transition protocol invokes.) */\n  registerActivityCancellation(cancel: () => void | Promise<void>): () => void;\n  /** Focus-handoff helpers (§7.3). Return focus to the launcher on close/Escape. */\n  readonly focus: {\n    onEscape(handler: () => void): () => void; // returns an unsubscribe\n    returnFocusToLauncher(): void;\n  };\n}\n\n/** Props the host injects into the overlay component (mirrors PlatformReactPageProps + overlayHost). */\nexport interface PlatformReactOverlayProps {\n  extensionId: string;\n  organisationId: string;\n  tenantId?: string;\n  overlayId: string;\n  overlayHost: OverlayHostApi;\n}\n\nexport const OverlayHostContext = createContext<OverlayHostApi | null>(null);\n","import { useContext } from \"react\";\nimport { OverlayHostContext, type OverlayHostApi } from \"./overlayHostContext\";\n\n/**\n * Reads the host-provided overlay API. Must be called inside a PlatformReact overlay mounted by the\n * host (the host injects the API via the `overlayHost` prop, which\n * `definePlatformReactPluginOverlay` bridges into {@link OverlayHostContext}).\n */\nexport function useOverlayHost(): OverlayHostApi {\n  const api = useContext(OverlayHostContext);\n  if (api === null) {\n    throw new Error(\"useOverlayHost must be used within a host-mounted PlatformReact overlay.\");\n  }\n  return api;\n}\n","import { createElement, type ComponentType, type ReactElement } from \"react\";\nimport {\n  OverlayHostContext,\n  type PlatformReactOverlayProps,\n} from \"./overlayHostContext\";\nimport { TemplateContext, type ViewComponent } from \"./templateContext\";\nimport { PluginStyleScope } from \"./injectStyles\";\nimport { EHX_PLUGIN_ROOT_CLASS } from \"./definePlatformReactPluginPage\";\n\nexport interface DefinePlatformReactPluginOverlayOptions {\n  rootClassName: string;\n  styleId: string;\n  css: string;\n  manifest?: Record<string, Partial<Record<string, ViewComponent>>>;\n  wrapOverlay?: (overlay: ReactElement) => ReactElement;\n}\n\n/**\n * Wraps an overlay component as a PlatformReact entry with the providers the host\n * needs: the `OverlayHostContext` (bridging the `overlayHost` prop into a plugin-side\n * context for `useOverlayHost()`), the static `useView` manifest, and the scoped style\n * root. Mirrors `definePlatformReactPluginPage`; the key difference is the\n * `OverlayHostContext.Provider` wrapping the `overlayHost` prop.\n *\n * @ethisyscore/plugin-ui is BUNDLED into the plugin (not externalized), so a React\n * context created in the host's module copy would not be identity-equal to the\n * plugin's copy. Passing the API as a prop and bridging it here is the correct seam\n * (D-2 design decision).\n */\nexport function definePlatformReactPluginOverlay(\n  Overlay: ComponentType<PlatformReactOverlayProps>,\n  options: DefinePlatformReactPluginOverlayOptions,\n): ComponentType<PlatformReactOverlayProps> {\n  const { rootClassName, styleId, css, manifest = {}, wrapOverlay } = options;\n  return function MountedOverlay(props: PlatformReactOverlayProps) {\n    // Inject styles via <PluginStyleScope> (effect-based, idempotent under\n    // StrictMode) rather than calling injectPluginStyles() during render — keeps\n    // render pure and mirrors definePlatformReactPluginPage.\n    const tree = createElement(\n      OverlayHostContext.Provider,\n      { value: props.overlayHost },\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(Overlay, props),\n        ),\n      ),\n    );\n    return wrapOverlay ? wrapOverlay(tree) : tree;\n  };\n}\n\nexport interface PluginOverlayDefinerConfig {\n  module: string;\n  rootClassName: string;\n  styleId: string;\n  css: string;\n  wrapOverlay?: (overlay: ReactElement) => ReactElement;\n}\n\n/**\n * Builds a plugin-bound `definePluginOverlay(Overlay, views)` from one config, so a\n * plugin writes the four plugin-specific values (module key, root class, style id, CSS)\n * ONCE instead of in every overlay entry. The flat `views` map is wrapped into the\n * `{ [module]: views }` manifest slice that `useView(module, name)` reads. Mirrors\n * `createPluginPageDefiner`.\n */\nexport function createPluginOverlayDefiner(config: PluginOverlayDefinerConfig) {\n  const { module, ...rest } = config;\n  return function definePluginOverlay(\n    Overlay: ComponentType<PlatformReactOverlayProps>,\n    views: Record<string, ViewComponent> = {},\n  ): ComponentType<PlatformReactOverlayProps> {\n    return definePlatformReactPluginOverlay(Overlay, { ...rest, manifest: { [module]: views } });\n  };\n}\n","import { useEffect, useMemo, useRef } from \"react\";\n\n/**\n * A managed cleanup registry the overlay uses to register event listeners,\n * timers, and AbortControllers. All registrations are torn down deterministically\n * when the host component unmounts.\n *\n * **Teardown semantics (R2 decision):** the HOST does NOT call `disposeAll()`.\n * Teardown rides on React's unmount cleanup (`useEffect(() => () => disposeAll(), [])`),\n * which the host guarantees by forcing unmount via the identity-key change at\n * the remount boundary. `disposeAll()` is exposed as an OPTIONAL early-teardown\n * affordance for the overlay's own use only — not the host's teardown path.\n *\n * @example\n * ```tsx\n * function MyOverlay() {\n *   const lifecycle = useManagedLifecycle();\n *   useEffect(() => {\n *     lifecycle.addEventListener(window, \"resize\", handleResize);\n *     const ctrl = lifecycle.createAbortController();\n *     fetch(\"/api/data\", { signal: ctrl.signal });\n *   }, [lifecycle]);\n *   return <div />;\n * }\n * ```\n */\nexport interface ManagedLifecycle {\n  /**\n   * Registers an event listener on `target`. The listener is automatically\n   * removed when the host component unmounts (or when `disposeAll()` is called).\n   */\n  addEventListener(\n    target: Window | Document | HTMLElement,\n    type: string,\n    listener: EventListenerOrEventListenerObject,\n    options?: AddEventListenerOptions,\n  ): void;\n\n  /**\n   * Schedules a repeating callback. The interval is automatically cleared when\n   * the host component unmounts (or when `disposeAll()` is called).\n   *\n   * @returns The interval ID (mirrors the native return value).\n   */\n  setInterval(handler: () => void, ms: number): number;\n\n  /**\n   * Schedules a one-shot callback. The timeout is automatically cleared when\n   * the host component unmounts (or when `disposeAll()` is called).\n   *\n   * @returns The timeout ID (mirrors the native return value).\n   */\n  setTimeout(handler: () => void, ms: number): number;\n\n  /**\n   * Creates an AbortController whose signal is aborted when the host component\n   * unmounts (or when `disposeAll()` is called).\n   *\n   * @returns The AbortController. The caller may pass `.signal` to fetch/streams.\n   */\n  createAbortController(): AbortController;\n\n  /**\n   * Optional early-teardown affordance for the overlay's own use. Removes all\n   * registered listeners, clears all timers, and aborts all controllers\n   * immediately.\n   *\n   * Idempotent: subsequent calls (including the React unmount cleanup) are safe\n   * and do not throw.\n   *\n   * **The host does NOT call this.** Host-driven teardown is guaranteed by\n   * React unmount cleanup via the identity-key remount mechanism.\n   */\n  disposeAll(): void;\n}\n\n// ---------------------------------------------------------------------------\n// Internal registry entries\n// ---------------------------------------------------------------------------\n\ninterface ListenerEntry {\n  kind: \"listener\";\n  target: Window | Document | HTMLElement;\n  type: string;\n  listener: EventListenerOrEventListenerObject;\n  options?: AddEventListenerOptions;\n}\n\ninterface IntervalEntry {\n  kind: \"interval\";\n  id: number;\n}\n\ninterface TimeoutEntry {\n  kind: \"timeout\";\n  id: number;\n}\n\ninterface ControllerEntry {\n  kind: \"controller\";\n  controller: AbortController;\n}\n\ntype RegistryEntry = ListenerEntry | IntervalEntry | TimeoutEntry | ControllerEntry;\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\n/**\n * Returns a {@link ManagedLifecycle} registry. All registered event listeners,\n * timers, and AbortControllers are automatically torn down when the host\n * component unmounts.\n *\n * The returned object has stable identity across re-renders (backed by `useMemo`\n * / `useRef`) so it can be placed in dependency arrays without causing churn.\n */\nexport function useManagedLifecycle(): ManagedLifecycle {\n  // Ref holds the live registry so it is shared across all renders without\n  // causing re-renders. We use an Array (not a Set) for deterministic teardown\n  // order and because entries are not deduplicated — the same listener may be\n  // registered with different options.\n  const entriesRef = useRef<RegistryEntry[]>([]);\n\n  // Stable lifecycle object. `useMemo` with an empty dep array gives us a\n  // single object identity for the lifetime of the component, which means\n  // callers can safely include `lifecycle` in useEffect dependency arrays.\n  const lifecycle = useMemo<ManagedLifecycle>(() => {\n    const addEventListener = (\n      target: Window | Document | HTMLElement,\n      type: string,\n      listener: EventListenerOrEventListenerObject,\n      options?: AddEventListenerOptions,\n    ): void => {\n      target.addEventListener(type, listener, options);\n      entriesRef.current.push({ kind: \"listener\", target, type, listener, options });\n    };\n\n    const setInterval = (handler: () => void, ms: number): number => {\n      const id = globalThis.setInterval(handler, ms) as unknown as number;\n      entriesRef.current.push({ kind: \"interval\", id });\n      return id;\n    };\n\n    const setTimeout = (handler: () => void, ms: number): number => {\n      const id = globalThis.setTimeout(handler, ms) as unknown as number;\n      entriesRef.current.push({ kind: \"timeout\", id });\n      return id;\n    };\n\n    const createAbortController = (): AbortController => {\n      const controller = new AbortController();\n      entriesRef.current.push({ kind: \"controller\", controller });\n      return controller;\n    };\n\n    const disposeAll = (): void => {\n      // Drain the registry atomically so concurrent / re-entrant calls are safe.\n      const entries = entriesRef.current.splice(0);\n      for (const entry of entries) {\n        switch (entry.kind) {\n          case \"listener\":\n            entry.target.removeEventListener(entry.type, entry.listener, entry.options);\n            break;\n          case \"interval\":\n            globalThis.clearInterval(entry.id);\n            break;\n          case \"timeout\":\n            globalThis.clearTimeout(entry.id);\n            break;\n          case \"controller\":\n            entry.controller.abort();\n            break;\n        }\n      }\n    };\n\n    return { addEventListener, setInterval, setTimeout, createAbortController, disposeAll };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // Teardown on unmount. The host guarantees unmount via the identity-key change;\n  // `disposeAll()` is also an optional early-teardown path for the overlay itself.\n  useEffect(() => () => lifecycle.disposeAll(), [lifecycle]);\n\n  return lifecycle;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethisyscore/plugin-ui",
-  "version": "1.31.0",
+  "version": "1.33.0",
   "description": "Plugin-UI umbrella SDK: client bridge + a11y/l10n primitives + brokered-MCP client (WI 4858).",
   "type": "module",
   "main": "./dist/index.cjs",