@salesforce/platform-sdk 11.5.0 → 11.6.0

package/dist/core/index.d.ts

@@ -7,7 +7,7 @@ export { Surface, getVerifiedSurface, initialize, isSfEmbeddingIframe, resetSurf
 export type { InitializeOptions } from './surface';
 export type { SDKOptions } from './options';
 export type { HostContext, HostStyles, ChatMessage, ChatSDK, ContentBlock, DeviceCapabilities, DisplayMode, ResourceRequest, SafeAreaInsets, SetWidgetStateOptions, ToolCall, ToolState, } from './chat';
-export type { AlertOptions, MessageLevel, ModalOptions, ToastOptions, Theme, ThemeMode, ViewSDK, } from './view';
+export type { AlertOptions, MessageLevel, ModalOptions, ToastOptions, Theme, ThemeMode, UiState, UiStyles, ViewSDK, } from './view';
 export type { CacheControl, DataSDK, DataSDKGraphQL, GraphQLError, GraphQLRawDocument, GraphQLRequest, GraphQLResponse, MutateOptions, MutationResult, QueryOptions, QueryResult, QuerySubscriber, Unsubscribe, } from './data';
 export type { LightningSDK, LMSMessage, LMSSubscription, MessageChannel } from './lightning';
 export type { OpenAISDK } from './platforms';

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACN,OAAO,EACP,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,YAAY,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,YAAY,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,QAAQ,EACR,SAAS,GACT,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,SAAS,EACT,OAAO,GACP,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,OAAO,EACP,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,GACX,MAAM,QAAQ,CAAC;AAGhB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7F,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACN,OAAO,EACP,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,YAAY,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,YAAY,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,QAAQ,EACR,SAAS,GACT,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,SAAS,EACT,OAAO,EACP,QAAQ,EACR,OAAO,GACP,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,OAAO,EACP,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,GACX,MAAM,QAAQ,CAAC;AAGhB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7F,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/core/view.d.ts

@@ -3,6 +3,34 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
+/**
+ * CSS-adjacent styling the host publishes for the embedded surface.
+ *
+ * `variables` are CSS custom properties (`--*`) read off the host element's inline
+ * style; `attributes` are mirrored a11y/i18n/input attributes from the host LWC.
+ */
+export interface UiStyles {
+    variables?: Record<string, string>;
+    attributes?: Record<string, string>;
+}
+/**
+ * Host → embedding rendering snapshot exposed to bundles via {@link ViewSDK.getUiState}.
+ *
+ * `props` are host-configurable inputs (theme, locale, mode, etc.); `styles` are the
+ * CSS custom properties and attributes the host wants mirrored onto the surface.
+ *
+ * Declared locally (not re-exported from `@salesforce/sf-embedding-bridge`) to keep the
+ * wire-layer package off the SDK's public type graph; the shape mirrors the bridge's, so
+ * surface-side code assigns without a cast.
+ *
+ * This is the open, fully-permissive shape. A bundle that knows its host contract can
+ * declare a narrower type that `extends UiState` (tighter `props`/`styles`) and pass it to
+ * {@link ViewSDK.getUiState}'s single type parameter for precise typing.
+ */
+export interface UiState {
+    props: Record<string, unknown>;
+    styles: UiStyles;
+}
 /**
  * Theme mode
  */
@@ -245,32 +273,50 @@ export type ViewSDK = Partial<EventTarget> & {
      */
     clearDirtyState?(label?: string): Promise<void>;
     /**
-     * Get UI properties from the host and subscribe to changes
+     * Get the current host UI state and a `subscribe` function for future changes.
      *
-     * Returns an object containing a promise for the initial props and a subscribe
-     * function to listen for prop updates. UI props allow the host to configure
-     * the application's appearance or behavior dynamically.
+     * Returns the latest known snapshot synchronously — the underlying wire subscription is
+     * opened once, is session-scoped, and is shared across every caller ({@link getTheme} is
+     * its synchronous sibling). Call `subscribe` with a handler to be notified on every
+     * subsequent host push; `subscribe` returns an `unsubscribe` function that detaches that
+     * one handler. Detaching is local fan-out only — the shared wire subscription stays open.
      *
-     * @returns Object with props promise and subscribe function
+     * The optional `State` type parameter describes the host contract this caller expects:
+     * pass a type that `extends UiState` (narrower `props`/`styles`) and both `state` and the
+     * `subscribe` handler's argument are typed as it. It defaults to the open {@link UiState},
+     * so `getUiState()` with no type argument is the fully-permissive snapshot. `State` is
+     * erased at runtime — purely a compile-time convenience, so pin only what the host
+     * actually guarantees.
+     *
+     * @typeParam State - The expected snapshot shape; must extend {@link UiState}.
+     * @returns `{ state, subscribe }` — the current snapshot and a subscribe function whose
+     *   return value is the per-handler `unsubscribe`.
      *
      * @example
      * ```typescript
-     * const uiProps = viewSDK.getUiProps?.();
-     *
-     * // Get initial props
-     * const initialProps = await uiProps.props;
-     * console.log('Theme:', initialProps.theme);
-     *
-     * // Subscribe to prop changes
-     * uiProps.subscribe((newProps) => {
-     *   console.log('Props updated:', newProps);
-     *   // Update UI based on new props
-     * });
+     * // Untyped — the permissive default.
+     * const { state, subscribe } = viewSDK.getUiState?.() ?? {
+     *   state: { props: {}, styles: {} },
+     *   subscribe: () => () => {},
+     * };
+     * applyProps(state.props);
+     * const unsubscribe = subscribe((next) => applyProps(next.props));
+     * unsubscribe(); // later, when the caller no longer cares
+     *
+     * // Typed — pin the exact snapshot the host guarantees.
+     * interface MyUiState extends UiState {
+     *   props: { theme: "light" | "dark" };
+     *   styles: { variables?: { "--accent": string } };
+     * }
+     * const { state } = viewSDK.getUiState?.<MyUiState>() ??
+     *   { state: { props: { theme: "light" }, styles: {} } };
+     * state.props.theme;                    // "light" | "dark"
+     * state.styles.variables?.["--accent"]; // string | undefined
      * ```
      */
-    getUiProps?(): {
-        props: Promise<Record<string, unknown>>;
-        subscribe: (callback: (props: Record<string, unknown>) => void) => void;
+    getUiState?<State extends UiState = UiState>(): {
+        state: State;
+        subscribe: (handler: (state: State) => void) => () => void;
     };
     /**
      * Resize the application viewport

package/dist/core/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/core/view.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,SAAS,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;;;;OAQG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG;IAC5C;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,CAAC,IAAI;QACd,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;KACxE,CAAC;IAEF;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC;CAC1B,CAAC"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/core/view.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,QAAQ,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,SAAS,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;;;;OAQG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG;IAC5C;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,UAAU,CAAC,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO,KAAK;QAC/C,KAAK,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;KAC3D,CAAC;IAEF;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC;CAC1B,CAAC"}

package/dist/data/index.js

@@ -196,7 +196,7 @@ class ie {
     })).structuredContent;
   }
 }
-const ce = "X-SFDC-Client-Name", ue = "X-SFDC-Client-Version", he = "@salesforce/platform-sdk", le = "11.5.0", de = (t) => {
+const ce = "X-SFDC-Client-Name", ue = "X-SFDC-Client-Version", he = "@salesforce/platform-sdk", le = "11.6.0", de = (t) => {
   let e = y(ce, he, t);
   return e = y(ue, le, e), u(e);
 }, pe = "X-CSRF-Token";

package/dist/view/embedding.d.ts

@@ -1,4 +1,4 @@
-import { ViewSDK } from '../core';
+import { UiState, ViewSDK } from '../core';
 /** Pixel-only dimension string: bare number or `Npx`. The empty string is allowed so a caller can omit one axis. */
 export type PixelSize = `${number}` | `${number}px` | "";
 /**
@@ -21,6 +21,8 @@ export type PixelSize = `${number}` | `${number}px` | "";
 export declare class EmbeddingViewSDK extends EventTarget implements ViewSDK {
     private readonly session;
     static create(): Promise<EmbeddingViewSDK>;
+    private currentUiState;
+    private readonly uiStateListeners;
     private constructor();
     /**
      * Dispatch a custom event.
@@ -41,6 +43,26 @@ export declare class EmbeddingViewSDK extends EventTarget implements ViewSDK {
      *   otherwise `true` (native {@link EventTarget} semantics).
      */
     dispatchEvent(event: Event): boolean;
+    /**
+     * Get the current host UI state and a `subscribe` function for future changes.
+     *
+     * The snapshot is fetched once at {@link EmbeddingViewSDK.create} and refreshed on every
+     * host push, so this returns synchronously. `subscribe(handler)` registers the handler for
+     * every subsequent push and returns an `unsubscribe` that detaches just that handler; the
+     * underlying wire subscription is session-scoped and shared, so detaching is a local
+     * `Set.delete`, not a wire teardown.
+     *
+     * The optional `State` type parameter narrows `state` and the `subscribe` handler for this
+     * caller; it is erased at runtime, so the stored snapshot and listeners are the open-shaped
+     * {@link UiState} and the narrowed handler is adapted to that at the boundary.
+     *
+     * @returns `{ state, subscribe }` — the latest cached snapshot and a subscribe function
+     *   whose return value is the per-handler `unsubscribe`.
+     */
+    getUiState<State extends UiState = UiState>(): {
+        state: State;
+        subscribe: (handler: (state: State) => void) => () => void;
+    };
     markDirtyState(label?: string): Promise<void>;
     clearDirtyState(label?: string): Promise<void>;
     /** Resize the embedded surface. Pass `""` for either axis to leave it unchanged; both empty is a no-op. */
@@ -68,6 +90,16 @@ export declare class EmbeddingViewSDK extends EventTarget implements ViewSDK {
      * is disposed.
      */
     private subscribeToHostEvent;
+    /**
+     * Open the host's ui-state stream once per session and cache the initial snapshot,
+     * then fan out every subsequent push to registered listeners. Private wire-layer
+     * plumbing — the public entry point is {@link getUiState}.
+     *
+     * Best-effort, mirroring {@link subscribeToHostEvent}: if the subscription cannot be
+     * opened, {@link getUiState} still returns a usable (empty) snapshot and every other
+     * method continues to work. The wire is not explicitly torn down.
+     */
+    private subscribeToUiState;
     private setDirty;
 }
 //# sourceMappingURL=embedding.d.ts.map

package/dist/view/embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/view/embedding.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMvC,oHAAoH;AACpH,MAAM,MAAM,SAAS,GAAG,GAAG,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,WAAY,YAAW,OAAO;IAQ/C,OAAO,CAAC,QAAQ,CAAC,OAAO;WAP/B,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAOhD,OAAO;IAIP;;;;;;;;;;;;;;;;;OAiBG;IACM,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IA0BvC,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,2GAA2G;IACrG,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhE;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;;;;;;;OAeG;YACW,oBAAoB;IAyBlC,OAAO,CAAC,QAAQ;CAOhB"}
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/view/embedding.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMhD,oHAAoH;AACpH,MAAM,MAAM,SAAS,GAAG,GAAG,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,WAAY,YAAW,OAAO;IAa/C,OAAO,CAAC,QAAQ,CAAC,OAAO;WAZ/B,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAShD,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuC;IAExE,OAAO;IAIP;;;;;;;;;;;;;;;;;OAiBG;IACM,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IA0B7C;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO,KAAK;QAC9C,KAAK,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;KAC3D;IAeK,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,2GAA2G;IACrG,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhE;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;;;;;;;OAeG;YACW,oBAAoB;IAyBlC;;;;;;;;OAQG;YACW,kBAAkB;IAiBhC,OAAO,CAAC,QAAQ;CAOhB"}

package/dist/view/index.d.ts

@@ -25,5 +25,5 @@ export interface ViewSDKOptions extends SDKOptions {
 export declare function createViewSDK(options?: ViewSDKOptions): Promise<ViewSDK>;
 export { MCPAppsViewSDK } from './mcpapps';
 export { getViewSDK, getViewSDKSync, resetViewSDK } from './singleton';
-export type { AlertOptions, ModalOptions, SDKOptions, Theme, ThemeMode, ToastOptions, ViewSDK, } from '../core';
+export type { AlertOptions, ModalOptions, SDKOptions, Theme, ThemeMode, ToastOptions, UiState, UiStyles, ViewSDK, } from '../core';
 //# sourceMappingURL=index.d.ts.map

package/dist/view/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAKnD;;;;;;GAMG;AAEH,MAAM,WAAW,cAAe,SAAQ,UAAU;CAAG;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCxE;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,EACL,SAAS,EACT,YAAY,EACZ,OAAO,GACP,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAKnD;;;;;;GAMG;AAEH,MAAM,WAAW,cAAe,SAAQ,UAAU;CAAG;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCxE;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,EACL,SAAS,EACT,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,OAAO,GACP,MAAM,SAAS,CAAC"}

package/dist/view/index.js

@@ -1,8 +1,8 @@
-import { g as h, S as i, a as p } from "../surface-Dd2tqrPi.js";
-import { w } from "../sdk-promise-D0sy7OW1.js";
+import { g as h, S as n, a as w } from "../surface-Dd2tqrPi.js";
+import { w as p } from "../sdk-promise-D0sy7OW1.js";
 import { requireSharedSession as m } from "../sf-embedding/index.js";
-function f(n) {
-  switch (n) {
+function f(i) {
+  switch (i) {
     case "info":
       return "ℹ️";
     case "success":
@@ -15,34 +15,38 @@ function f(n) {
       return "ℹ️";
   }
 }
-function l(n, e) {
-  return `${f(e)} ${n}`;
+function u(i, e) {
+  return `${f(e)} ${i}`;
 }
-function o(n, e) {
-  const s = n.trim();
+function o(i, e) {
+  const s = i.trim();
   if (s === "")
     return { success: !0, value: void 0 };
   const t = s.match(/^(\d+(?:\.\d+)?)(px)?$/);
   if (!t || !t[1])
     return {
       success: !1,
-      error: `Invalid ${e}: "${n}". Only pixel values are supported (e.g., "800px" or "800").`
+      error: `Invalid ${e}: "${i}". Only pixel values are supported (e.g., "800px" or "800").`
     };
   const r = parseFloat(t[1]);
   return r < 0 || !isFinite(r) ? {
     success: !1,
-    error: `Invalid ${e}: "${n}". Value must be a positive number.`
+    error: `Invalid ${e}: "${i}". Value must be a positive number.`
   } : { success: !0, value: r };
 }
-const v = "trackdirtystate";
-class u extends EventTarget {
+const b = "trackdirtystate";
+class l extends EventTarget {
   constructor(e) {
     super(), this.session = e;
   }
   static async create() {
-    const e = await m("EmbeddingViewSDK"), s = new u(e);
-    return await s.subscribeToHostEvent(), s;
+    const e = await m("EmbeddingViewSDK"), s = new l(e);
+    return await Promise.all([s.subscribeToHostEvent(), s.subscribeToUiState()]), s;
   }
+  // Latest snapshot, refreshed on every host push. Session-scoped — the wire subscription
+  // is opened once at create() and never torn down.
+  currentUiState = { props: {}, styles: {} };
+  uiStateListeners = /* @__PURE__ */ new Set();
   /**
    * Dispatch a custom event.
    *
@@ -77,6 +81,33 @@ class u extends EventTarget {
       }
     return super.dispatchEvent(e);
   }
+  /**
+   * Get the current host UI state and a `subscribe` function for future changes.
+   *
+   * The snapshot is fetched once at {@link EmbeddingViewSDK.create} and refreshed on every
+   * host push, so this returns synchronously. `subscribe(handler)` registers the handler for
+   * every subsequent push and returns an `unsubscribe` that detaches just that handler; the
+   * underlying wire subscription is session-scoped and shared, so detaching is a local
+   * `Set.delete`, not a wire teardown.
+   *
+   * The optional `State` type parameter narrows `state` and the `subscribe` handler for this
+   * caller; it is erased at runtime, so the stored snapshot and listeners are the open-shaped
+   * {@link UiState} and the narrowed handler is adapted to that at the boundary.
+   *
+   * @returns `{ state, subscribe }` — the latest cached snapshot and a subscribe function
+   *   whose return value is the per-handler `unsubscribe`.
+   */
+  getUiState() {
+    return {
+      state: this.currentUiState,
+      subscribe: (e) => {
+        const s = e;
+        return this.uiStateListeners.add(s), () => {
+          this.uiStateListeners.delete(s);
+        };
+      }
+    };
+  }
   async markDirtyState(e) {
     this.setDirty(!0, e);
   }
@@ -139,8 +170,33 @@ class u extends EventTarget {
       );
     }
   }
+  /**
+   * Open the host's ui-state stream once per session and cache the initial snapshot,
+   * then fan out every subsequent push to registered listeners. Private wire-layer
+   * plumbing — the public entry point is {@link getUiState}.
+   *
+   * Best-effort, mirroring {@link subscribeToHostEvent}: if the subscription cannot be
+   * opened, {@link getUiState} still returns a usable (empty) snapshot and every other
+   * method continues to work. The wire is not explicitly torn down.
+   */
+  async subscribeToUiState() {
+    const e = this.session.bridge;
+    e.onUiStateChanged((s) => {
+      this.currentUiState = s.current;
+      for (const t of this.uiStateListeners) t(s.current);
+    });
+    try {
+      const { current: s } = await e.sendUiStateSubscribe();
+      this.currentUiState = s;
+    } catch (s) {
+      console.warn(
+        "[EmbeddingViewSDK] ui-state subscription failed; getUiState will return an empty snapshot",
+        s
+      );
+    }
+  }
   setDirty(e, s) {
-    this.session.bridge.sendEventDispatch(v, {
+    this.session.bridge.sendEventDispatch(b, {
       isDirty: e,
       instanceId: this.session.hostMetaData.instanceId,
       label: s ?? ""
@@ -157,7 +213,7 @@ class g {
    * @param level - The message severity level (defaults to "info")
    */
   async sendMessage(e, s = "info") {
-    const t = l(e, s);
+    const t = u(e, s);
     await this.session.request("ui/message", {
       role: "user",
       content: [
@@ -192,13 +248,13 @@ class g {
     return t.value !== void 0 && (c.width = t.value), r.value !== void 0 && (c.height = r.value), this.session.sendNotification("ui/notifications/size-changed", c), Promise.resolve();
   }
 }
-class b {
+class v {
   async displayAlert(e) {
-    const s = e.level || "info", t = l(e.message, s);
+    const s = e.level || "info", t = u(e.message, s);
     await window.openai.sendFollowUpMessage({ prompt: t });
   }
   async displayToast(e) {
-    const s = e.level || "info", t = l(e.message, s);
+    const s = e.level || "info", t = u(e.message, s);
     await window.openai.sendFollowUpMessage({ prompt: t });
   }
   async displayModal(e) {
@@ -213,8 +269,8 @@ class b {
   }
 }
 let a = null, d = null;
-function M(n) {
-  return a || (a = y(n).then((e) => (d = e, e))), a;
+function M(i) {
+  return a || (a = y(i).then((e) => (d = e, e))), a;
 }
 function T() {
   return d;
@@ -222,20 +278,20 @@ function T() {
 function V() {
   a = null, d = null;
 }
-function y(n) {
-  return w(
+function y(i) {
+  return p(
     (async () => {
       try {
-        switch (await h(n?.surface)) {
-          case i.OpenAI:
-            return new b();
-          case i.WebApp:
-          case i.Mosaic:
+        switch (await h(i?.surface)) {
+          case n.OpenAI:
+            return new v();
+          case n.WebApp:
+          case n.Mosaic:
             return {};
-          case i.MicroFrontend:
-            return await u.create();
-          case i.MCPApps: {
-            const s = await p.getInstance();
+          case n.MicroFrontend:
+            return await l.create();
+          case n.MCPApps: {
+            const s = await w.getInstance();
             return new g(s);
           }
           default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/platform-sdk",
-  "version": "11.5.0",
+  "version": "11.6.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -115,7 +115,7 @@
     "@conduit-client/service-pubsub": "3.19.6",
     "@conduit-client/service-retry": "3.19.6",
     "@conduit-client/utils": "3.19.6",
-    "@salesforce/jsonrpc": "^11.5.0",
+    "@salesforce/jsonrpc": "^11.6.0",
     "@salesforce/sf-embedding-bridge": "2.2.4-rc.1"
   },
   "peerDependencies": {