@openfin/fdc3-api 45.100.72 → 45.100.74

package/out/fdc3-api-alpha.d.ts

@@ -3101,6 +3101,53 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin.WindowOptions;
 };
 
+/**
+ * End of Interop Client Events
+ */
+/**
+ * Client-side handle for the chrome-browser feature.
+ *
+ * For Chrome extension integration to be active on a window, that window must be
+ * created with `chromeBrowser: true` in its window options. There is no separate
+ * `init()` step.
+ */
+declare interface ChromeBrowser {
+    /**
+     * Extension action surface — observe and invoke installed Chrome extension actions.
+     */
+    readonly Actions: ChromeBrowserActions;
+}
+
+/**
+ * APIs for interacting with Chromium extension actions from an initialized ChromeBrowser window.
+ *
+ * @interface
+ */
+declare interface ChromeBrowserActions {
+    /**
+     * Returns the current list of extension actions with the minimal render state
+     * required to build a toolbar UI.
+     */
+    getExtensionActions(): Promise<ExtensionActionListItem[]>;
+    /**
+     * Executes the specified extension action.
+     *
+     * @remarks
+     * This may trigger an extension popup to be shown by the Runtime if the extension
+     * has a popup configured for the currently active tab.
+     */
+    invokeExtensionAction(options: ExtensionActionInvokeOptions): Promise<void>;
+    /**
+     * Hides the active extension popup, if any.
+     */
+    hideActiveExtensionPopup(): Promise<void>;
+    /**
+     * Reactive value reflecting the current extension action list.
+     * Compatible with React's `useSyncExternalStore`.
+     */
+    readonly state: Readable<ExtensionActionListItem[]>;
+}
+
 /**
  * Control behavior for Chromium policies
  *
@@ -5428,6 +5475,33 @@ declare type ExitCode = {
     exitCode: number;
 };
 
+/**
+ * Options for invoking an extension action.
+ *
+ * @interface
+ */
+declare type ExtensionActionInvokeOptions = {
+    extensionId: ExtensionId;
+    /** Anchor in window client coordinates (from getBoundingClientRect). */
+    anchor: Anchor;
+};
+
+/**
+ * Minimal UI model required to render a list of extension actions.
+ *
+ * @interface
+ */
+declare type ExtensionActionListItem = {
+    /** Stable ID for the extension that owns this action. */
+    extensionId: ExtensionId;
+    /** Whether to show the action button for the current context (active tab). */
+    isVisible: boolean;
+    /** Accessible label / title for the action button. */
+    title: string;
+    /** Renderer-safe icon (data URL). */
+    iconDataUrl: string;
+};
+
 declare type ExtensionEvent = SecurityRealmEvent & {
     /**
      * Runtime extension whose status has been (possibly) modified
@@ -5435,6 +5509,13 @@ declare type ExtensionEvent = SecurityRealmEvent & {
     extension: string;
 };
 
+/**
+ * Unique identifier of a Chromium extension.
+ *
+ * @interface
+ */
+declare type ExtensionId = string;
+
 /**
  * @interface
  */
@@ -6224,6 +6305,7 @@ declare interface FinApi<MeType extends OpenFin.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
+    readonly ChromeBrowser: OpenFin.ChromeBrowser;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -10609,6 +10691,7 @@ declare namespace OpenFin {
         SnapshotSource,
         SnapshotSourceModule,
         System,
+        Readable,
         LayoutEntityDefinition,
         LayoutEntityTypes,
         LayoutPosition,
@@ -10641,6 +10724,10 @@ declare namespace OpenFin {
         AnchorLocation,
         Anchor,
         DownloadBubbleOptions,
+        ExtensionId,
+        ExtensionActionListItem,
+        ExtensionActionInvokeOptions,
+        ChromeBrowserActions,
         DisplayMetadata,
         LegacyWinOptionsInAppOptions,
         Snapshot,
@@ -11006,6 +11093,7 @@ declare namespace OpenFin {
         InteropClientEvent,
         ClientChangedContextGroup,
         InteropClientEvents,
+        ChromeBrowser,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -14178,6 +14266,14 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         };
         response: void;
     };
+    'chrome-browser-get-extension-actions': ApiCall<{}, {
+        actions: OpenFin.ExtensionActionListItem[];
+    }>;
+    'chrome-browser-invoke-extension-action': ApiCall<{
+        extensionId: string;
+        anchor: OpenFin.Anchor;
+    }, void>;
+    'chrome-browser-hide-active-extension-popup': ApiCall<{}, void>;
 };
 
 declare type ProtocolOffer = ClassicProtocolOffer | RTCProtocolOffer;
@@ -14274,6 +14370,21 @@ declare type QueryPermissionResult = {
     rawValue?: unknown;
 };
 
+/**
+ * A readonly implementation of the observable pattern.
+ * Frameworks and vanilla consumers use this to read state and subscribe to changes.
+ */
+declare interface Readable<T> {
+    /** Synchronously returns the current value. */
+    get(): T;
+    /**
+     * Subscribes to changes.
+     * @param listener A callback that is invoked when the value changes.
+     * @returns An unsubscribe function to clean up the listener.
+     */
+    subscribe(listener: () => void): () => void;
+}
+
 /**
  * @interface
  */

package/out/fdc3-api-beta.d.ts

@@ -3101,6 +3101,53 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin.WindowOptions;
 };
 
