clickgo 3.1.3-dev12 → 3.1.5-dev14

package/types/index.d.ts

@@ -83,7 +83,7 @@ export interface IAvailArea {
 }
 
 /** --- 全局事件类型 --- */
-export type TGlobalEvent = 'error' | 'screenResize' | 'configChanged' | 'formCreated' | 'formRemoved' | 'formTitleChanged' | 'formIconChanged' | 'formStateMinChanged' | 'formStateMaxChanged' | 'formShowChanged' | 'formFocused' | 'formBlurred' | 'formFlash' | 'taskStarted' | 'taskEnded' | 'launcherFolderNameChanged';
+export type TGlobalEvent = 'error' | 'screenResize' | 'configChanged' | 'formCreated' | 'formRemoved' | 'formTitleChanged' | 'formIconChanged' | 'formStateMinChanged' | 'formStateMaxChanged' | 'formShowChanged' | 'formFocused' | 'formBlurred' | 'formFlash' | 'taskStarted' | 'taskEnded' | 'launcherFolderNameChanged' | 'hashChanged';
 
 /** --- 现场下载 app 的参数 --- */
 export interface ICoreFetchAppOptions {
@@ -99,7 +99,7 @@ export interface IApp {
     'config': IAppConfig;
     /** --- 所有已加载的文件内容 --- */
     'files': Record<string, Blob | string>;
-    /** --- 应用图标，net 模式下可能为空 --- */
+    /** --- 应用图标 --- */
     'icon': string;
 }
 
@@ -119,7 +119,7 @@ export interface IAppConfig {
     /** --- 将自动加载的主题 --- */
     'themes'?: string[];
     /** --- 将自动申请的权限 --- */
-    'permissions'?: Record<string, any>;
+    'permissions'?: string[];
     /** --- 将自动加载的语言包，path: lang --- */
     'locales'?: Record<string, string>;
     /** --- 全局样式，不带扩展名，系统会在末尾添加 .css --- */
@@ -129,6 +129,8 @@ export interface IAppConfig {
 
     /** --- 将要加载的非 js 文件列表，打包为 cga 模式下此配置可省略 --- */
     'files'?: string[];
+    /** --- import 的目录映射关系 --- */
+    'map'?: Record<string, string>;
 }
 
 // -------------------------
@@ -284,58 +286,68 @@ export interface IFormInfo {
     'focus': boolean;
 }
 
-/** --- 窗体创建选项 --- */
-export interface IFormCreateOptions {
-    'code'?: IFormCreateCode;
-    'layout': string;
-    'style'?: string;
-
-    /** --- 当前窗体的基准路径，不以 / 结尾，仅用作传值，App 内无法填写 --- */
-    'path'?: string;
-    /** --- 传递到 onMounted 的数据 --- */
-    'data'?: Record<string, any>;
-    /** --- APP 内无法填写 --- */
-    'taskId'?: number;
-}
-
-/** --- 窗体的 code 参数 --- */
-export interface IFormCreateCode {
-    'data'?: Record<string, any>;
-    'access'?: Record<string, any>;
-    'methods'?: Record<string, any>;
-    'computed'?: Record<string, {
-        'get'?: any;
-        'set'?: any;
-    }>;
-    'beforeCreate'?: any;
-    'created'?: any;
-    'beforeMount'?: any;
-    'mounted'?: any;
-    'beforeUpdate'?: any;
-    'updated'?: any;
-    'beforeUnmount'?: any;
-    'unmounted'?: any;
-}
-
 // --------------------------
 // --------- fs lib ---------
 // --------------------------
 
+export interface IMountHandler {
+    'taskId'?: number;
+    getContent?: (path: string, options?: BufferEncoding | {
+        'encoding'?: BufferEncoding;
+        'start'?: number;
+        'end'?: number;
+        'files'?: Record<string, Blob | string>;
+        'current'?: string;
+        'progress'?: (loaded: number, total: number) => void | Promise<void>;
+    }) => Promise<Blob | string | null>;
+    putContent?: (path: string, data: string | Blob, options?: {
+        'encoding'?: BufferEncoding | null;
+        'mode'?: string | number;
+        'flag'?: string | number;
+        'current'?: string;
+    }) => Promise<boolean>;
+    readLink?: (path: string, options?: BufferEncoding | {
+        'encoding'?: BufferEncoding;
+        /** --- 不以 / 结尾的路径 --- */
+        'current'?: string;
+    }) => Promise<string | null>;
+    symlink?: (filePath: string, linkPath: string, options?: {
+        'type'?: 'dir' | 'file' | 'junction';
+        'current'?: string;
+    }) => Promise<boolean>;
+    unlink?: (path: string, options?: {
+        'current'?: string;
+    }) => Promise<boolean>;
+    stats: (path: string, options?: {
+        'files'?: Record<string, Blob | string>;
+        'current'?: string;
+    }) => Promise<IStats | null>;
+    mkdir: (path: string, mode?: number, options?: {
+        'current'?: string;
+    }) => Promise<boolean>;
+    rmdir: (path: string, options?: {
+        'current'?: string;
+    }) => Promise<boolean>;
+    chmod: (path: string, mod: string | number, options?: {
+        'current'?: string;
+    }) => Promise<boolean>;
+}
+
 /** --- 文件/文件夹信息对象 --- */
 export interface IStats {
     isFile(): boolean;
     isDirectory(): boolean;
     isSymbolicLink(): boolean;
-    size: number;
-    blksize: number;
-    atimeMs: number;
-    mtimeMs: number;
-    ctimeMs: number;
-    birthtimeMs: number;
-    atime: Date;
-    mtime: Date;
-    ctime: Date;
-    birthtime: Date;
+    'size': number;
+    'blksize': number;
+    'atimeMs': number;
+    'mtimeMs': number;
+    'ctimeMs': number;
+    'birthtimeMs': number;
+    'atime': Date;
+    'mtime': Date;
+    'ctime': Date;
+    'birthtime': Date;
 }
 
 /** --- 目录下项目 ---  */
@@ -343,7 +355,7 @@ export interface IDirent {
     isFile(): boolean;
     isDirectory(): boolean;
     isSymbolicLink(): boolean;
-    name: string;
+    'name': string;
 }
 
 // --------------------------
@@ -370,7 +382,7 @@ export interface ITask {
         /** --- 独占窗体序列 --- */
         'dialogFormIds': number[];
         /** --- 已申请的权限列表 --- */
-        'permissions': Record<string, any>;
+        'permissions': string[];
     };
     /** --- 窗体对象列表 --- */
     'forms': Record<string, IForm>;
@@ -403,8 +415,10 @@ export interface ITaskRunOptions {
     'notify'?: boolean;
     /** --- 所属任务，App 模式无法设置 --- */
     'taskId'?: number;
-    /** --- 不禁止某些浏览器对象，App 模式下无法设置 --- */
+    /** --- 不禁止某些浏览器对象，App 模式下仅能设置基任务中已经 unblock 的值 --- */
     'unblock'?: string[];
+    /** --- 直接赋予此任务相应权限，App 模式下有 "root" 权限的应用才能设置 --- */
+    'permissions'?: string[];
 }
 
 export interface ICreateTimerOptions {
@@ -527,15 +541,19 @@ export interface IZipMetadata {
 
 /** --- Dialog 选项 --- */
 export interface IFormDialogOptions {
-    /** --- 当前的 taskId，App 模式下无效 --- */
-    'taskId'?: number;
-
     'title'?: string;
     'content': string;
     'buttons'?: string[];
     'direction'?: 'h' | 'v';
 
+    'style'?: string;
+    /** --- 路径基，以 / 结束或文件路径则以文件的基路径为准，可留空 --- */
+    'path'?: string;
+
     'select'?: (e: Event, button: string) => void;
+
+    /** --- 当前的 taskId，App 模式下无效 --- */
+    'taskId'?: number;
 }
 
 /** --- Confirm 选项 --- */