clickgo 6.8.0 → 6.8.1

package/dist/lib/core.d.ts

@@ -69,6 +69,40 @@ export declare abstract class AbstractApp {
     onFormShowInSystemTaskChange(taskId: string, formId: string, value: boolean): void | Promise<void>;
     /** --- 窗体的 formHash 改变事件 --- */
     onFormHashChange(taskId: string, formId: string, value: string, data: Record<string, any>): void | Promise<void>;
+    /**
+     * --- 托盘注册通知；通过 task.getTrayList(this) 读取快照 ---
+     * @param taskId 所属任务
+     * @param trayId 托盘 ID
+     * @returns 无返回值
+     */
+    onTrayCreated(taskId: string, trayId: string): void | Promise<void>;
+    /**
+     * --- 托盘数据变更通知 ---
+     * @param taskId 所属任务
+     * @param trayId 托盘 ID
+     * @returns 无返回值
+     */
+    onTrayChanged(taskId: string, trayId: string): void | Promise<void>;
+    /**
+     * --- 托盘删除通知 ---
+     * @param taskId 所属任务
+     * @param trayId 托盘 ID
+     * @returns 无返回值
+     */
+    onTrayRemoved(taskId: string, trayId: string): void | Promise<void>;
+    /**
+     * --- 自己的托盘左键点击，只投递到所属任务 ---
+     * @param trayId 托盘 ID
+     * @returns 无返回值
+     */
+    onTrayClick(trayId: string): void | Promise<void>;
+    /**
+     * --- 自己的托盘菜单命令，只投递到所属任务 ---
+     * @param trayId 托盘 ID
+     * @param menuId 菜单命令
+     * @returns 无返回值
+     */
+    onTrayMenuClick(trayId: string, menuId: string): void | Promise<void>;
     /** --- 任务开始事件 --- */
     onTaskStarted(taskId: string): void | Promise<void>;
     /** --- 任务结束事件 --- */
@@ -169,6 +203,8 @@ export declare function init(): void;
 export interface IConfig {
     'locale': string;
     ['task.position']: 'left' | 'right' | 'top' | 'bottom';
+    ['task.mode']: 'bar' | 'dock';
+    ['task.margin']: number;
     ['task.pin']: Record<string, {
         'name': string;
         'icon': string;
@@ -202,7 +238,7 @@ export interface IAvailArea {
     'oheight': number;
 }
 /** --- 全局事件类型 --- */
-export type TGlobalEvent = 'error' | 'screenResize' | 'configChanged' | 'formCreated' | 'formRemoved' | 'formTitleChanged' | 'formIconChanged' | 'formStateMinChanged' | 'formStateMaxChanged' | 'formShowChanged' | 'formFocused' | 'formBlurred' | 'formFlash' | 'formShowInSystemTaskChange' | 'formHashChange' | 'taskStarted' | 'taskEnded' | 'launcherFolderNameChanged' | 'hashChanged' | 'keydown' | 'keyup';
+export type TGlobalEvent = 'trayCreated' | 'trayChanged' | 'trayRemoved' | 'error' | 'screenResize' | 'configChanged' | 'formCreated' | 'formRemoved' | 'formTitleChanged' | 'formIconChanged' | 'formStateMinChanged' | 'formStateMaxChanged' | 'formShowChanged' | 'formFocused' | 'formBlurred' | 'formFlash' | 'formShowInSystemTaskChange' | 'formHashChange' | 'taskStarted' | 'taskEnded' | 'launcherFolderNameChanged' | 'hashChanged' | 'keydown' | 'keyup';
 /** --- 现场下载 app 的参数 --- */
 export interface ICoreFetchAppOptions {
     'notify'?: number | {

package/dist/lib/form.d.ts

@@ -286,6 +286,40 @@ export declare abstract class AbstractForm extends AbstractCommon {
     onFormShowInSystemTaskChange(taskId: string, formId: string, value: boolean): void | Promise<void>;
     /** --- 窗体的 formHash 改变事件 --- */
     onFormHashChange(taskId: string, formId: string, value: string, data: Record<string, any>): void | Promise<void>;
+    /**
+     * --- 托盘注册通知；通过 task.getTrayList(this) 读取快照 ---
+     * @param taskId 所属任务
+     * @param trayId 托盘 ID
+     * @returns 无返回值
+     */
+    onTrayCreated(taskId: string, trayId: string): void | Promise<void>;
+    /**
+     * --- 托盘数据变更通知 ---
+     * @param taskId 所属任务
+     * @param trayId 托盘 ID
+     * @returns 无返回值
+     */
+    onTrayChanged(taskId: string, trayId: string): void | Promise<void>;
+    /**
+     * --- 托盘删除通知 ---
+     * @param taskId 所属任务
+     * @param trayId 托盘 ID
+     * @returns 无返回值
+     */
+    onTrayRemoved(taskId: string, trayId: string): void | Promise<void>;
+    /**
+     * --- 自己的托盘左键点击，只投递到所属任务 ---
+     * @param trayId 托盘 ID
+     * @returns 无返回值
+     */
+    onTrayClick(trayId: string): void | Promise<void>;
+    /**
+     * --- 自己的托盘菜单命令，只投递到所属任务 ---
+     * @param trayId 托盘 ID
+     * @param menuId 菜单命令
+     * @returns 无返回值
+     */
+    onTrayMenuClick(trayId: string, menuId: string): void | Promise<void>;
     /** --- 任务开始事件 --- */
     onTaskStarted(taskId: string): void | Promise<void>;
     /** --- 任务结束事件 --- */
@@ -477,6 +511,11 @@ export declare function hideRectangle(): void;
  * @param type 样式，可留空
  */
 export declare function alert(content: string, type?: 'default' | 'primary' | 'info' | 'warning' | 'danger' | 'cg'): number;
+/**
+ * --- 按当前可用区域和实际高度重新排列通知 ---
+ * @returns 无返回值
+ */
+export declare function refreshNotifyPosition(): void;
 /**
  * --- 弹出右下角信息框 ---
  * @param opt timeout 默认 5 秒，最大 10 分钟

package/dist/lib/task.d.ts

@@ -6,6 +6,65 @@ import * as lControl from './control';
  * @param id 系统级 ID
  */
 export declare function initSysId(id: string): void;
+/** --- 当前注册的系统任务栏 --- */
+export declare let systemTaskInfo: ISystemTaskInfo;
+/** --- 托盘菜单命令；separator 项只显示分隔线 --- */
+export interface ITrayMenuItem {
+    'id': string;
+    'label': string;
+    'disabled'?: boolean;
+    'separator'?: boolean;
+}
+/** --- 托盘注册数据；包内图标请用 /package/ 开头的路径 --- */
+export interface ITrayOptions {
+    'icon': string;
+    'tip'?: string;
+    'menu'?: ITrayMenuItem[];
+}
+/** --- 提供给任务栏的托盘快照，icon 已解析为跨任务可用的 URL --- */
+export interface ITrayInfo {
+    'id': string;
+    'taskId': string;
+    'icon': string;
+    'tip': string;
+    'menu': ITrayMenuItem[];
+}
+/**
+ * --- 注册托盘；不依赖当前是否存在任务栏 ---
+ * @param current 所属任务
+ * @param options 图标、提示和菜单
+ * @returns 托盘 ID，任务已结束时返回 false
+ */
+export declare function createTray(current: lCore.TCurrent, options: ITrayOptions): Promise<string | false>;
+/**
+ * --- 更新自己的托盘；并发图标更新以最后发起的一次为准 ---
+ * @param current 所属任务
+ * @param id 托盘 ID
+ * @param options 要修改的字段
+ * @returns 是否仍拥有该托盘
+ */
+export declare function updateTray(current: lCore.TCurrent, id: string, options: Partial<ITrayOptions>): Promise<boolean>;
+/**
+ * --- 删除自己的托盘 ---
+ * @param current 所属任务
+ * @param id 托盘 ID
+ * @returns 是否删除
+ */
+export declare function removeTray(current: lCore.TCurrent, id: string): boolean;
+/**
+ * --- 获取托盘快照；系统任务栏/root 可读全部，普通任务只能读自己的 ---
+ * @param current 调用任务
+ * @returns 托盘快照
+ */
+export declare function getTrayList(current: lCore.TCurrent): Record<string, ITrayInfo>;
+/**
+ * --- 当前系统任务栏投递点击/菜单命令到托盘所属 App 和 Form ---
+ * @param current 当前系统任务栏
+ * @param id 托盘 ID
+ * @param menuId 菜单 ID；省略表示左键点击
+ * @returns 是否投递；过期、禁用或非系统任务栏的命令返回 false
+ */
+export declare function activateTray(current: lCore.TCurrent, id: string, menuId?: string): Promise<boolean>;
 /**
  * --- 获取任务的 runtime 数据，仅系统可以获取 ---
  * @param current 当前任务 ID
@@ -147,8 +206,6 @@ export declare function removeTimer(current: lCore.TCurrent, timer: number): voi
  * @param delay 暂停时间
  */
 export declare function sleep(current: lCore.TCurrent, fun: () => void | Promise<void>, delay: number): number;
-/** --- task 的信息 --- */
-export declare let systemTaskInfo: ISystemTaskInfo;
 /**
  * --- 将任务注册为系统 task ---
  * @param taskId task id

package/dist/lib/tool.d.ts

@@ -455,8 +455,10 @@ export declare function stateMachine(code: string, start: number, process: (even
 /**
  * --- 加载脚本 ---
  * @param url 脚本网址
+ * @param ordered 是否按插入顺序执行，下载仍并行，默认 false
+ * @returns 加载是否成功
  */
-export declare function loadScript(url: string): Promise<boolean>;
+export declare function loadScript(url: string, ordered?: boolean): Promise<boolean>;
 /**
  * --- 批量加载 js 文件 ---
  * @param urls js 文件列表
@@ -464,6 +466,8 @@ export declare function loadScript(url: string): Promise<boolean>;
  */
 export declare function loadScripts(urls: string[], opt?: {
     loaded?: (url: string, state: number) => void;
+    /** --- 并行下载并按列表顺序执行，默认 false --- */
+    'ordered'?: boolean;
 }): Promise<void>;
 /**
  * --- 加载 css 文件 ---
@@ -479,6 +483,15 @@ export declare function loadLink(url: string, pos?: 'before' | 'after'): Promise
 export declare function loadLinks(urls: string[], opt?: {
     loaded?: (url: string, state: number) => void;
 }): Promise<void>;
+/**
+ * --- 批量并行加载 JS 和 CSS；JS 按列表顺序执行，CSS 按列表顺序插入 ---
+ * @param urls 资源网址，忽略查询参数和哈希后以 .css 结尾的按 CSS 加载，其余按 JS 加载
+ * @param opt loaded 为单个资源加载完成回调，state 为 1-成功、0-失败
+ * @returns 全部资源成功返回 true，任一资源失败返回 false；空列表返回 true
+ */
+export declare function loadAssets(urls: string[], opt?: {
+    loaded?: (url: string, state: number) => void;
+}): Promise<boolean>;
 /**
  * --- 加载 css 字符串 ---
  * @param style css 字符串