@openfin/core 45.100.71 → 45.100.72

package/out/mock-alpha.d.ts

@@ -3144,6 +3144,11 @@ declare type ClearCacheOption = {
      * browser data that can be used across sessions
      */
     localStorage?: boolean;
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -3186,6 +3191,11 @@ declare type ClearDataOptions = {
      * - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
      */
     originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -12325,6 +12335,38 @@ declare interface PlatformProvider {
      * @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
      */
     shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
+    /**
+     * Returns the platform's keyboard commands. Default implementation returns the manifest's
+     * `platform.commands`. Override to inject additional default commands.
+     * Called once during Platform.init; the result is cached for the lifetime
+     * of the platform.
+     *
+     * @remarks
+     * The returned commands are merged with core's built-in default commands
+     * (unless `disableDefaultCommands` is set).
+     * Overriders receive the raw manifest commands from `super` and can prepend
+     * their own defaults — returned commands override default commands by command name.
+     *
+     * @example
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         getKeyboardCommands() {
+     *             const manifestCommands = super.getKeyboardCommands();
+     *             const myCommands = [{ command: 'myApp.search', keys: 'Ctrl+K' }];
+     *             return [
+     *                 ...myCommands,
+     *                 ...manifestCommands
+     *             ];
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     * ```
+     */
+    getKeyboardCommands(): OpenFin_2.ShortcutOverride[];
     /**
      * Method that is called every time an error occurs when processing an action in the Platform Provider. It is meant to be overriden, as a means to debug Platform applications
      */
@@ -13135,7 +13177,7 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     }>;
     'destroy-view': IdentityCall;
     'attach-view': IdentityCall<{
-        target: OpenFin_2.Identity;
+        target: OpenFin_2.Identity | OpenFin_2.LayoutIdentity;
     }>;
     'set-view-bounds': IdentityCall<{
         bounds: OpenFin_2.Bounds;
@@ -14932,13 +14974,15 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      * * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
      * * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
      * * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
+     * * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
      * @example
      * ```js
      * const clearCacheOptions = {
      *     appcache: true,
      *     cache: true,
      *     cookies: true,
-     *     localStorage: true
+     *     localStorage: true,
+     *     windowState: true
      * };
      * fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
      * ```
@@ -14963,12 +15007,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      *
      * @param options - Optional configuration for what data to clear
      *
+     * @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
+     * After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
+     *
      * @example
      * ```js
      * // Clear only cookies and localStorage for a specific origin
      * await fin.System.clearCacheData({
      *     dataTypes: ['cookies', 'localStorage'],
-     *     origins: ['http://localhost:8081']
+     *     origins: ['http://localhost:8081'],
+     *     windowState: true
      * });
      *
      * // Clear everything except for a specific origin
@@ -17426,7 +17474,7 @@ declare class View_2 extends WebContents<OpenFin_2.ViewEvent> {
      * ```
      * @experimental
      */
-    attach: (target: OpenFin_2.Identity) => Promise<void>;
+    attach: (target: OpenFin_2.Identity | OpenFin_2.LayoutIdentity) => Promise<void>;
     /**
      * Destroys the current view
      *
@@ -17850,7 +17898,7 @@ declare type ViewCreationFailure = {
 declare type ViewCreationOptions = Partial<ViewOptions> & {
     name: string;
     url: string;
-    target: Identity_4;
+    target: Identity_4 | LayoutIdentity;
 };
 
 declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.PlatformViewCreationOptions;

package/out/mock-beta.d.ts

@@ -3144,6 +3144,11 @@ declare type ClearCacheOption = {
      * browser data that can be used across sessions
      */
     localStorage?: boolean;
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -3186,6 +3191,11 @@ declare type ClearDataOptions = {
      * - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
      */
     originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -12325,6 +12335,38 @@ declare interface PlatformProvider {
      * @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
      */
     shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
+    /**
+     * Returns the platform's keyboard commands. Default implementation returns the manifest's
+     * `platform.commands`. Override to inject additional default commands.
+     * Called once during Platform.init; the result is cached for the lifetime
+     * of the platform.
+     *
+     * @remarks
+     * The returned commands are merged with core's built-in default commands
+     * (unless `disableDefaultCommands` is set).
+     * Overriders receive the raw manifest commands from `super` and can prepend
+     * their own defaults — returned commands override default commands by command name.
+     *
+     * @example
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         getKeyboardCommands() {
+     *             const manifestCommands = super.getKeyboardCommands();
+     *             const myCommands = [{ command: 'myApp.search', keys: 'Ctrl+K' }];
+     *             return [
+     *                 ...myCommands,
+     *                 ...manifestCommands
+     *             ];
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     * ```
+     */
+    getKeyboardCommands(): OpenFin_2.ShortcutOverride[];
     /**
      * Method that is called every time an error occurs when processing an action in the Platform Provider. It is meant to be overriden, as a means to debug Platform applications
      */
@@ -13135,7 +13177,7 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     }>;
     'destroy-view': IdentityCall;
     'attach-view': IdentityCall<{
-        target: OpenFin_2.Identity;
+        target: OpenFin_2.Identity | OpenFin_2.LayoutIdentity;
     }>;
     'set-view-bounds': IdentityCall<{
         bounds: OpenFin_2.Bounds;
@@ -14932,13 +14974,15 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      * * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
      * * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
      * * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
+     * * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
      * @example
      * ```js
      * const clearCacheOptions = {
      *     appcache: true,
      *     cache: true,
      *     cookies: true,
-     *     localStorage: true
+     *     localStorage: true,
+     *     windowState: true
      * };
      * fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
      * ```
@@ -14963,12 +15007,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      *
      * @param options - Optional configuration for what data to clear
      *
+     * @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
+     * After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
+     *
      * @example
      * ```js
      * // Clear only cookies and localStorage for a specific origin
      * await fin.System.clearCacheData({
      *     dataTypes: ['cookies', 'localStorage'],
-     *     origins: ['http://localhost:8081']
+     *     origins: ['http://localhost:8081'],
+     *     windowState: true
      * });
      *
      * // Clear everything except for a specific origin
@@ -17426,7 +17474,7 @@ declare class View_2 extends WebContents<OpenFin_2.ViewEvent> {
      * ```
      * @experimental
      */
-    attach: (target: OpenFin_2.Identity) => Promise<void>;
+    attach: (target: OpenFin_2.Identity | OpenFin_2.LayoutIdentity) => Promise<void>;
     /**
      * Destroys the current view
      *
@@ -17850,7 +17898,7 @@ declare type ViewCreationFailure = {
 declare type ViewCreationOptions = Partial<ViewOptions> & {
     name: string;
     url: string;
-    target: Identity_4;
+    target: Identity_4 | LayoutIdentity;
 };
 
 declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.PlatformViewCreationOptions;

package/out/mock-public.d.ts

@@ -3144,6 +3144,11 @@ declare type ClearCacheOption = {
      * browser data that can be used across sessions
      */
     localStorage?: boolean;
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -3186,6 +3191,11 @@ declare type ClearDataOptions = {
      * - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
      */
     originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -12325,6 +12335,38 @@ declare interface PlatformProvider {
      * @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
      */
     shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
+    /**
+     * Returns the platform's keyboard commands. Default implementation returns the manifest's
+     * `platform.commands`. Override to inject additional default commands.
+     * Called once during Platform.init; the result is cached for the lifetime
+     * of the platform.
+     *
+     * @remarks
+     * The returned commands are merged with core's built-in default commands
+     * (unless `disableDefaultCommands` is set).
+     * Overriders receive the raw manifest commands from `super` and can prepend
+     * their own defaults — returned commands override default commands by command name.
+     *
+     * @example
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         getKeyboardCommands() {
+     *             const manifestCommands = super.getKeyboardCommands();
+     *             const myCommands = [{ command: 'myApp.search', keys: 'Ctrl+K' }];
+     *             return [
+     *                 ...myCommands,
+     *                 ...manifestCommands
+     *             ];
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     * ```
+     */
+    getKeyboardCommands(): OpenFin_2.ShortcutOverride[];
     /**
      * Method that is called every time an error occurs when processing an action in the Platform Provider. It is meant to be overriden, as a means to debug Platform applications
      */
@@ -13135,7 +13177,7 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     }>;
     'destroy-view': IdentityCall;
     'attach-view': IdentityCall<{
-        target: OpenFin_2.Identity;
+        target: OpenFin_2.Identity | OpenFin_2.LayoutIdentity;
     }>;
     'set-view-bounds': IdentityCall<{
         bounds: OpenFin_2.Bounds;
@@ -14932,13 +14974,15 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      * * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
      * * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
      * * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
+     * * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
      * @example
      * ```js
      * const clearCacheOptions = {
      *     appcache: true,
      *     cache: true,
      *     cookies: true,
-     *     localStorage: true
+     *     localStorage: true,
+     *     windowState: true
      * };
      * fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
      * ```
@@ -14963,12 +15007,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      *
      * @param options - Optional configuration for what data to clear
      *
+     * @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
+     * After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
+     *
      * @example
      * ```js
      * // Clear only cookies and localStorage for a specific origin
      * await fin.System.clearCacheData({
      *     dataTypes: ['cookies', 'localStorage'],
-     *     origins: ['http://localhost:8081']
+     *     origins: ['http://localhost:8081'],
+     *     windowState: true
      * });
      *
      * // Clear everything except for a specific origin
@@ -17426,7 +17474,7 @@ declare class View_2 extends WebContents<OpenFin_2.ViewEvent> {
      * ```
      * @experimental
      */
-    attach: (target: OpenFin_2.Identity) => Promise<void>;
+    attach: (target: OpenFin_2.Identity | OpenFin_2.LayoutIdentity) => Promise<void>;
     /**
      * Destroys the current view
      *
@@ -17850,7 +17898,7 @@ declare type ViewCreationFailure = {
 declare type ViewCreationOptions = Partial<ViewOptions> & {
     name: string;
     url: string;
-    target: Identity_4;
+    target: Identity_4 | LayoutIdentity;
 };
 
 declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.PlatformViewCreationOptions;

package/out/stub.d.ts

@@ -3200,6 +3200,11 @@ declare type ClearCacheOption = {
      * browser data that can be used across sessions
      */
     localStorage?: boolean;
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -3242,6 +3247,11 @@ declare type ClearDataOptions = {
      * - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
      */
     originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -12742,6 +12752,38 @@ declare interface PlatformProvider {
      * @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
      */
     shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
+    /**
+     * Returns the platform's keyboard commands. Default implementation returns the manifest's
+     * `platform.commands`. Override to inject additional default commands.
+     * Called once during Platform.init; the result is cached for the lifetime
+     * of the platform.
+     *
+     * @remarks
+     * The returned commands are merged with core's built-in default commands
+     * (unless `disableDefaultCommands` is set).
+     * Overriders receive the raw manifest commands from `super` and can prepend
+     * their own defaults — returned commands override default commands by command name.
+     *
+     * @example
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         getKeyboardCommands() {
+     *             const manifestCommands = super.getKeyboardCommands();
+     *             const myCommands = [{ command: 'myApp.search', keys: 'Ctrl+K' }];
+     *             return [
+     *                 ...myCommands,
+     *                 ...manifestCommands
+     *             ];
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     * ```
+     */
+    getKeyboardCommands(): OpenFin_2.ShortcutOverride[];
     /**
      * Method that is called every time an error occurs when processing an action in the Platform Provider. It is meant to be overriden, as a means to debug Platform applications
      */
@@ -13552,7 +13594,7 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     }>;
     'destroy-view': IdentityCall;
     'attach-view': IdentityCall<{
-        target: OpenFin_2.Identity;
+        target: OpenFin_2.Identity | OpenFin_2.LayoutIdentity;
     }>;
     'set-view-bounds': IdentityCall<{
         bounds: OpenFin_2.Bounds;
@@ -15355,13 +15397,15 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      * * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
      * * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
      * * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
+     * * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
      * @example
      * ```js
      * const clearCacheOptions = {
      *     appcache: true,
      *     cache: true,
      *     cookies: true,
-     *     localStorage: true
+     *     localStorage: true,
+     *     windowState: true
      * };
      * fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
      * ```
@@ -15386,12 +15430,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      *
      * @param options - Optional configuration for what data to clear
      *
+     * @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
+     * After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
+     *
      * @example
      * ```js
      * // Clear only cookies and localStorage for a specific origin
      * await fin.System.clearCacheData({
      *     dataTypes: ['cookies', 'localStorage'],
-     *     origins: ['http://localhost:8081']
+     *     origins: ['http://localhost:8081'],
+     *     windowState: true
      * });
      *
      * // Clear everything except for a specific origin
@@ -17859,7 +17907,7 @@ declare class View_2 extends WebContents<OpenFin_2.ViewEvent> {
      * ```
      * @experimental
      */
-    attach: (target: OpenFin_2.Identity) => Promise<void>;
+    attach: (target: OpenFin_2.Identity | OpenFin_2.LayoutIdentity) => Promise<void>;
     /**
      * Destroys the current view
      *
@@ -18317,7 +18365,7 @@ declare type ViewCreationFailure = {
 declare type ViewCreationOptions = Partial<ViewOptions> & {
     name: string;
     url: string;
-    target: Identity_4;
+    target: Identity_4 | LayoutIdentity;
 };
 
 declare type ViewCreationOrReference = OpenFin_2.Identity | OpenFin_2.PlatformViewCreationOptions;

package/out/stub.js

@@ -5170,13 +5170,15 @@ class System extends EmitterBase {
      * * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
      * * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
      * * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
+     * * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
      * @example
      * ```js
      * const clearCacheOptions = {
      *     appcache: true,
      *     cache: true,
      *     cookies: true,
-     *     localStorage: true
+     *     localStorage: true,
+     *     windowState: true
      * };
      * fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
      * ```
@@ -5205,12 +5207,16 @@ class System extends EmitterBase {
      *
      * @param options - Optional configuration for what data to clear
      *
+     * @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
+     * After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
+     *
      * @example
      * ```js
      * // Clear only cookies and localStorage for a specific origin
      * await fin.System.clearCacheData({
      *     dataTypes: ['cookies', 'localStorage'],
-     *     origins: ['http://localhost:8081']
+     *     origins: ['http://localhost:8081'],
+     *     windowState: true
      * });
      *
      * // Clear everything except for a specific origin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/core",
-  "version": "45.100.71",
+  "version": "45.100.72",
   "description": "The core renderer entry point of OpenFin",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "out/stub.js",