@incremark/vue 0.2.2 → 0.2.4

package/dist/ThemeProvider.vue.d.ts

@@ -0,0 +1,25 @@
+import type { DesignTokens } from '@incremark/theme';
+/**
+ * 主题配置，可以是：
+ * - 字符串：'default' | 'dark'
+ * - 完整主题对象：DesignTokens
+ * - 部分主题对象：Partial<DesignTokens>（会合并到默认主题）
+ */
+type __VLS_Props = {
+    theme: 'default' | 'dark' | DesignTokens | Partial<DesignTokens>;
+    class?: string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    class: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/AutoScrollContainer.vue.d.ts

@@ -0,0 +1,31 @@
+type __VLS_Props = {
+    /** 是否启用自动滚动 */
+    enabled?: boolean;
+    /** 触发自动滚动的底部阈值（像素） */
+    threshold?: number;
+    /** 滚动行为 */
+    behavior?: ScrollBehavior;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    /** 强制滚动到底部 */
+    scrollToBottom: () => void;
+    /** 是否用户手动向上滚动了 */
+    isUserScrolledUp: () => boolean;
+    /** 容器元素引用 */
+    container: import("vue").Ref<HTMLDivElement | null, HTMLDivElement | null>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    enabled: boolean;
+    threshold: number;
+    behavior: ScrollBehavior;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,36 @@
+import { type Component } from 'vue';
+import type { ParsedBlock } from '@incremark/core';
+import type { UseIncremarkReturn } from '../composables/useIncremark';
+export type ComponentMap = Partial<Record<string, Component>>;
+export interface BlockWithStableId extends ParsedBlock {
+    stableId: string;
+    isLastPending?: boolean;
+}
+type __VLS_Props = {
+    /** 要渲染的块列表（来自 useIncremark 的 blocks） */
+    blocks?: BlockWithStableId[];
+    /** 自定义组件映射，key 为节点类型 */
+    components?: ComponentMap;
+    /** 自定义容器组件映射，key 为容器名称（如 'warning', 'info'） */
+    customContainers?: Record<string, Component>;
+    /** 自定义代码块组件映射，key 为代码语言名称（如 'echart', 'mermaid'） */
+    customCodeBlocks?: Record<string, Component>;
+    /** 待处理块的样式类名 */
+    pendingClass?: string;
+    /** 已完成块的样式类名 */
+    completedClass?: string;
+    /** 是否显示块状态边框 */
+    showBlockStatus?: boolean;
+    /** 可选：useIncremark 返回的对象（用于自动注入数据） */
+    incremark?: UseIncremarkReturn;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    blocks: BlockWithStableId[];
+    customCodeBlocks: Record<string, Component>;
+    customContainers: Record<string, Component>;
+    components: Partial<Record<string, Component>>;
+    pendingClass: string;
+    completedClass: string;
+    showBlockStatus: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkBlockquote.vue.d.ts

@@ -0,0 +1,6 @@
+import type { Blockquote } from 'mdast';
+type __VLS_Props = {
+    node: Blockquote;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,23 @@
+import type { Code } from 'mdast';
+import type { Component } from 'vue';
+type __VLS_Props = {
+    node: Code;
+    /** Shiki 主题，默认 github-dark */
+    theme?: string;
+    /** 是否禁用代码高亮 */
+    disableHighlight?: boolean;
+    /** Mermaid 渲染延迟（毫秒），用于流式输入时防抖 */
+    mermaidDelay?: number;
+    /** 自定义代码块组件映射，key 为代码语言名称 */
+    customCodeBlocks?: Record<string, Component>;
+    /** 块状态，用于判断是否使用自定义组件 */
+    blockStatus?: 'pending' | 'stable' | 'completed';
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    theme: string;
+    disableHighlight: boolean;
+    mermaidDelay: number;
+    customCodeBlocks: Record<string, Component>;
+    blockStatus: "pending" | "stable" | "completed";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkContainer.vue.d.ts

@@ -0,0 +1,18 @@
+import type { RootContent } from 'mdast';
+import type { Component } from 'vue';
+/**
+ * 容器节点类型定义
+ * 根据 directive 解析后的结构
+ */
+export interface ContainerNode {
+    type: 'containerDirective' | 'leafDirective' | 'textDirective';
+    name: string;
+    attributes?: Record<string, string>;
+    children?: RootContent[];
+}
+type __VLS_Props = {
+    node: ContainerNode;
+    customContainers?: Record<string, Component>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkDefault.vue.d.ts

@@ -0,0 +1,6 @@
+import type { RootContent } from 'mdast';
+type __VLS_Props = {
+    node: RootContent;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkFootnotes.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/IncremarkHeading.vue.d.ts

@@ -0,0 +1,6 @@
+import type { Heading } from 'mdast';
+type __VLS_Props = {
+    node: Heading;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkHtmlElement.vue.d.ts

@@ -0,0 +1,20 @@
+import type { RootContent } from 'mdast';
+/**
+ * HtmlElementNode 类型定义（与 @incremark/core 中的定义一致）
+ */
+interface HtmlElementNode {
+    type: 'htmlElement';
+    tagName: string;
+    attrs: Record<string, string>;
+    children: RootContent[];
+    data?: {
+        rawHtml?: string;
+        parsed?: boolean;
+        originalType?: string;
+    };
+}
+type __VLS_Props = {
+    node: HtmlElementNode;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkInline.vue.d.ts

@@ -0,0 +1,6 @@
+import type { PhrasingContent } from 'mdast';
+type __VLS_Props = {
+    nodes: PhrasingContent[];
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,6 @@
+import type { List } from 'mdast';
+type __VLS_Props = {
+    node: List;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkMath.vue.d.ts

@@ -0,0 +1,17 @@
+interface MathNode {
+    type: 'math' | 'inlineMath';
+    value: string;
+    data?: {
+        hName?: string;
+        hProperties?: Record<string, any>;
+    };
+}
+type __VLS_Props = {
+    node: MathNode;
+    /** 渲染延迟（毫秒），用于流式输入时防抖 */
+    renderDelay?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    renderDelay: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkParagraph.vue.d.ts

@@ -0,0 +1,6 @@
+import type { Paragraph } from 'mdast';
+type __VLS_Props = {
+    node: Paragraph;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,12 @@
+import type { RootContent } from 'mdast';
+import type { Component } from 'vue';
+import type { ContainerNode } from './IncremarkContainer.vue';
+type ExtendedRootContent = RootContent | ContainerNode;
+type __VLS_Props = {
+    node: ExtendedRootContent;
+    customContainers?: Record<string, Component>;
+    customCodeBlocks?: Record<string, Component>;
+    blockStatus?: 'pending' | 'stable' | 'completed';
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkTable.vue.d.ts

@@ -0,0 +1,6 @@
+import type { Table } from 'mdast';
+type __VLS_Props = {
+    node: Table;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/IncremarkThematicBreak.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/{src/components/index.ts → dist/components/index.d.ts}

@@ -1,23 +1,16 @@
-// 主组件
-export { default as Incremark } from './Incremark.vue'
-export type { ComponentMap, BlockWithStableId } from './Incremark.vue'
-
-// 渲染器组件 - 用于自定义渲染
-export { default as IncremarkRenderer } from './IncremarkRenderer.vue'
-
-// 各节点类型组件 - 用于自定义或扩展
-export { default as IncremarkHeading } from './IncremarkHeading.vue'
-export { default as IncremarkParagraph } from './IncremarkParagraph.vue'
-export { default as IncremarkCode } from './IncremarkCode.vue'
-export { default as IncremarkList } from './IncremarkList.vue'
-export { default as IncremarkTable } from './IncremarkTable.vue'
-export { default as IncremarkBlockquote } from './IncremarkBlockquote.vue'
-export { default as IncremarkThematicBreak } from './IncremarkThematicBreak.vue'
-export { default as IncremarkInline } from './IncremarkInline.vue'
-export { default as IncremarkMath } from './IncremarkMath.vue'
-export { default as IncremarkHtmlElement } from './IncremarkHtmlElement.vue'
-export { default as IncremarkDefault } from './IncremarkDefault.vue'
-export { default as IncremarkFootnotes } from './IncremarkFootnotes.vue'
-
-// 工具组件
-export { default as AutoScrollContainer } from './AutoScrollContainer.vue'
+export { default as Incremark } from './Incremark.vue';
+export type { ComponentMap, BlockWithStableId } from './Incremark.vue';
+export { default as IncremarkRenderer } from './IncremarkRenderer.vue';
+export { default as IncremarkHeading } from './IncremarkHeading.vue';
+export { default as IncremarkParagraph } from './IncremarkParagraph.vue';
+export { default as IncremarkCode } from './IncremarkCode.vue';
+export { default as IncremarkList } from './IncremarkList.vue';
+export { default as IncremarkTable } from './IncremarkTable.vue';
+export { default as IncremarkBlockquote } from './IncremarkBlockquote.vue';
+export { default as IncremarkThematicBreak } from './IncremarkThematicBreak.vue';
+export { default as IncremarkInline } from './IncremarkInline.vue';
+export { default as IncremarkMath } from './IncremarkMath.vue';
+export { default as IncremarkHtmlElement } from './IncremarkHtmlElement.vue';
+export { default as IncremarkDefault } from './IncremarkDefault.vue';
+export { default as IncremarkFootnotes } from './IncremarkFootnotes.vue';
+export { default as AutoScrollContainer } from './AutoScrollContainer.vue';

package/dist/composables/index.d.ts

@@ -0,0 +1,8 @@
+export { useIncremark } from './useIncremark';
+export type { UseIncremarkOptions, TypewriterOptions, TypewriterControls } from './useIncremark';
+export { useStreamRenderer } from './useStreamRenderer';
+export type { UseStreamRendererOptions } from './useStreamRenderer';
+export { useDevTools } from './useDevTools';
+export type { UseDevToolsOptions } from './useDevTools';
+export { useBlockTransformer } from './useBlockTransformer';
+export type { UseBlockTransformerOptions, UseBlockTransformerReturn } from './useBlockTransformer';

package/dist/composables/useBlockTransformer.d.ts

@@ -0,0 +1,68 @@
+import { type Ref, type ComputedRef } from 'vue';
+import { BlockTransformer, type TransformerOptions, type DisplayBlock, type SourceBlock, type AnimationEffect } from '@incremark/core';
+export interface UseBlockTransformerOptions extends Omit<TransformerOptions, 'onChange'> {
+}
+export interface UseBlockTransformerReturn<T = unknown> {
+    /** 用于渲染的 display blocks */
+    displayBlocks: ComputedRef<DisplayBlock<T>[]>;
+    /** 是否正在处理中 */
+    isProcessing: ComputedRef<boolean>;
+    /** 是否已暂停 */
+    isPaused: ComputedRef<boolean>;
+    /** 当前动画效果 */
+    effect: ComputedRef<AnimationEffect>;
+    /** 跳过所有动画 */
+    skip: () => void;
+    /** 重置状态 */
+    reset: () => void;
+    /** 暂停动画 */
+    pause: () => void;
+    /** 恢复动画 */
+    resume: () => void;
+    /** 动态更新配置 */
+    setOptions: (options: Partial<Pick<TransformerOptions, 'charsPerTick' | 'tickInterval' | 'effect' | 'pauseOnHidden'>>) => void;
+    /** transformer 实例（用于高级用法） */
+    transformer: BlockTransformer<T>;
+}
+/**
+ * Vue 3 Composable: Block Transformer
+ *
+ * 用于控制 blocks 的逐步显示（打字机效果）
+ * 作为解析器和渲染器之间的中间层
+ *
+ * 特性：
+ * - 使用 requestAnimationFrame 实现流畅动画
+ * - 支持随机步长 `charsPerTick: [1, 3]`
+ * - 支持动画效果 `effect: 'typing'`
+ * - 页面不可见时自动暂停
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useIncremark, useBlockTransformer, defaultPlugins } from '@incremark/vue'
+ *
+ * const { blocks, completedBlocks, append, finalize } = useIncremark()
+ *
+ * // 使用 completedBlocks 作为输入（ID 稳定）
+ * const sourceBlocks = computed(() => completedBlocks.value.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' }" />
+ *   <button v-if="isProcessing" @click="skip">跳过</button>
+ * </template>
+ * ```
+ */
+export declare function useBlockTransformer<T = unknown>(sourceBlocks: Ref<SourceBlock<T>[]> | ComputedRef<SourceBlock<T>[]>, options?: UseBlockTransformerOptions): UseBlockTransformerReturn<T>;

package/dist/composables/useDefinationsContext.d.ts

@@ -0,0 +1,9 @@
+/**
+ * support definations and footnoteDefinitions
+ * @returns
+ */
+export declare function useDefinationsContext(): {
+    definations: import("vue").Ref<Record<string, import("mdast").Definition>>;
+    footnoteDefinitions: import("vue").Ref<Record<string, import("mdast").FootnoteDefinition>>;
+    footnoteReferenceOrder: import("vue").Ref<string[]>;
+};

package/dist/composables/useDevTools.d.ts

@@ -0,0 +1,18 @@
+import { type DevToolsOptions } from '@incremark/devtools';
+import type { UseIncremarkReturn } from './useIncremark';
+export interface UseDevToolsOptions extends DevToolsOptions {
+}
+/**
+ * Vue 3 DevTools 一行接入
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useIncremark, useDevTools } from '@incremark/vue'
+ *
+ * const incremark = useIncremark()
+ * useDevTools(incremark)  // 就这一行！
+ * </script>
+ * ```
+ */
+export declare function useDevTools(incremark: UseIncremarkReturn, options?: UseDevToolsOptions): import("@incremark/devtools").IncremarkDevTools;

package/dist/composables/useIncremark.d.ts

@@ -0,0 +1,112 @@
+import { type ComputedRef } from 'vue';
+import { type ParserOptions, type ParsedBlock, type IncrementalUpdate, type Root, type TransformerPlugin, type AnimationEffect } from '@incremark/core';
+/** 打字机效果配置 */
+export interface TypewriterOptions {
+    /** 是否启用打字机效果（可响应式切换） */
+    enabled?: boolean;
+    /** 每次显示的字符数，可以是固定值或范围 [min, max] */
+    charsPerTick?: number | [number, number];
+    /** 更新间隔 (ms) */
+    tickInterval?: number;
+    /** 动画效果: 'none' | 'fade-in' | 'typing' */
+    effect?: AnimationEffect;
+    /** 光标字符（仅 typing 效果使用） */
+    cursor?: string;
+    /** 页面不可见时暂停 */
+    pauseOnHidden?: boolean;
+    /** 自定义插件 */
+    plugins?: TransformerPlugin[];
+}
+export interface UseIncremarkOptions extends ParserOptions {
+    /** 打字机配置，传入即创建 transformer（可通过 enabled 控制是否启用） */
+    typewriter?: TypewriterOptions;
+}
+/** 打字机控制对象 */
+export interface TypewriterControls {
+    /** 是否启用（只读） */
+    enabled: ComputedRef<boolean>;
+    /** 设置是否启用 */
+    setEnabled: (enabled: boolean) => void;
+    /** 是否正在处理中 */
+    isProcessing: ComputedRef<boolean>;
+    /** 是否已暂停 */
+    isPaused: ComputedRef<boolean>;
+    /** 当前动画效果 */
+    effect: ComputedRef<AnimationEffect>;
+    /** 跳过动画，直接显示全部 */
+    skip: () => void;
+    /** 暂停动画 */
+    pause: () => void;
+    /** 恢复动画 */
+    resume: () => void;
+    /** 动态更新配置 */
+    setOptions: (options: Partial<TypewriterOptions>) => void;
+}
+/** useIncremark 的返回类型 */
+export type UseIncremarkReturn = ReturnType<typeof useIncremark>;
+/**
+ * Vue 3 Composable: Incremark 流式 Markdown 解析器
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * import { useIncremark, Incremark } from '@incremark/vue'
+ *
+ * // 基础用法
+ * const { blocks, append, finalize } = useIncremark()
+ *
+ * // 启用打字机效果
+ * const { blocks, append, finalize, typewriter } = useIncremark({
+ *   typewriter: {
+ *     enabled: true,       // 可响应式切换
+ *     charsPerTick: [1, 3],
+ *     tickInterval: 30,
+ *     effect: 'typing',
+ *     cursor: '|'
+ *   }
+ * })
+ *
+ * // 动态切换打字机效果
+ * typewriter.enabled.value = false
+ * </script>
+ *
+ * <template>
+ *   <Incremark :blocks="blocks" />
+ *   <button v-if="typewriter.isProcessing.value" @click="typewriter.skip">跳过</button>
+ * </template>
+ * ```
+ */
+export declare function useIncremark(options?: UseIncremarkOptions): {
+    /** 已收集的完整 Markdown 字符串 */
+    markdown: import("vue").Ref<string, string>;
+    /** 已完成的块列表 */
+    completedBlocks: import("vue").ShallowRef<ParsedBlock[], ParsedBlock[]>;
+    /** 待处理的块列表 */
+    pendingBlocks: import("vue").ShallowRef<ParsedBlock[], ParsedBlock[]>;
+    /** 当前完整的 AST */
+    ast: ComputedRef<Root>;
+    /** 用于渲染的 blocks（根据打字机设置自动处理） */
+    blocks: ComputedRef<(ParsedBlock & {
+        stableId: string;
+    })[]>;
+    /** 是否正在加载 */
+    isLoading: import("vue").Ref<boolean, boolean>;
+    /** 是否已完成（finalize） */
+    isFinalized: import("vue").Ref<boolean, boolean>;
+    /** 脚注引用的出现顺序 */
+    footnoteReferenceOrder: import("vue").Ref<string[], string[]>;
+    /** 追加内容 */
+    append: (chunk: string) => IncrementalUpdate;
+    /** 完成解析 */
+    finalize: () => IncrementalUpdate;
+    /** 强制中断 */
+    abort: () => IncrementalUpdate;
+    /** 重置解析器和打字机 */
+    reset: () => void;
+    /** 一次性渲染（reset + append + finalize） */
+    render: (content: string) => IncrementalUpdate;
+    /** 解析器实例 */
+    parser: import("@incremark/core").IncremarkParser;
+    /** 打字机控制 */
+    typewriter: TypewriterControls;
+};

package/dist/composables/useProvideDefinations.d.ts

@@ -0,0 +1,16 @@
+import { type InjectionKey, type Ref } from 'vue';
+import type { Definition, FootnoteDefinition } from 'mdast';
+export declare const definationsInjectionKey: InjectionKey<{
+    definations: Ref<Record<string, Definition>>;
+    footnoteDefinitions: Ref<Record<string, FootnoteDefinition>>;
+    footnoteReferenceOrder: Ref<string[]>;
+}>;
+export declare function useProvideDefinations(): {
+    setDefinations: (definitions: Record<string, Definition>) => void;
+    setFootnoteDefinitions: (definitions: Record<string, FootnoteDefinition>) => void;
+    setFootnoteReferenceOrder: (order: string[]) => void;
+    clearDefinations: () => void;
+    clearFootnoteDefinitions: () => void;
+    clearFootnoteReferenceOrder: () => void;
+    clearAllDefinations: () => void;
+};

package/dist/composables/useStreamRenderer.d.ts

@@ -0,0 +1,26 @@
+import { type Ref, type ComputedRef } from 'vue';
+import type { ParsedBlock } from '@incremark/core';
+export interface BlockWithStableId extends ParsedBlock {
+    /** 稳定的渲染 ID（用于 Vue key） */
+    stableId: string;
+}
+export interface UseStreamRendererOptions {
+    /** 已完成的块 */
+    completedBlocks: Ref<ParsedBlock[]>;
+    /** 待处理的块 */
+    pendingBlocks: Ref<ParsedBlock[]>;
+}
+export interface UseStreamRendererReturn {
+    /** 带稳定 ID 的已完成块 */
+    stableCompletedBlocks: ComputedRef<BlockWithStableId[]>;
+    /** 带稳定 ID 的待处理块 */
+    stablePendingBlocks: ComputedRef<BlockWithStableId[]>;
+    /** 所有带稳定 ID 的块 */
+    allStableBlocks: ComputedRef<BlockWithStableId[]>;
+}
+/**
+ * Vue 3 Composable: 流式渲染辅助
+ *
+ * 为块分配稳定的渲染 ID，确保 Vue 的虚拟 DOM 复用
+ */
+export declare function useStreamRenderer(options: UseStreamRendererOptions): UseStreamRendererReturn;

package/dist/composables/useTypewriter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @file useTypewriter Composable - 打字机效果管理
+ *
+ * @description
+ * 管理打字机效果的状态和控制逻辑，从 useIncremark 中拆分出来以简化代码。
+ *
+ * @author Incremark Team
+ * @license MIT
+ */
+import { type Ref, type ComputedRef } from 'vue';
+import { type RootContent, type ParsedBlock, type BlockTransformer } from '@incremark/core';
+import type { TypewriterOptions, TypewriterControls } from './useIncremark';
+export interface UseTypewriterOptions {
+    typewriter?: TypewriterOptions;
+    completedBlocks: Ref<ParsedBlock[]>;
+    pendingBlocks: Ref<ParsedBlock[]>;
+}
+export interface UseTypewriterReturn {
+    /** 用于渲染的 blocks（经过打字机处理或原始blocks） */
+    blocks: ComputedRef<Array<ParsedBlock & {
+        stableId: string;
+    }>>;
+    /** 打字机控制对象 */
+    typewriter: TypewriterControls;
+    /** transformer 实例 */
+    transformer: BlockTransformer<RootContent> | null;
+}
+/**
+ * useTypewriter Composable
+ *
+ * @description
+ * 管理打字机效果的所有状态和逻辑。
+ *
+ * @param options - 打字机配置和数据
+ * @returns 打字机状态和控制对象
+ */
+export declare function useTypewriter(options: UseTypewriterOptions): UseTypewriterReturn;

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { useIncremark, useStreamRenderer, useDevTools, useBlockTransformer } from './composables';
+export { useProvideDefinations } from './composables/useProvideDefinations';
+export { useDefinationsContext } from './composables/useDefinationsContext';
+export type { UseIncremarkOptions, TypewriterOptions, TypewriterControls, UseStreamRendererOptions, UseDevToolsOptions, UseBlockTransformerOptions, UseBlockTransformerReturn } from './composables';
+export { Incremark, IncremarkRenderer, IncremarkHeading, IncremarkParagraph, IncremarkCode, IncremarkList, IncremarkTable, IncremarkBlockquote, IncremarkThematicBreak, IncremarkInline, IncremarkMath, IncremarkHtmlElement, IncremarkDefault, IncremarkFootnotes, AutoScrollContainer } from './components';
+export type { ComponentMap, BlockWithStableId } from './components';
+export { default as ThemeProvider } from './ThemeProvider.vue';
+export type { ParsedBlock, IncrementalUpdate, ParserOptions, BlockStatus, Root, RootContent, SourceBlock, DisplayBlock, TransformerPlugin, TransformerOptions, TransformerState, AnimationEffect } from '@incremark/core';
+export { BlockTransformer, createBlockTransformer, countChars, sliceAst, cloneNode, codeBlockPlugin, mermaidPlugin, imagePlugin, mathPlugin, thematicBreakPlugin, defaultPlugins, allPlugins, createPlugin } from '@incremark/core';
+export { type DesignTokens, defaultTheme, darkTheme, generateCSSVars, mergeTheme, applyTheme } from '@incremark/theme';