clickgo 4.2.0 → 5.0.0

package/dist/lib/control.d.ts

@@ -89,7 +89,7 @@ export declare abstract class AbstractControl {
      * --- 判断当前事件可否执行 ---
      * @param e 鼠标、触摸、键盘事件
      */
-    allowEvent(e: MouseEvent | TouchEvent | KeyboardEvent): boolean;
+    allowEvent(e: PointerEvent | KeyboardEvent): boolean;
     /**
      * --- 触发系统方法 ---
      * @param name 方法名

package/dist/lib/core.d.ts

@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import * as mpegts from 'mpegts.js';
 import * as clickgo from '../clickgo';
 import * as lForm from './form';
 import * as lControl from './control';
@@ -92,9 +93,9 @@ export declare function trigger(name: TGlobalEvent, taskId?: string | boolean |
 export declare function readApp(blob: Blob): Promise<false | IApp>;
 /**
  * --- 从网址下载应用 ---
- * @param url 对于当前网页的相对、绝对路径，以 .cga 结尾的文件 ---
- * @param opt,notifyId:显示进度条的 notify id,current:设置则以设置的为准，不以 / 结尾，否则以 location 为准 ---
  * @param taskId 所属任务 ID
+ * @param url 对于当前网页的相对、绝对路径，以 .cga 结尾的文件
+ * @param opt 选项
  */
 export declare function fetchApp(taskId: string, url: string, opt?: ICoreFetchAppOptions): Promise<null | IApp>;
 /**
@@ -103,7 +104,7 @@ export declare function fetchApp(taskId: string, url: string, opt?: ICoreFetchAp
 export declare function getAvailArea(): IAvailArea;
 /**
  * --- 修改浏览器 hash ---
- * @param taskId 当前任务 id
+ * @param current 当前任务 id
  * @param hash 修改的值，不含 #
  */
 export declare function hash(current: TCurrent, hash: string): Promise<boolean>;
@@ -139,8 +140,7 @@ export declare function open(url: string): void;
  * --- 注册模块 ---
  * @param current 当前任务 id
  * @param name 模块名
- * @param func 执行加载函数
- * @param version 版本号，非 ESM 可留空
+ * @param opt 选项
  */
 export declare function regModule(current: TCurrent, name: string, opt: {
     /** --- ESM 模式必填 --- */
@@ -154,6 +154,7 @@ export declare function regModule(current: TCurrent, name: string, opt: {
  */
 export declare function checkModule(name: string): boolean;
 export declare function getModule(name: 'tums-player'): Promise<ITumsPlayer | null>;
+export declare function getModule(name: 'mpegts'): Promise<typeof mpegts.default | null>;
 export declare function getModule(name: string): Promise<any | null>;
 /**
  * --- 加载模块，返回 true / false ---

package/dist/lib/dom.d.ts

@@ -38,10 +38,6 @@ export declare function setGlobalCursor(type?: string): void;
  * @param enable 是否启用
  */
 export declare function setGlobalTransition(enable: boolean): void;
-/**
- * --- 判断当前的事件是否是含有 touch 的设备触发的，如果当前就是 touch 则直接返回 false（false 代表 OK，true 代表 touch 设备却触发了 mouse 事件） ---
- */
-export declare function hasTouchButMouse(e: MouseEvent | TouchEvent | PointerEvent): boolean;
 /**
  * --- 创建任务时连同一起创建的 style 标签 ---
  * @param taskId 任务 id
@@ -136,10 +132,10 @@ export declare function clearWatchSize(taskId: lCore.TCurrent): void;
 export declare function getWatchCount(taskId?: string): number;
 /**
  * --- 添加 DOM 内容变化监视 ---
- * @param current 当前任务 id
+ * @param current 当前任务
  * @param el dom 对象
  * @param cb 回调
- * @param mode 监听模式
+ * @param mode 监听模式，默认 default
  */
 export declare function watch(current: lCore.TCurrent, el: HTMLElement, cb: (mutations: MutationRecord[]) => void | Promise<void>, mode?: 'child' | 'childsub' | 'style' | 'text' | 'default', immediate?: boolean): boolean;
 /**
@@ -197,69 +193,7 @@ export declare function isWatchProperty(el: HTMLElement): boolean;
  */
 export declare function clearWatchProperty(formId: string, panelId?: string): void;
 export declare function getWatchInfo(): IGetWatchInfoResult;
-/**
- * --- 鼠标/手指没移动时，click 才生效 ---
- * @param e 事件对象
- * @param handler 回调
- */
-export declare function bindClick(e: MouseEvent | TouchEvent, handler: (e: MouseEvent | TouchEvent, x: number, y: number) => void | Promise<void>): void;
-/**
- * --- 相当于鼠标/手指两次 click 的效果，并且两次位置差别不太大，dblclick 才生效 ---
- * @param e 事件对象
- * @param handler 回调
- */
-export declare function bindDblClick(e: MouseEvent | TouchEvent, handler: (e: MouseEvent | TouchEvent, x: number, y: number) => void | Promise<void>): void;
-/**
- * --- 绑定按下以及弹起事件，touch 和 mouse 只会绑定一个 ---
- * @param oe MouseEvent | TouchEvent
- * @param opt 回调选项
- */
-export declare function bindDown<T extends MouseEvent | TouchEvent>(oe: T, opt: IBindDownOptions<T>): void;
-/**
- * --- 绑定缩放，要绑定到 mousedown、touchstart、touchmove、touchend、wheel 上 ---
- * @param oe 触发的时间
- * @param handler 回调函数
- */
-export declare function bindScale(oe: MouseEvent | TouchEvent | WheelEvent, handler: (e: MouseEvent | TouchEvent | WheelEvent, scale: number, cpos: {
-    'x': number;
-    'y': number;
-}) => void | Promise<void>): void;
-/**
- * --- 绑定上拉、下拉、左拉、右拉 ---
- * @param oe 响应事件
- * @param before before 事件，返回 1 则显示 gesture，0 则不处理（可能会向上传递事件），-1 则 stopPropagation（本层可拖动，若实际不可拖动则可能导致浏览器页面滚动）
- * @param handler 执行完毕的话才会回调
- */
-export declare function bindGesture(oe: MouseEvent | TouchEvent | WheelEvent, before: (e: MouseEvent | TouchEvent | WheelEvent, dir: 'top' | 'right' | 'bottom' | 'left') => number, handler?: (dir: 'top' | 'right' | 'bottom' | 'left') => void | Promise<void>): void;
-export declare function allowEvent(e: MouseEvent | TouchEvent | KeyboardEvent): boolean;
-/**
- * --- 绑定长按事件 ---
- * @param e 事件原型
- * @param long 回调
- */
-export declare function bindLong(e: MouseEvent | TouchEvent, long: (e: MouseEvent | TouchEvent) => void | Promise<void>): void;
-/**
- * --- 重新绑定 drag 数据 ---
- * @param data 要绑定的数据
- */
-export declare function setDragData(data?: string | number | boolean | Record<string, any>): void;
-/**
- * --- 绑定拖动 ---
- * @param e 鼠标事件
- * @param opt 参数
- */
-export declare function bindDrag(e: MouseEvent | TouchEvent, opt: {
-    'el': HTMLElement;
-    'data'?: any;
-    'start'?: (x: number, y: number) => any;
-    'move'?: (e: MouseEvent | TouchEvent, opt: IBindMoveMoveOptions) => void;
-    'end'?: (moveTimes: Array<{
-        'time': number;
-        'ox': number;
-        'oy': number;
-    }>, e: MouseEvent | TouchEvent) => void;
-}): void;
-/** --- 目前是否已绑定了 bindMove --- */
+/** --- 相关状态 --- */
 export declare let is: {
     'move': boolean;
     'shift': boolean;
@@ -274,18 +208,6 @@ export declare let is: {
     /** --- 动画开启状态 --- */
     'transition': boolean;
 };
-/**
- * --- 绑定拖动事件 ---
- * @param e mousedown 或 touchstart 的 event
- * @param opt 回调选项
- */
-export declare function bindMove(e: MouseEvent | TouchEvent, opt: IBindMoveOptions): IBindMoveResult;
-/**
- * --- 绑定拖动改变大小事件 ---
- * @param e mousedown 或 touchstart 的 event
- * @param opt 选项，width, height 当前对象宽高
- */
-export declare function bindResize(e: MouseEvent | TouchEvent, opt: IBindResizeOptions): void;
 /**
  * --- 通过 data 名查找上层所有标签是否存在 ---
  * @param el 当前标签
@@ -410,85 +332,6 @@ export interface IDomSize {
     'scrollWidth': number;
     'scrollHeight': number;
 }
-/** --- 绑定鼠标事件选项 --- */
-export interface IBindDownOptions<T extends MouseEvent | TouchEvent> {
-    'down'?: (e: T) => void;
-    'start'?: (e: T) => any;
-    'move'?: (e: T, dir: 'top' | 'right' | 'bottom' | 'left') => any;
-    'up'?: (e: T) => void | Promise<void>;
-    'end'?: (e: T) => void | Promise<void>;
-}
-/** --- 绑定拖动选项 move 回调的回调参数 --- */
-export interface IBindMoveMoveOptions {
-    'ox': number;
-    'oy': number;
-    'x': number;
-    'y': number;
-    'border': TDomBorder;
-    'inBorder': {
-        'top': boolean;
-        'right': boolean;
-        'bottom': boolean;
-        'left': boolean;
-    };
-    'dir': 'top' | 'right' | 'bottom' | 'left';
-}
-/** --- 绑定拖动选项 --- */
-export interface IBindMoveOptions {
-    'areaObject'?: HTMLElement | lCore.IVue;
-    'left'?: number;
-    'top'?: number;
-    'right'?: number;
-    'bottom'?: number;
-    'offsetLeft'?: number;
-    'offsetTop'?: number;
-    'offsetRight'?: number;
-    'offsetBottom'?: number;
-    'objectLeft'?: number;
-    'objectTop'?: number;
-    'objectWidth'?: number;
-    'objectHeight'?: number;
-    'object'?: HTMLElement | lCore.IVue;
-    'showRect'?: boolean;
-    'cursor'?: string;
-    'start'?: (x: number, y: number) => any;
-    'move'?: (e: MouseEvent | TouchEvent, opt: IBindMoveMoveOptions) => void;
-    'up'?: (moveTimes: Array<{
-        'time': number;
-        'ox': number;
-        'oy': number;
-    }>, e: MouseEvent | TouchEvent) => void;
-    'end'?: (moveTimes: Array<{
-        'time': number;
-        'ox': number;
-        'oy': number;
-    }>, e: MouseEvent | TouchEvent) => void;
-    'borderIn'?: (x: number, y: number, border: TDomBorder, e: MouseEvent | TouchEvent) => void;
-    'borderOut'?: () => void;
-}
-/** --- 绑定拖动返回值 --- */
-export interface IBindMoveResult {
-    'left': number;
-    'top': number;
-    'right': number;
-    'bottom': number;
-}
-/** --- 绑定改变大小选项 --- */
-export interface IBindResizeOptions {
-    'objectLeft'?: number;
-    'objectTop'?: number;
-    'objectWidth'?: number;
-    'objectHeight'?: number;
-    'object'?: HTMLElement | lCore.IVue;
-    'minWidth'?: number;
-    'minHeight'?: number;
-    'maxWidth'?: number;
-    'maxHeight'?: number;
-    'border': TDomBorder;
-    'start'?: (x: number, y: number) => any;
-    'move'?: (left: number, top: number, width: number, height: number, x: number, y: number, border: TDomBorder) => void;
-    'end'?: () => void;
-}
 /** --- 监视位置中的元素 --- */
 export interface IWatchPositionItem {
     'el': HTMLElement;

package/dist/lib/form.d.ts

@@ -54,7 +54,7 @@ declare abstract class AbstractCommon {
      * --- 判断当前事件可否执行 ---
      * @param e 鼠标、触摸、键盘事件
      */
-    allowEvent(e: MouseEvent | TouchEvent | KeyboardEvent): boolean;
+    allowEvent(e: PointerEvent | KeyboardEvent): boolean;
     /**
      * --- 触发系统方法 ---
      * @param name 方法名
@@ -255,8 +255,6 @@ export declare const elements: {
     'popList': HTMLDivElement;
     'circular': HTMLDivElement;
     'rectangle': HTMLDivElement;
-    'gesture': HTMLDivElement;
-    'drag': HTMLDivElement;
     'keyboard': HTMLDivElement;
     'notify': HTMLElement;
     'alert': HTMLElement;
@@ -287,16 +285,16 @@ export declare function max(formId: string): boolean;
  */
 export declare function close(formId: string): boolean;
 /**
- * --- 绑定窗体拖动大小事件，在 mousedown、touchstart 中绑定 ---
+ * --- 绑定窗体拖动大小事件，在 pointerdown 中绑定 ---
  * @param e 事件源
  * @param border 调整大小的方位
  */
-export declare function bindResize(e: MouseEvent | TouchEvent, border: lDom.TDomBorder): void;
+export declare function bindResize(e: PointerEvent, border: lDom.TDomBorder): void;
 /**
- * --- 绑定窗体拖动事件，在 mousedown、touchstart 中绑定 ---
+ * --- 绑定窗体拖动事件，在 pointerdown 中绑定 ---
  * @param e 事件源
  */
-export declare function bindDrag(e: MouseEvent | TouchEvent): void;
+export declare function bindDrag(e: PointerEvent): void;
 /**
  *  --- 重置所有已经最大化的窗体大小和位置 ---
  */
@@ -413,22 +411,6 @@ export declare function showRectangle(x: number, y: number, border: lDom.TDomBor
  * --- 结束时请隐藏矩形 ---
  */
 export declare function hideRectangle(): void;
-/**
- * --- 显示 drag 虚拟框 ---
- */
-export declare function showDrag(opt?: {
-    /** --- 传入要拖动的对象，让系统仿照他的圆角等形象 --- */
-    'element'?: HTMLElement;
-}): void;
-/**
- * --- 移动 drag 到新位置 ---
- * @param opt top:顶部位置,left:左侧位置,width:宽度位置,height:高度位置
- */
-export declare function moveDrag(opt: IMoveDragOptions): void;
-/**
- * --- 隐藏拖拽框框 ---
- */
-export declare function hideDrag(): void;
 /**
  * --- 从下方弹出 alert ---
  * @param content 内容
@@ -475,7 +457,7 @@ export declare function removeFromPop(el: HTMLElement): void;
  * @param direction 要显示方向（以 $el 为准的 h 水平 v 垂直 t 垂直水平居中）或坐标
  * @param opt width / height 显示的 pop 定义自定义宽/高度，可省略；null，true 代表为空也会显示，默认为 false; autoPosition, 因 pop 内部内容变动导致的自动更新 pop 位置，默认 false，autoScroll，因原元素位置变更导致 pop 位置变更，默认 false，flow: 是否加入 pop 流，默认加入，不加入的话将不会自动隐藏
  */
-export declare function showPop(el: HTMLElement | lCore.IVue, pop: HTMLElement | lCore.IVue | undefined, direction: 'h' | 'v' | 't' | MouseEvent | TouchEvent | {
+export declare function showPop(el: HTMLElement | lCore.IVue, pop: HTMLElement | lCore.IVue | undefined, direction: 'h' | 'v' | 't' | PointerEvent | {
     x: number;
     y: number;
 }, opt?: {
@@ -497,10 +479,10 @@ export declare function hidePop(pop?: HTMLElement | lCore.IVue): void;
 /** --- 检测 pop 是不是刚刚显示的 --- */
 export declare function isJustPop(el: HTMLElement | number): boolean;
 /**
- * --- 点下 (mousedown / touchstart) 屏幕任意一位置时根据点击处处理隐藏 pop 和焦点丢失事件，鼠标和 touch 只会响应一个 ---
+ * --- 点下 pointerdown 屏幕任意一位置时根据点击处处理隐藏 pop 和焦点丢失事件，鼠标和 touch 只会响应一个 ---
  * @param e 事件对象
  */
-export declare function doFocusAndPopEvent(e: MouseEvent | TouchEvent): Promise<void>;
+export declare function doFocusAndPopEvent(e: PointerEvent): Promise<void>;
 /**
  * --- 移除一个 form（关闭窗口） ---
  * @param formId 要移除的 form id
@@ -564,7 +546,7 @@ export declare function confirm(current: lCore.TCurrent, opt: string | IFormConf
 export declare function prompt(current: lCore.TCurrent, opt: string | IFormPromptOptions): Promise<string>;
 /**
  * --- 让窗体闪烁 ---
- * @param taskId 所属的 taskId
+ * @param current 所属的 taskId
  * @param formId 要闪烁的窗体 id，必填
  */
 export declare function flash(current: lCore.TCurrent, formId: string): Promise<void>;

package/dist/lib/fs.d.ts

@@ -45,7 +45,7 @@ export declare function putContent(current: lCore.TCurrent, path: string, data:
  * --- 读取链接的 target ---
  * @param current 当前任务 id
  * @param path 要读取的路径
- * @param options 选项
+ * @param encoding 编码
  */
 export declare function readLink(current: lCore.TCurrent, path: string, encoding?: BufferEncoding): Promise<string | null>;
 /**

package/dist/lib/task.d.ts

@@ -16,7 +16,7 @@ export declare function getRuntime(current: lCore.TCurrent, taskId: string): IRu
 export declare function getOriginList(current: lCore.TCurrent): Promise<Record<string, ITask>>;
 /**
  * --- 获取任务简略信息 ---
- * @param tid 任务 id
+ * @param taskId 任务 id
  */
 export declare function get(taskId: lCore.TCurrent): ITaskInfo | null;
 /**

package/dist/lib/tool.d.ts

@@ -32,8 +32,11 @@ export declare function compressor<T extends File | Blob>(file: T, options?: {
     /** --- 压缩质量，默认 0.8 --- */
     'quality'?: number;
 }): Promise<T | false>;
-interface IClassPrototype {
+/** --- 类原型信息 --- */
+export interface IClassPrototype {
+    /** --- 方法列表，key 为方法名，value 为函数体，例如：{'method1': function() { ... }} --- */
     'method': Record<string, any>;
+    /** --- 访问器列表，key 为属性名，value 为包含 get 和 set 的对象，例如：{'prop1': { 'get': function() { ... }, 'set': function(v) { ... } }} --- */
     'access': Record<string, {
         'get': any;
         'set': any;
@@ -123,7 +126,7 @@ export declare function layoutInsertAttr(layout: string, insert: string, opt?: {
  */
 export declare function layoutClassPrepend(layout: string, preps: string[]): string;
 /**
- * --- 对 layout 的 @events 事件进行包裹 ---
+ * --- 对 layout 的 events 事件进行包裹 ---
  * @param layout 要包裹的 layout
  */
 export declare function eventsAttrWrap(layout: string): string;
@@ -218,7 +221,11 @@ export declare function hex2rgb(hex: string): {
 };
 /**
  * --- rgb 字符串转 hsl 数组 ---
- * @param rgb rgb(x, x, x) 或直接 x,x,x
+ * @param r r 值或 rgb(x, x, x) 或直接 x,x,x
+ * @param g g 值
+ * @param b b 值
+ * @param a a 值
+ * @param decimal 是否保留小数
  */
 export declare function rgb2hsl(r: string | number, g?: string | number, b?: string | number, a?: string | number, decimal?: boolean): {
     'h': number;
@@ -229,7 +236,11 @@ export declare function rgb2hsl(r: string | number, g?: string | number, b?: str
 };
 /**
  * --- hsl 字符串转 rgb 数组 ---
- * @param hsl hsl(x, x, x) 或直接 x,x,x
+ * @param h h 值或 hsl(x, x, x) 或直接 x,x,x
+ * @param s s 值
+ * @param l l 值
+ * @param a a 值
+ * @param decimal 是否保留小数
  */
 export declare function hsl2rgb(h: string | number, s?: string | number, l?: string | number, a?: string | number, decimal?: boolean): {
     'r': number;
@@ -528,4 +539,3 @@ export interface IRequestOptions {
 }
 /** --- 虚假值类型 --- */
 export type TFalsy = false | '' | 0 | null | undefined | typeof NaN;
-export {};

package/dist/lib/zip.d.ts

@@ -26,7 +26,6 @@ export declare class Zip {
     /**
      * --- 获取对象是否存在，存在则返回 stats 对象，否则返回 null ---
      * @param path 对象路径
-     * @param options 选项
      */
     stats(path: string): IZipStats | null;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clickgo",
-  "version": "4.2.0",
+  "version": "5.0.0",
   "description": "Background interface, software interface, mobile phone APP interface operation library.",
   "type": "module",
   "keywords": [
@@ -13,23 +13,30 @@
   "license": "Apache-2.0",
   "types": "./dist/clickgo.d.ts",
   "scripts": {
+    "sass": "sass --watch dist/:dist/ --style compressed --no-source-map",
     "native": "electron ./dist/test/native",
     "native2": "electron ./dist/test/native/index2",
-    "native3": "electron ./dist/test/native/index3"
+    "native3": "electron ./dist/test/native/index3",
+    "build-doc": "bash ./utils/build-doc.sh"
   },
   "devDependencies": {
     "@litert/eslint-plugin-rules": "^0.3.1",
+    "@litert/pointer": "^1.6.0",
     "@types/clean-css": "^4.2.11",
-    "@types/node": "^24.3.0",
+    "@types/google.maps": "^3.58.1",
+    "@types/node": "^25.0.3",
     "clean-css": "^5.3.3",
-    "commander": "^14.0.0",
+    "commander": "^14.0.2",
     "compressorjs": "^1.2.1",
     "echarts": "^6.0.0",
-    "electron": "^37.4.0",
+    "electron": "^39.2.7",
     "jszip": "^3.10.1",
-    "rollup": "^4.50.0",
-    "terser": "^5.44.0",
-    "typescript": "^5.9.2",
-    "vue": "^3.5.21"
+    "mpegts.js": "^1.8.0",
+    "rollup": "^4.54.0",
+    "terser": "^5.44.1",
+    "typedoc": "^0.28.15",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "typescript": "^5.9.3",
+    "vue": "^3.5.26"
   }
 }