@incremark/react 0.2.4 → 0.2.5

package/dist/index.d.ts

@@ -180,6 +180,13 @@ declare function useIncremark(options?: UseIncremarkOptions): {
     isLoading: boolean;
     /** 是否已完成（finalize） */
     isFinalized: boolean;
+    /**
+     * 内容是否完全显示完成
+     * - 无打字机：等于 isFinalized
+     * - 有打字机：isFinalized + 动画播放完成
+     * 适用于控制 footnote 等需要在内容完全显示后才出现的元素
+     */
+    isDisplayComplete: boolean;
     /** 追加内容 */
     append: (chunk: string) => IncrementalUpdate;
     /** 完成解析 */

package/dist/index.js

@@ -146,6 +146,7 @@ function useTypewriter(options) {
     typewriterConfig?.effect ?? "none"
   );
   const [displayBlocks, setDisplayBlocks] = useState2([]);
+  const [isAnimationComplete, setIsAnimationComplete] = useState2(true);
   if (hasTypewriterConfig && !transformerRef.current) {
     const twOptions = typewriterConfig;
     transformerRef.current = createBlockTransformer({
@@ -158,6 +159,12 @@ function useTypewriter(options) {
         setDisplayBlocks(blocks2);
         setIsTypewriterProcessing(transformerRef.current?.isProcessing() ?? false);
         setIsTypewriterPaused(transformerRef.current?.isPausedState() ?? false);
+        if (transformerRef.current?.isProcessing()) {
+          setIsAnimationComplete(false);
+        }
+      },
+      onAllComplete: () => {
+        setIsAnimationComplete(true);
       }
     });
   }
@@ -283,7 +290,8 @@ function useTypewriter(options) {
   return {
     blocks,
     typewriter: typewriterControls,
-    transformer
+    transformer,
+    isAnimationComplete
   };
 }
 
@@ -318,11 +326,12 @@ function useIncremark(options = {}) {
   const [pendingBlocks, setPendingBlocks] = useState3([]);
   const [isLoading, setIsLoading] = useState3(false);
   const [isFinalized, setIsFinalized] = useState3(false);
-  const { blocks, typewriter, transformer } = useTypewriter({
+  const { blocks, typewriter, transformer, isAnimationComplete } = useTypewriter({
     typewriter: options.typewriter,
     completedBlocks,
     pendingBlocks
   });
+  const isDisplayComplete = isFinalized && isAnimationComplete;
   const ast = useMemo2(
     () => ({
       type: "root",
@@ -397,6 +406,13 @@ function useIncremark(options = {}) {
     isLoading,
     /** 是否已完成（finalize） */
     isFinalized,
+    /**
+     * 内容是否完全显示完成
+     * - 无打字机：等于 isFinalized
+     * - 有打字机：isFinalized + 动画播放完成
+     * 适用于控制 footnote 等需要在内容完全显示后才出现的元素
+     */
+    isDisplayComplete,
     /** 追加内容 */
     append,
     /** 完成解析 */
@@ -1304,7 +1320,7 @@ var Incremark = (props) => {
     incremark
   } = props;
   if (incremark) {
-    const { blocks: blocks2, isFinalized: isFinalized2, _definitionsContextValue } = incremark;
+    const { blocks: blocks2, isDisplayComplete: isDisplayComplete2, _definitionsContextValue } = incremark;
     return /* @__PURE__ */ jsx17(IncremarkContainerProvider, { definitions: _definitionsContextValue, children: /* @__PURE__ */ jsx17(
       IncremarkInternal,
       {
@@ -1314,12 +1330,12 @@ var Incremark = (props) => {
         customCodeBlocks,
         showBlockStatus,
         className,
-        isFinalized: isFinalized2
+        isDisplayComplete: isDisplayComplete2
       }
     ) });
   }
   const blocks = propsBlocks || [];
-  const isFinalized = blocks.length > 0 && blocks.every((b) => b.status === "completed");
+  const isDisplayComplete = blocks.length > 0 && blocks.every((b) => b.status === "completed");
   return /* @__PURE__ */ jsx17(
     IncremarkInternal,
     {
@@ -1329,7 +1345,7 @@ var Incremark = (props) => {
       customCodeBlocks,
       showBlockStatus,
       className,
-      isFinalized
+      isDisplayComplete
     }
   );
 };
@@ -1340,7 +1356,7 @@ var IncremarkInternal = ({
   customCodeBlocks,
   showBlockStatus,
   className,
-  isFinalized
+  isDisplayComplete
 }) => {
   return /* @__PURE__ */ jsxs8("div", { className: `incremark ${className}`, children: [
     blocks.map((block) => {
@@ -1365,7 +1381,7 @@ var IncremarkInternal = ({
         }
       ) }, block.stableId);
     }),
-    isFinalized && /* @__PURE__ */ jsx17(IncremarkFootnotes, {})
+    isDisplayComplete && /* @__PURE__ */ jsx17(IncremarkFootnotes, {})
   ] });
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incremark/react",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "license": "MIT",
   "description": "Incremark React integration - Incremental Markdown parser for AI streaming",
   "type": "module",
@@ -21,13 +21,13 @@
     "mermaid": "^10.0.0 || ^11.0.0",
     "katex": "^0.16.0",
     "react": ">=18.0.0",
-    "@incremark/core": "0.2.4"
+    "@incremark/core": "0.2.5"
   },
   "dependencies": {
     "shiki": "^3.20.0",
-    "@incremark/theme": "0.2.4",
-    "@incremark/shared": "0.2.4",
-    "@incremark/devtools": "0.2.4"
+    "@incremark/theme": "0.2.5",
+    "@incremark/shared": "0.2.5",
+    "@incremark/devtools": "0.2.5"
   },
   "devDependencies": {
     "@types/mdast": "^4.0.0",