@incremark/svelte 0.3.1 → 0.3.2

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

@@ -1 +0,0 @@
-{"version":3,"file":"useBlockTransformer.d.ts","sourceRoot":"","sources":["../../src/stores/useBlockTransformer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EACL,gBAAgB,EAEhB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAA;AAExB;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC;CAAG;AAE3F;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC,GAAG,OAAO;IACpD,2BAA2B;IAC3B,aAAa,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC1C,cAAc;IACd,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC/B,YAAY;IACZ,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC3B,aAAa;IACb,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;IACjC,aAAa;IACb,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,WAAW;IACX,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,WAAW;IACX,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,WAAW;IACX,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,aAAa;IACb,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,cAAc,GAAG,QAAQ,GAAG,eAAe,CAAC,CAAC,KAAK,IAAI,CAAA;IAC9H,6BAA6B;IAC7B,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC7C,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EACxC,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CAAC,CAAC,CAAC,CAwD9B"}

package/dist/stores/useBlockTransformer.js

@@ -1,110 +0,0 @@
-/**
- * @file useBlockTransformer Store - 块转换器
- * @description 用于控制 blocks 的逐步显示（打字机效果）
- */
-import { writable, derived } from 'svelte/store';
-import { createBlockTransformer } from '@incremark/core';
-/**
- * Svelte 5 Store: Block Transformer
- *
- * @description
- * 用于控制 blocks 的逐步显示（打字机效果）
- * 作为解析器和渲染器之间的中间层
- *
- * 特性：
- * - 使用 requestAnimationFrame 实现流畅动画
- * - 支持随机步长 `charsPerTick: [1, 3]`
- * - 支持动画效果 `effect: 'typing'`
- * - 页面不可见时自动暂停
- *
- * @param sourceBlocks - 源 blocks store
- * @param options - 转换器选项
- * @returns 转换器状态和控制对象
- *
- * @example
- * ```svelte
- * <script>
- *   import { useIncremark, useBlockTransformer, defaultPlugins } from '@incremark/svelte'
- *   import { derived } from 'svelte/store'
- *
- *   const { completedBlocks, append, finalize } = useIncremark()
- *
- *   // 使用 completedBlocks 作为输入（ID 稳定）
- *   const sourceBlocks = derived(completedBlocks, ($blocks) =>
- *     $blocks.map(b => ({
- *       id: b.id,
- *       node: b.node,
- *       status: b.status
- *     }))
- *   )
- *
- *   // 添加打字机效果
- *   const { displayBlocks, isProcessing, skip, effect } = useBlockTransformer(sourceBlocks, {
- *     charsPerTick: [1, 3],
- *     tickInterval: 30,
- *     effect: 'typing',
- *     plugins: defaultPlugins
- *   })
- * </script>
- *
- * <template>
- *   <Incremark blocks={$displayBlocks} class:typing={$effect === 'typing'} />
- *   {#if $isProcessing}
- *     <button on:click={skip}>跳过</button>
- *   {/if}
- * </template>
- * ```
- */
-export function useBlockTransformer(sourceBlocks, options = {}) {
-    const displayBlocks = writable([]);
-    const isProcessing = writable(false);
-    const isPaused = writable(false);
-    const effect = writable(options.effect ?? 'none');
-    const transformer = createBlockTransformer({
-        ...options,
-        onChange: (blocks) => {
-            displayBlocks.set(blocks);
-            isProcessing.set(transformer.isProcessing());
-            isPaused.set(transformer.isPausedState());
-        }
-    });
-    // 监听源 blocks 变化
-    sourceBlocks.subscribe((blocks) => {
-        // 推入新 blocks
-        transformer.push(blocks);
-        // 处理正在显示的 block 内容更新
-        displayBlocks.update((displayBlocksValue) => {
-            const currentDisplaying = displayBlocksValue.find((b) => !b.isDisplayComplete);
-            if (currentDisplaying) {
-                const updated = blocks.find((b) => b.id === currentDisplaying.id);
-                if (updated) {
-                    transformer.update(updated);
-                }
-            }
-            return displayBlocksValue;
-        });
-    });
-    return {
-        displayBlocks: derived(displayBlocks, ($blocks) => $blocks),
-        isProcessing: derived(isProcessing, ($processing) => $processing),
-        isPaused: derived(isPaused, ($paused) => $paused),
-        effect: derived(effect, ($effect) => $effect),
-        skip: () => transformer.skip(),
-        reset: () => transformer.reset(),
-        pause: () => {
-            transformer.pause();
-            isPaused.set(true);
-        },
-        resume: () => {
-            transformer.resume();
-            isPaused.set(false);
-        },
-        setOptions: (opts) => {
-            transformer.setOptions(opts);
-            if (opts.effect !== undefined) {
-                effect.set(opts.effect);
-            }
-        },
-        transformer
-    };
-}

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

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

package/dist/stores/useIncremark.js

@@ -1,208 +0,0 @@
-/**
- * @file useIncremark Store - 核心 Store
- * @description Svelte 5 Store: Incremark 流式 Markdown 解析器
- */
-import { writable, derived } from 'svelte/store';
-import { createIncremarkParser } from '@incremark/core';
-import { setDefinitionsContext } from '../context/definitionsContext';
-import { useTypewriter } from './useTypewriter';
-/**
- * Svelte 5 Store: Incremark 流式 Markdown 解析器
- *
- * @description
- * 核心 store，管理解析器状态和操作
- *
- * @param options - 解析器选项
- * @returns 解析器状态和控制对象
- *
- * @example
- * ```svelte
- * <script>
- *   import { useIncremark, Incremark } from '@incremark/svelte'
- *
- *   // 基础用法
- *   const { blocks, append, finalize } = useIncremark()
- *
- *   // 启用打字机效果
- *   const { blocks, append, finalize, typewriter } = useIncremark({
- *     typewriter: {
- *       enabled: true,
- *       charsPerTick: [1, 3],
- *       tickInterval: 30,
- *       effect: 'typing',
- *       cursor: '|'
- *     }
- *   })
- * </script>
- *
- * <template>
- *   <Incremark blocks={$blocks} />
- * </template>
- * ```
- */
-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);
-        }
-    });
-    // 状态 stores
-    const completedBlocks = writable([]);
-    const pendingBlocks = writable([]);
-    const isLoading = writable(false);
-    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, 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',
-        children: [
-            ...$completedBlocks.map((b) => b.node),
-            ...$pendingBlocks.map((b) => b.node)
-        ]
-    }));
-    /**
-     * 追加内容
-     *
-     * @param chunk - 要追加的 Markdown 文本块
-     * @returns 增量更新结果
-     */
-    function append(chunk) {
-        const update = parser.append(chunk);
-        handleUpdate(update, false);
-        return update;
-    }
-    /**
-     * 完成解析
-     *
-     * @returns 增量更新结果
-     */
-    function finalize() {
-        const update = parser.finalize();
-        handleUpdate(update, true);
-        return update;
-    }
-    /**
-     * 强制中断
-     *
-     * @returns 增量更新结果
-     */
-    function abort() {
-        return finalize();
-    }
-    /**
-     * 重置解析器和打字机
-     */
-    function reset() {
-        parser.reset();
-        completedBlocks.set([]);
-        pendingBlocks.set([]);
-        markdown.set('');
-        isLoading.set(false);
-        isFinalized.set(false);
-        footnoteReferenceOrder.set([]);
-        // 重置 transformer
-        transformer?.reset();
-    }
-    /**
-     * 一次性渲染（reset + append + finalize）
-     *
-     * @param content - 完整的 Markdown 内容
-     * @returns 增量更新结果
-     */
-    function render(content) {
-        const update = parser.render(content);
-        markdown.set(parser.getBuffer());
-        completedBlocks.set(parser.getCompletedBlocks());
-        pendingBlocks.set([]);
-        isLoading.set(false);
-        isFinalized.set(true);
-        footnoteReferenceOrder.set(update.footnoteReferenceOrder);
-        setFootnoteReferenceOrder(update.footnoteReferenceOrder);
-        return update;
-    }
-    /**
-     * 更新解析器配置（动态更新，不需要重建 parser 实例）
-     *
-     * 注意：更新配置后会自动重置状态
-     *
-     * @param newOptions - 部分配置选项（包括 astBuilder，可以动态切换引擎）
-     */
-    function updateOptions(newOptions) {
-        parser.updateOptions(newOptions);
-        // 同步 Svelte 状态
-        completedBlocks.set([]);
-        pendingBlocks.set([]);
-        markdown.set('');
-        isLoading.set(false);
-        isFinalized.set(false);
-        footnoteReferenceOrder.set([]);
-        transformer?.reset();
-    }
-    return {
-        markdown,
-        completedBlocks,
-        pendingBlocks,
-        ast,
-        blocks,
-        isLoading,
-        isFinalized,
-        isDisplayComplete,
-        footnoteReferenceOrder,
-        append,
-        finalize,
-        abort,
-        reset,
-        render,
-        updateOptions,
-        parser,
-        typewriter
-    };
-}

