@skopon-cool/form-sdk 0.1.3 → 0.1.4

package/src/components/SkoponA2uiStreamRenderer.tsx

@@ -5,6 +5,8 @@ import { A2uiSurface, type ReactComponentImplementation } from '@a2ui/react/v0_9
 import { injectStyles } from '@a2ui/react/styles'
 import { buildSkoponCatalog } from '../catalog/a2uiCustomCatalog'
 import { A2uiPreviewModeProvider } from '../catalog/a2uiPreviewContext'
+import { CaseSearchProvider, type CaseSearchFn } from '../catalog/caseSearchContext'
+import { ResumeSearchProvider, type ResumeSearchFn } from '../catalog/resumeSearchContext'
 
 export interface SkoponA2uiStreamRendererProps {
   /** 增量追加的 A2UI v0.9 消息 */
@@ -12,6 +14,10 @@ export interface SkoponA2uiStreamRendererProps {
   surfaceId?: string
   emptyHint?: ReactNode
   interactive?: boolean
+  /** 简历多选组件：注入搜索函数 */
+  resumeSearch?: ResumeSearchFn | null
+  /** 案例单选组件：注入搜索函数 */
+  caseSearch?: CaseSearchFn | null
 }
 
 function createProcessor(): MessageProcessor<ReactComponentImplementation> {
@@ -23,6 +29,8 @@ export default function SkoponA2uiStreamRenderer({
   surfaceId = 'skopon-form-stream',
   emptyHint = null,
   interactive = true,
+  resumeSearch = null,
+  caseSearch = null,
 }: SkoponA2uiStreamRendererProps) {
   useEffect(() => {
     injectStyles()
@@ -31,9 +39,35 @@ export default function SkoponA2uiStreamRenderer({
 
   const processorRef = useRef<MessageProcessor<ReactComponentImplementation>>(createProcessor())
   const processedCountRef = useRef(0)
+  const lastProcessedMessagesRef = useRef('')
   const mountedRef = useRef(true)
   const surfaceIdRef = useRef(surfaceId)
 
+  function commitProcessor(
+    next: MessageProcessor<ReactComponentImplementation>,
+    processedMessages: A2uiMessage[],
+  ) {
+    processorRef.current = next
+    processedCountRef.current = processedMessages.length
+    lastProcessedMessagesRef.current = JSON.stringify(processedMessages)
+    if (!mountedRef.current) return
+    setProcessor(next)
+    setSurfaces(Array.from(next.model.surfacesMap.values()))
+  }
+
+  function processedPrefixChanged(messages: A2uiMessage[], prefixLen: number): boolean {
+    if (prefixLen <= 0) return false
+    const newPrefix = JSON.stringify(messages.slice(0, prefixLen))
+    const stored = lastProcessedMessagesRef.current
+    if (!stored) return true
+    try {
+      const parsed = JSON.parse(stored) as A2uiMessage[]
+      return JSON.stringify(parsed.slice(0, prefixLen)) !== newPrefix
+    } catch {
+      return true
+    }
+  }
+
   const [processor, setProcessor] = useState(() => processorRef.current)
   const [surfaces, setSurfaces] = useState(() =>
     Array.from(processorRef.current.model.surfacesMap.values()),
@@ -70,18 +104,17 @@ export default function SkoponA2uiStreamRenderer({
 
     if (surfaceIdChanged) {
       const next = createProcessor()
-      processorRef.current = next
-      processedCountRef.current = 0
       if (Array.isArray(messages) && messages.length > 0) {
         next.processMessages(messages)
-        processedCountRef.current = messages.length
+        if (!cancelled) commitProcessor(next, messages)
+      } else {
+        processorRef.current = next
+        processedCountRef.current = 0
+        lastProcessedMessagesRef.current = ''
         if (!cancelled) {
           setProcessor(next)
-          setSurfaces(Array.from(next.model.surfacesMap.values()))
+          setSurfaces([])
         }
-      } else if (!cancelled) {
-        setProcessor(next)
-        setSurfaces([])
       }
       return () => {
         cancelled = true
@@ -93,6 +126,7 @@ export default function SkoponA2uiStreamRenderer({
         const next = createProcessor()
         processorRef.current = next
         processedCountRef.current = 0
+        lastProcessedMessagesRef.current = ''
         if (!cancelled) {
           setProcessor(next)
           setSurfaces([])
@@ -104,23 +138,21 @@ export default function SkoponA2uiStreamRenderer({
     }
 
     const activeProcessor = processorRef.current
+    const processedCount = processedCountRef.current
 
-    if (messages.length < processedCountRef.current) {
+    if (
+      messages.length < processedCount ||
+      processedPrefixChanged(messages, processedCount)
+    ) {
       const next = createProcessor()
-      processorRef.current = next
-      processedCountRef.current = 0
       next.processMessages(messages)
-      processedCountRef.current = messages.length
-      if (!cancelled) {
-        setProcessor(next)
-        setSurfaces(Array.from(next.model.surfacesMap.values()))
-      }
+      if (!cancelled) commitProcessor(next, messages)
       return () => {
         cancelled = true
       }
     }
 
-    const pending = messages.slice(processedCountRef.current)
+    const pending = messages.slice(processedCount)
     if (pending.length === 0) {
       return () => {
         cancelled = true
@@ -128,6 +160,7 @@ export default function SkoponA2uiStreamRenderer({
     }
     activeProcessor.processMessages(pending)
     processedCountRef.current = messages.length
+    lastProcessedMessagesRef.current = JSON.stringify(messages)
     if (!cancelled) {
       setSurfaces(Array.from(activeProcessor.model.surfacesMap.values()))
     }
@@ -140,12 +173,16 @@ export default function SkoponA2uiStreamRenderer({
   if (surfaces.length === 0) return <>{emptyHint}</>
 
   return (
-    <A2uiPreviewModeProvider interactive={interactive}>
-      <div className="a2ui-surface a2ui-container">
-        {surfaces.map((surface) => (
-          <A2uiSurface key={surface.id} surface={surface} />
-        ))}
-      </div>
-    </A2uiPreviewModeProvider>
+    <ResumeSearchProvider resumeSearch={resumeSearch}>
+      <CaseSearchProvider caseSearch={caseSearch}>
+        <A2uiPreviewModeProvider interactive={interactive}>
+          <div className="a2ui-surface a2ui-container">
+            {surfaces.map((surface) => (
+              <A2uiSurface key={surface.id} surface={surface} />
+            ))}
+          </div>
+        </A2uiPreviewModeProvider>
+      </CaseSearchProvider>
+    </ResumeSearchProvider>
   )
 }

package/src/components/SkoponFormRenderer.tsx

@@ -15,6 +15,8 @@ import { extractSurfaceValues } from '../adapter/extractSurfaceValues'
 import { isA2uiSurfaceEmpty, surfaceDocToMessages } from '../adapter/a2uiAdapter'
 import { SKOPON_CATALOG_ID, buildSkoponCatalog } from '../catalog/a2uiCustomCatalog'
 import { A2uiPreviewModeProvider } from '../catalog/a2uiPreviewContext'
+import { CaseSearchProvider, type CaseSearchFn } from '../catalog/caseSearchContext'
+import { ResumeSearchProvider, type ResumeSearchFn } from '../catalog/resumeSearchContext'
 
 export interface SkoponFormRendererRef {
   getValues: (fieldNames?: string[]) => Record<string, unknown>
@@ -27,6 +29,10 @@ export interface SkoponFormRendererProps {
   interactive?: boolean
   /** 默认用于 getValues() 的字段名列表 */
   fieldNames?: string[]
+  /** 简历多选组件：注入搜索函数 */
+  resumeSearch?: ResumeSearchFn | null
+  /** 案例单选组件：注入搜索函数 */
+  caseSearch?: CaseSearchFn | null
 }
 
 const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererProps>(
@@ -37,6 +43,8 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
       emptyHint = null,
       interactive = true,
       fieldNames = [],
+      resumeSearch = null,
+      caseSearch = null,
     },
     ref,
   ) {
@@ -49,13 +57,23 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
     const fieldNamesRef = useRef(fieldNames)
     fieldNamesRef.current = fieldNames
 
+    const docKey = useMemo(() => {
+      if (isA2uiSurfaceEmpty(doc)) return ''
+      try {
+        return JSON.stringify(doc)
+      } catch {
+        return String(doc)
+      }
+    }, [doc])
+
     const renderResult = useMemo(() => {
-      if (isA2uiSurfaceEmpty(doc)) {
+      if (!docKey) {
         return { surfaces: [], processor: null as MessageProcessor<ReactComponentImplementation> | null }
       }
       try {
+        const resolvedDoc = JSON.parse(docKey) as A2uiSurfaceDoc
         const processor = new MessageProcessor([buildSkoponCatalog()])
-        const messages = surfaceDocToMessages(doc!, {
+        const messages = surfaceDocToMessages(resolvedDoc, {
           surfaceId,
           catalogId: SKOPON_CATALOG_ID,
         }) as unknown as A2uiMessage[]
@@ -68,7 +86,7 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
         console.error('[SkoponFormRenderer] 渲染 A2UI surface 失败', error)
         return { surfaces: [], processor: null as MessageProcessor<ReactComponentImplementation> | null }
       }
-    }, [doc, surfaceId])
+    }, [docKey, surfaceId])
 
     const { surfaces, processor } = renderResult
     processorRef.current = processor
@@ -89,13 +107,17 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
     if (surfaces.length === 0) return <>{emptyHint}</>
 
     return (
-      <A2uiPreviewModeProvider interactive={interactive}>
-        <div className="a2ui-surface a2ui-container">
-          {surfaces.map((surface) => (
-            <A2uiSurface key={surface.id} surface={surface} />
-          ))}
-        </div>
-      </A2uiPreviewModeProvider>
+      <ResumeSearchProvider resumeSearch={resumeSearch}>
+        <CaseSearchProvider caseSearch={caseSearch}>
+          <A2uiPreviewModeProvider interactive={interactive}>
+            <div className="a2ui-surface a2ui-container">
+              {surfaces.map((surface) => (
+                <A2uiSurface key={surface.id} surface={surface} />
+              ))}
+            </div>
+          </A2uiPreviewModeProvider>
+        </CaseSearchProvider>
+      </ResumeSearchProvider>
     )
   },
 )

package/src/index.ts

@@ -63,6 +63,8 @@ export { createFormClient, type FormClient, type FormClientOptions } from './cli
 
 export { default as SkoponFormRenderer } from './components/SkoponFormRenderer'
 export type { SkoponFormRendererProps, SkoponFormRendererRef } from './components/SkoponFormRenderer'
+export type { ResumeSearchFn as SkoponResumeSearchFn } from './catalog/resumeSearchContext'
+export type { CaseSearchFn as SkoponCaseSearchFn } from './catalog/caseSearchContext'
 
 export { default as SkoponA2uiStreamRenderer } from './components/SkoponA2uiStreamRenderer'
 export type { SkoponA2uiStreamRendererProps } from './components/SkoponA2uiStreamRenderer'
@@ -73,4 +75,25 @@ export type { AskUserFormCardProps } from './components/AskUserFormCard'
 export { default as CurlSubmitBlock } from './components/CurlSubmitBlock'
 export type { CurlSubmitBlockProps } from './components/CurlSubmitBlock'
 
+
+export {
+  ResumeSearchProvider,
+  useResumeSearch,
+  type ResumeSearchFn,
+  type ResumeSearchItem,
+  type ResumeSearchParams,
+  type ResumeSearchResult,
+} from './catalog/resumeSearchContext'
+
+export {
+  CaseSearchProvider,
+  useCaseSearch,
+  type CaseSearchFn,
+  type CaseSearchItem,
+  type CaseSearchParams,
+  type CaseSearchResult,
+} from './catalog/caseSearchContext'
+
+export type { FormResumeFilter, FormCaseFilter } from './types/index'
+
 import './styles/index.css'

package/src/styles/index.css

@@ -193,3 +193,63 @@
   white-space: pre-wrap;
   word-break: break-all;
 }
+
+.skopon-resume-select-list {
+  display: flex;
+  flex-direction: column;
+  gap: var(--space-2, 8px);
+  margin-top: var(--space-2, 8px);
+}
+.skopon-resume-select-card {
+  display: flex;
+  align-items: flex-start;
+  gap: 12px;
+  width: 100%;
+  padding: 12px;
+  border: 1px solid var(--color-border, #d9d9d9);
+  border-radius: var(--radius-md, 8px);
+  background: var(--color-surface, #fff);
+  text-align: left;
+  cursor: pointer;
+}
+.skopon-resume-select-card:hover:not(:disabled) {
+  border-color: var(--color-primary, #1677ff);
+}
+.skopon-resume-select-card--selected {
+  border-color: var(--color-primary, #1677ff);
+  background: color-mix(in srgb, var(--color-primary, #1677ff) 8%, transparent);
+}
+.skopon-resume-select-card:disabled {
+  cursor: not-allowed;
+  opacity: 0.72;
+}
+.skopon-resume-select-card-body {
+  flex: 1;
+  min-width: 0;
+}
+.skopon-resume-select-card-name {
+  font-weight: 600;
+  margin-bottom: 4px;
+}
+.skopon-resume-select-card-desc {
+  color: var(--color-text-secondary, rgba(0, 0, 0, 0.65));
+  font-size: 13px;
+  margin-bottom: 4px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+}
+.skopon-resume-select-card-meta {
+  color: var(--color-text-secondary, rgba(0, 0, 0, 0.45));
+  font-size: 12px;
+}
+.skopon-resume-select-actions {
+  margin-top: var(--space-2, 8px);
+}
+.skopon-resume-select-empty,
+.skopon-resume-select-status {
+  padding: 12px 0;
+  color: var(--color-text-secondary, rgba(0, 0, 0, 0.45));
+}

package/src/types/index.ts

@@ -17,6 +17,8 @@ export type A2uiComponentName =
   | 'FileUpload'
   | 'SkoponMedia'
   | 'SkoponSelect'
+  | 'SkoponResumeSelect'
+  | 'SkoponCaseSelect'
 
 export interface A2uiComponentNode {
   id: string
@@ -53,6 +55,8 @@ export type FormBlockType =
   | 'datetime'
   | 'time'
   | 'file'
+  | 'resume_multiselect'
+  | 'case_singleselect'
   | 'image'
   | 'video'
   | 'audio'
@@ -80,6 +84,24 @@ export interface FormBlockOption {
   label: string
 }
 
+/** 简历多选组件：渲染时用于 /univ/resume/search 的筛选条件 */
+export interface FormResumeFilter {
+  names?: string[]
+  agentUniqueIds?: string[]
+  resumeUniqueIds?: string[]
+  pageSize?: number
+}
+
+/** 案例单选组件：渲染时用于 /univ/case/list 的筛选条件 */
+export interface FormCaseFilter {
+  /** Agent 类型（编辑器辅助，运行时不用） */
+  agentKind?: string
+  /** Agent unique_id（编辑器辅助，运行时不用） */
+  agentUniqueId?: string
+  flowId?: number
+  pageSize?: number
+}
+
 export interface FormBlock {
   id: string
   type: FormBlockType
@@ -98,6 +120,14 @@ export interface FormBlock {
   fileMinCount?: number
   fileMaxCount?: number
   defaultValue?: string | string[] | boolean
+  /** 简历多选：是否显示「换一批」 */
+  resumeEnableRefresh?: boolean
+  /** 简历多选：列表筛选条件（持久化进 block json） */
+  resumeFilter?: FormResumeFilter
+  /** 案例单选：是否显示「换一批」 */
+  caseEnableRefresh?: boolean
+  /** 案例单选：列表筛选条件（持久化进 block json） */
+  caseFilter?: FormCaseFilter
 }
 
 export interface FormSchema {