@skopon-cool/form-sdk 0.1.6 → 0.1.8

package/dist/types/index.d.ts

@@ -72,10 +72,18 @@ export interface FormBlock {
     defaultValue?: string | string[] | boolean;
     /** 简历多选：是否显示「换一批」 */
     resumeEnableRefresh?: boolean;
+    /** 简历多选：最少选中数量，配置值 ≥ 1 */
+    resumeMinCount?: number;
+    /** 简历多选：最多选中数量，配置值 ≥ 1 */
+    resumeMaxCount?: number;
     /** 简历多选：列表筛选条件（持久化进 block json） */
     resumeFilter?: FormResumeFilter;
     /** 案例单选：是否显示「换一批」 */
     caseEnableRefresh?: boolean;
+    /** 案例多选：最少选中数量，配置值 ≥ 1 */
+    caseMinCount?: number;
+    /** 案例多选：最多选中数量，配置值 ≥ 1 */
+    caseMaxCount?: number;
     /** 案例单选：列表筛选条件（持久化进 block json） */
     caseFilter?: FormCaseFilter;
 }

package/package.json

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

package/src/adapter/formSchema.ts

@@ -23,6 +23,12 @@ function normalizeFileUploadCount(raw: unknown, fallback = 1): number {
   return Math.max(0, Math.floor(num))
 }
 
+function normalizeMultiselectCount(raw: unknown, fallback = 1): number {
+  const num = typeof raw === 'number' ? raw : Number(raw)
+  if (!Number.isFinite(num)) return fallback
+  return Math.max(1, Math.floor(num))
+}
+
 function normalizeDefaultValue(
   type: FormBlockType,
   raw: FormBlock['defaultValue'],
@@ -129,10 +135,26 @@ function normalizeBlock(raw: FormBlock): FormBlock {
       : undefined,
     resumeEnableRefresh:
       type === 'resume_multiselect' ? migrated.resumeEnableRefresh !== false : undefined,
+    resumeMinCount:
+      type === 'resume_multiselect' && migrated.resumeMinCount != null
+        ? normalizeMultiselectCount(migrated.resumeMinCount, 1)
+        : undefined,
+    resumeMaxCount:
+      type === 'resume_multiselect' && migrated.resumeMaxCount != null
+        ? normalizeMultiselectCount(migrated.resumeMaxCount, 1)
+        : undefined,
     resumeFilter:
       type === 'resume_multiselect' ? normalizeResumeFilter(migrated.resumeFilter) : undefined,
     caseEnableRefresh:
       type === 'case_multiselect' ? migrated.caseEnableRefresh !== false : undefined,
+    caseMinCount:
+      type === 'case_multiselect' && migrated.caseMinCount != null
+        ? normalizeMultiselectCount(migrated.caseMinCount, 1)
+        : undefined,
+    caseMaxCount:
+      type === 'case_multiselect' && migrated.caseMaxCount != null
+        ? normalizeMultiselectCount(migrated.caseMaxCount, 1)
+        : undefined,
     caseFilter:
       type === 'case_multiselect' ? normalizeCaseFilter(migrated.caseFilter) : undefined,
   }
@@ -203,6 +225,8 @@ export function createEmptyBlock(type: FormBlockType): FormBlock {
 
   if (type === 'resume_multiselect') {
     block.resumeEnableRefresh = true
+    block.resumeMinCount = 1
+    block.resumeMaxCount = 1
     block.resumeFilter = {
       names: [],
       agentUniqueIds: [],
@@ -214,6 +238,8 @@ export function createEmptyBlock(type: FormBlockType): FormBlock {
 
   if (type === 'case_multiselect') {
     block.caseEnableRefresh = true
+    block.caseMinCount = 1
+    block.caseMaxCount = 1
     block.caseFilter = { flowUniqueIds: [], pageSize: 20 }
     block.defaultValue = []
   }

package/src/blocks/case_multiselect/adapter.ts

@@ -39,6 +39,13 @@ function readCaseFilterFromNode(cf: Record<string, unknown>) {
   }
 }
 
+function readOptionalCount(raw: unknown): number | undefined {
+  if (raw === undefined || raw === null) return undefined
+  const num = typeof raw === 'number' ? raw : Number(raw)
+  if (!Number.isFinite(num) || num < 1) return undefined
+  return Math.floor(num)
+}
+
 export function caseMultiselectToComponent(
   block: FormBlock,
   ctx: BlockAdapterContext,
@@ -59,6 +66,8 @@ export function caseMultiselectToComponent(
       flowUniqueIds: block.caseFilter?.flowUniqueIds ?? [],
       pageSize: block.caseFilter?.pageSize ?? 20,
     },
+    ...(block.caseMinCount !== undefined ? { minCount: block.caseMinCount } : {}),
+    ...(block.caseMaxCount !== undefined ? { maxCount: block.caseMaxCount } : {}),
     value: { path },
   })
 }
@@ -84,6 +93,10 @@ export function caseMultiselectFromComponent(
   if (node.caseFilter && typeof node.caseFilter === 'object') {
     block.caseFilter = readCaseFilterFromNode(node.caseFilter as Record<string, unknown>)
   }
+  const minCount = readOptionalCount(node.minCount)
+  if (minCount !== undefined) block.caseMinCount = minCount
+  const maxCount = readOptionalCount(node.maxCount)
+  if (maxCount !== undefined) block.caseMaxCount = maxCount
   return block
 }
 

package/src/blocks/resume_multiselect/adapter.ts

@@ -5,6 +5,13 @@ function asLiteral(value: unknown): string | undefined {
   return typeof value === 'string' ? value : undefined
 }
 
+function readOptionalCount(raw: unknown): number | undefined {
+  if (raw === undefined || raw === null) return undefined
+  const num = typeof raw === 'number' ? raw : Number(raw)
+  if (!Number.isFinite(num) || num < 1) return undefined
+  return Math.floor(num)
+}
+
 export function resumeMultiselectToComponent(
   block: FormBlock,
   ctx: BlockAdapterContext,
@@ -23,6 +30,8 @@ export function resumeMultiselectToComponent(
       resumeUniqueIds: block.resumeFilter?.resumeUniqueIds ?? [],
       pageSize: block.resumeFilter?.pageSize ?? 20,
     },
+    ...(block.resumeMinCount !== undefined ? { minCount: block.resumeMinCount } : {}),
+    ...(block.resumeMaxCount !== undefined ? { maxCount: block.resumeMaxCount } : {}),
     value: { path },
   })
 }
