tiptap-markdown-react 0.19.2 → 1.0.0

package/dist/blockDrag/actions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockDrag/listDrop.d.ts

@@ -0,0 +1,21 @@
+import { Node as PMNode, Slice } from '@tiptap/pm/model';
+import { Plugin, PluginKey } from '@tiptap/pm/state';
+import { EditorView } from '@tiptap/pm/view';
+export declare const blockDragListGuardKey: PluginKey<any>;
+export declare function setBlockHandleDragging(view: EditorView, dragging: boolean): void;
+export declare function isBlockHandleDragging(view: EditorView): boolean;
+/** 坐标落在某份列表（含其中的条目）里面。 */
+export declare function isPosInsideList(doc: PMNode, pos: number): boolean;
+/**
+ * 把列表内部的位置抬到最外层那份列表的边界。
+ * `after` 为真时放在列表后面，否则放在前面。
+ */
+export declare function listEscapePos(doc: PMNode, pos: number, after: boolean): number | null;
+/** 指针在列表盒的下半段时落到列表后面，否则落到前面。 */
+export declare function listEscapeEdge(view: EditorView, pos: number, clientY: number): number | null;
+/**
+ * 把手柄拖来的切片挪到 `insertPos`。位置落在被拖的选区内部时不挪。
+ * 返回 true 表示这次落点已经由我们处理（包括故意不挪）。
+ */
+export declare function moveDraggedSlice(view: EditorView, slice: Slice, insertPos: number): boolean;
+export declare function blockDragListGuardPlugin(): Plugin;

package/dist/blockDrag/listDrop.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blurSelection.dom.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/characterCount.d.ts

@@ -0,0 +1 @@
+export declare function countWords(text: string): number;

package/dist/characterCount.dom.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/characterCount.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/chart/createChart.d.ts

@@ -1,16 +1,13 @@
 import { ReportChartOptions } from './ChartExtension';
 import { ChartTheme } from './types';
-import { ChartLabels } from '../labels';
 export interface CreateChartOptions {
     /** When true, reserved for future in-place chart editing. Currently unused (no edit UI). Default false. */
     editable?: boolean;
     chartTheme?: ChartTheme | null;
-    chartLabels?: Partial<ChartLabels>;
 }
 export interface InteractiveChartOptions extends ReportChartOptions {
     chartEditable: boolean;
     chartTheme: ChartTheme | null;
-    chartLabels?: Partial<ChartLabels>;
 }
 /**
  * Client chart extension with React NodeView.

package/dist/components/BlockDragHandle.d.ts

@@ -0,0 +1,14 @@
+import { Editor } from '@tiptap/core';
+export interface BlockDragHandleProps {
+    editor: Editor;
+}
+/**
+ * 块拖拽：悬停时在块左侧露出手柄（拖动重排），点手柄打开菜单
+ * （转换 / 复制 / 再制一份 / 删除）。交互对齐 Tiptap Drag Context Menu，
+ * 样式走本库的 `--tmr-*`。手柄跟着文档最外层的块走，列表和引用整块移动。
+ * 松开时如果指针在列表上，块落到整份列表的前面或后面，不会变成其中一条。
+ *
+ * 不注册 NodeRange 扩展：它会接管 Shift+方向键和 Mod-a。拖拽要用的
+ * NodeRangeSelection 在加载 drag-handle 时已经注册进 Selection。
+ */
+export declare function BlockDragHandle({ editor }: BlockDragHandleProps): import("react").JSX.Element;

package/dist/components/BlockDragHandle.dom.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/CodeBlockView.d.ts

@@ -1,11 +1,11 @@
 import { NodeViewProps } from '@tiptap/react';
 /**
  * 代码块自定义 NodeView：右上角语言选择器（Radix DropdownMenu，支持方向键导航）+ 删除。
- * 文案（Auto-detect / 删除标题）从扩展 options.codeBlockLabels 读取，缺省用英文默认。
+ * 文案从编辑器的 locale 读取，缺省英文。
  *
  * 只读态（预览 / 只读编辑器）走另一套头部：左侧语言标签，右侧复制 + 展开收起；
  * 超出 `--tmr-code-max-height`（缺省 480px）的代码块默认限高块内滚动，行号槽
  * 用 MutationObserver 跟踪 PM 管理的 code 内容保持同步（纯文本变化不触发 React
  * 重渲染，gutter 行数靠观察器自刷新）。
  */
