@incremark/solid 0.3.3

package/dist/composables/useProvideDefinations.d.ts

@@ -0,0 +1,36 @@
+import { type Accessor, type Setter } from 'solid-js';
+import type { Definition, FootnoteDefinition } from 'mdast';
+export interface DefinationsContextValue {
+    definations: Accessor<Record<string, Definition>>;
+    setDefinations: Setter<Record<string, Definition>>;
+    footnoteDefinitions: Accessor<Record<string, FootnoteDefinition>>;
+    setFootnoteDefinitions: Setter<Record<string, FootnoteDefinition>>;
+    footnoteReferenceOrder: Accessor<string[]>;
+    setFootnoteReferenceOrder: Setter<string[]>;
+    clearAllDefinations: () => void;
+}
+export declare const DefinationsContext: import("solid-js").Context<DefinationsContextValue | undefined>;
+export interface DefinationsProviderProps {
+    children?: any;
+    value: DefinationsContextValue;
+}
+export declare function DefinationsProvider(props: DefinationsProviderProps): import("solid-js").JSX.Element;
+/**
+ * Provides definitions state management
+ * Call this in a composable to get setter functions
+ */
+export declare function useProvideDefinations(): {
+    definations: Accessor<Record<string, Definition>>;
+    setDefinations: Setter<Record<string, Definition>>;
+    footnoteDefinitions: Accessor<Record<string, FootnoteDefinition>>;
+    setFootnoteDefinitions: Setter<Record<string, FootnoteDefinition>>;
+    footnoteReferenceOrder: Accessor<string[]>;
+    setFootnoteReferenceOrder: Setter<string[]>;
+    clearDefinations: () => void;
+    clearFootnoteDefinitions: () => void;
+    clearFootnoteReferenceOrder: () => void;
+    clearAllDefinations: () => void;
+    DefinationsProvider: typeof DefinationsProvider;
+    contextValue: DefinationsContextValue;
+};
+//# sourceMappingURL=useProvideDefinations.d.ts.map

package/dist/composables/useProvideDefinations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProvideDefinations.d.ts","sourceRoot":"","sources":["../../src/composables/useProvideDefinations.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAgB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAEnE,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAA;AAE3D,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IACjD,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IAClD,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAA;IACjE,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAClE,sBAAsB,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1C,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IAC3C,mBAAmB,EAAE,MAAM,IAAI,CAAA;CAChC;AAED,eAAO,MAAM,kBAAkB,iEAA2C,CAAA;AAE1E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,KAAK,EAAE,uBAAuB,CAAA;CAC/B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,kCAMlE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB;;;;;;;;;;;;;EA+CpC"}

package/dist/composables/useShiki.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Shiki Highlighter 单例管理器
+ *
+ * 避免重复创建 Shiki 实例，所有组件共享同一个 highlighter
+ */
+import { type Accessor } from 'solid-js';
+import type { HighlighterGeneric, BundledLanguage, BundledTheme } from 'shiki';
+interface HighlighterInfo {
+    highlighter: HighlighterGeneric<BundledLanguage, BundledTheme>;
+    loadedLanguages: Set<BundledLanguage>;
+    loadedThemes: Set<BundledTheme>;
+}
+/** Shiki highlighter 单例管理器 */
+declare class ShikiManager {
+    private static instance;
+    /** 存储 highlighter 实例，key 为主题名称 */
+    private highlighters;
+    private constructor();
+    static getInstance(): ShikiManager;
+    /**
+     * 获取或创建 highlighter
+     * @param theme 主题名称
+     * @returns highlighter 实例
+     */
+    getHighlighter(theme: BundledTheme): Promise<HighlighterInfo>;
+    /**
+     * 加载语言（按需）
+     * @param theme 主题名称
+     * @param lang 语言名称
+     */
+    loadLanguage(theme: BundledTheme, lang: BundledLanguage): Promise<void>;
+    /**
+     * 加载主题（按需）
+     * @param theme 主题名称
+     */
+    loadTheme(theme: BundledTheme): Promise<void>;
+    /**
+     * 高亮代码
+     * @param theme 主题名称
+     * @param code 代码内容
+     * @param lang 语言名称
+     * @param fallbackTheme 回退主题
+     * @returns 高亮后的 HTML
+     */
+    codeToHtml(theme: BundledTheme, code: string, lang: BundledLanguage, fallbackTheme: BundledTheme): Promise<string>;
+    /**
+     * 清理所有 highlighter（应用退出或需要重置时调用）
+     */
+    disposeAll(): void;
+}
+/**
+ * 获取 ShikiManager 单例（延迟初始化）
+ * 避免模块加载时立即创建实例，支持 SSR
+ */
+declare function getShikiManager(): ShikiManager;
+export { getShikiManager, ShikiManager };
+export interface UseShikiReturn {
+    highlighterInfo: Accessor<HighlighterInfo | null>;
+    isHighlighting: Accessor<boolean>;
+    isReady: Accessor<boolean>;
+    initHighlighter: () => Promise<void>;
+    highlight: (code: string, lang: string, fallbackTheme: string) => Promise<string>;
+}
+/**
+ * 使用 Shiki Highlighter（组合式函数）
+ *
+ * @param theme 主题名称
+ * @returns Shiki 相关的响应式状态和方法
+ */
+export declare function useShiki(theme: string): UseShikiReturn;
+//# sourceMappingURL=useShiki.d.ts.map

