@openfin/workspace 45.0.15 → 45.1.0-alpha.2539edb0

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

@@ -1,7 +1,7 @@
 import type OpenFin from '@openfin/core';
-import type { PagePinnedState } from '../../../common/src/api/pages/shapes';
 import { WindowIdentity } from '../../../common/src/utils/window';
-import { AttachedPage, PageLayout } from '../../../client-api-platform/src/shapes';
+import type { PagePinnedState } from '../../../common/src/api/pages/shapes';
+import { AttachedPage, BrowserCreateViewRequest, PageLayout } from '../../../client-api-platform/src/shapes';
 export type LayoutDOMEventType = 
 /**
  * Fired when a tab is created in a container. (Emmitted by ??)
@@ -90,7 +90,7 @@ export declare const generateViewNameAndIdentifierNameIfNotExists: <T extends {
  * @param layout The Layout to be cloned
  * @returns A Promise resolving to a copy of the layout with view options converted
  */
-export declare const cloneLayoutAndConvertViewOptions: (layout: PageLayout, initViewOptions?: Partial<OpenFin.ViewOptions>) => Promise<PageLayout>;
+export declare const cloneLayoutAndConvertViewOptions: (layout: PageLayout, initViewOptions?: Partial<BrowserCreateViewRequest>) => Promise<PageLayout>;
 export declare const cloneViewComponentWithoutName: (componentState: any) => any;
 /**
  * Deep clones a layout and removes generated view names.
@@ -153,8 +153,27 @@ 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>;
+/**
+ * Waits for a specific view to receive focus on the current window, resolving
+ * either when the matching `view-focused` event fires or after a timeout (default 150ms).
+ * Useful for ensuring focus is stable before opening popups that would auto-close on focus shift.
+ */
+export declare const waitForViewFocus: (viewName: string, timeoutMs?: number) => Promise<void>;
 /**
  * Only show the view tab icon when not on the landing page
  */

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

