@fgbg/mdocs 0.6.0

package/dist/server/storage/file-store.js

@@ -0,0 +1,61 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { resolveDocAbsolutePath } from "./paths.js";
+/** 单篇文档允许的最大字节数（2 MB），超过则拒绝写入。 */
+const MAX_DOC_BYTES = 2 * 1024 * 1024;
+/**
+ * 将文档内容写入磁盘。
+ *
+ * @param domainId - 域 ID，用于隔离不同域的磁盘路径
+ * @param relativePath - 文档的相对路径（如 "guide/getting-started.md"）
+ * @param content - 要写入的 Markdown 文本内容
+ * @returns 写入结果，含内容哈希与字节数
+ */
+export function writeDocument(domainId, relativePath, content) {
+    const buf = Buffer.from(content, "utf8");
+    if (buf.byteLength > MAX_DOC_BYTES) {
+        throw new Error("document is too large");
+    }
+    const abs = resolveDocAbsolutePath(domainId, relativePath);
+    fs.mkdirSync(path.dirname(abs), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(abs, buf, { mode: 0o600 });
+    return {
+        contentHash: sha256(buf),
+        bytes: buf.byteLength,
+    };
+}
+/**
+ * 从磁盘读取文档内容。
+ *
+ * @param domainId - 域 ID
+ * @param relativePath - 文档的相对路径
+ * @returns 原始文本内容与内容的 SHA-256 哈希值
+ */
+export function readDocument(domainId, relativePath) {
+    const abs = resolveDocAbsolutePath(domainId, relativePath);
+    const buf = fs.readFileSync(abs);
+    return {
+        content: buf.toString("utf8"),
+        contentHash: sha256(buf),
+    };
+}
+/**
+ * 删除指定相对路径对应的文档文件。
+ *
+ * @param domainId - 域 ID
+ * @param relativePath - 要删除的文档相对路径
+ */
+export function deleteDocumentFile(domainId, relativePath) {
+    const abs = resolveDocAbsolutePath(domainId, relativePath);
+    if (fs.existsSync(abs)) {
+        fs.unlinkSync(abs);
+    }
+}
+/**
+ * 计算给定 Buffer 的 SHA-256 十六进制摘要。
+ */
+export function sha256(buf) {
+    return createHash("sha256").update(buf).digest("hex");
+}
+//# sourceMappingURL=file-store.js.map

package/dist/server/storage/file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.js","sourceRoot":"","sources":["../../../src/server/storage/file-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,kCAAkC;AAClC,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAQtC;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,YAAoB,EAAE,OAAe;IACnF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,GAAG,CAAC,UAAU,GAAG,aAAa,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,GAAG,GAAG,sBAAsB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC3D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC;QACxB,KAAK,EAAE,GAAG,CAAC,UAAU;KACtB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,YAAoB;IACjE,MAAM,GAAG,GAAG,sBAAsB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC7B,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC;KACzB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,YAAoB;IACvE,MAAM,GAAG,GAAG,sBAAsB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/server/storage/paths.js

@@ -0,0 +1,39 @@
+import path from "node:path";
+import { getConfig } from "../config/index.js";
+import { DocPathError, normaliseDocRelativePath as sharedNormaliseDocRelativePath } from "../../shared/docPath.js";
+/** 存储路径相关错误，用于包装共享模块抛出的路径异常。 */
+export class StoragePathError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "StoragePathError";
+    }
+}
+/**
+ * 规范化文档相对路径。
+ * 调用共享模块的实现，并将 DocPathError 转换为 StoragePathError 抛出。
+ */
+export function normaliseDocRelativePath(input) {
+    try {
+        return sharedNormaliseDocRelativePath(input);
+    }
+    catch (e) {
+        if (e instanceof DocPathError)
+            throw new StoragePathError(e.message);
+        throw e;
+    }
+}
+/**
+ * 将相对路径解析为 docsDir 下的绝对路径。
+ * 解析后会校验结果是否仍在 docsDir 内部，防止路径穿越。
+ */
+export function resolveDocAbsolutePath(domainId, relativePath) {
+    const cfg = getConfig();
+    const safe = normaliseDocRelativePath(relativePath);
+    const abs = path.resolve(cfg.docsDir, domainId, safe);
+    // 校验解析后的路径未逃逸出该域的文档根目录
+    if (!abs.startsWith(path.resolve(cfg.docsDir, domainId) + path.sep)) {
+        throw new StoragePathError("resolved path escapes domain root");
+    }
+    return abs;
+}
+//# sourceMappingURL=paths.js.map

