@choiceform/os-client-core 3.3.3 → 3.4.0

package/index.d.ts

@@ -166,18 +166,27 @@ interface CFEnvSystem {
    * 生成一个div
    * 举例，web端提供的该方法为如下，其他端需要使用兼容的方式提供
    * ```typescript
-   * function parseHtml(html?:string):HTMLElement {
+   * function newDiv():HTMLElement {
    *   return document.createElement('div');
-
    * }
    * ```
    */
   newDiv(): HTMLElement;
+  /**
+   * 生成一个div
+   * 举例，web端提供的该方法为如下，其他端需要使用兼容的方式提供
+   * ```typescript
+   * function newDiv():HTMLElement {
+   *   return document.createElement('div');
+   * }
+   * ```
+   */
+  newSpan(): HTMLSpanElement;
   /**
    * 生成一个文本节点的方法
    * 举例，web端提供的该方法为如下，其他端需要使用兼容的方式提供
    * ```typescript
-   * function newTextNode(html:string):Text {
+   * function newTextNode():Text {
    *   return document.createText();
    * }
    * ```
@@ -373,6 +382,13 @@ interface CFEnvNetWork {
    * 默认行为：什么也不做
    */
   closeSocket?(): void;
+  /**
+   * 推动socket消息的方法
+   * 默认行为：什么也不做
+   * @param message 消息名
+   * @param payload 附带的数据
+   */
+  pushSocket?(message:string, payload: object): void;
 }
 /**
  * 授权相关的配置，不同的运行平台有不同的账户系统，所以授权方式也不一样。
@@ -492,9 +508,9 @@ interface CFEnvHook {
   beforeForceLeave?(): void;
   /**
    * 当语言发生变化时的回调
-   * @param lang 语言代号：zh_cn/en_us/ja_jp格式
+   * @param langItem
    */
-  onLangChange?(lang: string): void;
+  onLangChange?(langItem: CFLangTableItem): void;
   /**
    * 当进行上一题/下一题切换题目时的回调
    */
@@ -1695,16 +1711,6 @@ declare const enum OPT_MARK {
    * 块状选项
    */
   BLOCK = 'block',
-  /**
-   * 只有级联题使用，
-   * 展示成下拉列表嵌套选择
-   */
-  DROPDOWN = 'dropdown',
-  /**
-   * 只有级联题使用
-   * 展示成普通选项嵌套选择
-   */
-  STRETCH = 'stretch',
 }
 
 /**
@@ -1869,24 +1875,6 @@ declare const enum OPT_MAP_TYPE {
   NUMBER = 'number',
 }
 
-/**
- * 矩阵展示方式枚举
- */
-declare const enum MATRIX_DISPLAY {
-  /**
-   * 自动适应
-   */
-  AUTO = 'auto',
-  /**
-   * 层级排布
-   */
-  STRETCH = 'stretch',
-  /**
-   * 展示成矩阵表
-   */
-  MATRIX = 'matrix',
-}
-
 /**
  * 权重输入方式
  */
@@ -2027,20 +2015,6 @@ declare const enum VERIFY_TYPE {
   IMAGE = 'image',
 }
 
-/**
- * 演示评价题评分方式枚举
- */
-declare const enum SLIDE_RATE_TYPE {
-  /**
-   * 演示评价
-   */
-  SLIDE = 'slide',
-  /**
-   * 表格评价
-   */
-  TABLE = 'table',
-}
-
 /**
  * 表格评价时的表头展示方式枚举
  */
