@bettercms-ai/kit 0.1.1 → 2.0.0

package/dist/controls/rich-text/link-form.js

@@ -0,0 +1,147 @@
+import { Button } from "../../ui/button.js";
+import { Switch } from "../../ui/controls.js";
+import { Input } from "../../ui/input.js";
+import { LinkLine, normLink } from "../link.js";
+import * as React from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { IconLink } from "@tabler/icons-react";
+//#region src/controls/rich-text/link-form.tsx
+/**
+* RICH TEXT · the link popover's body for a link inside the text, in V2's link panel chrome (controls/link.tsx
+* LinkPopoverBody: what it links to now · the address · Remove link · Cancel · Apply): the address, and "Open in new tab"
+* when the field allows it. A text link stores its address and target only (production's link mark), so V2's link type
+* select and rel choice, which belong to the link FIELD, are not offered here.
+*/
+/** An address a link may carry: http(s), mailto, tel, a site path or an in-page anchor. */
+function linkProblem(href) {
+	const h = href.trim();
+	if (!h) return "Add an address first.";
+	if (/^(https?:\/\/[^\s]+|mailto:[^\s]+|tel:[+\d][\d\s()-]*|\/(?!\/)[^\s]*|#[^\s]+)$/i.test(h)) return null;
+	if (/^[a-z][a-z0-9+.-]*:/i.test(h)) return "Use an address that starts with https://, mailto: or tel:.";
+	if (/^[^\s/]+\.[^\s]+$/.test(h)) return `Add https:// in front: https://${h}`;
+	return "Use a full address (https://…), a page path (/about) or an anchor (#section).";
+}
+function LinkForm({ initial, allowNewTab, onSave, onCancel, onDetach }) {
+	const [href, setHref] = React.useState(initial.href);
+	const [newTab, setNewTab] = React.useState(!!initial.newTab);
+	const [problem, setProblem] = React.useState(null);
+	const urlId = React.useId();
+	const tabId = React.useId();
+	const errId = React.useId();
+	const start = initial.href.trim();
+	const changed = href.trim() !== start || allowNewTab && newTab !== !!initial.newTab;
+	const ok = !linkProblem(href);
+	return /* @__PURE__ */ jsxs("form", {
+		className: "flex flex-col gap-3",
+		onSubmit: (e) => {
+			e.preventDefault();
+			const p = linkProblem(href);
+			setProblem(p);
+			if (!p) onSave({
+				href: href.trim(),
+				newTab: allowNewTab && newTab
+			});
+		},
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex min-w-0 flex-col gap-1",
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "text-kit-sm font-medium text-kit-fg",
+					children: "Link"
+				}), start ? /* @__PURE__ */ jsx("span", {
+					className: "flex min-w-0 text-kit-fg-2",
+					children: /* @__PURE__ */ jsx(LinkLine, { v: normLink({
+						href: start,
+						newTab: !!initial.newTab
+					}) })
+				}) : /* @__PURE__ */ jsx("span", {
+					className: "text-kit-xs text-kit-fg-3",
+					children: "No link yet"
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex flex-col gap-1.5",
+				onBlur: (e) => {
+					if (!e.currentTarget.contains(e.relatedTarget) && href.trim()) setProblem(linkProblem(href));
+				},
+				children: [
+					/* @__PURE__ */ jsx("label", {
+						htmlFor: urlId,
+						className: "text-kit-xs text-kit-fg-2",
+						children: "Link to"
+					}),
+					/* @__PURE__ */ jsx(Input, {
+						id: urlId,
+						autoFocus: true,
+						size: "sm",
+						value: href,
+						onChange: (e) => {
+							setHref(e.target.value);
+							if (problem) setProblem(null);
+						},
+						onKeyDown: (e) => {
+							if (e.key === "Enter" && !ok) {
+								e.preventDefault();
+								setProblem(linkProblem(href));
+							}
+						},
+						placeholder: "https://… or /page",
+						leading: /* @__PURE__ */ jsx(IconLink, { stroke: 1.5 }),
+						"aria-invalid": problem ? true : void 0,
+						"aria-describedby": problem ? errId : void 0
+					}),
+					problem ? /* @__PURE__ */ jsx("p", {
+						id: errId,
+						role: "alert",
+						className: "text-kit-xs text-kit-danger-fg",
+						children: problem
+					}) : null
+				]
+			}),
+			allowNewTab ? /* @__PURE__ */ jsxs("label", {
+				htmlFor: tabId,
+				className: "flex min-h-7 items-center justify-between gap-3",
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "text-kit-xs text-kit-fg-2",
+					children: "Open in new tab"
+				}), /* @__PURE__ */ jsx(Switch, {
+					id: tabId,
+					size: "sm",
+					checked: newTab,
+					onCheckedChange: setNewTab
+				})]
+			}) : null,
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-2 border-t border-kit-line pt-2.5",
+				children: [
+					onDetach ? /* @__PURE__ */ jsx(Button, {
+						type: "button",
+						size: "xs",
+						variant: "danger-ghost",
+						onClick: onDetach,
+						children: "Remove link"
+					}) : null,
+					/* @__PURE__ */ jsx("span", { className: "flex-1" }),
+					/* @__PURE__ */ jsx(Button, {
+						type: "button",
+						size: "xs",
+						variant: "ghost",
+						onClick: onCancel,
+						children: "Cancel"
+					}),
+					/* @__PURE__ */ jsx(Button, {
+						type: "submit",
+						size: "xs",
+						variant: "primary",
+						disabled: !changed || !ok,
+						children: "Apply"
+					})
+				]
+			})
+		]
+	});
+}
+//#endregion
+export { LinkForm, linkProblem };
+
+//# sourceMappingURL=link-form.js.map

