@ethisyscore/plugin-ui 1.45.0 → 1.46.0

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

@@ -5,7 +5,9 @@ import { QueryClient, UseQueryResult, UseQueryOptions, QueryKey } from '@tanstac
 import { PlatformReactPageProps } from '@ethisyscore/components-react';
 import * as _tanstack_query_core from '@tanstack/query-core';
 import { McpTransport, UploadDocumentResult } from '@ethisyscore/extension-runtime/plugin';
-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, k as HostSidebarInput, l as HostSidebarNavItem, S as SIDEBAR_MODE, m as isHostChromeCompatible, r as reportHostChromeDiagnostic, s as setHostChromeDiagnosticSink, u as useHostSidebarActions } from '../useHostSidebarActions-DFZPen7T.js';
+import { k as HostSidebarInput } from '../useHostSidebarActions-DFZPen7T.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, l as HostSidebarNavItem, S as SIDEBAR_MODE, m as isHostChromeCompatible, r as reportHostChromeDiagnostic, s as setHostChromeDiagnosticSink, u as useHostSidebarActions } from '../useHostSidebarActions-DFZPen7T.js';
+import { g as PluginDetailContext } from '../pageHeaderTypes-PWZpiwp6.js';
 
 /** A view component resolved from the template manifest. Props are open. */
 type ViewComponent = ComponentType<Record<string, unknown>>;
@@ -1063,4 +1065,52 @@ declare function surfacePathFor(opts: {
     suffix?: string;
 }): string;
 
-export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, 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, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToolInvoker, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };
+/**
+ * Options for {@link toHostSidebarInput}.
+ */
+interface ToHostSidebarInputOptions {
+    /** The plugin's mount base (e.g. `/extensions/projects`). Stripped from hrefs. */
+    basePath: string;
+    /**
+     * The entity token the host matches to the current route. Use the bare entity id
+     * — the host segment-matches it across an entity's sub-pages
+     * (`deriveEntityToken`/`tokenMatches`). When absent the result is `{mode:"none"}`.
+     */
+    entityToken: string | undefined;
+    /**
+     * Dispatch bridge for `actionId` actions — pass a page's `useTriggerSidebarAction()`
+     * so a sidebar click reaches the same `useSidebarActions` handler the header uses.
+     * (Kept as a parameter rather than called internally so this stays a PURE mapper
+     * and avoids the cross-entry `SidebarActionContext` singleton pitfall.)
+     */
+    onDispatch: (actionId: string) => void;
+    /**
+     * Slug-relative fallback for a back link that can't be confined (e.g. the plugin
+     * root, whose path is empty and which the host rejects). Defaults to `""` which,
+     * if the primary back link is also unconfinable, yields no back link.
+     */
+    backHrefFallback?: string;
+}
+/**
+ * Map a plugin {@link PluginDetailContext} to a {@link HostSidebarInput} for
+ * `useHostSidebarActions(mode:"detail")` — the plugin-side of the host left-sidebar
+ * detail panel (back link + sub-page nav + Quick actions), the companion of
+ * `useDetailHeaderActions` (the header surface).
+ *
+ * Encodes the host-contract rules so no plugin has to re-derive them from host
+ * source (getting them wrong SILENTLY BLANKS the panel):
+ *  - hrefs are made SLUG-RELATIVE (basePath stripped); absolute/cross-module hrefs
+ *    are dropped (the host rejects them and `mode:"detail"` atomic-drops on a bad
+ *    nav/back href).
+ *  - the host action contract is FLAT (no nested children), so children-bearing
+ *    actions (e.g. Lifecycle / Share) are flattened to their leaves.
+ *  - `actionId` → `kind:"dispatch"` with `onSelect` wired to `onDispatch`; `href` →
+ *    `kind:"navigate"`; a bare `onClick` → `kind:"dispatch"` with that handler.
+ *  - duplicate action ids are removed (the host rejects the whole contribution on a
+ *    duplicate id).
+ *  - no context / no entity token → `{mode:"none"}` (suppresses without clobbering
+ *    the static manifest).
+ */
+declare function toHostSidebarInput(context: PluginDetailContext | null | undefined, opts: ToHostSidebarInputOptions): HostSidebarInput;
+
+export { type AuthenticatedQueryResult, BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, type DefinePlatformReactPluginOverlayOptions, type DefinePlatformReactPluginPageOptions, EHX_PLUGIN_ROOT_CLASS, HostSidebarInput, type InsetLease, type ManagedLifecycle, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, type OverlayHostApi, type OverlayHostCapabilities, OverlayHostContext, type PlatformReactOverlayProps, type PluginOverlayDefinerConfig, type PluginPageDefinerConfig, PluginStyleScope, type ReactRouterShimOptions, SurfaceBaseContext, type SurfaceBaseValue, TemplateContext, type TemplateManifest, type ToHostSidebarInputOptions, type ToolInvoker, type UseMcpUploadOptions, type UseMcpUploadResult, type UseMcpUploadTarget, type ViewComponent, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, normaliseSlug, notViaMcp, resolveSurfaceBase, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };

