@incremark/svelte 0.3.1 → 0.3.3

package/dist/components/IncremarkMath.svelte

@@ -30,7 +30,7 @@
 
   let {
     node,
-    renderDelay = 300
+    renderDelay = 0
   }: Props = $props()
 
   // 状态

package/dist/components/types.d.ts

@@ -4,7 +4,7 @@
  */
 import type { Component } from 'svelte';
 import type { ParsedBlock } from '@incremark/core';
-import type { UseIncremarkOptions } from '../stores/useIncremark';
+import type { UseIncremarkOptions } from '../stores/useIncremark.svelte.ts';
 /**
  * 组件映射类型
  * 使用 any 以支持不同类型的组件

package/dist/components/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/components/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEjE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;AAEvD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,cAAc,CAAC,MAAM,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,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,eAAe,CAAC,CAAA;IAClD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gBAAgB,CAAC,EAAE,mBAAmB,CAAA;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/components/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAE3E;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;AAEvD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,cAAc,CAAC,MAAM,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,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,eAAe,CAAC,CAAA;IAClD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gBAAgB,CAAC,EAAE,mBAAmB,CAAA;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B"}

package/dist/context/{definitionsContext.d.ts → definitionsContext.svelte.d.ts}

@@ -1,25 +1,25 @@
 /**
  * @file Definitions Context - Svelte Context 实现
- * @description 管理 definitions 和 footnotes 的共享状态，对应 Vue 版本的 provide/inject
+ * @description 管理 definitions 和 footnotes 的共享状态，使用 Svelte 5 runes 语法
  */
-import { type Writable } from 'svelte/store';
 import type { Definition, FootnoteDefinition } from 'mdast';
 /**
- * Definitions Context 值类型
+ * Definitions Context 值类型（使用 getter 函数）
  */
 export interface DefinitionsContextValue {
-    /** Definitions 映射 */
-    definations: Writable<Record<string, Definition>>;
-    /** Footnote definitions 映射 */
-    footnoteDefinitions: Writable<Record<string, FootnoteDefinition>>;
-    /** Footnote 引用顺序 */
-    footnoteReferenceOrder: Writable<string[]>;
+    /** 获取 Definitions 映射 */
+    getDefinations: () => Record<string, Definition>;
+    /** 获取 Footnote definitions 映射 */
+    getFootnoteDefinitions: () => Record<string, FootnoteDefinition>;
+    /** 获取 Footnote 引用顺序 */
+    getFootnoteReferenceOrder: () => string[];
 }
 /**
  * 设置 Definitions Context
  *
  * @description
  * 在父组件中调用，为子组件提供 definitions context
+ * 使用 $state 实现响应式状态
  *
  * @returns 返回设置函数，用于更新 context 值
  *
@@ -56,9 +56,11 @@ export declare function setDefinitionsContext(): {
  * <script>
  *   import { getDefinitionsContext } from '@incremark/svelte'
  *
- *   const { definations, footnoteDefinitions, footnoteReferenceOrder } = getDefinitionsContext()
+ *   const context = getDefinitionsContext()
+ *   // 使用 getter 获取值（在模板或 $derived 中使用会自动追踪依赖）
+ *   const definitions = $derived(context.getDefinations())
  * </script>
  * ```
  */
 export declare function getDefinitionsContext(): DefinitionsContextValue;
-//# sourceMappingURL=definitionsContext.d.ts.map
+//# sourceMappingURL=definitionsContext.svelte.d.ts.map

package/dist/context/definitionsContext.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitionsContext.svelte.d.ts","sourceRoot":"","sources":["../../src/context/definitionsContext.svelte.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wBAAwB;IACxB,cAAc,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAChD,iCAAiC;IACjC,sBAAsB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAChE,uBAAuB;IACvB,yBAAyB,EAAE,MAAM,MAAM,EAAE,CAAA;CAC1C;AAOD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB;kCAiBE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;0CAOlB,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;uCAOrC,MAAM,EAAE;;;;;EA2CnD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,IAAI,uBAAuB,CAQ/D"}