+/**
+ * End of Interop Client Events
+ */
+/**
+ * Client-side handle for the chrome-browser feature.
+ *
+ * For Chrome extension integration to be active on a window, that window must be
+ * created with `chromeBrowser: true` in its window options. There is no separate
+ * `init()` step.
+ */
+declare interface ChromeBrowser {
+    /**
+     * Extension action surface — observe and invoke installed Chrome extension actions.
+     */
+    readonly Actions: ChromeBrowserActions;
+}
+
+/**
+ * APIs for interacting with Chromium extension actions from an initialized ChromeBrowser window.
+ *
+ * @interface
+ */
+declare interface ChromeBrowserActions {
+    /**
+     * Returns the current list of extension actions with the minimal render state
+     * required to build a toolbar UI.
+     */
+    getExtensionActions(): Promise<ExtensionActionListItem[]>;
+    /**
+     * Executes the specified extension action.
+     *
+     * @remarks
+     * This may trigger an extension popup to be shown by the Runtime if the extension
+     * has a popup configured for the currently active tab.
+     */
+    invokeExtensionAction(options: ExtensionActionInvokeOptions): Promise<void>;
+    /**
+     * Hides the active extension popup, if any.
+     */
+    hideActiveExtensionPopup(): Promise<void>;
+    /**
+     * Reactive value reflecting the current extension action list.
+     * Compatible with React's `useSyncExternalStore`.
+     */
+    readonly state: Readable<ExtensionActionListItem[]>;
+}
+
 /**
  * Control behavior for Chromium policies
  *
@@ -5428,6 +5475,33 @@ declare type ExitCode = {
     exitCode: number;
 };
 
+/**
+ * Options for invoking an extension action.
+ *
+ * @interface
+ */
+declare type ExtensionActionInvokeOptions = {
+    extensionId: ExtensionId;
+    /** Anchor in window client coordinates (from getBoundingClientRect). */
+    anchor: Anchor;
+};
+
+/**
+ * Minimal UI model required to render a list of extension actions.
+ *
+ * @interface
+ */
+declare type ExtensionActionListItem = {
+    /** Stable ID for the extension that owns this action. */
+    extensionId: ExtensionId;
+    /** Whether to show the action button for the current context (active tab). */
+    isVisible: boolean;
+    /** Accessible label / title for the action button. */
+    title: string;
+    /** Renderer-safe icon (data URL). */
+    iconDataUrl: string;
+};
+
 declare type ExtensionEvent = SecurityRealmEvent & {
     /**
      * Runtime extension whose status has been (possibly) modified
@@ -5435,6 +5509,13 @@ declare type ExtensionEvent = SecurityRealmEvent & {
     extension: string;
 };
 
+/**
+ * Unique identifier of a Chromium extension.
+ *
+ * @interface
+ */
+declare type ExtensionId = string;
+
 /**
  * @interface
  */
@@ -6224,6 +6305,7 @@ declare interface FinApi<MeType extends OpenFin.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
+    readonly ChromeBrowser: OpenFin.ChromeBrowser;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -10609,6 +10691,7 @@ declare namespace OpenFin {
         SnapshotSource,
         SnapshotSourceModule,
         System,
+        Readable,
         LayoutEntityDefinition,
         LayoutEntityTypes,
         LayoutPosition,
@@ -10641,6 +10724,10 @@ declare namespace OpenFin {
         AnchorLocation,
         Anchor,
         DownloadBubbleOptions,
+        ExtensionId,
+        ExtensionActionListItem,
+        ExtensionActionInvokeOptions,
+        ChromeBrowserActions,
         DisplayMetadata,
         LegacyWinOptionsInAppOptions,
         Snapshot,
@@ -11006,6 +11093,7 @@ declare namespace OpenFin {
         InteropClientEvent,
         ClientChangedContextGroup,
         InteropClientEvents,
+        ChromeBrowser,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -14178,6 +14266,14 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         };
         response: void;
     };
+    'chrome-browser-get-extension-actions': ApiCall<{}, {
+        actions: OpenFin.ExtensionActionListItem[];
+    }>;
+    'chrome-browser-invoke-extension-action': ApiCall<{
+        extensionId: string;
+        anchor: OpenFin.Anchor;
+    }, void>;
+    'chrome-browser-hide-active-extension-popup': ApiCall<{}, void>;
 };
 
 declare type ProtocolOffer = ClassicProtocolOffer | RTCProtocolOffer;
@@ -14274,6 +14370,21 @@ declare type QueryPermissionResult = {
     rawValue?: unknown;
 };
 
+/**
+ * A readonly implementation of the observable pattern.
+ * Frameworks and vanilla consumers use this to read state and subscribe to changes.
+ */
+declare interface Readable<T> {
+    /** Synchronously returns the current value. */
+    get(): T;
+    /**
+     * Subscribes to changes.
+     * @param listener A callback that is invoked when the value changes.
+     * @returns An unsubscribe function to clean up the listener.
+     */
+    subscribe(listener: () => void): () => void;
+}
+
 /**
  * @interface
  */

package/out/fdc3-api-public.d.ts

@@ -3101,6 +3101,53 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin.WindowOptions;
 };
 
