();
+ const slices = richSlices(src);
+ const nodes = nodesNamed(root, "richcontent");
+ if (slices.length === nodes.length) nodes.forEach((n, i) => m.set(n, slices[i]));
+ return m;
+};
+
+/** Lines of text in a raw richcontent block: a new line per `` and per `
`, tags dropped, entities decoded. */
+const htmlOf = (raw: string): string => {
+ let out = "";
+ let i = 0;
+ for (;;) {
+ const lt = raw.indexOf("<", i);
+ if (lt < 0) {
+ out += decode(raw.slice(i));
+ break;
+ }
+ if (lt > i) out += decode(raw.slice(i, lt));
+ const gt = raw.indexOf(">", lt);
+ if (gt < 0) break;
+ const name = (/^([a-z0-9]+)/i.exec(raw.slice(lt + 1, gt))?.[1] ?? "").toLowerCase();
+ if (name === "br" || name === "p" || name === "li") out += "\n";
+ i = gt + 1;
+ }
+ return out.split("\n").map((l) => l.replace(/\s+/g, " ").trim()).filter(Boolean).join("\n");
+};
+
+/** richcontent text from the parsed node alone (no raw slice): the text survives, the line breaks may not. */
+const plainOf = (n: XNode): string => {
+ const own = n.text.trim();
+ const kids = n.children.map(plainOf).filter(Boolean);
+ return kids.length ? (own ? [own, ...kids].join("\n") : kids.join("\n")) : own;
+};
+
+/** The text of a richcontent block: from the raw slice when we have one (keeping text and `
` order), else from the tree. */
+const htmlText = (n: XNode, raw: Map): string => {
+ const slice = raw.get(n);
+ return slice === undefined ? plainOf(n) : htmlOf(slice);
+};
+
+/** One FreeMind node -> one Cartocortex topic. */
+function nodeFromXml(x: XNode, ids: Map, raw: Map): Node {
+ const children = x.children.filter((c) => c.name === "node").map((c) => nodeFromXml(c, ids, raw));
+ const nodeRich = x.children.find((c) => c.name === "richcontent" && attr(c, "TYPE")?.toUpperCase() === "NODE");
+ const noteRich = x.children.find((c) => c.name === "richcontent" && attr(c, "TYPE")?.toUpperCase() === "NOTE");
+ const noteHook = x.children.find((c) => c.name === "hook" && attr(c, "NAME") === "map/Note"); // FreeMind 0.9
+ const icons = x.children.filter((c) => c.name === "icon").map((c) => attr(c, "BUILTIN") ?? "");
+ const prio = icons.map((b) => /^full-(\d+)$/.exec(b)?.[1]).find(Boolean);
+ const prog = icons.map((b) => PROGRESS[b]).find((p) => p !== undefined);
+ const text = nodeRich ? htmlText(nodeRich, raw) : attr(x, "TEXT") ?? "";
+ const note = noteRich ? htmlText(noteRich, raw) : noteHook ? (kid(noteHook, "text")?.text ?? "").trim() : "";
+ const fill = hexColor(attr(x, "BACKGROUND_COLOR"));
+ const ink = hexColor(attr(x, "COLOR"));
+ const font = kid(x, "font");
+ const dest = x.children.find((c) => c.name === "arrowlink");
+ const to = dest ? attr(dest, "DESTINATION") : undefined;
+ const link = attr(x, "LINK");
+ const node: Node = {
+ id: crypto.randomUUID(),
+ text,
+ children,
+ ...(note ? { note } : {}),
+ ...(link ? { link } : {}),
+ ...(to ? { topicLink: to } : {}),
+ ...(fill ? { color: fill } : {}),
+ ...(ink ? { textColor: ink } : {}),
+ ...(font && attr(font, "BOLD")?.toLowerCase() === "true" ? { bold: true } : {}),
+ ...(font && attr(font, "ITALIC")?.toLowerCase() === "true" ? { italic: true } : {}),
+ ...(children.length && attr(x, "FOLDED")?.toLowerCase() === "true" ? { collapsed: true } : {}),
+ ...(prio ? { priority: Math.min(9, Math.max(1, Number(prio))) } : {}),
+ ...(prog !== undefined ? { progress: prog } : {}),
+ };
+ const id = attr(x, "ID");
+ if (id) ids.set(id, node.id); // for arrowlink: FreeMind's id -> ours
+ return node;
+}
+
+/** The root topics of a .mm map. Left-side first-level topics open as a one-sided (logic left) or two-sided (map) chart. */
+export function fromFreemind(src: string): Node[] {
+ const root = parseXml(src); // throws on DOCTYPE, on anything but plain XML
+ const raw = rawSlices(src, root);
+ const ids = new Map();
+ const roots = root.children.filter((c) => c.name === "node").map((c) => {
+ const sides = c.children.filter((k) => k.name === "node").map((k) => (attr(k, "POSITION") ?? "").toLowerCase() === "left");
+ const node = nodeFromXml(c, ids, raw);
+ const lefts = sides.filter(Boolean).length;
+ if (!lefts) return node;
+ node.layout = lefts === sides.length ? "left" : "map";
+ // The two-sided map grows its first half to the right, so right-side topics come first.
+ node.children = node.children.filter((_, i) => !sides[i]).concat(node.children.filter((_, i) => sides[i]));
+ return node;
+ });
+ if (!roots.length) throw new Error("no topic found in this mind map");
+ resolveTopicLinks(roots, ids); // arrowlink destinations -> our topic ids; links to missing topics are dropped
+ return roots;
+}
+
+/** A .mm file: plain XML, or gzip (magic bytes 1f 8b). */
+export async function fromFreemindBytes(bytes: Uint8Array): Promise {
+ if (bytes[0] !== 0x1f || bytes[1] !== 0x8b) return fromFreemind(new TextDecoder().decode(bytes));
+ const text = await new Response(new Blob([bytes as BlobPart]).stream().pipeThrough(new DecompressionStream("gzip"))).text();
+ return fromFreemind(text);
+}
+
+const esc = (s: string) => s.replace(/[&<>"']/g, (c) => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" })[c]!);
+
+const hex = (c: string | undefined) => (c && /^#[0-9a-f]{6}$/i.test(c) ? c : undefined);
+
+/** FreeMind keeps line breaks in a richcontent block, one `` per line. */
+const richBlock = (type: string, lines: string[]): string =>
+ `
${lines.map((l) => `${esc(l)}
`).join("")}