package/dist/context/{definitionsContext.js → definitionsContext.svelte.js}

@@ -1,9 +1,8 @@
 /**
  * @file Definitions Context - Svelte Context 实现
- * @description 管理 definitions 和 footnotes 的共享状态，对应 Vue 版本的 provide/inject
+ * @description 管理 definitions 和 footnotes 的共享状态，使用 Svelte 5 runes 语法
  */
 import { setContext, getContext } from 'svelte';
-import { writable } from 'svelte/store';
 /**
  * Context key
  */
@@ -13,6 +12,7 @@ const DEFINITIONS_CONTEXT_KEY = Symbol('definitionsContext');
  *
  * @description
  * 在父组件中调用，为子组件提供 definitions context
+ * 使用 $state 实现响应式状态
  *
  * @returns 返回设置函数，用于更新 context 值
  *
@@ -26,50 +26,51 @@ const DEFINITIONS_CONTEXT_KEY = Symbol('definitionsContext');
  * ```
  */
 export function setDefinitionsContext() {
-    const definations = writable({});
-    const footnoteDefinitions = writable({});
-    const footnoteReferenceOrder = writable([]);
+    // 使用 $state 实现响应式状态（每个组件实例有独立的状态）
+    let definationsState = $state({});
+    let footnoteDefinitionsState = $state({});
+    let footnoteReferenceOrderState = $state([]);
     const contextValue = {
-        definations,
-        footnoteDefinitions,
-        footnoteReferenceOrder
+        getDefinations: () => definationsState,
+        getFootnoteDefinitions: () => footnoteDefinitionsState,
+        getFootnoteReferenceOrder: () => footnoteReferenceOrderState
     };
     setContext(DEFINITIONS_CONTEXT_KEY, contextValue);
     /**
      * 设置 definitions
      */
     function setDefinations(definitions) {
-        definations.set(definitions);
+        definationsState = definitions;
     }
     /**
      * 设置 footnote definitions
      */
     function setFootnoteDefinitions(definitions) {
-        footnoteDefinitions.set(definitions);
+        footnoteDefinitionsState = definitions;
     }
     /**
      * 设置 footnote 引用顺序
      */
     function setFootnoteReferenceOrder(order) {
-        footnoteReferenceOrder.set(order);
+        footnoteReferenceOrderState = order;
     }
     /**
      * 清空 definitions
      */
     function clearDefinations() {
-        definations.set({});
+        definationsState = {};
     }
     /**
      * 清空 footnote definitions
      */
     function clearFootnoteDefinitions() {
-        footnoteDefinitions.set({});
+        footnoteDefinitionsState = {};
     }
     /**
      * 清空 footnote 引用顺序
      */
     function clearFootnoteReferenceOrder() {
-        footnoteReferenceOrder.set([]);
+        footnoteReferenceOrderState = [];
     }
     /**
      * 清空所有 definitions
@@ -104,7 +105,9 @@ export function setDefinitionsContext() {
  * <script>
  *   import { getDefinitionsContext } from '@incremark/svelte'
  *
- *   const { definations, footnoteDefinitions, footnoteReferenceOrder } = getDefinitionsContext()
+ *   const context = getDefinitionsContext()
+ *   // 使用 getter 获取值（在模板或 $derived 中使用会自动追踪依赖）
+ *   const definitions = $derived(context.getDefinations())
  * </script>
  * ```
  */

package/dist/index.d.ts

@@ -2,16 +2,17 @@
  * @file @incremark/svelte 主入口文件
  * @description Svelte 5 集成库的导出入口
  */