-export declare function CodeBlockView({ node, updateAttributes, deleteNode, extension, editor, }: NodeViewProps): import("react").JSX.Element;
+export declare function CodeBlockView({ node, updateAttributes, deleteNode, editor, }: NodeViewProps): import("react").JSX.Element;

package/dist/components/ColorPalette.d.ts

@@ -1,10 +1,11 @@
-import { ColorPaletteLabels } from '../labels';
+import { LocaleCode } from '../i18n';
 export interface ColorPaletteProps {
     /** 当前已应用的颜色（用于打勾），无则不选中。 */
     value?: string;
     /** 点击某色块。null 表示「None」（清除）。 */
     onPick: (color: string | null) => void;
-    labels?: Partial<ColorPaletteLabels>;
+    /** 内置语言，默认英文。 */
+    locale?: LocaleCode;
 }
 /** 颜色面板：None 清除行 + 色板网格 + THEME 品牌色。 */
-export declare function ColorPalette({ value, onPick, labels }: ColorPaletteProps): import("react").JSX.Element;
+export declare function ColorPalette({ value, onPick, locale }: ColorPaletteProps): import("react").JSX.Element;

package/dist/components/EditorToolbar.d.ts

@@ -1,6 +1,6 @@
 import { Editor } from '@tiptap/react';
 import { ReactNode } from 'react';
-import { ToolbarLabels } from '../labels';
+import { LocaleCode } from '../i18n';
 import { ImportMenuItem } from '../importMenu';
 import { SourceRef } from '../citationUtils';
 /** `onImportDocument` 的成功返回。给字符串等价于 `{ markdown }`。 */