package/dist/server/storage/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/server/storage/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,wBAAwB,IAAI,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEnH,gCAAgC;AAChC,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,IAAI,CAAC;QACH,OAAO,8BAA8B,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,YAAY;YAAE,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,YAAoB;IAC3E,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,uBAAuB;IACvB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,gBAAgB,CAAC,mCAAmC,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/server/test-utils/lexical-structure-compare.js

@@ -0,0 +1,89 @@
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/** 从 code 节点取出可比较的源码字符串（兼容 `code` 字段与 `children`+text） */
+export function extractCodeSource(node) {
+    if (node.type !== "code")
+        return "";
+    if (typeof node.code === "string")
+        return node.code;
+    const ch = node.children;
+    if (!Array.isArray(ch))
+        return "";
+    const parts = [];
+    for (const c of ch) {
+        if (isRecord(c) && c.type === "text" && typeof c.text === "string") {
+            parts.push(c.text);
+        }
+    }
+    return parts.join("");
+}
+function structuralChildren(node) {
+    if (node.type === "code") {
+        return [];
+    }
+    const ch = node.children;
+    return Array.isArray(ch) ? ch : [];
+}
+function diffNodes(golden, actual, path) {
+    const out = [];
+    if (!isRecord(golden) || !isRecord(actual)) {
+        out.push(`${path}: 期望 object，实际 ${typeof golden} / ${typeof actual}`);
+        return out;
+    }
+    const gType = golden.type;
+    const aType = actual.type;
+    if (gType !== aType) {
+        out.push(`${path}.type: 期望 ${String(gType)}，实际 ${String(aType)}`);
+        return out;
+    }
+    const typeStr = typeof gType === "string" ? gType : "";
+    if (typeStr === "text") {
+        const gt = golden.text;
+        const at = actual.text;
+        if (gt !== at) {
+            out.push(`${path}.text: 期望 ${JSON.stringify(gt)}，实际 ${JSON.stringify(at)}`);
+        }
+        return out;
+    }
+    if (typeStr === "code") {
+        const gs = extractCodeSource(golden);
+        const as = extractCodeSource(actual);
+        if (gs !== as) {
+            out.push(`${path}.code: 源码不一致`);
+            out.push(`  golden: ${JSON.stringify(gs)}`);
+            out.push(`  actual: ${JSON.stringify(as)}`);
+        }
+        return out;
+    }
+    const gKids = structuralChildren(golden);
+    const aKids = structuralChildren(actual);
+    if (gKids.length !== aKids.length) {
+        out.push(`${path}.children.length: 期望 ${gKids.length} 个子节点，实际 ${aKids.length} 个`);
+        const n = Math.min(gKids.length, aKids.length);
+        for (let i = 0; i < n; i++) {
+            out.push(...diffNodes(gKids[i], aKids[i], `${path}.children[${i}]`));
+        }
+        return out;
+    }
+    for (let i = 0; i < gKids.length; i++) {
+        out.push(...diffNodes(gKids[i], aKids[i], `${path}.children[${i}]`));
+    }
+    return out;
+}
+/**
+ * @param goldenDoc - Lobe 导出：`{ root: {...} }`
+ * @param actualDoc - markdownToLexicalJson 解析结果：`{ root: {...} }`
+ */
+export function compareLexicalStructure(goldenDoc, actualDoc) {
+    if (!isRecord(goldenDoc) || !isRecord(actualDoc)) {
+        return ["文档根: 期望值须为 `{ root }` object"];
+    }
+    const gRoot = goldenDoc.root;
+    const aRoot = actualDoc.root;
+    if (!isRecord(gRoot) || !isRecord(aRoot)) {
+        return ["文档根: golden 或 actual 缺少 .root"];
+    }
+    return diffNodes(gRoot, aRoot, "root");
+}
+//# sourceMappingURL=lexical-structure-compare.js.map

package/dist/server/test-utils/lexical-structure-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexical-structure-compare.js","sourceRoot":"","sources":["../../../src/server/test-utils/lexical-structure-compare.ts"],"names":[],"mappings":"AAMA,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,IAA6B;IAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACpD,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,kBAAkB,CAAC,IAA6B;IACvD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;IACzB,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,SAAS,CAAC,MAAe,EAAE,MAAe,EAAE,IAAY;IAC/D,MAAM,GAAG,GAA+B,EAAE,CAAC;IAE3C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,kBAAkB,OAAO,MAAM,MAAM,OAAO,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,aAAa,MAAM,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvD,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QACvB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QACvB,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,aAAa,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,cAAc,CAAC,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5C,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,GAAG,CAAC,IAAI,CACN,GAAG,IAAI,wBAAwB,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,MAAM,IAAI,CACxE,CAAC;QACF,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAkB,EAClB,SAAkB;IAElB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC;IAC7B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/server/test-utils/lexical-structure-compare.test.js