@@ -51,6 +60,10 @@ export function resumeMultiselectFromComponent(
       pageSize: typeof rf.pageSize === 'number' ? rf.pageSize : 20,
     }
   }
+  const minCount = readOptionalCount(node.minCount)
+  if (minCount !== undefined) block.resumeMinCount = minCount
+  const maxCount = readOptionalCount(node.maxCount)
+  if (maxCount !== undefined) block.resumeMaxCount = maxCount
   return block
 }
 

package/src/catalog/skoponCaseSelect.tsx

@@ -6,7 +6,7 @@ import { createBinderlessComponentImplementation } from '@a2ui/react/v0_9'
 import { z } from 'zod'
 import type { FormCaseFilter } from '../types/index'
 import { useA2uiPreviewMode } from './a2uiPreviewContext'
-import { asStringArray, useSkoponBoundField } from './useSkoponBoundField'
+import { asStringArray, clampStringArraySelection, isCardSelectionDisabled, readOptionalSelectCount, toggleStringArraySelection, useSkoponBoundField } from './useSkoponBoundField'
 import { type CaseSearchItem, useCaseSearch } from './caseSearchContext'
 
 function readString(value: unknown): string {
@@ -64,6 +64,8 @@ const SkoponCaseSelectApi = {
       help: z.any().optional(),
       enableRefresh: z.any().optional(),
       caseFilter: z.any().optional(),
+      minCount: z.any().optional(),
+      maxCount: z.any().optional(),
       value: z.any().optional(),
     })
     .passthrough(),
