@openfin/workspace 45.1.10 → 45.1.12

package/client-api-platform/src/api/app-directory.d.ts

@@ -7,7 +7,7 @@ import type { LaunchAppRequest, SearchSitesRequest, SearchSitesResponse, Site }
  * @param app the app directory entry.
  * @param opts launch options.
  */
-export declare function launchApp({ app, target }: LaunchAppRequest): Promise<void | OpenFin.View | OpenFin.Identity | OpenFin.Platform | OpenFin.Application>;
+export declare function launchApp({ app, target }: LaunchAppRequest): Promise<void | OpenFin.Identity | OpenFin.Platform | OpenFin.View | OpenFin.Application>;
 export declare const enterpriseAppDirectoryChannelClient: () => Promise<OpenFin.ChannelClient>;
 export declare function getResults(payload: {
     req: SearchSitesRequest;

package/common/src/utils/env.d.ts

@@ -11,7 +11,7 @@ export declare const isDocumentDefined: boolean;
 export declare const isWindowDefinedWithIndexDB: boolean;
 export declare const finUUID: string;
 export declare const finName: string;
-export declare const finEntityType: "" | "window" | "view";
+export declare const finEntityType: "" | "view" | "window";
 export declare const isEnvLocal: boolean;
 export declare const isEnvDev: boolean;
 export declare const isEnvStaging: boolean;

package/common/src/utils/layout.d.ts

@@ -153,6 +153,19 @@ export declare const findViewInLayout: (node: any, viewId: OpenFin.Identity) =>
  * @returns The total number of views in the layout configuration.
  */
 export declare const countViews: (node: OpenFin.LayoutContent) => number;
+/**
+ * Returns the sole view component when a page layout contains exactly one view.
+ * Used to decide whether a page-tab drag should emit a single-view merge payload.
+ *
+ * Importantly this counts views recursively across the layout tree, not just
+ * top-level sections — a one-section/tab-strip supertab with multiple views
+ * must not be treated as a single-view page.
+ *
+ * Also requires a non-empty `componentState.name`. Core types mark
+ * `componentState` / `name` as optional, and a merge payload without a name
+ * is invalid — treat those layouts as non-mergeable page drags instead.
+ */
+export declare const getSingleViewComponent: (content: OpenFin.LayoutContent | undefined) => OpenFin.LayoutComponent | null;
 export declare const getLayoutConfig: (layoutContainerKey: string) => Promise<any>;
 export declare const findPageForView: (viewName: string, browserWindowIdentity?: WindowIdentity) => Promise<AttachedPage | undefined>;
 /**

package/common/src/utils/navigate.d.ts

@@ -6,6 +6,8 @@ import { ComponentName } from '../../../common/src/utils/usage-register';
 export declare const NavigationSource: {
     readonly DOCK_SEARCH_BUTTON: "dock-search-button";
     readonly DOCK_STORE_BUTTON: "dock-store-button";
+    readonly DOCK3_SEARCH_BUTTON: "dock3-search-button";
+    readonly DOCK3_STORE_BUTTON: "dock3-store-button";
     readonly HOME_ESC: "home-esc";
     readonly HOME_COMMAND: "home-command";
 };
@@ -21,3 +23,10 @@ export interface NavigateToOptions {
     source?: NavigationSourceType | null;
 }
 export declare const navigateTo: (componentName: ComponentName, platformIdentity: OpenFin.Identity, options?: NavigateToOptions) => Promise<void>;
+/** True when Home/Storefront was opened from classic Dock or Dock3. */
+export declare const wasOpenedFromDock: (source: string | null | undefined) => boolean;
+/**
+ * Show/focus the dock that opened Home or Storefront (classic vs Dock3).
+ * @returns true if the source was a dock opener (whether or not that dock was running).
+ */
+export declare const showOpenerDockForNavigationSource: (source: string | null | undefined, platformUuid: string) => Promise<boolean>;

package/common/src/utils/window.d.ts

@@ -28,7 +28,11 @@ export declare enum WindowName {
     DesktopSignalsModal = "here-desktop-signals-modal",
     IntentsResolverModal = "here-intents-resolver-modal",
     /** Browser-zone Home VPW window (platform child window). */
-    HomeVpw = "home-vpw"
+    HomeVpw = "home-vpw",
+    /** Browser-zone Storefront VPW window (platform child window). */
+    StorefrontVpw = "storefront-vpw",
+    /** Dock3 window (platform child window). */
+    Dock3 = "dock3"
 }
 export interface WindowIdentity {
     uuid: ApplicationUUID | string;
@@ -105,6 +109,12 @@ export declare const providerOFIdentity: {
     readonly name: ApplicationUUID.Workspace;
     readonly uuid: ApplicationUUID.Workspace;
 };
+/** Home VPW window identity under a platform UUID. */
+export declare const getHomeVpwOFIdentity: (platformUuid: string) => WindowIdentity;
+/** Storefront VPW window identity under a platform UUID. */
+export declare const getStorefrontVpwOFIdentity: (platformUuid: string) => WindowIdentity;
+/** Dock3 window identity under a platform UUID. */
+export declare const getDock3OFIdentity: (platformUuid: string) => WindowIdentity;
 /**
  * Get the Home OpenFin window.
  */
@@ -175,7 +185,26 @@ export declare const showAndFocusDock: () => Promise<void>;
 export declare const getDisableMultiplePagesOption: (identity: WindowIdentity) => Promise<any>;
 export declare const getIsLockedOption: (identity: WindowIdentity) => Promise<any>;
 export declare const getPlatformWindowTitle: (identity: WindowIdentity) => Promise<any>;
-export declare const getComponentWindowStatus: () => Promise<{
+/**
+ * Prefer a running Home VPW window for the platform; fall back to classic Home.
+ */
+export declare const resolvePreferredHomeIdentity: (platformUuid: string) => Promise<WindowIdentity | null>;
+/**
+ * Prefer a running Storefront VPW window for the platform; fall back to classic Storefront.
+ */
+export declare const resolvePreferredStorefrontIdentity: (platformUuid: string) => Promise<WindowIdentity | null>;
+export declare const showPreferredHomeWindow: (platformUuid: string) => Promise<void>;
+export declare const showPreferredStorefrontWindow: (platformUuid: string) => Promise<void>;
+/**
+ * Prefer a running Dock3 window for the platform; fall back to classic Dock.
+ */
+export declare const resolvePreferredDockIdentity: (platformUuid: string) => Promise<WindowIdentity | null>;
+export declare const showPreferredDockWindow: (platformUuid: string) => Promise<void>;
+/**
+ * Whether classic and/or VPW Home/Storefront windows are running.
+ * When `platformUuid` is provided, VPW windows under that platform count as running.
+ */
+export declare const getComponentWindowStatus: (platformUuid?: string) => Promise<{
     storefrontRunning: boolean;
     homeRunning: boolean;
 }>;

package/externals.report.json

@@ -2,7 +2,7 @@
     "@openfin/notifications": [
         {
             "type": "explicit",
-            "version": "45.1.0-alpha-4945",
+            "version": "45.1.0-alpha-4953",
             "packageName": "client-api/package.json",
             "issuer": "client-api/src/notifications.ts"
         }
@@ -43,14 +43,6 @@
             "issuer": "common/src/utils/layout.ts"
         }
     ],
-    "lodash.clonedeep": [
-        {
-            "type": "explicit",
-            "version": "4.5.0",
-            "packageName": "common/package.json",
-            "issuer": "common/src/utils/layout.ts"
-        }
-    ],
     "react-i18next": [
         {
             "type": "explicit",
@@ -68,12 +60,6 @@
         }
     ],
     "dexie": [
-        {
-            "type": "explicit",
-            "version": "^4.0.11",
-            "packageName": "common/package.json",
-            "issuer": "common/src/api/pages/idb.ts"
-        },
         {
             "type": "root-implicit",
             "version": "^4.0.11",
@@ -91,6 +77,20 @@
             "version": "^4.0.11",
             "packageName": "common/package.json",
             "issuer": "common/src/utils/create-and-migrate-ibd-store.ts"
+        },
+        {
+            "type": "explicit",
+            "version": "^4.0.11",
+            "packageName": "common/package.json",
+            "issuer": "common/src/api/pages/idb.ts"
+        }
+    ],
+    "lodash.clonedeep": [
+        {
+            "type": "explicit",
+            "version": "4.5.0",
+            "packageName": "common/package.json",
+            "issuer": "common/src/utils/layout.ts"
         }
     ]
 }