@skopon-cool/form-sdk 0.6.6 → 0.6.8

package/dist/types/index.d.ts

@@ -52,6 +52,15 @@ export interface FormBlockCondition {
     operator: FormConditionOperator;
     value?: string;
 }
+/** Durable file reference saved in a file field's answer. */
+export interface FormFileValueRef {
+    asset_id: string;
+    source?: 'upload' | 'library_select';
+    url?: string;
+    expires_at?: number;
+    footage_asset_id?: string;
+    [key: string]: unknown;
+}
 /** 简历多选组件：渲染时用于 /univ/resume/search 的筛选条件 */
 export interface FormResumeFilter {
     names?: string[];
@@ -133,7 +142,7 @@ export interface FormBlock {
     fileReviewMessage?: string;
     /** 审核未通过的历史文件，仅作错误态回显，不计入有效提交。 */
     fileRejectedUrls?: string[];
-    defaultValue?: string | string[] | boolean;
+    defaultValue?: string | Array<string | FormFileValueRef> | boolean;
     /** 派生 JSON Schema 时写入 property.$comment */
     jsonSchemaDescription?: string;
     /** 是否隐藏（仅 text 块；隐藏时仍提交） */

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

package/src/adapter/formSchema.ts

@@ -1,6 +1,7 @@
 import type {
   FormBlock,
   FormBlockType,
+  FormFileValueRef,
   FormCaseFilter,
   FormContentFilter,
   FormResumeFilter,
@@ -63,10 +64,31 @@ function normalizeDefaultValue(
   if (type === 'toggle') {
     return coerceToggleValue(raw)
   }
+  if (type === 'file') {
+    const values: unknown[] = Array.isArray(raw) ? raw : [raw]
+    const normalizedValues: Array<string | FormFileValueRef> = []
+    for (const value of values) {
+      if (typeof value === 'string') {
+        if (value.trim()) normalizedValues.push(value.trim())
+        continue
+      }
+      if (!value || typeof value !== 'object' || Array.isArray(value)) continue
+      const ref = value as Record<string, unknown>
+      const assetId = String(ref.asset_id ?? ref.assetId ?? '').trim()
+      if (!assetId) continue
+      const normalized: FormFileValueRef = { ...ref, asset_id: assetId }
+      delete normalized.assetId
+      if (normalized.source !== 'library_select') normalized.source = 'upload'
+      if (typeof normalized.url !== 'string' || !/^https?:\/\//i.test(normalized.url)) delete normalized.url
+      if (typeof normalized.expires_at !== 'number' || !Number.isFinite(normalized.expires_at)) delete normalized.expires_at
+      if (normalized.footage_asset_id != null) normalized.footage_asset_id = String(normalized.footage_asset_id)
+      normalizedValues.push(normalized)
+    }
+    return normalizedValues
+  }
   if (
     type === 'multiselect' ||
     type === 'checkbox' ||
-    type === 'file' ||
     type === 'resume_multiselect' ||
     type === 'case_multiselect'
   ) {
@@ -342,9 +364,7 @@ export function resolveSchemaDefaultValue(block: FormBlock): unknown | undefined
       return values.length > 0 ? values : undefined
     }
     case 'file': {
-      const values = Array.isArray(normalized)
-        ? (normalized as string[]).map(String).map((item) => item.trim()).filter(Boolean)
-        : []
+      const values = Array.isArray(normalized) ? normalized : []
       return values.length > 0 ? values : undefined
     }
     default:
@@ -389,7 +409,21 @@ function blockToJsonSchemaProperty(block: FormBlock): Record<string, unknown> |
       const maxCount = normalizeFileUploadCount(block.fileMaxCount, 1)
       property = {
         type: 'array',
-        items: { type: 'string' },
+        items: {
+          anyOf: [
+            { type: 'string' },
+            {
+              type: 'object',
+              required: ['asset_id'],
+              properties: {
+                asset_id: { type: 'string' },
+                source: { type: 'string' },
+                url: { type: 'string' },
+              },
+              additionalProperties: true,
+            },
+          ],
+        },
         minItems: minCount,
         ...(maxCount > 0 ? { maxItems: maxCount } : {}),
       }

package/src/catalog/a2uiCustomCatalog.tsx

@@ -41,7 +41,7 @@ import FilePlaceholderIcon from '../icons/FilePlaceholderIcon'
 import { isUploadCancelledError } from '../client/uploadClient'
 import { useA2uiPreviewMode } from './a2uiPreviewContext'
 import { useFileUploadStatus } from './fileUploadStatusContext'
-import { useMaterialUpload } from './materialUploadContext'
+import { useMaterialResolveUrls, useMaterialUpload } from './materialUploadContext'
 import {
   asOptionalString,
   asStringArray,
@@ -59,6 +59,7 @@ const SKOPON_COMPONENT_NAMES = new Set([
   'SkoponMedia',
   'SkoponSelect',
   'SkoponModulePanel',
+  'Tabs',
   'Image',
   'Video',
   'AudioPlayer',
@@ -334,6 +335,86 @@ const SkoponModulePanelImpl = createBinderlessComponentImplementation(
   },
 )
 
+/** Keep visited module panels mounted so file previews and in-progress fields survive tab changes. */
+const TabsImpl = createBinderlessComponentImplementation(
+  { name: 'Tabs', schema: getBasicSchema('Tabs') },
+  ({ context, buildChild }) => {
+    const props = context.componentModel.properties as Record<string, unknown>
+    const tabs = Array.isArray(props.tabs)
+      ? props.tabs.filter((tab): tab is Record<string, unknown> => !!tab && typeof tab === 'object')
+      : []
+    const [selectedIndex, setSelectedIndex] = useState(0)
+    const [visitedIndices, setVisitedIndices] = useState<Set<number>>(() => new Set([0]))
+    const selected = Math.min(selectedIndex, Math.max(0, tabs.length - 1))
+    const tabHeadersStyle = {
+      display: 'flex',
+      gap: 'var(--a2ui-spacing-xs, 0.25rem)',
+      borderBottom: 'var(--a2ui-tabs-border, var(--a2ui-border-width, 1px) solid var(--a2ui-color-border, #ccc))',
+      marginBottom: 'var(--a2ui-spacing-m, 0.5rem)',
+    }
+    const tabHeaderBaseStyle = {
+      padding: 'var(--a2ui-spacing-m, 0.5rem) var(--a2ui-spacing-l, 1rem)',
+      background: 'var(--a2ui-tabs-header-background, transparent)',
+      color: 'var(--a2ui-tabs-header-color, var(--a2ui-color-on-surface))',
+      border: 'none',
+      borderRadius: 'var(--a2ui-border-radius, 0.25rem) var(--a2ui-border-radius, 0.25rem) 0 0',
+      cursor: 'pointer',
+      fontFamily: 'inherit',
+    }
+    const tabHeaderActiveStyle = {
+      background: 'var(--a2ui-tabs-header-background-active, var(--a2ui-color-secondary, #eee))',
+      color: 'var(--a2ui-tabs-header-color-active, var(--a2ui-color-on-secondary, #333))',
+    }
+
+    return (
+      <div className="skopon-module-tabs">
+        <div className="skopon-module-tabs__header" role="tablist" aria-label="表单分组" style={tabHeadersStyle}>
+          {tabs.map((tab, index) => {
+            const active = selected === index
+            const rawTitle = tab.title as Parameters<typeof context.dataContext.resolveDynamicValue>[0]
+            const title = context.dataContext.resolveDynamicValue<string>(rawTitle) || ''
+            return (
+              <button
+                key={index}
+                type="button"
+                role="tab"
+                id={`skopon-module-tab-${context.componentModel.id}-${index}`}
+                aria-selected={active}
+                aria-controls={`skopon-module-panel-${context.componentModel.id}-${index}`}
+                className={`a2ui-tabs-header a2ui-tab-button ${active ? 'active' : ''}`}
+                style={{ ...tabHeaderBaseStyle, ...(active ? tabHeaderActiveStyle : {}) }}
+                onClick={() => {
+                  setSelectedIndex(index)
+                  setVisitedIndices(current => current.has(index) ? current : new Set(current).add(index))
+                }}
+              >
+                {title}
+              </button>
+            )
+          })}
+        </div>
+        <div className="skopon-module-tabs__content">
+          {tabs.map((tab, index) => {
+            const child = typeof tab.child === 'string' ? tab.child : ''
+            return (
+              <div
+                key={index}
+                id={`skopon-module-panel-${context.componentModel.id}-${index}`}
+                role="tabpanel"
+                aria-labelledby={`skopon-module-tab-${context.componentModel.id}-${index}`}
+                hidden={selected !== index}
+                style={{ padding: 'var(--a2ui-tabs-content-padding, 0 var(--a2ui-spacing-m, 0.5rem))' }}
+              >
+                {visitedIndices.has(index) && child ? buildChild(child) : null}
+              </div>
+            )
+          })}
+        </div>
+      </div>
+    )
+  },
+)
+
 function ChoicePickerPreview({ context }: { context: ComponentContext }) {
   const { interactive } = useA2uiPreviewMode()
   const { value, setValue, setValueSilent, fieldName } = useSkoponBoundField(context, 'value', {
@@ -596,6 +677,7 @@ function normalizeFileValues(value: unknown): FileValueRef[] {
     result.push({
       assetId,
       source: obj.source === 'library_select' ? 'library_select' as const : 'upload' as const,
+      url: typeof obj.url === 'string' && /^https?:\/\//i.test(obj.url) ? obj.url : undefined,
     })
     return result
   }, [])
@@ -619,6 +701,7 @@ function FileUploadPreview({ context }: { context: ComponentContext }) {
   const { interactive } = useA2uiPreviewMode()
   const { beginUpload } = useFileUploadStatus()
   const uploadMaterial = useMaterialUpload()
+  const resolveMaterialUrls = useMaterialResolveUrls()
   const { value, setValue, setValueSilent, fieldName } = useSkoponBoundField(context, 'value', {
     component: 'FileUpload',
     changeAction: 'change',
@@ -663,14 +746,22 @@ function FileUploadPreview({ context }: { context: ComponentContext }) {
       ? '物料或素材'
       : '物料 · 仅上传'
   const initialValues = normalizeFileValues(value)
+  const initialAssetIds = [...new Set(initialValues.flatMap((entry) => entry.assetId ? [entry.assetId] : []))]
   const externalUidRef = useRef(0)
   const mountedRef = useRef(true)
   const controllersRef = useRef(new Map<string, AbortController>())
+  const previewRefreshAttemptedRef = useRef(new Set<string>())
   const setValueRef = useRef(setValue)
   setValueRef.current = setValue
   const [items, setItems] = useState<FileUploadListItem[]>(() => [
     ...initialValues.map((entry) => {
-      if (entry.url) return fileItemFromUrl(entry.url, `external-${externalUidRef.current++}`)
+      if (entry.url) {
+        return {
+          ...fileItemFromUrl(entry.url, `external-${externalUidRef.current++}`),
+          assetId: entry.assetId,
+          source: entry.source,
+        }
+      }
       const option = assetOptions.find((item) => item.assetId === entry.assetId)
       return {
         uid: `asset-${entry.assetId}-${externalUidRef.current++}`,
@@ -689,6 +780,35 @@ function FileUploadPreview({ context }: { context: ComponentContext }) {
   ])
   const itemsRef = useRef(items)
   itemsRef.current = items
+  const unresolvedAssetIds = initialAssetIds.filter((assetId) => {
+    const itemUrl = itemsRef.current.find((item) => item.assetId === assetId)?.url
+    const option = assetOptions.find((item) => item.assetId === assetId)
+    return !(itemUrl || option?.previewUrl || option?.url)
+  })
+  const unresolvedAssetKey = unresolvedAssetIds.join('\u0000')
+
+  useEffect(() => {
+    const assetIds = unresolvedAssetKey ? unresolvedAssetKey.split('\u0000') : []
+    if (!resolveMaterialUrls || !assetIds.length) return
+    let cancelled = false
+    void resolveMaterialUrls(assetIds).then((urls) => {
+      if (cancelled) return
+      const validUrls = Object.fromEntries(Object.entries(urls).filter(([assetId, url]) =>
+        assetIds.includes(assetId) && /^https?:\/\//i.test(url),
+      ))
+      if (!Object.keys(validUrls).length) return
+      setItems((current) => {
+        const next = current.map((item) => item.assetId && validUrls[item.assetId]
+          ? { ...item, url: validUrls[item.assetId] }
+          : item)
+        itemsRef.current = next
+        return next
+      })
+    }).catch((error: unknown) => {
+      console.warn('[Form material preview] Unable to resolve saved asset previews', error)
+    })
+    return () => { cancelled = true }
+  }, [unresolvedAssetKey, resolveMaterialUrls])
 
   const commitItems = useCallback(
     (
@@ -738,7 +858,11 @@ function FileUploadPreview({ context }: { context: ComponentContext }) {
           const key = entry.assetId ? `asset:${entry.assetId}` : `url:${entry.url}`
           if (present.has(key)) return
           if (entry.url) {
-            next.push(fileItemFromUrl(entry.url, `external-${externalUidRef.current++}`))
+            next.push({
+              ...fileItemFromUrl(entry.url, `external-${externalUidRef.current++}`),
+              assetId: entry.assetId,
+              source: entry.source,
+            })
             return
           }
           const option = assetOptions.find((item) => item.assetId === entry.assetId)
@@ -830,6 +954,35 @@ function FileUploadPreview({ context }: { context: ComponentContext }) {
     [commitItems],
   )
 
+  const handlePreviewError = useCallback((uid: string) => {
+    const item = itemsRef.current.find((candidate) => candidate.uid === uid)
+    if (!item?.url) return
+
+    // Signed preview URLs can expire while a form is open. Clear the failed URL
+    // immediately so the browser does not leave a broken-image icon, then ask
+    // the host to resolve the stable asset ID once more.
+    const failedUrl = item.url
+    const next = itemsRef.current.map((candidate) =>
+      candidate.uid === uid ? { ...candidate, url: undefined } : candidate,
+    )
+    itemsRef.current = next
+    setItems(next)
+
+    if (!item.assetId || !resolveMaterialUrls || previewRefreshAttemptedRef.current.has(uid)) return
+    previewRefreshAttemptedRef.current.add(uid)
+    void resolveMaterialUrls([item.assetId]).then((urls) => {
+      const freshUrl = urls[item.assetId!]
+      if (!mountedRef.current || !freshUrl || freshUrl === failedUrl || !/^https?:\/\//i.test(freshUrl)) return
+      const refreshed = itemsRef.current.map((candidate) =>
+        candidate.uid === uid ? { ...candidate, url: freshUrl } : candidate,
+      )
+      itemsRef.current = refreshed
+      setItems(refreshed)
+    }).catch((error: unknown) => {
+      console.warn('[Form material preview] Unable to refresh a failed asset preview', error)
+    })
+  }, [resolveMaterialUrls])
+
   const uploadedCount = items.filter((item) => item.status === 'done').length
   const atMaxLimit = hasMaxLimit && items.filter((item) => item.status !== 'error').length >= maxCount
   const belowMinCount = uploadedCount < minCount
@@ -881,7 +1034,7 @@ function FileUploadPreview({ context }: { context: ComponentContext }) {
   if (compact) {
     const displayItem = items.find((item) => item.status === 'error') ?? items[0]
     const displayUrl = displayItem?.url
-    const isImage = fileAcceptTypes?.includes('image/*') ?? placeholderIcon === 'image'
+    const isImage = placeholderIcon === 'image' || Boolean(fileAcceptTypes?.some((type) => type.toLowerCase().startsWith('image/')))
     const state = reviewStatus === 'passed'
       ? 'passed'
       : reviewStatus === 'failed'
@@ -906,7 +1059,7 @@ function FileUploadPreview({ context }: { context: ComponentContext }) {
       <><article className={`skopon-compact-upload skopon-compact-upload--${state}`} data-skopon-field={fieldName || undefined}>
         <div className="skopon-compact-upload__thumb">
           {displayUrl && isImage ? (
-            <img src={displayUrl} alt={label || '已上传素材'} />
+            <img src={displayUrl} alt={label || '已上传素材'} onError={() => displayItem && handlePreviewError(displayItem.uid)} />
           ) : (
             <FilePlaceholderIcon type={placeholderIcon} size={30} />
           )}
@@ -1175,6 +1328,7 @@ export function buildSkoponCatalog(): Catalog<ReactComponentImplementation> {
     SkoponMediaImpl,
     SkoponSelectImpl,
     SkoponModulePanelImpl,
+    TabsImpl,
     ImageImpl,
     VideoImpl,
     AudioPlayerImpl,

package/src/catalog/materialUploadContext.tsx

@@ -22,18 +22,26 @@ export type MaterialUploadFn = (
   options?: { signal?: AbortSignal },
 ) => Promise<MaterialUploadResult>
 
+/** Resolve durable private asset IDs to short-lived preview URLs for rendering. */
+export type MaterialResolveUrlsFn = (assetIds: string[]) => Promise<Record<string, string>>
+
 const MaterialUploadContext = createContext<MaterialUploadFn | null>(null)
+const MaterialResolveUrlsContext = createContext<MaterialResolveUrlsFn | null>(null)
 
 export function MaterialUploadProvider({
   uploadMaterial,
+  resolveMaterialUrls,
   children,
 }: {
   uploadMaterial?: MaterialUploadFn | null
+  resolveMaterialUrls?: MaterialResolveUrlsFn | null
   children: ReactNode
 }) {
   return (
     <MaterialUploadContext.Provider value={uploadMaterial ?? null}>
-      {children}
+      <MaterialResolveUrlsContext.Provider value={resolveMaterialUrls ?? null}>
+        {children}
+      </MaterialResolveUrlsContext.Provider>
     </MaterialUploadContext.Provider>
   )
 }
@@ -41,3 +49,7 @@ export function MaterialUploadProvider({
 export function useMaterialUpload(): MaterialUploadFn | null {
   return useContext(MaterialUploadContext)
 }
+
+export function useMaterialResolveUrls(): MaterialResolveUrlsFn | null {
+  return useContext(MaterialResolveUrlsContext)
+}

package/src/components/AskUserFormCard.tsx

@@ -41,7 +41,7 @@ import {
 import SkoponFormRenderer, { type SkoponFormRendererRef } from './SkoponFormRenderer'
 import CurlSubmitBlock from './CurlSubmitBlock'
 import SkoponFormProvider from './SkoponFormProvider'
-import type { MaterialUploadFn } from '../catalog/materialUploadContext'
+import type { MaterialResolveUrlsFn, MaterialUploadFn } from '../catalog/materialUploadContext'
 
 const REFRESH_REPORT_DEBOUNCE_MS = 80
 
@@ -85,6 +85,8 @@ export interface AskUserFormCardProps {
   caseSearch?: CaseSearchFn | null
   /** 用户私有物料上传函数，由宿主负责浏览器直传及上下文。 */
   uploadMaterial?: MaterialUploadFn | null
+  /** 用户私有素材 URL 解析函数，由宿主提供 API，SDK 负责用它回显 asset_id。 */
+  resolveMaterialUrls?: MaterialResolveUrlsFn | null
 }
 
 interface AskUserFormCardBodyProps extends AskUserFormCardProps {
@@ -107,6 +109,7 @@ function AskUserFormCardBody({
   contentSearch = null,
   caseSearch = null,
   uploadMaterial = null,
+  resolveMaterialUrls = null,
   onSurfaceReadyChange,
   onAutoControlReady,
 }: AskUserFormCardBodyProps) {
@@ -521,6 +524,7 @@ function AskUserFormCardBody({
         contentSearch={contentSearch}
         caseSearch={caseSearch}
         uploadMaterial={uploadMaterial}
+        resolveMaterialUrls={resolveMaterialUrls}
         onUploadingChange={setUploading}
       />
 

package/src/components/SkoponFormRenderer.tsx

@@ -16,7 +16,7 @@ import { isA2uiSurfaceEmpty, surfaceDocToMessages } from '../adapter/a2uiAdapter
 import { SKOPON_CATALOG_ID, buildSkoponCatalog } from '../catalog/a2uiCustomCatalog'
 import { A2uiPreviewModeProvider } from '../catalog/a2uiPreviewContext'
 import { FileUploadStatusProvider } from '../catalog/fileUploadStatusContext'
-import { MaterialUploadProvider, type MaterialUploadFn } from '../catalog/materialUploadContext'
+import { MaterialUploadProvider, type MaterialResolveUrlsFn, type MaterialUploadFn } from '../catalog/materialUploadContext'
 import { CaseSearchProvider, type CaseSearchFn } from '../catalog/caseSearchContext'
 import { ContentSearchProvider, type ContentSearchFn } from '../catalog/contentSearchContext'
 import { ResumeSearchProvider, type ResumeSearchFn } from '../catalog/resumeSearchContext'
@@ -44,6 +44,8 @@ export interface SkoponFormRendererProps {
   onUploadingChange?: (uploading: boolean) => void
   /** 宿主注入的用户私有物料直传；未注入时上传会失败并提示配置。 */
   uploadMaterial?: MaterialUploadFn | null
+  /** 宿主注入的私有素材 URL 解析器；用于回显已保存的 asset_id。 */
+  resolveMaterialUrls?: MaterialResolveUrlsFn | null
   /** 外层已包裹 SkoponFormProvider 时可设为 false，避免重复 ConfigProvider */
   wrapProvider?: boolean
 }
@@ -61,6 +63,7 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
       caseSearch = null,
       onUploadingChange,
       uploadMaterial = null,
+      resolveMaterialUrls = null,
       wrapProvider = true,
     },
     ref,
@@ -148,7 +151,7 @@ const SkoponFormRenderer = forwardRef<SkoponFormRendererRef, SkoponFormRendererP
     }
 
     const content = (
-      <MaterialUploadProvider uploadMaterial={uploadMaterial}>
+      <MaterialUploadProvider uploadMaterial={uploadMaterial} resolveMaterialUrls={resolveMaterialUrls}>
       <FileUploadStatusProvider onUploadingChange={onUploadingChange}>
         <ResumeSearchProvider resumeSearch={resumeSearch}>
           <ContentSearchProvider contentSearch={contentSearch}>

package/src/index.ts

@@ -14,6 +14,7 @@ export type {
   FormDefinitionPayload,
   FormDetailResult,
   FormFilePlaceholderIcon,
+  FormFileValueRef,
   FormJsonSchema,
   FormMediaSize,
   FormModule,
@@ -153,6 +154,7 @@ export type { SkoponA2uiStreamRendererProps } from './components/SkoponA2uiStrea
 
 export { default as AskUserFormCard } from './components/AskUserFormCard'
 export type { AskUserFormCardProps } from './components/AskUserFormCard'
+export type { MaterialResolveUrlsFn, MaterialUploadFn, MaterialUploadResult } from './catalog/materialUploadContext'
 
 export { default as CurlSubmitBlock } from './components/CurlSubmitBlock'
 export type { CurlSubmitBlockProps } from './components/CurlSubmitBlock'

package/src/styles/index.css

@@ -825,10 +825,79 @@
 .skopon-file-source-actions {
   display: flex;
   flex-wrap: wrap;
+  align-items: center;
   gap: 8px;
   margin: 8px 0;
 }
 
+.skopon-file-source-actions > .ant-upload-wrapper,
+.skopon-file-source-actions > .ant-upload-wrapper > .ant-upload,
+.skopon-card-form .skopon-file-source-actions > .ant-upload-wrapper,
+.skopon-card-form .skopon-file-source-actions > .ant-upload-wrapper > .ant-upload {
+  display: inline-flex;
+  width: auto;
+  flex: 0 0 auto;
+}
+
+/* Keep the three form actions consistent across hosts with different CSS resets. */
+.skopon-resume-select-actions .ant-btn,
+.skopon-file-source-actions .ant-btn,
+.skopon-card-form .skopon-resume-select-actions .ant-btn,
+.skopon-card-form .skopon-file-source-actions .ant-btn {
+  box-sizing: border-box;
+  display: inline-flex;
+  min-width: 0;
+  min-height: 32px;
+  height: 32px;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  padding: 0 13px;
+  border: 1px solid var(--color-border-strong, #cbd5d1);
+  border-radius: var(--radius-button, 9999px);
+  background: var(--color-surface, #fff);
+  color: var(--color-primary, #208368);
+  font-family: var(--font-sans, sans-serif);
+  font-size: 13px;
+  font-weight: var(--font-weight-medium, 500);
+  line-height: 18px;
+  box-shadow: none !important;
+  filter: none !important;
+  white-space: nowrap;
+}
+
+.skopon-resume-select-actions .ant-btn:hover:not(:disabled),
+.skopon-file-source-actions .ant-btn:hover:not(:disabled),
+.skopon-card-form .skopon-resume-select-actions .ant-btn:hover:not(:disabled),
+.skopon-card-form .skopon-file-source-actions .ant-btn:hover:not(:disabled) {
+  border-color: var(--color-primary, #208368);
+  background: var(--color-primary-subtle, #e6f7ed);
+  color: var(--color-primary, #208368);
+}
+
+.skopon-resume-select-actions .ant-btn:focus:not(:focus-visible),
+.skopon-file-source-actions .ant-btn:focus:not(:focus-visible),
+.skopon-card-form .skopon-resume-select-actions .ant-btn:focus:not(:focus-visible),
+.skopon-card-form .skopon-file-source-actions .ant-btn:focus:not(:focus-visible) {
+  outline: none;
+}
+
+.skopon-resume-select-actions .ant-btn:focus-visible,
+.skopon-file-source-actions .ant-btn:focus-visible,
+.skopon-card-form .skopon-resume-select-actions .ant-btn:focus-visible,
+.skopon-card-form .skopon-file-source-actions .ant-btn:focus-visible {
+  outline: 2px solid var(--color-focus-ring, color-mix(in srgb, var(--color-primary, #208368) 35%, transparent));
+  outline-offset: 2px;
+}
+
+.skopon-resume-select-actions .ant-btn::before,
+.skopon-file-source-actions .ant-btn::before,
+.skopon-card-form .skopon-resume-select-actions .ant-btn::before,
+.skopon-card-form .skopon-file-source-actions .ant-btn::before {
+  box-shadow: none !important;
+  filter: none !important;
+}
+
 .skopon-asset-picker {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));

package/src/types/index.ts

@@ -114,6 +114,16 @@ export interface FormBlockCondition {
   value?: string
 }
 
+/** Durable file reference saved in a file field's answer. */
+export interface FormFileValueRef {
+  asset_id: string
+  source?: 'upload' | 'library_select'
+  url?: string
+  expires_at?: number
+  footage_asset_id?: string
+  [key: string]: unknown
+}
+
 /** 简历多选组件：渲染时用于 /univ/resume/search 的筛选条件 */
 export interface FormResumeFilter {
   names?: string[]
@@ -198,7 +208,7 @@ export interface FormBlock {
   fileReviewMessage?: string
   /** 审核未通过的历史文件，仅作错误态回显，不计入有效提交。 */
   fileRejectedUrls?: string[]
-  defaultValue?: string | string[] | boolean
+  defaultValue?: string | Array<string | FormFileValueRef> | boolean
   /** 派生 JSON Schema 时写入 property.$comment */
   jsonSchemaDescription?: string
   /** 是否隐藏（仅 text 块；隐藏时仍提交） */