-export { useIncremark, type UseIncremarkOptions, type UseIncremarkReturn, type TypewriterOptions, type TypewriterControls } from './stores/useIncremark';
-export { useDevTools, type UseDevToolsOptions } from './stores/useDevTools.svelte';
-export { useBlockTransformer, type UseBlockTransformerOptions, type UseBlockTransformerReturn } from './stores/useBlockTransformer';
-export { useLocale, type UseLocaleReturn } from './stores/useLocale.svelte';
-export { setDefinitionsContext, getDefinitionsContext, type DefinitionsContextValue } from './context/definitionsContext';
+export { useIncremark, type UseIncremarkOptions, type UseIncremarkReturn, type TypewriterOptions, type TypewriterControls } from './stores/useIncremark.svelte.ts';
+export { useDevTools, type UseDevToolsOptions } from './stores/useDevTools.svelte.ts';
+export { useBlockTransformer, type UseBlockTransformerOptions, type UseBlockTransformerReturn } from './stores/useBlockTransformer.svelte.ts';
+export { useLocale, type UseLocaleReturn } from './stores/useLocale.svelte.ts';
+export { setDefinitionsContext, getDefinitionsContext, type DefinitionsContextValue } from './context/definitionsContext.svelte.ts';
 export { Incremark, IncremarkContent, IncremarkParagraph, IncremarkInline, IncremarkHeading, IncremarkCode, IncremarkList, IncremarkTable, IncremarkBlockquote, IncremarkThematicBreak, IncremarkMath, IncremarkHtmlElement, IncremarkFootnotes, IncremarkDefault, IncremarkRenderer, type ComponentMap, type RenderableBlock, type IncremarkContentProps, type CodeBlockConfig } from './components';
 export { default as AutoScrollContainer } from './components/AutoScrollContainer.svelte';
 export { default as ThemeProvider } from './ThemeProvider.svelte';
 export { default as ConfigProvider } from './components/ConfigProvider.svelte';
 export type { ParsedBlock, IncrementalUpdate, ParserOptions, BlockStatus, Root, RootContent, SourceBlock, DisplayBlock, TransformerPlugin, TransformerOptions, TransformerState, AnimationEffect } from '@incremark/core';
+export type { Root as MdastRoot, Parent, Heading, Paragraph, Code, Blockquote, List, ListItem, Table, TableCell, ThematicBreak, Text, PhrasingContent, InlineCode, Link, LinkReference, Image, ImageReference, HTML, Definition, FootnoteDefinition } from 'mdast';
 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';
 import { en as enShared, zhCN as zhCNShared } from '@incremark/shared';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AACxJ,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAClF,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC/B,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAG3E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,KAAK,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAGzH,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACrB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AACxF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAG9E,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,IAAI,EACJ,WAAW,EAEX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EAChB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EACf,aAAa,EACb,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,YAAY,EACb,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,UAAU,EACV,UAAU,EACX,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,EAAE,IAAI,QAAQ,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,UAAU,IAAI,IAAI,EAAE,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAClK,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC/B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAG9E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wCAAwC,CAAA;AAGnI,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACrB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AACxF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAA;AAG9E,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,IAAI,EACJ,WAAW,EAEX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EAChB,MAAM,iBAAiB,CAAA;AAGxB,YAAY,EACV,IAAI,IAAI,SAAS,EACjB,MAAM,EAEN,OAAO,EACP,SAAS,EACT,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,SAAS,EACT,aAAa,EAEb,IAAI,EACJ,eAAe,EACf,UAAU,EACV,IAAI,EACJ,aAAa,EACb,KAAK,EACL,cAAc,EAEd,IAAI,EAEJ,UAAU,EACV,kBAAkB,EACnB,MAAM,OAAO,CAAA;AAGd,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EACf,aAAa,EACb,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,YAAY,EACb,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,UAAU,EACV,UAAU,EACX,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,EAAE,IAAI,QAAQ,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,UAAU,IAAI,IAAI,EAAE,CAAA;AAC7C,YAAY,EAAE,eAAe,EAAE,CAAA"}

package/dist/index.js

@@ -3,12 +3,12 @@
  * @description Svelte 5 集成库的导出入口
  */
 // Stores/Utilities
-export { useIncremark } from './stores/useIncremark';
-export { useDevTools } from './stores/useDevTools.svelte';
-export { useBlockTransformer } from './stores/useBlockTransformer';
-export { useLocale } from './stores/useLocale.svelte';
+export { useIncremark } from './stores/useIncremark.svelte.ts';
+export { useDevTools } from './stores/useDevTools.svelte.ts';
+export { useBlockTransformer } from './stores/useBlockTransformer.svelte.ts';
+export { useLocale } from './stores/useLocale.svelte.ts';
 // Context
