@incremark/svelte 0.2.4 → 0.2.6

package/dist/components/Incremark.svelte

@@ -6,24 +6,14 @@
 <script lang="ts">
   import type { Component } from 'svelte'
   import type { Readable } from 'svelte/store'
-  import type { RootContent } from '@incremark/core'
+  import type { RootContent, ParsedBlock } from '@incremark/core'
   import type { HTML } from 'mdast'
-  
+
   import { getDefinitionsContext } from '../context/definitionsContext'
   import type { UseIncremarkReturn } from '../stores/useIncremark'
   import type { ComponentMap, BlockWithStableId } from './types'
-  
-  // 导入默认组件
-  import IncremarkParagraph from './IncremarkParagraph.svelte'
-  import IncremarkHeading from './IncremarkHeading.svelte'
-  import IncremarkCode from './IncremarkCode.svelte'
-  import IncremarkList from './IncremarkList.svelte'
-  import IncremarkTable from './IncremarkTable.svelte'
-  import IncremarkBlockquote from './IncremarkBlockquote.svelte'
-  import IncremarkThematicBreak from './IncremarkThematicBreak.svelte'
-  import IncremarkMath from './IncremarkMath.svelte'
-  import IncremarkHtmlElement from './IncremarkHtmlElement.svelte'
-  import IncremarkDefault from './IncremarkDefault.svelte'
+
+  // 导入组件
   import IncremarkFootnotes from './IncremarkFootnotes.svelte'
   import IncremarkRenderer from './IncremarkRenderer.svelte'
 
