tiptap-markdown-react 0.17.1 → 0.18.0

package/dist/labels.d.ts

@@ -25,7 +25,18 @@ export interface ToolbarLabels {
     superscript: string;
     subscript: string;
     link: string;
+    /**
+     * 链接浮层输入框的占位与无障碍名（原 `window.prompt` 的提示语，现在落到输入框上）。
+     */
     linkPrompt: string;
+    /** 链接浮层「应用」按钮的 title / aria-label。 */
+    linkApply: string;
+    /** 链接浮层「在新窗口打开」按钮的 title / aria-label。 */
+    linkOpen: string;
+    /** 链接浮层「移除链接」按钮的 title / aria-label。 */
+    linkRemove: string;
+    /** 链接浮层：地址被编辑器拒绝时的提示（落在输入框 title 上）。 */
+    linkInvalid: string;
     image: string;
     imageUploadFailed: string;
     /** Markdown 文件导入失败（与图片上传共用 onError 回调时，便于宿主区分文案）。 */
@@ -49,11 +60,29 @@ export interface ToolbarLabels {
     orderedList: string;
     taskList: string;
     more: string;
+    /**
+     * 工具栏的搜索入口（放大镜按钮，落在 More 之后）：title 与 aria-label。
+     * 只在宿主传了 `onSearch` 时才渲染——它只是入口，条子本身归编辑器
+     * （`<MarkdownWysiwygEditor>`），点击后由宿主调 `handle.openFind()`。
+     */
+    search: string;
     codeBlock: string;
     hr: string;
     /** 导入下拉里的 Markdown 项。 */
     importMarkdown: string;
     tableInsert: string;
+    /** 行手柄的 title / aria-label（鼠标悬停单元格时出现在行的左缘）。 */
+    tableRowMenu: string;
+    /** 列手柄的 title / aria-label（悬停时出现在表格上方、对齐该列）。 */
+    tableColumnMenu: string;
+    /** 表格菜单：清空选中行 / 列 / 单元格矩形里的内容（保留单元格与表头）。 */
+    tableClearContent: string;
+    /** 表格菜单：把选中单元格的样式属性复位（列宽、对齐等；不动合并结构）。 */
+    tableResetCellStyles: string;
+    /** 表格底边 `+` 手柄（末尾追加一行）的 title / aria-label。 */
+    tableAppendRow: string;
+    /** 表格右边 `+` 手柄（末尾追加一列）的 title / aria-label。 */
+    tableAppendColumn: string;
     /** 网格选择器底部尺寸文案，如 "3 × 4"。参数顺序：列、行。 */
     tableSizeSelected: (cols: number, rows: number) => string;
     tableAddColumnBefore: string;
@@ -152,6 +181,17 @@ export interface ShortcutLabels {
     findReplace: string;
 }
 export declare const defaultShortcutLabels: ShortcutLabels;
+/** 链接编辑浮层（`<LinkPopover>`）文案。 */
+export interface LinkPopoverLabels {
+    /** 输入框占位与无障碍名，也是浮层的 aria-label。 */
+    field: string;
+    apply: string;
+    open: string;
+    remove: string;
+    /** 地址被编辑器拒绝时的提示（落在输入框 title 上）。 */
+    invalid: string;
+}
+export declare const defaultLinkPopoverLabels: LinkPopoverLabels;
 export interface ColorPaletteLabels {
     none: string;
     theme: string;
@@ -197,7 +237,7 @@ export interface FindLabels {
     caseSensitive: string;
     wholeWord: string;
     useRegex: string;
-    /** 计数文案。无结果时 current 传 0。 */
+    /** 计数文案。无结果时 current 传 0；有结果但还没定位到某一条（currentIndex 为 null）时也是 0。 */
     counter: (current: number, total: number) => string;
     /** 正则模式下模式非法（RE2 不支持 lookaround / backreference 等，见官方扩展）。 */
     invalidRegex: string;

package/dist/linkEditing.d.ts

@@ -0,0 +1,45 @@
+import { Editor } from '@tiptap/react';
+/** 链接可编辑吗：只读态、或当前选区不允许套 link mark（例如整块选中）时为 false。 */
+export declare function canSetLink(editor: Editor | null | undefined): boolean;
+/** 光标 / 选区是否落在链接里。 */
+export declare function isLinkActive(editor: Editor | null | undefined): boolean;
+/** 读当前链接的 href（不在链接里时是空串）。 */
+export declare function readLinkHref(editor: Editor | null | undefined): string;
+/**
+ * 把用户输入整理成要存进 href 的值。
+ *
+ * 原样保留：空、站内相对地址（`/docs`、`#sec`、`?q=1`）、已带协议的（`https:`、`mailto:`）。
+ * 补协议：裸域名（`example.com`、`example.com/a`）与主机:端口（`localhost:3000`）——补的是
+ * 扩展配置的 `defaultProtocol`，与 Tiptap 自动链接同一套，避免手打和粘贴落到不同地址。
+ */
+export declare function normalizeLinkHref(editor: Editor, raw: string): string;
+/**
+ * 应用链接：把地址套到**整条**链接（或选区）上；选区为空且原本不在链接里时，把地址当文本插进去。
+ * 返回扩展是否接受了这个地址——`setLink` 会走 Tiptap 的 `isAllowedUri`。
+ *
+ * 两处与官方那版不同，都是单测逼出来的：
+ *   1. 先 `can().setLink()` 干跑一遍。官方把 `insertContent` 挂在失败的 `setLink` 后面直接
+ *      `run()`，结果是地址被拒时正文仍被改（链接文字被换成那个地址）。
+ *   2. 「当文本插入」的判据是「选区为空**且光标不在已有链接里**」。官方只看选区是否为空，
+ *      于是「光标在链接里、改一个地址」会把整条链接的文字替换成地址——而这正是这个浮层的主用途。
+ */
+export declare function applyLink(editor: Editor | null | undefined, raw: string): boolean;
+/** 移除链接：范围同样扩到整条，并挡住自动链接立刻加回来。 */
+export declare function removeLink(editor: Editor | null | undefined): boolean;
+/**
+ * 把待打开的地址解析成绝对地址；解析不了、或协议不在白名单里时返回 `'#'` 表示「别打开」。
+ *
+ * 与官方 `sanitizeUrl(inputUrl, baseUrl)` 同语义：先按 base 解析成绝对地址（相对地址因此也
+ * 能用），再查协议白名单。调用方拿到 `'#'` 就不开新窗口。
+ */
+export declare function sanitizeLinkUrl(input: string, baseUrl: string): string;
+/**
+ * 打开地址（新窗口 + `noopener,noreferrer`）。空输入或非法地址都不开窗——调用方在此之前
+ * 已经用 `sanitizeLinkUrl` 判过一次，这里再判一次是为了让这个入口单独用也安全。
+ */
+export declare function openLinkUrl(input: string, baseUrl: string): boolean;
+/** 输入框的回车是否该当作「应用」（输入法组合中的回车是提交候选词，放行）。 */
+export declare function isApplyKey(event: {
+    key: string;
+    nativeEvent: Pick<KeyboardEvent, 'isComposing' | 'keyCode'>;
+}): boolean;

package/dist/linkEditing.test.d.ts

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