@@ -115,6 +117,8 @@ function SkoponCaseSelectPreview({ context }: { context: ComponentContext }) {
   const placeholder = readString(props.placeholder)
   const help = readString(props.help)
   const enableRefresh = props.enableRefresh !== false
+  const minCount = readOptionalSelectCount(props.minCount)
+  const maxCount = readOptionalSelectCount(props.maxCount)
   const caseFilter = useMemo(() => readCaseFilter(props.caseFilter), [props.caseFilter])
   const filterSig = filterKey(caseFilter)
 
@@ -128,6 +132,11 @@ function SkoponCaseSelectPreview({ context }: { context: ComponentContext }) {
 
   const selectedIds = asStringArray(value)
 
+  useEffect(() => {
+    const clamped = clampStringArraySelection(selectedIds, maxCount)
+    if (clamped !== null) setValue(clamped)
+  }, [maxCount, selectedIds, setValue])
+
   const emptyHint = useMemo(() => {
     if (!caseSearch) return '未配置案例搜索服务'
     if (!isCaseFilterReady(caseFilter)) return '未配置案例列表筛选条件'
@@ -173,9 +182,13 @@ function SkoponCaseSelectPreview({ context }: { context: ComponentContext }) {
 
   const toggleSelect = (caseUniqueId: string) => {
     if (!interactive) return
-    const next = selectedIds.includes(caseUniqueId)
-      ? selectedIds.filter((id) => id !== caseUniqueId)
-      : [...selectedIds, caseUniqueId]
+    const next = toggleStringArraySelection(
+      selectedIds,
+      caseUniqueId,
+      minCount,
+      maxCount,
+    )
+    if (next === null) return
     setValue(next)
   }
 
@@ -205,7 +218,13 @@ function SkoponCaseSelectPreview({ context }: { context: ComponentContext }) {
               key={item.caseUniqueId}
               item={item}
               selected={selectedIds.includes(item.caseUniqueId)}
-              disabled={!interactive}
+              disabled={isCardSelectionDisabled(
+                selectedIds,
+                item.caseUniqueId,
+                interactive,
+                minCount,
+                maxCount,
+              )}
               onToggle={() => toggleSelect(item.caseUniqueId)}
             />
           ))}

package/src/catalog/skoponResumeSelect.tsx

@@ -6,7 +6,7 @@ import { createBinderlessComponentImplementation } from '@a2ui/react/v0_9'
 import { z } from 'zod'
 import type { FormResumeFilter } from '../types/index'
 import { useA2uiPreviewMode } from './a2uiPreviewContext'
-import { asStringArray, useSkoponBoundField } from './useSkoponBoundField'
+import { asStringArray, clampStringArraySelection, isCardSelectionDisabled, readOptionalSelectCount, toggleStringArraySelection, useSkoponBoundField } from './useSkoponBoundField'
 import {
   type ResumeSearchItem,
   type ResumeSearchWorkItem,
@@ -50,6 +50,8 @@ const SkoponResumeSelectApi = {
       help: z.any().optional(),
       enableRefresh: z.any().optional(),
       resumeFilter: z.any().optional(),
+      minCount: z.any().optional(),
+      maxCount: z.any().optional(),
       value: z.any().optional(),
     })
     .passthrough(),
@@ -168,6 +170,8 @@ function SkoponResumeSelectPreview({ context }: { context: ComponentContext }) {
   const placeholder = readString(props.placeholder)
   const help = readString(props.help)
   const enableRefresh = props.enableRefresh !== false
+  const minCount = readOptionalSelectCount(props.minCount)
+  const maxCount = readOptionalSelectCount(props.maxCount)
   const resumeFilter = useMemo(() => readResumeFilter(props.resumeFilter), [props.resumeFilter])
   const filterSig = filterKey(resumeFilter)
 
@@ -181,6 +185,11 @@ function SkoponResumeSelectPreview({ context }: { context: ComponentContext }) {
 
   const selectedIds = asStringArray(value)
 
+  useEffect(() => {
+    const clamped = clampStringArraySelection(selectedIds, maxCount)
+    if (clamped !== null) setValue(clamped)
+  }, [maxCount, selectedIds, setValue])
+
   const fetchPage = useCallback(
     async (targetPage: number) => {
       const filter = readResumeFilter(JSON.parse(filterSig) as FormResumeFilter)
@@ -219,9 +228,13 @@ function SkoponResumeSelectPreview({ context }: { context: ComponentContext }) {
 
   const toggleSelect = (resumeUniqueId: string) => {
     if (!interactive) return
-    const next = selectedIds.includes(resumeUniqueId)
-      ? selectedIds.filter((id) => id !== resumeUniqueId)
-      : [...selectedIds, resumeUniqueId]
+    const next = toggleStringArraySelection(
+      selectedIds,
+      resumeUniqueId,
+      minCount,
+      maxCount,
+    )
+    if (next === null) return
     setValue(next)
   }
 
@@ -258,7 +271,13 @@ function SkoponResumeSelectPreview({ context }: { context: ComponentContext }) {
               key={item.resumeUniqueId}
               item={item}
               selected={selectedIds.includes(item.resumeUniqueId)}
-              disabled={!interactive}
+              disabled={isCardSelectionDisabled(
+                selectedIds,
+                item.resumeUniqueId,
+                interactive,
+                minCount,
+                maxCount,
+              )}
               onToggle={() => toggleSelect(item.resumeUniqueId)}
             />
           ))}

package/src/catalog/useSkoponBoundField.test.ts

@@ -3,7 +3,7 @@
  */
 import { describe, it, expect } from 'vitest'
 import type { ComponentContext } from '@a2ui/web_core/v0_9'
-import { asStringArray, readBoundFieldValue } from './useSkoponBoundField'
+import { asStringArray, clampStringArraySelection, readBoundFieldValue, toggleStringArraySelection } from './useSkoponBoundField'
 
 function createMockContext(initial: unknown = []): {
   context: ComponentContext
@@ -47,6 +47,31 @@ describe('readBoundFieldValue', () => {
   })
 })
 
+describe('toggleStringArraySelection', () => {
+  it('blocks append when at maxCount', () => {
+    expect(toggleStringArraySelection(['a'], 'b', undefined, 1)).toBeNull()
+  })
+
+  it('blocks deselect when at minCount', () => {
+    expect(toggleStringArraySelection(['a'], 'a', 1, undefined)).toBeNull()
+  })
+
+  it('allows toggle within bounds', () => {
+    expect(toggleStringArraySelection([], 'a', 1, 2)).toEqual(['a'])
+    expect(toggleStringArraySelection(['a', 'b'], 'a', 1, 3)).toEqual(['b'])
+  })
+})
+
+describe('clampStringArraySelection', () => {
+  it('returns null when within maxCount', () => {
+    expect(clampStringArraySelection(['a'], 2)).toBeNull()
+  })
+
+  it('trims to maxCount when over limit', () => {
+    expect(clampStringArraySelection(['a', 'b', 'c'], 2)).toEqual(['a', 'b'])
+  })
+})
+
 describe('file upload remove by uid index', () => {
   it('removes only the file at the uid index when names duplicate', () => {
     const currentNames = ['dup.txt', 'dup.txt', 'other.txt']

package/src/catalog/useSkoponBoundField.ts

@@ -64,3 +64,49 @@ export function asStringArray(value: unknown): string[] {
   if (typeof value === 'string' && value) return [value]
   return []
 }
+
+export function readOptionalSelectCount(value: unknown): number | undefined {
+  if (value === undefined || value === null) return undefined
+  const num = typeof value === 'number' ? value : Number(value)
+  if (!Number.isFinite(num) || num < 1) return undefined
+  return Math.floor(num)
+}
+
+export function toggleStringArraySelection(
+  selectedIds: string[],
+  itemId: string,
+  minCount: number | undefined,
+  maxCount: number | undefined,
+): string[] | null {
+  const isSelected = selectedIds.includes(itemId)
+  if (isSelected) {
+    const next = selectedIds.filter((id) => id !== itemId)
+    if (minCount !== undefined && next.length < minCount) return null
+    return next
+  }
+  if (maxCount !== undefined && selectedIds.length >= maxCount) return null
+  return [...selectedIds, itemId]
+}
+
+export function isCardSelectionDisabled(
+  selectedIds: string[],
+  itemId: string,
+  interactive: boolean,
+  minCount: number | undefined,
+  maxCount: number | undefined,
+): boolean {
+  if (!interactive) return true
+  const isSelected = selectedIds.includes(itemId)
+  if (!isSelected && maxCount !== undefined && selectedIds.length >= maxCount) return true
+  if (isSelected && minCount !== undefined && selectedIds.length <= minCount) return true
+  return false
+}
+
+/** 超出 maxCount 时返回裁剪后的数组，否则返回 null（无需变更）。 */
+export function clampStringArraySelection(
+  selectedIds: string[],
+  maxCount: number | undefined,
+): string[] | null {
+  if (maxCount === undefined || selectedIds.length <= maxCount) return null
+  return selectedIds.slice(0, maxCount)
+}

package/src/components/AskUserFormCard.tsx

@@ -165,6 +165,7 @@ export default function AskUserFormCard({
       <CurlSubmitBlock
         payload={payload}
         callbackUrl={callbackUrl}
+        copyMode="submitFields"
         unpublishedFormId={formDisabled && resolvedFormUniqueId ? resolvedFormUniqueId : undefined}
         onNotify={onNotify}
       />

package/src/types/index.ts

@@ -129,10 +129,18 @@ export interface FormBlock {
   defaultValue?: string | string[] | boolean
   /** 简历多选：是否显示「换一批」 */
   resumeEnableRefresh?: boolean
+  /** 简历多选：最少选中数量，配置值 ≥ 1 */
+  resumeMinCount?: number
+  /** 简历多选：最多选中数量，配置值 ≥ 1 */
+  resumeMaxCount?: number
   /** 简历多选：列表筛选条件（持久化进 block json） */
   resumeFilter?: FormResumeFilter
   /** 案例单选：是否显示「换一批」 */
   caseEnableRefresh?: boolean
+  /** 案例多选：最少选中数量，配置值 ≥ 1 */
+  caseMinCount?: number
+  /** 案例多选：最多选中数量，配置值 ≥ 1 */
+  caseMaxCount?: number
   /** 案例单选：列表筛选条件（持久化进 block json） */
   caseFilter?: FormCaseFilter
 }