-export { setDefinitionsContext, getDefinitionsContext } from './context/definitionsContext';
+export { setDefinitionsContext, getDefinitionsContext } from './context/definitionsContext.svelte.ts';
 // Components
 export { Incremark, IncremarkContent, IncremarkParagraph, IncremarkInline, IncremarkHeading, IncremarkCode, IncremarkList, IncremarkTable, IncremarkBlockquote, IncremarkThematicBreak, IncremarkMath, IncremarkHtmlElement, IncremarkFootnotes, IncremarkDefault, IncremarkRenderer } from './components';
 // Additional Components

package/dist/stores/{useBlockTransformer.d.ts → useBlockTransformer.svelte.d.ts}

@@ -1,9 +1,8 @@
 /**
- * @file useBlockTransformer Store - 块转换器
- * @description 用于控制 blocks 的逐步显示（打字机效果）
+ * @file useBlockTransformer - 块转换器
+ * @description 用于控制 blocks 的逐步显示（打字机效果），使用 Svelte 5 runes 语法
  */
-import { type Readable } from 'svelte/store';
-import { BlockTransformer, type TransformerOptions, type DisplayBlock, type SourceBlock, type AnimationEffect } from '@incremark/core';
+import { type TransformerOptions, type DisplayBlock, type SourceBlock, type AnimationEffect, type BlockTransformer } from '@incremark/core';
 /**
  * useBlockTransformer 选项
  */
