wendang 0.0.1 → 0.1.0

package/dist/cjs/shared/mind-map.js

@@ -0,0 +1,445 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIND_MAP_PALETTE = exports.mindMapId = exports.MIND_MAP_THEMES = exports.MIND_MAP_LAYOUTS = exports.MIND_MAP_MAX_TEXT = exports.MIND_MAP_MAX_TOPICS = exports.MIND_MAP_VERSION = void 0;
+exports.createMindMap = createMindMap;
+exports.readMindMap = readMindMap;
+exports.mindMapTree = mindMapTree;
+exports.mindMapDescendants = mindMapDescendants;
+exports.canMoveMindTopic = canMoveMindTopic;
+exports.mindMapBranchSides = mindMapBranchSides;
+exports.projectMindSideMove = projectMindSideMove;
+exports.textDifference = textDifference;
+exports.layoutMindMap = layoutMindMap;
+exports.mindMapSvg = mindMapSvg;
+exports.mindMapOutline = mindMapOutline;
+exports.mindMapMarkdown = mindMapMarkdown;
+exports.mindRelationPaths = mindRelationPaths;
+exports.mindMapToJson = mindMapToJson;
+const safe_href_js_1 = require("./safe-href.js");
+const presence_js_1 = require("./presence.js");
+const mind_topic_text_js_1 = require("./mind-topic-text.js");
+/** Engine-independent document format. Topic text remains ordinary ProseMirror text. */
+exports.MIND_MAP_VERSION = 3;
+exports.MIND_MAP_MAX_TOPICS = 500;
+exports.MIND_MAP_MAX_TEXT = 2000;
+exports.MIND_MAP_LAYOUTS = ['right', 'left', 'both', 'down'];
+exports.MIND_MAP_THEMES = ['blue', 'teal', 'violet', 'amber'];
+const mindMapId = () => crypto.randomUUID();
+exports.mindMapId = mindMapId;
+const validId = (id) => typeof id === 'string' && /^[\w-]{1,80}$/.test(id);
+function createMindMap(layout = 'right') {
+    const id = (0, exports.mindMapId)(), rootId = (0, exports.mindMapId)();
+    return {
+        type: 'mindMap', attrs: { id, rootId, formatVersion: exports.MIND_MAP_VERSION, layout, theme: 'blue', height: 380 },
+        content: [
+            { type: 'mindMapTopic', attrs: { id: rootId, parentId: '', order: 0 }, content: [{ type: 'text', text: '中心主题' }] },
+            ...['分支主题 1', '分支主题 2', '分支主题 3'].map((text, order) => ({
+                type: 'mindMapTopic', attrs: { id: (0, exports.mindMapId)(), parentId: rootId, order },
+                content: [{ type: 'text', text }],
+            })),
+        ],
+    };
+}
+function readMindMap(node) {
+    const a = node?.attrs;
+    if (node?.type !== 'mindMap' || !a || ![1, 2, exports.MIND_MAP_VERSION].includes(Number(a.formatVersion)) ||
+        !validId(a.id) || !validId(a.rootId) || !Array.isArray(node.content) ||
+        node.content.length < 1 || node.content.filter(t => t?.type === 'mindMapTopic').length > exports.MIND_MAP_MAX_TOPICS || node.content.length > 1500)
+        return null;
+    const topics = [];
+    const ids = new Set();
+    for (const topic of node.content.filter(t => t?.type !== 'mindMapRelation')) {
+        if (!topic || typeof topic !== 'object')
+            return null;
+        const t = topic.attrs;
+        if (topic.type !== 'mindMapTopic' || !t || !validId(t.id) || ids.has(t.id) ||
+            typeof t.parentId !== 'string' || (t.parentId !== '' && !validId(t.parentId)) ||
+            typeof t.order !== 'number' || !Number.isFinite(t.order) ||
+            Math.abs(t.order) > 1e12 || (topic.content !== undefined && !Array.isArray(topic.content)) ||
+            topic.content?.some(c => !c || !['text', 'mindMapDescription', 'mindMapNote'].includes(c.type ?? '') || (c.type === 'text' && typeof c.text !== 'string')))
+            return null;
+        const text = (topic.content ?? []).filter(c => c.type === 'text').map(c => c.text ?? '').join('');
+        if (text.length > exports.MIND_MAP_MAX_TEXT)
+            return null;
+        ids.add(t.id);
+        const extra = {};
+        if (t.color && !/^#[0-9a-f]{6}$/i.test(String(t.color)))
+            return null;
+        if (t.background && !/^#[0-9a-f]{6}$/i.test(String(t.background)))
+            return null;
+        for (const key of ['color', 'background'])
+            if (t[key] && !['#18243a', '#ffffff', '#3864ef', '#087f8c', '#7950c7', '#a66b08', '#d94848', '#f3f5fb', '#dce7ff', '#d3f4e9', '#ece0ff', '#fff0c2', '#ffe1e1', '#233044'].includes(String(t[key])))
+                return null;
+        if (t.shape && !['round', 'pill', 'text'].includes(String(t.shape)))
+            return null;
+        if (t.fontSize && ![12, 14, 16, 18, 20].includes(Number(t.fontSize)))
+            return null;
+        if (t.align && !['left', 'center', 'right'].includes(String(t.align)))
+            return null;
+        if (t.done !== undefined && t.done !== null && typeof t.done !== 'boolean')
+            return null;
+        if (t.side !== undefined && t.side !== null && t.side !== -1 && t.side !== 1)
+            return null;
+        if (t.icon && !['💡', '🎯', '📌', '🚩', '⭐', '✅', '⚠️', '💬', '📅', '🔎'].includes(String(t.icon)))
+            return null;
+        if (t.attachmentId && !(typeof t.attachmentId === 'string' && /^[0-9a-f-]{36}$/i.test(t.attachmentId)))
+            return null;
+        const fields = new Set();
+        let fieldsStarted = false, noteStarted = false;
+        for (const child of topic.content ?? []) {
+            if (child.marks !== undefined && (!Array.isArray(child.marks) || child.marks.some(m => !m || !['bold', 'italic', 'strike', 'textStyle', 'highlight', 'link'].includes(m.type))))
+                return null;
+            if (child.type !== 'text' && ((child.content !== undefined && !Array.isArray(child.content)) || child.content?.some(n => n.type !== 'text' || typeof n.text !== 'string') || (child.content ?? []).reduce((sum, n) => sum + (n.text?.length ?? 0), 0) > 4000))
+                return null;
+            if (child.type === 'text' && fieldsStarted)
+                return null;
+            if (child.type !== 'text') {
+                if (fields.has(child.type) || (child.type === 'mindMapDescription' && noteStarted))
+                    return null;
+                fields.add(child.type);
+                fieldsStarted = true;
+                if (child.type === 'mindMapNote')
+                    noteStarted = true;
+            }
+        }
+        for (const key of ['shape', 'color', 'background', 'fontSize', 'align', 'icon', 'done', 'attachmentId', 'side'])
+            if (t[key] !== undefined && t[key] !== null && t[key] !== '')
+                Object.assign(extra, { [key]: t[key] });
+        const runs = (topic.content ?? []).filter(c => c.type === 'text').map(c => ({ text: c.text ?? '', ...(c.marks?.length ? { marks: c.marks } : {}) }));
+        if (runs.some(r => r.marks?.length))
+            extra.runs = runs;
+        for (const [type, key] of [['mindMapDescription', 'description'], ['mindMapNote', 'note']]) {
+            const child = topic.content?.find(c => c.type === type);
+            if (child)
+                extra[key] = (child.content ?? []).map(c => c.text ?? '').join('');
+        }
+        topics.push({ id: t.id, parentId: t.parentId, order: t.order, text, ...extra });
+    }
+    if (!ids.has(a.rootId))
+        return null;
+    const relations = node.content.filter(c => c.type === 'mindMapRelation');
+    const relationIds = new Set();
+    for (const r of relations) {
+        const p = r.attrs;
+        if (!p || !validId(p.id) || ids.has(p.id) || relationIds.has(p.id) || !validId(p.source) || !validId(p.target) ||
+            p.source === p.target || !['related', 'depends', 'reference'].includes(String(p.kind)) ||
+            typeof p.label !== 'string' || p.label.length > 200)
+            return null;
+        relationIds.add(p.id);
+    }
+    return {
+        id: a.id, rootId: a.rootId, topics,
+        ...(a.branchStyle ? { branchStyle: a.branchStyle } : {}),
+        ...(node.content.some(c => c.type === 'mindMapRelation') ? { relations: node.content.filter(c => c.type === 'mindMapRelation').map(c => ({ ...c.attrs })) } : {}),
+        layout: exports.MIND_MAP_LAYOUTS.includes(a.layout) ? a.layout : 'right',
+        theme: exports.MIND_MAP_THEMES.includes(a.theme) ? a.theme : 'blue',
+        height: typeof a.height === 'number' && Number.isFinite(a.height) ? Math.min(800, Math.max(240, a.height)) : 380,
+    };
+}
+/** Missing parents and concurrent cycles keep every surviving topic, deterministically. */
+function mindMapTree(model) {
+    const topics = model.topics.map(t => ({ ...t }));
+    const byId = new Map(topics.map(t => [t.id, t]));
+    for (const t of topics) {
+        if (t.id === model.rootId)
+            t.parentId = '';
+        else if (!byId.has(t.parentId) || t.parentId === t.id)
+            t.parentId = model.rootId;
+    }
+    for (const start of [...topics].sort((a, b) => a.id.localeCompare(b.id))) {
+        const path = [], seen = new Set();
+        let current = start;
+        while (current && current.id !== model.rootId) {
+            if (seen.has(current.id)) {
+                const cycle = path.slice(path.indexOf(current.id)).sort();
+                byId.get(cycle[0]).parentId = model.rootId;
+                break;
+            }
+            seen.add(current.id);
+            path.push(current.id);
+            current = byId.get(current.parentId);
+        }
+    }
+    return topics.sort((a, b) => a.order - b.order || a.id.localeCompare(b.id));
+}
+function mindMapDescendants(model, id) {
+    const tree = mindMapTree(model), ids = new Set([id]);
+    for (let changed = true; changed;) {
+        changed = false;
+        for (const t of tree)
+            if (ids.has(t.parentId) && !ids.has(t.id)) {
+                ids.add(t.id);
+                changed = true;
+            }
+    }
+    return ids;
+}
+function canMoveMindTopic(model, id, parentId) {
+    return id !== model.rootId && model.topics.some(t => t.id === id) &&
+        model.topics.some(t => t.id === parentId) && !mindMapDescendants(model, id).has(parentId);
+}
+/** Only first-level topics own a side; all descendants inherit their branch direction. */
+function mindMapBranchSides(model) {
+    return new Map(mindMapTree(model).filter(t => t.parentId === model.rootId).map((t, i) => [t.id, model.layout === 'left' ? -1 : model.layout === 'both' ? t.side ?? (i % 2 ? -1 : 1) : 1]));
+}
+/** Shared by the live drop preview and the single document transaction on release. */
+function projectMindSideMove(model, id, side, beforeId) {
+    if (model.layout === 'down' || (side !== -1 && side !== 1) || !canMoveMindTopic(model, id, model.rootId))
+        return null;
+    const sides = mindMapBranchSides(model);
+    const siblings = mindMapTree(model).filter(t => t.parentId === model.rootId && t.id !== id && sides.get(t.id) === side);
+    const index = beforeId ? siblings.findIndex(t => t.id === beforeId) : siblings.length;
+    if (index < 0)
+        return null;
+    const order = siblings.map(t => t.id);
+    order.splice(index, 0, id);
+    const orders = new Map(order.map((key, i) => [key, i * 1024]));
+    return { ...model, layout: 'both', topics: model.topics.map(t => t.id === id
+            ? { ...t, parentId: model.rootId, side, order: orders.get(id) }
+            : t.parentId === model.rootId ? { ...t, side: sides.get(t.id), order: orders.get(t.id) ?? t.order } : t) };
+}
+function textDifference(before, after) {
+    let from = 0, tail = 0;
+    while (from < before.length && from < after.length && before[from] === after[from])
+        from++;
+    // Do not split surrogate pairs when inserting/removing emoji.
+    if (from > 0 && /[\uD800-\uDBFF]/.test(before[from - 1]))
+        from--;
+    while (tail < before.length - from && tail < after.length - from &&
+        before[before.length - tail - 1] === after[after.length - tail - 1])
+        tail++;
+    if (tail > 0 && /[\uDC00-\uDFFF]/.test(before[before.length - tail]))
+        tail--;
+    return { from, to: before.length - tail, text: after.slice(from, after.length - tail) };
+}
+function wrapTopic(text, maxUnits = 14) {
+    const lines = [];
+    for (const line of (text || '未命名主题').split('\n')) {
+        let part = '', units = 0;
+        for (const ch of line) {
+            const size = /[\u0000-\u00ff]/.test(ch) ? 0.6 : 1;
+            if (units + size > maxUnits) {
+                lines.push(part);
+                part = '';
+                units = 0;
+            }
+            part += ch;
+            units += size;
+        }
+        lines.push(part || ' ');
+    }
+    return lines;
+}
+function layoutMindMap(model, collapsed = new Set()) {
+    const tree = mindMapTree(model), byParent = new Map();
+    for (const t of tree) {
+        const list = byParent.get(t.parentId) ?? [];
+        list.push(t);
+        byParent.set(t.parentId, list);
+    }
+    const root = tree.find(t => t.id === model.rootId);
+    const dimensions = new Map(tree.map(t => {
+        const measured = (0, mind_topic_text_js_1.mindTopicTextSize)(t.text, t.fontSize || 14, t.id === root.id, t.description || '', !!t.runs?.some(r => r.marks?.some(m => m.type === 'bold')), t.attachmentId ? 180 : 0);
+        return [t.id, { lines: measured.lines, width: measured.width,
+                height: Math.max(44, measured.titleHeight + 22) + (t.description ? measured.descriptionLines.length * 18 + 6 : 0) +
+                    (t.attachmentId ? 104 : 0) + (t.icon || t.done ? 20 : 0) + (t.note ? 20 : 0) }];
+    }));
+    const kids = (id) => collapsed.has(id) ? [] : byParent.get(id) ?? [];
+    const nodes = [];
+    const span = (t) => Math.max(model.layout === 'down' ? dimensions.get(t.id).width : dimensions.get(t.id).height, kids(t.id).reduce((n, c) => n + span(c) + 20, -20));
+    const place = (t, x, y, side) => {
+        const d = dimensions.get(t.id);
+        nodes.push({ ...t, ...d, x, y, side });
+        const children = kids(t.id), total = children.reduce((n, c) => n + span(c) + 20, -20);
+        let cursor = (model.layout === 'down' ? x + d.width / 2 : y + d.height / 2) - total / 2;
+        for (const c of children) {
+            const cd = dimensions.get(c.id), s = span(c);
+            if (model.layout === 'down')
+                place(c, cursor + s / 2 - cd.width / 2, y + d.height + 60, side);
+            else
+                place(c, side === 1 ? x + d.width + 64 : x - cd.width - 64, cursor + s / 2 - cd.height / 2, side);
+            cursor += s + 20;
+        }
+    };
+    if (model.layout === 'both') {
+        const d = dimensions.get(root.id);
+        nodes.push({ ...root, ...d, x: 0, y: 0, side: 1 });
+        const children = kids(root.id);
+        const sides = mindMapBranchSides(model);
+        for (const side of [-1, 1]) {
+            const branches = children.filter(c => sides.get(c.id) === side);
+            let cursor = d.height / 2 - branches.reduce((n, c) => n + span(c) + 20, -20) / 2;
+            for (const c of branches) {
+                const cd = dimensions.get(c.id), s = span(c);
+                place(c, side === 1 ? d.width + 64 : -cd.width - 64, cursor + s / 2 - cd.height / 2, side);
+                cursor += s + 20;
+            }
+        }
+    }
+    else
+        place(root, 0, 0, model.layout === 'left' ? -1 : 1);
+    const placed = new Map(nodes.map(n => [n.id, n]));
+    const edges = nodes.filter(n => n.id !== root.id).map(n => {
+        const p = placed.get(n.parentId);
+        let x1, y1, x2, y2, path;
+        if (model.layout === 'down') {
+            x1 = p.x + p.width / 2;
+            y1 = p.y + p.height;
+            x2 = n.x + n.width / 2;
+            y2 = n.y;
+            path = `M${x1},${y1} C${x1},${(y1 + y2) / 2} ${x2},${(y1 + y2) / 2} ${x2},${y2}`;
+        }
+        else {
+            x1 = p.x + (n.side === 1 ? p.width : 0);
+            y1 = p.y + p.height / 2;
+            x2 = n.x + (n.side === 1 ? 0 : n.width);
+            y2 = n.y + n.height / 2;
+            path = `M${x1},${y1} C${(x1 + x2) / 2},${y1} ${(x1 + x2) / 2},${y2} ${x2},${y2}`;
+        }
+        if (model.branchStyle === 'straight')
+            path = `M${x1},${y1} L${x2},${y2}`;
+        if (model.branchStyle === 'step')
+            path = model.layout === 'down'
+                ? `M${x1},${y1} V${(y1 + y2) / 2} H${x2} V${y2}` : `M${x1},${y1} H${(x1 + x2) / 2} V${y2} H${x2}`;
+        return { id: `${p.id}-${n.id}`, source: p.id, target: n.id, path };
+    });
+    const relationBounds = (model.relations ?? []).flatMap(r => {
+        const a = placed.get(r.source), b = placed.get(r.target);
+        if (!a || !b)
+            return [];
+        const center = (a.x + a.width / 2 + b.x + b.width / 2) / 2, half = [...r.label].length * 7 / 2;
+        return [{ left: center - half, right: center + half, top: Math.min(a.y, b.y) - 68 }];
+    });
+    const x = Math.min(...nodes.map(n => n.x), ...relationBounds.map(r => r.left)) - 32, y = Math.min(...nodes.map(n => n.y), ...relationBounds.map(r => r.top)) - 32;
+    return { nodes, edges, bounds: { x, y,
+            width: Math.max(...nodes.map(n => n.x + n.width), ...relationBounds.map(r => r.right)) - x + 32,
+            height: Math.max(...nodes.map(n => n.y + n.height)) - y + 32 } };
+}
+exports.MIND_MAP_PALETTE = {
+    blue: '#3864ef', teal: '#087f8c', violet: '#7950c7', amber: '#a66b08',
+};
+const escapeXml = (s) => s.replace(/[&<>"']/g, ch => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&apos;' })[ch]);
+function svgRichLine(topic, line, offset) {
+    if (!topic.runs?.length)
+        return escapeXml(line);
+    const chars = [];
+    let position = offset;
+    for (const ch of line) {
+        let cursor = 0;
+        const run = topic.runs.find(r => { const start = cursor; cursor += r.text.length; return position >= start && position < cursor; });
+        const marks = run?.marks ?? [], style = [];
+        for (const m of marks) {
+            if (m.type === 'bold')
+                style.push('font-weight:700');
+            if (m.type === 'italic')
+                style.push('font-style:italic');
+            if (m.type === 'strike')
+                style.push('text-decoration:line-through');
+            if (m.type === 'link')
+                style.push('text-decoration:underline');
+            if (m.type === 'textStyle' && /^#[0-9a-f]{6}$/i.test(String(m.attrs?.color)))
+                style.push(`fill:${m.attrs.color}`);
+        }
+        chars.push(`<tspan${style.length ? ` style="${style.join(';')}"` : ''}>${escapeXml(ch)}</tspan>`);
+        position += ch.length;
+    }
+    return chars.join('');
+}
+function svgHighlights(topic, line, offset, x, y) {
+    if (!topic.runs?.some(r => r.marks?.some(m => m.type === 'highlight')))
+        return '';
+    const font = topic.fontSize || 14;
+    const width = (ch) => (/[\u0000-\u00ff]/.test(ch) ? 8 : 14) * font / 14;
+    const total = [...line].reduce((sum, ch) => sum + width(ch), 0);
+    let left = topic.align === 'left' ? x + 16 : topic.align === 'right' ? x + topic.width - total - 16 : x + (topic.width - total) / 2;
+    let position = offset;
+    const rects = [];
+    for (const ch of line) {
+        let cursor = 0;
+        const run = topic.runs.find(r => { const start = cursor; cursor += r.text.length; return position >= start && position < cursor; });
+        const color = run?.marks?.find(m => m.type === 'highlight')?.attrs?.color;
+        const w = width(ch);
+        if (/^#[0-9a-f]{6}$/i.test(String(color)))
+            rects.push(`<rect x="${left}" y="${y - font}" width="${w}" height="${font + 4}" rx="2" fill="${color}"/>`);
+        left += w;
+        position += ch.length;
+    }
+    return rects.join('');
+}
+function mindMapSvg(model, options = {}) {
+    const drawing = layoutMindMap(model), b = drawing.bounds, color = exports.MIND_MAP_PALETTE[model.theme];
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${b.x} ${b.y} ${b.width} ${b.height}" width="${Math.ceil(b.width)}" height="${Math.ceil(b.height)}">` +
+        (options.transparent ? '' : `<rect x="${b.x}" y="${b.y}" width="${b.width}" height="${b.height}" fill="#fff"/>`) +
+        drawing.edges.map(e => `<path d="${e.path}" fill="none" stroke="${color}" stroke-width="2"/>`).join('') +
+        drawing.nodes.map(n => {
+            const lineHeight = (0, mind_topic_text_js_1.mindTopicLineHeight)(n.fontSize || 14), baseline = 11 + (lineHeight - (n.fontSize || 14)) / 2 + (n.fontSize || 14) * .8;
+            const fill = n.background || (n.id === model.rootId ? color : '#f3f5fb');
+            const ink = n.color || (n.shape === 'text' ? '#25314a' : n.background ? (0, presence_js_1.readableTextColor)(n.background) : n.id === model.rootId ? '#fff' : '#25314a');
+            const description = n.description ? wrapTopic(n.description) : [];
+            const image = n.attachmentId && options.images?.[n.attachmentId];
+            return `<g>` + (n.shape === 'text' ? '' : `<rect x="${n.x}" y="${n.y}" width="${n.width}" height="${n.height}" rx="${n.shape === 'pill' ? 24 : 9}" fill="${escapeXml(fill)}" stroke="${color}" stroke-opacity=".3"/>`) +
+                (n.icon || n.done ? `<text x="${n.x + n.width / 2}" y="${n.y + 22}" text-anchor="middle" font-size="16">${n.done ? '☑ ' : ''}${escapeXml(n.icon || '')}</text>` : '') +
+                n.lines.map((line, i) => svgHighlights(n, line, n.lines.slice(0, i).reduce((sum, l) => sum + l.length, 0), n.x, n.y + baseline + i * lineHeight + (n.icon || n.done ? 20 : 0))).join('') +
+                n.lines.map((line, i) => `<text x="${n.x + (n.align === 'left' ? 16 : n.align === 'right' ? n.width - 16 : n.width / 2)}" y="${n.y + baseline + i * lineHeight + (n.icon || n.done ? 20 : 0)}" text-anchor="${n.align === 'left' ? 'start' : n.align === 'right' ? 'end' : 'middle'}" font-family="${escapeXml(mind_topic_text_js_1.MIND_TOPIC_FONT)}" font-size="${n.fontSize || 14}" fill="${escapeXml(ink)}">${svgRichLine(n, line, n.lines.slice(0, i).reduce((sum, l) => sum + l.length, 0))}</text>`).join('') +
+                description.map((line, i) => `<text x="${n.x + n.width / 2}" y="${n.y + 28 + n.lines.length * lineHeight + i * 18 + (n.icon || n.done ? 20 : 0)}" text-anchor="middle" font-size="12" fill="#677184">${escapeXml(line)}</text>`).join('') +
+                (n.note ? `<text x="${n.x + n.width / 2}" y="${n.y + n.height - (n.attachmentId ? 112 : 10)}" text-anchor="middle" font-size="10" fill="#677184">▤ 备注</text>` : '') +
+                (image && /^data:image\/(png|jpeg|webp|gif);base64,/.test(image) ? `<image x="${n.x + 10}" y="${n.y + n.height - 105}" width="${n.width - 20}" height="95" href="${image}" preserveAspectRatio="xMidYMid meet"/>` : '') + '</g>';
+        }).join('') + mindRelationPaths(model, drawing).map(r => `<path d="${r.path}" fill="none" stroke="#8b5fc7" stroke-width="2" stroke-dasharray="6 4"/><text x="${r.x}" y="${r.y}" font-size="12" fill="#7950c7">${escapeXml(r.label || ({ related: '相关', depends: '依赖', reference: '参考' }[r.kind]))}</text>`).join('') + '</svg>';
+}
+function mindMapOutline(model) {
+    const tree = mindMapTree(model), result = [];
+    const visit = (id, depth) => {
+        const topic = tree.find(t => t.id === id);
+        if (!topic)
+            return;
+        result.push({ ...topic, depth });
+        for (const child of tree.filter(t => t.parentId === id))
+            visit(child.id, depth + 1);
+    };
+    visit(model.rootId, 0);
+    return result;
+}
+function mindMapMarkdown(model) {
+    const escape = (value) => value.replace(/([\\`*_[\]<>])/g, '\\$1').replace(/\n/g, ' ');
+    return mindMapOutline(model).map(t => {
+        const title = (t.runs ?? [{ text: t.text }]).map(run => {
+            let value = escape(run.text);
+            for (const mark of run.marks ?? []) {
+                if (mark.type === 'bold')
+                    value = `**${value}**`;
+                if (mark.type === 'italic')
+                    value = `*${value}*`;
+                if (mark.type === 'strike')
+                    value = `~~${value}~~`;
+                if (mark.type === 'link' && (0, safe_href_js_1.isSafeHref)(mark.attrs?.href))
+                    value = `[${value}](${String(mark.attrs.href).replace(/[()]/g, ch => encodeURIComponent(ch))})`;
+            }
+            return value;
+        }).join('') || '未命名主题';
+        return `${'  '.repeat(t.depth)}- ${t.done ? '[x] ' : ''}${t.icon ? t.icon + ' ' : ''}${title}${t.description ? ' — ' + escape(t.description) : ''}${t.note ? '（备注：' + escape(t.note) + '）' : ''}${t.attachmentId ? ' [图片附件：' + t.attachmentId + ']' : ''}`;
+    }).join('\n') + ((model.relations?.length ?? 0) > 0 ? '\n\n关系：\n' + model.relations.map(r => `- ${escape(model.topics.find(t => t.id === r.source)?.text || '已移除主题')} → ${escape(model.topics.find(t => t.id === r.target)?.text || '已移除主题')}：${escape(r.label || r.kind)}`).join('\n') : '');
+}
+function mindRelationPaths(model, drawing) {
+    const nodes = new Map(drawing.nodes.map(n => [n.id, n]));
+    return (model.relations ?? []).flatMap(r => {
+        const a = nodes.get(r.source), b = nodes.get(r.target);
+        if (!a || !b || a === b)
+            return [];
+        const x1 = a.x + a.width / 2, y1 = a.y, x2 = b.x + b.width / 2, y2 = b.y;
+        const bend = Math.min(y1, y2) - 48;
+        return [{ ...r, path: `M${x1},${y1} C${x1},${bend} ${x2},${bend} ${x2},${y2}`, x: (x1 + x2) / 2, y: bend + 8 }];
+    });
+}
+function mindMapToJson(model, fresh = false) {
+    const ids = new Map(model.topics.map(t => [t.id, fresh ? (0, exports.mindMapId)() : t.id]));
+    return { type: 'mindMap', attrs: { id: fresh ? (0, exports.mindMapId)() : model.id, rootId: ids.get(model.rootId),
+            formatVersion: exports.MIND_MAP_VERSION, layout: model.layout, theme: model.theme, height: model.height, branchStyle: model.branchStyle || 'curve' },
+        content: [...model.topics.map(t => {
+                const { text, runs, description, note, ...attrs } = t;
+                return { type: 'mindMapTopic', attrs: { ...attrs, id: ids.get(t.id), parentId: ids.get(t.parentId) ?? '' },
+                    content: [...(runs ?? (text ? [{ text }] : [])).map(r => ({ type: 'text', ...r })),
+                        ...(description ? [{ type: 'mindMapDescription', content: [{ type: 'text', text: description }] }] : []),
+                        ...(note ? [{ type: 'mindMapNote', content: [{ type: 'text', text: note }] }] : [])] };
+            }), ...(model.relations ?? []).map(r => ({ type: 'mindMapRelation', attrs: { ...r,
+                    id: fresh ? (0, exports.mindMapId)() : r.id, source: ids.get(r.source), target: ids.get(r.target) } }))] };
+}

package/dist/cjs/shared/mind-topic-text.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIND_TOPIC_FONT = exports.MIND_TOPIC_PADDING = exports.mindTopicLineHeight = exports.MIND_TOPIC_LINE_HEIGHT = void 0;
+exports.setMindTextMeasureFactory = setMindTextMeasureFactory;
+exports.mindTextMeasure = mindTextMeasure;
+exports.wrapMindText = wrapMindText;
+exports.mindTopicTextSize = mindTopicTextSize;
+exports.MIND_TOPIC_LINE_HEIGHT = 22;
+const mindTopicLineHeight = (fontSize = 14) => Math.max(exports.MIND_TOPIC_LINE_HEIGHT, Math.ceil(fontSize * 1.4));
+exports.mindTopicLineHeight = mindTopicLineHeight;
+exports.MIND_TOPIC_PADDING = 34; // 16px * 2 padding + 1px * 2 borders.
+exports.MIND_TOPIC_FONT = '-apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif';
+const sizeCache = new Map();
+let factory;
+function setMindTextMeasureFactory(value) { factory = value; sizeCache.clear(); }
+/** Real browser font metrics; non-DOM exports/tests keep a conservative text-only fallback. */
+function mindTextMeasure(fontSize = 14, weight = 400) {
+    const measured = factory?.(fontSize, weight);
+    if (measured)
+        return measured;
+    return text => [...text].reduce((sum, ch) => sum + (/[\u0000-\u00ff]/.test(ch) ? 9 : 14) * fontSize / 14, 0);
+}
+/** Keep explicit empty lines and emoji clusters; presentation wrapping never edits the source. */
+function wrapMindText(text, width, measure) {
+    const lines = [];
+    const segmenter = typeof Intl.Segmenter === 'function' ? new Intl.Segmenter(undefined, { granularity: 'grapheme' }) : null;
+    for (const line of text.split('\n')) {
+        let part = '';
+        const segments = segmenter ? [...segmenter.segment(line)].map(s => s.segment) : [...line];
+        for (const ch of segments) {
+            if (part && measure(part + ch) > width) {
+                lines.push(part);
+                part = '';
+            }
+            part += ch;
+        }
+        lines.push(part);
+    }
+    return lines;
+}
+function mindTopicTextSize(text, fontSize = 14, root = false, description = '', bold = false, minimumWidth = 0) {
+    const key = JSON.stringify([text, fontSize, root, description, bold, minimumWidth]);
+    const cached = sizeCache.get(key);
+    if (cached)
+        return cached;
+    const measure = mindTextMeasure(fontSize, bold ? 700 : root ? 600 : 400), descriptionMeasure = mindTextMeasure(12);
+    const source = text || '未命名主题';
+    const longest = Math.max(...source.split('\n').map(measure), ...description.split('\n').map(descriptionMeasure));
+    const width = Math.min(240, Math.max(root ? 128 : 100, minimumWidth, Math.ceil(longest + exports.MIND_TOPIC_PADDING + 2)));
+    const lines = wrapMindText(source, width - exports.MIND_TOPIC_PADDING, measure);
+    const descriptionLines = description ? wrapMindText(description, width - exports.MIND_TOPIC_PADDING, descriptionMeasure) : [];
+    const result = { width, lines, descriptionLines, titleHeight: lines.length * (0, exports.mindTopicLineHeight)(fontSize) };
+    if (sizeCache.size >= 512)
+        sizeCache.delete(sizeCache.keys().next().value);
+    sizeCache.set(key, result);
+    return result;
+}

package/dist/cjs/shared/node-catalog.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * 节点目录：编辑器的 nodeView 与只读渲染规则**共用的单一真源**
+ * （对齐《Wiki好用技术方案》1.1）。
+ *
+ * 这里只放纯数据（无 Vue、无 Tiptap 依赖），因此阅读端可以只引它 + Renderer，
+ * 而完全不加载编辑器代码；编辑器端再基于同一份目录生成扩展。
+ *
+ * 新增节点时必须同时更新：
+ *  1) 本目录  2) 服务端 doc-schema.service.ts 白名单  3) 提升 schema 版本
+ * 否则旧客户端会因「遇到不支持节点」而被服务端拒写（这是预期行为，避免静默丢内容）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNKNOWN_NODE_LABEL = exports.NODE_CATALOG = void 0;
+exports.nodeMeta = nodeMeta;
+exports.headingTag = headingTag;
+exports.NODE_CATALOG = [
+    { type: 'doc', kind: 'block', label: '文档', topLevel: true },
+    { type: 'paragraph', kind: 'block', label: '段落', topLevel: true },
+    { type: 'heading', kind: 'block', label: '标题', topLevel: true },
+    { type: 'bulletList', kind: 'block', label: '无序列表', topLevel: true },
+    { type: 'orderedList', kind: 'block', label: '有序列表', topLevel: true },
+    { type: 'taskList', kind: 'block', label: '待办列表', topLevel: true },
+    { type: 'listItem', kind: 'block', label: '列表项' },
+    { type: 'taskItem', kind: 'block', label: '待办项' },
+    { type: 'blockquote', kind: 'block', label: '引用块', topLevel: true },
+    { type: 'codeBlock', kind: 'block', label: '代码块', topLevel: true },
+    { type: 'horizontalRule', kind: 'atom', atom: true, label: '分割线', topLevel: true },
+    { type: 'table', kind: 'block', label: '表格', topLevel: true },
+    { type: 'tableRow', kind: 'block', label: '表格行' },
+    { type: 'tableHeader', kind: 'block', label: '表头单元格' },
+    { type: 'tableCell', kind: 'block', label: '单元格' },
+    { type: 'image', kind: 'atom', atom: true, label: '图片', topLevel: true },
+    { type: 'fileAttachment', kind: 'atom', atom: true, label: '视频或文件', topLevel: true },
+    { type: 'videoEmbed', kind: 'atom', atom: true, label: '嵌入视频', topLevel: true },
+    { type: 'mindMap', kind: 'block', label: '思维导图', topLevel: true },
+    { type: 'mindMapDescription', kind: 'inline', label: '主题描述' },
+    { type: 'mindMapNote', kind: 'inline', label: '主题备注' },
+    { type: 'mindMapRelation', kind: 'block', label: '主题关系' },
+    { type: 'mindMapTopic', kind: 'block', label: '导图主题' },
+    { type: 'callout', kind: 'block', label: '高亮块', topLevel: true },
+    // 分栏：columns 是顶层行，column 只在其内部（故 column 无 topLevel）
+    { type: 'columns', kind: 'block', label: '分栏', topLevel: true },
+    { type: 'column', kind: 'block', label: '栏' },
+    { type: 'pageLink', kind: 'atom', atom: true, label: '页面引用' },
+    { type: 'mention', kind: 'atom', atom: true, label: '提及用户' },
+    { type: 'mathInline', kind: 'atom', atom: true, label: '行内公式' },
+    { type: 'mathBlock', kind: 'atom', atom: true, label: '公式块', topLevel: true },
+    { type: 'text', kind: 'text', label: '文本' },
+    { type: 'hardBreak', kind: 'inline', atom: true, label: '换行' },
+];
+const META_BY_TYPE = new Map(exports.NODE_CATALOG.map((n) => [n.type, n]));
+function nodeMeta(type) {
+    return type ? META_BY_TYPE.get(type) : undefined;
+}
+/** 只读渲染遇到未知节点时使用的降级提示（不静默丢弃，向用户明示）。 */
+exports.UNKNOWN_NODE_LABEL = '此内容由更高版本的编辑器创建，当前版本无法显示';
+/** 标题级别 → HTML 标签 */
+function headingTag(level) {
+    const n = typeof level === 'number' ? level : 1;
+    return `h${Math.min(Math.max(n, 1), 6)}`;
+}