@skopon-cool/form-sdk 0.4.0 → 0.4.1

package/package.json

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

package/src/components/AskUserFormCard.tsx

@@ -243,6 +243,12 @@ function AskUserFormCardBody({
     return { ...cardValues, ...extraValues }
   }, [fieldNames, extraValues])
 
+  // live options 走 ref，避免 options 刷新导致 reportSnapshot 引用变化、打断 Init 定时器
+  const liveOptionsRef = useRef(liveOptionsCtx.liveOptions)
+  liveOptionsRef.current = liveOptionsCtx.liveOptions
+  const pendingChangeRef = useRef(liveOptionsCtx.pendingChangeFields)
+  pendingChangeRef.current = liveOptionsCtx.pendingChangeFields
+
   const reportSnapshot = useCallback(
     (formChange: string[]) => {
       const snapshot = buildFormRuntimeSnapshot({
@@ -250,49 +256,49 @@ function AskUserFormCardBody({
         description: surfaceDescription,
         blocks: renderBlocks,
         values: collectAnswer(),
-        liveOptions: liveOptionsCtx.liveOptions,
+        liveOptions: liveOptionsRef.current,
         formChange,
       })
       runtime.reportData(snapshot)
     },
-    [
-      surfaceTitle,
-      surfaceDescription,
-      renderBlocks,
-      collectAnswer,
-      liveOptionsCtx.liveOptions,
-      runtime,
-    ],
+    [surfaceTitle, surfaceDescription, renderBlocks, collectAnswer, runtime],
   )
+  const reportSnapshotRef = useRef(reportSnapshot)
+  reportSnapshotRef.current = reportSnapshot
 
   // Init：surface 就绪或 doc 内容变化时上报（form_change: []）
+  // lastInitKey 仅在实际上报后写入；定时器被取消时不占位，避免 Init 被永久跳过。
   useEffect(() => {
-    if (!hasFormSurface || !docKey) return
+    if (!hasFormSurface) {
+      lastInitKeyRef.current = ''
+      return
+    }
+    if (!docKey) return
     const initKey = `${surfaceId}::${docKey}`
     if (lastInitKeyRef.current === initKey) return
-    lastInitKeyRef.current = initKey
-    // 等下一帧，确保 SkoponFormRenderer dataModel 已就绪
     const timer = setTimeout(() => {
       if (!mountedRef.current) return
-      reportSnapshot([])
+      if (lastInitKeyRef.current === initKey) return
+      lastInitKeyRef.current = initKey
+      reportSnapshotRef.current([])
     }, 0)
     return () => clearTimeout(timer)
-  }, [hasFormSurface, surfaceId, docKey, reportSnapshot])
+  }, [hasFormSurface, surfaceId, docKey])
 
   // Refresh：live options 变更后 debounce 上报（form_change 为变更字段）
   useEffect(() => {
     if (!hasFormSurface || liveOptionsCtx.version === 0) return
-    if (liveOptionsCtx.pendingChangeFields.length === 0) return
+    if (pendingChangeRef.current.length === 0) return
     if (refreshTimerRef.current != null) {
       clearTimeout(refreshTimerRef.current)
     }
     refreshTimerRef.current = setTimeout(() => {
       refreshTimerRef.current = null
       if (!mountedRef.current) return
-      const changed = [...liveOptionsCtx.pendingChangeFields]
+      const changed = [...pendingChangeRef.current]
       liveOptionsCtx.clearPendingChangeFields()
       if (changed.length === 0) return
-      reportSnapshot(changed)
+      reportSnapshotRef.current(changed)
     }, REFRESH_REPORT_DEBOUNCE_MS)
     return () => {
       if (refreshTimerRef.current != null) {
@@ -300,13 +306,7 @@ function AskUserFormCardBody({
         refreshTimerRef.current = null
       }
     }
-  }, [
-    hasFormSurface,
-    liveOptionsCtx.version,
-    liveOptionsCtx.pendingChangeFields,
-    liveOptionsCtx.clearPendingChangeFields,
-    reportSnapshot,
-  ])
+  }, [hasFormSurface, liveOptionsCtx.version, liveOptionsCtx.clearPendingChangeFields])
 
   const handleSubmit = useCallback(async () => {
     if (submitting) return