@choiceform/os-client-core 3.0.0 → 3.1.1

package/index.d.ts

@@ -196,16 +196,6 @@ interface CFEnvUi {
    * @param styleGroup 样式信息：JSON形式
    */
   setVarStyle?(style: string, styleGroup: CFVarStyleGroup): void;
-  /**
-   * 获取某个url地址的图片的高宽信息的方法，有些答题端需要对图片进行布局控制，
-   * 需要事先知道图片的尺寸，核心在生成图片对象的时候会尝试调用这个方法添加尺寸信息。
-   * 无此需要的终端可以不配置这个方法。
-   * 如果不配置则使用默认值:无论什么图片都返回固定大小100*100
-   * @deprecated 这个方法目前只有老UI在使用，只为兼容性暂时保留，不要使用，后续将移除，
-   *             这个信息应该由UI自主获取并使用，无需核心包插手
-   * @param url 图片地址
-   */
-  getImageSize?(url: string): Promise<CFImageSize>;
   /**
    * 初始化一个节点动态模板的方法，该方法去动态获取设计端指定的自定义组件模板来渲染节点。
    * 只有实现了动态模板机制的答题端需要配置这个方法
@@ -265,10 +255,22 @@ interface CFApiReqResult {
   readonly response: string | object;
 }
 
+
+interface CFUploadBaseConfig {
+  /**
+   * 关联的节点id
+   */
+  readonly nodeId: string;
+  /**
+   * 关联的选项id
+   */
+  readonly optionId: string;
+}
+
 /**
  * 图片上传参数
  */