@@ -0,0 +1,93 @@
+/**
+ * 结构对比器自检（与业务代码无关）。
+ */
+import { describe, expect, it } from "vitest";
+import { compareLexicalStructure, extractCodeSource, } from "./lexical-structure-compare.js";
+describe("compareLexicalStructure", () => {
+    it("完全一致时无差异", () => {
+        const doc = {
+            root: {
+                type: "root",
+                direction: "ltr",
+                format: "",
+                indent: 0,
+                version: 1,
+                children: [
+                    {
+                        type: "heading",
+                        tag: "h1",
+                        direction: "ltr",
+                        format: "",
+                        indent: 0,
+                        version: 1,
+                        children: [
+                            {
+                                type: "text",
+                                text: "Hi",
+                                version: 1,
+                                format: 0,
+                                detail: 0,
+                                mode: "normal",
+                                style: "",
+                            },
+                        ],
+                    },
+                ],
+            },
+        };
+        expect(compareLexicalStructure(doc, doc)).toEqual([]);
+    });
+    it("text 内容不同则报告", () => {
+        const a = {
+            root: { type: "root", children: [{ type: "paragraph", children: [{ type: "text", text: "x" }] }] },
+        };
+        const b = {
+            root: { type: "root", children: [{ type: "paragraph", children: [{ type: "text", text: "y" }] }] },
+        };
+        expect(compareLexicalStructure(a, b).some((s) => s.includes(".text"))).toBe(true);
+    });
+    it("子节点个数不同则报告", () => {
+        const a = {
+            root: { type: "root", children: [{ type: "paragraph", children: [{ type: "text", text: "a" }] }] },
+        };
+        const b = {
+            root: {
+                type: "root",
+                children: [
+                    {
+                        type: "paragraph",
+                        children: [
+                            { type: "text", text: "a" },
+                            { type: "text", text: "b" },
+                        ],
+                    },
+                ],
+            },
+        };
+        expect(compareLexicalStructure(a, b).some((s) => s.includes("children.length"))).toBe(true);
+    });
+    it("code：golden 用 code 字段、actual 用 children text 时只比源码", () => {
+        const golden = {
+            root: {
+                type: "root",
+                children: [{ type: "code", code: "console.log(1);", language: "js", version: 1 }],
+            },
+        };
+        const actual = {
+            root: {
+                type: "root",
+                children: [
+                    {
+                        type: "code",
+                        language: "js",
+                        children: [{ type: "text", text: "console.log(1);" }],
+                    },
+                ],
+            },
+        };
+        expect(compareLexicalStructure(golden, actual)).toEqual([]);
+        const codeNode = golden.root.children[0];
+        expect(extractCodeSource(codeNode)).toBe("console.log(1);");
+    });
+});
+//# sourceMappingURL=lexical-structure-compare.test.js.map

package/dist/server/test-utils/lexical-structure-compare.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexical-structure-compare.test.js","sourceRoot":"","sources":["../../../src/server/test-utils/lexical-structure-compare.test.ts"],"names":[],"mappings":"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"}

package/dist/server/test-utils/markdown-vs-lobe-golden.test.js

