@incremark/svelte 0.3.0 → 0.3.2

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

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

package/dist/stores/useIncremark.svelte.js

@@ -0,0 +1,226 @@
+/**
+ * @file useIncremark - 核心 Composable
+ * @description Svelte 5 Composable: Incremark 流式 Markdown 解析器（使用 runes 语法）
+ */
+import { createIncremarkParser } from '@incremark/core';
+import { setDefinitionsContext } from '../context/definitionsContext.svelte.ts';
+import { useTypewriter } from './useTypewriter.svelte.ts';
+/**
+ * Svelte 5 Composable: Incremark 流式 Markdown 解析器
+ *
+ * @description
+ * 核心 composable，管理解析器状态和操作，使用 Svelte 5 runes 语法
+ *
+ * @param options - 解析器选项
+ * @returns 解析器状态和控制对象
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { useIncremark, Incremark } from '@incremark/svelte'
+ *
+ *   // 基础用法
+ *   const incremark = useIncremark()
+ *
+ *   // 启用打字机效果
+ *   const incremark = useIncremark({
+ *     typewriter: {
+ *       enabled: true,
+ *       charsPerTick: [1, 3],
+ *       tickInterval: 30,
+ *       effect: 'typing',
+ *       cursor: '|'
+ *     }
+ *   })
+ * </script>
+ *
+ * <Incremark blocks={incremark.blocks} />
+ * ```
+ */
+export function useIncremark(options = {}) {
+    // 内部自动提供 definitions context
+    const { setDefinations, setFootnoteDefinitions, setFootnoteReferenceOrder } = setDefinitionsContext();
+    // 解析器
+    const parser = createIncremarkParser({
+        ...options,
+        onChange: (state) => {
+            setDefinations(state.definitions);
+            setFootnoteDefinitions(state.footnoteDefinitions);
+            // 调用用户提供的 onChange
+            options.onChange?.(state);
+        }
+    });
+    // 状态（使用 $state runes）
+    let completedBlocksState = $state([]);
+    let pendingBlocksState = $state([]);
+    let isLoadingState = $state(false);
+    let markdownState = $state('');
+    let isFinalizedState = $state(false);
+    let footnoteReferenceOrderState = $state([]);
+    let astState = $state({
+        type: 'root',
+        children: []
+    });
+    /**
+     * 处理解析器更新结果（统一 append 和 finalize 的更新逻辑）
+     */
+    function handleUpdate(update, isFinalize) {
+        markdownState = parser.getBuffer();
+        // 处理被更新的 blocks（需要移除的旧 blocks）
+        if (update.updated.length > 0) {
+            const idsToRemove = new Set(update.updated.map((b) => b.id));
+            completedBlocksState = completedBlocksState.filter((b) => !idsToRemove.has(b.id));
+        }
+        if (update.completed.length > 0) {
+            completedBlocksState = [...completedBlocksState, ...update.completed];
+        }
+        pendingBlocksState = update.pending;
+        if (isFinalize) {
+            // 如果还有 pending blocks，则将它们添加到 completed blocks 中
+            if (update.pending.length > 0) {
+                completedBlocksState = [...completedBlocksState, ...update.pending];
+                pendingBlocksState = [];
+            }
+            isLoadingState = false;
+            isFinalizedState = true;
+        }
+        else {
+            isLoadingState = true;
+        }
+        // 更新脚注引用顺序（解析器的完整顺序）
+        footnoteReferenceOrderState = update.footnoteReferenceOrder;
+    }
+    // 使用 useTypewriter composable 管理打字机效果
+    const typewriterResult = useTypewriter({
+        typewriter: options.typewriter,
+        getCompletedBlocks: () => completedBlocksState,
+        getPendingBlocks: () => pendingBlocksState
+    });
+    const { getBlocks: getTypewriterBlocks, typewriter, transformer } = typewriterResult;
+    // 派生状态：用于渲染的 blocks
+    const blocksGetter = $derived.by(() => {
+        // 如果没有启用打字机，直接返回原始 blocks
+        if (!options.typewriter || !typewriter.enabled) {
+            return [
+                ...completedBlocksState,
+                ...pendingBlocksState.map((b, i) => ({
+                    ...b,
+                    isLastPending: i === pendingBlocksState.length - 1
+                }))
+            ];
+        }
+        // 否则返回打字机处理的 blocks
+        return getTypewriterBlocks();
+    });
+    // 派生状态：内容是否完全显示完成
+    const isDisplayCompleteGetter = $derived.by(() => {
+        // 没有配置打字机，或者打字机未启用：只需判断是否 finalized
+        if (!options.typewriter || !typewriter.enabled) {
+            return isFinalizedState;
+        }
+        // 启用了打字机：需要 finalize + 动画完成
+        return isFinalizedState && typewriterResult.isAnimationComplete;
+    });
+    // 派生状态：脚注引用顺序
+    // 与 Vue 版本对齐：确保脚注只在引用所在的 block 动画完成后才显示
+    const displayedFootnoteOrder = $derived.by(() => {
+        // 没有配置打字机，或者打字机未启用：使用解析器的顺序
+        if (!options.typewriter || !typewriter.enabled) {
+            return footnoteReferenceOrderState;
+        }
+        // 启用了打字机：从打字机获取脚注顺序（通过 getter 访问派生状态）
+        // 注意：动画进行中时会返回空数组，这是正确的行为（隐藏脚注）
+        return typewriterResult.displayedFootnoteReferenceOrder;
+    });
+    // 监听脚注顺序变化，更新 context
+    $effect(() => {
+        setFootnoteReferenceOrder(displayedFootnoteOrder);
+    });
+    /**
+     * 追加内容
+     */
+    function append(chunk) {
+        const update = parser.append(chunk);
+        astState = update.ast;
+        handleUpdate(update, false);
+        return update;
+    }
+    /**
+     * 完成解析
+     */
+    function finalize() {
+        const update = parser.finalize();
+        handleUpdate(update, true);
+        return update;
+    }
+    /**
+     * 强制中断
+     */
+    function abort() {
+        return finalize();
+    }
+    /**
+     * 重置解析器和打字机
+     */
+    function reset() {
+        parser.reset();
+        completedBlocksState = [];
+        pendingBlocksState = [];
+        markdownState = '';
+        isLoadingState = false;
+        isFinalizedState = false;
+        footnoteReferenceOrderState = [];
+        astState = { type: 'root', children: [] };
+        // 重置 transformer
+        transformer?.reset();
+    }
+    /**
+     * 一次性渲染（reset + append + finalize）
+     */
+    function render(content) {
+        const update = parser.render(content);
+        markdownState = parser.getBuffer();
+        completedBlocksState = parser.getCompletedBlocks();
+        pendingBlocksState = [];
+        isLoadingState = false;
+        isFinalizedState = true;
+        // render 是一次性渲染，不经过打字机，直接设置脚注顺序
+        footnoteReferenceOrderState = update.footnoteReferenceOrder;
+        setFootnoteReferenceOrder(update.footnoteReferenceOrder);
+        return update;
+    }
+    /**
+     * 更新解析器配置（动态更新，不需要重建 parser 实例）
+     */
+    function updateOptions(newOptions) {
+        parser.updateOptions(newOptions);
+        // 同步状态
+        completedBlocksState = [];
+        pendingBlocksState = [];
+        markdownState = '';
+        isLoadingState = false;
+        isFinalizedState = false;
+        footnoteReferenceOrderState = [];
+        astState = { type: 'root', children: [] };
+        transformer?.reset();
+    }
+    return {
+        get markdown() { return markdownState; },
+        get completedBlocks() { return completedBlocksState; },
+        get pendingBlocks() { return pendingBlocksState; },
+        get ast() { return astState; },
+        get blocks() { return blocksGetter; },
+        get isLoading() { return isLoadingState; },
+        get isFinalized() { return isFinalizedState; },
+        get isDisplayComplete() { return isDisplayCompleteGetter; },
+        get footnoteReferenceOrder() { return footnoteReferenceOrderState; },
+        append,
+        finalize,
+        abort,
+        reset,
+        render,
+        updateOptions,
+        parser,
+        typewriter
+    };
+}