-interface CFUploadConfig {
+interface CFUploadConfig extends CFUploadBaseConfig {
   /**
    * 上传进度回调方法
    * @param e 进度
@@ -284,6 +286,11 @@ interface CFUploadConfig {
  * 环境配置：网络连接与资源加载
  */
 interface CFEnvNetWork {
+  /**
+   * 移除上传文件时的处理
+   * @param config 配置信息
+   */
+  removeUpload(config: CFUploadBaseConfig): Promise<void>;
   /**
    * 上传文件的方法，答题端的上传题需要上传文件，在不同的平台上上传机制不同
    * 需要独立实现这个方法将文件正确上传到服务器
@@ -390,21 +397,42 @@ interface CFEnvAuth {
  */
 interface CFEnvStorage {
   /**
-   * 写缓存方法
+   * 同步写缓存方法
    * @param key
    * @param value
    */
   set(key: string, value: string): void;
+  /**
+   * 写缓存方法(至关重要的)
+   * 在离线模式下，有些重要的缓存数据不能写在内嵌的浏览器中，而是要传给App宿主帮写，
+   * 这种场合下的缓存读写就需要用到这个方法而不是set方法，为确保通信操作完成，会变成异步的。
+   * 如果不是离线模式的时候，会自动退化到使用set方法。
+   * @param key
+   * @param value
+   */
+  setVital(key: string, value: string): Promise<void>;
   /**
    * 读缓存方法
    * @param key
    */
   get(key: string): string;
+  /**
+   * 写缓存方法(至关重要的)
+   * 说明同上
+   * @param key
+   */
+  getVital(key: string): Promise<string>;
   /**
    * 移除缓存方法
    * @param key
    */
   remove(key: string): void;
+  /**
+   * 移除缓存方法(至关重要的)
+   * 说明同上
+   * @param key
+   */
+  removeVital(key: string): Promise<void>;
 }
 
 /**
@@ -455,6 +483,27 @@ interface CFEnvHook {
    * @param title 标题内容
    */
   onTitleChange?(title: string): void;
+  /**
+   * 开始一个新回复时的回调，
+   * 非断点续答询问后选择断点续答或重新开始的时候不算做这种情况之内
+   * @param state 
+   */
+  onStartNewSurvey?(state: CFSurveyState): Promise<void>;
+  /**
+   * 断点续答询问后后选择重新开始时的回调
+   * @param state 
+   */
+  onRestartSurvey?(state: CFSurveyState): Promise<void>;
+  /**
+   * 断点续答询问后选择续答时的回调
+   * @param state 
+   */
+  onResumeSurvey?(state: CFSurveyState): Promise<void>;
+  /**
+   * 当一个回复完成走到结束节点时的回调，此时数据已经提交了。
+   * @param state 
+   */
+  onEndSurvey?(state: CFSurveyState): Promise<void>;
 }
 
 /**
@@ -562,17 +611,6 @@ interface CFHostConfig {
   readonly qStaticHost?: string;
 }
 
-/**
- * 属性设置方法，将fromObj身上的的属性值设置到toObj身上（同Object.assign方法）
- * 并可以做一些附加的操作
- */
-type CFPropSetFn =
-  /**
-   * @param toObj 接受设置属性的对象
-   * @param fromObj 提供设置属性的对象
-   */
-  <T>(toObj: T, fromObj: Partial<T>) => void;
-
 /**
  * 客户端初始化配置信息
  */
@@ -598,31 +636,6 @@ interface CFSetupOptions {
    *
    */
   clientName?: string; // anti-readonly
-  /**
-   * @deprecated 该属性仅为兼容老版UI中使用的emberjs的setProperties暂时保留，即将移除，不要使用这个属性
-   *
-   * 该属性已废除，请使用最新标准：使用[[CFEventHub]]来监听`SET_PROPS`来监听变化重新更新UI
-   * 属性设置辅助方法
-   * 由于UI中绑定了核心提供的数据结构的某些值，UI中进行操作后回调了核心提供的回调函数
-   * 核心中的逻辑会更改数据结构中的这些值，核心逻辑中默认是直接更改这些值的。
-   * 这样的话，大部分框架的UI模板引擎是无法觉察到这个更改的，从而UI上的内容不会正常更新。
-   * 这时候可以通过设置该方法来使得模板引擎觉察到内容的更改达到更新页面的目的。
-   *
-   * 举例：UI中渲染选项时背景颜色绑定了[[CFOption.selected]]属性，
-   * 选中的选项（option.selected为true）渲染成红色，
-   * 未选中的选项（option.selected为false）渲染成灰色，
-   * 现在某个选项初始时是未选中的，根据绑定规则，渲染成了灰色，现在点击该选项，会回调核心
-   * 逻辑中提供的选项点击回调函数，在该函数中会将option.selected改为true，
-   * 但是UI模板并不知道这个属性发生了变化，所以依然渲染成了灰色，这时就需要用的这个配置方法。
-   * 如使用emberjs的时候我们将该方法配置为EmberObject的setProperties方法,如果不配置则
-   * UI不会得到更新.
-   * ```typescript
-   *   import {setProperties} from '@ember/object';
-   *   options.setter = setProperties
-   * ```
-   * 默认行为：只更新数据，不做其他任何行为。
-   */
-  setter?: CFPropSetFn; // anti-readonly
   /**
    * 指定该客户端是不是动态加载模板的
    * 对支持动态加载的客户端，核心会尝试去动态模板服务器上加载动态的模板。
@@ -640,12 +653,12 @@ interface CFSetupOptions {
    */
   templatePath?: string; // anti-readonly
   /**
-   * 模板树所在地址
+   * 模板树所在地址，如果指定一定要指定根目录开始的绝对路径。
    * 如果是动态加载的,则一定要准备好该属性
    * 核心会去获取这个文件来了解动态模板的依赖情况，
    * 如果dynamic属性指定为true，而不提供这个路径，初始化时会报错。
    * 当前只有web版客户端有可能支持动态模板功能，小程序和本地应用不支持该功能，所以无需配置。
-   * 默认：空字符串
+   * 默认：/tree.json
    */
   treeUrl?: string; // anti-readonly
   /**
@@ -711,30 +724,29 @@ interface CFSetupOptions {
   /**
    * 如果觉得核心包中逻辑相关的提示文字多语言翻译不满足你的要求，或者支持的语言不够多
    * 你可以配置该属性指定使用自己准备的翻译文本，这个配置的每个属性的属性名是语言代号，
-   * 其属性值是该语言翻译文本（json格式）所在的网络地址
-   * 比如，核心模块当前仅提供了中文（zh_cn）和英文（en_us）的多语言文本
+   * 其属性值是该语言翻译文本对象
+   * 比如，核心模块当前仅提供了中文（zh_cn）和英文（en_us）的多语言
    * 现在你对核心模块的中文翻译是满意的但是对核心模块的英文的翻译内容不满意，
    * 这样你就可以配置该属性如下内容
    *
-   * (我们假设你将多语言文本放到了下面这个网址中)
    * ```
    * {
-   *  "en_us": 'https://yousite.com/your-os-client/es_us.json'
+   *  en_us: {...}
    * }
    * ```
-   * 以上配置会覆盖掉默认的英文翻译，当进行英文翻译时，会只用你提供的这本json作为翻译依据，
+   * 以上配置会覆盖掉默认的英文翻译，当进行英文翻译时，会只用你提供的这个对象作为翻译依据，
    * 核心模块提供的英文翻译会被丢弃
    *
    * 如果在此基础上,同时你希望有日文版的多语言翻译，这时你可以添加配置日文翻译文本
    * ```
    * {
-   *  "en_us": 'https://yousite.com/your-os-client/es_us.json'
-   *  "ja_jp": 'https://yousite.com/your-os-client/ja_jp.json'
+   *  en_us: {...}
+   *  ja_jp: {...}
    * }
    * ```
    * 以上的配置覆盖了英文翻译，同时新增了日文翻译。
    *
-   * 每本json要准备的数据格式在[[LANG_ZH_CN]]和[[LANG_EN_US]]中做出了示范.
+   * 每个json对象要准备的数据格式在[[LANG_ZH_CN]]中做出了示范.
    *
    * 各种语言的代号可参照[百科全书](https://en.wikipedia.org/wiki/Language_localisation)
    *
@@ -742,7 +754,7 @@ interface CFSetupOptions {
    *
    * 默认值：空
    */
-  langSrcMap?: { [key: string]: string }; // anti-readonly
+  langSrcMap?: { [key: string]: any }; // anti-readonly
 
   /**
    * 设置该方法来监听核心包的多语言变化,当核心包多语言切换时,会调用该方法
@@ -872,21 +884,20 @@ interface CFUtil {
    * @param text 富文本
    */
   richTextToNodes(text: string): CFRichTextNode[];
-  /**
-   * 获取答题任务的信息，包含最新的结果，进度信息
-   *
-   * 一般只有离线APP才用到该方法。
-   *
-   * 如果最后要以这个方法的结果进行提交，请确保总是在下一题点击动作处理完成以后
-   * 再调用该方法，才能获取到最新的结果。
-   */
-  getTaskInfo(): Promise<CFTaskInfo>;
 }
 
 /**
  * 核心对象
  */
 interface CFCore extends CFSetupOptions {
+  /**
+   * 发布的版本号
+   */
+  readonly releaseVersion: string;
+  /**
+   * 发布日期
+   */
+  readonly releaseDate: string;
   /**
    * 主题是否已经更新为何服务器上的一致，还未更新好时，APP页面渲染但是不要显示，可以控制透明度或display。
    * 等稍后改属性准备好后再显示出来。
@@ -972,7 +983,7 @@ interface CFCore extends CFSetupOptions {
    * 1. 会强制开启断点续答
    * 2. 则缓存的数据会使用任务id+问卷id的方式分区
    * 否则缓存的数据只按问卷id分区
-   * 3. 答题期间可以调用[[CFCore.util]]的[[CFUtil.getTaskInfo]]方法获取最新的结果
+   * 3. 答题期间每答完一题会往离线服务器发送最新的数
    *
    * 预览模式下总是为空
    *
@@ -982,10 +993,6 @@ interface CFCore extends CFSetupOptions {
    * 是否为实时预览
    */
   readonly realTimePreview: boolean;
-  /**
-   * 是否为轻量版模板预览
-   */
-  readonly liteTemplate: boolean;
   /**
    * 提示消息是否已挂起，挂起后不会发出提示消息
    */
@@ -1014,21 +1021,8 @@ interface CFCore extends CFSetupOptions {
    * 获取首页数据的方法
    * 多次调用,只有第一次会发送请求
    * 请求的数据会放到缓存中,后面几次获得的都是返回的缓存数据
-   * @param offlineTaskId 离线任务唯一id，默认无需指定，只有离线应用需要制定，如果指定了则：
-   * 1. 会强制开启断点续答模式
-   * 2. 数据缓存将以任务id区分存储块
-   * 3. 答题期间可以调用[[CFCore.util]]的[[CFUtil.getTaskInfo]]方法获取最新的结果
-   *
-   * 目前只有离线引用需要指定这个id
-   *
-   * 预览模式下会无视该参数
-   *
-   * 指定路由切换方法,核心包中某些时候需要跳转路由,就会调用这个方法.
-   * 因为核心只知道要跳向哪个路由,而不知道怎么跳过去.
-   * 跳过去的方法只有UI层才知道(使用框架的路由跳转结构)
-   * 所以需要UI层指定这个方法.
    */
-  fetchStartState(offlineTaskId?: string): Promise<CFStartState>;
+  fetchStartState(): Promise<CFStartState>;
   /**
    * 获取答题也数据的方法
    * 多次调用,只有第一次会发送请求
@@ -1593,10 +1587,6 @@ declare const enum EVENT_NAME {
    * 数据发生变更
    */
   SET_PROPS = 'SET_PROPS',
-  /**
-   * 更新UI事件，跟新UI一般监听SET_PROPS后驱动更新即可，但是RN中有问题，所以RN中使用UPDATE_UI
-   */
-  UPDATE_UI = 'UPDATE_UI',
   /**
    * 切换节点
    */
@@ -2144,37 +2134,6 @@ declare const enum OPTION_TYPE {
   OPTION_COMMENT = 'option_comment',
 }
 
-/**
- * 问题渲染类型集合,下面说明每个类型字符代表的题型
- * @deprecated 即将移除，仅为老UI暂时存在
- */
-declare const enum QUES_TYPE {
-  CHOICE = 'choice',
-  REGION = 'region',
-  INTRO_PAGE = 'intro-page',
-  END_PAGE = 'end-page',
-  SHORT_TEXT = 'short-text',
-  REWARD = 'reward',
-  ICON = 'icon',
-  LOCATION = 'location',
-  LOTTERY = 'lottery',
-  RATING = 'rating',
-  RANGE = 'range',
-  MATRIX = 'matrix',
-  DROPDOWN = 'dropdown',
-  PICTURE_CHOICE = 'picture-choice',
-  RANKING = 'ranking',
-  FILE_UPLOAD = 'file-upload',
-  VERIFICATION = 'verification',
-  WEIGHT = 'weight',
-  CASCADE = 'cascade',
-  HOT_SPOT = 'hot-spot',
-  HEAT_MAP = 'heat-map',
-  SLIDE_RATE = 'slide-rate',
-  MAX_DIFF = 'max-diff',
-  NO_VIEW = 'no-view',
-}
-
 /**
  * 变量解析文字是的图片保留模式
  */
@@ -2290,73 +2249,6 @@ declare const enum RESPONSE_STATUS {
   TEST = 'test',
 }
 
-/**
- * 输入内容控制类型枚举
- * @deprecated 不要使用，即将移除，仅为老UI暂时存在
- */
-declare const enum INPUT_RULE {
-  /**
-   * 字符数量控制
-   */
-  COUNT = 'count',
-  /**
-   * 日期
-   */
-  DATE = 'date',
-  /**
-   * 日期范围
-   */
-  DATE_RANGE = 'dateRange',
-  /**
-   * 邮箱
-   */
-  EMAIL = 'email',
-  /**
-   * 小数
-   */
-  FLOAT = 'float',
-  /**
-   * 整数
-   */
-  INT = 'int',
-  /**
-   * 时间
-   */
-  TIME = 'time',
-  /**
-   * 手机号码
-   */
-  MOBILE = 'mobile',
-  /**
-   * 邮编
-   */
-  POSTCODE = 'postCode',
-  /**
-   * 时间范围
-   */
-  TIME_RANGE = 'timeRange',
-  /**
-   * 时间间隔
-   */
-  TIME_SPAN = 'timeSpan',
-  /**
-   * 网址
-   */
-  LINK = 'link',
-  /**
-   * 自动提示填充内容
-   */
-  AUTO_COMPLETE = 'autoComplete',
-  /**
-   * 下拉列表选择内容
-   */
-  DROPDOWN = 'dropdown',
-  /**
-   * 不要求
-   */
-  NO_VALIDATION = 'noValidation',
-}
-
 /**
  * 选项输入与验证类型
  */
@@ -2825,7 +2717,7 @@ interface ICFOptDisplayInfo {
   readonly option_ids: string[];
 }
 
-type IOptionValue = number | string | ICoords | CFMaxDiffRecord[];
+type IOptionAnswerValue = number | string | ICoords | CFMaxDiffRecord[];
 
 /**
  * 一般与选项一一对应答案项数据结构
@@ -2835,7 +2727,7 @@ interface ICFAnswerItem {
   /**
    * 输入值
    */
-  readonly value: IOptionValue;
+  readonly value: IOptionAnswerValue;
   /**
    * 是否为其他选项
    */
@@ -3146,12 +3038,12 @@ interface CFI18n {
   /**
    * 获取多语言资源配置
    */
-  getLangSrcMap(): SignStrStr;
+  getLangSrcMap(): SignStrAny;
   /**
    * 合并多言翻译资源配置
    * @ignore
    */
-  mergeLangSrcMap(map: SignStrStr): void;
+  mergeLangSrcMap(map: SignStrAny): void;
   /**
    * messageformat类型，参考https://github.com/messageformat/messageformat
    * 这是核心包中使用的多语言翻译工具
@@ -3238,56 +3130,31 @@ interface CFClient {
  * 2. web核心包：`@choiceform/os-client-core/dist/web-core`, 自带了web端运行环境配置，方便web端直接使用
  * 携带了ts类型包。
  *
- * 古董版纯核心包，经babel处理过能支持到ie10
+ * 纯核心包
  */
 declare module '@choiceform/os-client-core' {
   const CFClient: CFClient;
   export = CFClient;
 }
-/**
- * 现代版纯核心包，未经过babel处理
- */
-declare module '@choiceform/os-client-core/dist/modern/core' {
-  const CFClient: CFClient;
-  export = CFClient;
-}
 
 /**
  * 自带了web端运行环境配置web核心包
- * 古董版web核心包，经babel处理过能支持到ie10
+ * web核心包
  */
 declare module '@choiceform/os-client-core/dist/web-core' {
   const CFClient: CFClient;
   export = CFClient;
 }
 
-/**
- * 自带了web端运行环境配置web核心包
- * 现代版web核心包，未经babel处理
- */
-declare module '@choiceform/os-client-core/dist/modern/web-core' {
-  const CFClient: CFClient;
-  export = CFClient;
-}
 
 /**
  * 分离的辅助包：填空自动提示查询功能包
- * 古董版，经babel处理过能支持到ie10
  */
 declare module '@choiceform/os-client-core/dist/support/atcp' {
   const CFAtcp: CFAtcp;
   export = CFAtcp;
 }
 
-/**
- * 分离的辅助包：填空自动提示查询功能包
- * 古董版，经babel处理过能支持到ie10
- */
-declare module '@choiceform/os-client-core/dist/modern/support/atcp' {
-  const CFAtcp: CFAtcp;
-  export = CFAtcp;
-}
-
 //#endregion
 
 
@@ -3601,14 +3468,6 @@ interface ICFNode {
    * 强制自动跳过的原因
    */
   readonly forceSkipReason?: SKIP_REASON;
-  /**
-   * 仅在预览时显示
-   * 替身节点题目是在正式答题的时候不要显示的题目
-   * 但是如果该属性为true,则在预览的时候仍然要显示,但是不可以被更改.
-   * @deprecated 不要使用，仅老UI使用,不久后将废除,新UI转为使用readonly属性
-   * @ignore
-   */
-  readonly shadowNodes: boolean;
   /**
    * 该题目只需要显示,不能更改答案
    * UI上要禁用用户操作
@@ -3767,7 +3626,7 @@ interface ICFOutputNodeMixin extends ICFNode {
  * 主输入输出类型节点
  * @ignore
  */
-interface ICFInOutNodeMixin extends ICFInputNodeMixin, ICFOutputNodeMixin {}
+interface ICFInOutNodeMixin extends ICFInputNodeMixin, ICFOutputNodeMixin { }
 
 /**
  * 选项类型节点掺元
@@ -3867,9 +3726,9 @@ interface ICFValidationNodeMixin extends ICFNode {
  */
 interface ICFSubjectNode
   extends ICFInOutNodeMixin,
-    ICFOptNodeMixin,
-    CFMediaNodeMixin,
-    ICFValidationNodeMixin {
+  ICFOptNodeMixin,
+  CFMediaNodeMixin,
+  ICFValidationNodeMixin {
   /**
    * 是否为必答题
    * @ignore
@@ -4089,7 +3948,7 @@ interface ICFHeatMapNode extends ICFSubjectNode, ICFImageMapBase {
  * 填空节点
  * @ignore
  */
-interface ICFFillNode extends ICFSubjectNode, ICFFillNodeMixin {}
+interface ICFFillNode extends ICFSubjectNode, ICFFillNodeMixin { }
 
 /**
  * 级联节点
@@ -4175,11 +4034,6 @@ interface ICFMenuNode extends ICFSubjectNode, ICFMultiSelectNodeMixin {
    * UI需要渲染,选中后的值
    */
   readonly value: string;
-  /**
-   * 展示图标
-   * @deprecated 仅兼容老UI使用，后续会移除，新UI不要使用
-   */
-  readonly icon: string;
 }
 
 /**
@@ -4187,32 +4041,40 @@ interface ICFMenuNode extends ICFSubjectNode, ICFMultiSelectNodeMixin {
  * typescript会进行类型合并，这样在UI端就可以自己随意往其中塞数据，
  * 并且可以获得类型辨析功能
  */
-interface IRateItemCustomData {}
+interface IRateItemCustomData { }
 
 /**
- * 评分项标准
+ * 拥有自定义图标的对象规范
  */
-interface CFRateItem {
+interface CFCustomIconOwner {
   /**
-   * 由于UI端不可以更改任何核心包提供的数据
-   * 但是有时候可能需要放一些自定的数据在评分项上
-   * 这个属性就是专门给UI端放置自定义数据的地方
-   * 默认为一个空对象
+   * 自定义图标原始对象
    */
-  customData: IRateItemCustomData; // anti-readonly
+  readonly icon: ICFNodeIcon;
   /**
-   * 图标地址
+   * 解析后的未激活或未选中时的图标地址
    */
-  readonly url: string;
+  readonly normalIconUrl: string;
   /**
-   * 激活时的图标地址
+   * 解析后的被激活或者被选中时的图标url
+   * 未激活或者未选中时展示[[CFCustomIconOwner.normalIconUrl]]
+   *
+   * 激活或者选中时选中时展示[[CFCustomIconOwner.activeIconUrl]]
    */
-  readonly urlActive: string;
+  readonly activeIconUrl: string;
+}
+
+/**
+ * 评分项标准
+ */
+interface CFRateItem extends CFCustomIconOwner {
   /**
-   * 展示的图标
-   * @ignore
+   * 由于UI端不可以更改任何核心包提供的数据
+   * 但是有时候可能需要放一些自定的数据在评分项上
+   * 这个属性就是专门给UI端放置自定义数据的地方
+   * 默认为一个空对象
    */
-  readonly icon: ICFNodeIcon;
+  customData: IRateItemCustomData; // anti-readonly
   /**
    * 展示的文本
    */
@@ -4619,11 +4481,6 @@ interface CFNodeLayout extends CFThemeBase {
    * 选项标记与展示方式
    */
   readonly optMark: OPT_MARK;
-  /**
-   * 选项标记与展示方式
-   * @deprecated 为老UI准备的别名，不要使用
-   */
-  readonly optMarkOld: string;
   /**
    * 选项数值方式对齐规则
    */
@@ -4778,7 +4635,7 @@ interface ICFAutoInputConfig {
 /**
  * 验证选项数据
  */
-interface ICFValidateOptBase {
+interface CFValidateOptBase {
   /**
    * 日期级别
    * 1: 年
@@ -4834,7 +4691,7 @@ interface ICFValidateOptBase {
   readonly timeGrade?: number;
   /**
    * 供以选择的文字列表
-   * 当[[CFOption.inputRule]]是`dropdown`需要提供一个下拉列表选择空间
+   * 当[[CFValidateOptBase.fillType]]是`list_select`需要提供一个下拉列表选择空间
    * 空间中药展示的项目列表文字,就使用该属性的文字列表
    * 当选中某一个项时,就将该项的文字当做输入内容
    * 可以选择多项,每项之间用半角逗号分隔.
@@ -4859,7 +4716,7 @@ interface ICFValidateOptBase {
   readonly simpleCplt?: boolean;
   /**
    * 自动提示数据
-   * 当[[CFOption.inputRule]]是`autoComplete`需要提供一个自动提示输入控件
+   * 当[[CFValidateOptBase.fillType]]是`auto_complete`需要提供一个自动提示输入控件
    * 该控件在输入任何字符内容时,这些字符并不是答案，而是搜索字符
    * 需要使用从@choiceform/os-client-core/dist/support/atcp中提供的[[CFAtcp.getAutoCompleteData]]方法
    * 来搜索能匹配的提示项目，然后这些项目的name和icon属性显示为一个个标签到一个自动提示列表中供用户选择
@@ -4903,7 +4760,7 @@ interface ICFValidateOptBase {
 /**
  * 验证选项类型
  */
-interface CFValidateOpt extends CFOption, ICFValidateOptBase {}
+interface CFValidateOpt extends CFOption, CFValidateOptBase { }
 
 /**
  * 级联信息
@@ -4965,7 +4822,7 @@ interface CFCascade {
  * typescript会进行类型合并，这样在UI端就可以自己随意往其中塞数据，
  * 并且可以获得类型辨析功能
  */
-interface IOptionCustomData {}
+interface IOptionCustomData { }
 
 /**
  * 通用选项类
@@ -4988,11 +4845,6 @@ interface CFOption extends ICFPort {
    * 辅助输入数据
    */
   readonly assistValue: CFAssistProps;
-  /**
-   * 图标，代表不同选项的形象的图标，UI中可照此渲染
-   * @deprecated 仅为了兼容老UI暂时保留，新UI不要使用，在新的规则中，新UI可以自己判断情况，自由渲染
-   */
-  readonly icon: string;
   /**
    * @ignore
    */
@@ -5089,42 +4941,6 @@ interface CFOption extends ICFPort {
    * @ignore
    */
   readonly optComment: string;
-  /**
-   * @deprecated 不要使用，仅为老UI暂时保留，后续会移除, 新UI改用[[ICFValidateOptBase.fillType]]
-   * 填空选项的输入规则,有些输入方式需要提供输入控件支持
-   * 有些则只需要提供普通输入框
-   * 所有方式都可以根据类型显示对应的提示(图标?,文字? UI自己决定)
-   * 参照[[INPUT_RULE]]，有以下几中方式：
-   *
-   * + 输入字符,UI提供普通的输入框即可
-   *
-   * + 输入日期,UI需要提供日期输入控件
-   *
-   * + 输入日期范围,UI需要提供日期输入范围控件
-   *
-   * + 输入邮箱地址,UI提供普通输入框即可
-   *
-   * + 输入小数,UI需要提供数值输入控件
-   *
-   * + 输入整数,UI需要提供数值输入控件,且仅允许输入整数
-   *
-   * + 输入手机号码,UI仅需提供普通输入框
-   *
-   * + 输入邮政编码,UI仅需提供普通输入框
-   *
-   * + 输入时间范围,UI需要提供输入时间范围的控件
-   *
-   * + 输入时间间隔,UI需要提供输入时间间隔的控件
-   *
-   * + 输入网址,UI提供普通输入框即可
-   *
-   * + 自动提示输入模式,UI需要提供自动提示输入控件,提示内容参照[[ICFValidateOptBase.completeGroups]]
-   *
-   * + 下拉列表方式输入,UI需要提供一个下拉列表选择空间,列表中要展示的项目参照[[ICFValidateOptBase.selectList]]
-   *
-   * + 无要求,UI提供简单的输入框即可
-   */
-  readonly inputRule: INPUT_RULE;
 
   /**
    * @ignore
@@ -5194,19 +5010,8 @@ interface CFOption extends ICFPort {
 /**
  * 图标题选项
  */
-interface CFIconOption extends CFOption {
-  /**
-   * 选项未被选中时的图标url
-   */
-  readonly icon: string;
-  /**
-   * 选项被选中时的图标url
-   * 图标题选项的在选中和未选中时展示的图标不同
-   * 未选中是展示[[CFIconOption.icon]]
-   *
-   * 选中时展示[[CFIconOption.iconActive]]
-   */
-  readonly iconActive: string;
+interface CFSelectIconOption extends CFOption, CFCustomIconOwner {
+
 }
 
 /**
@@ -5226,7 +5031,11 @@ interface CFIconMarkOption extends CFOption {
   /**
    * 图形数量
    */
-  readonly count: number;
+  readonly iconCount: number;
+  /**
+   * 图形名称
+   */
+  readonly iconName: string;
 }
 
 /**
@@ -5262,7 +5071,7 @@ interface CFValueMarkOption extends CFOption {
 /**
  * 演示评价选项
  */
-interface CFSlideRateOption extends CFOption, CFSelectImageOption {}
+interface CFSlideRateOption extends CFOption, CFSelectImageOption { }
 
 /**
  * 权重选项
@@ -5344,9 +5153,9 @@ interface CFSelectImageOption extends CFOption {
  */
 interface ICFUploadResult {
   /**
-   * 上传后的在服务器上的文件名
+   * 上传后的在服务器上的文件路径
    */
-  readonly name: string;
+  readonly filePath: string;
   /**
    * 上传后的文件内容
    * 如果是图片则是图片的base64内容
@@ -5578,7 +5387,7 @@ interface ICFOptionRefer {
 /**
  * @ignore
  */
-interface ICFDataOption extends CFOption, CFIconOption, CFSelectImageOption {}
+interface ICFDataOption extends CFOption, CFSelectIconOption, CFSelectImageOption { }
 
 
 // -------------- types/outer/option/mapping.d.ts ---------------
@@ -5675,13 +5484,6 @@ interface CFQuestion extends ICFNode, ICFTypeInfo {
    * @ignore
    */
   readonly origin: ICFNode;
-  /**
-   * 自动提供好的题目渲染类型
-   * 你可以根据这个属性来决定渲染不同题目的模板
-   * 如choice的时候渲染选择题,short-text的时候渲染成填空题
-   * @deprecated 即将移除，仅为老UI暂时存在，不要使用
-   */
-  readonly quesType: QUES_TYPE;
   /**
    * 选择类型
    * 对于选择类型的题目有效,用于确定这是单选模式和多选模式
@@ -5876,14 +5678,14 @@ interface ICFMatrixResult {
  * 图标题
  * 渲染规则和选择题一样,参考[[CFSelectQuestion]]
  * 特殊点:
- * 图标题的选项是[[CFIconOption]]类型,可能包含图标.
- * 需要根据[[CFIconOption.icon]]和[[CFIconOption.iconActive]]渲染
+ * 图标题的选项是[[CFSelectIconOption]]类型,可能包含图标.
+ * 需要根据[[CFSelectIconOption.normalIconUrl]]和[[CFSelectIconOption.activeIconUrl]]渲染
  */
 interface CFSelectIconQuestion extends CFSubjectQuestion {
   /**
    * 图标选项列表
    */
-  readonly options: CFIconOption[];
+  readonly options: CFSelectIconOption[];
 }
 
 /**
@@ -6126,7 +5928,7 @@ interface CFHeatMapQuestion extends ICFHeatMapNode, CFSubjectQuestion {
  * 基本内容请参考选择题[[CFSelectQuestion]]
  * 特殊点,填空题的普通选项,都是输入型的选项[[CFValidateOpt.inputType]]为`input`
  *
- * 关注[[CFValidateOpt.inputRule]]的值,它定义了很多输入方式,在该属性上说明了每种方式应该渲染成什么样子
+ * 关注[[CFValidateOpt.fillType]]的值,它定义了很多输入方式,在该属性上说明了每种方式应该渲染成什么样子
  *
  * 选项被输入后,需要调用[[CFUIEventHandler.handleOptionInput]]方法
  *
@@ -6563,7 +6365,7 @@ interface CFLotteryPage extends ICFLotteryNode, CFQuestion {
  *
  * 而是,渲染出[[CFRegionQuestion.regions]]中的省市县下拉列表,让答题者选择省市区.
  *
- * 要考虑[[CFRegionQuestion.grade]]属性,它决定询问地区的级别,则只渲染到该级别的列表.
+ * 要考虑[[CFRegionQuestion.infoRange]]属性,它决定询问地区的级别,则只渲染到该级别的列表.
  *
  * 答题者选择地区列表后,需要回调[[CFUIEventHandler.handleManualLocate]]方法
  */
@@ -6582,14 +6384,6 @@ interface CFRegionQuestion extends CFSubjectQuestion {
    * 地域列表,需要将这几层地域信息渲染成一个多层列表供答题者选择
    */
   readonly regions: CFRegionProvince[];
-  /**
-   * 手动定位时的省市区选择级数,用于决定下拉列表渲染到多少级.
-   * 1: 只收集省级信息
-   * 2: 收集省-市信息
-   * 3: 收集省-市-县信息
-   * @deprecated 不要使用，老UI兼容保留，新版使用infoRange
-   */
-  readonly grade: number;
   /**
    * 定位结果
    * @ignore
@@ -7377,11 +7171,6 @@ interface CFRealtimeState extends CFSurveyState, CFStartState {
    * 中奖时间,预览奖励页面时才存在
    */
   readonly rewardTime?: string;
-  /**
-   * @deprecated
-   * 兼容老数据专用，即将移除，新UI不要使用
-   */
-  readonly quesType: 'reward';
 }
 
 
@@ -7483,11 +7272,6 @@ interface ICFRewardInfo extends ICFGiftNode, ICFLotteryResult, ICFCustomLogo {
    * @ignore
    */
   readonly quesTitle: string;
-  /**
-   * 问题渲染类型
-   * @deprecated 兼容老UI而存在，后续会被移除，不要使用
-   */
-  readonly quesType: string;
   /**
    * 图片列表
    */
@@ -7580,17 +7364,6 @@ interface CFRewardState extends ICFRewardInfo, CFStateBase {
    * 同description
    */
   readonly summary: string;
-  /**
-   * 用于渲染的图标
-   * @deprecated 即将移除，新UI不要使用
-   */
-  readonly icon: string;
-  /**
-   * 节点类渲染类型
-   * 兼容老UI
-   * @deprecated 即将移除，新UI不要使用
-   */
-  readonly nodeType: 'reward';
   /**
    * 奖励时间
    */
@@ -8075,13 +7848,6 @@ interface CFSurveyState
    * 预览工具信息
    */
   readonly previewTool?: CFPreviewTool;
-  /**
-   * 答案断点续答工具
-   * answerResumer的别名
-   * @deprecated 即将移除，新UI不要使用， 该属性是老UI使用.新产品中请使用answerResumer
-   * @ignore
-   */
-  readonly memoryTool?: CFAnswerResumer;
   /**
    * 答案断点续答工具
    */
@@ -8865,89 +8631,44 @@ interface CFPreviewTimeInfo {
  */
 interface CFQueryParams {
   /**
-   * key1的别名
-   */
-  readonly key?: string;
-  /**
-   * 系统附加参数1
-   */
-  readonly key1?: string;
-  /**
-   * 系统附加参数2
-   */
-  readonly key2?: string;
-  /**
-   * 系统附加参数3
-   */
-  readonly key3?: string;
-  /**
-   * 系统附加参数4
-   */
-  readonly key4?: string;
-  /**
-   * 系统附加参数5
-   */
-  readonly key5?: string;
-  /**
-   * 系统附加参数6
-   */
-  readonly key6?: string;
-  /**
-   * 系统附加参数7
-   */
-  readonly key7?: string;
-  /**
-   * 系统附加参数8
-   */
-  readonly key8?: string;
-  /**
-   * 系统附加参数9
-   */
-  readonly key9?: string;
-  /**
-   * 系统附加参数10
-   */
-  readonly key10?: string;
-  /**
-   * 系统附加参数11
-   */
-  readonly key11?: string;
-  /**
-   * 系统附加参数12
-   */
-  readonly key12?: string;
-  /**
-   * 系统附加参数13
-   */
-  readonly key13?: string;
-  /**
-   * 系统附加参数14
-   */
-  readonly key14?: string;
-  /**
-   * 系统附加参数15
-   */
-  readonly key15?: string;
-  /**
-   * 系统附加参数16
-   */
-  readonly key16?: string;
-  /**
-   * 系统附加参数17
+   * 离线任务唯一id，默认不会指定，只有离线应用需要指定
+   * 预览模式下会无视该参数
    */
-  readonly key17?: string;
+  readonly offline_task_id?: string;
   /**
-   * 系统附加参数18
+   * 离线问卷id，只有离线模式的时候会传入。
+   * 正式答题的时候，url是没有携带问卷id的，而是携带的收集器代码
+   * 问卷id都是获取问卷数据以后才能获取到的。
+   *
+   * 而离线的时候要很早就访问本地离线专属资源，这时候还没有问卷id。
+   *
+   * 所以依赖url参数上传输一个过来
+   *
+   * 离线模式下核心包需要
+   *
+   * 1. 拦截api通过通讯转发给app
+   *
+   * 2. 有些资源是写死的地址，编程模块中会直接通过ajax去请求这些资源，如多语言文本等，
+   *    可以在发起ajax请求的时候去拦截这些url，然后转成本地地址，在发出请求。
+   *
+   * 3. cfpd中有些资源，如图片，视频，图标等保存的是一个缺少主机名的路径，后续通过配置中的cdn主机名拼接这些路径形成一个完成的url，
+   *    这些资源一般不是通过ajax变成方式去请求的，而是浏览器直接发起请求的，所以无法在发出请求的时候去拦截，而是应该事先就把地址纠正掉。
+   *    需要篡改主机配置中的cdn主机地址，使得通过cdn主机地址拼接起来的cfpd中提供的url地址直接是指向本地的。
+   *
+   * 4. cfpd中还有些资源是写死的的地址，如自动提示图标，也是直接有浏览器请求的，需要在解析cfpd的时候去篡改掉这些地址。
+   *
+   * 5. 还有fake接口，是通过addScript添加到头部的，这个可以在addScript中拦截
+   *
    */
-  readonly key18?: string;
+  readonly offline_survey_id?: string;
   /**
-   * 系统附加参数19
+   * key1的别名
    */
-  readonly key19?: string;
+  readonly key?: string;
   /**
-   * 系统附加参数20
+   * 系统附加参数1
    */
-  readonly key20?: string;
+  readonly key1?: string;
   /**
    * 是否为开发模式,开启这个参数可以在本地调整正式环境的问卷
    * @ignore
@@ -9009,14 +8730,10 @@ interface CFQueryParams {
    */
   readonly infer_collector_id?: string;
   /**
-   * 收集器id，这个参数是必须的，如果是预览的时候则同问卷id一样
-   * 正式答题的时候则是一个收集器短id
+   * 收集器代码，这个参数是必须的，如果是预览的时候则同问卷id一样
+   * 正式答题的时候则是一个收集器代码
    */
   readonly sid: string;
-  /**
-   * 轻量版模板查看模式
-   */
-  readonly lite_template: string;
   /**
    * @ignore
    */
@@ -9146,7 +8863,7 @@ interface CFAnswerResumer {
   /**
    * 拒绝使用断点续答时的回调函数
    */
-  handleDeny(): void;
+  handleDeny(): Promise<void>;
 }
 
 /**
@@ -9243,7 +8960,7 @@ interface ICFOptionCache {
   readonly records: CFMaxDiffRecord[];
   readonly sortNo: number;
   readonly value: string | number;
-  readonly name: string;
+  readonly filePath: string;
   readonly fileName: string;
   readonly isImage: boolean;
   readonly fileType: string;