@@ -2209,7 +2183,7 @@ declare const enum VAR_TYPE {
    */
   VAR_MEDIA = 'var-media',
   /**
-   * 循环变量
+   * 循环仰视变量
    */
   VAR_LOOP = 'var-loop',
   /**
@@ -2745,6 +2719,78 @@ interface ICFStretchConfig {
 }
 
 
+// -------------- types/outer/flow/group-table.d.ts ---------------
+
+/**
+ * 单页组表格
+ * 主要用于在答题过程中，如果是单页组并且开始了 renderAsTable 这个选项的时候
+ * 需要优先使用这个字段来渲染，
+ * 在这种模式下，单页组中的题目按照表格的形式渲染题目
+ */
+interface ISinglePageGroupTable {
+  /**
+   * 表格标题
+   */
+  title: string
+  /**
+   * 表格头部数据
+   */
+  header: ISinglePageGroupTableHeaderCell[]
+  /**
+   * 每一行的数据
+   */
+  rows: ISinglePageGroupTableRow[]
+
+}
+
+/**
+ * 单页组的某一列的数据结构
+ */
+interface ISinglePageGroupTableHeaderCell {
+  /**
+   * 列的标题
+   */
+  title: string
+  /**
+   * 列的uuid
+   */
+  uuid: string
+}
+
+/**
+ * 单页组的一行的数据结构
+ */
+interface ISinglePageGroupTableRow {
+  /**
+   * uuid
+   */
+  uuid: string
+  /**
+   * 行头需要显示的文本
+   */
+  readonly title: string;
+  /**
+   * 每一行所关联的问题，横向排布。
+   */
+  cells: ISinglePageGroupTableRowCell[]
+}
+
+/**
+ * 单页组的一行的数据结构
+ */
+interface ISinglePageGroupTableRowCell {
+  /**
+   * cell 的 uuid
+   * 在有node 的情况下，会使用node的renderId 
+   * 如果没有的家。则自动生成一个uuid
+   */
+  uuid: string
+  /**
+   * 单元格子内的关联问题
+   */
+  node?: CFQuestion
+}
+
 // -------------- types/outer/flow/payload.d.ts ---------------
 
 /**
@@ -3459,6 +3505,15 @@ interface ICFNodeGroup {
    * 组内节点排列方向
    */
   readonly displayDirection: GROUP_DISPLAY_DIRECTION;
+  /**
+   * 是否需要渲染成单页表格的样式
+   * @param
+   */
+  readonly renderAsTable?: boolean;
+  /**
+   * 如果需要渲染成单页表格，则这个就是表格上方的标题
+   */
+  readonly tableTitle?: string;
 }
 //#endregion
 