@@ -0,0 +1,35 @@
+/**
+ * Lobe Lexical golden（fixtures）与 markdown→Lexical 的差异清单；仅测试用。
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { markdownToLexicalJson } from "../documents/markdown-to-lexical.js";
+import { compareLexicalStructure } from "./lexical-structure-compare.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const LOBE_GOLDEN = JSON.parse(readFileSync(join(__dirname, "fixtures/lobe-playground.lexical-golden.json"), "utf8"));
+/** 与 golden fixture 对应的 Markdown（playground 正文） */
+export const PLAYGROUND_MARKDOWN = `# Welcome to the Lobe Editor Demo!
+> In case the black box at the bottom is – it's the debug view, showing the current state of the editor. You can disable it by pressing on the settings control in the bottom-left of your screen and toggling the debug view setting.
+
+The playground is a demo environment built with \`@lobehub/editor\`. Try typing in **some text** with *different formats*.
+- Visit the [Lobe Editor website](https://editor.lobehub.com) for documentation and more information.
+- Check out the code on our [GitHub repository](https://github.com/lobehub/lobe-editor).
+- Playground code [Playground code](https://github.com/lobehub/lobe-editor/blob/master/src/react/Editor/demos/index.tsx) can be found here.
+- Join our [Discover Server](https://discord.gg/AYFPHvv2jT) and chat with the team.
+
+Lastly, we're constantly adding cool new features to this playground. So make sure you check back here when you next get a chance 🙂.
+
+\`\`\`typescript
+import { Editor } from '@lobehub/editor';
+\`\`\`
+`;
+describe("Markdown 解析结果 vs Lobe Lexical golden 结构", () => {
+    it("结构差异清单（子节点个数、type、text 严格对齐；code 仅比源码）", () => {
+        const actual = JSON.parse(markdownToLexicalJson(PLAYGROUND_MARKDOWN));
+        const diff = compareLexicalStructure(LOBE_GOLDEN, actual);
+        expect(diff.join("\n")).toMatchSnapshot();
+    });
+});
+//# sourceMappingURL=markdown-vs-lobe-golden.test.js.map

package/dist/server/test-utils/markdown-vs-lobe-golden.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-vs-lobe-golden.test.js","sourceRoot":"","sources":["../../../src/server/test-utils/markdown-vs-lobe-golden.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,8CAA8C,CAAC,EAAE,MAAM,CAAC,CAC3E,CAAC;AAEb,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;CAclC,CAAC;AAEF,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,mBAAmB,CAAC,CAAY,CAAC;QACjF,MAAM,IAAI,GAAG,uBAAuB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/shared/docPath.js

@@ -0,0 +1,45 @@
+/** Same rules as server `normaliseDocRelativePath` (no Node `path` dependency). */
+export class DocPathError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DocPathError";
+    }
+}
+const RELATIVE_PATH_RX = /^[A-Za-z0-9_\-./\u4e00-\u9fa5]+$/;
+function posixNormalize(raw) {
+    const stack = [];
+    for (const seg of raw.split("/")) {
+        if (seg === "" || seg === ".")
+            continue;
+        if (seg === "..") {
+            if (stack.length)
+                stack.pop();
+        }
+        else
+            stack.push(seg);
+    }
+    return stack.join("/");
+}
+export function normaliseDocRelativePath(input) {
+    const raw = input.trim();
+    if (!raw)
+        throw new DocPathError("relative path is required");
+    if (raw.startsWith("/"))
+        throw new DocPathError("path must be relative");
+    if (raw.includes("\\"))
+        throw new DocPathError("use forward slashes");
+    if (raw.includes(".."))
+        throw new DocPathError("path must not contain ..");
+    if (!raw.toLowerCase().endsWith(".md")) {
+        throw new DocPathError("document path must end with .md");
+    }
+    if (!RELATIVE_PATH_RX.test(raw)) {
+        throw new DocPathError("path contains unsupported characters");
+    }
+    const norm = posixNormalize(raw);
+    if (norm.startsWith("..") || norm.startsWith("/")) {
+        throw new DocPathError("path escapes docs root");
+    }
+    return norm;
+}
+//# sourceMappingURL=docPath.js.map

package/dist/shared/docPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docPath.js","sourceRoot":"","sources":["../../src/shared/docPath.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AAE5D,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG;YAAE,SAAS;QACxC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,IAAI,KAAK,CAAC,MAAM;gBAAE,KAAK,CAAC,GAAG,EAAE,CAAC;QAChC,CAAC;;YAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,YAAY,CAAC,2BAA2B,CAAC,CAAC;IAC9D,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,uBAAuB,CAAC,CAAC;IACzE,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,qBAAqB,CAAC,CAAC;IACtE,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAC3E,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,YAAY,CAAC,iCAAiC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,YAAY,CAAC,sCAAsC,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,YAAY,CAAC,wBAAwB,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/shared/domainUi.js

@@ -0,0 +1,13 @@
+export const DEFAULT_DOMAIN_ID = "default";
+export const DOMAIN_PERMISSIONS = ["public", "restricted", "private"];
+export function isBuiltInDomainId(domainId) {
+    return domainId === DEFAULT_DOMAIN_ID;
+}
+export function isDomainCreator(d, visitorId) {
+    return visitorId !== null && d.creatorVisitorId === visitorId;
+}
+/** Rename / change permission / delete blocked when domain has documents (server + UI). */
+export function isDomainStructurallyLocked(d) {
+    return d.docCount > 0;
+}
+//# sourceMappingURL=domainUi.js.map

