clickgo 7.3.2 → 7.4.1

package/dist/lib/control.d.ts

@@ -819,18 +819,28 @@ export interface IFabricObjectchangeEvent {
         'height': number;
     };
 }
-export interface IObjviewerLine {
-    /** -- 可自定义线段的名称 --- */
-    'name'?: string;
-    'start': clickgo.control.IObjviewerLineObj;
-    'end': clickgo.control.IObjviewerLineObj;
-    /** --- 默认 255 --- */
-    'hue'?: string;
-    'path'?: string;
-    /** --- 默认 solid --- */
-    'stroke'?: 'solid' | 'dashed' | 'up' | 'down';
-}
-export interface IObjviewerLineObj {
-    'obj': HTMLElement | AbstractControl;
-    'pos': 'lt' | 't' | 'tr' | 'r' | 'rb' | 'b' | 'bl' | 'l';
+/** --- 节点和连接的语义状态，不依赖主题的具体颜色 --- */
+export type TObjviewerStatus = 'default' | 'online' | 'warning' | 'offline';
+/** --- 按稳定节点 ID 声明的连接，节点暂不存在时不绘制，不保存 DOM 引用 --- */
+export interface IObjviewerEdge {
+    'source': string;
+    'target': string;
+    'label'?: string;
+    /** --- 默认 default，连接状态由应用明确提供 --- */
+    'status'?: TObjviewerStatus;
+    /** --- 默认 none，dash 为流动虚线，dots 为静止底线上的移动圆点 --- */
+    'animation'?: 'none' | 'dash' | 'dots';
+    /** --- 默认 forward，沿 source 到 target；reverse 反向，both 双向 --- */
+    'direction'?: 'forward' | 'reverse' | 'both';
+    /** --- 动画周期，单位秒，默认 3，限制为 0.25–60；dots 为走完整条路径的时间 --- */
+    'duration'?: number;
+    /** --- dots 模式每个方向的圆点数，默认 3，取整并限制为 1–8 --- */
+    'dotCount'?: number;
+}
+/** --- 节点选择事件，仅通知选择，不在控件内执行业务跳转 --- */
+export interface IObjviewerSelectEvent {
+    'detail': {
+        'nodeId': string;
+        'label': string;
+    };
 }

package/dist/lib/tool.d.ts

@@ -21,19 +21,33 @@ export type { TTextEncoding, ITextEncoding, IDecodedText } from './tool/encoding
  * @returns 模块对象
  */
 export declare function runIife(code: string): any;
-/**
- * --- 压缩一个图片 ---
- * @param file 文件或 blob 类型 ---
- * @param options 参数
- */
-export declare function compressor<T extends File | Blob>(file: T, options?: {
+/** --- 图片压缩参数，未指定大小上限时仅使用第一档质量 --- */
+export interface ICompressorOptions {
     /** --- 最大宽度，默认无限 --- */
     'maxWidth'?: number;
     /** --- 最高高度，默认无限 --- */
     'maxHeight'?: number;
-    /** --- 压缩质量，默认 0.8 --- */
-    'quality'?: number;
-}): Promise<T | false>;
+    /** --- 编码质量，取值 0 至 1，默认 0.8；数组按顺序尝试，仅 JPEG/WebP 支持调节质量 --- */
+    'quality'?: number | readonly number[];
+    /** --- 输出格式，默认 auto 保留压缩器的自动选择；JPEG 的透明区域填白 --- */
+    'mimeType'?: 'auto' | 'image/jpeg' | 'image/png' | 'image/webp';
+    /** --- 文件大小上限，单位字节，须为正有限数；各档都超限时返回 false，不再额外缩小尺寸或降质 --- */
+    'maxSize'?: number;
+}
+/**
+ * --- 压缩图片，质量降档复用同一画布，保留方向校正及等比缩放 ---
+ * @param file 图片文件或 Blob；File 输入返回 File，转换格式时同步扩展名和 MIME 类型
+ * @param options 压缩参数
+ * @returns 压缩后的图片；参数无效、加载或编码失败、指定格式不受支持或无法满足大小上限时返回 false
+ * @example
+ * const image = await clickgo.tool.compressor(file, {
+ *     'mimeType': 'image/jpeg',
+ *     'maxWidth': 2000,
+ *     'quality': [0.9, 0.6, 0.5],
+ *     'maxSize': 2 * 1024 * 1024,
+ * });
+ */
+export declare function compressor<T extends File | Blob>(file: T, options?: ICompressorOptions): Promise<T | false>;
 /** --- 类原型信息 --- */
 export interface IClassPrototype {
     /** --- 方法列表，key 为方法名，value 为函数体，例如：{'method1': function() { ... }} --- */