package/dist/platform-react/index.js

@@ -646,6 +646,71 @@ function useHostSidebarActions(input) {
   }, [compatible, key]);
 }
 
-export { BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, EHX_PLUGIN_ROOT_CLASS, HOST_CHROME_CONTRACT_VERSION, HostSidebarActionsContext, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginStyleScope, SIDEBAR_MODE, SurfaceBaseContext, TemplateContext, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, isHostChromeCompatible, normaliseSlug, notViaMcp, reportHostChromeDiagnostic, resolveSurfaceBase, setHostChromeDiagnosticSink, surfacePathFor, useAuthenticatedQueries, useAuthenticatedQuery, useHostSidebarActions, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };
+// src/platform-react/toHostSidebarInput.ts
+function toHostSidebarInput(context, opts) {
+  if (!context || !opts.entityToken) {
+    return { mode: "none" };
+  }
+  const navItems = context.navItems.map((n) => ({ id: n.id, label: n.label, icon: n.icon, href: slugRelative(n.href, opts.basePath) })).filter((n) => isConfinable(n.href));
+  const mappedBack = slugRelative(context.backHref, opts.basePath);
+  const backHref = isConfinable(mappedBack) ? mappedBack : opts.backHrefFallback ?? "";
+  return {
+    mode: "detail",
+    entityToken: opts.entityToken,
+    title: context.title,
+    navSectionLabel: context.navSectionLabel ?? "Sections",
+    navItems,
+    backHref,
+    backLabel: context.backLabel ?? "Back",
+    actions: toHostActions(context.actions ?? [], opts)
+  };
+}
+function slugRelative(href, basePath) {
+  if (!href) return "";
+  const base = basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+  if (href === base) return "";
+  const prefix = `${base}/`;
+  return href.startsWith(prefix) ? href.slice(prefix.length) : href;
+}
+function isConfinable(slugRelativeHref) {
+  return slugRelativeHref.length > 0 && !slugRelativeHref.startsWith("/") && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(slugRelativeHref) && !slugRelativeHref.includes("#");
+}
+function flattenLeaves(items) {
+  const out = [];
+  for (const item of items) {
+    if (item.children?.length) out.push(...flattenLeaves(item.children));
+    else out.push(item);
+  }
+  return out;
+}
+function toHostActions(actions, opts) {
+  const out = [];
+  for (const item of flattenLeaves(actions)) {
+    const mapped = toHostAction(item, opts);
+    if (mapped) out.push(mapped);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  return out.filter((a) => seen.has(a.id) ? false : (seen.add(a.id), true));
+}
+function toHostAction(item, opts) {
+  const slot = item.slot === "primary" ? "primary" : item.slot === "sidebar-only" ? "sidebar-only" : "overflow";
+  const variant = item.variant === "danger" ? "danger" : void 0;
+  const shared = { id: item.id, label: item.label, icon: item.icon, slot, variant, disabled: item.disabled };
+  if (item.href) {
+    const href = slugRelative(item.href, opts.basePath);
+    if (!isConfinable(href)) return null;
+    return { ...shared, kind: "navigate", href };
+  }
+  if (item.actionId) {
+    const actionId = item.actionId;
+    return { ...shared, kind: "dispatch", onSelect: () => opts.onDispatch(actionId) };
+  }
+  if (item.onClick) {
+    return { ...shared, kind: "dispatch", onSelect: item.onClick };
+  }
+  return null;
+}
+
+export { BaseMcpService, DEFAULT_MAX_UPLOAD_BYTES, EHX_PLUGIN_ROOT_CLASS, HOST_CHROME_CONTRACT_VERSION, HostSidebarActionsContext, MissingViewFallback, OVERLAY_HOST_CONTRACT_VERSION, OverlayHostContext, PluginStyleScope, SIDEBAR_MODE, SurfaceBaseContext, TemplateContext, buildSurfaceUrl, createPluginOverlayDefiner, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginOverlay, definePlatformReactPluginPage, injectPluginStyles, isComponent, isHostChromeCompatible, normaliseSlug, notViaMcp, reportHostChromeDiagnostic, resolveSurfaceBase, setHostChromeDiagnosticSink, surfacePathFor, toHostSidebarInput, useAuthenticatedQueries, useAuthenticatedQuery, useHostSidebarActions, useManagedLifecycle, useMcpUpload, useOverlayHost, usePluginRealtime, useSurfaceUrl, useToolInvoker, useToolInvokerMap, useView };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map