package/dist/shared/domainUi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domainUi.js","sourceRoot":"","sources":["../../src/shared/domainUi.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAkB,CAAC;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAU,CAAC;AAI/E,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,KAAK,iBAAiB,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAgB,EAAE,SAAwB;IACxE,OAAO,SAAS,KAAK,IAAI,IAAI,CAAC,CAAC,gBAAgB,KAAK,SAAS,CAAC;AAChE,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,0BAA0B,CAAC,CAAgB;IACzD,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/shared/folderDesc.js

@@ -0,0 +1,7 @@
+/** Reserved filename for per-folder description (hidden in tree, opened when folder is selected). */
+export const FOLDER_DESC_FILENAME = "___desc___.md";
+export function folderDescPathForFolder(folderPath) {
+    const p = folderPath.trim();
+    return p ? `${p}/${FOLDER_DESC_FILENAME}` : FOLDER_DESC_FILENAME;
+}
+//# sourceMappingURL=folderDesc.js.map

package/dist/shared/folderDesc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folderDesc.js","sourceRoot":"","sources":["../../src/shared/folderDesc.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAEpD,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC;AACnE,CAAC"}

package/dist/shared/personalDomain.js

@@ -0,0 +1,20 @@
+/** Personal workspace: `domain_id === visitor_id`, storage paths prefixed with `${visitorId}/`. */
+export const PERSONAL_DOMAIN_NAME_SUFFIX = "个人域";
+const MAX_DOMAIN_NAME_LEN = 200;
+export function personalDomainDisplayName(visitorName) {
+    const n = visitorName.trim() + PERSONAL_DOMAIN_NAME_SUFFIX;
+    return n.length <= MAX_DOMAIN_NAME_LEN ? n : n.slice(0, MAX_DOMAIN_NAME_LEN);
+}
+/** Strip leading `${domainId}/` when present (tree + client paths are domain-relative). */
+export function stripDomainPathPrefix(domainId, storedRelativePath) {
+    const pre = `${domainId}/`;
+    return storedRelativePath.startsWith(pre) ? storedRelativePath.slice(pre.length) : storedRelativePath;
+}
+/** Prefix user path for DB + disk when writing into personal domain. */
+export function prefixPersonalDomainStoragePath(visitorId, userNormalisedPath) {
+    const pre = `${visitorId}/`;
+    if (userNormalisedPath.startsWith(pre))
+        return userNormalisedPath;
+    return `${pre}${userNormalisedPath}`;
+}
+//# sourceMappingURL=personalDomain.js.map

package/dist/shared/personalDomain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personalDomain.js","sourceRoot":"","sources":["../../src/shared/personalDomain.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAEnG,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAEjD,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,2BAA2B,CAAC;IAC3D,OAAO,CAAC,CAAC,MAAM,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAC/E,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,kBAA0B;IAChF,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,CAAC;IAC3B,OAAO,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;AACxG,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,+BAA+B,CAAC,SAAiB,EAAE,kBAA0B;IAC3F,MAAM,GAAG,GAAG,GAAG,SAAS,GAAG,CAAC;IAC5B,IAAI,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAClE,OAAO,GAAG,GAAG,GAAG,kBAAkB,EAAE,CAAC;AACvC,CAAC"}

package/dist/shared/storagePath.js