package/dist/composables/useShiki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShiki.d.ts","sourceRoot":"","sources":["../../src/composables/useShiki.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAI9E,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;AAID,8BAA8B;AAC9B,cAAM,YAAY;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IAEnD,kCAAkC;IAClC,OAAO,CAAC,YAAY,CAAqC;IAEzD,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;;;OAIG;IACG,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAuBnE;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7E;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD;;;;;;;OAOG;IACG,UAAU,CACd,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,eAAe,EACrB,aAAa,EAAE,YAAY,GAC1B,OAAO,CAAC,MAAM,CAAC;IAalB;;OAEG;IACH,UAAU;CAQX;AAMD;;;GAGG;AACH,iBAAS,eAAe,IAAI,YAAY,CAKvC;AAED,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,CAAA;AAIxC,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,QAAQ,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;IACjD,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACjC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC1B,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAClF;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CA0EtD"}

package/dist/composables/useStreamRenderer.d.ts

@@ -0,0 +1,25 @@
+import { type Accessor } from 'solid-js';
+import type { ParsedBlock } from '@incremark/core';
+export interface UseStreamRendererOptions {
+    /** 初始块列表 */
+    initialBlocks?: ParsedBlock[];
+}
+export interface UseStreamRendererReturn {
+    /** 块列表 */
+    blocks: Accessor<ParsedBlock[]>;
+    /** 设置块列表 */
+    setBlocks: (blocks: ParsedBlock[]) => void;
+    /** 添加块 */
+    addBlocks: (blocks: ParsedBlock[]) => void;
+    /** 清空块列表 */
+    clearBlocks: () => void;
+    /** 块数量 */
+    blockCount: Accessor<number>;
+}
+/**
+ * SolidJS 流式渲染 Hook
+ *
+ * 用于管理流式渲染的块列表状态
+ */
+export declare function useStreamRenderer(options?: UseStreamRendererOptions): UseStreamRendererReturn;
+//# sourceMappingURL=useStreamRenderer.d.ts.map

package/dist/composables/useStreamRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreamRenderer.d.ts","sourceRoot":"","sources":["../../src/composables/useStreamRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,MAAM,WAAW,wBAAwB;IACvC,YAAY;IACZ,aAAa,CAAC,EAAE,WAAW,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU;IACV,MAAM,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;IAC/B,YAAY;IACZ,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,IAAI,CAAA;IAC1C,UAAU;IACV,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,IAAI,CAAA;IAC1C,YAAY;IACZ,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,UAAU;IACV,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,uBAAuB,CAoBjG"}

package/dist/composables/useTypewriter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file useTypewriter Composable - 打字机效果管理
+ *
+ * @description
+ * 管理打字机效果的状态和控制逻辑。
+ *
+ * @author Incremark Team
+ * @license MIT
+ */
+import { type Accessor } from 'solid-js';
+import { type RootContent, type ParsedBlock, type BlockTransformer } from '@incremark/core';
+import type { TypewriterOptions, TypewriterControls } from './useIncremark';
+export interface UseTypewriterOptions {
+    typewriter: () => TypewriterOptions | undefined;
+    completedBlocks: Accessor<ParsedBlock[]>;
+    pendingBlocks: Accessor<ParsedBlock[]>;
+}
+/** 用于渲染的 block 类型 */
+export type RenderBlock = ParsedBlock & {
+    isLastPending?: boolean;
+};
+export interface UseTypewriterReturn {
+    /** 用于渲染的 blocks（经过打字机处理或原始blocks） */
+    blocks: RenderBlock[];
+    /** 打字机控制对象 */
+    typewriter: TypewriterControls;
+    /** transformer 实例 */
+    transformer: BlockTransformer<RootContent> | null;
+    /** 所有动画是否已完成（队列为空且没有正在处理的 block） */
+    isAnimationComplete: Accessor<boolean>;
+    /**
+     * 脚注引用顺序（所有动画完成后才返回）
+     * 用于控制脚注的显示时机：只有当所有 blocks 的打字机动画都完成后才显示脚注
+     * 动画进行中时返回空数组
+     */
+    displayedFootnoteReferenceOrder: Accessor<string[]>;
+}
+/**
+ * useTypewriter Composable
+ *
+ * @description
+ * 管理打字机效果的所有状态和逻辑。
+ *
+ * @param options - 打字机配置和数据
+ * @returns 打字机状态和控制对象
+ */
+export declare function useTypewriter(options: UseTypewriterOptions): UseTypewriterReturn;
+//# sourceMappingURL=useTypewriter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTypewriter.d.ts","sourceRoot":"","sources":["../../src/composables/useTypewriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,UAAU,CAAA;AAEjB,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,WAAW,EAGhB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAG3E,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,iBAAiB,GAAG,SAAS,CAAA;IAC/C,eAAe,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;IACxC,aAAa,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;CACvC;AAED,qBAAqB;AACrB,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAEnE,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,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;IACtC;;;;OAIG;IACH,+BAA+B,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CACpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CA0OhF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { useIncremark, useStreamRenderer, useDevTools, useBlockTransformer, useLocale } from './composables';
+export { useProvideDefinations } from './composables/useProvideDefinations';
+export { useDefinationsContext } from './composables/useDefinationsContext';
+export type { UseIncremarkOptions, TypewriterOptions, TypewriterControls, UseStreamRendererOptions, UseStreamRendererReturn, UseDevToolsOptions, UseDevToolsReturn, UseBlockTransformerOptions, UseBlockTransformerReturn } from './composables';
+export * from './components';
+export { clearAnimatedChunks, shouldAnimateChunk } from './utils/animatedChunks';
+export { ThemeProvider as ThemeProviderExport, useTheme } from './components/ThemeProvider';
+export { ConfigProvider as ConfigProviderExport } from './components/ConfigProvider';
+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';
+import type { IncremarkLocale } from '@incremark/shared';
+export { enShared as en, zhCNShared as zhCN };
+export type { IncremarkLocale };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC5G,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,eAAe,CAAA;AAGtB,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEhF,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC3F,OAAO,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAGpF,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"}