package/dist/stores/useTypewriter.d.ts

@@ -1,44 +0,0 @@
-/**
- * @file useTypewriter Store - 打字机效果管理
- * @description 管理打字机效果的状态和控制逻辑，从 useIncremark 中拆分出来以简化代码
- */
-import { type Writable, type Readable } from 'svelte/store';
-import { type RootContent, type ParsedBlock, type BlockTransformer } from '@incremark/core';
-import type { TypewriterOptions, TypewriterControls } from './useIncremark';
-/**
- * useTypewriter 选项
- */
-export interface UseTypewriterOptions {
-    /** 打字机配置 */
-    typewriter?: TypewriterOptions;
-    /** 已完成的块列表 store */
-    completedBlocks: Writable<ParsedBlock[]>;
-    /** 待处理的块列表 store */
-    pendingBlocks: Writable<ParsedBlock[]>;
-}
-/**
- * useTypewriter 返回值
- */
-export interface UseTypewriterReturn {
-    /** 用于渲染的 blocks（经过打字机处理或原始blocks） */
-    blocks: Readable<Array<ParsedBlock & {
-        isLastPending?: boolean;
-    }>>;
-    /** 打字机控制对象 */
-    typewriter: TypewriterControls;
-    /** transformer 实例 */
-    transformer: BlockTransformer<RootContent> | null;
-    /** 所有动画是否已完成（队列为空且没有正在处理的 block） */
-    isAnimationComplete: Readable<boolean>;
-}
-/**
- * useTypewriter Store
- *
- * @description
- * 管理打字机效果的所有状态和逻辑
- *
- * @param options - 打字机配置和数据
- * @returns 打字机状态和控制对象
- */
-export declare function useTypewriter(options: UseTypewriterOptions): UseTypewriterReturn;
-//# sourceMappingURL=useTypewriter.d.ts.map

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