@@ -0,0 +1,88 @@
+/**
+ * Storage path normalisation (shared by server and web).
+ * Persisted `relative_path` uses slugged segments; human-facing labels use `display_name` / UI copy.
+ */
+import { DocPathError } from "./docPath.js";
+const DISPLAY_FOLDER_MAX = 120;
+const DISPLAY_FILE_MAX = 200;
+/**
+ * One path segment (directory name or `.md` filename stem) safe for storage / RELATIVE_PATH_RX.
+ */
+export function normalisePathSegmentForStorage(raw) {
+    let t = raw.trim().replace(/\s+/g, "_");
+    t = t.replace(/[^A-Za-z0-9_\-\.\u4e00-\u9fa5]/g, "_");
+    t = t.replace(/_+/g, "_");
+    t = t.replace(/^[._]+|[._]+$/g, "");
+    while (t.includes("..")) {
+        t = t.replace(/\.\./g, "_");
+    }
+    if (t === "." || t === ".." || !t)
+        return "";
+    return t;
+}
+/** Validate a single folder label (display); storage path uses {@link normalisePathSegmentForStorage}. */
+export function parseDisplayNameFolder(raw) {
+    const t = raw.trim();
+    if (!t)
+        return { ok: false, message: "enter a folder name" };
+    if (t.includes("/") || t.includes("\\"))
+        return { ok: false, message: "use a single name, not a path" };
+    if (t === "." || t === "..")
+        return { ok: false, message: "invalid folder name" };
+    if (t.length > DISPLAY_FOLDER_MAX)
+        return { ok: false, message: "folder name is too long" };
+    return { ok: true, display: t };
+}
+/**
+ * Validate a markdown filename the user typed (one segment, may omit `.md` before normalise elsewhere).
+ * Returns trimmed display filename ending with `.md`.
+ */
+export function parseDisplayNameMarkdownFile(raw) {
+    let t = raw.trim();
+    if (!t)
+        return { ok: false, message: "enter a file name" };
+    if (t.includes("/") || t.includes("\\"))
+        return { ok: false, message: "use a file name, not a path" };
+    if (t === "." || t === "..")
+        return { ok: false, message: "invalid file name" };
+    if (!t.toLowerCase().endsWith(".md"))
+        t += ".md";
+    if (t.length > DISPLAY_FILE_MAX)
+        return { ok: false, message: "file name is too long" };
+    return { ok: true, displayFile: t };
+}
+/**
+ * Normalise every `/`-separated segment for storage (dirs + final `.md` stem).
+ * Last segment must end with `.md`; extension casing preserved as input segment.
+ */
+export function normaliseRelativePathForStorage(raw) {
+    const t = raw.trim().replace(/\\/g, "/");
+    if (!t)
+        throw new DocPathError("relative path is required");
+    if (t.startsWith("/"))
+        throw new DocPathError("path must be relative");
+    if (t.includes(".."))
+        throw new DocPathError("path must not contain ..");
+    const parts = t.split("/").filter((p) => p.length > 0);
+    if (parts.length === 0)
+        throw new DocPathError("relative path is required");
+    const out = [];
+    for (let i = 0; i < parts.length - 1; i += 1) {
+        const s = normalisePathSegmentForStorage(parts[i]);
+        if (!s)
+            throw new DocPathError("invalid path segment");
+        out.push(s);
+    }
+    const last = parts[parts.length - 1];
+    if (!last.toLowerCase().endsWith(".md")) {
+        throw new DocPathError("document path must end with .md");
+    }
+    const stem = last.slice(0, -3);
+    const suffix = last.slice(-3);
+    const ns = normalisePathSegmentForStorage(stem);
+    if (!ns)
+        throw new DocPathError("invalid file name");
+    out.push(ns + suffix);
+    return out.join("/");
+}
+//# sourceMappingURL=storagePath.js.map

package/dist/shared/storagePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storagePath.js","sourceRoot":"","sources":["../../src/shared/storagePath.ts"],"names":[],"mappings":"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"}

package/dist/shared/types/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/dist/shared/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/shared/types/api.ts"],"names":[],"mappings":""}

package/dist/shared/types/diagram.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagram.js.map

package/dist/shared/types/diagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram.js","sourceRoot":"","sources":["../../../src/shared/types/diagram.ts"],"names":[],"mappings":""}

package/dist/shared/types/document.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document.js.map

package/dist/shared/types/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/shared/types/document.ts"],"names":[],"mappings":""}

package/dist/shared/types/domain.js

@@ -0,0 +1,3 @@
+/** Private-type domains: exactly one domain member (the domain owner). No multi-member list. */
+export const PRIVATE_DOMAIN_MAX_MEMBERS = 1;
+//# sourceMappingURL=domain.js.map

package/dist/shared/types/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../../src/shared/types/domain.ts"],"names":[],"mappings":"AAmCA,gGAAgG;AAChG,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAU,CAAC"}

package/dist/shared/types/domainMemberTemplate.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domainMemberTemplate.js.map

package/dist/shared/types/domainMemberTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domainMemberTemplate.js","sourceRoot":"","sources":["../../../src/shared/types/domainMemberTemplate.ts"],"names":[],"mappings":""}

package/dist/shared/types/tree.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tree.js.map

package/dist/shared/types/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../src/shared/types/tree.ts"],"names":[],"mappings":""}

package/dist/shared/types/visitor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=visitor.js.map

package/dist/shared/types/visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor.js","sourceRoot":"","sources":["../../../src/shared/types/visitor.ts"],"names":[],"mappings":""}