@ethisyscore/plugin-ui 1.99.0 → 1.100.0

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

@@ -7,8 +7,8 @@ import { T as ToolInvoker } from '../mcpService-4h3sKDpW.cjs';
 export { B as BaseMcpService, n as notViaMcp, u as useToolInvoker, a as useToolInvokerMap } from '../mcpService-4h3sKDpW.cjs';
 import * as _tanstack_query_core from '@tanstack/query-core';
 import { McpTransport, UploadDocumentResult } from '@ethisyscore/extension-runtime/plugin';
-import { k as HostSidebarInput, n as HostSidebarHookInput } from '../useHostSidebarActions-Bt2U-EuA.cjs';
-export { H as HOST_CHROME_CONTRACT_VERSION, a as HostChromeDiagnostic, b as HostSidebarAction, c as HostSidebarActionDescriptor, d as HostSidebarActionSlot, e as HostSidebarActionVariant, f as HostSidebarActionsApi, g as HostSidebarActionsCapabilities, h as HostSidebarActionsContext, i as HostSidebarActionsPageProps, j as HostSidebarContribution, o as HostSidebarDerivedInput, l as HostSidebarNavItem, S as SIDEBAR_MODE, m as isHostChromeCompatible, r as reportHostChromeDiagnostic, s as setHostChromeDiagnosticSink, u as useHostSidebarActions } from '../useHostSidebarActions-Bt2U-EuA.cjs';
+import { l as HostSidebarInput, p as HostSidebarHookInput } from '../activeNavHref-BkBjanre.cjs';
+export { H as HOST_CHROME_CONTRACT_VERSION, a as HostChromeDiagnostic, b as HostSidebarAction, c as HostSidebarActionDescriptor, d as HostSidebarActionSlot, e as HostSidebarActionVariant, f as HostSidebarActionsApi, g as HostSidebarActionsCapabilities, h as HostSidebarActionsContext, i as HostSidebarActionsPageProps, j as HostSidebarActiveNav, k as HostSidebarContribution, q as HostSidebarDerivedInput, m as HostSidebarNavItem, R as ResolveActiveNavHrefOptions, S as SIDEBAR_MODE, n as isHostChromeCompatible, r as reportHostChromeDiagnostic, o as resolveActiveNavHref, s as setHostChromeDiagnosticSink, u as useHostSidebarActions, w as withActiveNavHref } from '../activeNavHref-BkBjanre.cjs';
 import { g as PluginDetailContext, H as HeaderMenuItem } from '../pageHeaderTypes-PWZpiwp6.cjs';
 
 /** A view component resolved from the template manifest. Props are open. */

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

@@ -7,8 +7,8 @@ import { T as ToolInvoker } from '../mcpService-4h3sKDpW.js';
 export { B as BaseMcpService, n as notViaMcp, u as useToolInvoker, a as useToolInvokerMap } from '../mcpService-4h3sKDpW.js';
 import * as _tanstack_query_core from '@tanstack/query-core';
 import { McpTransport, UploadDocumentResult } from '@ethisyscore/extension-runtime/plugin';
-import { k as HostSidebarInput, n as HostSidebarHookInput } from '../useHostSidebarActions-Bt2U-EuA.js';
-export { H as HOST_CHROME_CONTRACT_VERSION, a as HostChromeDiagnostic, b as HostSidebarAction, c as HostSidebarActionDescriptor, d as HostSidebarActionSlot, e as HostSidebarActionVariant, f as HostSidebarActionsApi, g as HostSidebarActionsCapabilities, h as HostSidebarActionsContext, i as HostSidebarActionsPageProps, j as HostSidebarContribution, o as HostSidebarDerivedInput, l as HostSidebarNavItem, S as SIDEBAR_MODE, m as isHostChromeCompatible, r as reportHostChromeDiagnostic, s as setHostChromeDiagnosticSink, u as useHostSidebarActions } from '../useHostSidebarActions-Bt2U-EuA.js';
+import { l as HostSidebarInput, p as HostSidebarHookInput } from '../activeNavHref-cA3_ywRa.js';
+export { H as HOST_CHROME_CONTRACT_VERSION, a as HostChromeDiagnostic, b as HostSidebarAction, c as HostSidebarActionDescriptor, d as HostSidebarActionSlot, e as HostSidebarActionVariant, f as HostSidebarActionsApi, g as HostSidebarActionsCapabilities, h as HostSidebarActionsContext, i as HostSidebarActionsPageProps, j as HostSidebarActiveNav, k as HostSidebarContribution, q as HostSidebarDerivedInput, m as HostSidebarNavItem, R as ResolveActiveNavHrefOptions, S as SIDEBAR_MODE, n as isHostChromeCompatible, r as reportHostChromeDiagnostic, o as resolveActiveNavHref, s as setHostChromeDiagnosticSink, u as useHostSidebarActions, w as withActiveNavHref } from '../activeNavHref-cA3_ywRa.js';
 import { g as PluginDetailContext, H as HeaderMenuItem } from '../pageHeaderTypes-PWZpiwp6.js';
 
 /** A view component resolved from the template manifest. Props are open. */