@@ -1 +0,0 @@
-{"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,EAEtB,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,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAA;IAClE,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,CA4KhF"}

package/dist/stores/useTypewriter.js

@@ -1,163 +0,0 @@
-/**
- * @file useTypewriter Store - 打字机效果管理
- * @description 管理打字机效果的状态和控制逻辑，从 useIncremark 中拆分出来以简化代码
- */
-import { writable, derived } from 'svelte/store';
-import { createBlockTransformer, defaultPlugins } from '@incremark/core';
-import { addCursorToNode } from '../utils/cursor';
-/**
- * useTypewriter Store
- *
- * @description
- * 管理打字机效果的所有状态和逻辑
- *
- * @param options - 打字机配置和数据
- * @returns 打字机状态和控制对象
- */
-export function useTypewriter(options) {
-    const { typewriter: typewriterConfig, completedBlocks, pendingBlocks } = options;
-    // 打字机状态 stores
-    const typewriterEnabled = writable(typewriterConfig?.enabled ?? !!typewriterConfig);
-    const displayBlocks = writable([]);
-    const isTypewriterProcessing = writable(false);
-    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) {
-        const twOptions = typewriterConfig;
-        transformer = createBlockTransformer({
-            charsPerTick: twOptions.charsPerTick ?? [1, 3],
-            tickInterval: twOptions.tickInterval ?? 30,
-            effect: twOptions.effect ?? 'none',
-            pauseOnHidden: twOptions.pauseOnHidden ?? true,
-            plugins: twOptions.plugins ?? defaultPlugins,
-            onChange: (blocks) => {
-                displayBlocks.set(blocks);
-                isTypewriterProcessing.set(transformer?.isProcessing() ?? false);
-                isTypewriterPaused.set(transformer?.isPausedState() ?? false);
-                // 有 blocks 正在处理时，动画未完成
-                if (transformer?.isProcessing()) {
-                    isAnimationComplete.set(false);
-                }
-            },
-            onAllComplete: () => {
-                // 所有动画完成
-                isAnimationComplete.set(true);
-            }
-        });
-    }
-    // 将 completedBlocks 转换为 SourceBlock 格式
-    const sourceBlocks = derived(completedBlocks, ($completedBlocks) => {
-        return $completedBlocks.map(block => ({
-            id: block.id,
-            node: block.node,
-            status: block.status
-        }));
-    });
-    // 监听 sourceBlocks 变化，推送给 transformer
-    if (transformer) {
-        let unsubscribe = null;
-        unsubscribe = sourceBlocks.subscribe((blocks) => {
-            transformer.push(blocks);
-            // 更新正在显示的 block
-            displayBlocks.update((displayBlocksValue) => {
-                const currentDisplaying = displayBlocksValue.find((b) => !b.isDisplayComplete);
-                if (currentDisplaying) {
-                    const updated = blocks.find((b) => b.id === currentDisplaying.id);
-                    if (updated) {
-                        transformer.update(updated);
-                    }
-                }
-                return displayBlocksValue;
-            });
-        });
-    }
-    // 原始 blocks（不经过打字机）
-    const rawBlocks = derived([completedBlocks, pendingBlocks], ([$completedBlocks, $pendingBlocks]) => {
-        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
-    const blocks = derived([typewriterEnabled, displayBlocks, rawBlocks, typewriterEffect, typewriterCursor], ([$enabled, $displayBlocks, $rawBlocks, $effect, $cursor]) => {
-        // 未启用打字机或没有 transformer：返回原始 blocks
-        if (!$enabled || !transformer) {
-            return $rawBlocks;
-        }
-        // 启用打字机：使用 displayBlocks
-        return $displayBlocks.map((db, index) => {
-            const isPending = !db.isDisplayComplete;
-            const isLastPending = isPending && index === $displayBlocks.length - 1;
-            // typing 效果时添加光标
-            let node = db.displayNode;
-            if ($effect === 'typing' && isLastPending) {
-                node = addCursorToNode(db.displayNode, $cursor);
-            }
-            return {
-                id: db.id,
-                status: (db.isDisplayComplete ? 'completed' : 'pending'),
-                isLastPending,
-                node,
-                startOffset: 0,
-                endOffset: 0,
-                rawText: ''
-            };
-        });
-    });
-    // 打字机控制对象
-    const typewriterControls = {
-        enabled: derived(typewriterEnabled, ($enabled) => $enabled),
-        setEnabled: (value) => {
-            typewriterEnabled.set(value);
-        },
-        isProcessing: derived(isTypewriterProcessing, ($processing) => $processing),
-        isPaused: derived(isTypewriterPaused, ($paused) => $paused),
-        effect: derived(typewriterEffect, ($effect) => $effect),
-        skip: () => transformer?.skip(),
-        pause: () => {
-            transformer?.pause();
-            isTypewriterPaused.set(true);
-        },
-        resume: () => {
-            transformer?.resume();
-            isTypewriterPaused.set(false);
-        },
-        setOptions: (opts) => {
-            if (opts.enabled !== undefined) {
-                typewriterEnabled.set(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.set(opts.effect);
-            }
-            if (opts.cursor !== undefined) {
-                typewriterCursor.set(opts.cursor);
-            }
-        }
-    };
-    return {
-        blocks,
-        typewriter: typewriterControls,
-        transformer,
-        isAnimationComplete: derived(isAnimationComplete, ($v) => $v)
-    };
-}