Skip to content

Commit 13f6c6e

Browse files
Revert openfin
1 parent 28c6f6d commit 13f6c6e

11 files changed

Lines changed: 277 additions & 201 deletions

File tree

types/openfin/_v2/api/application/application.d.ts

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -96,16 +96,16 @@ export interface RvmLaunchOptions {
9696
* [spellCheck=false]
9797
* Enable spell check at the application level.
9898
*
99-
* [url="about:blank"]
99+
* @property {string} [url="about:blank"]
100100
* The url to the application (specifically the application's main window).
101101
*
102-
* uuid
102+
* @property {string} uuid
103103
* The _Unique Universal Identifier_ (UUID) of the application, unique within the set of all other applications
104104
* running in the OpenFin Runtime.
105105
*
106106
* Note that `name` and `uuid` must match.
107107
*
108-
* [webSecurity=true]
108+
* @property {boolean} [webSecurity=true]
109109
* When set to `false` it will disable the same-origin policy for the app.
110110
*/
111111
/**

types/openfin/_v2/api/external-window/external-window.d.ts

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@ export default class ExternalWindowModule extends Base {
3030
* They are also compatible with OpenFin's Layouts service to facilitate
3131
* complete positional control over all running applications.<br>
3232
* External Windows has the ability to listen for <a href="tutorial-ExternalWindow.EventEmitter.html"> external window-specific events</a>.
33+
* @class
3334
* @alias ExternalWindow
3435
* @hideconstructor
3536
*/
@@ -60,7 +61,7 @@ export declare class ExternalWindow extends EmitterBase<ExternalWindowEvents> {
6061
/**
6162
* Gives focus to the external window.
6263
* @return {Promise.<void>}
63-
* @fires ExternalWindow#focused
64+
* @emits ExternalWindow#focused
6465
* @experimental
6566
* @tutorial Window.focus
6667
*/
@@ -214,6 +215,7 @@ export declare class ExternalWindow extends EmitterBase<ExternalWindowEvents> {
214215
setAsForeground(): Promise<void>;
215216
/**
216217
* Sets the external window's size and position.
218+
* @property { Bounds } bounds
217219
* @return {Promise.<void>}
218220
* @experimental
219221
* @tutorial Window.setBounds

types/openfin/_v2/api/platform/platform-provider.d.ts

Lines changed: 30 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -3,54 +3,64 @@ import { OverrideCallback } from '../../shapes/Platform';
33
export default function initConstructor(environment: Environment): (userOverrideFn: OverrideCallback<any>) => Promise<void>;
44
/**
55
* ApplySnapshotOptions interface
6-
* [closeExistingWindows=false] When true, applySnapshot will close existing windows,
6+
* @typedef { object } ApplySnapshotOptions
7+
* @property { boolean } [closeExistingWindows=false] When true, applySnapshot will close existing windows,
78
* replacing current Platform state with the given snapshot.
8-
* [skipOutOfBoundsCheck=false] When true, applySnapshot will not check whether any windows in a
9+
* @property { boolean } [skipOutOfBoundsCheck=false] When true, applySnapshot will not check whether any windows in a
910
* snapshot are off-screen. By default, such windows will be repositioned to be on-screen,
1011
* as defined by {@link PlatformProvider#positionOutOfBoundsWindows PlatformProvider.positionOutOfBoundsWindows}.
1112
*/
1213
/**
1314
* Payload sent to Platform Provider when {@link Platform#applySnapshot Platform.applySnapshot} is called.
14-
* snapshot The snapshot to be applied.
15-
* [options] Options to customize snapshot application.
15+
* @typedef { object } ApplySnapshotPayload
16+
* @property { Snapshot } snapshot The snapshot to be applied.
17+
* @property { ApplySnapshotOptions } [options] Options to customize snapshot application.
1618
*/
1719
/**
1820
* CreateViewPayload interface
19-
* opts Options for the view to be added.
20-
* [target] Window the view will be added to. If no target is provided, a new window will be created.
21+
* @typedef { object } CreateViewPayload
22+
* @property { View~options } opts Options for the view to be added.
23+
* @property { Identity } [target] Window the view will be added to. If no target is provided, a new window will be created.
2124
*/
2225
/**
2326
* CloseViewPayload interface
24-
* target View to be closed.
27+
* @typedef { object } CloseViewPayload
28+
* @property { Identity } target View to be closed.
2529
*/
2630
/**
2731
* ReplaceLayoutOpts interface
28-
* layout Layout config to be applied.
32+
* @typedef { object } ReplaceLayoutOpts
33+
* @property { LayoutConfig } layout Layout config to be applied.
2934
*/
3035
/**
3136
* ReplaceLayoutPayload interface
32-
* opts Object containing the layout to be applied.
33-
* target Identity of the window whose layout will be replace.
37+
* @typedef { object } ReplaceLayoutPayload
38+
* @property { ReplaceLayoutOpts } opts Object containing the layout to be applied.
39+
* @property { Identity } target Identity of the window whose layout will be replace.
3440
*/
3541
/**
3642
* SetWindowContextPayload interface
37-
* context The requested context update.
38-
* entityType Entity type of the target of the context update ('view' or 'window').
39-
* target Identity of the entity targeted by the call to {@link Platform#setWindowContext Platform.setWindowContext}.
43+
* @typedef { object } SetWindowContextPayload
44+
* @property { any } context The requested context update.
45+
* @property { EntityType } entityType Entity type of the target of the context update ('view' or 'window').
46+
* @property { Identity } target Identity of the entity targeted by the call to {@link Platform#setWindowContext Platform.setWindowContext}.
4047
*/
4148
/**
4249
* SetWindowContextPayload interface
43-
* context The requested context update.
44-
* entityType Entity type of the target of the context update ('view' or 'window').
45-
* target Identity of the entity targetted by the call to {@link Platform#setWindowContext Platform.setWindowContext}.
50+
* @typedef { object } SetWindowContextPayload
51+
* @property { any } context The requested context update.
52+
* @property { EntityType } entityType Entity type of the target of the context update ('view' or 'window').
53+
* @property { Identity } target Identity of the entity targetted by the call to {@link Platform#setWindowContext Platform.setWindowContext}.
4654
*/
4755
/**
4856
* GetWindowContextPayload interface
49-
* entityType Entity type of the target of the context update ('view' or 'window').
50-
* target Identity of the entity targeted by the call to {@link Platform#getWindowContext Platform.getWindowContext}.
57+
* @typedef { object } GetWindowContextPayload
58+
* @property { EntityType } entityType Entity type of the target of the context update ('view' or 'window').
59+
* @property { Identity } target Identity of the entity targeted by the call to {@link Platform#getWindowContext Platform.getWindowContext}.
5160
*/
5261
/**
5362
* HostContextChangedPayload interface
54-
* context The new context object
55-
* reason The reason for the update: 'updated' or 'reparented'
63+
* @typedef { object } HostContextChangedPayload
64+
* @property { any } context The new context object
65+
* @property { string } reason The reason for the update: 'updated' or 'reparented'
5666
*/

types/openfin/_v2/api/system/system.d.ts

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -221,10 +221,10 @@ export interface ServiceIdentifier {
221221
* peakNonPagedPoolUsage The peak nonpaged pool usage in bytes
222222
* peakPagedPoolUsage The peak paged pool usage in bytes
223223
* peakPagefileUsage The peak value in bytes of pagefileUsage during the lifetime of this process
224-
* peakWorkingSetSize The peak working set size in bytes
225-
* processId The native process identifier
226-
* uuid The application UUID
227-
* workingSetSize The current working set size (both shared and private data) in bytes
224+
* @property { number } peakWorkingSetSize The peak working set size in bytes
225+
* @property { number } processId The native process identifier
226+
* @property { string } uuid The application UUID
227+
* @property { number } workingSetSize The current working set size (both shared and private data) in bytes
228228
*/
229229
/**
230230
* ProxyConfig interface

types/openfin/_v2/api/view/view.d.ts

Lines changed: 32 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -81,58 +81,59 @@ export default class ViewModule extends Base {
8181
*
8282
* [bounds] initial bounds
8383
*
84-
* [backgroundColor="#FFF"] - _Updatable._
84+
* @property {string} [backgroundColor="#FFF"] - _Updatable._
8585
* The view’s _backfill_ color as a hexadecimal value. Not to be confused with the content background color
8686
* (`document.body.style.backgroundColor`),
8787
* this color briefly fills a view’s (a) content area before its content is loaded as well as (b) newly exposed
8888
* areas when growing a window. Setting
8989
* this value to the anticipated content background color can help improve user experience.
9090
* Default is white.
9191
*
92-
* [contentNavigation]
92+
* @property {object} [contentNavigation]
9393
* Restrict navigation to URLs that match a whitelisted pattern.
9494
* In the lack of a whitelist, navigation to URLs that match a blacklisted pattern would be prohibited.
9595
* See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
96-
* [contentNavigation.whitelist=[]] List of whitelisted URLs.
97-
* [contentNavigation.blacklist=[]] List of blacklisted URLs.
96+
* @property {string[]} [contentNavigation.whitelist=[]] List of whitelisted URLs.
97+
* @property {string[]} [contentNavigation.blacklist=[]] List of blacklisted URLs.
9898
*
99-
* [contextMenuSettings] - _Updatable._
99+
* @property {object} [contextMenuSettings] - _Updatable._
100100
* Configure the context menu when right-clicking on a view.
101-
* [contextMenuSettings.enable=true] Should the context menu display on right click.
102-
* [contextMenuSettings.devtools=true] Should the context menu contain a button for opening devtools.
103-
* [contextMenuSettings.reload=true] Should the context menu contain a button for reloading the page.
101+
* @property {boolean} [contextMenuSettings.enable=true] Should the context menu display on right click.
102+
* @property {boolean} [contextMenuSettings.devtools=true] Should the context menu contain a button for opening devtools.
103+
* @property {boolean} [contextMenuSettings.reload=true] Should the context menu contain a button for reloading the page.
104104
*
105-
* [customData=""] - _Updatable._
105+
* @property {any} [customData=""] - _Updatable._
106106
* A field that the user can attach serializable data to to be ferried around with the view options.
107107
* _When omitted, the default value of this property is the empty string (`""`)._
108108
*
109109
* When omitted, the default value of this property is the empty string (`""`).
110110
* As opposed to customData this is meant for frequent updates and sharing with other contexts. [Example]{@tutorial customContext}
111111
*
112-
* [hotkeys=[]] - _Updatable._
112+
* @property {object[]} [hotkeys=[]] - _Updatable._
113113
* Defines the list of hotkeys that will be emitted as a `hotkey` event on the view. For usage example see [example]{@tutorial hotkeys}.
114114
* Within Platform, OpenFin also implements a set of pre-defined actions called
115115
* [keyboard commands]{@link https://developers.openfin.co/docs/platform-api#section-5-3-using-keyboard-commands}
116116
* that can be assigned to a specific hotkey in the platform manifest.
117-
* [hotkeys.keys] The key combination of the hotkey, i.e. "Ctrl+T"
118-
* [hotkeys.preventDefault=false] preventDefault will prevent the page keydown/keyup events from being emitted.
117+
* @property {string} hotkeys.keys The key combination of the hotkey, i.e. "Ctrl+T"
118+
* @property {boolean} [hotkeys.preventDefault=false] preventDefault will prevent the page keydown/keyup events from being emitted.
119119
*
120-
* [name]
120+
* @property {string} name
121121
* The name of the view.
122-
* [preloadScripts] - _Inheritable_
122+
123+
* @property {preloadScript[]} [preloadScripts] - _Inheritable_
123124
* A list of scripts that are eval'ed before other scripts in the page. When omitted, _inherits_
124125
* from the parent application.
125126
*
126-
* [[processAffinity=<application uuid>]
127+
* @property {string} [processAffinity=<application uuid>]
127128
* A string to attempt to group renderers together. Will only be used if pages are on the same origin.
128129
*
129-
* [target]
130+
* @property {Identity} [target]
130131
* The identity of the window this view should be attached to.
131132
*
132-
* [[url="about:blank"]
133+
* @property {string} [url="about:blank"]
133134
* The URL of the view.
134135
*
135-
* [[uuid=<application uuid>]
136+
* @property {string} [uuid=<application uuid>]
136137
* The `uuid` of the application, unique within the set of all `Application`s running in OpenFin Runtime.
137138
* If omitted, defaults to the `uuid` of the application spawning the view.
138139
* If given, must match the `uuid` of the application spawning the view.
@@ -158,6 +159,7 @@ export declare class View extends WebContents<ViewEvents> {
158159
* Gets a base64 encoded image of the view or a part of it.
159160
* @function capturePage
160161
* @param { CapturePageOptions } [options] Options for the capturePage call.
162+
* @memberOf View
161163
* @instance
162164
* @return {Promise.<string>}
163165
* @tutorial View.capturePage
@@ -167,6 +169,7 @@ export declare class View extends WebContents<ViewEvents> {
167169
* applications you have created.
168170
* @param { string } code JavaScript code to be executed on the view.
169171
* @function executeJavaScript
172+
* @memberOf View
170173
* @instance
171174
* @return {Promise.<void>}
172175
* @tutorial View.executeJavaScript
@@ -187,6 +190,7 @@ export declare class View extends WebContents<ViewEvents> {
187190
/**
188191
* Returns the zoom level of the view.
189192
* @function getZoomLevel
193+
* @memberOf View
190194
* @instance
191195
* @return {Promise.<number>}
192196
* @tutorial View.getZoomLevel
@@ -195,6 +199,7 @@ export declare class View extends WebContents<ViewEvents> {
195199
* Sets the zoom level of the view.
196200
* @param { number } level The zoom level
197201
* @function setZoomLevel
202+
* @memberOf View
198203
* @instance
199204
* @return {Promise.<void>}
200205
* @tutorial View.setZoomLevel
@@ -204,6 +209,7 @@ export declare class View extends WebContents<ViewEvents> {
204209
* @param { string } searchTerm Term to find in page
205210
* @param { FindInPageOptions } options Search options
206211
* @function findInPage
212+
* @memberOf View
207213
* @instance
208214
* @return {Promise.<number>}
209215
* @tutorial View.findInPage
@@ -216,6 +222,7 @@ export declare class View extends WebContents<ViewEvents> {
216222
* "keepSelection" - Translate the selection into a normal selection.<br>
217223
* "activateSelection" - Focus and click the selection node.<br>
218224
* @function stopFindInPage
225+
* @memberOf View
219226
* @instance
220227
* @return {Promise.<void>}
221228
* @tutorial View.stopFindInPage
@@ -233,27 +240,31 @@ export declare class View extends WebContents<ViewEvents> {
233240
/**
234241
* Navigates the view back one page.
235242
* @function navigateBack
243+
* @memberOf View
236244
* @instance
237245
* @return {Promise.<void>}
238246
* @tutorial View.navigateBack
239247
*/
240248
/**
241249
* Navigates the view forward one page.
242250
* @function navigateForward
251+
* @memberOf View
243252
* @instance
244253
* @return {Promise.<void>}
245254
* @tutorial View.navigateForward
246255
*/
247256
/**
248257
* Stops any current navigation the view is performing.
249258
* @function stopNavigation
259+
* @memberOf View
250260
* @instance
251261
* @return {Promise.<void>}
252262
* @tutorial View.stopNavigation
253263
*/
254264
/**
255265
* Reloads the view current page
256266
* @function reload
267+
* @memberOf View
257268
* @instance
258269
* @return {Promise.<void>}
259270
* @tutorial View.reload
@@ -262,20 +273,23 @@ export declare class View extends WebContents<ViewEvents> {
262273
* Prints the view's web page
263274
* @param { PrintOptions } [options] Printer Options
264275
* @function print
276+
* @memberOf View
265277
* @instance
266278
* @return {Promise.<void>}
267279
* @tutorial View.print
268280
*/
269281
/**
270282
* Returns an array with all system printers
271283
* @function getPrinters
284+
* @memberOf View
272285
* @instance
273286
* @return { Promise.Array.<PrinterInfo> }
274287
* @tutorial View.getPrinters
275288
*/
276289
/**
277290
* Shows the Chromium Developer Tools
278291
* @function showDeveloperTools
292+
* @memberOf View
279293
* @instance
280294
* @return {Promise.<void>}
281295
* @tutorial View.showDeveloperTools

0 commit comments

Comments
 (0)