@skopon-cool/form-sdk 0.1.3 → 0.1.4

package/dist/types/index.d.ts

@@ -4,7 +4,7 @@
 export type A2uiBinding<T> = T | {
     path: string;
 };
-export type A2uiComponentName = 'Column' | 'Row' | 'Text' | 'Image' | 'Video' | 'AudioPlayer' | 'TextField' | 'CheckBox' | 'ChoicePicker' | 'DateTimeInput' | 'FileUpload' | 'SkoponMedia' | 'SkoponSelect';
+export type A2uiComponentName = 'Column' | 'Row' | 'Text' | 'Image' | 'Video' | 'AudioPlayer' | 'TextField' | 'CheckBox' | 'ChoicePicker' | 'DateTimeInput' | 'FileUpload' | 'SkoponMedia' | 'SkoponSelect' | 'SkoponResumeSelect' | 'SkoponCaseSelect';
 export interface A2uiComponentNode {
     id: string;
     component: A2uiComponentName | string;
@@ -21,7 +21,7 @@ export interface A2uiSurfaceDoc {
 }
 export declare const A2UI_PROTOCOL_VERSION: "v0.9";
 export type FormJsonSchema = Record<string, unknown>;
-export type FormBlockType = 'heading' | 'paragraph' | 'text' | 'textarea' | 'email' | 'number' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'toggle' | 'tel' | 'url' | 'datetime' | 'time' | 'file' | 'image' | 'video' | 'audio';
+export type FormBlockType = 'heading' | 'paragraph' | 'text' | 'textarea' | 'email' | 'number' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'toggle' | 'tel' | 'url' | 'datetime' | 'time' | 'file' | 'resume_multiselect' | 'case_singleselect' | 'image' | 'video' | 'audio';
 export type FormMediaSize = 'huge' | 'large' | 'medium' | 'small' | 'icon';
 export type FormFilePlaceholderIcon = 'video' | 'audio' | 'image' | 'file' | 'spreadsheet' | 'document';
 export declare const FORM_MEDIA_SIZES: FormMediaSize[];
@@ -29,6 +29,22 @@ export interface FormBlockOption {
     value: string;
     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;
@@ -47,6 +63,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 {
     title?: string;

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.1.3",
+  "version": "0.1.4",
   "description": "Skopon form rendering SDK (A2UI + form_definition) with submit helpers",
   "type": "module",
   "sideEffects": [

package/src/adapter/a2uiAdapter.test.ts

@@ -238,4 +238,52 @@ describe('a2uiAdapter blocks <-> surface', () => {
     const withHeader = blocksToA2ui(makeDefinition())
     expect((withHeader.components.find((c) => c.id === 'root')?.children as string[]).length).toBe(12)
   })
+
+  it('round-trips case_singleselect through blocksToA2ui and a2uiToBlocks', () => {
+    const doc = blocksToA2ui(
+      {
+        title: '',
+        description: '',
+        blocks: [
+          {
+            id: 'b-case',
+            type: 'case_singleselect',
+            name: 'selected_case',
+            label: '选择案例',
+            placeholder: '暂无案例',
+            help: '请选择一个案例',
+            caseEnableRefresh: true,
+            caseFilter: {
+              agentKind: 'public-user',
+              agentUniqueId: 'agent-1',
+              flowId: 42,
+              pageSize: 10,
+            },
+            defaultValue: 'case-abc',
+          },
+        ],
+      },
+      { includeHeader: false },
+    )
+    const node = doc.components.find((c) => c.id === 'b-case')
+    expect(node?.component).toBe('SkoponCaseSelect')
+    expect(node?.enableRefresh).toBe(true)
+    expect(node?.caseFilter).toEqual({
+      agentKind: 'public-user',
+      agentUniqueId: 'agent-1',
+      flowId: 42,
+      pageSize: 10,
+    })
+    expect(doc.dataModel?.selected_case).toBe('case-abc')
+
+    const back = a2uiToBlocks(doc)
+    const block = back.blocks.find((b) => b.name === 'selected_case')
+    expect(block?.type).toBe('case_singleselect')
+    expect(block?.caseEnableRefresh).toBe(true)
+    expect(block?.caseFilter?.flowId).toBe(42)
+    expect(block?.caseFilter?.pageSize).toBe(10)
+    expect(block?.caseFilter?.agentKind).toBe('public-user')
+    expect(block?.caseFilter?.agentUniqueId).toBe('agent-1')
+    expect(block?.defaultValue).toBe('case-abc')
+  })
 })

package/src/adapter/a2uiAdapter.ts

@@ -11,6 +11,7 @@ import { generateId } from './id'
 import { coerceToggleValue } from './formSchema'
 import { getMediaUrls, normalizeMediaSize } from './formMedia'
 import { syncFormDefinition } from './formSchema'
+import { getBlockTypeAdapter, getComponentAdapter } from '../blocks/registry'
 
 /**
  * A2UI surface <-> FormBlock 双向适配器。
@@ -99,14 +100,20 @@ function defaultValueForBlock(block: FormBlock): unknown {
       return coerceToggleValue(block.defaultValue)
     case 'multiselect':
     case 'checkbox':
+    case 'resume_multiselect':
       if (Array.isArray(block.defaultValue)) return block.defaultValue
       if (typeof block.defaultValue === 'string' && block.defaultValue) return [block.defaultValue]
       return []
     case 'select':
     case 'radio':
+    case 'case_singleselect':
       if (Array.isArray(block.defaultValue)) return block.defaultValue[0] ?? ''
       if (typeof block.defaultValue === 'string') return block.defaultValue
       return ''
+    case 'number':
+      if (typeof block.defaultValue === 'number') return block.defaultValue
+      if (typeof block.defaultValue === 'string' && block.defaultValue) return block.defaultValue
+      return null
     default:
       if (typeof block.defaultValue === 'string') return block.defaultValue
       return ''
@@ -131,6 +138,12 @@ function blockToComponent(block: FormBlock): {
     dataValue?: unknown
   } => (name ? { node, dataKey: name, dataValue: defaultValueForBlock(block) } : { node })
 
+  const adapterCtx = { id, label, name, path, withData }
+  const typeAdapter = getBlockTypeAdapter(block.type)
+  if (typeAdapter) {
+    return typeAdapter.toComponent(block, adapterCtx)
+  }
+
   switch (block.type) {
     case 'heading':
       return { node: { id, component: 'Text', text: label, variant: 'h3' } }
@@ -351,6 +364,11 @@ function componentToBlock(node: A2uiComponentNode): FormBlock | null {
 
   const base = (type: FormBlockType): FormBlock => ({ id, type, label })
 
+  const componentAdapter = getComponentAdapter(component)
+  if (componentAdapter) {
+    return componentAdapter.fromComponent(node, base, { asLiteral, nameFromValue })
+  }
+
   switch (component) {
     case 'Text': {
       const variant = String(node.variant ?? 'body')
@@ -465,6 +483,23 @@ function collectOrder(
 }
 
 /** A2UI surface 文档 -> FormSchema（已 sync 出 jsonSchema） */
+function applyDataModelDefaults(
+  blocks: FormBlock[],
+  dataModel: Record<string, unknown> | undefined,
+): FormBlock[] {
+  if (!dataModel) return blocks
+  return blocks.map((block) => {
+    const name = block.name?.trim()
+    if (!name || !(name in dataModel)) return block
+    const raw = dataModel[name]
+    if (raw === undefined) return block
+    if (block.type === 'toggle') {
+      return { ...block, defaultValue: raw === true || raw === 'true' }
+    }
+    return { ...block, defaultValue: raw as FormBlock['defaultValue'] }
+  })
+}
+
 export function a2uiToBlocks(doc: A2uiSurfaceDoc | null | undefined): FormSchema {
   if (!doc || !Array.isArray(doc.components)) {
     return syncFormDefinition({ title: '', description: '', blocks: [], jsonSchema: {} })
@@ -490,7 +525,12 @@ export function a2uiToBlocks(doc: A2uiSurfaceDoc | null | undefined): FormSchema
     if (block) blocks.push(block)
   }
 
-  return syncFormDefinition({ title, description, blocks, jsonSchema: {} })
+  return syncFormDefinition({
+    title,
+    description,
+    blocks: applyDataModelDefaults(blocks, doc.dataModel),
+    jsonSchema: {},
+  })
 }
 
 /**

package/src/adapter/formSchema.ts

@@ -1,4 +1,4 @@
-import type { FormBlock, FormBlockType, FormSchema } from '../types/index'
+import type { FormBlock, FormBlockType, FormCaseFilter, FormResumeFilter, FormSchema } from '../types/index'
 import { isInputBlockType, isMediaBlockType } from '../types/index'
 import { generateId } from './id'
 import {
@@ -29,7 +29,7 @@ function normalizeDefaultValue(
 ): FormBlock['defaultValue'] {
   if (raw === undefined) return undefined
   if (type === 'toggle') return coerceToggleValue(raw)
-  if (type === 'multiselect' || type === 'checkbox') {
+  if (type === 'multiselect' || type === 'checkbox' || type === 'resume_multiselect') {
     if (Array.isArray(raw)) return raw.map(String)
     if (typeof raw === 'string' && raw) return [raw]
     return []
@@ -39,6 +39,44 @@ function normalizeDefaultValue(
   return String(raw)
 }
 
+function normalizeCaseFilter(raw: FormCaseFilter | undefined): FormCaseFilter {
+  const pageSizeRaw = typeof raw?.pageSize === 'number' ? raw.pageSize : Number(raw?.pageSize)
+  const pageSize =
+    Number.isFinite(pageSizeRaw) && pageSizeRaw >= 1 && pageSizeRaw <= 100
+      ? Math.floor(pageSizeRaw)
+      : 20
+  const flowIdRaw = typeof raw?.flowId === 'number' ? raw.flowId : Number(raw?.flowId)
+  const flowId =
+    Number.isFinite(flowIdRaw) && flowIdRaw > 0 ? Math.floor(flowIdRaw) : undefined
+  const agentKind =
+    typeof raw?.agentKind === 'string' && raw.agentKind.trim()
+      ? raw.agentKind.trim()
+      : undefined
+  const agentUniqueId =
+    typeof raw?.agentUniqueId === 'string' && raw.agentUniqueId.trim()
+      ? raw.agentUniqueId.trim()
+      : undefined
+  return { agentKind, agentUniqueId, flowId, pageSize }
+}
+
+function normalizeResumeFilter(raw: FormResumeFilter | undefined): FormResumeFilter {
+  const pageSizeRaw = typeof raw?.pageSize === 'number' ? raw.pageSize : Number(raw?.pageSize)
+  const pageSize =
+    Number.isFinite(pageSizeRaw) && pageSizeRaw >= 1 && pageSizeRaw <= 100
+      ? Math.floor(pageSizeRaw)
+      : 20
+  return {
+    names: Array.isArray(raw?.names) ? raw!.names.map(String).filter(Boolean) : [],
+    agentUniqueIds: Array.isArray(raw?.agentUniqueIds)
+      ? raw!.agentUniqueIds.map(String).filter(Boolean)
+      : [],
+    resumeUniqueIds: Array.isArray(raw?.resumeUniqueIds)
+      ? raw!.resumeUniqueIds.map(String).filter(Boolean)
+      : [],
+    pageSize,
+  }
+}
+
 function normalizeBlock(raw: FormBlock): FormBlock {
   const fileAcceptTypes = normalizeFileAcceptTypes(raw.fileAcceptTypes)
   const type = raw.type
@@ -69,6 +107,14 @@ function normalizeBlock(raw: FormBlock): FormBlock {
           label: opt.label?.trim() || `选项 ${index + 1}`,
         }))
       : undefined,
+    resumeEnableRefresh:
+      type === 'resume_multiselect' ? raw.resumeEnableRefresh !== false : undefined,
+    resumeFilter:
+      type === 'resume_multiselect' ? normalizeResumeFilter(raw.resumeFilter) : undefined,
+    caseEnableRefresh:
+      type === 'case_singleselect' ? raw.caseEnableRefresh !== false : undefined,
+    caseFilter:
+      type === 'case_singleselect' ? normalizeCaseFilter(raw.caseFilter) : undefined,
   }
 }
 
@@ -135,6 +181,23 @@ export function createEmptyBlock(type: FormBlockType): FormBlock {
     block.fileMaxCount = 1
   }
 
+  if (type === 'resume_multiselect') {
+    block.resumeEnableRefresh = true
+    block.resumeFilter = {
+      names: [],
+      agentUniqueIds: [],
+      resumeUniqueIds: [],
+      pageSize: 20,
+    }
+    block.defaultValue = []
+  }
+
+  if (type === 'case_singleselect') {
+    block.caseEnableRefresh = true
+    block.caseFilter = { pageSize: 20 }
+    block.defaultValue = ''
+  }
+
   return block
 }
 

package/src/blocks/case_singleselect/adapter.ts

@@ -0,0 +1,74 @@
+import type { A2uiComponentNode, FormBlock } from '../../types/index'
+import type { BlockAdapterContext, BlockToComponentResult } from '../types'
+
+function asLiteral(value: unknown): string | undefined {
+  return typeof value === 'string' ? value : undefined
+}
+
+export function caseSingleselectToComponent(
+  block: FormBlock,
+  ctx: BlockAdapterContext,
+): BlockToComponentResult {
+  const { id, label, path, withData } = ctx
+  return withData({
+    id,
+    component: 'SkoponCaseSelect',
+    label,
+    placeholder: block.placeholder ?? '',
+    help: block.help ?? '',
+    enableRefresh: block.caseEnableRefresh !== false,
+    caseFilter: {
+      agentKind: block.caseFilter?.agentKind,
+      agentUniqueId: block.caseFilter?.agentUniqueId,
+      flowId: block.caseFilter?.flowId,
+      pageSize: block.caseFilter?.pageSize ?? 20,
+    },
+    value: { path },
+  })
+}
+
+export function caseSingleselectFromComponent(
+  node: A2uiComponentNode,
+  base: (type: 'case_singleselect') => FormBlock,
+  helpers: {
+    asLiteral: (value: unknown) => string | undefined
+    nameFromValue: (value: unknown) => string
+  },
+): FormBlock {
+  const name = helpers.nameFromValue(node.value)
+  const block: FormBlock = {
+    ...base('case_singleselect'),
+    name,
+    caseEnableRefresh: node.enableRefresh !== false,
+  }
+  const placeholder = helpers.asLiteral(node.placeholder)
+  if (placeholder) block.placeholder = placeholder
+  const help = helpers.asLiteral(node.help)
+  if (help) block.help = help
+  if (node.caseFilter && typeof node.caseFilter === 'object') {
+    const cf = node.caseFilter as Record<string, unknown>
+    const flowIdRaw = typeof cf.flowId === 'number' ? cf.flowId : Number(cf.flowId)
+    const pageSizeRaw = typeof cf.pageSize === 'number' ? cf.pageSize : Number(cf.pageSize)
+    const agentKind =
+      typeof cf.agentKind === 'string' && cf.agentKind.trim()
+        ? cf.agentKind.trim()
+        : undefined
+    const agentUniqueId =
+      typeof cf.agentUniqueId === 'string' && cf.agentUniqueId.trim()
+        ? cf.agentUniqueId.trim()
+        : undefined
+    block.caseFilter = {
+      agentKind,
+      agentUniqueId,
+      flowId:
+        Number.isFinite(flowIdRaw) && flowIdRaw > 0 ? Math.floor(flowIdRaw) : undefined,
+      pageSize:
+        Number.isFinite(pageSizeRaw) && pageSizeRaw >= 1 && pageSizeRaw <= 100
+          ? Math.floor(pageSizeRaw)
+          : 20,
+    }
+  }
+  return block
+}
+
+export { asLiteral }

package/src/blocks/case_singleselect/catalog.ts

@@ -0,0 +1 @@
+export { SkoponCaseSelectImpl } from '../../catalog/skoponCaseSelect'

package/src/blocks/case_singleselect/index.ts

@@ -0,0 +1,14 @@
+import type { BlockAdapterPlugin } from '../types'
+import {
+  caseSingleselectFromComponent,
+  caseSingleselectToComponent,
+} from './adapter'
+import { SkoponCaseSelectImpl } from './catalog'
+
+export const caseSingleselectAdapter: BlockAdapterPlugin = {
+  type: 'case_singleselect',
+  componentName: 'SkoponCaseSelect',
+  toComponent: caseSingleselectToComponent,
+  fromComponent: caseSingleselectFromComponent,
+  catalogComponents: [SkoponCaseSelectImpl],
+}

package/src/blocks/registry.ts

@@ -0,0 +1,34 @@
+import type { FormBlockType } from '../types/index'
+import type { BlockAdapterPlugin } from './types'
+import { caseSingleselectAdapter } from './case_singleselect'
+import { resumeMultiselectAdapter } from './resume_multiselect'
+
+const adapters: BlockAdapterPlugin[] = [resumeMultiselectAdapter, caseSingleselectAdapter]
+
+const adapterByType = new Map<FormBlockType, BlockAdapterPlugin>(
+  adapters.map((adapter) => [adapter.type, adapter]),
+)
+
+const adapterByComponent = new Map<string, BlockAdapterPlugin>(
+  adapters.map((adapter) => [adapter.componentName, adapter]),
+)
+
+export function getBlockTypeAdapter(type: FormBlockType): BlockAdapterPlugin | undefined {
+  return adapterByType.get(type)
+}
+
+export function getComponentAdapter(componentName: string): BlockAdapterPlugin | undefined {
+  return adapterByComponent.get(componentName)
+}
+
+export function getAllBlockAdapters(): BlockAdapterPlugin[] {
+  return adapters
+}
+
+export function getRegisteredCatalogComponents() {
+  return adapters.flatMap((adapter) => adapter.catalogComponents)
+}
+
+export function getRegisteredCatalogComponentNames(): string[] {
+  return adapters.map((adapter) => adapter.componentName)
+}

package/src/blocks/resume_multiselect/adapter.ts

@@ -0,0 +1,57 @@
+import type { A2uiComponentNode, FormBlock } from '../../types/index'
+import type { BlockAdapterContext, BlockToComponentResult } from '../types'
+
+function asLiteral(value: unknown): string | undefined {
+  return typeof value === 'string' ? value : undefined
+}
+
+export function resumeMultiselectToComponent(
+  block: FormBlock,
+  ctx: BlockAdapterContext,
+): BlockToComponentResult {
+  const { id, label, path, withData } = ctx
+  return withData({
+    id,
+    component: 'SkoponResumeSelect',
+    label,
+    placeholder: block.placeholder ?? '',
+    help: block.help ?? '',
+    enableRefresh: block.resumeEnableRefresh !== false,
+    resumeFilter: {
+      names: block.resumeFilter?.names ?? [],
+      agentUniqueIds: block.resumeFilter?.agentUniqueIds ?? [],
+      resumeUniqueIds: block.resumeFilter?.resumeUniqueIds ?? [],
+      pageSize: block.resumeFilter?.pageSize ?? 20,
+    },
+    value: { path },
+  })
+}
+
+export function resumeMultiselectFromComponent(
+  node: A2uiComponentNode,
+  base: (type: 'resume_multiselect') => FormBlock,
+  helpers: { asLiteral: (value: unknown) => string | undefined; nameFromValue: (value: unknown) => string },
+): FormBlock {
+  const name = helpers.nameFromValue(node.value)
+  const block: FormBlock = {
+    ...base('resume_multiselect'),
+    name,
+    resumeEnableRefresh: node.enableRefresh !== false,
+  }
+  const placeholder = helpers.asLiteral(node.placeholder)
+  if (placeholder) block.placeholder = placeholder
+  const help = helpers.asLiteral(node.help)
+  if (help) block.help = help
+  if (node.resumeFilter && typeof node.resumeFilter === 'object') {
+    const rf = node.resumeFilter as Record<string, unknown>
+    block.resumeFilter = {
+      names: Array.isArray(rf.names) ? rf.names.map(String) : [],
+      agentUniqueIds: Array.isArray(rf.agentUniqueIds) ? rf.agentUniqueIds.map(String) : [],
+      resumeUniqueIds: Array.isArray(rf.resumeUniqueIds) ? rf.resumeUniqueIds.map(String) : [],
+      pageSize: typeof rf.pageSize === 'number' ? rf.pageSize : 20,
+    }
+  }
+  return block
+}
+
+export { asLiteral }

package/src/blocks/resume_multiselect/catalog.ts

@@ -0,0 +1 @@
+export { SkoponResumeSelectImpl } from '../../catalog/skoponResumeSelect'

package/src/blocks/resume_multiselect/index.ts

@@ -0,0 +1,14 @@
+import type { BlockAdapterPlugin } from '../types'
+import {
+  resumeMultiselectFromComponent,
+  resumeMultiselectToComponent,
+} from './adapter'
+import { SkoponResumeSelectImpl } from './catalog'
+
+export const resumeMultiselectAdapter: BlockAdapterPlugin = {
+  type: 'resume_multiselect',
+  componentName: 'SkoponResumeSelect',
+  toComponent: resumeMultiselectToComponent,
+  fromComponent: resumeMultiselectFromComponent,
+  catalogComponents: [SkoponResumeSelectImpl],
+}

package/src/blocks/types.ts

@@ -0,0 +1,34 @@
+import type {
+  A2uiComponentNode,
+  FormBlock,
+  FormBlockType,
+} from '../types/index'
+import type { ReactComponentImplementation } from '@a2ui/react/v0_9'
+
+export interface BlockAdapterContext {
+  id: string
+  label: string
+  name: string
+  path: string | undefined
+  withData: (node: A2uiComponentNode) => {
+    node: A2uiComponentNode
+    dataKey?: string
+    dataValue?: unknown
+  }
+}
+
+export type BlockToComponentResult =
+  | { node: A2uiComponentNode | null }
+  | ReturnType<BlockAdapterContext['withData']>
+
+export interface BlockAdapterPlugin {
+  type: FormBlockType
+  componentName: string
+  toComponent: (block: FormBlock, ctx: BlockAdapterContext) => BlockToComponentResult
+  fromComponent: (
+    node: A2uiComponentNode,
+    base: (type: FormBlockType) => FormBlock,
+    helpers: { asLiteral: (value: unknown) => string | undefined; nameFromValue: (value: unknown) => string },
+  ) => FormBlock | null
+  catalogComponents: ReactComponentImplementation[]
+}

package/src/catalog/a2uiCustomCatalog.tsx

@@ -26,6 +26,10 @@ import {
   formatFileAcceptSummary,
 } from '../adapter/formFileAccept'
 import { buildMediaListClassName, normalizeMediaSize } from '../adapter/formMedia'
+import {
+  getRegisteredCatalogComponentNames,
+  getRegisteredCatalogComponents,
+} from '../blocks/registry'
 import FilePlaceholderIcon from '../icons/FilePlaceholderIcon'
 import { useA2uiPreviewMode } from './a2uiPreviewContext'
 import {
@@ -53,6 +57,7 @@ const SKOPON_COMPONENT_NAMES = new Set([
   'FileUpload',
   'TextField',
   'Text',
+  ...getRegisteredCatalogComponentNames(),
 ])
 
 const NON_MARKDOWN_TEXT_VARIANTS = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'caption'])
@@ -691,6 +696,7 @@ export function buildSkoponCatalog(): Catalog<ReactComponentImplementation> {
     FileUploadImpl,
     TextFieldImpl,
     TextImpl,
+    ...getRegisteredCatalogComponents(),
   ]
   const functions = [...basicCatalog.functions.values()]
   return new Catalog(SKOPON_CATALOG_ID, components, functions, basicCatalog.themeSchema)

package/src/catalog/caseSearchContext.tsx

@@ -0,0 +1,46 @@
+import { createContext, useContext, type ReactNode } from 'react'
+import type { FormCaseFilter } from '../types/index'
+
+export interface CaseSearchItem {
+  caseUniqueId: string
+  caseId?: number
+  flowId?: number
+  name: string
+  link?: string
+  platform?: string | null
+  description?: string
+}
+
+export interface CaseSearchParams {
+  filter: FormCaseFilter
+  page: number
+}
+
+export interface CaseSearchResult {
+  list: CaseSearchItem[]
+  total: number
+  page: number
+  pageSize: number
+}
+
+export type CaseSearchFn = (params: CaseSearchParams) => Promise<CaseSearchResult>
+
+const CaseSearchContext = createContext<CaseSearchFn | null>(null)
+
+export function CaseSearchProvider({
+  caseSearch,
+  children,
+}: {
+  caseSearch: CaseSearchFn | null | undefined
+  children: ReactNode
+}) {
+  return (
+    <CaseSearchContext.Provider value={caseSearch ?? null}>
+      {children}
+    </CaseSearchContext.Provider>
+  )
+}
+
+export function useCaseSearch(): CaseSearchFn | null {
+  return useContext(CaseSearchContext)
+}