package/dist/stores/useLocale.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLocale.svelte.d.ts","sourceRoot":"","sources":["../../src/stores/useLocale.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAKxD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,SAAS,EAAE,MAAM,eAAe,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,eAAe,QAG7D;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAiB3C"}
+{"version":3,"file":"useLocale.svelte.d.ts","sourceRoot":"","sources":["../../src/stores/useLocale.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAKxD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,SAAS,EAAE,MAAM,eAAe,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,eAAe,QAG7D;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAkB3C"}

package/dist/stores/useLocale.svelte.js

@@ -1,5 +1,5 @@
 import { setContext, getContext } from 'svelte';
-import { en } from '../index';
+import { zhCN } from '@incremark/shared';
 const LOCALE_KEY = Symbol('incremark-locale');
 /**
  * 提供 locale context
@@ -18,7 +18,8 @@ export function provideLocale(getLocale) {
 export function useLocale() {
     const context = getContext(LOCALE_KEY);
     // 获取当前 locale（支持响应式更新）
-    const getLocale = context?.getLocale ?? (() => en);
+    // 使用 getContext 的默认值，如果没有 provider 则使用中文
+    const getLocale = context?.getLocale ?? (() => zhCN);
     const t = (key) => {
         const locale = getLocale();
         const keys = key.split('.');

package/dist/stores/useShiki.svelte.d.ts

@@ -1,9 +1,35 @@
+import type { HighlighterGeneric, BundledLanguage, BundledTheme } from 'shiki';
+interface HighlighterInfo {
+    highlighter: HighlighterGeneric<BundledLanguage, BundledTheme>;
+    loadedLanguages: Set<BundledLanguage>;
+    loadedThemes: Set<BundledTheme>;
+}
+export type { HighlighterInfo };
+declare class ShikiManager {
+    private static instance;
+    private highlighters;
+    private constructor();
+    static getInstance(): ShikiManager;
+    getHighlighter(theme: BundledTheme): Promise<HighlighterInfo>;
+    loadLanguage(theme: BundledTheme, lang: BundledLanguage): Promise<void>;
+    loadTheme(theme: BundledTheme): Promise<void>;
+    codeToHtml(theme: BundledTheme, code: string, lang: BundledLanguage, fallbackTheme: BundledTheme): Promise<string>;
+}
+/**
+ * 获取 ShikiManager 单例（延迟初始化）
+ * 避免模块加载时立即创建实例，支持 SSR
+ */
+declare function getShikiManager(): ShikiManager;
+export { getShikiManager, ShikiManager };
 /**
  * 使用 Shiki Highlighter
  * @param themeGetter 传入一个返回主题字符串的函数，例如 () => theme
  */
 export declare function useShiki(themeGetter: () => string): {
     readonly isHighlighting: boolean;
+    readonly isReady: boolean;
+    readonly highlighterInfo: HighlighterInfo | null;
+    initHighlighter: () => Promise<void>;
     highlight: (code: string, lang: string, fallbackTheme: string) => Promise<string>;
 };
 //# sourceMappingURL=useShiki.svelte.d.ts.map

package/dist/stores/useShiki.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useShiki.svelte.d.ts","sourceRoot":"","sources":["../../src/stores/useShiki.svelte.ts"],"names":[],"mappings":"AA+FA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM;;sBAOjB,MAAM,QAAQ,MAAM,iBAAiB,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;EAgC7F"}
+{"version":3,"file":"useShiki.svelte.d.ts","sourceRoot":"","sources":["../../src/stores/useShiki.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAG9E,UAAU,eAAe;IACvB,WAAW,EAAE,kBAAkB,CAAC,eAAe,EAAE,YAAY,CAAC,CAAA;IAC9D,eAAe,EAAE,GAAG,CAAC,eAAe,CAAC,CAAA;IACrC,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,CAAA;CAChC;AAED,YAAY,EAAE,eAAe,EAAE,CAAA;AAG/B,cAAM,YAAY;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IACnD,OAAO,CAAC,YAAY,CAAqC;IAEzD,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,YAAY;IAO5B,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAqB7D,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C,UAAU,CACd,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,eAAe,EACrB,aAAa,EAAE,YAAY,GAC1B,OAAO,CAAC,MAAM,CAAC;CASnB;AAMD;;;GAGG;AACH,iBAAS,eAAe,IAAI,YAAY,CAKvC;AAED,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,CAAA;AAIxC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM;;;;2BASd,OAAO,CAAC,IAAI,CAAC;sBAiBhB,MAAM,QAAQ,MAAM,iBAAiB,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;EAwC7F"}

package/dist/stores/useShiki.svelte.js

@@ -69,6 +69,7 @@ function getShikiManager() {
     }
     return shikiManagerInstance;
 }
+export { getShikiManager, ShikiManager };
 // ============ Svelte 5 Composable ============
 /**
  * 使用 Shiki Highlighter
@@ -77,6 +78,25 @@ function getShikiManager() {
 export function useShiki(themeGetter) {
     // 使用 Svelte 5 的原生响应式状态
     let isHighlighting = $state(false);
+    let isReady = $state(false);
+    let highlighterInfo = $state(null);
+    /**
+     * 初始化 highlighter（预加载）
+     */
+    async function initHighlighter() {
+        if (isReady)
+            return;
+        try {
+            const currentTheme = themeGetter();
+            const info = await getShikiManager().getHighlighter(currentTheme);
+            highlighterInfo = info;
+            isReady = true;
+        }
+        catch (e) {
+            console.warn('Failed to initialize Shiki highlighter:', e);
+            throw e;
+        }
+    }
     /**
      * 高亮代码
      */
@@ -88,6 +108,10 @@ export function useShiki(themeGetter) {
         try {
             const manager = getShikiManager();
             const info = await manager.getHighlighter(currentTheme);
+            if (!highlighterInfo) {
+                highlighterInfo = info;
+                isReady = true;
+            }
             // 按需加载语言
             if (!info.loadedLanguages.has(lang) && lang !== 'text') {
                 await manager.loadLanguage(currentTheme, lang);
@@ -105,6 +129,9 @@ export function useShiki(themeGetter) {
     return {
         // 使用 getter 暴露只读状态，保持 UI 响应
         get isHighlighting() { return isHighlighting; },
+        get isReady() { return isReady; },
+        get highlighterInfo() { return highlighterInfo; },
+        initHighlighter,
         highlight
     };
 }

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

@@ -0,0 +1,49 @@
+/**
+ * @file useTypewriter Composable - 打字机效果管理
+ * @description 管理打字机效果的状态和控制逻辑，使用 Svelte 5 runes
+ */
+import { type RootContent, type ParsedBlock, type BlockTransformer } from '@incremark/core';
+import type { TypewriterOptions, TypewriterControls } from './useIncremark.svelte.ts';
+/**
+ * useTypewriter 选项
+ */
+export interface UseTypewriterOptions {
+    /** 打字机配置 */
+    typewriter?: TypewriterOptions;
+    /** 获取已完成的块列表（使用 getter 函数实现响应式） */
+    getCompletedBlocks: () => ParsedBlock[];
+    /** 获取待处理的块列表（使用 getter 函数实现响应式） */
+    getPendingBlocks: () => ParsedBlock[];
+}
+/**
+ * useTypewriter 返回值
+ */
+export interface UseTypewriterReturn {
+    /** 获取用于渲染的 blocks（经过打字机处理或原始blocks） */
+    getBlocks: () => Array<ParsedBlock & {
+        isLastPending?: boolean;
+    }>;
+    /** 打字机控制对象 */
+    typewriter: TypewriterControls;
+    /** transformer 实例 */
+    transformer: BlockTransformer<RootContent> | null;
+    /** 所有动画是否已完成（getter） */
+    readonly isAnimationComplete: boolean;
+    /**
+     * 脚注引用顺序（所有动画完成后才返回）（getter）
+     * 用于控制脚注的显示时机：只有当所有 blocks 的打字机动画都完成后才显示脚注
+     * 动画进行中时返回空数组
+     */
+    readonly displayedFootnoteReferenceOrder: string[];
+}
+/**
+ * useTypewriter Composable
+ *
+ * @description
+ * 管理打字机效果的所有状态和逻辑，使用 Svelte 5 runes
+ *
+ * @param options - 打字机配置和数据
+ * @returns 打字机状态和控制对象
+ */
+export declare function useTypewriter(options: UseTypewriterOptions): UseTypewriterReturn;
+//# sourceMappingURL=useTypewriter.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTypewriter.svelte.d.ts","sourceRoot":"","sources":["../../src/stores/useTypewriter.svelte.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,WAAW,EAGhB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAGrF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY;IACZ,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B,mCAAmC;IACnC,kBAAkB,EAAE,MAAM,WAAW,EAAE,CAAA;IACvC,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,WAAW,EAAE,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,SAAS,EAAE,MAAM,KAAK,CAAC,WAAW,GAAG;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACjE,cAAc;IACd,UAAU,EAAE,kBAAkB,CAAA;IAC9B,qBAAqB;IACrB,WAAW,EAAE,gBAAgB,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;IACjD,wBAAwB;IACxB,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;IACrC;;;;OAIG;IACH,QAAQ,CAAC,+BAA+B,EAAE,MAAM,EAAE,CAAA;CACnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAwNhF"}

package/dist/stores/useTypewriter.svelte.js

@@ -0,0 +1,212 @@
+/**
+ * @file useTypewriter Composable - 打字机效果管理
+ * @description 管理打字机效果的状态和控制逻辑，使用 Svelte 5 runes
+ */
+import { createBlockTransformer, defaultPlugins, mathPlugin, collectFootnoteReferences } from '@incremark/core';
+import { addCursorToNode } from '../utils/cursor';
+/**
+ * useTypewriter Composable
+ *
+ * @description
+ * 管理打字机效果的所有状态和逻辑，使用 Svelte 5 runes
+ *
+ * @param options - 打字机配置和数据
+ * @returns 打字机状态和控制对象
+ */
+export function useTypewriter(options) {
+    const { typewriter: typewriterConfig, getCompletedBlocks, getPendingBlocks } = options;
+    // 打字机状态（使用 $state runes）
+    let typewriterEnabled = $state(typewriterConfig?.enabled ?? !!typewriterConfig);
+    let displayBlocks = $state([]);
+    let isTypewriterProcessing = $state(false);
+    let isTypewriterPaused = $state(false);
+    let typewriterEffect = $state(typewriterConfig?.effect ?? 'none');
+    let typewriterCursor = $state(typewriterConfig?.cursor ?? '|');
+    let isAnimationComplete = $state(true); // 初始为 true（没有动画时视为完成）
+    // 创建 transformer（如果有 typewriter 配置）
+    // 在初始化时立即创建，而不是延迟创建
+    let transformer = null;
+    if (typewriterConfig) {
+        transformer = createBlockTransformer({
+            charsPerTick: typewriterConfig.charsPerTick ?? [1, 3],
+            tickInterval: typewriterConfig.tickInterval ?? 30,
+            effect: typewriterConfig.effect ?? 'none',
+            pauseOnHidden: typewriterConfig.pauseOnHidden ?? true,
+            // 默认插件 + 数学公式插件（数学公式应该整体显示，不参与打字机逐字符效果）
+            plugins: typewriterConfig.plugins ?? [...defaultPlugins, mathPlugin],
+            onChange: (blocks) => {
+                displayBlocks = blocks;
+                isTypewriterProcessing = transformer?.isProcessing() ?? false;
+                isTypewriterPaused = transformer?.isPausedState() ?? false;
+            },
+            onAllComplete: () => {
+                // 所有动画完成
+                isAnimationComplete = true;
+            }
+        });
+    }
+    // 监听配置变化（同步 Vue 的 watch 逻辑）
+    $effect(() => {
+        const config = typewriterConfig;
+        if (!config || !transformer)
+            return;
+        // 更新本地状态
+        if (config.enabled !== undefined) {
+            typewriterEnabled = config.enabled;
+        }
+        if (config.effect !== undefined) {
+            typewriterEffect = config.effect;
+        }
+        if (config.cursor !== undefined) {
+            typewriterCursor = config.cursor;
+        }
+        // 更新 transformer 配置
+        transformer.setOptions({
+            charsPerTick: config.charsPerTick,
+            tickInterval: config.tickInterval,
+            effect: config.effect,
+            pauseOnHidden: config.pauseOnHidden
+        });
+    });
+    // 监听 blocks 变化，推送给 transformer
+    // transformer.push() 会自动检测并更新已存在 blocks 的内容变化
+    $effect(() => {
+        // 只有在 transformer 存在时才推送 blocks
+        if (!transformer)
+            return;
+        // 通过 getter 函数获取最新的 blocks（这样可以跟踪响应式变化）
+        const completedBlocks = getCompletedBlocks();
+        const pendingBlocks = getPendingBlocks();
+        // 直接传递原始 block 引用
+        // ParsedBlock 的结构（id, node, status）已经兼容 SourceBlock
+        const allBlocks = [...completedBlocks, ...pendingBlocks];
+        transformer.push(allBlocks);
+    });
+    // 获取原始 blocks（不经过打字机）
+    function getRawBlocks() {
+        const completedBlocks = getCompletedBlocks();
+        const pendingBlocks = getPendingBlocks();
+        const result = [];
+        for (const block of completedBlocks) {
+            result.push(block);
+        }
+        for (let i = 0; i < pendingBlocks.length; i++) {
+            const isLastPending = i === pendingBlocks.length - 1;
+            result.push({
+                ...pendingBlocks[i],
+                isLastPending
+            });
+        }
+        return result;
+    }
+    // 获取最终用于渲染的 blocks
+    function getBlocks() {
+        // 未启用打字机或没有 transformer：返回原始 blocks
+        if (!typewriterEnabled || !transformer) {
+            return getRawBlocks();
+        }
+        // 启用打字机：使用 displayBlocks state
+        return displayBlocks.map((db, index) => {
+            const isPending = !db.isDisplayComplete;
+            const isLastPending = isPending && index === displayBlocks.length - 1;
+            // typing 效果时添加光标
+            let node = db.displayNode;
+            if (typewriterEffect === 'typing' && isLastPending) {
+                node = addCursorToNode(db.displayNode, typewriterCursor);
+            }
+            return {
+                id: db.id,
+                status: db.status,
+                isLastPending,
+                node,
+                startOffset: 0,
+                endOffset: 0,
+                rawText: ''
+            };
+        });
+    }
+    /**
+     * 派生状态：脚注引用顺序（所有动画完成后才返回）
+     * 用于控制脚注的显示时机：只有当所有 blocks 的打字机动画都完成后才显示脚注
+     */
+    const displayedFootnoteReferenceOrder = $derived.by(() => {
+        // 未启用打字机：返回所有脚注引用（从原始 blocks 中提取）
+        if (!typewriterEnabled || !transformer) {
+            const references = [];
+            const seen = new Set();
+            for (const block of getRawBlocks()) {
+                const blockRefs = collectFootnoteReferences(block.node);
+                for (const ref of blockRefs) {
+                    if (!seen.has(ref)) {
+                        seen.add(ref);
+                        references.push(ref);
+                    }
+                }
+            }
+            return references;
+        }
+        // 启用打字机：只有所有动画完成后才返回脚注引用
+        // 如果还有动画在进行中，返回空数组
+        if (!isAnimationComplete) {
+            return [];
+        }
+        // 所有动画完成，返回全部脚注引用
+        const references = [];
+        const seen = new Set();
+        for (const db of displayBlocks) {
+            const blockRefs = collectFootnoteReferences(db.displayNode);
+            for (const ref of blockRefs) {
+                if (!seen.has(ref)) {
+                    seen.add(ref);
+                    references.push(ref);
+                }
+            }
+        }
+        return references;
+    });
+    // 打字机控制对象
+    const typewriterControls = {
+        get enabled() { return typewriterEnabled; },
+        setEnabled: (value) => {
+            typewriterEnabled = value;
+        },
+        get isProcessing() { return isTypewriterProcessing; },
+        get isPaused() { return isTypewriterPaused; },
+        get effect() { return typewriterEffect; },
+        skip: () => transformer?.skip(),
+        pause: () => {
+            transformer?.pause();
+            isTypewriterPaused = true;
+        },
+        resume: () => {
+            transformer?.resume();
+            isTypewriterPaused = false;
+        },
+        setOptions: (opts) => {
+            if (opts.enabled !== undefined) {
+                typewriterEnabled = opts.enabled;
+            }
+            if (opts.charsPerTick !== undefined || opts.tickInterval !== undefined || opts.effect !== undefined || opts.pauseOnHidden !== undefined) {
+                transformer?.setOptions({
+                    charsPerTick: opts.charsPerTick,
+                    tickInterval: opts.tickInterval,
+                    effect: opts.effect,
+                    pauseOnHidden: opts.pauseOnHidden
+                });
+            }
+            if (opts.effect !== undefined) {
+                typewriterEffect = opts.effect;
+            }
+            if (opts.cursor !== undefined) {
+                typewriterCursor = opts.cursor;
+            }
+        }
+    };
+    return {
+        getBlocks,
+        typewriter: typewriterControls,
+        transformer,
+        get isAnimationComplete() { return isAnimationComplete; },
+        get displayedFootnoteReferenceOrder() { return displayedFootnoteReferenceOrder; }
+    };
+}

package/dist/utils/cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/utils/cursor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CA0B9E"}
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/utils/cursor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAoC9E"}

package/dist/utils/cursor.js

@@ -10,8 +10,16 @@
  * @returns 添加了光标的新节点
  */
 export function addCursorToNode(node, cursor) {
+    // 代码块不应该添加光标（会破坏代码高亮）
+    if (node.type === 'code') {
+        return node;
+    }
     const cloned = JSON.parse(JSON.stringify(node));
     function addToLast(n) {
+        // 跳过代码块
+        if (n.type === 'code') {
+            return false;
+        }
         if (n.children && n.children.length > 0) {
             for (let i = n.children.length - 1; i >= 0; i--) {
                 if (addToLast(n.children[i])) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incremark/svelte",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "High-performance streaming markdown renderer for Svelte 5 ecosystem.",
   "type": "module",
   "svelte": "./dist/index.js",
@@ -23,12 +23,14 @@
     "dist"
   ],
   "dependencies": {
+    "@antfu/utils": "^9.3.0",
     "shiki": "^3.20.0",
-    "@incremark/core": "0.3.0",
-    "@incremark/devtools": "0.3.0",
-    "@incremark/icons": "0.3.0",
-    "@incremark/shared": "0.3.0",
-    "@incremark/theme": "0.3.0"
+    "shiki-stream": "^0.1.4",
+    "@incremark/core": "0.3.2",
+    "@incremark/icons": "0.3.2",
+    "@incremark/shared": "0.3.2",
+    "@incremark/theme": "0.3.2",
+    "@incremark/devtools": "0.3.2"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",
@@ -44,6 +46,7 @@
     }
   },
   "devDependencies": {
+    "@shikijs/core": "^3.21.0",
     "@types/mdast": "^4.0.0",
     "@sveltejs/package": "^2.4.0",
     "@sveltejs/vite-plugin-svelte": "^4.0.0",