tiptap-markdown-react 0.1.0

package/dist/toc/extractToc.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 最小 Tiptap JSON 节点结构（只取本模块用到的字段）。
+ * 不从 `@tiptap/core` 引 `JSONContent`——core 是嵌套依赖、非直接依赖，
+ * 直接 import 类型解析不到（与仓库既有做法一致，见 extensions.ts）。
+ */
+interface TocDocNode {
+    type?: string;
+    text?: string;
+    attrs?: Record<string, unknown> | null;
+    content?: TocDocNode[];
+}
+/** 目录项。 */
+export interface TocItem {
+    /** 锚点 id（= heading 的 data-toc-id / id，由 generateTocIds 注入）。 */
+    id: string;
+    /** 标题层级（1-6）。 */
+    level: number;
+    /** 标题纯文本。 */
+    text: string;
+    /** 付费墙锁住的章节（置灰不可点）。 */
+    locked?: boolean;
+}
+/**
+ * 从已注入锚点 id 的 Tiptap JSON doc 提取 h1-h6 目录。
+ *
+ * 必须在 `generateTocIds` 之后调用（heading 的 attrs 里才有 `data-toc-id`）。
+ * `lockedTitles`：被截断（锁住）章节标题，命中则标 `locked`——
+ * 目录列全部章节，锁住项置灰不可点（付费墙钩子）。用 Set 便于去重命中。
+ */
+export declare function extractToc(doc: TocDocNode, lockedTitles?: string[]): TocItem[];
+export {};

package/dist/toc/tocSlug.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 目录锚点 id 生成——阅读页（SSR）与编辑页（editor）共用的**单一真源**，
+ * 保证「创作预览的锚点 = 发布后阅读页的锚点」。
+ *
+ * 用 slug 而非官方默认 UUID：slug 跨 SSR / ISR revalidate 稳定（UUID 每次都变、
+ * 分享的 #hash 会失效），且 `#introduction` 比 `#d4590f81-…` 可读、对 SEO 友好。
+ *
+ * slug 会重名（两个「细节」都 slug 成 `xi-jie`），故用闭包计数器去重：
+ * 同名追加 -2 / -3（已实测：details / details-2 / details-3，HTML id 全唯一）。
+ */
+/**
+ * 造一个带去重的 `getId`。每次生成新实例（闭包各自计数），传给
+ * `TableOfContents.configure({ getId })` 或 `generateTocIds` 的扩展配置。
+ */
+export declare function makeTocGetId(): (content: string) => string;

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "tiptap-markdown-react",
+  "version": "0.1.0",
+  "description": "A batteries-included, self-styled Markdown WYSIWYG editor and reader suite built on Tiptap v3. Markdown in/out, SSR/static rendering, table of contents, themeable via CSS variables, zero Ant Design.",
+  "type": "module",
+  "license": "MIT",
+  "author": "CatsInJune",
+  "homepage": "https://github.com/CatsInJune/tiptap-markdown-react#readme",
+  "bugs": {
+    "url": "https://github.com/CatsInJune/tiptap-markdown-react/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CatsInJune/tiptap-markdown-react.git"
+  },
+  "keywords": [
+    "tiptap",
+    "markdown",
+    "editor",
+    "wysiwyg",
+    "rich-text",
+    "react",
+    "prosemirror",
+    "ssr",
+    "table-of-contents"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@tiptap/extension-code-block-lowlight": "^3.27.0",
+    "@tiptap/extension-highlight": "^3.27.0",
+    "@tiptap/extension-image": "^3.27.0",
+    "@tiptap/extension-subscript": "^3.27.0",
+    "@tiptap/extension-superscript": "^3.27.0",
+    "@tiptap/extension-table": "^3.27.0",
+    "@tiptap/extension-table-of-contents": "^3.27.0",
+    "@tiptap/extension-task-item": "^3.27.0",
+    "@tiptap/extension-task-list": "^3.27.0",
+    "@tiptap/extension-text-style": "^3.27.0",
+    "@tiptap/markdown": "^3.27.0",
+    "@tiptap/pm": "^3.27.0",
+    "@tiptap/react": "^3.27.0",
+    "@tiptap/starter-kit": "^3.27.0",
+    "@tiptap/static-renderer": "^3.27.0",
+    "lowlight": "^3.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "dependencies": {
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-popover": "^1.1.15"
+  },
+  "devDependencies": {
+    "@tiptap/extension-code-block-lowlight": "^3.27.1",
+    "@tiptap/extension-highlight": "^3.27.1",
+    "@tiptap/extension-image": "^3.27.1",
+    "@tiptap/extension-subscript": "^3.27.1",
+    "@tiptap/extension-superscript": "^3.27.1",
+    "@tiptap/extension-table": "^3.27.1",
+    "@tiptap/extension-table-of-contents": "^3.27.1",
+    "@tiptap/extension-task-item": "^3.27.1",
+    "@tiptap/extension-task-list": "^3.27.1",
+    "@tiptap/extension-text-style": "^3.27.1",
+    "@tiptap/markdown": "^3.27.1",
+    "@tiptap/pm": "^3.27.1",
+    "@tiptap/react": "^3.27.1",
+    "@tiptap/starter-kit": "^3.27.1",
+    "@tiptap/static-renderer": "^3.27.1",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^4.7.0",
+    "lowlight": "^3.3.0",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "rollup-preserve-directives": "^1.1.3",
+    "typescript": "^5.9.3",
+    "vite": "^5.4.21",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "overrides": {
+    "@tiptap/core": "3.27.3"
+  }
+}