package/dist/controls/rich-text/link-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-form.js","names":[],"sources":["../../../src/controls/rich-text/link-form.tsx"],"sourcesContent":["/**\n * RICH TEXT · the link popover's body for a link inside the text, in V2's link panel chrome (controls/link.tsx\n * LinkPopoverBody: what it links to now · the address · Remove link · Cancel · Apply): the address, and \"Open in new tab\"\n * when the field allows it. A text link stores its address and target only (production's link mark), so V2's link type\n * select and rel choice, which belong to the link FIELD, are not offered here.\n */\nimport * as React from \"react\";\nimport { IconLink } from \"@tabler/icons-react\";\nimport { Button } from \"../../ui/button\";\nimport { Switch } from \"../../ui/controls\";\nimport { Input } from \"../../ui/input\";\nimport { LinkLine, normLink } from \"../link\";\n\nexport interface TextLink {\n  href: string;\n  newTab?: boolean;\n}\n\n/** An address a link may carry: http(s), mailto, tel, a site path or an in-page anchor. */\nexport function linkProblem(href: string): string | null {\n  const h = href.trim();\n  if (!h) return \"Add an address first.\";\n  if (/^(https?:\\/\\/[^\\s]+|mailto:[^\\s]+|tel:[+\\d][\\d\\s()-]*|\\/(?!\\/)[^\\s]*|#[^\\s]+)$/i.test(h)) return null;\n  if (/^[a-z][a-z0-9+.-]*:/i.test(h)) return \"Use an address that starts with https://, mailto: or tel:.\";\n  if (/^[^\\s/]+\\.[^\\s]+$/.test(h)) return `Add https:// in front: https://${h}`;\n  return \"Use a full address (https://…), a page path (/about) or an anchor (#section).\";\n}\n\nexport function LinkForm({\n  initial,\n  allowNewTab,\n  onSave,\n  onCancel,\n  onDetach,\n}: {\n  initial: TextLink;\n  allowNewTab: boolean;\n  onSave: (v: TextLink) => void;\n  onCancel: () => void;\n  onDetach?: () => void;\n}) {\n  const [href, setHref] = React.useState(initial.href);\n  const [newTab, setNewTab] = React.useState(!!initial.newTab);\n  const [problem, setProblem] = React.useState<string | null>(null);\n  const urlId = React.useId();\n  const tabId = React.useId();\n  const errId = React.useId();\n  const start = initial.href.trim();\n  // V2 LinkPopoverBody (controls/link.tsx): Apply only when something changed and the link can be saved\n  const changed = href.trim() !== start || (allowNewTab && newTab !== !!initial.newTab);\n  const ok = !linkProblem(href);\n  return (\n    <form\n      className=\"flex flex-col gap-3\"\n      onSubmit={(e) => {\n        e.preventDefault();\n        const p = linkProblem(href);\n        setProblem(p);\n        if (!p) onSave({ href: href.trim(), newTab: allowNewTab && newTab });\n      }}\n    >\n      <div className=\"flex min-w-0 flex-col gap-1\">\n        <span className=\"text-kit-sm font-medium text-kit-fg\">Link</span>\n        {start ? (\n          <span className=\"flex min-w-0 text-kit-fg-2\">\n            <LinkLine v={normLink({ href: start, newTab: !!initial.newTab })} />\n          </span>\n        ) : (\n          <span className=\"text-kit-xs text-kit-fg-3\">No link yet</span>\n        )}\n      </div>\n      <div\n        className=\"flex flex-col gap-1.5\"\n        onBlur={(e) => {\n          if (!e.currentTarget.contains(e.relatedTarget as Node) && href.trim()) setProblem(linkProblem(href));\n        }}\n      >\n        <label htmlFor={urlId} className=\"text-kit-xs text-kit-fg-2\">\n          Link to\n        </label>\n        <Input\n          id={urlId}\n          autoFocus\n          size=\"sm\"\n          value={href}\n          onChange={(e) => {\n            setHref(e.target.value);\n            if (problem) setProblem(null);\n          }}\n          onKeyDown={(e) => {\n            // Apply is disabled while the address cannot be saved, so Enter says why instead of doing nothing\n            if (e.key === \"Enter\" && !ok) {\n              e.preventDefault();\n              setProblem(linkProblem(href));\n            }\n          }}\n          placeholder=\"https://… or /page\"\n          leading={<IconLink stroke={1.5} />}\n          aria-invalid={problem ? true : undefined}\n          aria-describedby={problem ? errId : undefined}\n        />\n        {problem ? (\n          <p id={errId} role=\"alert\" className=\"text-kit-xs text-kit-danger-fg\">\n            {problem}\n          </p>\n        ) : null}\n      </div>\n      {allowNewTab ? (\n        <label htmlFor={tabId} className=\"flex min-h-7 items-center justify-between gap-3\">\n          <span className=\"text-kit-xs text-kit-fg-2\">Open in new tab</span>\n          <Switch id={tabId} size=\"sm\" checked={newTab} onCheckedChange={setNewTab} />\n        </label>\n      ) : null}\n      <div className=\"flex items-center gap-2 border-t border-kit-line pt-2.5\">\n        {onDetach ? (\n          <Button type=\"button\" size=\"xs\" variant=\"danger-ghost\" onClick={onDetach}>\n            Remove link\n          </Button>\n        ) : null}\n        <span className=\"flex-1\" />\n        <Button type=\"button\" size=\"xs\" variant=\"ghost\" onClick={onCancel}>\n          Cancel\n        </Button>\n        <Button type=\"submit\" size=\"xs\" variant=\"primary\" disabled={!changed || !ok}>\n          Apply\n        </Button>\n      </div>\n    </form>\n  );\n}\n"],"mappings":"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"}

package/dist/controls/rich-text/markdown.d.ts

@@ -0,0 +1,6 @@
+export declare function htmlToMarkdown(html: string): string;
+export declare function inlineMd(src: string): string;
+/** Throws on Markdown it cannot read (e.g. an unclosed code fence). */
+export declare function markdownToHtml(md: string): string;
+/** Does pasted plain text look like Markdown worth converting into blocks? */
+export declare const looksLikeMarkdown: (t: string) => boolean;

package/dist/controls/rich-text/markdown.js

