clickgo 6.7.2 → 6.8.0

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/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

@@ -439,8 +439,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 +457,7 @@ export declare function showCircular(x: number, y: number): void;
 /**
  * --- 移动矩形到新位置 ---
  * @param border 显示的位置代号
+ * @returns 无返回值
  */
 export declare function moveRectangle(border: lDom.TDomBorderCustom): void;
 /**