@@ -60,7 +60,8 @@ export interface EditorToolbarProps {
     importMenuItems?: ImportMenuItem[];
     /** 是否显示导入下拉，默认 `true`。卡片等场景可关掉。 */
     showImport?: boolean;
-    labels?: Partial<ToolbarLabels>;
+    /** 内置语言，默认英文。 */
+    locale?: LocaleCode;
     /**
      * 工具栏最右端的搜索入口（放大镜）。**不传就不渲染**——条子本身归
      * `<MarkdownWysiwygEditor>`，这里只给一个入口，宿主接上自己的编辑器句柄即可：
@@ -81,4 +82,4 @@ export type { ImportMenuItem };
  * 顶部操作栏（零 UI 框架依赖，Radix Popover 菜单 + 内联 SVG 图标）。位置由父级控制，
  * 这里只渲染按钮 + 反映 editor 激活态。不含业务耦合，扩展项经 extraToolbarItems 注入。
  */
-export declare function EditorToolbar({ editor, onImageUpload, onError, onImportDocument, importAccept, importMenuItems, showImport, labels, onSearch, searchActive, extraToolbarItems, className, }: EditorToolbarProps): import("react").JSX.Element;
+export declare function EditorToolbar({ editor, onImageUpload, onError, onImportDocument, importAccept, importMenuItems, showImport, locale, onSearch, searchActive, extraToolbarItems, className, }: EditorToolbarProps): import("react").JSX.Element;

package/dist/components/FindReplaceBar.d.ts

@@ -1,12 +1,13 @@
 import { Editor } from '@tiptap/react';
 import { CSSProperties, RefObject } from 'react';
-import { FindLabels } from '../labels';
+import { LocaleCode } from '../i18n';
 export interface FindReplaceBarProps {
     /** 编辑器实例（由 `<MarkdownWysiwygEditor>` 提供，浮动条不自行创建编辑器）。 */
     editor: Editor;
     /** 关闭（Esc / ×）：宿主负责收起浮动条并把焦点还给编辑器。 */
     onClose: () => void;
-    labels?: Partial<FindLabels>;
+    /** 内置语言，默认英文。 */
+    locale?: LocaleCode;
     /**
      * 查找输入框 ref。宿主拿它实现「再按一次 Mod+F 聚焦并全选当前查询」。
      * 也用于浮动条打开时自动聚焦。
@@ -17,4 +18,4 @@ export interface FindReplaceBarProps {
     /** 根节点内联样式（编辑器用它落 findBarOffset；宿主自绘时也可用）。 */
     style?: CSSProperties;
 }
-export declare function FindReplaceBar({ editor, onClose, labels, inputRef, className, style, }: FindReplaceBarProps): import("react").JSX.Element | null;
+export declare function FindReplaceBar({ editor, onClose, locale, inputRef, className, style, }: FindReplaceBarProps): import("react").JSX.Element | null;

package/dist/components/LinkPopover.d.ts

@@ -1,6 +1,6 @@
 import { Editor } from '@tiptap/react';
 import { CSSProperties, ReactNode } from 'react';
-import { LinkPopoverLabels } from '../labels';
+import { LocaleCode } from '../i18n';
 export interface LinkPopoverProps {
     /** 编辑器实例。 */
     editor: Editor;
@@ -9,7 +9,8 @@ export interface LinkPopoverProps {
      * 传函数组件时得先 `forwardRef`（本库的 `<EditorToolbar>` 就是这么接的）。
      */
     trigger: ReactNode;
-    labels?: Partial<LinkPopoverLabels>;
+    /** 内置语言，默认英文。 */
+    locale?: LocaleCode;
     /** 挂到浮层根节点上的 class / 内联样式（定位与层级归宿主，Radix 只管浮层方向）。 */
     className?: string;
     style?: CSSProperties;
@@ -25,4 +26,4 @@ export interface LinkPopoverProps {
  * 地址被编辑器拒掉时（Tiptap 的 `isAllowedUri`）浮层不关，输入框转成危险色并带上 title，
  * 让用户改——静默什么都不发生是最难查的。
  */
-export declare function LinkPopover({ editor, trigger, labels, className, style, }: LinkPopoverProps): import("react").JSX.Element;
+export declare function LinkPopover({ editor, trigger, locale, className, style, }: LinkPopoverProps): import("react").JSX.Element;

package/dist/components/MarkdownPreview.d.ts

@@ -1,3 +1,4 @@
+import { LocaleCode } from '../i18n';
 import { SourceRef } from '../citationUtils';
 import { RenderCitation } from '../citationTypes';
 export interface MarkdownPreviewProps {
@@ -14,6 +15,8 @@ export interface MarkdownPreviewProps {
      */
     renderCitation?: RenderCitation;
     className?: string;
+    /** 内置界面语言，默认英文。代码块与图表文案跟着变。 */
+    locale?: LocaleCode;
 }
 /**
  * 轻量只读 markdown 预览（Tiptap + 官方 @tiptap/markdown，editable:false）。
@@ -24,4 +27,4 @@ export interface MarkdownPreviewProps {
  * 这是「客户端只读预览」；若需 SEO / 无 JS 静态渲染，请改用 server 入口的
  * renderReportHtml + ReportContent / ReportContentWithCharts。
  */
-export declare function MarkdownPreview({ markdown, sources, renderCitation, className, }: MarkdownPreviewProps): import("react").JSX.Element;
+export declare function MarkdownPreview({ markdown, sources, renderCitation, className, locale, }: MarkdownPreviewProps): import("react").JSX.Element;

package/dist/components/MarkdownWysiwygEditor.d.ts

@@ -4,7 +4,7 @@ import { SourceRef } from '../citationUtils';
 import { RenderCitation } from '../citationTypes';
 import { CommentClickPayload, CommentRef } from '../commentAnchor/commentTypes';
 import { ImageUploadConfig } from '../imageUpload';
-import { CodeBlockLabels, FindLabels, ShortcutLabels, SlashMenuLabels } from '../labels';
+import { LocaleCode } from '../i18n';
 import { PendingAnchor } from '../pendingAnchor';
 import { SelectionKind } from '../selectionKind';
 import { TocItem } from '../toc/extractToc';
@@ -76,6 +76,8 @@ export interface MarkdownWysiwygEditorProps {
      * 只读态不应用评论锚定（comments 被忽略），与 MarkdownPreview 语义一致。
      */
     editable?: boolean;
+    /** 内置界面语言，默认英文。工具栏、目录等并列组件需各自传同一个值。 */
+    locale?: LocaleCode;
     /**
      * 初始脚注来源：按 index 对齐 `[^n]`，写入 citationRef 的 url/title。
      * 仅影响初始 content；后续插入请用 `insertMarkdown(editor, md, sources)`。
@@ -103,8 +105,6 @@ export interface MarkdownWysiwygEditorProps {
     markdownFileDrop?: boolean;
     /** 追加的 Tiptap 扩展（在内置扩展之后注册）。 */
     extraExtensions?: AnyExtension[];
-    /** 代码块 NodeView 的本地化文案。 */
-    codeBlockLabels?: Partial<CodeBlockLabels>;
     /**
      * 「这段正在被 AI 改写」的高亮：宿主在提交请求时给上、回填或冲突时传空数组清空。
      * 走 decoration，**不进 markdown、不进 undo 历史**，能盖住表格与图表这类块级节点。
@@ -177,8 +177,6 @@ export interface MarkdownWysiwygEditorProps {
      * 保留浏览器原生查找，或自己摆入口。焦点不在编辑器内时不接管，同页多编辑器不会互相抢。
      */
     findShortcut?: boolean;
-    /** 查找替换浮动条的本地化文案。 */
-    findLabels?: Partial<FindLabels>;
     /**
      * 浮动条开合状态变化的通知（条子开着时 `handle.openFind()`、Esc / × 关掉都会触发）。
      * 典型用法是驱动别处的入口按钮：`<EditorToolbar onSearch={open} searchActive={isOpen} />`。
@@ -191,8 +189,6 @@ export interface MarkdownWysiwygEditorProps {
      * 「格式 / 快捷键 / Markdown」三列对照抽屉（默认 true，只读态隐藏）。
      */
     shortcutPanel?: boolean;
-    /** 快捷键抽屉的本地化文案。 */
-    shortcutLabels?: Partial<ShortcutLabels>;
     /**
      * 把快捷键悬浮键挂到宿主的容器里（与 `findBarContainer` 同一套）：
      * 给元素或返回元素的函数即可，开合状态与抽屉归库——只换按钮落点。
@@ -207,8 +203,26 @@ export interface MarkdownWysiwygEditorProps {
      * 追加自定义命令项请传 `extraExtensions` 注册 `SlashMenu.configure({ items })`。
      */
     slashMenu?: boolean;
-    /** 斜杠菜单的本地化文案。 */
-    slashMenuLabels?: Partial<SlashMenuLabels>;
+    /**
+     * 智能标点（官方 `@tiptap/extension-typography`，MIT，不是 Pro）。
+     * 键入时把直引号收成弯引号、`--` 收成破折号、`...` 收成省略号，以及箭头、©、分数等。
+     * 代码块和行内代码里不触发；Backspace 撤销刚发生的替换。`---` 仍是分隔线。
+     * 默认 true。仅初始化时生效。
+     */
+    typography?: boolean;
+    /**
+     * 表情建议列表：键入 `:`（行首或空白后）弹出，选中后插入 emoji 节点。
+     * Markdown 存成 `:shortcode:`。传 false 只是不弹列表——节点、完整短码输入和往返仍在。
+     * 只读态不弹出。默认 true。仅初始化时生效。
+     */
+    emojiSuggestion?: boolean;
+    /**
+     * 块拖拽（对齐 Tiptap Drag Context Menu）：悬停块时左侧出现手柄，拖动重排，
+     * 点击打开菜单（转成别的块 / 复制 / 再制一份 / 删除，图片还可下载）。
+     * 手柄旁的「+」在块首插入 `/`，唤起斜杠菜单（`slashMenu={false}` 时不显示加号）。
+     * 默认 true。只读态和窄屏（宽度小于 768px）不显示，并收起左侧留白。
+     */
+    blockDrag?: boolean;
     /**
      * 图片上传（对齐官方 ImageUploadNode 的交互）：配置后工具栏的图片按钮变成
      * 「插入上传块」——文档里出现拖拽 / 点击的占位块，上传进度就地显示，全部成功后就地
@@ -226,6 +240,13 @@ export interface MarkdownWysiwygEditorProps {
      * imageMarkdown.ts）。传 `false` 关闭；传对象透传官方 resize 配置。仅初始化时生效。
      */
     imageResize?: boolean | ImageResizeOptions;
+    /**
+     * 全文统计（默认关）：传 `true` 才注册 MIT 包 `@tiptap/extensions` 的 CharacterCount
+     * （开源扩展，不是付费的 `@tiptap-pro`），在编辑器底部实时显示字符数与词数。
+     * 统计条是本库自绘。词数把每个汉字算作 1 个词（该扩展默认按空格切，整段中文会是 1）。
+     * 数字也可从 `editor.storage.characterCount` 读取。仅初始化时生效。
+     */
+    characterCount?: boolean;
 }
 /**
  * 所见即所得 Markdown 编辑器（基于 Tiptap v3 + 官方 @tiptap/markdown）。

package/dist/components/TocPanel.d.ts

@@ -1,4 +1,4 @@
-import { TocLabels } from '../labels';
+import { LocaleCode } from '../i18n';
 import { TocItem } from '../toc/extractToc';
 export interface TocPanelProps {
     items: TocItem[];
@@ -6,7 +6,8 @@ export interface TocPanelProps {
     activeId?: string;
     /** 点击目录项。锁住项不触发。默认行为由调用方决定（滚动 / 跳转）。 */
     onItemClick?: (item: TocItem) => void;
-    labels?: Partial<TocLabels>;
+    /** 内置语言，默认英文。 */
+    locale?: LocaleCode;
 }
 /**
  * 目录面板（阅读页 + 编辑页共用）。
@@ -17,4 +18,4 @@ export interface TocPanelProps {
  *
  * 纯展示：滚动 / active 计算交给调用方，本组件只渲染 + 派发点击。
  */
-export declare function TocPanel({ items, activeId, onItemClick, labels }: TocPanelProps): import("react").JSX.Element | null;
+export declare function TocPanel({ items, activeId, onItemClick, locale, }: TocPanelProps): import("react").JSX.Element | null;

package/dist/detailsMarkdown.d.ts

@@ -0,0 +1,4 @@
+import { JSONContent, MarkdownParseHelpers, MarkdownRendererHelpers, MarkdownToken, MarkdownTokenizer } from '@tiptap/core';
+export declare const detailsMarkdownTokenizer: MarkdownTokenizer;
+export declare function detailsParseMarkdown(token: MarkdownToken, helpers: MarkdownParseHelpers): JSONContent;
+export declare function detailsRenderMarkdown(node: JSONContent, helpers: MarkdownRendererHelpers): string;

package/dist/detailsMarkdown.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/emoji/EmojiSuggestion.d.ts

@@ -0,0 +1,23 @@
+import { EmojiItem } from '@tiptap/extension-emoji';
+import { AnyExtension } from '@tiptap/core';
+export interface EmojiSuggestionPopupHandle {
+    /** 编辑器键盘事件经 IME 守卫后委托进来；返回 true 表示已消费。 */
+    onKeyDown: (event: KeyboardEvent) => boolean;
+}
+export interface EmojiSuggestionPopupProps {
+    items: EmojiItem[];
+    query: string;
+    menuLabel: string;
+    command: (item: EmojiItem) => void;
+}
+/**
+ * 冒号表情格子。空查询按底部分类标签浏览；继续打短码则在全部分类里筛选。
+ * 定位由 @tiptap/suggestion 的 mount 接管。
+ */
+export declare const EmojiSuggestionPopup: import('react').ForwardRefExoticComponent<EmojiSuggestionPopupProps & import('react').RefAttributes<EmojiSuggestionPopupHandle>>;
+/**
+ * 把 schema 上的 emoji 扩展配成带（或不带）建议列表的那一份。
+ * configure 深合并 options，官方的 command / char / pluginKey 留着。
+ * 关掉时 allow 恒为 false：不弹层，`:smile:` 输入规则仍在。
+ */
+export declare function configureEmojiSuggestion(extension: AnyExtension, enabled: boolean): AnyExtension;

package/dist/emoji/emojiCategories.d.ts

@@ -0,0 +1,52 @@
+import { EmojiItem } from '@tiptap/extension-emoji';
+/** 底部标签。顺序与官方数据的 group 一致；图标是分类代表，不依赖某一条数据还在不在。 */
+export declare const EMOJI_CATEGORIES: readonly [{
+    readonly id: "smileys";
+    readonly group: "";
+    readonly label: "Smileys";
+    readonly icon: "😀";
+}, {
+    readonly id: "people";
+    readonly group: "people & body";
+    readonly label: "People";
+    readonly icon: "👋";
+}, {
+    readonly id: "nature";
+    readonly group: "animals & nature";
+    readonly label: "Animals & nature";
+    readonly icon: "🐻";
+}, {
+    readonly id: "food";
+    readonly group: "food & drink";
+    readonly label: "Food & drink";
+    readonly icon: "🍔";
+}, {
+    readonly id: "travel";
+    readonly group: "travel & places";
+    readonly label: "Travel & places";
+    readonly icon: "✈️";
+}, {
+    readonly id: "activities";
+    readonly group: "activities";
+    readonly label: "Activities";
+    readonly icon: "⚽";
+}, {
+    readonly id: "objects";
+    readonly group: "objects";
+    readonly label: "Objects";
+    readonly icon: "💡";
+}, {
+    readonly id: "symbols";
+    readonly group: "symbols";
+    readonly label: "Symbols";
+    readonly icon: "💯";
+}, {
+    readonly id: "flags";
+    readonly group: "flags";
+    readonly label: "Flags";
+    readonly icon: "🏁";
+}];
+export type EmojiCategoryId = (typeof EMOJI_CATEGORIES)[number]['id'];
+/** 肤色和发型零件。官方扩展不支持肤色修饰，单独显示也不是可选表情。 */
+export declare function isEmojiComponent(item: EmojiItem): boolean;
+export declare function itemsInCategory(items: EmojiItem[], id: EmojiCategoryId): EmojiItem[];

package/dist/emoji/emojiMarkdown.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/emoji/emojiSuggestion.dom.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/emoji/filterEmoji.d.ts

@@ -0,0 +1,7 @@
+import { EmojiItem } from '@tiptap/extension-emoji';
+/**
+ * 按短码 / 名称优先、标签其次过滤表情。
+ * 空查询返回全部可用表情，弹层再按分类切开。
+ * 区域指示符和肤色零件不进列表。没有 Unicode 字符的自定义图也不进。
+ */
+export declare function filterEmojiItems(items: EmojiItem[], query: string): EmojiItem[];

package/dist/emoji/markdownEmoji.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 官方 Emoji 节点 + `:shortcode:` 的 markdown 往返。
+ *
+ * 官方只有 renderMarkdown（输出 `:name:`），没有 tokenizer，读回会变成普通文本。
+ * 建议列表的 React 弹层不在这里：server / 预览共用这份 schema，弹层由编辑器
+ * configure 贴上去。
+ */
+export declare const MarkdownEmoji: import('@tiptap/core').Node<import('@tiptap/extension-emoji').EmojiOptions, import('@tiptap/extension-emoji').EmojiStorage>;