@@ -0,0 +1,181 @@
+import { esc, escAttr, sanitize } from "./dom.js";
+//#region src/controls/rich-text/markdown.ts
+/**
+* RICH TEXT · a small HTML ⇄ Markdown converter for the field's Markdown mode and for pasting (V2 HEAD
+* controls/rich-text/markdown.ts). Covers headings, bold/italic/strike/underline, inline code, links, images, lists,
+* quotes, code blocks, rules and paragraphs. Anything else is kept as one line of raw HTML, which the reverse direction
+* passes through untouched (and the field's own rules then decide whether it may stay).
+*/
+var escText = (s) => s.replace(/([\\`*[\]~])/g, "\\$1");
+function inline(node, inCode = false) {
+	if (node.nodeType === 3) {
+		const t = (node.textContent ?? "").replace(/ /g, " ");
+		return inCode ? t : escText(t.replace(/\s+/g, " "));
+	}
+	if (node.nodeType !== 1) return "";
+	const el = node;
+	const kids = () => Array.from(el.childNodes).map((c) => inline(c, inCode)).join("");
+	const wrap = (mark) => {
+		const inner = kids();
+		if (!inner.trim()) return inner;
+		const lead = inner.match(/^\s*/)[0];
+		const trail = inner.match(/\s*$/)[0];
+		return `${lead}${mark}${inner.trim()}${mark}${trail}`;
+	};
+	switch (el.tagName) {
+		case "STRONG":
+		case "B": return wrap("**");
+		case "EM":
+		case "I": return wrap("_");
+		case "S":
+		case "STRIKE":
+		case "DEL": return wrap("~~");
+		case "U": return `<u>${kids()}</u>`;
+		case "SUP": return el.matches("[data-footnote]") || el.querySelector(":scope > a[href*='-fn-']") ? kids() : `<sup>${kids()}</sup>`;
+		case "SUB": return `<sub>${kids()}</sub>`;
+		case "CODE": return "`" + (el.textContent ?? "").replace(/`/g, "") + "`";
+		case "BR": return "  \n";
+		case "IMG": return `![${el.getAttribute("alt") ?? ""}](${el.getAttribute("src") ?? ""})`;
+		case "A":
+			if (el.hasAttribute("target")) return el.outerHTML;
+			return `[${kids()}](${el.getAttribute("href") ?? ""})`;
+		default: return kids();
+	}
+}
+function list(el) {
+	if (el.querySelector("ul ul, ul ol, ol ol, ol ul, li > p + p")) return null;
+	return Array.from(el.children).filter((li) => li.tagName === "LI").map((li, i) => (el.tagName === "OL" ? `${i + 1}. ` : "- ") + inline(li).trim().replace(/ {2}\n/g, " ")).join("\n");
+}
+function htmlToMarkdown(html) {
+	const doc = new DOMParser().parseFromString(`<body>${html}</body>`, "text/html");
+	const out = [];
+	for (const node of Array.from(doc.body.childNodes)) {
+		if (node.nodeType === 3) {
+			const t = inline(node).trim();
+			if (t) out.push(t);
+			continue;
+		}
+		if (node.nodeType !== 1) continue;
+		const el = node;
+		const tag = el.tagName;
+		const raw = () => out.push(el.outerHTML.replace(/\n+/g, " "));
+		if (/^H[1-6]$/.test(tag)) out.push(`${"#".repeat(Number(tag[1]))} ${inline(el).trim()}`);
+		else if (tag === "P") {
+			const s = inline(el).trim().replace(/^([#>]|\d+\.|[-+] |-{3})/, "\\$1");
+			if (s) out.push(s);
+		} else if (tag === "UL" || tag === "OL") {
+			const l = list(el);
+			if (l === null) raw();
+			else out.push(l);
+		} else if (tag === "BLOCKQUOTE") {
+			const paras = el.querySelector("p,div") ? Array.from(el.children).map((c) => inline(c).trim()) : [inline(el).trim()];
+			out.push(paras.filter(Boolean).map((p) => p.split("\n").map((l) => `> ${l}`).join("\n")).join("\n>\n"));
+		} else if (tag === "PRE") out.push("```\n" + (el.textContent ?? "").replace(/\n$/, "") + "\n```");
+		else if (tag === "HR") out.push("---");
+		else if (tag === "FIGURE" && el.querySelector(":scope > img")) {
+			const img = el.querySelector("img");
+			const cap = el.querySelector("figcaption")?.textContent?.trim();
+			out.push(`![${img.getAttribute("alt") ?? ""}](${img.getAttribute("src") ?? ""}${cap ? ` "${cap.replace(/"/g, "'")}"` : ""})`);
+		} else raw();
+	}
+	return out.join("\n\n") + (out.length ? "\n" : "");
+}
+var safeHref = (h) => /^\s*(javascript|vbscript|data:text)/i.test(h) ? "#" : h;
+function inlineMd(src) {
+	const slots = [];
+	const hold = (html) => `\u0000${slots.push(html) - 1}\u0000`;
+	let s = src.replace(/\\([\\`*_[\]~#>+\-.!])/g, (_, c) => hold(esc(c)));
+	s = s.replace(/`([^`]+)`/g, (_, c) => hold(`<code>${esc(c)}</code>`));
+	s = s.replace(/<a [^>]*>.*?<\/a>/g, (m) => hold(m));
+	s = esc(s);
+	s = s.replace(/&lt;(\/?)u&gt;/g, "<$1u>");
+	s = s.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (_, a, u) => hold(`<img src="${escAttr(safeHref(u))}" alt="${escAttr(a)}">`));
+	s = s.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, (_, t, u) => `<a href="${escAttr(safeHref(u))}">${t}</a>`);
+	s = s.replace(/\*\*([^*]+?)\*\*/g, "<strong>$1</strong>");
+	s = s.replace(/__([^_]+?)__/g, "<strong>$1</strong>");
+	s = s.replace(/(^|[^\w*])\*([^*\s][^*]*?)\*(?!\*)/g, "$1<em>$2</em>");
+	s = s.replace(/(^|[^\w])_([^_\s][^_]*?)_(?!\w)/g, "$1<em>$2</em>");
+	s = s.replace(/~~([^~]+?)~~/g, "<s>$1</s>");
+	s = s.replace(/ {2,}\n/g, "<br>").replace(/\n/g, " ");
+	return s.replace(/\u0000(\d+)\u0000/g, (_, i) => slots[Number(i)]);
+}
+var RAW_BLOCK = /^<\/?(div|table|figure|details|ul|ol|p|h[1-6]|blockquote|pre|hr|section|aside)\b/i;
+var RE = {
+	fence: /^\s*```/,
+	heading: /^(#{1,6})\s+(.*?)\s*#*\s*$/,
+	hr: /^\s*(-{3,}|\*{3,}|_{3,})\s*$/,
+	image: /^!\[([^\]]*)\]\(([^)\s]+)(?:\s+"([^"]*)")?\)\s*$/,
+	quote: /^\s*>/,
+	ul: /^\s*[-*+]\s+(.*)$/,
+	ol: /^\s*\d+[.)]\s+(.*)$/
+};
+var startsBlock = (l) => RE.fence.test(l) || RE.heading.test(l) || RE.hr.test(l) || RE.quote.test(l) || RE.ul.test(l) || RE.ol.test(l) || RAW_BLOCK.test(l.trim());
+/** Throws on Markdown it cannot read (e.g. an unclosed code fence). */
+function markdownToHtml(md) {
+	const lines = md.replace(/\r\n?/g, "\n").split("\n");
+	const out = [];
+	let i = 0;
+	while (i < lines.length) {
+		const line = lines[i];
+		if (!line.trim()) {
+			i++;
+			continue;
+		}
+		if (RE.fence.test(line)) {
+			const code = [];
+			i++;
+			while (i < lines.length && !RE.fence.test(lines[i])) code.push(lines[i++]);
+			if (i >= lines.length) throw new Error("Unclosed code block");
+			i++;
+			out.push(`<pre>${esc(code.join("\n"))}</pre>`);
+			continue;
+		}
+		if (RAW_BLOCK.test(line.trim())) {
+			const raw = [];
+			while (i < lines.length && lines[i].trim()) raw.push(lines[i++]);
+			out.push(raw.join(" "));
+			continue;
+		}
+		let m = line.match(RE.heading);
+		if (m) {
+			out.push(`<h${m[1].length}>${inlineMd(m[2])}</h${m[1].length}>`);
+			i++;
+			continue;
+		}
+		if (RE.hr.test(line)) {
+			out.push("<hr>");
+			i++;
+			continue;
+		}
+		m = line.match(RE.image);
+		if (m) {
+			out.push(`<figure><img src="${escAttr(safeHref(m[2]))}" alt="${escAttr(m[1])}"></figure>${m[3] ? `<p>${esc(m[3])}</p>` : ""}`);
+			i++;
+			continue;
+		}
+		if (RE.quote.test(line)) {
+			const q = [];
+			while (i < lines.length && RE.quote.test(lines[i])) q.push(lines[i++].replace(/^\s*> ?/, ""));
+			out.push(`<blockquote>${q.join("\n").split(/\n\s*\n/).map(inlineMd).join("<br><br>")}</blockquote>`);
+			continue;
+		}
+		if (RE.ul.test(line) || RE.ol.test(line)) {
+			const ordered = !RE.ul.test(line);
+			const re = ordered ? RE.ol : RE.ul;
+			const items = [];
+			while (i < lines.length && re.test(lines[i])) items.push(`<li>${inlineMd(lines[i++].match(re)[1])}</li>`);
+			out.push(ordered ? `<ol>${items.join("")}</ol>` : `<ul>${items.join("")}</ul>`);
+			continue;
+		}
+		const para = [];
+		while (i < lines.length && lines[i].trim() && (para.length === 0 || !startsBlock(lines[i]))) para.push(lines[i++]);
+		out.push(`<p>${inlineMd(para.join("\n"))}</p>`);
+	}
+	return sanitize(out.join(""));
+}
+/** Does pasted plain text look like Markdown worth converting into blocks? */
+var looksLikeMarkdown = (t) => /\n\s*\n/.test(t) || /^(#{1,6}\s|[-*+]\s|\d+[.)]\s|>\s|```|---)/m.test(t) || /\*\*[^*]+\*\*|\[[^\]]+\]\([^)]+\)/.test(t);
+//#endregion
+export { htmlToMarkdown, inlineMd, looksLikeMarkdown, markdownToHtml };
+
+//# sourceMappingURL=markdown.js.map

package/dist/controls/rich-text/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","names":[],"sources":["../../../src/controls/rich-text/markdown.ts"],"sourcesContent":["/**\n * RICH TEXT · a small HTML ⇄ Markdown converter for the field's Markdown mode and for pasting (V2 HEAD\n * controls/rich-text/markdown.ts). Covers headings, bold/italic/strike/underline, inline code, links, images, lists,\n * quotes, code blocks, rules and paragraphs. Anything else is kept as one line of raw HTML, which the reverse direction\n * passes through untouched (and the field's own rules then decide whether it may stay).\n */\nimport { esc, escAttr, sanitize } from \"./dom\";\n\n/* ── HTML → Markdown ───────────────────────────────────────────────── */\nconst escText = (s: string) => s.replace(/([\\\\`*[\\]~])/g, \"\\\\$1\");\n\nfunction inline(node: Node, inCode = false): string {\n  if (node.nodeType === 3) {\n    const t = (node.textContent ?? \"\").replace(/ /g, \" \");\n    return inCode ? t : escText(t.replace(/\\s+/g, \" \"));\n  }\n  if (node.nodeType !== 1) return \"\";\n  const el = node as HTMLElement;\n  const kids = () => Array.from(el.childNodes).map((c) => inline(c, inCode)).join(\"\");\n  const wrap = (mark: string) => {\n    const inner = kids();\n    if (!inner.trim()) return inner;\n    const lead = inner.match(/^\\s*/)![0];\n    const trail = inner.match(/\\s*$/)![0];\n    return `${lead}${mark}${inner.trim()}${mark}${trail}`;\n  };\n  switch (el.tagName) {\n    case \"STRONG\":\n    case \"B\":\n      return wrap(\"**\");\n    case \"EM\":\n    case \"I\":\n      return wrap(\"_\");\n    case \"S\":\n    case \"STRIKE\":\n    case \"DEL\":\n      return wrap(\"~~\");\n    case \"U\":\n      return `<u>${kids()}</u>`;\n    // footnote markers are written elsewhere; a plain x² / x₂ stays inline HTML, which Markdown allows\n    case \"SUP\":\n      return el.matches(\"[data-footnote]\") || el.querySelector(\":scope > a[href*='-fn-']\") ? kids() : `<sup>${kids()}</sup>`;\n    case \"SUB\":\n      return `<sub>${kids()}</sub>`;\n    case \"CODE\":\n      return \"`\" + (el.textContent ?? \"\").replace(/`/g, \"\") + \"`\";\n    case \"BR\":\n      return \"  \\n\";\n    case \"IMG\":\n      return `![${el.getAttribute(\"alt\") ?? \"\"}](${el.getAttribute(\"src\") ?? \"\"})`;\n    case \"A\":\n      // a link that carries more than its address (opens in a new tab) keeps its markup, so Markdown mode drops nothing\n      if (el.hasAttribute(\"target\")) return el.outerHTML;\n      return `[${kids()}](${el.getAttribute(\"href\") ?? \"\"})`;\n    default:\n      return kids();\n  }\n}\n\nfunction list(el: HTMLElement): string | null {\n  if (el.querySelector(\"ul ul, ul ol, ol ol, ol ul, li > p + p\")) return null;\n  return Array.from(el.children)\n    .filter((li) => li.tagName === \"LI\")\n    .map((li, i) => (el.tagName === \"OL\" ? `${i + 1}. ` : \"- \") + inline(li).trim().replace(/ {2}\\n/g, \" \"))\n    .join(\"\\n\");\n}\n\nexport function htmlToMarkdown(html: string): string {\n  const doc = new DOMParser().parseFromString(`<body>${html}</body>`, \"text/html\");\n  const out: string[] = [];\n  for (const node of Array.from(doc.body.childNodes)) {\n    if (node.nodeType === 3) {\n      const t = inline(node).trim();\n      if (t) out.push(t);\n      continue;\n    }\n    if (node.nodeType !== 1) continue;\n    const el = node as HTMLElement;\n    const tag = el.tagName;\n    const raw = () => out.push(el.outerHTML.replace(/\\n+/g, \" \"));\n    if (/^H[1-6]$/.test(tag)) out.push(`${\"#\".repeat(Number(tag[1]))} ${inline(el).trim()}`);\n    else if (tag === \"P\") {\n      const s = inline(el).trim().replace(/^([#>]|\\d+\\.|[-+] |-{3})/, \"\\\\$1\");\n      if (s) out.push(s);\n    } else if (tag === \"UL\" || tag === \"OL\") {\n      const l = list(el);\n      if (l === null) raw();\n      else out.push(l);\n    } else if (tag === \"BLOCKQUOTE\") {\n      const paras = el.querySelector(\"p,div\") ? Array.from(el.children).map((c) => inline(c).trim()) : [inline(el).trim()];\n      out.push(paras.filter(Boolean).map((p) => p.split(\"\\n\").map((l) => `> ${l}`).join(\"\\n\")).join(\"\\n>\\n\"));\n    } else if (tag === \"PRE\") out.push(\"```\\n\" + (el.textContent ?? \"\").replace(/\\n$/, \"\") + \"\\n```\");\n    else if (tag === \"HR\") out.push(\"---\");\n    else if (tag === \"FIGURE\" && el.querySelector(\":scope > img\")) {\n      const img = el.querySelector(\"img\")!;\n      const cap = el.querySelector(\"figcaption\")?.textContent?.trim();\n      out.push(`![${img.getAttribute(\"alt\") ?? \"\"}](${img.getAttribute(\"src\") ?? \"\"}${cap ? ` \"${cap.replace(/\"/g, \"'\")}\"` : \"\"})`);\n    } else raw();\n  }\n  return out.join(\"\\n\\n\") + (out.length ? \"\\n\" : \"\");\n}\n\n/* ── Markdown → HTML ───────────────────────────────────────────────── */\nconst safeHref = (h: string) => (/^\\s*(javascript|vbscript|data:text)/i.test(h) ? \"#\" : h);\n\nexport function inlineMd(src: string): string {\n  const slots: string[] = [];\n  const hold = (html: string) => `\\u0000${slots.push(html) - 1}\\u0000`;\n  let s = src.replace(/\\\\([\\\\`*_[\\]~#>+\\-.!])/g, (_, c: string) => hold(esc(c)));\n  s = s.replace(/`([^`]+)`/g, (_, c: string) => hold(`<code>${esc(c)}</code>`));\n  s = s.replace(/<a [^>]*>.*?<\\/a>/g, (m) => hold(m));\n  s = esc(s);\n  s = s.replace(/&lt;(\\/?)u&gt;/g, \"<$1u>\");\n  s = s.replace(/!\\[([^\\]]*)\\]\\(([^)\\s]+)\\)/g, (_, a: string, u: string) => hold(`<img src=\"${escAttr(safeHref(u))}\" alt=\"${escAttr(a)}\">`));\n  s = s.replace(/\\[([^\\]]+)\\]\\(([^)\\s]+)\\)/g, (_, t: string, u: string) => `<a href=\"${escAttr(safeHref(u))}\">${t}</a>`);\n  s = s.replace(/\\*\\*([^*]+?)\\*\\*/g, \"<strong>$1</strong>\");\n  s = s.replace(/__([^_]+?)__/g, \"<strong>$1</strong>\");\n  s = s.replace(/(^|[^\\w*])\\*([^*\\s][^*]*?)\\*(?!\\*)/g, \"$1<em>$2</em>\");\n  s = s.replace(/(^|[^\\w])_([^_\\s][^_]*?)_(?!\\w)/g, \"$1<em>$2</em>\");\n  s = s.replace(/~~([^~]+?)~~/g, \"<s>$1</s>\");\n  s = s.replace(/ {2,}\\n/g, \"<br>\").replace(/\\n/g, \" \");\n  return s.replace(/\\u0000(\\d+)\\u0000/g, (_, i: string) => slots[Number(i)]);\n}\n\nconst RAW_BLOCK = /^<\\/?(div|table|figure|details|ul|ol|p|h[1-6]|blockquote|pre|hr|section|aside)\\b/i;\nconst RE = {\n  fence: /^\\s*```/,\n  heading: /^(#{1,6})\\s+(.*?)\\s*#*\\s*$/,\n  hr: /^\\s*(-{3,}|\\*{3,}|_{3,})\\s*$/,\n  image: /^!\\[([^\\]]*)\\]\\(([^)\\s]+)(?:\\s+\"([^\"]*)\")?\\)\\s*$/,\n  quote: /^\\s*>/,\n  ul: /^\\s*[-*+]\\s+(.*)$/,\n  ol: /^\\s*\\d+[.)]\\s+(.*)$/,\n};\nconst startsBlock = (l: string) => RE.fence.test(l) || RE.heading.test(l) || RE.hr.test(l) || RE.quote.test(l) || RE.ul.test(l) || RE.ol.test(l) || RAW_BLOCK.test(l.trim());\n\n/** Throws on Markdown it cannot read (e.g. an unclosed code fence). */\nexport function markdownToHtml(md: string): string {\n  const lines = md.replace(/\\r\\n?/g, \"\\n\").split(\"\\n\");\n  const out: string[] = [];\n  let i = 0;\n  while (i < lines.length) {\n    const line = lines[i];\n    if (!line.trim()) {\n      i++;\n      continue;\n    }\n    if (RE.fence.test(line)) {\n      const code: string[] = [];\n      i++;\n      while (i < lines.length && !RE.fence.test(lines[i])) code.push(lines[i++]);\n      if (i >= lines.length) throw new Error(\"Unclosed code block\");\n      i++;\n      out.push(`<pre>${esc(code.join(\"\\n\"))}</pre>`);\n      continue;\n    }\n    if (RAW_BLOCK.test(line.trim())) {\n      const raw: string[] = [];\n      while (i < lines.length && lines[i].trim()) raw.push(lines[i++]);\n      out.push(raw.join(\" \"));\n      continue;\n    }\n    let m = line.match(RE.heading);\n    if (m) {\n      out.push(`<h${m[1].length}>${inlineMd(m[2])}</h${m[1].length}>`);\n      i++;\n      continue;\n    }\n    if (RE.hr.test(line)) {\n      out.push(\"<hr>\");\n      i++;\n      continue;\n    }\n    m = line.match(RE.image);\n    if (m) {\n      // an image keeps no caption in production rich text: a title becomes the line under it, never dropped\n      out.push(`<figure><img src=\"${escAttr(safeHref(m[2]))}\" alt=\"${escAttr(m[1])}\"></figure>${m[3] ? `<p>${esc(m[3])}</p>` : \"\"}`);\n      i++;\n      continue;\n    }\n    if (RE.quote.test(line)) {\n      const q: string[] = [];\n      while (i < lines.length && RE.quote.test(lines[i])) q.push(lines[i++].replace(/^\\s*> ?/, \"\"));\n      out.push(`<blockquote>${q.join(\"\\n\").split(/\\n\\s*\\n/).map(inlineMd).join(\"<br><br>\")}</blockquote>`);\n      continue;\n    }\n    if (RE.ul.test(line) || RE.ol.test(line)) {\n      const ordered = !RE.ul.test(line);\n      const re = ordered ? RE.ol : RE.ul;\n      const items: string[] = [];\n      while (i < lines.length && re.test(lines[i])) items.push(`<li>${inlineMd(lines[i++].match(re)![1])}</li>`);\n      out.push(ordered ? `<ol>${items.join(\"\")}</ol>` : `<ul>${items.join(\"\")}</ul>`);\n      continue;\n    }\n    const para: string[] = [];\n    while (i < lines.length && lines[i].trim() && (para.length === 0 || !startsBlock(lines[i]))) para.push(lines[i++]);\n    out.push(`<p>${inlineMd(para.join(\"\\n\"))}</p>`);\n  }\n  return sanitize(out.join(\"\"));\n}\n\n/** Does pasted plain text look like Markdown worth converting into blocks? */\nexport const looksLikeMarkdown = (t: string) => /\\n\\s*\\n/.test(t) || /^(#{1,6}\\s|[-*+]\\s|\\d+[.)]\\s|>\\s|```|---)/m.test(t) || /\\*\\*[^*]+\\*\\*|\\[[^\\]]+\\]\\([^)]+\\)/.test(t);\n"],"mappings":";;;;;;;;AASA,IAAM,WAAW,MAAc,EAAE,QAAQ,iBAAiB,MAAM;AAEhE,SAAS,OAAO,MAAY,SAAS,OAAe;CAClD,IAAI,KAAK,aAAa,GAAG;EACvB,MAAM,KAAK,KAAK,eAAe,GAAA,CAAI,QAAQ,MAAM,GAAG;EACpD,OAAO,SAAS,IAAI,QAAQ,EAAE,QAAQ,QAAQ,GAAG,CAAC;CACpD;CACA,IAAI,KAAK,aAAa,GAAG,OAAO;CAChC,MAAM,KAAK;CACX,MAAM,aAAa,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,KAAK,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE;CAClF,MAAM,QAAQ,SAAiB;EAC7B,MAAM,QAAQ,KAAK;EACnB,IAAI,CAAC,MAAM,KAAK,GAAG,OAAO;EAC1B,MAAM,OAAO,MAAM,MAAM,MAAM,CAAC,CAAE;EAClC,MAAM,QAAQ,MAAM,MAAM,MAAM,CAAC,CAAE;EACnC,OAAO,GAAG,OAAO,OAAO,MAAM,KAAK,IAAI,OAAO;CAChD;CACA,QAAQ,GAAG,SAAX;EACE,KAAK;EACL,KAAK,KACH,OAAO,KAAK,IAAI;EAClB,KAAK;EACL,KAAK,KACH,OAAO,KAAK,GAAG;EACjB,KAAK;EACL,KAAK;EACL,KAAK,OACH,OAAO,KAAK,IAAI;EAClB,KAAK,KACH,OAAO,MAAM,KAAK,EAAE;EAEtB,KAAK,OACH,OAAO,GAAG,QAAQ,iBAAiB,KAAK,GAAG,cAAc,0BAA0B,IAAI,KAAK,IAAI,QAAQ,KAAK,EAAE;EACjH,KAAK,OACH,OAAO,QAAQ,KAAK,EAAE;EACxB,KAAK,QACH,OAAO,OAAO,GAAG,eAAe,GAAA,CAAI,QAAQ,MAAM,EAAE,IAAI;EAC1D,KAAK,MACH,OAAO;EACT,KAAK,OACH,OAAO,KAAK,GAAG,aAAa,KAAK,KAAK,GAAG,IAAI,GAAG,aAAa,KAAK,KAAK,GAAG;EAC5E,KAAK;GAEH,IAAI,GAAG,aAAa,QAAQ,GAAG,OAAO,GAAG;GACzC,OAAO,IAAI,KAAK,EAAE,IAAI,GAAG,aAAa,MAAM,KAAK,GAAG;EACtD,SACE,OAAO,KAAK;CAChB;AACF;AAEA,SAAS,KAAK,IAAgC;CAC5C,IAAI,GAAG,cAAc,wCAAwC,GAAG,OAAO;CACvE,OAAO,MAAM,KAAK,GAAG,QAAQ,CAAC,CAC3B,QAAQ,OAAO,GAAG,YAAY,IAAI,CAAC,CACnC,KAAK,IAAI,OAAO,GAAG,YAAY,OAAO,GAAG,IAAI,EAAE,MAAM,QAAQ,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,WAAW,GAAG,CAAC,CAAC,CACvG,KAAK,IAAI;AACd;AAEA,SAAgB,eAAe,MAAsB;CACnD,MAAM,MAAM,IAAI,UAAU,CAAC,CAAC,gBAAgB,SAAS,KAAK,UAAU,WAAW;CAC/E,MAAM,MAAgB,CAAC;CACvB,KAAK,MAAM,QAAQ,MAAM,KAAK,IAAI,KAAK,UAAU,GAAG;EAClD,IAAI,KAAK,aAAa,GAAG;GACvB,MAAM,IAAI,OAAO,IAAI,CAAC,CAAC,KAAK;GAC5B,IAAI,GAAG,IAAI,KAAK,CAAC;GACjB;EACF;EACA,IAAI,KAAK,aAAa,GAAG;EACzB,MAAM,KAAK;EACX,MAAM,MAAM,GAAG;EACf,MAAM,YAAY,IAAI,KAAK,GAAG,UAAU,QAAQ,QAAQ,GAAG,CAAC;EAC5D,IAAI,WAAW,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,OAAO,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,KAAK,GAAG;OAClF,IAAI,QAAQ,KAAK;GACpB,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,4BAA4B,MAAM;GACtE,IAAI,GAAG,IAAI,KAAK,CAAC;EACnB,OAAO,IAAI,QAAQ,QAAQ,QAAQ,MAAM;GACvC,MAAM,IAAI,KAAK,EAAE;GACjB,IAAI,MAAM,MAAM,IAAI;QACf,IAAI,KAAK,CAAC;EACjB,OAAO,IAAI,QAAQ,cAAc;GAC/B,MAAM,QAAQ,GAAG,cAAc,OAAO,IAAI,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,KAAK,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;GACnH,IAAI,KAAK,MAAM,OAAO,OAAO,CAAC,CAAC,KAAK,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;EACxG,OAAO,IAAI,QAAQ,OAAO,IAAI,KAAK,WAAW,GAAG,eAAe,GAAA,CAAI,QAAQ,OAAO,EAAE,IAAI,OAAO;OAC3F,IAAI,QAAQ,MAAM,IAAI,KAAK,KAAK;OAChC,IAAI,QAAQ,YAAY,GAAG,cAAc,cAAc,GAAG;GAC7D,MAAM,MAAM,GAAG,cAAc,KAAK;GAClC,MAAM,MAAM,GAAG,cAAc,YAAY,CAAC,EAAE,aAAa,KAAK;GAC9D,IAAI,KAAK,KAAK,IAAI,aAAa,KAAK,KAAK,GAAG,IAAI,IAAI,aAAa,KAAK,KAAK,KAAK,MAAM,KAAK,IAAI,QAAQ,MAAM,GAAG,EAAE,KAAK,GAAG,EAAE;EAC9H,OAAO,IAAI;CACb;CACA,OAAO,IAAI,KAAK,MAAM,KAAK,IAAI,SAAS,OAAO;AACjD;AAGA,IAAM,YAAY,MAAe,uCAAuC,KAAK,CAAC,IAAI,MAAM;AAExF,SAAgB,SAAS,KAAqB;CAC5C,MAAM,QAAkB,CAAC;CACzB,MAAM,QAAQ,SAAiB,SAAS,MAAM,KAAK,IAAI,IAAI,EAAE;CAC7D,IAAI,IAAI,IAAI,QAAQ,4BAA4B,GAAG,MAAc,KAAK,IAAI,CAAC,CAAC,CAAC;CAC7E,IAAI,EAAE,QAAQ,eAAe,GAAG,MAAc,KAAK,SAAS,IAAI,CAAC,EAAE,QAAQ,CAAC;CAC5E,IAAI,EAAE,QAAQ,uBAAuB,MAAM,KAAK,CAAC,CAAC;CAClD,IAAI,IAAI,CAAC;CACT,IAAI,EAAE,QAAQ,mBAAmB,OAAO;CACxC,IAAI,EAAE,QAAQ,gCAAgC,GAAG,GAAW,MAAc,KAAK,aAAa,QAAQ,SAAS,CAAC,CAAC,EAAE,SAAS,QAAQ,CAAC,EAAE,GAAG,CAAC;CACzI,IAAI,EAAE,QAAQ,+BAA+B,GAAG,GAAW,MAAc,YAAY,QAAQ,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK;CACrH,IAAI,EAAE,QAAQ,qBAAqB,qBAAqB;CACxD,IAAI,EAAE,QAAQ,iBAAiB,qBAAqB;CACpD,IAAI,EAAE,QAAQ,uCAAuC,eAAe;CACpE,IAAI,EAAE,QAAQ,oCAAoC,eAAe;CACjE,IAAI,EAAE,QAAQ,iBAAiB,WAAW;CAC1C,IAAI,EAAE,QAAQ,YAAY,MAAM,CAAC,CAAC,QAAQ,OAAO,GAAG;CACpD,OAAO,EAAE,QAAQ,uBAAuB,GAAG,MAAc,MAAM,OAAO,CAAC,EAAE;AAC3E;AAEA,IAAM,YAAY;AAClB,IAAM,KAAK;CACT,OAAO;CACP,SAAS;CACT,IAAI;CACJ,OAAO;CACP,OAAO;CACP,IAAI;CACJ,IAAI;AACN;AACA,IAAM,eAAe,MAAc,GAAG,MAAM,KAAK,CAAC,KAAK,GAAG,QAAQ,KAAK,CAAC,KAAK,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,GAAG,KAAK,CAAC,KAAK,UAAU,KAAK,EAAE,KAAK,CAAC;;AAG3K,SAAgB,eAAe,IAAoB;CACjD,MAAM,QAAQ,GAAG,QAAQ,UAAU,IAAI,CAAC,CAAC,MAAM,IAAI;CACnD,MAAM,MAAgB,CAAC;CACvB,IAAI,IAAI;CACR,OAAO,IAAI,MAAM,QAAQ;EACvB,MAAM,OAAO,MAAM;EACnB,IAAI,CAAC,KAAK,KAAK,GAAG;GAChB;GACA;EACF;EACA,IAAI,GAAG,MAAM,KAAK,IAAI,GAAG;GACvB,MAAM,OAAiB,CAAC;GACxB;GACA,OAAO,IAAI,MAAM,UAAU,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,GAAG,KAAK,KAAK,MAAM,IAAI;GACzE,IAAI,KAAK,MAAM,QAAQ,MAAM,IAAI,MAAM,qBAAqB;GAC5D;GACA,IAAI,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,EAAE,OAAO;GAC7C;EACF;EACA,IAAI,UAAU,KAAK,KAAK,KAAK,CAAC,GAAG;GAC/B,MAAM,MAAgB,CAAC;GACvB,OAAO,IAAI,MAAM,UAAU,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,KAAK,MAAM,IAAI;GAC/D,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC;GACtB;EACF;EACA,IAAI,IAAI,KAAK,MAAM,GAAG,OAAO;EAC7B,IAAI,GAAG;GACL,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC,OAAO,GAAG,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE;GAC/D;GACA;EACF;EACA,IAAI,GAAG,GAAG,KAAK,IAAI,GAAG;GACpB,IAAI,KAAK,MAAM;GACf;GACA;EACF;EACA,IAAI,KAAK,MAAM,GAAG,KAAK;EACvB,IAAI,GAAG;GAEL,IAAI,KAAK,qBAAqB,QAAQ,SAAS,EAAE,EAAE,CAAC,EAAE,SAAS,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,MAAM,IAAI,EAAE,EAAE,EAAE,QAAQ,IAAI;GAC7H;GACA;EACF;EACA,IAAI,GAAG,MAAM,KAAK,IAAI,GAAG;GACvB,MAAM,IAAc,CAAC;GACrB,OAAO,IAAI,MAAM,UAAU,GAAG,MAAM,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,MAAM,IAAI,CAAC,QAAQ,WAAW,EAAE,CAAC;GAC5F,IAAI,KAAK,eAAe,EAAE,KAAK,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,KAAK,UAAU,EAAE,cAAc;GACnG;EACF;EACA,IAAI,GAAG,GAAG,KAAK,IAAI,KAAK,GAAG,GAAG,KAAK,IAAI,GAAG;GACxC,MAAM,UAAU,CAAC,GAAG,GAAG,KAAK,IAAI;GAChC,MAAM,KAAK,UAAU,GAAG,KAAK,GAAG;GAChC,MAAM,QAAkB,CAAC;GACzB,OAAO,IAAI,MAAM,UAAU,GAAG,KAAK,MAAM,EAAE,GAAG,MAAM,KAAK,OAAO,SAAS,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAE,EAAE,EAAE,MAAM;GACzG,IAAI,KAAK,UAAU,OAAO,MAAM,KAAK,EAAE,EAAE,SAAS,OAAO,MAAM,KAAK,EAAE,EAAE,MAAM;GAC9E;EACF;EACA,MAAM,OAAiB,CAAC;EACxB,OAAO,IAAI,MAAM,UAAU,MAAM,EAAE,CAAC,KAAK,MAAM,KAAK,WAAW,KAAK,CAAC,YAAY,MAAM,EAAE,IAAI,KAAK,KAAK,MAAM,IAAI;EACjH,IAAI,KAAK,MAAM,SAAS,KAAK,KAAK,IAAI,CAAC,EAAE,KAAK;CAChD;CACA,OAAO,SAAS,IAAI,KAAK,EAAE,CAAC;AAC9B;;AAGA,IAAa,qBAAqB,MAAc,UAAU,KAAK,CAAC,KAAK,6CAA6C,KAAK,CAAC,KAAK,oCAAoC,KAAK,CAAC"}