+/**
+ * End of Interop Client Events
+ */
+/**
+ * Client-side handle for the chrome-browser feature.
+ *
+ * For Chrome extension integration to be active on a window, that window must be
+ * created with `chromeBrowser: true` in its window options. There is no separate
+ * `init()` step.
+ */
+declare interface ChromeBrowser {
+    /**
+     * Extension action surface — observe and invoke installed Chrome extension actions.
+     */
+    readonly Actions: ChromeBrowserActions;
+}
+
+/**
+ * APIs for interacting with Chromium extension actions from an initialized ChromeBrowser window.
+ *
+ * @interface
+ */
+declare interface ChromeBrowserActions {
+    /**
+     * Returns the current list of extension actions with the minimal render state
+     * required to build a toolbar UI.
+     */
+    getExtensionActions(): Promise<ExtensionActionListItem[]>;
+    /**
+     * Executes the specified extension action.
+     *
+     * @remarks
+     * This may trigger an extension popup to be shown by the Runtime if the extension
+     * has a popup configured for the currently active tab.
+     */
+    invokeExtensionAction(options: ExtensionActionInvokeOptions): Promise<void>;
+    /**
+     * Hides the active extension popup, if any.
+     */
+    hideActiveExtensionPopup(): Promise<void>;
+    /**
+     * Reactive value reflecting the current extension action list.
+     * Compatible with React's `useSyncExternalStore`.
+     */
+    readonly state: Readable<ExtensionActionListItem[]>;
+}
+
 /**
  * Control behavior for Chromium policies
  *
@@ -5428,6 +5475,33 @@ declare type ExitCode = {
     exitCode: number;
 };
 
+/**
+ * Options for invoking an extension action.
+ *
+ * @interface
+ */
+declare type ExtensionActionInvokeOptions = {
+    extensionId: ExtensionId;
+    /** Anchor in window client coordinates (from getBoundingClientRect). */
+    anchor: Anchor;
+};
+
+/**
+ * Minimal UI model required to render a list of extension actions.
+ *
+ * @interface
+ */
+declare type ExtensionActionListItem = {
+    /** Stable ID for the extension that owns this action. */
+    extensionId: ExtensionId;
+    /** Whether to show the action button for the current context (active tab). */
+    isVisible: boolean;
+    /** Accessible label / title for the action button. */
+    title: string;
+    /** Renderer-safe icon (data URL). */
+    iconDataUrl: string;
+};
+
 declare type ExtensionEvent = SecurityRealmEvent & {
     /**
      * Runtime extension whose status has been (possibly) modified
@@ -5435,6 +5509,13 @@ declare type ExtensionEvent = SecurityRealmEvent & {
     extension: string;
 };
 
+/**
+ * Unique identifier of a Chromium extension.
+ *
+ * @interface
+ */
+declare type ExtensionId = string;
+
 /**
  * @interface
  */
@@ -6224,6 +6305,7 @@ declare interface FinApi<MeType extends OpenFin.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
+    readonly ChromeBrowser: OpenFin.ChromeBrowser;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -10609,6 +10691,7 @@ declare namespace OpenFin {
         SnapshotSource,
         SnapshotSourceModule,
         System,
+        Readable,
         LayoutEntityDefinition,
         LayoutEntityTypes,
         LayoutPosition,
@@ -10641,6 +10724,10 @@ declare namespace OpenFin {
         AnchorLocation,
         Anchor,
         DownloadBubbleOptions,
+        ExtensionId,
+        ExtensionActionListItem,
+        ExtensionActionInvokeOptions,
+        ChromeBrowserActions,
         DisplayMetadata,
         LegacyWinOptionsInAppOptions,
         Snapshot,
@@ -11006,6 +11093,7 @@ declare namespace OpenFin {
         InteropClientEvent,
         ClientChangedContextGroup,
         InteropClientEvents,
+        ChromeBrowser,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -14178,6 +14266,14 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         };
         response: void;
     };
+    'chrome-browser-get-extension-actions': ApiCall<{}, {
+        actions: OpenFin.ExtensionActionListItem[];
+    }>;
+    'chrome-browser-invoke-extension-action': ApiCall<{
+        extensionId: string;
+        anchor: OpenFin.Anchor;
+    }, void>;
+    'chrome-browser-hide-active-extension-popup': ApiCall<{}, void>;
 };
 
 declare type ProtocolOffer = ClassicProtocolOffer | RTCProtocolOffer;
@@ -14274,6 +14370,21 @@ declare type QueryPermissionResult = {
     rawValue?: unknown;
 };
 
+/**
+ * A readonly implementation of the observable pattern.
+ * Frameworks and vanilla consumers use this to read state and subscribe to changes.
+ */
+declare interface Readable<T> {
+    /** Synchronously returns the current value. */
+    get(): T;
+    /**
+     * Subscribes to changes.
+     * @param listener A callback that is invoked when the value changes.
+     * @returns An unsubscribe function to clean up the listener.
+     */
+    subscribe(listener: () => void): () => void;
+}
+
 /**
  * @interface
  */

package/out/fdc3-api.d.ts

@@ -3157,6 +3157,53 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin.WindowOptions;
 };
 
