@skopon-cool/form-sdk 0.6.2 → 0.6.4

package/dist/submit/buildAnswerAgentBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildAnswerAgentBody.d.ts","sourceRoot":"","sources":["../../src/submit/buildAnswerAgentBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAA;AAEzC,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAmBD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,yBAAyB,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,uBAAuB,GAAG,UAAU,GAAG,IAAI,CAAA;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,OAAO,EACP,IAAI,EACJ,MAAM,GACP,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAevD;AAED,iDAAiD;AACjD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAqBpF;AAED,iCAAiC;AACjC,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,yBAAyB,GACjC,MAAM,GAAG,IAAI,CAQf"}
+{"version":3,"file":"buildAnswerAgentBody.d.ts","sourceRoot":"","sources":["../../src/submit/buildAnswerAgentBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,kCAAkC,CAAA;AAEzC,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAqBD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,yBAAyB,CAAA;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,uBAAuB,GAAG,UAAU,GAAG,IAAI,CAAA;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,OAAO,EACP,IAAI,EACJ,MAAM,GACP,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAevD;AAED,iDAAiD;AACjD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAqBpF;AAED,iCAAiC;AACjC,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,yBAAyB,GACjC,MAAM,GAAG,IAAI,CAQf"}

package/dist/submit/intersectPayloadBlocksWithForm.d.ts

@@ -1,5 +1,6 @@
 import type { FormBlock, FormSchema } from '../types/index';
-export type PayloadBlocksDefinition = Pick<FormSchema, 'title' | 'description' | 'blocks'> & {
+export type PayloadBlocksDefinition = Pick<FormSchema, 'title' | 'description' | 'modules' | 'blocks'> & {
+    schema?: 'skopon.material-form/v2';
     /**
      * ask 原始 blocks（normalize 前）。交集合并按此键集覆盖 form，
      * 避免 normalize 填入的空默认值误盖表单样式。
@@ -13,6 +14,14 @@ export interface PayloadBlocksIntersection {
     renderBlocks: FormBlock[];
     title: string;
     description: string;
+    modules?: FormSchema['modules'];
+}
+export interface IntersectPayloadBlocksOptions {
+    /**
+     * snapshot：消息快照中的显式配置优先（兼容旧行为）；
+     * latest：最新表单负责布局/文案/校验，只保留快照里的填写与审核运行态。
+     */
+    definitionPolicy?: 'snapshot' | 'latest';
 }
 /** 解析 ask_user payload 为 blocksJson 形（title / description / blocks） */
 export declare function parsePayloadBlocksJson(payload: unknown): PayloadBlocksDefinition | null;
@@ -20,7 +29,7 @@ export declare function parsePayloadBlocksJson(payload: unknown): PayloadBlocksD
  * payload.blocks 与 vt_forms 按 input 块 name 取交集用于渲染；
  * payload 中 form 不存在的块归入 extraBlocks（不渲染，提交时写入 curl）。
  */
-export declare function intersectPayloadBlocksWithForm(payloadDef: PayloadBlocksDefinition, formDefinition: FormSchema | undefined): PayloadBlocksIntersection;
+export declare function intersectPayloadBlocksWithForm(payloadDef: PayloadBlocksDefinition, formDefinition: FormSchema | undefined, options?: IntersectPayloadBlocksOptions): PayloadBlocksIntersection;
 /** 从 extraBlocks 提取提交值（优先 defaultValue） */
 export declare function extractExtraBlockValues(extraBlocks: FormBlock[]): Record<string, unknown>;
 /** payload 是否含至少一个具 name 的 input 块（可用于卡片 fallback） */

package/dist/submit/intersectPayloadBlocksWithForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intersectPayloadBlocksWithForm.d.ts","sourceRoot":"","sources":["../../src/submit/intersectPayloadBlocksWithForm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3D,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC,GAAG;IAC3F;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAA;CACxB,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,SAAS,EAAE,CAAA;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAA;IACxB,gEAAgE;IAChE,YAAY,EAAE,SAAS,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AA+ED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAmBvF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,uBAAuB,EACnC,cAAc,EAAE,UAAU,GAAG,SAAS,GACrC,yBAAyB,CA+B3B;AA+BD,2CAA2C;AAC3C,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzF;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAOlF;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,EAAE,CAQ3F;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,EAAE,CASvF;AAED,6DAA6D;AAC7D,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,uBAAuB,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}
+{"version":3,"file":"intersectPayloadBlocksWithForm.d.ts","sourceRoot":"","sources":["../../src/submit/intersectPayloadBlocksWithForm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3D,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC,GAAG;IACvG,MAAM,CAAC,EAAE,yBAAyB,CAAA;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAA;CACxB,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,SAAS,EAAE,CAAA;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAA;IACxB,gEAAgE;IAChE,YAAY,EAAE,SAAS,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;CAChC;AAUD,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAA;CACzC;AAiGD,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAsBvF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,uBAAuB,EACnC,cAAc,EAAE,UAAU,GAAG,SAAS,EACtC,OAAO,CAAC,EAAE,6BAA6B,GACtC,yBAAyB,CAwC3B;AA+BD,2CAA2C;AAC3C,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzF;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAOlF;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,EAAE,CAQ3F;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,EAAE,CASvF;AAED,6DAA6D;AAC7D,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,uBAAuB,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/dist/types/index.d.ts

@@ -4,7 +4,15 @@
 export type A2uiBinding<T> = T | {
     path: string;
 };
-export type A2uiComponentName = 'Column' | 'Row' | 'Text' | 'Image' | 'Video' | 'AudioPlayer' | 'TextField' | 'CheckBox' | 'ChoicePicker' | 'DateTimeInput' | 'FileUpload' | 'SkoponMedia' | 'SkoponWeb' | 'SkoponSelect' | 'SkoponResumeSelect' | 'SkoponCaseSelect';
+export type A2uiComponentName = 'Column' | 'Row' | 'Text' | 'Image' | 'Video' | 'AudioPlayer' | 'TextField' | 'CheckBox' | 'ChoicePicker' | 'DateTimeInput' | 'FileUpload' | 'SkoponMedia' | 'SkoponWeb' | 'SkoponSelect' | 'SkoponResumeSelect' | 'SkoponCaseSelect' | 'SkoponModulePanel';
+/** 表单分组模块。运行时以 Tab 展示，要求与示例统一放在模块底部。 */
+export interface FormModule {
+    id: string;
+    label: string;
+    description?: string;
+    reviewCriteria?: string;
+    exampleUrls?: string[];
+}
 export interface A2uiComponentNode {
     id: string;
     component: A2uiComponentName | string;
@@ -31,6 +39,13 @@ export interface FormBlockOption {
     value: string;
     label: string;
 }
+export interface FormAssetOption {
+    assetId: string;
+    url: string;
+    previewUrl?: string;
+    label: string;
+    assetType?: string;
+}
 export type FormConditionOperator = 'eq' | 'ne' | 'empty' | 'notEmpty';
 export interface FormBlockCondition {
     fieldName: string;
@@ -99,6 +114,25 @@ export interface FormBlock {
     filePlaceholderIcon?: FormFilePlaceholderIcon;
     fileMinCount?: number;
     fileMaxCount?: number;
+    /** 上传素材的示例图，仅展示，不参与提交。 */
+    fileExampleUrls?: string[];
+    /** 制作模板的逐字段审核标准；由工作流读取，不能使用提交值覆盖。 */
+    fileReviewCriteria?: string;
+    /** 是否需要由工作流审核上传内容；素材库已审核素材可以关闭。 */
+    fileReviewRequired?: boolean;
+    /** 物料采集来源模式，由 skopon-admin 环节配置。 */
+    fileSourceMode?: 'upload_required' | 'upload_or_asset' | 'asset_only';
+    /** 通用收集流从 Footage 为当前素材位查询的候选；仅提交选中的文件 URL。 */
+    fileAssetOptions?: FormAssetOption[];
+    /** 对应 Footage 同步素材位的限定 key。 */
+    assetSlotKey?: string;
+    assetType?: 'image' | 'video' | 'audio' | 'text';
+    /** 运行时素材审核状态；用于返工表单回显，不作为用户提交值。 */
+    fileReviewStatus?: 'passed' | 'failed';
+    /** 运行时素材审核说明；failed 时通常为不合格原因。 */
+    fileReviewMessage?: string;
+    /** 审核未通过的历史文件，仅作错误态回显，不计入有效提交。 */
+    fileRejectedUrls?: string[];
     defaultValue?: string | string[] | boolean;
     /** 派生 JSON Schema 时写入 property.$comment */
     jsonSchemaDescription?: string;
@@ -129,10 +163,13 @@ export interface FormBlock {
     /** 案例单选：列表筛选条件（持久化进 block json） */
     caseFilter?: FormCaseFilter;
     condition?: FormBlockCondition;
+    /** 所属模块；命中 FormSchema.modules.id 时在对应 Tab 中展示。 */
+    moduleId?: string;
 }
 export interface FormSchema {
     title?: string;
     description?: string;
+    modules?: FormModule[];
     blocks: FormBlock[];
     jsonSchema: FormJsonSchema;
 }
@@ -146,6 +183,7 @@ export declare function supportsDefaultValue(type: FormBlockType): boolean;
 export interface FormDefinitionPayload {
     title?: string;
     description?: string;
+    modules?: FormModule[];
     blocks?: FormBlock[];
     a2ui?: A2uiSurfaceDoc;
     json_schema?: FormJsonSchema;

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "Skopon form rendering SDK (A2UI + form_definition) with submit helpers",
   "type": "module",
   "sideEffects": [

package/src/adapter/a2uiAdapter.test.ts

@@ -44,6 +44,22 @@ function makeDefinition(): Pick<FormSchema, 'title' | 'description' | 'blocks'>
 }
 
 describe('a2uiAdapter blocks <-> surface', () => {
+  it('preserves material upload examples and review criteria through normalization and A2UI', () => {
+    const definition = normalizeFormDefinition({ blocks: [{
+      id: 'material', type: 'file', name: 'image01', help: '上传人物',
+      fileExampleUrls: [' https://cdn.test/example.jpg ', 'javascript:alert(1)', 'https://cdn.test/example.jpg'],
+      fileReviewCriteria: ' 五官清晰 ',
+      fileReviewStatus: 'failed', fileReviewMessage: ' 面部模糊 ',
+      fileRejectedUrls: ['https://cdn.test/rejected.jpg'],
+    }] })
+    const back = a2uiToBlocks(blocksToA2ui(definition))
+    expect(back.blocks[0]).toMatchObject({
+      name: 'image01', help: '上传人物', fileReviewCriteria: '五官清晰',
+      fileExampleUrls: ['https://cdn.test/example.jpg'],
+      fileReviewStatus: 'failed', fileReviewMessage: '面部模糊',
+      fileRejectedUrls: ['https://cdn.test/rejected.jpg'],
+    })
+  })
   it('blocksToA2ui builds a Column root referencing all components', () => {
     const doc = blocksToA2ui(makeDefinition(), { styleId: 'theme-a' })
     const root = doc.components.find((c) => c.id === 'root')

package/src/adapter/a2uiAdapter.ts

@@ -1,3 +1,4 @@
+import { normalizeAssetOptions } from './formAssetOptions'
 import type {
   A2uiComponentNode,
   A2uiSurfaceDoc,
@@ -276,6 +277,17 @@ function blockToComponent(block: FormBlock): {
         id,
         component: 'FileUpload',
         label,
+        help: block.help ?? '',
+        fileExampleUrls: block.fileExampleUrls ?? [],
+        fileReviewCriteria: block.fileReviewCriteria ?? '',
+        fileReviewRequired: block.fileReviewRequired !== false,
+        fileSourceMode: block.fileSourceMode,
+        fileAssetOptions: block.fileAssetOptions ?? [],
+        assetSlotKey: block.assetSlotKey,
+        assetType: block.assetType,
+        fileReviewStatus: block.fileReviewStatus,
+        fileReviewMessage: block.fileReviewMessage ?? '',
+        fileRejectedUrls: block.fileRejectedUrls ?? [],
         accept: (block.fileAcceptExtensions ?? []).join(','),
         fileAcceptTypes: block.fileAcceptTypes ?? [],
         filePlaceholderIcon: block.filePlaceholderIcon ?? 'document',
@@ -307,12 +319,15 @@ export function isA2uiSurfaceEmpty(doc: A2uiSurfaceDoc | null | undefined): bool
 
 /** FormBlock[] -> A2UI surface 文档 */
 export function blocksToA2ui(
-  definition: Pick<FormSchema, 'title' | 'description' | 'blocks'>,
+  definition: Pick<FormSchema, 'title' | 'description' | 'modules' | 'blocks'>,
   options?: BlocksToA2uiOptions,
 ): A2uiSurfaceDoc {
   const components: A2uiComponentNode[] = []
   const childIds: string[] = []
   const dataModel: Record<string, unknown> = {}
+  const modules = definition.modules ?? []
+  const moduleById = new Map(modules.map((module) => [module.id, module]))
+  const moduleChildIds = new Map(modules.map((module) => [module.id, [] as string[]]))
 
   const includeHeader = options?.includeHeader !== false
   const title = (definition.title ?? '').trim()
@@ -332,8 +347,40 @@ export function blocksToA2ui(
     // hidden 等无节点块仍可写入 dataModel，保证「不展示仍提交」
     if (dataKey) dataModel[dataKey] = dataValue
     if (!node) continue
+    const moduleId = block.moduleId?.trim()
+    if (moduleId && moduleById.has(moduleId) && node.component === 'FileUpload') {
+      // 分组表单把公共说明集中放在 Tab 底部，避免每个上传位重复拉长页面。
+      node.fileExampleUrls = []
+      node.fileReviewCriteria = ''
+      node.compact = true
+    }
     components.push(node)
-    childIds.push(node.id)
+    if (moduleId && moduleChildIds.has(moduleId)) {
+      moduleChildIds.get(moduleId)!.push(node.id)
+    } else {
+      childIds.push(node.id)
+    }
+  }
+
+  const tabs = modules.flatMap((module) => {
+    const children = moduleChildIds.get(module.id) ?? []
+    if (children.length === 0) return []
+    const panelId = `__module_panel_${module.id}`
+    components.push({
+      id: panelId,
+      component: 'SkoponModulePanel',
+      children,
+      single: children.length === 1,
+      description: module.description ?? '',
+      requirementsTitle: `${module.label.replace(/（.*?）|\(.*?\)/g, '').trim()}素材要求`,
+      reviewCriteria: module.reviewCriteria ?? '',
+      exampleUrls: module.exampleUrls ?? [],
+    })
+    return [{ title: module.label, child: panelId }]
+  })
+  if (tabs.length > 0) {
+    components.push({ id: '__modules__', component: 'Tabs', tabs })
+    childIds.push('__modules__')
   }
 
   components.unshift({ id: ROOT_ID, component: 'Column', children: childIds })
@@ -448,6 +495,23 @@ function componentToBlock(node: A2uiComponentNode): FormBlock | null {
     case 'FileUpload': {
       const accept = asLiteral(node.accept) ?? ''
       const block: FormBlock = { ...base('file'), name }
+      block.help = asLiteral(node.help)
+      block.fileReviewCriteria = asLiteral(node.fileReviewCriteria)
+      block.fileReviewRequired = node.fileReviewRequired !== false
+      if (node.fileSourceMode === 'upload_required' || node.fileSourceMode === 'upload_or_asset' || node.fileSourceMode === 'asset_only') block.fileSourceMode = node.fileSourceMode
+      block.fileAssetOptions = normalizeAssetOptions(node.fileAssetOptions)
+      block.assetSlotKey = asLiteral(node.assetSlotKey)
+      if (node.assetType === 'image' || node.assetType === 'video' || node.assetType === 'audio' || node.assetType === 'text') block.assetType = node.assetType
+      if (node.fileReviewStatus === 'passed' || node.fileReviewStatus === 'failed') {
+        block.fileReviewStatus = node.fileReviewStatus
+      }
+      block.fileReviewMessage = asLiteral(node.fileReviewMessage)
+      if (Array.isArray(node.fileRejectedUrls)) {
+        block.fileRejectedUrls = node.fileRejectedUrls.filter((url): url is string => typeof url === 'string')
+      }
+      if (Array.isArray(node.fileExampleUrls)) {
+        block.fileExampleUrls = node.fileExampleUrls.filter((url): url is string => typeof url === 'string')
+      }
       if (accept) block.fileAcceptExtensions = accept.split(',').map((s) => s.trim()).filter(Boolean)
       if (Array.isArray(node.fileAcceptTypes)) {
         block.fileAcceptTypes = node.fileAcceptTypes.map(String)

package/src/adapter/formAssetOptions.ts

@@ -0,0 +1,19 @@
+import type { FormAssetOption } from '../types/index'
+
+export function normalizeAssetOptions(raw: unknown): FormAssetOption[] {
+  if (!Array.isArray(raw)) return []
+  const seen = new Set<string>()
+  return raw.slice(0, 100).flatMap((item) => {
+    if (!item || typeof item !== 'object') return []
+    const assetId = String(item.assetId ?? '').trim()
+    const url = typeof item.url === 'string' ? item.url.trim() : ''
+    if (!assetId || seen.has(assetId) || !/^https?:\/\//i.test(url)) return []
+    seen.add(assetId)
+    return [{
+      assetId, url,
+      label: typeof item.label === 'string' ? item.label : `素材 ${assetId}`,
+      previewUrl: typeof item.previewUrl === 'string' && /^https?:\/\//i.test(item.previewUrl) ? item.previewUrl : undefined,
+      assetType: typeof item.assetType === 'string' ? item.assetType : undefined,
+    }]
+  })
+}

package/src/adapter/formSchema.ts

@@ -5,6 +5,7 @@ import type {
   FormContentFilter,
   FormResumeFilter,
   FormJsonSchema,
+  FormModule,
   FormSchema,
 } from '../types/index'
 import {
@@ -25,6 +26,7 @@ import {
 } from './formMedia'
 import { FORM_WEB_DEFAULT_HEIGHT, normalizeWebHeight } from './formWeb'
 import { hasRenderableFormOptions, normalizeFormOptions } from './formOptions'
+import { normalizeAssetOptions } from './formAssetOptions'
 
 const DEFAULT_MEDIA_URL_MAX = 10
 
@@ -194,6 +196,7 @@ function normalizeBlock(raw: FormBlock): FormBlock {
   return {
     id: migrated.id?.trim() || generateId('block-'),
     type,
+    moduleId: migrated.moduleId?.trim() || undefined,
     name: migrated.name?.trim() || undefined,
     label: migrated.label ?? '',
     placeholder: migrated.placeholder ?? '',
@@ -213,6 +216,30 @@ function normalizeBlock(raw: FormBlock): FormBlock {
     filePlaceholderIcon: normalizeFilePlaceholderIcon(migrated.filePlaceholderIcon),
     fileMinCount: type === 'file' ? normalizeFileUploadCount(migrated.fileMinCount, 1) : undefined,
     fileMaxCount: type === 'file' ? normalizeFileUploadCount(migrated.fileMaxCount, 1) : undefined,
+    fileExampleUrls: type === 'file' && Array.isArray(migrated.fileExampleUrls)
+      ? [...new Set(migrated.fileExampleUrls.filter((url): url is string =>
+          typeof url === 'string' && /^https?:\/\//i.test(url.trim()),
+        ).map((url) => url.trim()))]
+      : undefined,
+    fileReviewCriteria: type === 'file' ? migrated.fileReviewCriteria?.trim() ?? '' : undefined,
+    fileReviewRequired: type === 'file' ? migrated.fileReviewRequired !== false : undefined,
+    fileSourceMode: type === 'file' && ['upload_required', 'upload_or_asset', 'asset_only'].includes(String(migrated.fileSourceMode))
+      ? migrated.fileSourceMode
+      : undefined,
+    fileAssetOptions: type === 'file' ? normalizeAssetOptions(migrated.fileAssetOptions) : undefined,
+    assetSlotKey: type === 'file' ? migrated.assetSlotKey?.trim() || undefined : undefined,
+    assetType: type === 'file' && ['image', 'video', 'audio', 'text'].includes(String(migrated.assetType))
+      ? migrated.assetType
+      : undefined,
+    fileReviewStatus: type === 'file' && (migrated.fileReviewStatus === 'passed' || migrated.fileReviewStatus === 'failed')
+      ? migrated.fileReviewStatus
+      : undefined,
+    fileReviewMessage: type === 'file' ? migrated.fileReviewMessage?.trim() ?? '' : undefined,
+    fileRejectedUrls: type === 'file' && Array.isArray(migrated.fileRejectedUrls)
+      ? [...new Set(migrated.fileRejectedUrls.filter((url): url is string =>
+          typeof url === 'string' && /^https?:\/\//i.test(url.trim()),
+        ).map((url) => url.trim()))]
+      : undefined,
     defaultValue: normalizeDefaultValue(type, migrated.defaultValue),
     jsonSchemaDescription: migrated.jsonSchemaDescription?.trim() ?? '',
     hidden: type === 'text' ? migrated.hidden === true : undefined,
@@ -432,19 +459,52 @@ export function syncFormDefinition(definition: FormSchema): FormSchema {
   return {
     title,
     description,
+    modules: definition.modules,
     blocks: definition.blocks,
     jsonSchema: blocksToJsonSchema(definition.blocks, title, description),
   }
 }
 
+function normalizeModules(raw: FormModule[] | undefined): FormModule[] | undefined {
+  if (!Array.isArray(raw)) return undefined
+  const ids = new Set<string>()
+  const modules: FormModule[] = []
+  for (const item of raw) {
+    if (!item || typeof item !== 'object') continue
+    const id = item.id?.trim()
+    const label = item.label?.trim()
+    if (!id || !label || ids.has(id)) continue
+    ids.add(id)
+    const exampleUrls = Array.isArray(item.exampleUrls)
+      ? [...new Set(item.exampleUrls
+          .filter((url): url is string => typeof url === 'string' && /^https?:\/\//i.test(url.trim()))
+          .map((url) => url.trim()))]
+      : undefined
+    modules.push({
+      id,
+      label,
+      description: item.description?.trim() || undefined,
+      reviewCriteria: item.reviewCriteria?.trim() || undefined,
+      exampleUrls,
+    })
+  }
+  return modules.length > 0 ? modules : undefined
+}
+
 export function normalizeFormDefinition(raw: FormSchema | undefined): FormSchema {
   if (!raw || !Array.isArray(raw.blocks)) {
     return syncFormDefinition({ title: '', description: '', blocks: [], jsonSchema: {} })
   }
   const blocks = raw.blocks.map(normalizeBlock)
+  const modules = normalizeModules(raw.modules)
+  const moduleIds = new Set(modules?.map((item) => item.id) ?? [])
+  for (const block of blocks) {
+    if (block.moduleId && !moduleIds.has(block.moduleId)) block.moduleId = undefined
+  }
   return syncFormDefinition({
     title: typeof raw.title === 'string' ? raw.title : '',
     description: typeof raw.description === 'string' ? raw.description : '',
+    modules,
     blocks,
     jsonSchema: {},
   })

package/src/adapter/resolveSurface.ts

@@ -26,6 +26,7 @@ export function resolveSurfaceFromFormDefinition(
   const normalized = normalizeFormDefinition({
     title: typeof payload.title === 'string' ? payload.title : '',
     description: typeof payload.description === 'string' ? payload.description : '',
+    modules: Array.isArray(payload.modules) ? payload.modules : undefined,
     blocks,
     jsonSchema: normalizeJsonSchema(payload.jsonSchema ?? payload.json_schema),
   })
@@ -34,7 +35,7 @@ export function resolveSurfaceFromFormDefinition(
 }
 
 export function buildAskUserSurface(
-  formDef: Pick<FormSchema, 'title' | 'description'>,
+  formDef: Pick<FormSchema, 'title' | 'description' | 'modules'>,
   matchedBlocks: FormBlock[],
   options?: BlocksToA2uiOptions,
 ): A2uiSurfaceDoc {
@@ -42,6 +43,7 @@ export function buildAskUserSurface(
     {
       title: formDef.title,
       description: formDef.description,
+      modules: formDef.modules,
       blocks: matchedBlocks,
     },
     options,
@@ -60,6 +62,7 @@ export function mapFormDefinitionFromDto(raw: unknown): FormSchema | undefined {
   return normalizeFormDefinition({
     title: typeof obj.title === 'string' ? obj.title : '',
     description: typeof obj.description === 'string' ? obj.description : '',
+    modules: Array.isArray(obj.modules) ? obj.modules as FormSchema['modules'] : undefined,
     blocks: Array.isArray(obj.blocks) ? (obj.blocks as FormSchema['blocks']) : [],
     jsonSchema: normalizeJsonSchema(obj.jsonSchema ?? obj.json_schema),
   })