@ethisyscore/plugin-ui 1.52.0 → 1.54.0

package/dist/{useHostSidebarActions-CyNYWKiv.d.ts → useHostSidebarActions-Bt2U-EuA.d.ts}

@@ -129,7 +129,11 @@ declare const SIDEBAR_MODE: {
 /** Discriminated input to `useHostSidebarActions`. `mode:"none"` suppresses all plugin-side
  *  contributions without clobbering the static manifest actions. `mode:"actions"` is the
  *  batch-2 Quick Actions shape. `mode:"detail"` is the full detail-nav replacement with title,
- *  navigation items, back-arrow, and Quick Actions. */
+ *  navigation items, back-arrow, and Quick Actions.
+ *
+ *  `entityToken` is REQUIRED here — this is the published shape existing consumers narrow
+ *  against (`input.entityToken` is a `string` after a mode check), unchanged. To let the
+ *  hook derive the token instead, OMIT the property via {@link HostSidebarDerivedInput}. */
 type HostSidebarInput = {
     mode: "none";
 } | {
@@ -146,6 +150,30 @@ type HostSidebarInput = {
     backLabel: string;
     actions: HostSidebarAction[];
 };
+/** Token-less authoring variants: the hook derives the host-mirrored entity token from the
+ *  surface base + current location (`deriveHostEntityToken`) — correct by construction, since
+ *  the host's token guard silently drops a mismatching publish. Prefer these unless you need
+ *  the bare-entity-id form (which the host segment-matches across an entity's sub-pages).
+ *  `entityToken?: undefined` (not just absence) is deliberate: an EXPLICIT `undefined`
+ *  (e.g. `entityToken: maybeToken` with an unresolved token) keeps the long-standing
+ *  "unresolved token → contribute nothing" semantic and is treated as `mode:"none"`, NOT
+ *  derived — only a truly ABSENT property derives. */
+type HostSidebarDerivedInput = {
+    mode: "actions";
+    entityToken?: undefined;
+    actions: HostSidebarAction[];
+} | {
+    mode: "detail";
+    entityToken?: undefined;
+    title: string;
+    navSectionLabel: string;
+    navItems: HostSidebarNavItem[];
+    backHref: string;
+    backLabel: string;
+    actions: HostSidebarAction[];
+};
+/** What `useHostSidebarActions` accepts: the classic explicit-token shape or a derived-token variant. */
+type HostSidebarHookInput = HostSidebarInput | HostSidebarDerivedInput;
 /**
  * Publish contextual sidebar contributions from a PlatformReact page to the host sidebar, and
  * receive click dispatch by id. Accepts a discriminated `HostSidebarInput`:
@@ -156,6 +184,6 @@ type HostSidebarInput = {
  * Serializable descriptors only cross to the host; the inline `onSelect` handlers stay in a
  * ref-map here and are always the latest closure. Fails closed (no publish/subscribe, no throw)
  * when the host predates or is incompatible with the seam. */
-declare function useHostSidebarActions(input: HostSidebarInput): void;
+declare function useHostSidebarActions(input: HostSidebarHookInput): void;
 
-export { HOST_CHROME_CONTRACT_VERSION as H, SIDEBAR_MODE as S, type HostChromeDiagnostic as a, type HostSidebarAction as b, type HostSidebarActionDescriptor as c, type HostSidebarActionSlot as d, type HostSidebarActionVariant as e, type HostSidebarActionsApi as f, type HostSidebarActionsCapabilities as g, HostSidebarActionsContext as h, type HostSidebarActionsPageProps as i, type HostSidebarContribution as j, type HostSidebarInput as k, type HostSidebarNavItem as l, isHostChromeCompatible as m, reportHostChromeDiagnostic as r, setHostChromeDiagnosticSink as s, useHostSidebarActions as u };
+export { HOST_CHROME_CONTRACT_VERSION as H, SIDEBAR_MODE as S, type HostChromeDiagnostic as a, type HostSidebarAction as b, type HostSidebarActionDescriptor as c, type HostSidebarActionSlot as d, type HostSidebarActionVariant as e, type HostSidebarActionsApi as f, type HostSidebarActionsCapabilities as g, HostSidebarActionsContext as h, type HostSidebarActionsPageProps as i, type HostSidebarContribution as j, type HostSidebarInput as k, type HostSidebarNavItem as l, isHostChromeCompatible as m, type HostSidebarHookInput as n, type HostSidebarDerivedInput as o, reportHostChromeDiagnostic as r, setHostChromeDiagnosticSink as s, useHostSidebarActions as u };

package/package.json

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