package/dist/controls/rich-text/ops.d.ts

@@ -0,0 +1,35 @@
+/**
+ * RICH TEXT · pure DOM block operations on the editor surface (V2 HEAD controls/rich-text/ops.ts; no React, no
+ * emitting). The editor wraps each one, then serializes and emits the new value.
+ */
+import { type IslandEl, type IslandKind, type IslandModels } from "./dom";
+import type { RichTextFeature } from "./codec";
+import type { BasicId } from "./catalog";
+/** The writable line after a block, created when the block is last or followed by another rich block. */
+export declare function ensureLineAfter(b: Element): HTMLElement;
+export declare function duplicateBlock(b: HTMLElement): HTMLElement;
+/** Moves a block one step, keeping the caret where it was. Returns false at the edge. */
+export declare function moveBlock(b: HTMLElement, dir: -1 | 1): boolean;
+/** Text / Heading / Quote / Code. Returns the new element, or null when nothing changed. */
+export declare function turnInto(root: HTMLElement, b: HTMLElement | null, tag: string): HTMLElement | null;
+/** An empty paragraph at the caret to build a block from (reuses the current one when it is empty). */
+export declare function takeEmptyBlock(root: HTMLElement): HTMLElement;
+export declare function insertIsland<K extends IslandKind>(root: HTMLElement, kind: K, model?: IslandModels[K]): IslandEl;
+/** Inserts a basic block at the caret. */
+export declare function insertBasic(root: HTMLElement, id: BasicId): void;
+/**
+ * "# ", "> ", "- ", "1. " and "---" at the start of a paragraph, each only when the field accepts what it makes.
+ * Returns true when it converted.
+ */
+export declare function liveMarkdown(root: HTMLElement, data: string | null, allows?: (f: RichTextFeature) => boolean): boolean;
+/** `text` typed between backticks becomes inline code. */
+export declare function liveInlineCode(): boolean;
+/**
+ * HTML with every element the field does not accept turned into what it does: a heading / quote / code block becomes a
+ * paragraph, a list becomes one paragraph per item, a mark or link is unwrapped to its text, a divider or image is
+ * removed. `dropped` names what was taken out entirely (said to the author, never silent).
+ */
+export declare function restrictHtml(html: string, allows: (f: RichTextFeature) => boolean): {
+    html: string;
+    dropped: string[];
+};