+/**
+ * End of Interop Client Events
+ */
+/**
+ * Client-side handle for the chrome-browser feature.
+ *
+ * For Chrome extension integration to be active on a window, that window must be
+ * created with `chromeBrowser: true` in its window options. There is no separate
+ * `init()` step.
+ */
+declare interface ChromeBrowser {
+    /**
+     * Extension action surface — observe and invoke installed Chrome extension actions.
+     */
+    readonly Actions: ChromeBrowserActions;
+}
+
+/**
+ * APIs for interacting with Chromium extension actions from an initialized ChromeBrowser window.
+ *
+ * @interface
+ */
+declare interface ChromeBrowserActions {
+    /**
+     * Returns the current list of extension actions with the minimal render state
+     * required to build a toolbar UI.
+     */
+    getExtensionActions(): Promise<ExtensionActionListItem[]>;
+    /**
+     * Executes the specified extension action.
+     *
+     * @remarks
+     * This may trigger an extension popup to be shown by the Runtime if the extension
+     * has a popup configured for the currently active tab.
+     */
+    invokeExtensionAction(options: ExtensionActionInvokeOptions): Promise<void>;
+    /**
+     * Hides the active extension popup, if any.
+     */
+    hideActiveExtensionPopup(): Promise<void>;
+    /**
+     * Reactive value reflecting the current extension action list.
+     * Compatible with React's `useSyncExternalStore`.
+     */
+    readonly state: Readable<ExtensionActionListItem[]>;
+}
+
 /**
  * Control behavior for Chromium policies
  *
@@ -5510,6 +5557,33 @@ declare type ExitCode = {
     exitCode: number;
 };
 
+/**
+ * Options for invoking an extension action.
+ *
+ * @interface
+ */
+declare type ExtensionActionInvokeOptions = {
+    extensionId: ExtensionId;
+    /** Anchor in window client coordinates (from getBoundingClientRect). */
+    anchor: Anchor;
+};
+
+/**
+ * Minimal UI model required to render a list of extension actions.
+ *
+ * @interface
+ */
+declare type ExtensionActionListItem = {
+    /** Stable ID for the extension that owns this action. */
+    extensionId: ExtensionId;
+    /** Whether to show the action button for the current context (active tab). */
+    isVisible: boolean;
+    /** Accessible label / title for the action button. */
+    title: string;
+    /** Renderer-safe icon (data URL). */
+    iconDataUrl: string;
+};
+
 declare type ExtensionEvent = SecurityRealmEvent & {
     /**
      * Runtime extension whose status has been (possibly) modified
@@ -5517,6 +5591,13 @@ declare type ExtensionEvent = SecurityRealmEvent & {
     extension: string;
 };
 
+/**
+ * Unique identifier of a Chromium extension.
+ *
+ * @interface
+ */
+declare type ExtensionId = string;
+
 /**
  * @interface
  */
@@ -6309,6 +6390,7 @@ declare interface FinApi<MeType extends OpenFin.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
+    readonly ChromeBrowser: OpenFin.ChromeBrowser;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -10943,6 +11025,7 @@ declare namespace OpenFin {
         SnapshotSource,
         SnapshotSourceModule,
         System,
+        Readable,
         LayoutEntityDefinition,
         LayoutEntityTypes,
         LayoutPosition,
@@ -10975,6 +11058,10 @@ declare namespace OpenFin {
         AnchorLocation,
         Anchor,
         DownloadBubbleOptions,
+        ExtensionId,
+        ExtensionActionListItem,
+        ExtensionActionInvokeOptions,
+        ChromeBrowserActions,
         DisplayMetadata,
         LegacyWinOptionsInAppOptions,
         Snapshot,
@@ -11340,6 +11427,7 @@ declare namespace OpenFin {
         InteropClientEvent,
         ClientChangedContextGroup,
         InteropClientEvents,
+        ChromeBrowser,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -14595,6 +14683,14 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         };
         response: void;
     };
+    'chrome-browser-get-extension-actions': ApiCall<{}, {
+        actions: OpenFin.ExtensionActionListItem[];
+    }>;
+    'chrome-browser-invoke-extension-action': ApiCall<{
+        extensionId: string;
+        anchor: OpenFin.Anchor;
+    }, void>;
+    'chrome-browser-hide-active-extension-popup': ApiCall<{}, void>;
 };
 
 declare type ProtocolOffer = ClassicProtocolOffer | RTCProtocolOffer;
@@ -14691,6 +14787,21 @@ declare type QueryPermissionResult = {
     rawValue?: unknown;
 };
 
+/**
+ * A readonly implementation of the observable pattern.
+ * Frameworks and vanilla consumers use this to read state and subscribe to changes.
+ */
+declare interface Readable<T> {
+    /** Synchronously returns the current value. */
+    get(): T;
+    /**
+     * Subscribes to changes.
+     * @param listener A callback that is invoked when the value changes.
+     * @returns An unsubscribe function to clean up the listener.
+     */
+    subscribe(listener: () => void): () => void;
+}
+
 /**
  * @interface
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/fdc3-api",
-  "version": "45.100.72",
+  "version": "45.100.74",
   "description": "OpenFin fdc3 module utilities and types.",
   "license": "SEE LICENSE IN LICENSE.md",
   "private": false,