@@ -40,12 +30,17 @@
   interface Props {
     /** 要渲染的块列表（来自 useIncremark 的 blocks） */
     blocks?: BlockWithStableId[] | Readable<BlockWithStableId[]>
+    /** 内容是否完全显示完成（用于控制脚注等需要在内容完全显示后才出现的元素）
+     * 如果传入了 incremark，则会自动使用 incremark.isDisplayComplete，此 prop 被忽略 */
+    isDisplayComplete?: boolean
     /** 自定义组件映射，key 为节点类型 */
     components?: ComponentMap
     /** 自定义容器组件映射，key 为容器名称（如 'warning', 'info'） */
     customContainers?: Record<string, Component<any>>
     /** 自定义代码块组件映射，key 为代码语言名称（如 'echart', 'mermaid'） */
     customCodeBlocks?: Record<string, Component<any>>
+    /** 代码块配置映射，key 为代码语言名称 */
+    codeBlockConfigs?: Record<string, { takeOver?: boolean }>
     /** 待处理块的样式类名 */
     pendingClass?: string
     /** 已完成块的样式类名 */
@@ -58,117 +53,76 @@
 
   let {
     blocks = [],
+    isDisplayComplete = false,
     components = {},
     customContainers = {},
     customCodeBlocks = {},
+    codeBlockConfigs = {},
     pendingClass = 'incremark-pending',
     completedClass = 'incremark-completed',
     showBlockStatus = false,
     incremark
   }: Props = $props()
 
-  // 从 context 获取 footnoteReferenceOrder（如果有的话）
-  // 使用 $derived 来确保响应式
-  const footnoteReferenceOrder = $derived.by(() => {
-    try {
-      const context = getDefinitionsContext()
-      return context.footnoteReferenceOrder
-    } catch {
-      // 如果没有 context，返回 null
-      return null
-    }
-  })
-
-  // 计算 isFinalized（当不使用 incremark 时）
-  const actualIsFinalized = $derived.by(() => {
-    if (incremark) {
-      // 如果提供了 incremark，在模板中直接使用 $incremark.isFinalized
-      return false
-    }
-    // 如果手动传入 blocks，自动判断是否所有 block 都是 completed
-    const blocksArray = Array.isArray(blocks) ? blocks : []
-    return blocksArray.length > 0 && blocksArray.every(b => b.status === 'completed')
-  })
-
-  // 默认组件映射
-  const defaultComponents: ComponentMap = {
-    paragraph: IncremarkParagraph,
-    heading: IncremarkHeading,
-    code: IncremarkCode,
-    list: IncremarkList,
-    table: IncremarkTable,
-    blockquote: IncremarkBlockquote,
-    thematicBreak: IncremarkThematicBreak,
-    math: IncremarkMath,
-    inlineMath: IncremarkMath,
-    htmlElement: IncremarkHtmlElement
-  }
-
-  // 合并用户组件和默认组件
-  const mergedComponents = $derived({
-    ...defaultComponents,
-    ...components
-  })
-
-  // 处理 blocks（可能是 store 或数组）
-  const blocksArray = $derived.by(() => {
-    if (incremark) {
-      // 如果提供了 incremark，在模板中直接使用 incremark.blocks（store）
-      return []
-    }
-    return Array.isArray(blocks) ? blocks : []
-  })
+  const context = getDefinitionsContext();
+  const footnoteReferenceOrder = $derived(context?.footnoteReferenceOrder ?? []);
 
-  // 提取 incremark 的 stores（如果存在）
-  const incremarkBlocks = $derived.by(() => incremark?.blocks)
-  const incremarkIsFinalized = $derived.by(() => incremark?.isFinalized)
+  // 当使用 incremark 时，从 incremark 对象中提取 blocks 和 isDisplayComplete
+  const incremarkBlocks = $derived(
+    incremark ? (incremark as any).blocks : []
+  );
+  const incremarkIsDisplayComplete = $derived(
+    incremark ? (incremark as any).isDisplayComplete : false
+  );
 </script>
 
 <div class="incremark">
   <!-- 主要内容块 -->
-  {#if incremark && incremarkBlocks}
+  {#if incremark}
     <!-- 使用 incremark 的 blocks store -->
-    {#each ($incremarkBlocks || []) as block (block.stableId)}
-      {#if block.node.type !== 'definition' && block.node.type !== 'footnoteDefinition'}
+    {#each $incremarkBlocks as block (block.stableId)}
+      {#if (block as ParsedBlock).node.type !== 'definition' && (block as ParsedBlock).node.type !== 'footnoteDefinition'}
         <div
-          class="incremark-block {block.status === 'completed' ? completedClass : pendingClass} {showBlockStatus ? 'incremark-show-status' : ''} {(block as BlockWithStableId).isLastPending ? 'incremark-last-pending' : ''}"
+          class="incremark-block {(block as ParsedBlock).status === 'completed' ? completedClass : pendingClass} {showBlockStatus ? 'incremark-show-status' : ''} {(block as BlockWithStableId).isLastPending ? 'incremark-last-pending' : ''}"
         >
           <!-- 使用 IncremarkRenderer，传递 customContainers 和 customCodeBlocks -->
-          <IncremarkRenderer 
-            node={block.node} 
+          <IncremarkRenderer
+            node={(block as ParsedBlock).node}
             customContainers={customContainers}
             customCodeBlocks={customCodeBlocks}
-            blockStatus={block.status}
+            codeBlockConfigs={codeBlockConfigs}
+            blockStatus={(block as ParsedBlock).status}
           />
         </div>
       {/if}
     {/each}
   {:else}
     <!-- 使用传入的 blocks 数组 -->
-    {#each blocksArray as block (block.stableId)}
-      {#if block.node.type !== 'definition' && block.node.type !== 'footnoteDefinition'}
+    {#each (Array.isArray(blocks) ? blocks : []) as block (block.stableId)}
+      {#if (block as ParsedBlock).node.type !== 'definition' && (block as ParsedBlock).node.type !== 'footnoteDefinition'}
         <div
-          class="incremark-block {block.status === 'completed' ? completedClass : pendingClass} {showBlockStatus ? 'incremark-show-status' : ''} {block.isLastPending ? 'incremark-last-pending' : ''}"
+          class="incremark-block {(block as ParsedBlock).status === 'completed' ? completedClass : pendingClass} {showBlockStatus ? 'incremark-show-status' : ''} {block.isLastPending ? 'incremark-last-pending' : ''}"
         >
           <!-- 使用 IncremarkRenderer，传递 customContainers 和 customCodeBlocks -->
-          <IncremarkRenderer 
-            node={block.node} 
+          <IncremarkRenderer
+            node={(block as ParsedBlock).node}
             customContainers={customContainers}
             customCodeBlocks={customCodeBlocks}
-            blockStatus={block.status}
+            codeBlockConfigs={codeBlockConfigs}
+            blockStatus={(block as ParsedBlock).status}
           />
         </div>
       {/if}
     {/each}
   {/if}
 
-  <!-- 脚注列表（仅在 finalize 后显示） -->
-  {#if incremark && incremarkIsFinalized && footnoteReferenceOrder && $incremarkIsFinalized}
+  <!-- 脚注列表（仅在内容完全显示后显示） -->
+  {#if incremark && $incremarkIsDisplayComplete && $footnoteReferenceOrder}
     {@const footnoteOrder = $footnoteReferenceOrder ?? []}
     {#if footnoteOrder.length > 0}
       <IncremarkFootnotes />
     {/if}
-  {:else if !incremark && actualIsFinalized && footnoteReferenceOrder}
+  {:else if !incremark && isDisplayComplete && $footnoteReferenceOrder}
     {@const footnoteOrder = $footnoteReferenceOrder ?? []}
     {#if footnoteOrder.length > 0}
       <IncremarkFootnotes />

package/dist/components/Incremark.svelte.d.ts

@@ -8,12 +8,19 @@ import type { ComponentMap, BlockWithStableId } from './types';
 interface Props {
     /** 要渲染的块列表（来自 useIncremark 的 blocks） */
     blocks?: BlockWithStableId[] | Readable<BlockWithStableId[]>;
+    /** 内容是否完全显示完成（用于控制脚注等需要在内容完全显示后才出现的元素）
+     * 如果传入了 incremark，则会自动使用 incremark.isDisplayComplete，此 prop 被忽略 */
+    isDisplayComplete?: boolean;
     /** 自定义组件映射，key 为节点类型 */
     components?: ComponentMap;
     /** 自定义容器组件映射，key 为容器名称（如 'warning', 'info'） */
     customContainers?: Record<string, Component<any>>;
     /** 自定义代码块组件映射，key 为代码语言名称（如 'echart', 'mermaid'） */
     customCodeBlocks?: Record<string, Component<any>>;
+    /** 代码块配置映射，key 为代码语言名称 */
+    codeBlockConfigs?: Record<string, {
+        takeOver?: boolean;
+    }>;
     /** 待处理块的样式类名 */
     pendingClass?: string;
     /** 已完成块的样式类名 */

package/dist/components/Incremark.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Incremark.svelte.d.ts","sourceRoot":"","sources":["../../src/components/Incremark.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAK5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAgB5D;;GAEG;AACH,UAAU,KAAK;IACb,wCAAwC;IACxC,MAAM,CAAC,EAAE,iBAAiB,EAAE,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAC5D,wBAAwB;IACxB,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,gBAAgB;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,sCAAsC;IACtC,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAC/B;AAgJH,QAAA,MAAM,SAAS,0BAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"Incremark.svelte.d.ts","sourceRoot":"","sources":["../../src/components/Incremark.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAK5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAM5D;;GAEG;AACH,UAAU,KAAK;IACb,wCAAwC;IACxC,MAAM,CAAC,EAAE,iBAAiB,EAAE,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAC5D;uEACmE;IACnE,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,wBAAwB;IACxB,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,0BAA0B;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACzD,gBAAgB;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,sCAAsC;IACtC,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAC/B;AA2FH,QAAA,MAAM,SAAS,0BAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/components/IncremarkBlockquote.svelte

@@ -1,11 +1,11 @@
 <!--
   @file IncremarkBlockquote.svelte - 引用组件
-  @description 渲染 Markdown 引用块
+  @description 渲染 Markdown 引用块，支持所有块级内容
 -->
 
 <script lang="ts">
   import type { Blockquote } from 'mdast'
-  import IncremarkParagraph from './IncremarkParagraph.svelte'
+  import IncremarkRenderer from './IncremarkRenderer.svelte'
 
   /**
    * 组件 Props
@@ -20,11 +20,7 @@
 
 <blockquote class="incremark-blockquote">
   {#each node.children as child, index (index)}
-    {#if child.type === 'paragraph'}
-      <IncremarkParagraph node={child} />
-    {:else}
-      <div class="unknown-child">{child.type}</div>
-    {/if}
+    <IncremarkRenderer node={child} />
   {/each}
 </blockquote>
 

package/dist/components/IncremarkBlockquote.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IncremarkBlockquote.svelte.d.ts","sourceRoot":"","sources":["../../src/components/IncremarkBlockquote.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAIrC;;GAEG;AACH,UAAU,KAAK;IACb,WAAW;IACX,IAAI,EAAE,UAAU,CAAA;CACjB;AAwBH,QAAA,MAAM,mBAAmB,2CAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"IncremarkBlockquote.svelte.d.ts","sourceRoot":"","sources":["../../src/components/IncremarkBlockquote.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAIrC;;GAEG;AACH,UAAU,KAAK;IACb,WAAW;IACX,IAAI,EAAE,UAAU,CAAA;CACjB;AAoBH,QAAA,MAAM,mBAAmB,2CAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/components/IncremarkCode.svelte

@@ -15,12 +15,16 @@
     node: Code
     /** Shiki 主题，默认 github-dark */
     theme?: string
+    /** 默认回退主题（当指定主题加载失败时使用），默认 github-dark */
+    fallbackTheme?: string
     /** 是否禁用代码高亮 */
     disableHighlight?: boolean
     /** Mermaid 渲染延迟（毫秒），用于流式输入时防抖 */
     mermaidDelay?: number
     /** 自定义代码块组件映射，key 为代码语言名称 */
     customCodeBlocks?: Record<string, any>
+    /** 代码块配置映射，key 为代码语言名称 */
+    codeBlockConfigs?: Record<string, { takeOver?: boolean }>
     /** 块状态，用于判断是否使用自定义组件 */
     blockStatus?: 'pending' | 'stable' | 'completed'
   }
@@ -28,9 +32,11 @@
   let {
     node,
     theme = 'github-dark',
+    fallbackTheme = 'github-dark',
     disableHighlight = false,
     mermaidDelay = 500,
     customCodeBlocks,
+    codeBlockConfigs,
     blockStatus = 'completed'
   }: Props = $props()
 
@@ -63,15 +69,24 @@
 
   // 检查是否有自定义代码块组件
   const CustomCodeBlock = $derived.by(() => {
-    // 如果代码块还在 pending 状态，不使用自定义组件
-    if (blockStatus === 'pending') {
+    const component = customCodeBlocks?.[language]
+    if (!component) return null
+
+    // 检查该语言的配置
+    const config = codeBlockConfigs?.[language]
+
+    // 如果配置了 takeOver 为 true，则从一开始就使用
+    if (config?.takeOver) {
+      return component
+    }
+
+    // 否则，默认行为：只在 completed 状态使用
+    if (blockStatus !== 'completed') {
       return null
     }
-    return customCodeBlocks?.[language] || null
-  })
 
-  // 是否使用自定义组件
-  const useCustomComponent = $derived(!!CustomCodeBlock)
+    return component
+  })
 
   /**
    * 切换 Mermaid 视图模式
@@ -188,7 +203,7 @@
 
       const html = highlighter.codeToHtml(code, {
         lang: loadedLanguages.has(lang) ? lang : 'text',
-        theme: loadedThemes.has(theme) ? theme : 'github-dark'
+        theme: loadedThemes.has(theme) ? theme : fallbackTheme
       })
       highlightedHtml = html
     } catch (e) {
@@ -229,13 +244,9 @@
 </script>
 
 <!-- 自定义代码块组件 -->
-{#if useCustomComponent && CustomCodeBlock}
-  <svelte:component 
-    this={CustomCodeBlock} 
-    codeStr={code} 
-    lang={language}
-  />
-<!-- Mermaid 图表 -->
+{#if CustomCodeBlock}
+  {@const Component = CustomCodeBlock}
+  <Component codeStr={code} lang={language} completed={blockStatus === 'completed'} takeOver={codeBlockConfigs?.[language]?.takeOver} />
 {:else if isMermaid}
   <div class="incremark-mermaid">
     <div class="mermaid-header">

package/dist/components/IncremarkCode.svelte.d.ts

@@ -7,12 +7,18 @@ interface Props {
     node: Code;
     /** Shiki 主题，默认 github-dark */
     theme?: string;
+    /** 默认回退主题（当指定主题加载失败时使用），默认 github-dark */
+    fallbackTheme?: string;
     /** 是否禁用代码高亮 */
     disableHighlight?: boolean;
     /** Mermaid 渲染延迟（毫秒），用于流式输入时防抖 */
     mermaidDelay?: number;
     /** 自定义代码块组件映射，key 为代码语言名称 */
     customCodeBlocks?: Record<string, any>;
+    /** 代码块配置映射，key 为代码语言名称 */
+    codeBlockConfigs?: Record<string, {
+        takeOver?: boolean;
+    }>;
     /** 块状态，用于判断是否使用自定义组件 */
     blockStatus?: 'pending' | 'stable' | 'completed';
 }

package/dist/components/IncremarkCode.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IncremarkCode.svelte.d.ts","sourceRoot":"","sources":["../../src/components/IncremarkCode.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAI/B;;GAEG;AACH,UAAU,KAAK;IACb,WAAW;IACX,IAAI,EAAE,IAAI,CAAA;IACV,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtC,wBAAwB;IACxB,WAAW,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAA;CACjD;AAmRH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"IncremarkCode.svelte.d.ts","sourceRoot":"","sources":["../../src/components/IncremarkCode.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAI/B;;GAEG;AACH,UAAU,KAAK;IACb,WAAW;IACX,IAAI,EAAE,IAAI,CAAA;IACV,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtC,0BAA0B;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACzD,wBAAwB;IACxB,WAAW,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAA;CACjD;AA8RH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/components/IncremarkList.svelte

@@ -1,12 +1,12 @@
 <!--
   @file IncremarkList.svelte - 列表组件
-  @description 渲染 Markdown 列表（有序列表和无序列表），支持任务列表和嵌套列表
+  @description 渲染 Markdown 列表（有序列表和无序列表），支持任务列表和所有块级内容
 -->
 
 <script lang="ts">
-  import type { List, ListItem, PhrasingContent, BlockContent } from 'mdast'
+  import type { List, ListItem, RootContent } from 'mdast'
   import IncremarkInline from './IncremarkInline.svelte'
-  import IncremarkList from './IncremarkList.svelte';
+  import IncremarkRenderer from './IncremarkRenderer.svelte'
 
   /**
    * 组件 Props
@@ -36,10 +36,10 @@
    * @param item - 列表项节点
    * @returns 行内内容数组
    */
-  function getItemInlineContent(item: ListItem): PhrasingContent[] {
+  function getItemInlineContent(item: ListItem) {
     const firstChild = item.children[0]
     if (firstChild?.type === 'paragraph') {
-      return firstChild.children as PhrasingContent[]
+      return firstChild.children
     }
     return []
   }
@@ -51,14 +51,14 @@
    * @param item - 列表项节点
    * @returns 块级子节点数组
    */
-  function getItemBlockChildren(item: ListItem): BlockContent[] {
+  function getItemBlockChildren(item: ListItem): RootContent[] {
     return item.children.filter((child, index) => {
       // 第一个 paragraph 已经被处理为内联内容
       if (index === 0 && child.type === 'paragraph') {
         return false
       }
       return true
-    }) as BlockContent[]
+    })
   }
 
   /**
@@ -96,12 +96,9 @@
         </label>
       {:else}
         <IncremarkInline nodes={getItemInlineContent(item)} />
-        <!-- 递归渲染嵌套列表和其他块级内容 -->
+        <!-- 递归渲染所有块级内容（嵌套列表、heading、blockquote、code、table 等） -->
         {#each getItemBlockChildren(item) as child, childIndex (childIndex)}
-          {#if child.type === 'list'}
-            <IncremarkList node={child} />
-          {/if}
-          <!-- 其他块级内容可以在这里扩展 -->
+          <IncremarkRenderer node={child} />
         {/each}
       {/if}
     </li>

package/dist/components/IncremarkList.svelte.d.ts

@@ -1,5 +1,4 @@
 import type { List } from 'mdast';
-import IncremarkList from './IncremarkList.svelte';
 /**
  * 组件 Props
  */

package/dist/components/IncremarkList.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IncremarkList.svelte.d.ts","sourceRoot":"","sources":["../../src/components/IncremarkList.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAA2C,MAAM,OAAO,CAAA;AAE1E,OAAO,aAAa,MAAM,wBAAwB,CAAC;AAGjD;;GAEG;AACH,UAAU,KAAK;IACb,WAAW;IACX,IAAI,EAAE,IAAI,CAAA;CACX;AA4FH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"IncremarkList.svelte.d.ts","sourceRoot":"","sources":["../../src/components/IncremarkList.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAyB,MAAM,OAAO,CAAA;AAKtD;;GAEG;AACH,UAAU,KAAK;IACb,WAAW;IACX,IAAI,EAAE,IAAI,CAAA;CACX;AAyFH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/components/IncremarkRenderer.svelte

@@ -7,7 +7,6 @@
   import type { RootContent, HTML } from 'mdast'
   import IncremarkHeading from './IncremarkHeading.svelte'
   import IncremarkParagraph from './IncremarkParagraph.svelte'
-  import IncremarkCode from './IncremarkCode.svelte'
   import IncremarkList from './IncremarkList.svelte'
   import IncremarkTable from './IncremarkTable.svelte'
   import IncremarkBlockquote from './IncremarkBlockquote.svelte'
@@ -15,6 +14,7 @@
   import IncremarkMath from './IncremarkMath.svelte'
   import IncremarkHtmlElement from './IncremarkHtmlElement.svelte'
   import IncremarkDefault from './IncremarkDefault.svelte'
+  import IncremarkCode from './IncremarkCode.svelte'
   import IncremarkContainer, { type ContainerNode } from './IncremarkContainer.svelte'
 
   /**
@@ -25,23 +25,24 @@
     node: RootContent | ContainerNode
     customContainers?: Record<string, any>
     customCodeBlocks?: Record<string, any>
+    codeBlockConfigs?: Record<string, { takeOver?: boolean }>
     blockStatus?: 'pending' | 'stable' | 'completed'
   }
 
-  let { 
-    node, 
+  let {
+    node,
     customContainers,
     customCodeBlocks,
+    codeBlockConfigs,
     blockStatus
   }: Props = $props()
 
   /**
-   * 组件映射
+   * 默认组件映射
    */
-  const componentMap: Record<string, any> = {
+  const defaultComponentMap: Record<string, any> = {
     heading: IncremarkHeading,
     paragraph: IncremarkParagraph,
-    code: IncremarkCode,
     list: IncremarkList,
     table: IncremarkTable,
     blockquote: IncremarkBlockquote,
@@ -49,13 +50,16 @@
     math: IncremarkMath,
     inlineMath: IncremarkMath,
     htmlElement: IncremarkHtmlElement,
+    containerDirective: IncremarkContainer,
+    leafDirective: IncremarkContainer,
+    textDirective: IncremarkContainer,
   }
 
   /**
    * 获取组件
    */
   function getComponent(type: string): any {
-    return componentMap[type] || IncremarkDefault
+    return defaultComponentMap[type] || IncremarkDefault
   }
 
   /**
@@ -84,16 +88,14 @@
     node={node} 
     customContainers={customContainers}
   />
-<!-- 代码节点：特殊处理，传递 customCodeBlocks 和 blockStatus -->
+<!-- 代码节点：特殊处理，传递 customCodeBlocks、codeBlockConfigs 和 blockStatus -->
 {:else if node.type === 'code'}
-  {@const Component = getComponent('code')}
-  {#if Component}
-    <Component 
-      node={node} 
-      customCodeBlocks={customCodeBlocks}
-      blockStatus={blockStatus}
-    />
-  {/if}
+  <IncremarkCode
+    node={node}
+    customCodeBlocks={customCodeBlocks}
+    codeBlockConfigs={codeBlockConfigs}
+    blockStatus={blockStatus}
+  />
 {:else}
   <!-- 其他节点：使用对应组件 -->
   {@const Component = getComponent(node.type)}

package/dist/components/IncremarkRenderer.svelte.d.ts

@@ -8,6 +8,9 @@ interface Props {
     node: RootContent | ContainerNode;
     customContainers?: Record<string, any>;
     customCodeBlocks?: Record<string, any>;
+    codeBlockConfigs?: Record<string, {
+        takeOver?: boolean;
+    }>;
     blockStatus?: 'pending' | 'stable' | 'completed';
 }
 declare const IncremarkRenderer: import("svelte").Component<Props, {}, "">;

package/dist/components/IncremarkRenderer.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IncremarkRenderer.svelte.d.ts","sourceRoot":"","sources":["../../src/components/IncremarkRenderer.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAQ,MAAM,OAAO,CAAA;AAW9C,OAA2B,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGnF;;GAEG;AACH,UAAU,KAAK;IACb,aAAa;IACb,IAAI,EAAE,WAAW,GAAG,aAAa,CAAA;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtC,WAAW,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAA;CACjD;AAwFH,QAAA,MAAM,iBAAiB,2CAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"IncremarkRenderer.svelte.d.ts","sourceRoot":"","sources":["../../src/components/IncremarkRenderer.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAQ,MAAM,OAAO,CAAA;AAW9C,OAA2B,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGnF;;GAEG;AACH,UAAU,KAAK;IACb,aAAa;IACb,IAAI,EAAE,WAAW,GAAG,aAAa,CAAA;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACzD,WAAW,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAA;CACjD;AAwFH,QAAA,MAAM,iBAAiB,2CAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/stores/useIncremark.d.ts

@@ -68,11 +68,19 @@ export interface UseIncremarkReturn {
     /** 用于渲染的 blocks（根据打字机设置自动处理） */
     blocks: Readable<Array<ParsedBlock & {
         stableId: string;
+        isLastPending?: boolean;
     }>>;
     /** 是否正在加载 */
     isLoading: Writable<boolean>;
     /** 是否已完成（finalize） */
     isFinalized: Writable<boolean>;
+    /**
+     * 内容是否完全显示完成
+     * - 无打字机：等于 isFinalized
+     * - 有打字机：isFinalized + 动画播放完成
+     * 适用于控制 footnote 等需要在内容完全显示后才出现的元素
+     */
+    isDisplayComplete: Readable<boolean>;
     /** 脚注引用的出现顺序 */
     footnoteReferenceOrder: Writable<string[]>;
     /** 追加内容 */

package/dist/stores/useIncremark.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIncremark.d.ts","sourceRoot":"","sources":["../../src/stores/useIncremark.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useIncremark.d.ts","sourceRoot":"","sources":["../../src/stores/useIncremark.ts"],"names":[],"mappings":"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"}

package/dist/stores/useIncremark.js

@@ -60,12 +60,46 @@ export function useIncremark(options = {}) {
     const markdown = writable('');
     const isFinalized = writable(false);
     const footnoteReferenceOrder = writable([]);
+    /**
+     * 处理解析器更新结果（统一 append 和 finalize 的更新逻辑）
+     */
+    function handleUpdate(update, isFinalize) {
+        markdown.set(parser.getBuffer());
+        if (update.completed.length > 0) {
+            completedBlocks.update((blocks) => [
+                ...blocks,
+                ...update.completed
+            ]);
+        }
+        pendingBlocks.set(update.pending);
+        if (isFinalize) {
+            isLoading.set(false);
+            isFinalized.set(true);
+        }
+        else {
+            isLoading.set(true);
+        }
+        // 更新脚注引用顺序
+        footnoteReferenceOrder.set(update.footnoteReferenceOrder);
+        setFootnoteReferenceOrder(update.footnoteReferenceOrder);
+    }
     // 使用 useTypewriter store 管理打字机效果
-    const { blocks, typewriter, transformer } = useTypewriter({
+    const { blocks, typewriter, transformer, isAnimationComplete } = useTypewriter({
         typewriter: options.typewriter,
         completedBlocks,
         pendingBlocks
     });
+    // 内容是否完全显示完成
+    // 如果没有配置打字机或未启用打字机：解析完成即显示完成
+    // 如果启用打字机：解析完成 + 动画完成
+    const isDisplayComplete = derived([isFinalized, isAnimationComplete, typewriter.enabled], ([$isFinalized, $isAnimationComplete, $typewriterEnabled]) => {
+        // 没有配置打字机，或者打字机未启用：只需判断是否 finalized
+        if (!options.typewriter || !$typewriterEnabled) {
+            return $isFinalized;
+        }
+        // 启用了打字机：需要 finalize + 动画完成
+        return $isFinalized && $isAnimationComplete;
+    });
     // AST
     const ast = derived([completedBlocks, pendingBlocks], ([$completedBlocks, $pendingBlocks]) => ({
         type: 'root',
@@ -81,19 +115,8 @@ export function useIncremark(options = {}) {
      * @returns 增量更新结果
      */
     function append(chunk) {
-        isLoading.set(true);
         const update = parser.append(chunk);
-        markdown.set(parser.getBuffer());
-        if (update.completed.length > 0) {
-            completedBlocks.update((blocks) => [
-                ...blocks,
-                ...update.completed
-            ]);
-        }
-        pendingBlocks.set(update.pending);
-        // 更新脚注引用顺序
-        footnoteReferenceOrder.set(update.footnoteReferenceOrder);
-        setFootnoteReferenceOrder(update.footnoteReferenceOrder);
+        handleUpdate(update, false);
         return update;
     }
     /**
@@ -103,19 +126,7 @@ export function useIncremark(options = {}) {
      */
     function finalize() {
         const update = parser.finalize();
-        markdown.set(parser.getBuffer());
-        if (update.completed.length > 0) {
-            completedBlocks.update((blocks) => [
-                ...blocks,
-                ...update.completed
-            ]);
-        }
-        pendingBlocks.set([]);
-        isLoading.set(false);
-        isFinalized.set(true);
-        // 更新脚注引用顺序
-        footnoteReferenceOrder.set(update.footnoteReferenceOrder);
-        setFootnoteReferenceOrder(update.footnoteReferenceOrder);
+        handleUpdate(update, true);
         return update;
     }
     /**
@@ -165,6 +176,7 @@ export function useIncremark(options = {}) {
         blocks,
         isLoading,
         isFinalized,
+        isDisplayComplete,
         footnoteReferenceOrder,
         append,
         finalize,

package/dist/stores/useTypewriter.d.ts

@@ -23,11 +23,14 @@ export interface UseTypewriterReturn {
     /** 用于渲染的 blocks（经过打字机处理或原始blocks） */
     blocks: Readable<Array<ParsedBlock & {
         stableId: string;
+        isLastPending?: boolean;
     }>>;
     /** 打字机控制对象 */
     typewriter: TypewriterControls;
     /** transformer 实例 */
     transformer: BlockTransformer<RootContent> | null;
+    /** 所有动画是否已完成（队列为空且没有正在处理的 block） */
+    isAnimationComplete: Readable<boolean>;
 }
 /**
  * useTypewriter Store

package/dist/stores/useTypewriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTypewriter.d.ts","sourceRoot":"","sources":["../../src/stores/useTypewriter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,WAAW,EAGhB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAG3E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY;IACZ,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B,oBAAoB;IACpB,eAAe,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;IACxC,oBAAoB;IACpB,aAAa,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAC3D,cAAc;IACd,UAAU,EAAE,kBAAkB,CAAA;IAC9B,qBAAqB;IACrB,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;CAClD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAkKhF"}
+{"version":3,"file":"useTypewriter.d.ts","sourceRoot":"","sources":["../../src/stores/useTypewriter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,WAAW,EAGhB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAG3E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY;IACZ,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B,oBAAoB;IACpB,eAAe,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;IACxC,oBAAoB;IACpB,aAAa,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAA;IACpF,cAAc;IACd,UAAU,EAAE,kBAAkB,CAAA;IAC9B,qBAAqB;IACrB,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;IACjD,oCAAoC;IACpC,mBAAmB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CA8KhF"}

package/dist/stores/useTypewriter.js

@@ -23,6 +23,7 @@ export function useTypewriter(options) {
     const isTypewriterPaused = writable(false);
     const typewriterEffect = writable(typewriterConfig?.effect ?? 'none');
     const typewriterCursor = writable(typewriterConfig?.cursor ?? '|');
+    const isAnimationComplete = writable(true); // 初始为 true（没有动画时视为完成）
     // 创建 transformer（如果有 typewriter 配置）
     let transformer = null;
     if (typewriterConfig) {
@@ -37,6 +38,14 @@ export function useTypewriter(options) {
                 displayBlocks.set(blocks);
                 isTypewriterProcessing.set(transformer?.isProcessing() ?? false);
                 isTypewriterPaused.set(transformer?.isPausedState() ?? false);
+                // 有 blocks 正在处理时，动画未完成
+                if (transformer?.isProcessing()) {
+                    isAnimationComplete.set(false);
+                }
+            },
+            onAllComplete: () => {
+                // 所有动画完成
+                isAnimationComplete.set(true);
             }
         });
     }
@@ -73,9 +82,11 @@ export function useTypewriter(options) {
             result.push({ ...block, stableId: block.id });
         }
         for (let i = 0; i < $pendingBlocks.length; i++) {
+            const isLastPending = i === $pendingBlocks.length - 1;
             result.push({
                 ...$pendingBlocks[i],
-                stableId: `pending-${i}`
+                stableId: `pending-${i}`,
+                isLastPending
             });
         }
         return result;
@@ -148,6 +159,7 @@ export function useTypewriter(options) {
     return {
         blocks,
         typewriter: typewriterControls,
-        transformer
+        transformer,
+        isAnimationComplete: derived(isAnimationComplete, ($v) => $v)
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incremark/svelte",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Incremark Svelte 5 集成",
   "type": "module",
   "svelte": "./dist/index.js",
@@ -24,10 +24,10 @@
   ],
   "dependencies": {
     "shiki": "^3.20.0",
-    "@incremark/core": "0.2.4",
-    "@incremark/devtools": "0.2.4",
-    "@incremark/shared": "0.2.4",
-    "@incremark/theme": "0.2.4"
+    "@incremark/devtools": "0.2.6",
+    "@incremark/core": "0.2.6",
+    "@incremark/theme": "0.2.6",
+    "@incremark/shared": "0.2.6"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",