clickgo 6.7.2 → 6.8.1

package/dist/lib/control.d.ts

@@ -438,6 +438,8 @@ export interface IIconviewOpenEvent {
 }
 export interface IIconviewDropEvent {
     'detail': {
+        /** --- 原始松手指针事件，可读取 Ctrl/Shift/Alt；Pointer.js 1.8.0 起提供 --- */
+        'event'?: PointerEvent;
         'self': boolean;
         'from': Array<{
             'index': number;
@@ -466,6 +468,73 @@ export interface IIconviewSelectEvent {
         };
     };
 }
+/** --- 桌面图标；位置和选择使用稳定 ID，不依赖数据顺序 --- */
+export interface IDesktopItem {
+    'id': string;
+    'name': string;
+    'icon'?: string;
+    /** --- 通用文件拖拽路径，由应用解释和执行操作 --- */
+    'path'?: string;
+    /** --- 0: 文件夹，1: 文件 --- */
+    'type'?: 0 | 1;
+    /** --- 禁止用户拖动；区域变化时仍可自动调整位置 --- */
+    'locked'?: boolean;
+}
+/** --- 相对控件内边缘的物理像素坐标，RTL 下也不镜像 --- */
+export interface IDesktopPosition {
+    'x': number;
+    'y': number;
+}
+/** --- 图标 ID 到位置的映射，可独立保存和恢复 --- */
+export type TDesktopPositions = Record<string, IDesktopPosition>;
+/** --- 布局变化的来源 --- */
+export type TDesktopLayoutReason = 'data' | 'positions' | 'resize' | 'options' | 'arrange' | 'drag';
+/** --- 用户选择完成后的通知，属性同步不触发 --- */
+export interface IDesktopSelectEvent {
+    'detail': {
+        'value': string[];
+    };
+}
+/** --- 双击、Enter 或溢出菜单请求打开图标 --- */
+export interface IDesktopOpenEvent {
+    'detail': {
+        'value': string[];
+    };
+}
+/** --- 自动重排或用户拖动完成后的布局快照 --- */
+export interface IDesktopLayoutEvent {
+    'detail': {
+        'positions': TDesktopPositions;
+        /** --- 持久化位置，窗口临时缩小时不被覆盖 --- */
+        'preferredPositions': TDesktopPositions;
+        'overflow': string[];
+        'reason': TDesktopLayoutReason;
+    };
+}
+/** --- 未放入区域的图标 ID 发生变化；数据和已有位置仍保留 --- */
+export interface IDesktopOverflowEvent {
+    'detail': {
+        'value': string[];
+    };
+}
+/** --- 文件拖入桌面或目录，文件操作由应用决定 --- */
+export interface IDesktopDropEvent {
+    'detail': {
+        /** --- 原始松手指针事件，可读取 Ctrl/Shift/Alt；Pointer.js 1.8.0 起提供 --- */
+        'event'?: PointerEvent;
+        'self': boolean;
+        'from': Array<{
+            'id'?: string;
+            'index': number;
+            'type': -1 | 0 | 1;
+            'path': string;
+            'name'?: string;
+            'icon'?: string;
+        }>;
+        'to': IDesktopItem | null;
+        'position': IDesktopPosition;
+    };
+}
 export interface ILevelselectLevelEvent {
     'detail': {
         'list': Array<{

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/dom.d.ts

@@ -199,23 +199,36 @@ export declare function isWatch(el: HTMLElement): boolean;
  * @param taskId 任务 id
  */
 export declare function clearWatch(taskId: lCore.TCurrent): void;
+/** --- 样式变化通知回调 --- */
+type TWatchStyleCallback = (name: string, value: string, old: string) => void | Promise<void>;
 /**
  * --- 监听一个标签的计算后样式的变化 ---
  * @param el 对象
  * @param name 样式名
  * @param cb 变更回调
  * @param immediate 是否立刻执行一次
+ * @returns 无返回值
  */
-export declare function watchStyle(el: HTMLElement, name: string | string[], cb: (name: string, value: string, old: string) => void | Promise<void>, immediate?: boolean): void;
+export declare function watchStyle(el: HTMLElement, name: string | string[], cb: TWatchStyleCallback, immediate?: boolean): void;
+/**
+ * --- 取消元素的样式监听，可只移除指定属性或指定回调 ---
+ * @param el 要取消监听的元素，移出页面后仍可取消
+ * @param name 样式名，留空则匹配全部属性
+ * @param cb 只移除此回调，留空则移除匹配属性的全部回调
+ * @returns 无返回值
+ */
+export declare function unwatchStyle(el: HTMLElement, name?: string | string[], cb?: TWatchStyleCallback): void;
 /**
  * --- 检测一个标签是否正在被 watchStyle ---
  * @param el 要检测的标签
+ * @returns 是否有属于该元素的样式监听
  */
 export declare function isWatchStyle(el: HTMLElement): boolean;
 /**
  * --- 清除某个窗体的所有 watch style 监视 ---
  * @param formId 窗体 id
  * @param panelId 若指定则只清除当前窗体的某个 panel 的 watch
+ * @returns 无返回值
  */
 export declare function clearWatchStyle(formId: string, panelId?: string): void;
 /**
@@ -434,3 +447,4 @@ export interface IGetWatchInfoResult {
         };
     }>>;
 }
+export {};

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>;
     /** --- 任务结束事件 --- */
@@ -439,8 +473,10 @@ export declare function changeFocusMaxZIndex(): Promise<void>;
 /**
  * --- 根据 border 方向 获取理论窗体大小 ---
  * @param border 显示的位置代号
+ * @param area 布局区域，默认避开任务栏
+ * @returns 对应区域内的窗体矩形
  */
-export declare function getRectByBorder(border: lDom.TDomBorderCustom): {
+export declare function getRectByBorder(border: lDom.TDomBorderCustom, area?: lCore.IAvailArea): {
     'width': number;
     'height': number;
     'left': number;
@@ -455,6 +491,7 @@ export declare function showCircular(x: number, y: number): void;
 /**
  * --- 移动矩形到新位置 ---
  * @param border 显示的位置代号
+ * @returns 无返回值
  */
 export declare function moveRectangle(border: lDom.TDomBorderCustom): void;
 /**
@@ -474,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 字符串