@@ -0,0 +1,32 @@
+import type OpenFin from '@openfin/core';
+import { ComponentName } from '../../../common/src/utils/usage-register';
+/**
+ * Constants for navigation source identifiers
+ */
+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";
+};
+export type NavigationSourceType = (typeof NavigationSource)[keyof typeof NavigationSource];
+export interface NavigatePayload {
+    componentName: ComponentName;
+    platformIdentity: OpenFin.Identity;
+    providerId?: string;
+    source?: NavigationSourceType | null;
+}
+export interface NavigateToOptions {
+    providerId?: string;
+    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/popup-window.d.ts

@@ -29,6 +29,10 @@ export type SearchMenuChannelMessage = {
     type: 'update-search-menu-state';
 } | {
     type: 'ready';
+} | {
+    /** Browser window asks the search view whether its webContents owns focus. */
+    type: 'focus-query';
+    requestId: string;
 };
 export type BrowserSearchMenuKeyboardEvent = {
     type: string;
@@ -171,5 +175,10 @@ export type SearchMenuChannelResponse = {
 } | {
     type: 'single-provider-results-announcement';
     message: string;
+} | {
+    /** Answer to a 'focus-query' message: whether the search view's webContents owns focus. */
+    type: 'focus-state';
+    requestId: string;
+    hasFocus: boolean;
 };
 export {};

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

@@ -2,6 +2,10 @@
  * All routes that serve HTML pages for the app.
  * Routes should include the zone that the HTML page is a part of.
  * Make sure to include trailing slash, as it is essential for deployed version to route correctly.
+ *
+ * Offline: zone `pages/` HTML is auto-precached at build time via
+ * `common/scripts/offline-document-routes.js` (used by createWorkspaceNextConfig).
+ * Adding a new page under `pages/` is enough — no manual SW list update.
  */
 declare enum WorkspaceRoute {
     Home = "/home/",
@@ -16,6 +20,7 @@ declare enum WorkspaceRoute {
 }
 declare enum BrowserRoute {
     Browser = "/browser/",
+    BrowserHome = "/home/",
     BrowserPopupMenu = "/popup-menu/",
     BrowserPopupMenuSaveModal = "/popup-menu/save-modal/",
     BrowserPopupMenuLayouts = "/popup-menu/layouts/layouts/",
@@ -40,6 +45,7 @@ declare enum BrowserRoute {
 }
 declare const PageRoute: {
     Browser: BrowserRoute.Browser;
+    BrowserHome: BrowserRoute.BrowserHome;
     BrowserPopupMenu: BrowserRoute.BrowserPopupMenu;
     BrowserPopupMenuSaveModal: BrowserRoute.BrowserPopupMenuSaveModal;
     BrowserPopupMenuLayouts: BrowserRoute.BrowserPopupMenuLayouts;

package/common/src/utils/usage-register.d.ts

@@ -11,22 +11,36 @@ export declare enum ComponentName {
     Dock = "Dock",
     EnterpriseDock = "EnterpriseDock",
     Home = "Home",
+    HomeVpw = "HomeVpw",
     Notification = "Notification",
     Storefront = "Storefront",
     Platform = "Platform",
     Theming = "Theming",
     Microflow = "Microflow",
-    SupertabHideShowTabs = "PRODM-318: Supertab Hide/Show Tab Headers"
+    SuppressWorkspaceSwitched = "SuppressWorkspaceSwitched",
+    SuppressWorkspaceSaved = "SuppressWorkspaceSaved",
+    AllowDuplicatePageTitles = "AllowDuplicatePageTitles",
+    PagePinning = "PagePinning",
+    ViewTabNewTabShortcut = "ViewTabNewTabShortcut",
+    SupertabHideShowTabs = "PRODM-318: Supertab Hide/Show Tab Headers",
+    StorefrontVpw = "PRODM-171: VPW Storefront"
 }
 export declare const registerBrowserUsage: (status: RegisterUsageStatus) => void;
 export declare const registerHomeUsage: (status: RegisterUsageStatus) => void;
 export declare const registerStorefrontUsage: (status: RegisterUsageStatus) => void;
+export declare const registerHomeVpwUsage: (status: RegisterUsageStatus) => void;
 export declare const registerDockUsage: (status: RegisterUsageStatus) => void;
 export declare const registerNotificationUsage: (status: RegisterUsageStatus) => void;
 export declare const registerPlatformUsage: (status: RegisterUsageStatus) => void;
 export declare const registerThemingUsage: (status: RegisterUsageStatus) => void;
 export declare const registerMicroflowUsage: (microflowName: string, status: RegisterUsageStatus) => void;
+export declare const registerSuppressWorkspaceSwitchedUsage: (status: RegisterUsageStatus) => void;
+export declare const registerSuppressWorkspaceSavedUsage: (status: RegisterUsageStatus) => void;
+export declare const registerAllowDuplicatePageTitlesUsage: (status: RegisterUsageStatus) => void;
+export declare const registerPagePinningUsage: (status: RegisterUsageStatus) => void;
+export declare const registerViewTabNewTabShortcutUsage: (status: RegisterUsageStatus) => void;
 export declare const registerSupertabHideShowTabsUsage: () => void;
+export declare const registerStorefrontVpwUsage: (status: RegisterUsageStatus) => void;
 export type AnalyticsSource = 'Browser' | 'Dock' | 'Home' | 'Notification' | 'Store' | 'Platform' | 'Theming' | 'Interop';
 /**
  * Event for analytics

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

@@ -26,7 +26,13 @@ export declare enum WindowName {
     ApplyAndPublishModal = "here-apply-and-publish-modal",
     PublishOnCloseModal = "here-publish-on-close-modal",
     DesktopSignalsModal = "here-desktop-signals-modal",
-    IntentsResolverModal = "here-intents-resolver-modal"
+    IntentsResolverModal = "here-intents-resolver-modal",
+    /** Browser-zone Home VPW window (platform child window). */
+    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;
@@ -103,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.
  */
@@ -168,12 +180,32 @@ export declare const isStorefrontWindowRunning: () => Promise<boolean>;
 export declare const isDockWindowRunning: () => Promise<boolean>;
 export declare const isHomeWindowRunning: () => Promise<boolean>;
 export declare const isNotificationCenterRunning: () => Promise<boolean>;
+export declare const isProviderWindowRunning: () => Promise<boolean>;
 export declare const showAndFocusStorefront: () => Promise<void>;
 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,11 +2,19 @@
     "@openfin/notifications": [
         {
             "type": "explicit",
-            "version": "45.0.0-alpha-4928",
+            "version": "45.1.0-alpha-4967",
             "packageName": "client-api/package.json",
             "issuer": "client-api/src/notifications.ts"
         }
     ],
+    "@openfin/microsoft365": [
+        {
+            "type": "explicit",
+            "version": "^1.1.0",
+            "packageName": "client-api/package.json",
+            "issuer": "client-api/src/integrations/microsoft.ts"
+        }
+    ],
     "title-case": [
         {
             "type": "explicit",
@@ -21,14 +29,6 @@
             "issuer": "common/src/utils/color-linking.ts"
         }
     ],
-    "@openfin/microsoft365": [
-        {
-            "type": "explicit",
-            "version": "^1.1.0",
-            "packageName": "client-api/package.json",
-            "issuer": "client-api/src/integrations/microsoft.ts"
-        }
-    ],
     "lodash.debounce": [
         {
             "type": "explicit",
@@ -43,12 +43,20 @@
             "issuer": "common/src/utils/layout.ts"
         }
     ],
-    "lodash.clonedeep": [
+    "react-i18next": [
         {
             "type": "explicit",
-            "version": "4.5.0",
+            "version": "15.4.0",
             "packageName": "common/package.json",
-            "issuer": "common/src/utils/layout.ts"
+            "issuer": "common/src/api/i18next.ts"
+        }
+    ],
+    "i18next": [
+        {
+            "type": "explicit",
+            "version": "^23.7.16",
+            "packageName": "common/package.json",
+            "issuer": "common/src/api/i18next.ts"
         }
     ],
     "dexie": [
@@ -68,29 +76,21 @@
             "type": "explicit",
             "version": "^4.0.11",
             "packageName": "common/package.json",
-            "issuer": "common/src/utils/create-and-migrate-ibd-store.ts"
+            "issuer": "common/src/api/pages/idb.ts"
         },
         {
             "type": "explicit",
             "version": "^4.0.11",
             "packageName": "common/package.json",
-            "issuer": "common/src/api/pages/idb.ts"
-        }
-    ],
-    "react-i18next": [
-        {
-            "type": "explicit",
-            "version": "15.4.0",
-            "packageName": "common/package.json",
-            "issuer": "common/src/api/i18next.ts"
+            "issuer": "common/src/utils/create-and-migrate-ibd-store.ts"
         }
     ],
-    "i18next": [
+    "lodash.clonedeep": [
         {
             "type": "explicit",
-            "version": "^23.7.16",
+            "version": "4.5.0",
             "packageName": "common/package.json",
-            "issuer": "common/src/api/i18next.ts"
+            "issuer": "common/src/utils/layout.ts"
         }
     ]
 }

package/home-vpw/src/api/constants.d.ts

@@ -0,0 +1,3 @@
+import { WindowName } from '../../../common/src/utils/window';
+export declare const HOME_VPW_WINDOW_NAME = WindowName.HomeVpw;
+export declare const getHomeVpwChannelName: (uuid?: string) => string;

package/home-vpw/src/api/ensure-infrastructure.d.ts

@@ -0,0 +1,6 @@
+import type { CLIProvider, HomeProvider } from '../../../client-api/src/shapes';
+import { HomeVpwProvider } from './provider';
+/** Creates the platform channel and {@link HomeVpwProvider} instance if not already running. */
+export declare const ensureHomeVpwChannel: () => Promise<HomeVpwProvider>;
+/** Launches the browser-zone Home VPW window and waits for the client `ready` handshake. */
+export declare const launchHomeVpwWindow: (provider: Pick<HomeProvider | CLIProvider, "id" | "title" | "icon" | "subHeader">) => Promise<void>;

package/home-vpw/src/api/index.d.ts

@@ -0,0 +1,3 @@
+export { deregister, hide, register, show } from './register';
+export type { CLIProvider, HomeProvider, HomeRegistration, SetSearchQueryOptions } from './register';
+export { getHomeVpwChannelName, HOME_VPW_WINDOW_NAME } from './constants';

package/home-vpw/src/api/internal/channel-handlers.d.ts

@@ -0,0 +1,23 @@
+import type OpenFin from '@openfin/core';
+import { withDisconnectListener } from '../../../../common/src/utils/channels';
+import { SearchAPIClientChannelClient } from '../../../../common/src/api/protocol/shapes/search';
+import type { HomeClientApiDataRequest, HomeClientApiDispatchRequest, HomeClientApiSearchCloseRequest, HomeInternalDataResponse, HomeInternalErrorResponse, InternalSearchListenerRequest } from '../../../../common/src/api/shapes/home';
+import { HomeVpwProvidersMap } from './providers-map';
+import type { CLIProvider, HomeProvider } from '../../../../client-api/src/shapes';
+export type HomeVpwChannelHandlersContext = {
+    providers: HomeVpwProvidersMap<HomeProvider | CLIProvider>;
+    searchRequests: Map<string, InternalSearchListenerRequest>;
+    getSearchClientAPIChannelClient: () => Promise<withDisconnectListener<SearchAPIClientChannelClient>>;
+};
+export type HomeVpwChannelHandlers = {
+    handleDataRequest: (req: HomeClientApiDataRequest) => Promise<HomeInternalDataResponse | HomeInternalErrorResponse>;
+    handleResultDispatch: (req: HomeClientApiDispatchRequest, identity: OpenFin.Identity) => Promise<void>;
+    handleSearchRequestClose: (req: HomeClientApiSearchCloseRequest) => void;
+    handleChannelDisconnection: () => Promise<void>;
+};
+export declare const createHomeVpwChannelHandlers: (ctx: HomeVpwChannelHandlersContext) => HomeVpwChannelHandlers;
+type HomeVpwSearchChannelClient = withDisconnectListener<SearchAPIClientChannelClient> & {
+    homeVpwChannelActionsRegistered?: boolean;
+};
+export declare const registerHomeVpwChannelClientActions: (channel: HomeVpwSearchChannelClient, handlers: HomeVpwChannelHandlers) => void;
+export {};

package/home-vpw/src/api/internal/provider-registration.d.ts

@@ -0,0 +1,8 @@
+import type { CLIProvider, HomeProvider, RegisterMetaInfoInternal } from '../../../../client-api/src/shapes';
+import { HomeVpwProvidersMap } from './providers-map';
+/** VPW search providers — separate from legacy Home provider registration in client-api. */
+export declare const HomeVpwProviders: HomeVpwProvidersMap<HomeProvider | CLIProvider>;
+export declare const registerHomeVpwProviderInternal: (provider: HomeProvider | CLIProvider) => Promise<RegisterMetaInfoInternal>;
+export declare const registerHomeVpwBuiltinProviderInternal: (provider: HomeProvider | CLIProvider) => Promise<RegisterMetaInfoInternal | void>;
+export declare const deregisterHomeVpwProviderInternal: (providerId: string) => Promise<void>;
+export declare const hasRegisteredHomeVpwIntegrator: () => boolean;

package/home-vpw/src/api/internal/providers-map.d.ts

@@ -0,0 +1,22 @@
+import { PlatformError } from '../../../../common/src/errors';
+type HomeVpwProviderRecord = {
+    id: string;
+};
+export declare class HomeVpwProviderAlreadyRegisteredError extends PlatformError {
+    constructor(id: string);
+}
+/**
+ * In-process registry for Home VPW search provider callbacks.
+ * VPW-only — not shared with legacy Home provider registration in client-api.
+ */
+export declare class HomeVpwProvidersMap<T extends HomeVpwProviderRecord> {
+    private readonly providersMap;
+    getProvider(id: string): T | undefined;
+    hasProvider(id: string): boolean;
+    assertNotAlreadyRegistered(id: string): void;
+    hasProviderMatching(predicate: (id: string) => boolean): boolean;
+    addProvider(provider: T): void;
+    deleteProvider(id: string): void;
+    getProviderOrFail(id: string): T;
+}
+export {};

package/home-vpw/src/api/launch.d.ts

@@ -0,0 +1,6 @@
+import type { CLIProvider, HomeProvider } from '../../../client-api/src/shapes';
+/**
+ * Create the Home VPW window from the Workspace Platform (e.g. Studio).
+ * Uses fin.Window.create so creation runs in the platform process — same pattern as Dock3.
+ */
+export declare const launchHomeVpw: (provider: Pick<HomeProvider | CLIProvider, "subHeader">) => Promise<void>;

package/home-vpw/src/api/protocol.d.ts

@@ -0,0 +1,44 @@
+import type { OpenFin } from '@openfin/core';
+type ChannelActionMap = {
+    [action: string]: (...args: any[]) => any;
+};
+type TypedChannelClient<ProviderActions extends ChannelActionMap, ClientActions extends ChannelActionMap> = Omit<OpenFin.ChannelClient, 'dispatch' | 'register'> & {
+    dispatch: <T extends keyof ProviderActions>(action: T, payload: Parameters<ProviderActions[T]>[0]) => Promise<Awaited<ReturnType<ProviderActions[T]>>>;
+    register: <T extends keyof ClientActions>(action: T, handler: (payload: Parameters<ClientActions[T]>[0], id: OpenFin.ProviderIdentity | OpenFin.ClientIdentity) => Promise<Awaited<ReturnType<ClientActions[T]>>>) => boolean;
+};
+type TypedChannelProvider<ProviderActions extends ChannelActionMap, ClientActions extends ChannelActionMap> = Omit<OpenFin.ChannelProvider, 'dispatch' | 'register'> & {
+    dispatch: <T extends keyof ClientActions>(to: OpenFin.ClientIdentity, action: T, payload: Parameters<ClientActions[T]>[0]) => Promise<Awaited<ReturnType<ClientActions[T]>>>;
+    register: <T extends keyof ProviderActions>(action: T, handler: (payload: Parameters<ProviderActions[T]>[0], id: OpenFin.ProviderIdentity | OpenFin.ClientIdentity) => Promise<Awaited<ReturnType<ProviderActions[T]>>>) => boolean;
+};
+export type SetSearchQueryPayload = {
+    query: string;
+    providerId?: string;
+    context?: Record<string, unknown>;
+};
+export type SearchInvokedPayload = {
+    query?: string;
+    providerId?: string;
+    context?: Record<string, unknown>;
+};
+/**
+ * Actions the VPW window dispatches TO the platform provider (provider handles these).
+ * @internal
+ */
+export type HomeVpwChannelProviderChannelActions = {
+    ready: () => void;
+};
+/**
+ * Actions the platform provider dispatches TO the VPW window (client handles these).
+ * @internal
+ */
+export type HomeVpwChannelClientChannelActions = {
+    'search-invoked': (payload: SearchInvokedPayload) => void;
+    'set-search-query': (payload: SetSearchQueryPayload) => void;
+    /** Immediate show — mirrors legacy `show-home` / `showAndFocus`. */
+    'show': () => void;
+    /** Deferred show after resize animation and theme sync — mirrors legacy `setSearchQuery` show path. */
+    'show-when-ready': () => void;
+};
+export type HomeVpwChannelProvider = TypedChannelProvider<HomeVpwChannelProviderChannelActions, HomeVpwChannelClientChannelActions>;
+export type HomeVpwChannelClient = TypedChannelClient<HomeVpwChannelProviderChannelActions, HomeVpwChannelClientChannelActions>;
+export {};

package/home-vpw/src/api/provider.d.ts

@@ -0,0 +1,19 @@
+import type { OpenFin } from '@openfin/core';
+import type { HomeVpwChannelProvider } from './protocol';
+export declare class HomeVpwProvider {
+    #private;
+    static getOverrideConstructor(channel: HomeVpwChannelProvider): new () => HomeVpwProvider;
+    static instance: HomeVpwProvider | null;
+    constructor(channel: HomeVpwChannelProvider);
+    get ready(): Promise<void>;
+    private ensureClientConnected;
+    show(): Promise<void>;
+    showWhenReady(): Promise<void>;
+    hide(): Promise<void>;
+    shutdown(): Promise<void>;
+    getWindowSync(): OpenFin.Window;
+    dispatchSearchInvoked(query?: string, providerId?: string, context?: Record<string, unknown>): Promise<void>;
+    dispatchSetSearchQuery(query: string, providerId?: string, context?: Record<string, unknown>): Promise<void>;
+    private registerChannelActions;
+}
+export type HomeVpwConstructorOverride = (Base: new () => HomeVpwProvider) => new () => HomeVpwProvider;

package/home-vpw/src/api/register.d.ts

@@ -0,0 +1,10 @@
+import type { CLIProvider, HomeProvider, HomeRegistration } from '../../../client-api/src/shapes';
+export type { CLIProvider, HomeProvider, HomeRegistration, SetSearchQueryOptions } from '../../../client-api/src/shapes';
+export { hide, show } from './visibility';
+/**
+ * Register a Home VPW integrator — stands up channel, browser-zone window, and search topic registration.
+ * Mirrors legacy Home.register: window is created hidden; call show to display.
+ */
+export declare const register: (provider: HomeProvider | CLIProvider) => Promise<HomeRegistration>;
+export declare const deregister: (providerId: string) => Promise<void>;
+export declare const registerBuiltin: (provider: HomeProvider | CLIProvider) => Promise<void>;

package/home-vpw/src/api/visibility.d.ts

@@ -0,0 +1,3 @@
+export declare const show: () => Promise<void>;
+export declare const hide: () => Promise<void>;
+export declare const showWhenReady: () => Promise<void>;