@snack-kit/core 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,1236 @@
+import React from 'react';
+
+interface I18nData {
+    /**
+     * 语言
+     */
+    [lang: string]: {
+        /**
+         * 字段键值
+         */
+        [key: string]: string;
+    };
+}
+
+/** 设置模块属性模型中单个属性的结构 */
+interface SnackSettingModelItem {
+    /** 属性当前值 */
+    value: unknown;
+    [k: string]: unknown;
+}
+/**
+ * Snack 设置模块基类
+ *
+ * 继承此类的模块通常作为另一个 Snack 模块的配置面板，
+ * 通过 `$setData` 方法同步修改主模块（`main`）的 `data`。
+ */
+declare class SnackSetting extends Snack {
+    /**
+     * 关联的主模块 Snack 实例
+     */
+    main: Snack;
+    /**
+     * 属性模型，键为数据字段名，值描述该字段的元数据与当前值
+     */
+    model: Record<string, SnackSettingModelItem>;
+    /**
+     * 是否将当前设置按照普通模式渲染，为 `true` 则不以弹窗模式渲染
+     */
+    $normal: boolean;
+    $model(): any;
+    /**
+     * this.data 数据赋值，同时渲染页面
+     * @param field 字段名字，支持 . 操作符
+     * @param value
+     * @param isRefresh
+     */
+    $setData(field: string, value?: unknown, isRefresh?: boolean): unknown;
+    /**
+     * 支持 . 操作符设置对象数据
+     * @param data
+     * @param field
+     * @param value
+     * @param parseExpr	是否解析表达式
+     * @private
+     */
+    private setFieldValue;
+}
+
+interface ImportModules {
+    [type: string]: {
+        [name: string]: Snack | SnackSetting;
+    };
+}
+interface CoreConfig {
+    /**
+     * 是否 runtime 模式
+     */
+    runtime?: boolean;
+    /**
+     * runtime 模块名称映射对象
+     */
+    runtimeMapping?: {
+        [name: string]: string;
+    };
+    /**
+     * snack 服务端地址
+     */
+    service?: string;
+    /**
+     * snack模块 加载路径，默认 service + modPath
+     */
+    modUrl?: string;
+    /**
+     * snack模块 请求路径
+     */
+    modPath?: string;
+    /**
+     * 单独指定 cnd 请求域名地址，默认为 service + cdnPath
+     */
+    cdnUrl?: string;
+    /**
+     * cdn 请求路径
+     */
+    cdnPath?: string;
+    /**
+     * 设计器页面路径
+     */
+    pageUrl?: string;
+    /**
+     * 设计器页面路径
+     */
+    pagePath?: string;
+    /**
+     * 静态资源cdn路径
+     */
+    staticUrl?: string;
+    /**
+     * 引用包导入
+     */
+    importMaps?: {
+        [name: string]: any;
+    };
+    /**
+     * 导入sanck class，加载时候优先从该列表内查询
+     */
+    importModules?: ImportModules;
+    /**
+     * 基础模块分类名称
+     */
+    basicsType?: string;
+    /**
+     * FormAttr全局默认值配置，当组件内部缺少参数时，采用该定义数值
+     */
+    defaultFormAttr?: SnackFormAttribute;
+    /**
+     * i18n国际化数据复写
+     */
+    i18n?: I18nData;
+    /**
+     * 国际化语言Mapping转换关系
+     * 例，当国际化语言为zh时，取值时则以zh_CN:
+     * { "zh" : "zh_CN" }
+     */
+    localeMapping?: {
+        [locale: string]: string;
+    };
+    /**
+     * 默认国际化语言
+     * 当localeMapping或传入语言为找到时，则使用该语言
+     */
+    localeDefault?: string;
+    /**
+     * 消息提示对象由外部传入，用于evalJs使用
+     */
+    message?: {
+        [key: string]: any;
+    };
+    /**
+     * argv 环境变量对象，可在表达式中通过 `$.argv` 访问
+     */
+    argv?: Record<string, string | boolean | number | null | undefined>;
+}
+interface LoadModuleConfig extends CoreConfig {
+    /**
+     * 所需加载的模块列表，单个加载可以为对象
+     */
+    module: Array<ModuleConfig> | ModuleConfig;
+    /**
+     * Require 配置参数
+     */
+    config?: RequireConfig;
+}
+/**
+ * 通过模块名称加载模块方法配置
+ */
+interface ModuleConfig {
+    /**
+     * 模块名称
+     */
+    name: string;
+    /**
+     * 模块分类，snack.json type属性
+     */
+    type?: string;
+    /**
+     * 是否同时加载setting模块
+     */
+    setting?: boolean;
+    /**
+     * 引用包导入
+     */
+    importMaps?: {
+        [name: string]: any;
+    };
+    /**
+     * Require 配置参数
+     */
+    config?: RequireConfig;
+}
+/**
+ * 通过模块URL加载模块方法配置
+ */
+interface LoadModuleURLConfig {
+    /**
+     * snack 模块绝对路径
+     */
+    urls: string | Array<string>;
+    /**
+     * 模块cdn库地址
+     */
+    cdnUrl: string;
+    /**
+     * 静态资源cdn地址
+     */
+    staticUrl?: string;
+    /**
+     * 引用包导入
+     */
+    importMaps?: {
+        [name: string]: any;
+    };
+    /**
+     * Require 配置参数
+     */
+    config?: RequireConfig;
+}
+/**
+ * 放置容器下级对象
+ */
+interface DropChildrenItem<P = any, D = any, M = any, S = any> {
+    /**
+     * 父级模块
+     */
+    parent?: P;
+    /**
+     * Drag 容器snack实例
+     */
+    D: D;
+    /**
+     * Drag 容器组件实例
+     */
+    DFC: React.FunctionComponent | null;
+    /**
+     * 主模块 snack实例
+     */
+    M: M;
+    /**
+     * 主模块 组件实例
+     */
+    MFC: React.FunctionComponent | null;
+    /**
+     * 设置模块 snack实例
+     */
+    S?: S;
+    /**
+     * 设置模块 组件实例
+     */
+    SFC?: React.FunctionComponent | null;
+}
+interface LoadConfig {
+    /**
+     * snack 模块请求地址
+     */
+    url: string;
+    /**
+     * require 请求配置
+     */
+    config?: RequireConfig;
+    /**
+     * 引用包导入
+     */
+    importMaps?: {
+        [name: string]: any;
+    };
+}
+interface RequireConfig {
+    /**
+     * 超时等待时间，默认 50s
+     */
+    waitSeconds?: string;
+    /**
+     * cdn 路径，默认'./'
+     */
+    baseUrl?: string;
+    /**
+     * 指定snack模块静态资源上下文，默认随snack js文件路径
+     */
+    staticUrl?: string;
+    paths?: {
+        [key: string]: any;
+    };
+    bundles?: {
+        [key: string]: any;
+    };
+    pkgs?: {
+        [key: string]: any;
+    };
+    shim?: {
+        [key: string]: any;
+    };
+    config?: {
+        [key: string]: any;
+    };
+}
+/**
+ * 表单校验规则
+ */
+interface SnackFormVerifyRule {
+    /**
+     * 必须匹配条件，如果为true则整个规则组内无论是否有通过的条件都必定会提示错误，如果为false则整个规则组内有一条规则通过，本条规则则不会提示错误，
+     */
+    mustMatch: boolean;
+    /**
+     * 字段校验正则
+     */
+    regExp?: string;
+    /**
+     * 校验错误文本
+     */
+    erorText?: {
+        [lang: string]: string;
+    };
+}
+/**
+ * 表单组件属性
+ */
+interface SnackFormAttribute {
+    /**
+     * 表单字段，默认''
+     */
+    field?: string;
+    /**
+     * 是否禁用,D、M都需要设置，默认false
+     */
+    disabled?: boolean;
+    /**
+     * 是否必填，校验时需要校验是否为空，默认false
+     */
+    required?: boolean;
+    /**
+     * 必填时，校验非空对象性，默认false
+     * */
+    notEmptyObject?: boolean;
+    /**
+     * 始终禁止提交该字段，组装json时过滤，默认false
+     */
+    noSubmit?: boolean;
+    /**
+     * 当组件被隐藏时则不提交该字段，同时字段校验也将忽略,默认true
+     */
+    hideNoSubmit?: boolean;
+    /**
+     * 是否对value进行tirm过滤，默认过滤，false禁止过滤
+     */
+    trimValue?: boolean;
+    /**
+     * 校验规则组
+     */
+    verifyRules?: SnackFormVerifyRule[];
+    /**
+     * 入参转换脚本
+     */
+    inFormatJS?: string;
+    /**
+     * 出参转换脚本
+     */
+    outFormatJS?: string;
+    /**
+     * 自定义校验脚本
+     */
+    verifyJS?: string;
+    /**
+     * 密码字段标记，为true时则将会在当前表单getData数据组装时候增加 @password: [f...] 字段对当前字段进行描述，默认true
+     */
+    passwordFlag?: boolean;
+    /**
+     * 校验触发事件,默认['onChange', 'onBlur']f
+     */
+    verifyOnEvents?: string[];
+    /**
+     * 校验防抖时间,默认 300ms
+     */
+    verifyASTime?: number;
+    /** 是否跳过校验规则列表 */
+    skipRegx?: boolean;
+}
+/**
+ * 页面数据结构
+ */
+interface SnackPageData {
+    /**
+     * 页面唯一id
+     */
+    id: string;
+    /**
+     * 页面名称
+     */
+    name: string;
+    /**
+     * 页面分类
+     */
+    type?: string;
+    /**
+     * 页面描述
+     */
+    description?: string;
+    /**
+     * 页面内容 Base64.encode(Object<SnackPageContent>)
+     */
+    content: string | SnackPageContent;
+    [name: string]: any;
+}
+/**
+ * 页面内容结构
+ */
+interface SnackPageContent {
+    /**
+     * 模块唯一id D.key
+     */
+    key?: string;
+    /** 是否是容器 */
+    isContainer?: boolean;
+    /**
+     * 模块(M)定义
+     */
+    module?: SnackPageContentModule;
+    /**
+     * 下级
+     */
+    children?: Array<SnackPageContent>;
+}
+interface SnackPageContentModule {
+    /**
+     * 模块(D.data.module)id、全小写目录名
+     */
+    id: string;
+    /**
+     * 是否为页面模版
+     */
+    template: boolean;
+    /**
+     * 模块或页面的分类
+     */
+    type?: string | null;
+    /**
+     * 模块data数据
+     */
+    data?: {
+        /**
+         * Drag容器data数据
+         */
+        D: {
+            [name: string]: any;
+        };
+        /**
+         * 模块(M)data数据
+         */
+        M: {
+            value?: any;
+            formAttr?: SnackFormAttribute;
+            [name: string]: any;
+        };
+    };
+}
+interface SnackEvent<S extends Snack = any> {
+    /**
+     * 事件名称
+     */
+    name: string;
+    /**
+     * 事件触发对象
+     */
+    target: S;
+    /**
+     * 事件数值
+     */
+    value?: any;
+}
+
+/**
+ * @author 刘佳
+ * @date 2021/8/2 1:59 下午
+ * @description Snack Core
+ */
+
+type SnackMaps = {
+    [name: string]: Snack;
+};
+type SDKEvent = 'onComplete' | string;
+/**
+ * 事件监听回调
+ * 使用 Function 类型是因为事件总线为动态分发系统，回调函数的参数类型由事件名称决定
+ */
+type SDKEventCallback = Function;
+/** 表达式求值上下文 */
+type ExprContext = Record<string, unknown>;
+/** RequireJS require 函数接口 */
+interface SnackRequireFunction {
+    (deps: string[], success: (e: Record<string, unknown>) => void, error?: (e: Error) => void): void;
+    config: (cfg: Record<string, unknown>) => void;
+}
+/** RequireJS define 函数接口（AMD） */
+type SnackDefineFunction = (name: string, deps: string[], factory: (...args: unknown[]) => unknown) => void;
+declare class Core {
+    /** RequireJS require 实例 */
+    require: SnackRequireFunction;
+    /** RequireJS define 实例 */
+    define: SnackDefineFunction;
+    runtime: boolean;
+    runtimeMapping: {
+        [id: string]: string;
+    };
+    service: string;
+    cdnUrl?: string;
+    cdnPath: string;
+    modUrl?: string;
+    modPath: string;
+    pageUrl: string;
+    pagePath: string;
+    staticUrl?: string;
+    importMaps: {
+        [mod: string]: any;
+    };
+    basicsType: string;
+    moduleMaps: SnackMaps;
+    global: {
+        [key: string]: any;
+    };
+    message: {
+        [key: string]: any;
+    };
+    i18n: I18nData;
+    defaultFormAttr: SnackFormAttribute;
+    importModules: ImportModules;
+    localeMapping: {
+        [locale: string]: string;
+    };
+    localeDefault: string;
+    argv: CoreConfig['argv'];
+    /**
+     * Core初始化构造函数
+     * @param {CoreConfig}
+     * @param importMaps 依赖对象导入
+     */
+    constructor({ runtime, runtimeMapping, service, cdnUrl, cdnPath, modUrl, modPath, pageUrl, pagePath, staticUrl, importMaps, basicsType, defaultFormAttr, importModules, i18n, localeMapping, localeDefault, message, argv }: CoreConfig);
+    /**
+     * 事件存储对象
+     * @private
+     */
+    private eventList;
+    /**
+     * 注册事件
+     * @param eventName 事件名称
+     * @param cb 事件回调函数
+     */
+    addEvent(eventName: SDKEvent, cb: SDKEventCallback): boolean;
+    /**
+     * 移除事件
+     * @param eventName 事件名称
+     * @param cb 解除绑定的事件回调
+     */
+    removeEvent(eventName: SDKEvent, cb?: SDKEventCallback): boolean;
+    /**
+     * 发送事件
+     * @param eventName 事件名称
+     * @param args 事件方法参数
+     */
+    sendEvent(eventName: SDKEvent, args?: unknown[]): boolean;
+    /**
+     * 按模块名称加载模块
+     * @param {LoadModuleConfig}
+     * @param callback  回调方法，存在该参数则Promises失效
+     * @return Snack    模块键值对 ｛snackName：snackClass｝
+     */
+    module({ module, service, cdnUrl, cdnPath, modUrl, modPath, staticUrl, importMaps, config }: LoadModuleConfig, callback?: (snack: SnackMaps) => void): Promise<void | SnackMaps>;
+    /**
+     * 按模块地址加载模块
+     * @param {LoadModuleURLConfig}
+     * @param callback  回调方法，存在该参数则Promises失效
+     * @return Snack    模块键值对 ｛snackName：snackClass｝
+     */
+    moduleURL({ urls, cdnUrl, staticUrl, importMaps, config }: LoadModuleURLConfig, callback?: (snack: SnackMaps) => void): Promise<SnackMaps | null>;
+    private addSnack;
+    private loadingPromises;
+    /**
+     * umd模块加载方法
+     * @param {LoadConfig}  snack模块js地址
+     * @return Snack    模块类对象
+     */
+    load({ url, config, importMaps }: LoadConfig): Promise<{} | Error>;
+    /**
+     * 移除模块
+     * @param id snack模块的 $id
+     * @param forceUpdate   是否调用$forceUpdate
+     */
+    remove(id: string, forceUpdate?: boolean): false | undefined;
+    /**
+     * 清空挂载在sdk内的所有模块
+     * @param forceUpdate   是否调用$forceUpdate
+     */
+    empty(forceUpdate?: boolean): void;
+    /**
+     * 全局Snack模块语言切换方法
+     * @param l     语言,默认 'zh'
+     */
+    language: (l?: string) => void;
+    /**
+     * 国际化数据导入
+     * @param data
+     */
+    setI18n(data: I18nData): void;
+    /**
+     * 获取国际化文本
+     * @param ops
+     * @param params
+     */
+    intl(ops: string | {
+        id: string;
+    }, params?: Record<string, unknown>): string | React.ReactNode;
+    /**
+     * 组件数据解析表达式
+     * @param data
+     */
+    exprParseByData(data?: SnackPageContentModule): SnackPageContentModule | undefined;
+    private exprRegx;
+    private checkHasExpr;
+    private evaluateExpression;
+    processTemplateString(template: string, context: ExprContext): string;
+    recursiveParseJson(obj: SnackData, context: ExprContext, filterPrototype?: boolean): SnackData;
+    /**
+     * 表达式入参
+     */
+    getExprArgv(data: unknown): ExprArgv;
+}
+type ExprArgv = {
+    /** 全局 argv 环境变量 */
+    argv: CoreConfig['argv'];
+    /** Core 实例 */
+    sdk: Core;
+    /** 表达式上下文数据，通常为组件的 data 对象 */
+    data: unknown;
+};
+
+interface DropOjb<M = any, P = any> {
+    data: any;
+    $id: string;
+    append: (module: M, onComplete?: (c?: DropChildrenItem) => void) => Promise<DropChildrenItem>;
+    $forceUpdate: () => void;
+    FC: (props: P) => void;
+}
+interface CompleteEvent {
+    /**
+     * 表单字段键值对
+     */
+    fields: SnackFormFields;
+    /**
+     * 所有子元素数组
+     */
+    children: DropChildrenItem[];
+    /**
+     * 所有子元素data.key键值对
+     */
+    childrenMaps: SnackChildMaps;
+}
+/**
+ * 表单字段map对象
+ */
+type SnackFormFields = {
+    [field: string]: DropChildrenItem;
+};
+type SnackChildMaps = {
+    [key: string]: DropChildrenItem;
+};
+
+/**
+ * 是否显示组件，默认显示
+ * @param child
+ * @param show  是否显示
+ */
+declare function $display(child?: DropChildrenItem, show?: boolean): DropChildrenItem<any, any, any, any> | undefined;
+declare const DisplayModule: typeof $display;
+/**
+ * 返回代monaco代码提示
+ * @param monaco    monaco编辑器对象
+ * @param event     指定过滤事件的参数，可选，默认全量参数
+ * @constructor
+ */
+declare const GetParamsDetails: (monaco: any, event?: string, locale?: "en-US" | "zh-CN") => {
+    label: string;
+    insertText: string;
+    detail: string;
+    documentation: string | undefined;
+    kind: any;
+}[];
+/**
+ * 脚本参数描述
+ * @param filterEvents string[]   过滤所属事件，默认参数生效与所有脚本
+ * @param events string[]         参数所属事件
+ * @param label string            参数名
+ * @param insertText string       自动补全代码
+ * @param detail string           简要描述
+ * @param documentation string    详细描述
+ * */
+declare const ParamsDetails: ({
+    label: string;
+    insertText: string;
+    detail: string;
+    filterEvents?: undefined;
+    events?: undefined;
+    documentation?: undefined;
+} | {
+    filterEvents: string[];
+    label: string;
+    insertText: string;
+    detail: string;
+    events?: undefined;
+    documentation?: undefined;
+} | {
+    events: string[];
+    label: string;
+    insertText: string;
+    detail: string;
+    filterEvents?: undefined;
+    documentation?: undefined;
+} | {
+    label: string;
+    insertText: string;
+    detail: string;
+    documentation: string;
+    filterEvents?: undefined;
+    events?: undefined;
+} | {
+    events: string[];
+    label: string;
+    insertText: string;
+    detail: string;
+    documentation: string;
+    filterEvents?: undefined;
+})[];
+declare const enParamsDetails: ({
+    label: string;
+    insertText: string;
+    detail: string;
+    filterEvents?: undefined;
+    events?: undefined;
+    documentation?: undefined;
+} | {
+    filterEvents: string[];
+    label: string;
+    insertText: string;
+    detail: string;
+    events?: undefined;
+    documentation?: undefined;
+} | {
+    events: string[];
+    label: string;
+    insertText: string;
+    detail: string;
+    filterEvents?: undefined;
+    documentation?: undefined;
+} | {
+    label: string;
+    insertText: string;
+    detail: string;
+    documentation: string;
+    filterEvents?: undefined;
+    events?: undefined;
+} | {
+    events: string[];
+    label: string;
+    insertText: string;
+    detail: string;
+    documentation: string;
+    filterEvents?: undefined;
+})[];
+/**
+ * 动态函数
+ * @param args      函数入参
+ * @param code      函数内容
+ * @param isSync    是否async函数
+ */
+declare const evalFunc: (args: string | string[], code: string, isSync?: boolean) => any;
+declare const replaceVars: (data: any, srcData: any) => any;
+
+/**
+ * @author 刘佳
+ * @date 2021/8/31 7:29 下午
+ * @description 包含Core内核的额外增强功能SDK类
+ */
+
+interface SnackPageParams {
+    /**
+     * 页面id
+     */
+    id: string;
+    /**
+     * 页面分类
+     */
+    type?: string;
+}
+interface RenderPageConfig {
+    /**
+     * 表单回填数据
+     */
+    data?: {
+        [key: string]: any;
+    };
+    /**
+     * 渲染规则
+     */
+    rules?: {
+        [key: string]: RenderPageRule;
+    };
+    /**
+     * root容器参数
+     */
+    rootProps?: {};
+    /**
+     * 页面事件对象
+     */
+    snackPageEvent?: SnackPageCompleteEvent;
+    /**
+     * 页面渲染完成事件
+     */
+    onComplete?: (e: SnackPageCompleteEvent, config?: SnackPageConfig) => void;
+}
+interface RenderPageRule {
+    /**
+     * 字段名
+     */
+    key: string;
+    /**
+     * 字段名称
+     */
+    label: string;
+    /**
+     * 是否有隐藏该字段绑定的组件
+     */
+    hide?: boolean;
+    /**
+     * 是否禁用该字段绑定的组件
+     */
+    disabled?: boolean;
+}
+interface SnackPageCompleteEvent extends CompleteEvent {
+    /**
+     * 清空表单数据填充
+     */
+    empty?: () => void;
+    /**
+     * 获取表单数据
+     * @param key 指定字段获取表单数据，不传则返回全量json
+     */
+    getData?: (key?: string) => any;
+    /**
+     * 设置表单数据
+     * @param kv    指定字段赋值或传入对象多个字段赋值
+     * @param value kv为对象时该参数将被忽略
+     */
+    setData?: (kv: string | {
+        [key: string]: any;
+    }, value?: any) => void;
+    /**
+     * 表单校验
+     * @param key 指定校验字段，不传则校验所有字段
+     */
+    verify?: (key?: string) => Promise<boolean>;
+    /**
+     * 页面内部事件回调方法
+     * @param e
+     */
+    snackEventCallback?: (e: SnackEvent) => void;
+    /**
+     * 页面销毁方法
+     */
+    destroy?: () => void;
+    /**
+     * 页面原始渲染数据
+     */
+    pageData?: SnackPageData | null;
+}
+interface SnackCreateModule {
+    main?: typeof Snack;
+    name: string;
+    type: string;
+    setting?: boolean;
+}
+/**
+ * form 自定义脚本所需参数
+ */
+interface FormDataFormatArgs {
+    fields: SnackFormFields;
+    childrenMaps: SnackChildMaps;
+    rules?: {
+        [key: string]: RenderPageRule;
+    };
+    verify?: (key?: string) => Promise<boolean>;
+    defaultData?: {
+        [key: string]: any;
+    };
+}
+type SnackPageConfig = SnackPageParams | SnackPageParams[] | SnackPageData | SnackPageData[];
+declare class SnackSDK extends Core {
+    constructor(config: CoreConfig);
+    /**
+     * 创建Snack模块实例
+     * @param snackClass Snack模块Class
+     * @param main 如果创建的是setting模块则需要传入main主模块Snack对象
+     * @param data
+     */
+    createModule<T extends Snack = any>({ main, name, type, setting }: SnackCreateModule, data?: SnackData): Promise<T | null>;
+    /**
+     * 渲染设计器页面
+     * @param params {SnackPageParams | SnackPageData} 页面加载参数 参数非法则创建空容器
+     * @param config {RenderPageConfig} 页面渲染参数
+     * @param root 根容器
+     * @param filter 过滤渲染组件列表
+     * @private
+     */
+    private createPage;
+    /** 校验防抖计时器 Map，key 为组件 $id */
+    private verifyTimeout;
+    /**
+     * 渲染多个页面，当页面为表单时会过滤相同字段的表单组件
+     * @param params
+     * @param config
+     */
+    renderPage(params: SnackPageConfig, config?: RenderPageConfig): Promise<DropOjb<any, any> | null>;
+    /**
+     * 卸载页面
+     * @private
+     */
+    destroy(event: SnackPageCompleteEvent | null, root: DropOjb | null): void;
+    /**
+     * 设置表单字段数据
+     * @param formatArag
+     * @param kv    所要设置的字段名，当value为空，key为对象则覆盖整个data对象
+     * @param value  所要设置的字段值
+     * @private
+     */
+    private formSetData;
+    /**
+     * 表单入参转换
+     * @param M
+     * @param verify
+     * @param fields
+     * @param defaultData
+     * @param childrenMaps
+     * @private
+     */
+    private formFormatValue;
+    /**
+     * 获取表单数据
+     * @param verify
+     * @param childrenMaps
+     * @param fields    表单字段对象
+     * @param defaultData
+     * @param key       指定获取字段值
+     * @private
+     */
+    private formGetData;
+    /**
+     * 表单校验
+     * @private
+     * @param formatArag
+     * @param key
+     * @param pageData
+     */
+    private formVerify;
+    /**
+     * 清空表单填充数据
+     * @param children
+     * @private
+     */
+    private formEmpty;
+    /**
+     * 格式化Form入参数据
+     * @param defaultData
+     * @param moduleData    组件初始化入参
+     * @param fields
+     * @private
+     */
+    private formatData;
+    /**
+     * 解码页面内容base64
+     * @param data
+     */
+    private pageContentDecode;
+    /**
+     * 获取页面数据
+     */
+    getPage(params: SnackPageParams): Promise<SnackPageData | null>;
+    /**
+     * 渲染设计器页面 - React FC组件
+     * @param params {SnackPageConfig}
+     * @param config {RenderPageConfig}
+     */
+    createPageComponent<T>(params: SnackPageConfig, config?: RenderPageConfig): Promise<React.FunctionComponent>;
+    /**
+     * 渲染页面到dom元素内
+     * @param el
+     * @param params
+     * @param config
+     */
+    createPageForElement<T extends SnackData = SnackData>(el: HTMLElement, params: SnackPageConfig, config?: RenderPageConfig): Promise<DropOjb | null | undefined>;
+    /**
+     * 渲染模块 - React FC组件
+     * @param args  模块装载参数
+     * @param data 模块初始数据
+     */
+    createModuleComponent<T extends SnackData>(args: SnackCreateModule, data?: T): Promise<React.FunctionComponent>;
+    /**
+     * 渲染模块到dom元素内
+     * @param el    所要渲染模块的容器
+     * @param args  模块装载参数
+     * @param data  模块初始数据
+     */
+    createModuleForElement<T extends SnackData, S extends Snack = any>(el: HTMLElement, args: SnackCreateModule, data?: T): Promise<S | null>;
+    /**
+     * 通过模块Class渲染模块
+     * @param SnackClass    sanck 模块 Class
+     * @param data          snack对象参数
+     * @param main          如果为设置模块，传入主模块对象
+     */
+    createClassModule<T extends SnackData, S extends Snack | SnackSetting>(SnackClass: new (...args: unknown[]) => S, data?: T, main?: Snack): S;
+    /**
+     * 通过模块Class渲染模块
+     * @param SnackClass    snack 模块 Class
+     * @param data          snack对象参数
+     * @param main          如果为设置模块，传入主模块对象
+     */
+    createClassModuleComponent<T extends SnackData, S extends Snack | SnackSetting>(SnackClass: new (...args: unknown[]) => S, data?: T, main?: Snack): React.FunctionComponent;
+}
+
+/**
+ * 设计器事件列表
+ * @param language {boolean} 当前语言*
+ */
+declare const GetDefaultEvents: (language?: "zh-CN" | "en-US") => ({
+    name: string;
+    label: string;
+    default: boolean;
+    verify: boolean;
+} | {
+    name: string;
+    label: string;
+    default: boolean;
+    verify?: undefined;
+} | {
+    name: string;
+    label: string;
+    default?: undefined;
+    verify?: undefined;
+})[];
+
+interface SnackMapItem {
+    [name: string]: Snack;
+}
+/**
+ * 国际化对象结构
+ */
+interface I18nMap {
+    [name: string]: {
+        [name: string]: string;
+    };
+}
+interface SnackData {
+    $snackSDK?: SnackSDK;
+    $i18n?: I18nMap;
+    style?: React.CSSProperties;
+    eventScripts?: {
+        [eventName: string]: {
+            script: string;
+        };
+    };
+    formAttr?: SnackFormAttribute;
+    /** drag/drop 容器父级 Snack 实例 */
+    parent?: Snack;
+    /** drag 容器渲染内容 */
+    content?: unknown;
+    /** drop 容器子节点列表 */
+    children?: Snack[];
+    [key: string]: any;
+}
+declare class Snack<T extends SnackData = any> {
+    data?: T | undefined;
+    /**
+     * 当前模块名称
+     */
+    $name: string;
+    /**
+     * 页面事件对象
+     */
+    $page?: SnackPageCompleteEvent;
+    /**
+     * 当前模块唯一id，每次实例化随机生成
+     */
+    $id: string;
+    /**
+     * 国际化语言map集合
+     */
+    private $i18nMap;
+    /**
+     * 构造函数初始化传入的国际化，当他存在时则优先从此国际化获取数据
+     * @private
+     */
+    private $i18nMapExternal?;
+    /**
+     * react重绘hook，由 FC 方法中的 useState setter 赋值
+     */
+    private $forceUpdateHook;
+    /**
+     * 父级容器Snack对象,通常为M的父级容器Drag
+     */
+    $parent?: Snack;
+    /**
+     * 重绘标识，每次 reload 重绘时更新
+     */
+    private $forceUpdateId;
+    /**
+     * 是否基础模块
+     */
+    isBasic: boolean;
+    /**
+     * 是否容器
+     */
+    isContainer: boolean;
+    /**
+     * 是否放置容器
+     */
+    isDrop: boolean;
+    /**
+     * 是否拖拽容器
+     */
+    isDrag: boolean;
+    /**
+     * 是否页面模版容器
+     */
+    isTemplate: boolean;
+    /**
+     * 是否form组件
+     */
+    isForm: boolean;
+    /**
+     * 设置模式
+     */
+    settingMode: boolean;
+    /**
+     * @para-snack/sdk 实列对象
+     */
+    sdk: SnackSDK | undefined;
+    /**
+     * 优先渲染属性
+     */
+    props?: T;
+    /**
+     *
+     * @param data      统一数据管理对象
+     * @param defData   data默认值
+     */
+    constructor(data?: T | undefined, defData?: T);
+    /**
+     * 浅克隆数据对象（JSON可序列化的字段深克隆，不可序列化的字段浅引用）
+     * @param obj 待克隆的数据对象
+     */
+    cloneData<T>(obj: T): T;
+    /**
+     * React组件方法
+     * @param data  统一数据管理对象（解构覆盖构造函数data参数）
+     * @return FunctionComponent
+     */
+    private $lastUpdateId;
+    FC(data: T): React.ReactNode;
+    /**
+     * 模块渲染方法，子类重写此方法实现 UI
+     * @param data 当前数据对象
+     */
+    $component(data?: T): React.ReactNode;
+    /**
+     * 强制渲染JSX内容
+     * @param reload 是否强制重绘
+     */
+    $forceUpdate(reload?: boolean): void;
+    /**
+     * this.style 样式赋值方法，同时渲染页面
+     * @param key
+     * @param value
+     */
+    $style(key?: keyof React.CSSProperties | Record<keyof React.CSSProperties, any>, value?: any): any;
+    /**
+     * 外部复写，统一销毁方法
+     */
+    $destroy(): void;
+    /**
+     * 国际化切换方法
+     * @param lang  语言
+     */
+    $language(lang: string): void;
+    get $lang(): string;
+    set $lang(lang: string);
+    /**
+     * 国际化语言包返回
+     */
+    get $i18n(): I18nMap;
+    /**
+     * 国际化语言包设置
+     * @param map   语言包对象
+     */
+    set $i18n(map: I18nMap);
+    /**
+     * 返回外部导入与默认国际化数据
+     */
+    $getI18n(): {
+        external: I18nMap | null;
+        default: I18nMap;
+    };
+    /**
+     * 国际化语言获取
+     * @param ops   语言变量
+     */
+    $intl(ops: {
+        id: string;
+    } | string, params?: Record<string, unknown>): string | React.JSX.Element;
+    $display(b: boolean): DropChildrenItem<any, any, any, any> | undefined;
+    protected cloneDeep(data: any, re?: any): any;
+}
+
+interface Props$1 {
+    content?: string | React.ReactNode;
+    sub?: string | React.ReactNode;
+    info?: string | React.ReactNode;
+}
+declare const Error$1: (props: Props$1) => React.JSX.Element;
+
+interface Props {
+    text?: string | React.ReactNode;
+    className?: string;
+    size?: number;
+}
+declare const Loading: (props: Props) => React.JSX.Element;
+
+declare const _default: {
+    version: string;
+};
+
+export { Core, type CoreConfig, DisplayModule, type DropChildrenItem, Error$1 as Error, type ExprArgv, type FormDataFormatArgs, GetDefaultEvents, GetParamsDetails, type I18nMap, type ImportModules, type LoadConfig, type LoadModuleConfig, type LoadModuleURLConfig, Loading, type ModuleConfig, ParamsDetails, type RenderPageConfig, type RenderPageRule, type RequireConfig, Snack, type SnackCreateModule, type SnackData, type SnackDefineFunction, type SnackEvent, type SnackFormAttribute, type SnackFormVerifyRule, type SnackMapItem, type SnackPageCompleteEvent, type SnackPageConfig, type SnackPageContent, type SnackPageContentModule, type SnackPageData, type SnackPageParams, type SnackRequireFunction, SnackSDK, SnackSetting, type SnackSettingModelItem, _default as default, enParamsDetails, evalFunc, replaceVars };