dany/antos-frontend
1
0
Fork 0
mirror of https://github.com/lxsang/antos-frontend.git synced 2024-11-16 01:38:21 +01:00
Code Issues 1 Actions Projects Releases Wiki Activity

fix: doc generation use latest typedoc version
All checks were successful
gitea-sync/antos/pipeline/head This commit looks good
Details

Browse Source
This commit is contained in:
DanyLE 2023-05-30 13:08:30 +02:00
parent edbbc9f248
commit 1db1b11277
24 changed files with 135 additions and 128 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Jenkinsfile vendored
View File

@ -22,11 +22,13 @@ pipeline{
steps {
sh'''
cd $WORKSPACE
[ -d "$WORKSPACE/node_modules" ] && rm -rf "$WORKSPACE/node_modules" || true
npm install terser
npm install uglifycss
npm install typescript
npm install @types/jquery
npm i typedoc@0.19.0
npm i typedoc@0.24
npm i typedoc-plugin-merge-modules
buildir="build"
[ -d "$buildir" ] && rm -rf "$buildir"
export BUILDDIR="$WORKSPACE/$buildir/opt/www/htdocs/os"

6
Makefile
View File

@ -227,8 +227,10 @@ ar:
release: main uglify
.PHONY: doc release clean
doc:
# npm i typedoc@0.19.0
./node_modules/.bin/typedoc --mode file --excludeNotExported --hideGenerator --name "AntOS $(VERSION)-$(BRANCH)-$(BUILDID) API" --out $(DOCDIR)
# npm install typedoc --save-dev
# npm install typedoc-plugin-merge-modules --save-dev
# ./node_modules/.bin/typedoc --mode file --excludeNotExported --hideGenerator --name "AntOS $(VERSION)-$(BRANCH)-$(BUILDID) API" --out $(DOCDIR)
./node_modules/.bin/typedoc --hideGenerator --plugin typedoc-plugin-merge-modules --entryPointStrategy expand --name "AntOS $(VERSION)-$(BRANCH)-$(BUILDID) API" --out $(DOCDIR)
test: build_javascripts
jest

2
src/core/Announcerment.ts
View File

@ -132,7 +132,7 @@ namespace OS {
export class Announcer {
/**
* The observable object that stores event name
* and its corresponding callback in [[ObservableEntryType]]
* and its corresponding callback in {@link ObservableEntryType}
*
* @type {GenericObject<ObservableEntryType>}
* @memberof Announcer

6
src/core/BaseApplication.ts
View File

@ -422,7 +422,7 @@ namespace OS {
* Base menu definition. This function
* returns the based menu definition of all applications.
* Other application specific menu entries
* should be defined in [[menu]] function
* should be defined in {@link menu} function
*
* @protected
* @returns {GUI.BasicItemType[]}
@ -469,7 +469,7 @@ namespace OS {
* Show local toast notification
*
* @param {any} data to send
* @param {GUI.ToastOptions} notification options see [[GUI.ToastOptions]]
* @param {GUI.ToastOptions} notification options see {@link GUI.ToastOptions}
* @returns {void}
* @memberof BaseApplication
*/
@ -495,7 +495,7 @@ namespace OS {
}
/**
* The cleanup function that is called by [[onexit]] function.
* The cleanup function that is called by {@link onexit} function.
* Application need to override this function to perform some
* specific task before exiting or to prevent the application
* to be exited

8
src/core/BaseDialog.ts
View File

@ -250,7 +250,7 @@ namespace OS {
/**
* If the `markup` variable is not provided, then
* the [[init]] function will find the scheme definition
* the {@link init} function will find the scheme definition
* in this class variable
*
* @static
@ -420,10 +420,10 @@ namespace OS {
`;
/**
* A text dialog is similar to a [[PromptDialog]] nut allows
* A text dialog is similar to a {@link PromptDialog} nut allows
* user to input multi-line text.
*
* Refer to [[PromptDialog]] for the definition of input and callback data
* Refer to {@link PromptDialog} for the definition of input and callback data
* of the dialog
*
* @export
@ -565,7 +565,7 @@ namespace OS {
* title: string // window title
* }
* ```
* Callback data: [[ColorType]] object
* Callback data: {@link ColorType} object
*
* @export
* @class ColorPickerDialog

6
src/core/BaseModel.ts
View File

@ -155,7 +155,7 @@ namespace OS {
* to handle all local events inside that model.
*
* This observable object is propagate to all the
* UI elements ([[AFXTag]]) inside the model
* UI elements ({@link OS.GUI.AFXTag}) inside the model
*
* @protected
* @type {API.Announcer}
@ -579,10 +579,10 @@ namespace OS {
}
/**
* Open a [[YesNoDialog]] to confirm a task
* Open a {@link OS.GUI.dialogs.YesNoDialog} to confirm a task
*
* @protected
* @param {GenericObject<any>} data [[YesNoDialog]] input data
* @param {GenericObject<any>} data {@link OS.GUI.dialogs.YesNoDialog} input data
* @returns {Promise<boolean>}
* @memberof BaseModel
*/

2
src/core/BaseService.ts
View File

@ -71,7 +71,7 @@ namespace OS {
/**
* Reference to the timer that periodically executes the callback
* defined in [[watch]].
* defined in {@link watch}.
*
* @private
* @type {number}

50
src/core/core.ts
View File

@ -39,8 +39,8 @@ interface String {
/**
* Parse the current string and convert it
* to an object of type [[Version]] if the string
* is in the format recognized by [[Version]],
* to an object of type {@link OS.Version} if the string
* is in the format recognized by {@link OS.Version},
* e.g.: `1.0.1-a`
*
* @returns {OS.Version}
@ -98,7 +98,7 @@ interface String {
format(...args: any[]): string;
/**
* Create a [[FormattedString]] object using the current
* Create a {@link OS.FormattedString} object using the current
* string and the input parameters
*
* @param {...any[]} args
@ -178,7 +178,7 @@ interface Array<T> {
/**
* Extend the Data prototype with the
* [[timestamp]] function
* {@link timestamp} function
*
* @interface Date
*/
@ -210,7 +210,7 @@ interface GenericObject<T> {
}
/**
* Global function to create a [[FormattedString]] from
* Global function to create a {@link OS.FormattedString} from
* a formatted string and a list of parameters. Example
*
* ```typescript
@ -305,7 +305,7 @@ namespace OS {
/**
* The value of the format pattern represented
* in [[fs]]
* in {@link fs}
*
* @type {any[]}
* @memberof FormattedString
@ -812,13 +812,13 @@ namespace OS {
/**
* Variable represents the current AntOS version, it
* is an instance of [[Version]]
* is an instance of {@link OS.Version}
*/
export const VERSION: Version = new Version(undefined);
/**
* Variable represents the current AntOS source code repository
* is an instance of [[string]]
* is an instance of string
*/
export const REPOSITORY: string = "https://github.com/lxsang/antos";
@ -829,10 +829,10 @@ namespace OS {
/**
* Register a model prototype to the system namespace.
* There are two types of model to be registered, if the model
* is of type [[SubWindow]], its prototype will be registered
* in the [[dialogs]] namespace, otherwise, if the model type
* is [[Application]] or [[Service]], its prototype will be
* registered in the [[application]] namespace.
* is of type {@link OS.GUI.SubWindow}, its prototype will be registered
* in the {@link OS.GUI.dialogs} namespace, otherwise, if the model type
* is {@link OS.application.BaseApplication} or {@link OS.application.BaseService}, its prototype will be
* registered in the {@link application} namespace.
*
* When a model is loaded in the system, its prototype is registered
* for later uses
@ -886,7 +886,7 @@ namespace OS {
/**
* Booting up AntOS. This function checks whether the user
* is successfully logged in, then call [[startAntOS]], otherwise
* is successfully logged in, then call {@link OS.GUI.startAntOS}, otherwise
* it shows the login screen
*
* @export
@ -919,7 +919,7 @@ namespace OS {
/**
* Perform the system shutdown operation. This function calls all
* clean up handles in [[cleanupHandles]], then save the system setting
* clean up handles in {@link cleanupHandles}, then save the system setting
* before exiting
*
* @export
@ -941,7 +941,7 @@ namespace OS {
}
/**
* Register a callback to the system [[cleanupHandles]]
* Register a callback to the system {@link cleanupHandles}
*
* @export
* @param {string} n callback string name
@ -979,7 +979,7 @@ namespace OS {
export interface PackageMetaType {
/**
* The application class name, if the package has only services
* this property is ignored and [[pkgname]] should be specified
* this property is ignored and {@link pkgname} should be specified
*
* @type {string}
* @memberof PackageMetaType
@ -987,7 +987,7 @@ namespace OS {
app?: string;
/**
* Package name, in case of [[app]] being undefined, this property
* Package name, in case of {@link app} being undefined, this property
* need to be specified
*
* @type {string}
@ -1126,7 +1126,7 @@ namespace OS {
/**
* Package version, should be in a format conforming
* to the version definition in [[Version]] class
* to the version definition in {@link Version} class
*
* @type {string}
* @memberof PackageMetaType
@ -1183,7 +1183,7 @@ namespace OS {
export var lang: GenericObject<string> = {};
/**
* Re-export the system announcement [[getMID]] function to the
* Re-export the system announcement {@link OS.announcer.getMID} function to the
* core API
*
* @export
@ -1343,7 +1343,7 @@ namespace OS {
* beginning of a heavy task
*
* @export
* @param {number} q message id, see [[mid]]
* @param {number} q message id, see {@link mid}
* @param {string} p message string
*/
export function loading(q: number, p: string): void {
@ -1526,8 +1526,8 @@ namespace OS {
* Fetch the package meta-data from the server
*
* @export
* @returns {Promise<RequestResult>} Promise on a [[RequestResult]].
* A success request result should contain a list of [[PackageMetaType]]
* @returns {Promise<RequestResult>} Promise on a {@link RequestResult}.
* A success request result should contain a list of {@link PackageMetaType}
*/
export function fetch(): Promise<RequestResult> {
return API.handle.packages({
@ -1573,7 +1573,7 @@ namespace OS {
* Save the current user setting
*
* @export
* @returns {Promise<RequestResult>} promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} promise on a {@link RequestResult}
*/
export function setting(): Promise<RequestResult> {
return API.handle.setting();
@ -1619,7 +1619,7 @@ namespace OS {
* text in spotlight.
*
* This function will call all the search handles stored
* in [[searchHandle]] and build the search result based
* in {@link searchHandle} and build the search result based
* on output of these handle
*
* @export
@ -1644,7 +1644,7 @@ namespace OS {
}
/**
* Register a search handle to the global [[searchHandle]]
* Register a search handle to the global {@link searchHandle}
*
* @export
* @param {string} name handle name string

18
src/core/gui.ts
View File

@ -108,7 +108,7 @@ namespace OS {
/**
* Item children, usually used by tree view or menu item
* This property is keep for compatibility purposes only.
* Otherwise, the [[nodes]] property should be used
* Otherwise, the {@link nodes} property should be used
*
* @type {BasicItemType[]}
* @memberof BasicItemType
@ -146,7 +146,7 @@ namespace OS {
* UI elements, then insert this UI scheme to the DOM tree.
*
* This function renders the UI of the application before calling the
* application's [[main]] function
* application's `main` function
*
* @export
* @param {string} html html scheme string
@ -174,7 +174,7 @@ namespace OS {
/**
* Load an application scheme file then render
* it with [[htmlToScheme]]
* it with {@link htmlToScheme}
*
* @export
* @param {string} path VFS path to the scheme file
@ -294,7 +294,7 @@ namespace OS {
*/
export interface ToastOptions {
/**
* Where the Toast is displayed? see [[ANCHOR]]
* Where the Toast is displayed? see {@link ANCHOR}
*
* @type {ANCHOR}
* @memberof ToastOptions
@ -322,7 +322,7 @@ namespace OS {
/**
* Toast notification API
* Show a toast message on different posisition on screen, see [[ToastOptions]]
* Show a toast message on different posisition on screen, see {@link ToastOptions}
*
* @export
* @param
@ -516,7 +516,7 @@ namespace OS {
/**
* Kill an running processes of an application, then
* unregister the application prototype definition
* from the [[application]] namespace.
* from the {@link application} namespace.
*
* This process is similar to uninstall the application
* from the current system state
@ -569,7 +569,7 @@ namespace OS {
* in the system.
*
* This function fist loads and registers the application prototype
* definition in the [[application]] namespace, then update
* definition in the {@link application} namespace, then update
* the system packages meta-data
*
* First it tries to load the package with the app name is also the
@ -861,7 +861,7 @@ namespace OS {
* Bind a context menu event to an AntOS element.
*
* This will find the fist element which defines a handle
* named [[contextMenuHandle]] and bind the context menu
* named {@link contextMenuHandle} and bind the context menu
* event to it.
*
* @param {JQuery.MouseEventBase} event mouse event
@ -1091,7 +1091,7 @@ namespace OS {
/**
* Show the login screen and perform the login operation.
*
* Once login successfully, the [[startAntOS]] will be called
* Once login successfully, the {@link startAntOS} will be called
*
* @export
*/

34
src/core/handles/RemoteHandle.ts
View File

@ -158,7 +158,7 @@ namespace OS {
*
* @export
* @param {string} p a VFS file path e.g. home://test/
* @returns {Promise<RequestResult>} A promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} A promise on a {@link RequestResult}
* which contains an error or a list of FileInfoType
*/
export function scandir(p: string): Promise<RequestResult> {
@ -203,7 +203,7 @@ namespace OS {
*
* @export
* @param {string} p VFS file path
* @returns {Promise<RequestResult>} A promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} A promise on a {@link RequestResult}
* which contains an error or an object of FileInfoType
*/
export function fileinfo(p: string): Promise<RequestResult> {
@ -226,8 +226,8 @@ namespace OS {
* - xml, html: the response is a XML/HTML object
* - text: plain text
*
* @returns {Promise<any>} A promise on a [[RequestResult]]
* which contains an error or an object of [[FileInfoType]]
* @returns {Promise<any>} A promise on a {@link RequestResult}
* which contains an error or an object of {@link FileInfoType}
*/
export function readfile(p: string, t: string): Promise<any> {
const path = `${API.REST}/VFS/get/`;
@ -240,7 +240,7 @@ namespace OS {
* @export
* @param {string} s VFS source file path
* @param {string} d VFS destination file path
* @returns {Promise<RequestResult>} A promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} A promise on a {@link RequestResult}
* which contains an error or a success response
*/
export function move(s: string, d: string): Promise<RequestResult> {
@ -253,7 +253,7 @@ namespace OS {
*
* @export
* @param {string} p VFS file path
* @returns {Promise<RequestResult>} A promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} A promise on a {@link RequestResult}
* which contains an error or a success response
*/
export function remove(p: string): Promise<RequestResult> {
@ -278,7 +278,7 @@ namespace OS {
*
* @export
* @param {PackageCommandType} d a package command of type PackageCommandType
* @returns {Promise<RequestResult>} a promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} a promise on a {@link RequestResult}
*/
export function packages(
d: PackageCommandType
@ -292,7 +292,7 @@ namespace OS {
*
* @export
* @param {string} d VFS destination directory path
* @returns {Promise<RequestResult>} a promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} a promise on a {@link RequestResult}
*/
export function upload(d: string): Promise<RequestResult> {
const path = `${API.REST}/VFS/upload`;
@ -305,7 +305,7 @@ namespace OS {
* @export
* @param {string} p path to the VFS file
* @param {string} d file data encoded in Base 64
* @returns {Promise<RequestResult>} a promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} a promise on a {@link RequestResult}
*/
export function write(
p: string,
@ -371,8 +371,8 @@ namespace OS {
* Check if a user is logged in
*
* @export
* @returns {Promise<RequestResult>} a promise on a [[RequestResult]] that
* contains an error or a [[UserSettingType]] object
* @returns {Promise<RequestResult>} a promise on a {@link RequestResult} that
* contains an error or a {@link OS.setting.UserSettingType} object
*/
export function auth(): Promise<RequestResult> {
const p = `${API.REST}/user/auth`;
@ -383,9 +383,9 @@ namespace OS {
* Perform a login operation
*
* @export
* @param {UserLoginType} d user data [[UserLoginType]]
* @returns {Promise<RequestResult>} a promise on a [[RequestResult]] that
* contains an error or a [[UserSettingType]] object
* @param {UserLoginType} d user data {@link UserLoginType}
* @returns {Promise<RequestResult>} a promise on a {@link RequestResult} that
* contains an error or a {@link OS.setting.UserSettingType} object
*/
export function login(d: UserLoginType): Promise<RequestResult> {
const p = `${API.REST}/user/login`;
@ -396,7 +396,7 @@ namespace OS {
* Perform a logout operation
*
* @export
* @returns {Promise<RequestResult>} a promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} a promise on a {@link RequestResult}
*/
export function logout(): Promise<RequestResult> {
const p = `${API.REST}/user/logout`;
@ -407,7 +407,7 @@ namespace OS {
* Save the current user settings
*
* @export
* @returns {Promise<RequestResult>} a promise on a [[RequestResult]]
* @returns {Promise<RequestResult>} a promise on a {@link RequestResult}
*/
export function setting(): Promise<RequestResult> {
const p = `${API.REST}/system/settings`;
@ -440,7 +440,7 @@ namespace OS {
* ```
* { table: "table name", cond: [conditional object]}
* ```
* @returns {Promise<RequestResult>} a promise of [[RequestResult]] on the
* @returns {Promise<RequestResult>} a promise of {@link RequestResult} on the
* query data
*
* A conditional object represents a SQL condition statement as an object,

2
src/core/pm.ts
View File

@ -11,7 +11,7 @@ namespace OS {
| application.BaseApplication
| application.BaseService;
/**
* Alias to all classes that extends [[BaseModel]]
* Alias to all classes that extends {@link BaseModel}
*/
export type ModelTypeClass = {
new <T extends BaseModel>(args: AppArgumentsType[]): T;

2
src/core/settings.ts
View File

@ -308,7 +308,7 @@ namespace OS {
/**
* Package repositories setting.
* This configuration is used by [[MarketPlace]]
* This configuration is used by {@link OS.application.MarketPlace}
* for package management
*
* @type {{

2
src/core/tags/CalendarTag.ts
View File

@ -140,7 +140,7 @@ namespace OS {
* This function triggers the date select event
*
* @private
* @param {TagEventType} e AFX tag event data [[TagEventType]]
* @param {TagEventType} e AFX tag event data {@link TagEventType}
* @returns {void}
* @memberof CalendarTag
*/

12
src/core/tags/FileViewTag.ts
View File

@ -167,7 +167,7 @@ namespace OS {
/**
* set the function that allows to fetch file entries.
* This handle function should return a promise on
* an arry of [[API.FileInfoType]]
* an arry of {@link API.FileInfoType}
*
* @memberof FileViewTag
*/
@ -178,7 +178,7 @@ namespace OS {
/**
* set the callback handle for the file select event.
* The parameter of the callback should be an object
* of type [[TagEventType]]<T> with the data type `T` is [[API.FileInfoType]]
* of type {@link TagEventType}<T> with the data type `T` is {@link API.FileInfoType}
*
* @memberof FileViewTag
*/
@ -189,7 +189,7 @@ namespace OS {
/**
* set the callback handle for the directory changed event.
* The parameter of the callback should be an object
* of type [[TagEventType]]<T> with the data type `T` is [[API.VFS.BaseFileHandle]]
* of type {@link TagEventType}<T> with the data type `T` is {@link API.VFS.BaseFileHandle}
*
* @memberof FileViewTag
*/
@ -200,7 +200,7 @@ namespace OS {
/**
set the callback handle for the file open event.
* The parameter of the callback should be an object
* of type [[TagEventType]]<T> with the data type `T` is [[API.FileInfoType]]
* of type {@link TagEventType}<T> with the data type `T` is {@link API.FileInfoType}
*
* @memberof FileViewTag
*/
@ -235,7 +235,7 @@ namespace OS {
*
* Turn on/off the changing current working directory feature
* of the widget when a directory is double clicked. If enabled,
* the widget will use the configured [[fetch]] function to query
* the widget will use the configured {@link fetch} function to query
* the content of the selected directory
*
* Getter:
@ -346,7 +346,7 @@ namespace OS {
*
* Set the path of the current working directory.
* When called the widget will refresh the current
* working directory using the configured [[fetch]]
* working directory using the configured {@link fetch}
* function
*
* Getter:

8
src/core/tags/GridViewTag.ts
View File

@ -229,7 +229,7 @@ namespace OS {
* Setter:
*
* Set the data of the cell, this will trigger
* the [[ondatachange]] function
* the {@link ondatachange} function
*
* Getter:
*
@ -255,7 +255,7 @@ namespace OS {
* Setter:
*
* Set/unset the current cell as selected.
* This will trigger the [[cellselect]]
* This will trigger the {@link cellselect}
* event
*
* Getter:
@ -345,7 +345,7 @@ namespace OS {
/**
* Simple grid cell defines a grid cell with
* an [[LabelTag]] as it cell layout
* an {@link LabelTag} as it cell layout
*
* @export
* @class SimpleGridCellTag
@ -390,7 +390,7 @@ namespace OS {
protected calibrate(): void { }
/**
* The layout of the cell with a simple [[LabelTag]]
* The layout of the cell with a simple {@link LabelTag}
*
* @returns
* @memberof SimpleGridCellTag

10
src/core/tags/ListViewTag.ts
View File

@ -6,7 +6,7 @@ namespace OS {
*/
export type ListItemEventData = TagEventDataType<ListViewItemTag>;
/**
* A list item represent the individual view of an item in the [[ListView]].
* A list item represent the individual view of an item in the {@link OS.GUI.tag.ListViewTag}.
* This class is an abstract prototype class, implementation of any
* list view item should extend it
*
@ -197,7 +197,7 @@ namespace OS {
* Layout definition of the item tag.
* This function define the outer layout of the item.
* Custom inner layout of each item implementation should
* be defined in [[itemlayout]]
* be defined in {@link itemlayout}
*
* @protected
* @returns {TagLayoutType[]}
@ -228,7 +228,7 @@ namespace OS {
* Setter:
*
* Set the data of the list item. This will
* trigger the [[ondatachange]] function
* trigger the {@link ondatachange} function
*
* Getter:
*
@ -523,7 +523,7 @@ namespace OS {
/**
* A collection of selected items in the list.
* The maximum size of this collection is 1 if
* the [[multiselect]] feature is disabled
* the {@link multiselect} feature is disabled
*
* @private
* @type {ListViewItemTag[]}
@ -742,7 +742,7 @@ namespace OS {
* Button layout allows to add some custom
* behaviors to the list.
*
* Each button data should define the [[onbtclick]]
* Each button data should define the {@link OS.GUI.tag.ButtonTag.onbtclick}
* event handle to specify the custom behavior
*
* When the list is configured as dropdown. The buttons

2
src/core/tags/OverlayTag.ts
View File

@ -3,7 +3,7 @@ namespace OS {
export namespace tag {
/**
* An overlay tag is a layout tag that alway stay on top of
* the virtual desktop environment. Tile layout elements ([[VBoxTag]], [[HboxTag]])
* the virtual desktop environment. Tile layout elements ({@link OS.GUI.tag.VBoxTag}, {@link OS.GUI.tag.HBoxTag})
* can be used inside this tag to compose elements
*
* @export

6
src/core/tags/ResizerTag.ts
View File

@ -3,7 +3,7 @@ namespace OS {
export namespace tag {
/**
* A `resizer` tag is basically used to dynamically resize an element using mouse.
* It is usually put inside a [[TileLayoutTag]] an can be attached to any element. Example:
* It is usually put inside a {@link TileLayoutTag} an can be attached to any element. Example:
*
* The resizer tag in the following example will be attached to the first `afx-vbox`,
* and allows to resize this element using mouse
@ -41,8 +41,8 @@ namespace OS {
/**
* Reference to the parent tag of the current tag.
* The parent tag should be an instance of a [[TileLayoutTag]]
* such as [[VBoxTag]] or [[HBoxTag]]
* The parent tag should be an instance of a {@link TileLayoutTag}
* such as {@link VBoxTag} or {@link HBoxTag}
*
* @private
* @type {*}

2
src/core/tags/StackPanelTag.ts
View File

@ -4,7 +4,7 @@ namespace OS {
/**
* A stack pannel allows to navigate back and forth between pannels
* (container widget). Each container widget in the stack should be
* composed inside a [[HBoxTag]]
* composed inside a {@link HBoxTag}
*
*
* @export

4
src/core/tags/TabContainerTag.ts
View File

@ -19,9 +19,9 @@ namespace OS {
}
export namespace tag {
/**
* A tab container allows to attach each tab on a [[TabBarTag]]
* A tab container allows to attach each tab on a {@link TabBarTag}
* with a container widget. The attached container widget should be
* composed inside a [[HBoxTag]]
* composed inside a {@link HBoxTag}
*
* The tab bar in a tab container can be configured to display tabs
* in horizontal (row) or vertical (column) order. Default to vertical order

12
src/core/tags/TreeViewTag.ts
View File

@ -111,7 +111,7 @@ namespace OS {
* Placeholder for the `fetch` function of the node.
* This function is used to fetch the child nodes of the
* current nodes. This function should return a promise on
* a list of [[TreeViewDataType]]
* a list of {@link TreeViewDataType}
*
* @memberof TreeViewItemPrototype
*/
@ -164,7 +164,7 @@ namespace OS {
* Setter:
*
* Set the data of the current node. This will trigger the
* [[ondatachange]] function
* {@link ondatachange} function
*
* Getter:
*
@ -405,7 +405,7 @@ namespace OS {
* Layout definition of a node. This function
* returns the definition of the base outer layout
* of a node. Custom inner layout of the node should
* be defined in the [[itemlayout]] function
* be defined in the {@link itemlayout} function
*
* @protected
* @returns {TagLayoutType[]}
@ -464,8 +464,8 @@ namespace OS {
}
/**
* SimpleTreeViewItem extends [[TreeViewItemPrototype]] and
* define it inner layout using a [[LabelTag]]
* SimpleTreeViewItem extends {@link TreeViewItemPrototype} and
* define it inner layout using a {@link LabelTag}
*
* @export
* @class SimpleTreeViewItem
@ -641,7 +641,7 @@ namespace OS {
* Placeholder for the `fetch` function of the tree.
* This function is used to fetch the child nodes of the
* current tree. This function should return a promise on
* a list of [[TreeViewDataType]]
* a list of {@link TreeViewDataType}
*
* @memberof TreeViewTag
*/

18
src/core/tags/tag.ts
View File

@ -24,7 +24,7 @@ interface HTMLElement {
* defined on any child of this element will be ignored.
*
* @param {JQuery.MouseEventBase} e a mouse event
* @param {OS.GUI.tag.StackMenuTag} m The context menu element [[StackMenuTag]]
* @param {OS.GUI.tag.StackMenuTag} m The context menu element {@link OS.GUI.tag.StackMenuTag}
* @memberof HTMLElement
*/
contextmenuHandle(e: JQuery.MouseEventBase, m: OS.GUI.tag.StackMenuTag): void;
@ -69,7 +69,7 @@ interface HTMLElement {
enable_drag(): void;
/**
* Perform DOM generation ([[afxml]]) then mount ([[sync]]) all the
* Perform DOM generation ({@link afxml}) then mount ({@link sync}) all the
* elements.
*
* @param {OS.API.Announcer} o an AntOS observable object
@ -116,7 +116,7 @@ interface Document {
namespace OS {
export namespace GUI {
/**
* [[TagLayoutType]] interface using by AFX tags to defined
* TagLayoutType interface using by AFX tags to defined
* its internal DOM hierarchy
*
* @export
@ -157,7 +157,7 @@ namespace OS {
/**
* this is the `data-id` attribute of the element,
* can be query by the [[aid]] Tag API function.
* can be query by the {@link OS.GUI.AFXTag.aid} Tag API function.
* Not to be confused with the DOM `id` attribute
*
* @type {(string | number)}
@ -294,7 +294,7 @@ namespace OS {
* Reference to some of the tag's children
* element. This reference object is built
* based on the `ref` property found in the
* tag layout [[TagLayoutType]]
* tag layout {@link TagLayoutType}
*
* @protected
* @type {GenericObject<HTMLElement>}
@ -487,7 +487,7 @@ namespace OS {
/**
* Init the current tag, this function
* is called before the [[mount]] function
* is called before the {@link mount} function
*
* @protected
* @abstract
@ -516,7 +516,7 @@ namespace OS {
/**
* Update only the current tag, this function is
* called by [[update]] before chaining the
* called by {@link update} before chaining the
* update process to its children
*
* @protected
@ -707,7 +707,7 @@ namespace OS {
*/
export namespace tag {
/**
* Alias to all classes that extends [[AFXTag]]
* Alias to all classes that extends {@link AFXTag}
*/
export type AFXTagTypeClass = {
new <T extends AFXTag>(): T;
@ -719,7 +719,7 @@ namespace OS {
* new definition
*
* @export
* @template T all classes that extends [[AFXTag]]
* @template T all classes that extends {@link AFXTag}
* @param {string} name name of the tag
* @param {{ new (): T }} cls the class that defines the tag
* @returns {void}

44
src/core/vfs.ts
View File

@ -21,7 +21,7 @@ interface String {
* Convert a string to VFS file handle.
*
* This function will create a file handle object from the string
* with the help of [[VFS.findHandles]]
* with the help of {@link OS.API.VFS.findHandles}
*
* @returns {OS.API.VFS.BaseFileHandle}
* @memberof String
@ -226,7 +226,7 @@ namespace OS {
*
* When converting a string to file handle, the system will look
* for a protocol pattern in the string, if the protocol found,
* its attached handle class (found in [[VFS.handles]]) will be
* its attached handle class (found in {@link VFS.handles}) will be
* used to initialize a file handle object from the string
*
* ```typescript
@ -322,7 +322,7 @@ namespace OS {
basename: string;
/**
* Once loaded, [[ready]] will be set to true and
* Once loaded, {@link ready} will be set to true and
* file meta-data will be stored in this place holder
*
* @type {FileInfoType}
@ -569,7 +569,7 @@ namespace OS {
/**
* Public read operation
*
* This function calls the [[_rd]] function to perform the operation.
* This function calls the {@link _rd} function to perform the operation.
*
* If the current file is a directory, then the operation
* will return the meta-data of all files inside of the directory.
@ -601,7 +601,7 @@ namespace OS {
/**
* Write the file cache to the actual file
*
* This function calls the [[_wr]] function to perform the operation
* This function calls the {@link _wr} function to perform the operation
*
* @param {string} t data type
* - `base64`
@ -626,7 +626,7 @@ namespace OS {
/**
* Sub-directory creation
*
* This function calls the [[_mk]] function to perform the operation
* This function calls the {@link _mk} function to perform the operation
*
* @param {string} d sub directory name
* @returns {Promise<RequestResult>} promise on the operation result
@ -648,7 +648,7 @@ namespace OS {
/**
* Delete the file
*
* This function calls the [[_rm]] function to perform the operation
* This function calls the {@link _rm} function to perform the operation
* @param {any} d user data
* @returns {Promise<RequestResult>} promise on the operation result
* @memberof BaseFileHandle
@ -671,7 +671,7 @@ namespace OS {
*
* Only work when the current file is a directory
*
* This function calls the [[_up]] function to perform the operation
* This function calls the {@link _up} function to perform the operation
*
* @returns {Promise<RequestResult>} promise on the operation result
* @memberof BaseFileHandle
@ -694,7 +694,7 @@ namespace OS {
*
* Only work with file
*
* This function calls the [[_pub]] function to perform the operation
* This function calls the {@link _pub} function to perform the operation
*
* @returns {Promise<RequestResult>} promise on operation result
* @memberof BaseFileHandle
@ -717,7 +717,7 @@ namespace OS {
*
* Only work with file
*
* This function calls the [[_down]] function to perform the operation
* This function calls the {@link _down} function to perform the operation
*
* @returns {Promise<any>} Promise on the operation result
* @memberof BaseFileHandle
@ -738,7 +738,7 @@ namespace OS {
/**
* Move the current file to another location
*
* This function calls the [[_mv]] function to perform the operation
* This function calls the {@link _mv} function to perform the operation
*
* @param {string} d destination location
* @returns {Promise<RequestResult>} promise on the operation result
@ -763,7 +763,7 @@ namespace OS {
*
* This action depends on each file protocol
*
* This function calls the [[_exec]] function to perform the operation
* This function calls the {@link _exec} function to perform the operation
*
* @returns {Promise<any>}
* @memberof BaseFileHandle
@ -831,7 +831,7 @@ namespace OS {
* that supports the operation
*
* @protected
* @param {any} t data type, see [[read]]
* @param {any} t data type, see {@link read}
* @returns {Promise<RequestResult>}
* @memberof BaseFileHandle
*/
@ -846,7 +846,7 @@ namespace OS {
* that supports the operation
*
* @protected
* @param {string} t data type, see [[write]]
* @param {string} t data type, see {@link write}
* @returns {Promise<RequestResult>}
* @memberof BaseFileHandle
*/
@ -1025,7 +1025,7 @@ namespace OS {
* Otherwise, file content will be returned
*
* @protected
* @param {string} t data type see [[read]]
* @param {string} t data type see {@link read}
* @returns {Promise<any>}
* @memberof RemoteFileHandle
*/
@ -1057,7 +1057,7 @@ namespace OS {
* Write file cache to the remote file
*
* @protected
* @param {string} t data type see [[write]]
* @param {string} t data type see {@link write}
* @returns {Promise<RequestResult>}
* @memberof RemoteFileHandle
*/
@ -1293,7 +1293,7 @@ namespace OS {
/**
* Package file is remote file ([[RemoteFileHandle]]) located either in
* Package file is remote file ({@link RemoteFileHandle}) located either in
* the local user packages location or system packages
* location, it should be in the following format:
*
@ -1596,7 +1596,7 @@ namespace OS {
* Read file content stored in the file cached
*
* @protected
* @param {string} t data type see [[read]]
* @param {string} t data type see {@link read}
* @returns {Promise<any>}
* @memberof BufferFileHandle
*/
@ -1617,7 +1617,7 @@ namespace OS {
* Write data to the file cache
*
* @protected
* @param {string} t data type, see [[write]]
* @param {string} t data type, see {@link write}
* @returns {Promise<RequestResult>}
* @memberof BufferFileHandle
*/
@ -1801,7 +1801,7 @@ namespace OS {
* Read URL content
*
* @protected
* @param {string} t data type see [[read]]
* @param {string} t data type see {@link read}
* @returns {Promise<any>}
* @memberof URLFileHandle
*/
@ -1855,7 +1855,7 @@ namespace OS {
* Read file content
*
* @protected
* @param {string} t data type, see [[read]]
* @param {string} t data type, see {@link read}
* @returns {Promise<any>}
* @memberof SharedFileHandle
*/
@ -1874,7 +1874,7 @@ namespace OS {
* write data to shared file
*
* @protected
* @param {string} t data type, see [[write]]
* @param {string} t data type, see {@link write}
* @returns {Promise<RequestResult>}
* @memberof SharedFileHandle
*/

3
tsconfig.json
View File

@ -8,5 +8,8 @@
],
"outDir": "dist"
},
"typedocOptions": {
"entryPoints": ["src"]
},
"include": ["src/**/*.ts"]
}