package/dist/platform-react/index.js

@@ -90,7 +90,7 @@ function surfacePathFor(opts) {
 }
 var CONTEXT_KEY = /* @__PURE__ */ Symbol.for("ethisyscore.plugin-ui.hostSidebarActionsContext");
 var SINK_KEY = /* @__PURE__ */ Symbol.for("ethisyscore.plugin-ui.hostChromeDiagnosticSink");
-var HOST_CHROME_CONTRACT_VERSION = "2.1.0";
+var HOST_CHROME_CONTRACT_VERSION = "2.2.0";
 var _g = globalThis;
 var HostSidebarActionsContext = _g[CONTEXT_KEY] ?? (_g[CONTEXT_KEY] = createContext(null));
 var _gs = globalThis;
@@ -843,14 +843,16 @@ function collectDispatchHandlers(actions) {
   );
 }
 function toContribution(input) {
+  const activeNav = input.activeNavHref ? { activeNavHref: input.activeNavHref } : {};
   if (input.mode === SIDEBAR_MODE.none) {
-    return { mode: SIDEBAR_MODE.none };
+    return { mode: SIDEBAR_MODE.none, ...activeNav };
   }
   if (input.mode === SIDEBAR_MODE.actions) {
     return {
       mode: SIDEBAR_MODE.actions,
       entityToken: input.entityToken,
-      actions: input.actions.map(toDescriptor)
+      actions: input.actions.map(toDescriptor),
+      ...activeNav
     };
   }
   return {
@@ -861,12 +863,14 @@ function toContribution(input) {
     navItems: input.navItems,
     backHref: input.backHref,
     backLabel: input.backLabel,
-    actions: input.actions.map(toDescriptor)
+    actions: input.actions.map(toDescriptor),
+    ...activeNav
   };
 }
 function contributionKey(input) {
+  const activeNav = input.activeNavHref ?? "";
   if (input.mode === SIDEBAR_MODE.none) {
-    return JSON.stringify([SIDEBAR_MODE.none]);
+    return JSON.stringify([SIDEBAR_MODE.none, activeNav]);
   }
   const actionTuple = (a) => [
     a.id,
@@ -884,7 +888,7 @@ function contributionKey(input) {
   ];
   const actionTuples = input.actions.map(actionTuple);
   if (input.mode === SIDEBAR_MODE.actions) {
-    return JSON.stringify([SIDEBAR_MODE.actions, input.entityToken, actionTuples]);
+    return JSON.stringify([SIDEBAR_MODE.actions, input.entityToken, actionTuples, activeNav]);
   }
   const navTuples = input.navItems.map((n) => [n.id, n.label, n.icon ?? "", n.href]);
   return JSON.stringify([
@@ -895,7 +899,8 @@ function contributionKey(input) {
     input.backHref,
     input.backLabel,
     navTuples,
-    actionTuples
+    actionTuples,
+    activeNav
   ]);
 }
 var devWarnedPages = /* @__PURE__ */ new Set();
@@ -914,7 +919,13 @@ function useHostSidebarActions(input) {
   const surfaceBase = useContext(SurfaceBaseContext);
   const pageId = surfaceBase?.pageId;
   const compatible = api && isHostChromeCompatible(api.capabilities?.contractVersion) ? api : null;
-  const resolved = input.mode === SIDEBAR_MODE.none ? input : typeof input.entityToken === "string" ? input : "entityToken" in input ? { mode: SIDEBAR_MODE.none } : {
+  const resolved = input.mode === SIDEBAR_MODE.none ? input : typeof input.entityToken === "string" ? input : "entityToken" in input ? (
+    // An unresolved entity token suppresses the CONTRIBUTION, not the page's identity:
+    // the sidebar entry the page belongs to is known before its entity has loaded, so the
+    // declaration (when there is one) is carried through rather than dropped, and the
+    // section stays lit while the detail data is in flight.
+    { mode: SIDEBAR_MODE.none, ...input.activeNavHref ? { activeNavHref: input.activeNavHref } : {} }
+  ) : {
     ...input,
     entityToken: deriveHostEntityToken(
       typeof window !== "undefined" ? window.location.pathname : "",
@@ -1069,6 +1080,79 @@ function menuConfigToHostSidebarInput(config, opts) {
   return { mode: "actions", actions };
 }
 
-export { BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, EHX_PLUGIN_PORTAL_ATTR, EHX_PLUGIN_PORTAL_CLASS, EHX_PLUGIN_ROOT_CLASS, HOST_CHROME_CONTRACT_VERSION, HostSidebarActionsContext, LIST_CURRENCIES_TOOL, MissingViewFallback, ORGANISATION_SETTINGS_URI, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginPortalScope, PluginStyleScope, REPORTING_CURRENCY_TOOL2 as REPORTING_CURRENCY_TOOL, SIDEBAR_MODE, SurfaceBaseContext, TemplateContext, TypedMcpService, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, isHostChromeCompatible, mcpTool, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, reportHostChromeDiagnostic, resolveSurfaceBase, setHostChromeDiagnosticSink, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useCurrency, useHostSidebarActions, useManagedLifecycle, useMcpUpload, useOrgFormatSync, useOverlayHost, usePluginRealtime, useReportingCurrencySync, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useTypedToolInvokerMap, useView };
+// src/components/layout/breadcrumbs.ts
+function stripTrailingSlash2(value) {
+  return value.length > 1 && value.endsWith("/") ? value.slice(0, -1) : value;
+}
+function sortBySpecificity(routeMeta) {
+  return [...routeMeta].sort((a, b) => {
+    const aDepth = a.pattern.split("/").length;
+    const bDepth = b.pattern.split("/").length;
+    if (bDepth !== aDepth) {
+      return bDepth - aDepth;
+    }
+    const aDynamic = (a.pattern.match(/:/g) ?? []).length;
+    const bDynamic = (b.pattern.match(/:/g) ?? []).length;
+    return aDynamic - bDynamic;
+  });
+}
+function matchRoute(pathname, sorted) {
+  const pathSegments = stripTrailingSlash2(pathname).split("/");
+  for (const entry of sorted) {
+    const patternSegments = entry.pattern.split("/");
+    if (patternSegments.length !== pathSegments.length) {
+      continue;
+    }
+    const params = {};
+    let matched = true;
+    for (let i = 0; i < patternSegments.length; i++) {
+      const pSeg = patternSegments[i];
+      const vSeg = pathSegments[i];
+      if (pSeg.startsWith(":")) {
+        params[pSeg.slice(1)] = vSeg;
+      } else if (pSeg !== vSeg) {
+        matched = false;
+        break;
+      }
+    }
+    if (matched) {
+      return { entry, params };
+    }
+  }
+  return null;
+}
+
+// src/platform-react/activeNavHref.ts
+function isConcrete(pattern) {
+  return !pattern.split("/").some((seg) => seg.startsWith(":"));
+}
+function resolveActiveNavHref(pathname, routeMeta, opts = {}) {
+  const base = opts.basePath ?? /^\/extensions\/[^/]+/.exec(pathname)?.[0];
+  if (!base) return void 0;
+  const mountBase = base.endsWith("/") ? base.slice(0, -1) : base;
+  const match = matchRoute(pathname, sortBySpecificity(routeMeta));
+  if (match == null) return void 0;
+  const seen = /* @__PURE__ */ new Set([match.entry.pattern]);
+  let node = match.entry;
+  while (node != null) {
+    if (isConcrete(node.pattern)) {
+      const owner = node.pattern.replace(/\/$/, "");
+      if (owner === mountBase) return void 0;
+      const prefix = `${mountBase}/`;
+      return owner.startsWith(prefix) ? owner.slice(prefix.length) : void 0;
+    }
+    const parentPattern = node.parent;
+    if (parentPattern == null || seen.has(parentPattern)) return void 0;
+    seen.add(parentPattern);
+    node = routeMeta.find((e) => e.pattern === parentPattern);
+  }
+  return void 0;
+}
+function withActiveNavHref(input, activeNavHref) {
+  if (!activeNavHref) return input;
+  return { ...input, activeNavHref };
+}
+
+export { BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, EHX_PLUGIN_PORTAL_ATTR, EHX_PLUGIN_PORTAL_CLASS, EHX_PLUGIN_ROOT_CLASS, HOST_CHROME_CONTRACT_VERSION, HostSidebarActionsContext, LIST_CURRENCIES_TOOL, MissingViewFallback, ORGANISATION_SETTINGS_URI, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginPortalScope, PluginStyleScope, REPORTING_CURRENCY_TOOL2 as REPORTING_CURRENCY_TOOL, SIDEBAR_MODE, SurfaceBaseContext, TemplateContext, TypedMcpService, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, deriveHostEntityToken, injectPluginStyles, isComponent, isHostChromeCompatible, mcpTool, menuConfigToHostSidebarInput, normaliseSlug, notViaMcp, reportHostChromeDiagnostic, resolveActiveNavHref, resolveSurfaceBase, setHostChromeDiagnosticSink, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useCurrency, useHostSidebarActions, useManagedLifecycle, useMcpUpload, useOrgFormatSync, useOverlayHost, usePluginRealtime, useReportingCurrencySync, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useTypedToolInvokerMap, useView, withActiveNavHref };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map