@@ -13,14 +12,16 @@ export interface UseBlockTransformerOptions extends Omit<TransformerOptions, 'on
  * useBlockTransformer 返回值
  */
 export interface UseBlockTransformerReturn<T = unknown> {
-    /** 用于渲染的 display blocks */
-    displayBlocks: Readable<DisplayBlock<T>[]>;
-    /** 是否正在处理中 */
-    isProcessing: Readable<boolean>;
-    /** 是否已暂停 */
-    isPaused: Readable<boolean>;
-    /** 当前动画效果 */
-    effect: Readable<AnimationEffect>;
+    /** 用于渲染的 display blocks（getter） */
+    readonly displayBlocks: DisplayBlock<T>[];
+    /** 是否正在处理中（getter） */
+    readonly isProcessing: boolean;
+    /** 是否已暂停（getter） */
+    readonly isPaused: boolean;
+    /** 当前动画效果（getter） */
+    readonly effect: AnimationEffect;
+    /** 推入新的 source blocks */
+    push: (blocks: SourceBlock<T>[]) => void;
     /** 跳过所有动画 */
     skip: () => void;
     /** 重置状态 */
@@ -35,11 +36,11 @@ export interface UseBlockTransformerReturn<T = unknown> {
     transformer: BlockTransformer<T>;
 }
 /**
- * Svelte 5 Store: Block Transformer
+ * Svelte 5 Composable: Block Transformer
  *
  * @description
  * 用于控制 blocks 的逐步显示（打字机效果）
- * 作为解析器和渲染器之间的中间层
+ * 作为解析器和渲染器之间的中间层，使用 Svelte 5 runes 语法
  *
  * 特性：
  * - 使用 requestAnimationFrame 实现流畅动画
@@ -47,7 +48,6 @@ export interface UseBlockTransformerReturn<T = unknown> {
  * - 支持动画效果 `effect: 'typing'`
  * - 页面不可见时自动暂停
  *
- * @param sourceBlocks - 源 blocks store
  * @param options - 转换器选项
  * @returns 转换器状态和控制对象
  *
@@ -55,35 +55,33 @@ export interface UseBlockTransformerReturn<T = unknown> {
  * ```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 incremark = useIncremark()
  *
  *   // 添加打字机效果
- *   const { displayBlocks, isProcessing, skip, effect } = useBlockTransformer(sourceBlocks, {
+ *   const blockTransformer = useBlockTransformer({
  *     charsPerTick: [1, 3],
  *     tickInterval: 30,
  *     effect: 'typing',
  *     plugins: defaultPlugins
  *   })
+ *
+ *   // 当 blocks 变化时推入
+ *   $effect(() => {
+ *     const sourceBlocks = incremark.completedBlocks.map(b => ({
+ *       id: b.id,
+ *       node: b.node,
+ *       status: b.status
+ *     }))
+ *     blockTransformer.push(sourceBlocks)
+ *   })
  * </script>
  *
- * <template>
- *   <Incremark blocks={$displayBlocks} class:typing={$effect === 'typing'} />
- *   {#if $isProcessing}
- *     <button on:click={skip}>跳过</button>
- *   {/if}
- * </template>
+ * <Incremark blocks={blockTransformer.displayBlocks} />
+ * {#if blockTransformer.isProcessing}
+ *   <button onclick={blockTransformer.skip}>跳过</button>
+ * {/if}
  * ```
  */
-export declare function useBlockTransformer<T = unknown>(sourceBlocks: Readable<SourceBlock<T>[]>, options?: UseBlockTransformerOptions): UseBlockTransformerReturn<T>;
-//# sourceMappingURL=useBlockTransformer.d.ts.map
+export declare function useBlockTransformer<T = unknown>(options?: UseBlockTransformerOptions): UseBlockTransformerReturn<T>;
+//# sourceMappingURL=useBlockTransformer.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBlockTransformer.svelte.d.ts","sourceRoot":"","sources":["../../src/stores/useBlockTransformer.svelte.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,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,mCAAmC;IACnC,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;IACzC,sBAAsB;IACtB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,oBAAoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,yBAAyB;IACzB,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAA;IACxC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC7C,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CAAC,CAAC,CAAC,CAwD9B"}

package/dist/stores/useBlockTransformer.svelte.js

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

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

@@ -3,7 +3,7 @@
  * @description Svelte 5 DevTools 一行接入
  */
 import { type DevToolsOptions } from '@incremark/devtools';
-import type { UseIncremarkReturn } from './useIncremark';
+import type { UseIncremarkReturn } from './useIncremark.svelte.ts';
 /**
  * useDevTools 选项
  */

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

@@ -1 +1 @@
-{"version":3,"file":"useDevTools.svelte.d.ts","sourceRoot":"","sources":["../../src/stores/useDevTools.svelte.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,eAAe;CAAG;AAE9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,GAAE,kBAAuB,mDAkCjC"}
+{"version":3,"file":"useDevTools.svelte.d.ts","sourceRoot":"","sources":["../../src/stores/useDevTools.svelte.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAElE;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,eAAe;CAAG;AAE9D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,GAAE,kBAAuB,mDAkCjC"}

package/dist/stores/{useIncremark.d.ts → useIncremark.svelte.d.ts}

@@ -1,8 +1,7 @@
 /**
- * @file useIncremark Store - 核心 Store
- * @description Svelte 5 Store: Incremark 流式 Markdown 解析器
+ * @file useIncremark - 核心 Composable
+ * @description Svelte 5 Composable: Incremark 流式 Markdown 解析器（使用 runes 语法）
  */
-import { type Writable, type Readable } from 'svelte/store';
 import { createIncremarkParser, type IncremarkParserOptions, type ParsedBlock, type IncrementalUpdate, type Root, type TransformerPlugin, type AnimationEffect } from '@incremark/core';
 /**
  * 打字机效果配置
@@ -37,16 +36,16 @@ export type RenderableBlock = ParsedBlock & {
  * 打字机控制对象
  */
 export interface TypewriterControls {
-    /** 是否启用（只读） */
-    enabled: Readable<boolean>;
+    /** 是否启用（只读 getter） */
+    readonly enabled: boolean;
     /** 设置是否启用 */
     setEnabled: (enabled: boolean) => void;
     /** 是否正在处理中 */
-    isProcessing: Readable<boolean>;
+    readonly isProcessing: boolean;
     /** 是否已暂停 */
-    isPaused: Readable<boolean>;
+    readonly isPaused: boolean;
     /** 当前动画效果 */
-    effect: Readable<AnimationEffect>;
+    readonly effect: AnimationEffect;
     /** 跳过动画，直接显示全部 */
     skip: () => void;
     /** 暂停动画 */
@@ -60,29 +59,29 @@ export interface TypewriterControls {
  * useIncremark 返回值
  */
 export interface UseIncremarkReturn {
-    /** 已收集的完整 Markdown 字符串 */
-    markdown: Writable<string>;
-    /** 已完成的块列表 */
-    completedBlocks: Writable<ParsedBlock[]>;
-    /** 待处理的块列表 */
-    pendingBlocks: Writable<ParsedBlock[]>;
-    /** 当前完整的 AST */
-    ast: Readable<Root>;
-    /** 用于渲染的 blocks（根据打字机设置自动处理） */
-    blocks: Readable<Array<RenderableBlock>>;
-    /** 是否正在加载 */
-    isLoading: Writable<boolean>;
-    /** 是否已完成（finalize） */
-    isFinalized: Writable<boolean>;
+    /** 已收集的完整 Markdown 字符串（getter） */
+    readonly markdown: string;
+    /** 已完成的块列表（getter） */
+    readonly completedBlocks: ParsedBlock[];
+    /** 待处理的块列表（getter） */
+    readonly pendingBlocks: ParsedBlock[];
+    /** 当前完整的 AST（getter） */
+    readonly ast: Root;
+    /** 用于渲染的 blocks（getter，根据打字机设置自动处理） */
+    readonly blocks: Array<RenderableBlock>;
+    /** 是否正在加载（getter） */
+    readonly isLoading: boolean;
+    /** 是否已完成（finalize）（getter） */
+    readonly isFinalized: boolean;
     /**
-     * 内容是否完全显示完成
+     * 内容是否完全显示完成（getter）
      * - 无打字机：等于 isFinalized
      * - 有打字机：isFinalized + 动画播放完成
      * 适用于控制 footnote 等需要在内容完全显示后才出现的元素
      */
-    isDisplayComplete: Readable<boolean>;
-    /** 脚注引用的出现顺序 */
-    footnoteReferenceOrder: Writable<string[]>;
+    readonly isDisplayComplete: boolean;
+    /** 脚注引用的出现顺序（getter） */
+    readonly footnoteReferenceOrder: string[];
     /** 追加内容 */
     append: (chunk: string) => IncrementalUpdate;
     /** 完成解析 */
@@ -101,10 +100,10 @@ export interface UseIncremarkReturn {
     typewriter: TypewriterControls;
 }
 /**
- * Svelte 5 Store: Incremark 流式 Markdown 解析器
+ * Svelte 5 Composable: Incremark 流式 Markdown 解析器
  *
  * @description
- * 核心 store，管理解析器状态和操作
+ * 核心 composable，管理解析器状态和操作，使用 Svelte 5 runes 语法
  *
  * @param options - 解析器选项
  * @returns 解析器状态和控制对象
@@ -115,10 +114,10 @@ export interface UseIncremarkReturn {
  *   import { useIncremark, Incremark } from '@incremark/svelte'
  *
  *   // 基础用法
- *   const { blocks, append, finalize } = useIncremark()
+ *   const incremark = useIncremark()
  *
  *   // 启用打字机效果
- *   const { blocks, append, finalize, typewriter } = useIncremark({
+ *   const incremark = useIncremark({
  *     typewriter: {
  *       enabled: true,
  *       charsPerTick: [1, 3],
@@ -129,10 +128,8 @@ export interface UseIncremarkReturn {
  *   })
  * </script>
  *
- * <template>
- *   <Incremark blocks={$blocks} />
- * </template>
+ * <Incremark blocks={incremark.blocks} />
  * ```
  */
 export declare function useIncremark(options?: UseIncremarkOptions): UseIncremarkReturn;
-//# sourceMappingURL=useIncremark.d.ts.map
+//# sourceMappingURL=useIncremark.svelte.d.ts.map

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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"}