@@ -3613,6 +3668,10 @@ interface ICFNode {
    * @ignore
    */
   readonly questionText: string;
+  /**
+   * 是否隐藏问题区，如果为true，不要渲染node-head
+   */
+  readonly headHidden?: boolean;
   /**
    * 原始问题描述
    * @ignore
@@ -3651,7 +3710,7 @@ interface ICFNode {
   /**
    * @ignore
    */
-  readonly realNodeName: string;
+  readonly runtimeNodeName: string;
   /**
    * 节点类型
    */
@@ -3938,11 +3997,6 @@ interface ICFMatrixNode extends ICFSubjectNode {
    * 如果是以列为主,则先列后行
    */
   readonly flatten: CFFlatItem[];
-  /**
-   * 矩阵展示方式
-   * UI根据不同的类型,展示成不同的方格
-   */
-  readonly displayType: MATRIX_DISPLAY;
   /**
    * 列选项
    * @ignore
@@ -4495,7 +4549,7 @@ interface ICFStartNode extends ICFNode, ICFStartMiniState, ICFOutputNodeMixin, C
  * 循环节点
  * @ignore
  */
-interface ICFLoopNode extends ICFInOutNodeMixin {
+interface ICFLoopNode extends ICFInOutNodeMixin , ICFOptNodeMixin {
   readonly loopEnd: ICFPort;
   readonly loopStart: ICFPort;
 }
@@ -4564,7 +4618,7 @@ interface ICFOptGroupNodeMixin extends ICFNode {
    * 选项分组设置，当题目上发现该属性时，放弃使用[[CFSubjectQuestion.options]]，转而使用该属性的结构来渲染选项
    * 该属性是树形递归结构,
    * 虽然当前所有题目的类型上都有该属性，
-   * 但只有`选择题`，`图标选择题`，`图片选择题`，`分值打分题`，`图形打分题`，`填空题`，`权重题`等这几题需要支持组渲染
+   * 但只有`选择题`，`图标选择题`，`图片选择题`，`拖拽打分题`，`图形打分题`，`填空题`，`数值分配题`等这几题需要支持组渲染
    * 
    * 其他题目还是维持以前的状态。
    * 
@@ -5140,22 +5194,6 @@ interface CFOption extends ICFPort {
    * UI需要渲染该消息,让答题者知道为什么错了
    */
   readonly errorMessage: string;
-  /**
-   * @ignore
-   */
-  readonly _previewTransferred: boolean;
-  /**
-   * 原始索引
-   * @ignore
-   */
-  readonly index: number;
-  /**
-   * 展示后的真实索引,未展示的为负值.
-   * 因为选项可能被隐藏,索引需要保证真实索引
-   * 用于在随机顺序追随引用源时作为可靠的参考
-   * @ignore
-   */
-  readonly realIndex: number;
   /**
    * @ignore
    */
@@ -5285,7 +5323,7 @@ interface CFIconMarkOption extends CFOption {
 }
 
 /**
- * 分值打分题选项
+ * 拖拽打分题选项
  */
 interface CFValueMarkOption extends CFOption {
   /**
@@ -5454,10 +5492,7 @@ interface CFUploadOption extends CFOption, ICFUploadResult {
   readonly image: CFImageInNode;
 }
 
-/**
- * 图片热点选项
- */
-interface CFHotSpotOption extends CFOption {
+interface CFHotSpotGraph {
   /**
    * @ignore
    */
@@ -5466,6 +5501,10 @@ interface CFHotSpotOption extends CFOption {
    * @ignore
    */
   readonly y: number;
+  /**
+   * 唯一id
+   */
+  readonly uuid: string;
   /**
    * 偏移
    */
@@ -5475,11 +5514,7 @@ interface CFHotSpotOption extends CFOption {
    */
   readonly pathD: string;
   /**
-   * 颜色
-   */
-  readonly color: string;
-  /**
-   * @ignore
+   * 图形区域，主要用于判断图形层级，图形区域小的应该在图形面积大的上方
    */
   readonly area: number;
   /**
@@ -5488,6 +5523,20 @@ interface CFHotSpotOption extends CFOption {
   points: { x: number; y: number }[];
 }
 
+/**
+ * 图片热点选项
+ */
+interface CFHotSpotOption extends CFOption {
+  /**
+   * 颜色
+   */
+  readonly color: string;
+  /**
+   * 图形列表
+   */
+  graphs: CFHotSpotGraph[]
+}
+
 /**
  * 热图选项
  */
@@ -5580,14 +5629,6 @@ interface ICFRefOption extends CFOption {
    * 关联的选项引用id
    */
   readonly referId: string;
-  /**
-   * 引用源的真实索引
-   */
-  readonly refIndex: number;
-  /**
-   * 引用源展示后的真实索引
-   */
-  readonly refRealIndex: number;
 }
 
 /**
@@ -5698,11 +5739,6 @@ interface CFQuestion extends ICFNode, ICFTypeInfo {
    * @ignore
    */
   readonly actions: ICFNodeAction[];
-  /**
-   * 刷新动态属性
-   * @ignore
-   */
-  dynamicNodeProps: () => void;
   /**
    * 是否已经被回复，包含了答案
    */
@@ -5773,10 +5809,6 @@ interface CFQuestion extends ICFNode, ICFTypeInfo {
    * 前一道题
    */
   readonly prev: CFQuestion;
-  /**
-   * 后一道题
-   */
-  readonly next: CFQuestion;
   /**
    * 编号,该题的唯一代号
    * 如果有该属性,UI要渲染
@@ -5954,7 +5986,6 @@ interface CFSequenceQuestion extends CFSubjectQuestion {
  *
  * 或者使用[[CFMatrixQuestion.flatten]]渲染层级排布方式的选项
  *
- * 使用哪种方式由[[CFMatrixQuestion.displayType]]决定
  *
  * 矩阵题的普通选项也是选择类型的,点击后调用[[CFUIEventHandler.handleOptionClick]]方法
  *
@@ -6087,12 +6118,12 @@ interface CFVerifyQuestion extends ICFValidateNode, CFQuestion {
 }
 
 /**
- * 图片热点题
+ * 图片框选题
  * 基本内容请参考选择题[[CFSelectQuestion]]
- * 特殊点,图片热点题的选项不是以列表方式渲染的,而是以覆盖在图片上的区域点的方式渲染
- * 图片热点题的选项是[[CFHotSpotOption]]类型
+ * 特殊点,图片框选题的选项不是以列表方式渲染的,而是以覆盖在图片上的区域点的方式渲染
+ * 图片框选题的选项是[[CFHotSpotOption]]类型
  *
- * 渲染图片热点题的选项再渲染时,先使用[[CFHotSpotQuestion.mapImage]]渲染出底图.
+ * 渲染图片框选题的选项再渲染时,先使用[[CFHotSpotQuestion.mapImage]]渲染出底图.
  *
  * 在根据每个选项的路径[[CFHotSpotOption.pathD]]和位置[[CFHotSpotOption.transform]]在底图上方绘制选项区域.
  *
@@ -6159,73 +6190,9 @@ interface CFFillQuestion extends ICFFillNode, CFSubjectQuestion {
 }
 
 /**
- * 演示评价题
+ * 连续评价题
  * 基本内容请参考选择题[[CFSelectQuestion]]
- *
- * 特殊点:演示评价题通过[[CFSlideRateQuestion.rateType]]属性区分有两种评分方式的UI：
- *
- * 1. slide-演示评价
- *
- * 它的普通选项不是直接以列表的方式展示出来,而是一页一个逐一展示出来的.
- * 它的选项是[[CFSlideRateOption]]类型的数组
- * 每次只渲染一个选项,选项中如有有文字和图片需要渲染
- * 同时关注[[CFSlideRateQuestion.rateOptions]]属性,为该选项渲染出几个打分图形和打分文字.
- * 每个图形和文字代表不同的分值,当答题者点击这些图形的时候就是为该选项评分
- * 评分后需要调用[[CFUIEventHandler.handleOptionInput]]方法
- *
- * 需要进行分页控制：
- * - 初始渲染[[CFSlideRateQuestion.currentOption]];
- * - 渲染上一页，下一页按钮，点击后分别调用[[CFSlideRateQuestion.gotoNextOption]]方法
- * 或[[CFSlideRateQuestion.gotoPrevOption]]方法要求核心包来切换当前选项，[[CFSlideRateQuestion.gotoOption]]跳转到指定的选项
- * - 当前是几分之几项如：1/6，每次切任务后更新进度，当前索引可以到靠查询当前选项在总选项表中的位置获取到。
- *
- * 2. table-表格评价
- *
- * 使用[[CFSlideRateQuestion.options]]与[[CFSlideRateQuestion.rateOptions]]组成生成表格
- * [[CFSlideRateQuestion.options]]当行，[[CFSlideRateQuestion.rateOptions]]当列。
- *
- * 比如下面的水果是选项，喜欢不喜欢是评价项，
- * 这UI看起来和矩阵题的行列单选简直一模一样，但其实是个打分题，提交数据的结构和矩阵题是不一样的。
- *
- *
- * |  |非常不喜欢|比较不喜欢|一般|比较喜欢|非常喜欢|
- * | :-: |  :-:  |  :-:  | :-: |  :-:  | :-: |
- * |    | 1  | 2  |3   | 4  | 5  |
- * |苹果| ○  |  ⊙ | ○  | ○  | ○  |
- * |香蕉| ○  |  ○ | ○  | ○  | ⊙  |
- * |雪梨| ○  |  ○ | ○  | ⊙  | ○  |
- * |菠萝| ○  |  ○ | ○  | ○  | ⊙  |
- *
- *
- *
- * 默认表头会显示两行，第一行是评价项的文字，第二行是评价项的分值
- * 参照[[CFSlideRateQuestion.tableHead]]的值来控制表头的展示方式，有以下可能：
- *
- * + none: 不显示表头
- * + text: 仅显示文字表头
- * + value: 仅显示分值表头
- * + text_value 同时显示文字表头和分值表头，文字表头在上。
- *
- *
- * 点击某个网格时调用[[CFUIEventHandler.handleOptionInput]]方法
- * 传入的分值就是该网格所在列对应的评价项的分值，传入的选项就是该网格所在的行所对应的选项。
- *
- * 渲染网格时检查网格所在行的选项的分值是否和网格所在列的评价项的分值一致，如果一致，则这个网格要被选中。
- *
- * 如果相邻的评价项是一样的（包含都是空字符串的情况）则相邻的的文字表头网格需要合并
- *
- * 如：五个评价项的文字分别是 讨厌-无感-无感-无感-喜欢，则中间三个无感要合并成一个单元格
- *
- * 分值表头则不需要合并
- *
- * 表格评价模式下表头和选项的文字中可能有富文本，需要能支持。
- *
- * 表格评价模式下选项的图片和评价项的图标无视掉，无需支持。
- *
- * 这个情况一般是在较大屏上使用，简单起见对小屏的是适配暂无要求
- * 如果在手机上存在评价项较多即使尽量挤压也在水平方向上显示不下的情况，
- * 这时候让它自动超出屏幕触发系统滚动条也是可以的。
- *
+ * 
  * 其他选项的渲染方式和选择题一样
  *
  */
@@ -6254,10 +6221,6 @@ interface CFSlideRateQuestion extends ICFSlideRateNode, CFSubjectQuestion {
    * 切换到指定选项
    */
   gotoOption(option: CFSlideRateOption): void;
-  /**
-   * 评价UI展示方式
-   */
-  readonly rateType: SLIDE_RATE_TYPE;
   /**
    * 表格评价时的表头展示方式
    */
@@ -6265,11 +6228,11 @@ interface CFSlideRateQuestion extends ICFSlideRateNode, CFSubjectQuestion {
 }
 
 /**
- * 权重题
+ * 数值分配题
  *
  * 基本内容请参考选择题[[CFSelectQuestion]]
  *
- * 特殊点:权重题的普通选项要以可评分的方式渲染出来,输入框输入分值,或滑杆拖动输入分值等等都可,UI自行决定.
+ * 特殊点:数值分配题的普通选项要以可评分的方式渲染出来,输入框输入分值,或滑杆拖动输入分值等等都可,UI自行决定.
  *
  * 当输入分值后,需要调用[[CFUIEventHandler.handleOptionInput]]方法
  *
@@ -6317,10 +6280,10 @@ interface CFWeightQuestion extends CFSubjectQuestion {
 
 
 /**
- * 分值打分题
+ * 拖拽打分题
  * 基本内容请参考选择题[[CFSelectQuestion]]
  *
- * 特殊点:分值打分题的每个选项是用于评分的,一般渲染一个滑杆让答题者拖动滑杆评分
+ * 特殊点:拖拽打分题的每个选项是用于评分的,一般渲染一个滑杆让答题者拖动滑杆评分
  * 选项是[[CFValueMarkOption]]类型,其中定义了最大分支,最小分值限制,每次拖动滑杆时的分值步进
  * 还有最大分值描述,和最小分值描述,这些内容可以选择性的渲染.
  * 答题者给选项评分后需要回调[[CFUIEventHandler.handleOptionInput]]方法
@@ -6500,7 +6463,7 @@ interface CFCascadeQuestion extends ICFCascadeNode, CFSubjectQuestion {
 }
 
 /**
- * 描述节点
+ * 素材展示页面
  *
  * 没有选项，其他方面同选择题[[CFSelectQuestion]]
  *
@@ -6804,15 +6767,15 @@ interface CFMaxDiffTask {
 }
 
 /**
- * 最大差分题
+ * MaxDiff问题
  * 基本内容请参考选择题[[CFSelectQuestion]]
  *
  * 特殊点：
  *
  *
- * 最大差分题不直接渲染选项，而是渲染任务:其中总任务列表时[[CFMaxDiffQuestion.tasks]]，不直接渲染这个列表，
+ * MaxDiff问题不直接渲染选项，而是渲染任务:其中总任务列表时[[CFMaxDiffQuestion.tasks]]，不直接渲染这个列表，
  *
- * 而是像演示评价题一样一次只显示一个任务卡片[[CFMaxDiffQuestion.currentTask]]。
+ * 而是像连续评价题一样一次只显示一个任务卡片[[CFMaxDiffQuestion.currentTask]]。
  *
  * 卡片展示成下面这样：
  *
@@ -6833,14 +6796,14 @@ interface CFMaxDiffTask {
  *
  * 渲染的时候也是当[[CFMaxDiffTaskItem.value]]为1时，左侧checkbox被选中，如果为-1时，右侧checkbox被选中。
  *
- * 由于一个最大差分题包含多一个任务页，所以需要提供切换任务的功能
+ * 由于一个MaxDiff问题包含多一个任务页，所以需要提供切换任务的功能
  *
  * 1. 渲染当前[[CFMaxDiffQuestion.currentTask]]任务卡片
  *
  * 2. 渲染`上一页`,`下一页`按钮，点击后分别调用[[CFMaxDiffQuestion.gotoPrevTask]]方法或[[CFMaxDiffQuestion.gotoNextTask]]方法来要求
  * 核心包切换当前任务, [[CFMaxDiffQuestion.gotoTask]]跳转到指定的任务。
  *
- * 3. 同时像演示评价题一样显示当前是几分之几项如：1/6，每次切任务后更新进度。当前索引可以到靠查询当前任务在总任务中的位置获取到。
+ * 3. 同时像连续评价题一样显示当前是几分之几项如：1/6，每次切任务后更新进度。当前索引可以到靠查询当前任务在总任务中的位置获取到。
  *
  */
 interface CFMaxDiffQuestion extends CFSubjectQuestion, ICFMaxDiffNode {
@@ -6879,9 +6842,9 @@ interface ICFDataHub extends ICFSubjectNode, CFSubjectQuestion {
  * 虚拟循环题
  * @ignore
  */
-interface ICFLoopHub extends ICFLoopNode, CFQuestion {
+interface ICFLoopHub extends ICFLoopNode, CFQuestion , ICFOptNodeMixin{
   /**
-   * 包含的循环变量列表
+   * 包含的循环仰视变量列表
    */
   readonly varList: ICFLoopVar[];
 }
@@ -8144,20 +8107,13 @@ interface CFSurveyState
    * @ignore
    */
   readonly resumeEnabled: boolean;
+
+
   /**
-   * 单页的时候方便获取到第一个题目
-   * @ignore
-   */
-  first: () => CFQuestion;
-  /**
-   * 单页的时候方便获取到最后一个题目
-   * @ignore
-   */
-  last: () => CFQuestion;
-  /**
-   * @ignore
+   * 是否需要以表格的方式渲染问题，
+   * 这个的优先级比 nodes 的要高
    */
-  dynamicStateProps: () => Promise<void>;
+  groupTable?: ISinglePageGroupTable
 }
 
 
@@ -8269,6 +8225,10 @@ interface CFLangTableItem {
    * 语言名称
    */
   readonly value: string;
+  /**
+   * 语言方向，不指定则认为是ltr
+   */
+  direction?: 'rtl' | 'ltr'
 }
 
 /**
@@ -8892,6 +8852,10 @@ interface CFPreviewTimeDisplay {
    * 节点名称
    */
   readonly name: string;
+  /**
+   * 唯一渲染id
+   */
+  readonly renderId: string;
   /**
    * 节点描述
    */
@@ -9281,7 +9245,7 @@ interface ICFQuestionCache {
   readonly failedSkipActivated: boolean;
   readonly tasks: ICFMaxDiffTaskCache[];
   /**
-   * 最大差分题和演示评价题当前任务索引
+   * MaxDiff问题和连续评价题当前任务索引
    */
   readonly currentTaskIndex: number;
   readonly rankList: string[];
@@ -9382,7 +9346,7 @@ interface CFUIEventHandler {
 
   /**
    * 选项点击回调,适用题型:
-   * 选择题/图标题/图片选择题/矩阵题/图片热点题/图片上传题点击上传
+   * 选择题/图标题/图片选择题/矩阵题/图片框选题/图片上传题点击上传
    * @param option 点击的选项
    * @param question 所在题目
    */
@@ -9431,7 +9395,7 @@ interface CFUIEventHandler {
   handleGetCodeClick?(question: CFQuestion): Promise<void>;
 
   /**
-   * 选项输入回调函数:适用题目填空题,打分题,权重题,演示评价题,上传题,输入方式排序或挑选方式排序的排序题以及有其他选项需要输入的题型
+   * 选项输入回调函数:适用题目填空题,打分题,数值分配题,连续评价题,上传题,输入方式排序或挑选方式排序的排序题以及有其他选项需要输入的题型
    * 对与挑选排序的排序题，如果是要放弃序号，data参数传入-1即可
    * @param data 输入的数据
    * @param option 所在的选项
@@ -9506,7 +9470,7 @@ interface CFUIEventHandler {
     sortTargetOpt: CFSequenceOption,
   ): Promise<void>;
   /**
-   * 最大差分题评分后的回调
+   * MaxDiff问题评分后的回调
    * @param value 分值，只能是-1或者1
    * @param item 被评价的项目
    * @param task 关联的任务
@@ -9999,9 +9963,9 @@ interface ICFVarInfo extends ICFVarDetail, ICFVarRaw, ICFVarPart {
    */
   readonly optionFilter?: ICFVarPart;
   /**
-   * 关联循环节点的id
+   * 循环仰视变量关联循环节点的id
    */
-  readonly loopNodeId?: string;
+  readonly lookupLoopNodeId?: string;
   /**
    * 用于变量映射表中匹配变量的映射id,一般有uuid,limit,limitSrc,limitRnd拼接而成
    */
@@ -10010,6 +9974,20 @@ interface ICFVarInfo extends ICFVarDetail, ICFVarRaw, ICFVarPart {
   readonly inEdist?: boolean;
 }
 
+/**
+ * 内部循环轮次，仅靠```ICFLoopVar```不能找到真正的循环圈。
+ * 所以需要记忆它所属的外部轮次ID
+ */
+interface ICFInnerLoopVar {
+  /**
+   * 外部轮次Id
+   */
+  readonly outerRoundId: string;
+  /**
+   * 关联轮次
+   */
+  round: ICFLoopVar
+}
 /**
  * @ignore
  */
@@ -10221,6 +10199,24 @@ interface IRawVarIdentity {
    * 选项数据分部id
    */
   readonly optPartId: string;
+  /**
+   * 关联循环节点后8位id
+   */
+  readonly loopNodeId?: string;
+  /**
+   * 关联的第几轮循环
+   * 如果是`LOOP_ALL_ROUND`,则是所有次循环
+   * 如果是某个循环选项的8位短id，则是该循环选项的这次循环
+   */
+  readonly loopRoundId?: VAR_CONST.LOOP_ALL_ROUND | string;
+  /**
+   * 同上，但针对内层循环
+   */
+  readonly innerLoopNodeId?: string;
+  /**
+   * 同上，但针对内层循环
+   */
+  readonly innerLoopRoundId?: VAR_CONST.LOOP_ALL_ROUND | string;
 }
 
 
@@ -10381,7 +10377,7 @@ interface CFVarStyleGroup {
    */
   readonly reqJson: CFVarStyle;
   /**
-   * 循环变量，对应var-loop
+   * 循环仰视变量，对应var-loop
    */
   readonly loopJson: CFVarStyle;
 }