@bettercms-ai/kit 0.1.1 → 2.0.0

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

@@ -0,0 +1,316 @@
+import { cloneModel, closestBlock, createIsland, defaultModel, esc, placeCaret, textBeforeCaret, topBlock } from "./dom.js";
+//#region src/controls/rich-text/ops.ts
+/**
+* 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.
+*/
+var emptyP = () => {
+	const p = document.createElement("p");
+	p.innerHTML = "<br>";
+	return p;
+};
+var isWritable = (el) => !!el && !el.hasAttribute("data-rt-island") && el.tagName !== "HR";
+/** The writable line after a block, created when the block is last or followed by another rich block. */
+function ensureLineAfter(b) {
+	const next = b.nextElementSibling;
+	if (isWritable(next)) return next;
+	const p = emptyP();
+	b.after(p);
+	return p;
+}
+function duplicateBlock(b) {
+	let c;
+	if (b.hasAttribute("data-rt-island")) {
+		const k = b.getAttribute("data-rt-island");
+		c = createIsland(k, cloneModel(k, b.__rt));
+	} else {
+		c = b.cloneNode(true);
+		c.removeAttribute("data-hint");
+	}
+	b.after(c);
+	return c;
+}
+/** Moves a block one step, keeping the caret where it was. Returns false at the edge. */
+function moveBlock(b, dir) {
+	const sib = dir < 0 ? b.previousElementSibling : b.nextElementSibling;
+	if (!sib) return false;
+	const s = window.getSelection();
+	const at = s && s.rangeCount ? {
+		n: s.getRangeAt(0).startContainer,
+		o: s.getRangeAt(0).startOffset
+	} : null;
+	const host = document.activeElement;
+	if (dir < 0) sib.before(b);
+	else sib.after(b);
+	if (at && s && b.contains(at.n)) {
+		host?.focus({ preventScroll: true });
+		const r = document.createRange();
+		r.setStart(at.n, Math.min(at.o, at.n.nodeType === 3 ? at.n.length : at.n.childNodes.length));
+		r.collapse(true);
+		s.removeAllRanges();
+		s.addRange(r);
+	}
+	return true;
+}
+/** Text / Heading / Quote / Code. Returns the new element, or null when nothing changed. */
+function turnInto(root, b, tag) {
+	if (!b || b.parentNode !== root || b.hasAttribute("data-rt-island") || b.tagName === "HR") return null;
+	if (b.tagName.toLowerCase() === tag) return null;
+	const inner = b.tagName === "UL" || b.tagName === "OL" ? Array.from(b.children).map((c) => c.innerHTML).join("<br>") : b.tagName === "PRE" ? esc(b.textContent ?? "").replace(/\n/g, "<br>") : b.innerHTML;
+	const n = document.createElement(tag);
+	n.innerHTML = tag === "pre" ? esc((b.textContent ?? "").replace(/​/g, "")) || "<br>" : inner || "<br>";
+	b.replaceWith(n);
+	root.focus({ preventScroll: true });
+	placeCaret(n);
+	return n;
+}
+/** An empty paragraph at the caret to build a block from (reuses the current one when it is empty). */
+function takeEmptyBlock(root) {
+	const s = window.getSelection();
+	const anchor = s && s.rangeCount && root.contains(s.anchorNode) ? s.anchorNode : null;
+	const li = anchor ? closestBlock(root, anchor) : null;
+	let b = topBlock(root, anchor);
+	if (li && li.tagName === "LI" && !li.textContent?.trim()) {
+		const list = li.parentElement;
+		li.remove();
+		if (!list.children.length) {
+			const p = emptyP();
+			list.replaceWith(p);
+			b = p;
+		} else b = list;
+	}
+	root.focus({ preventScroll: true });
+	if (b && b.tagName === "P" && !b.textContent?.replace(/​/g, "").trim() && !b.querySelector("img")) {
+		b.innerHTML = "<br>";
+		placeCaret(b);
+		return b;
+	}
+	if (b && /^(H[1-6]|BLOCKQUOTE|PRE)$/.test(b.tagName) && !b.textContent?.replace(/​/g, "").trim()) {
+		const p = emptyP();
+		b.replaceWith(p);
+		placeCaret(p);
+		return p;
+	}
+	const p = emptyP();
+	if (b) b.after(p);
+	else root.append(p);
+	placeCaret(p);
+	return p;
+}
+function insertIsland(root, kind, model = defaultModel(kind)) {
+	const target = takeEmptyBlock(root);
+	const isl = createIsland(kind, model);
+	isl.__rtFocus = true;
+	target.before(isl);
+	const next = target.nextElementSibling;
+	if (isWritable(next)) {
+		target.remove();
+		placeCaret(next, false);
+	} else placeCaret(target);
+	return isl;
+}
+/** Inserts a basic block at the caret. */
+function insertBasic(root, id) {
+	switch (id) {
+		case "p":
+			takeEmptyBlock(root);
+			return;
+		case "h1":
+		case "h2":
+		case "h3":
+		case "h4":
+		case "h5":
+		case "h6":
+			turnInto(root, takeEmptyBlock(root), id);
+			return;
+		case "quote":
+			turnInto(root, takeEmptyBlock(root), "blockquote");
+			return;
+		case "code":
+			turnInto(root, takeEmptyBlock(root), "pre");
+			return;
+		case "ul":
+		case "ol": {
+			const t = takeEmptyBlock(root);
+			const l = document.createElement(id);
+			l.innerHTML = "<li><br></li>";
+			t.replaceWith(l);
+			placeCaret(l.firstElementChild);
+			return;
+		}
+		case "hr": {
+			const t = takeEmptyBlock(root);
+			t.before(document.createElement("hr"));
+			placeCaret(t);
+			return;
+		}
+		case "image":
+		case "table":
+		case "pullquote":
+		case "takeaways":
+		case "callout":
+		case "toggle":
+		case "video":
+		case "file":
+			insertIsland(root, id);
+			return;
+	}
+}
+/**
+* "# ", "> ", "- ", "1. " and "---" at the start of a paragraph, each only when the field accepts what it makes.
+* Returns true when it converted.
+*/
+function liveMarkdown(root, data, allows = () => true) {
+	const s = window.getSelection();
+	if (!s || !s.rangeCount || !s.isCollapsed) return false;
+	const blk = topBlock(root, s.anchorNode);
+	if (!blk || blk.tagName !== "P") return false;
+	const before = textBeforeCaret(blk)?.replace(/ /g, " ");
+	if (before == null) return false;
+	if (data === "-" && before === "---" && (blk.textContent ?? "").replace(/ /g, " ") === "---") {
+		if (!allows("hr")) return false;
+		const p = emptyP();
+		blk.replaceWith(document.createElement("hr"), p);
+		placeCaret(p);
+		return true;
+	}
+	if (data !== " ") return false;
+	const h = before.match(/^(#{1,6}) $/);
+	let tag = h ? `h${h[1].length}` : before === "> " ? "blockquote" : null;
+	let list = before === "- " || before === "* " ? "ul" : /^1[.)] $/.test(before) ? "ol" : null;
+	if (tag && !allows(tag)) tag = null;
+	if (list && !allows(list)) list = null;
+	if (!tag && !list) return false;
+	const r = document.createRange();
+	r.selectNodeContents(blk);
+	r.setEnd(s.anchorNode, s.anchorOffset);
+	r.deleteContents();
+	const html = blk.textContent || blk.querySelector("img") ? blk.innerHTML : "<br>";
+	let target;
+	if (tag) {
+		target = document.createElement(tag);
+		target.innerHTML = html;
+		blk.replaceWith(target);
+	} else {
+		const l = document.createElement(list);
+		target = document.createElement("li");
+		target.innerHTML = html;
+		l.append(target);
+		blk.replaceWith(l);
+	}
+	placeCaret(target, false);
+	return true;
+}
+/** `text` typed between backticks becomes inline code. */
+function liveInlineCode() {
+	const s = window.getSelection();
+	if (!s || !s.rangeCount || !s.isCollapsed) return false;
+	const r = s.getRangeAt(0);
+	if (r.startContainer.nodeType !== 3 || r.startContainer.parentElement?.closest("code,pre")) return false;
+	const node = r.startContainer;
+	const m = node.data.slice(0, r.startOffset).match(/`([^`\n]+)`$/);
+	if (!m) return false;
+	const del = document.createRange();
+	del.setStart(node, r.startOffset - m[0].length);
+	del.setEnd(node, r.startOffset);
+	del.deleteContents();
+	const code = document.createElement("code");
+	code.textContent = m[1];
+	del.insertNode(code);
+	const next = code.nextSibling;
+	if (next && next.nodeType === 3 && next.textContent) {
+		const c = document.createRange();
+		c.setStart(next, 0);
+		c.collapse(true);
+		s.removeAllRanges();
+		s.addRange(c);
+	} else {
+		const after = document.createTextNode("​");
+		code.after(after);
+		placeCaret(after);
+	}
+	return true;
+}
+var MARK_FEATURE = {
+	STRONG: "bold",
+	B: "bold",
+	EM: "italic",
+	I: "italic",
+	U: "underline",
+	S: "strike",
+	STRIKE: "strike",
+	DEL: "strike",
+	CODE: "code",
+	A: "link"
+};
+var BLOCK_FEATURE = {
+	H1: "h1",
+	H2: "h2",
+	H3: "h3",
+	H4: "h4",
+	H5: "h5",
+	H6: "h6",
+	BLOCKQUOTE: "blockquote",
+	UL: "ul",
+	OL: "ol",
+	PRE: "pre",
+	HR: "hr",
+	FIGURE: "image",
+	IMG: "image"
+};
+var FEATURE_WORD = {
+	image: "images",
+	hr: "dividers",
+	pre: "code blocks",
+	ul: "bulleted lists",
+	ol: "numbered lists",
+	blockquote: "quotes",
+	link: "links"
+};
+/**
+* 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).
+*/
+function restrictHtml(html, allows) {
+	if (!html) return {
+		html,
+		dropped: []
+	};
+	const doc = new DOMParser().parseFromString(`<body>${html}</body>`, "text/html");
+	const dropped = /* @__PURE__ */ new Set();
+	const walk = (el) => {
+		for (const ch of Array.from(el.children)) {
+			walk(ch);
+			const mark = MARK_FEATURE[ch.tagName];
+			const block = BLOCK_FEATURE[ch.tagName];
+			if (mark && !allows(mark)) ch.replaceWith(...Array.from(ch.childNodes));
+			else if (block && !allows(block)) {
+				if (block === "hr" || block === "image") {
+					dropped.add(FEATURE_WORD[block]);
+					ch.remove();
+				} else if (block === "ul" || block === "ol") {
+					const ps = Array.from(ch.children).map((li) => {
+						const p = doc.createElement("p");
+						p.innerHTML = li.innerHTML;
+						return p;
+					});
+					ch.replaceWith(...ps);
+				} else {
+					const p = doc.createElement("p");
+					p.innerHTML = block === "pre" ? esc(ch.textContent ?? "").replace(/\n/g, "<br>") : ch.innerHTML;
+					ch.replaceWith(p);
+				}
+			}
+		}
+	};
+	walk(doc.body);
+	return {
+		html: doc.body.innerHTML,
+		dropped: [...dropped]
+	};
+}
+//#endregion
+export { duplicateBlock, ensureLineAfter, insertBasic, insertIsland, liveInlineCode, liveMarkdown, moveBlock, restrictHtml, takeEmptyBlock, turnInto };
+
+//# sourceMappingURL=ops.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ops.js","names":[],"sources":["../../../src/controls/rich-text/ops.ts"],"sourcesContent":["/**\n * RICH TEXT · pure DOM block operations on the editor surface (V2 HEAD controls/rich-text/ops.ts; no React, no\n * emitting). The editor wraps each one, then serializes and emits the new value.\n */\nimport { closestBlock, cloneModel, createIsland, defaultModel, esc, placeCaret, textBeforeCaret, topBlock, type IslandEl, type IslandKind, type IslandModels } from \"./dom\";\nimport type { RichTextFeature } from \"./codec\";\nimport type { BasicId } from \"./catalog\";\n\nconst emptyP = () => {\n  const p = document.createElement(\"p\");\n  p.innerHTML = \"<br>\";\n  return p;\n};\nconst isWritable = (el: Element | null): el is HTMLElement => !!el && !el.hasAttribute(\"data-rt-island\") && el.tagName !== \"HR\";\n\n/** The writable line after a block, created when the block is last or followed by another rich block. */\nexport function ensureLineAfter(b: Element): HTMLElement {\n  const next = b.nextElementSibling;\n  if (isWritable(next)) return next;\n  const p = emptyP();\n  b.after(p);\n  return p;\n}\n\nexport function duplicateBlock(b: HTMLElement): HTMLElement {\n  let c: HTMLElement;\n  if (b.hasAttribute(\"data-rt-island\")) {\n    const k = b.getAttribute(\"data-rt-island\") as IslandKind;\n    c = createIsland(k, cloneModel(k, (b as IslandEl).__rt as never));\n  } else {\n    c = b.cloneNode(true) as HTMLElement;\n    c.removeAttribute(\"data-hint\");\n  }\n  b.after(c);\n  return c;\n}\n\n/** Moves a block one step, keeping the caret where it was. Returns false at the edge. */\nexport function moveBlock(b: HTMLElement, dir: -1 | 1): boolean {\n  const sib = dir < 0 ? b.previousElementSibling : b.nextElementSibling;\n  if (!sib) return false;\n  const s = window.getSelection();\n  // ranges are live (a move collapses them), so keep the raw caret position\n  const at = s && s.rangeCount ? { n: s.getRangeAt(0).startContainer, o: s.getRangeAt(0).startOffset } : null;\n  const host = document.activeElement as HTMLElement | null;\n  if (dir < 0) sib.before(b);\n  else sib.after(b);\n  if (at && s && b.contains(at.n)) {\n    host?.focus({ preventScroll: true });\n    const r = document.createRange();\n    r.setStart(at.n, Math.min(at.o, at.n.nodeType === 3 ? (at.n as Text).length : at.n.childNodes.length));\n    r.collapse(true);\n    s.removeAllRanges();\n    s.addRange(r);\n  }\n  return true;\n}\n\n/** Text / Heading / Quote / Code. Returns the new element, or null when nothing changed. */\nexport function turnInto(root: HTMLElement, b: HTMLElement | null, tag: string): HTMLElement | null {\n  if (!b || b.parentNode !== root || b.hasAttribute(\"data-rt-island\") || b.tagName === \"HR\") return null;\n  if (b.tagName.toLowerCase() === tag) return null;\n  const inner =\n    b.tagName === \"UL\" || b.tagName === \"OL\"\n      ? Array.from(b.children).map((c) => c.innerHTML).join(\"<br>\")\n      : b.tagName === \"PRE\"\n        ? esc(b.textContent ?? \"\").replace(/\\n/g, \"<br>\")\n        : b.innerHTML;\n  const n = document.createElement(tag);\n  n.innerHTML = tag === \"pre\" ? esc((b.textContent ?? \"\").replace(/​/g, \"\")) || \"<br>\" : inner || \"<br>\";\n  b.replaceWith(n);\n  root.focus({ preventScroll: true });\n  placeCaret(n);\n  return n;\n}\n\n/** An empty paragraph at the caret to build a block from (reuses the current one when it is empty). */\nexport function takeEmptyBlock(root: HTMLElement): HTMLElement {\n  const s = window.getSelection();\n  const anchor = s && s.rangeCount && root.contains(s.anchorNode) ? s.anchorNode : null;\n  const li = anchor ? closestBlock(root, anchor) : null;\n  let b = topBlock(root, anchor);\n  if (li && li.tagName === \"LI\" && !li.textContent?.trim()) {\n    const list = li.parentElement!;\n    li.remove();\n    if (!list.children.length) {\n      const p = emptyP();\n      list.replaceWith(p);\n      b = p;\n    } else b = list;\n  }\n  root.focus({ preventScroll: true });\n  if (b && b.tagName === \"P\" && !b.textContent?.replace(/​/g, \"\").trim() && !b.querySelector(\"img\")) {\n    b.innerHTML = \"<br>\";\n    placeCaret(b);\n    return b;\n  }\n  // an empty heading, quote or code line (e.g. \"/\" typed on one) is reused too, so no empty block is left behind\n  if (b && /^(H[1-6]|BLOCKQUOTE|PRE)$/.test(b.tagName) && !b.textContent?.replace(/​/g, \"\").trim()) {\n    const p = emptyP();\n    b.replaceWith(p);\n    placeCaret(p);\n    return p;\n  }\n  const p = emptyP();\n  if (b) b.after(p);\n  else root.append(p);\n  placeCaret(p);\n  return p;\n}\n\nexport function insertIsland<K extends IslandKind>(root: HTMLElement, kind: K, model: IslandModels[K] = defaultModel(kind)): IslandEl {\n  const target = takeEmptyBlock(root);\n  const isl = createIsland(kind, model);\n  isl.__rtFocus = true;\n  target.before(isl);\n  // keep the document tidy: reuse the line that already follows instead of leaving an empty one\n  const next = target.nextElementSibling;\n  if (isWritable(next)) {\n    target.remove();\n    placeCaret(next, false);\n  } else placeCaret(target);\n  return isl;\n}\n\n/** Inserts a basic block at the caret. */\nexport function insertBasic(root: HTMLElement, id: BasicId) {\n  switch (id) {\n    case \"p\":\n      takeEmptyBlock(root);\n      return;\n    case \"h1\": case \"h2\": case \"h3\": case \"h4\": case \"h5\": case \"h6\":\n      turnInto(root, takeEmptyBlock(root), id);\n      return;\n    case \"quote\":\n      turnInto(root, takeEmptyBlock(root), \"blockquote\");\n      return;\n    case \"code\":\n      turnInto(root, takeEmptyBlock(root), \"pre\");\n      return;\n    case \"ul\": case \"ol\": {\n      const t = takeEmptyBlock(root);\n      const l = document.createElement(id);\n      l.innerHTML = \"<li><br></li>\";\n      t.replaceWith(l);\n      placeCaret(l.firstElementChild!);\n      return;\n    }\n    case \"hr\": {\n      const t = takeEmptyBlock(root);\n      t.before(document.createElement(\"hr\"));\n      placeCaret(t);\n      return;\n    }\n    case \"image\": case \"table\": case \"pullquote\": case \"takeaways\": case \"callout\": case \"toggle\": case \"video\": case \"file\":\n      insertIsland(root, id);\n      return;\n  }\n}\n\n/**\n * \"# \", \"> \", \"- \", \"1. \" and \"---\" at the start of a paragraph, each only when the field accepts what it makes.\n * Returns true when it converted.\n */\nexport function liveMarkdown(root: HTMLElement, data: string | null, allows: (f: RichTextFeature) => boolean = () => true): boolean {\n  const s = window.getSelection();\n  if (!s || !s.rangeCount || !s.isCollapsed) return false;\n  const blk = topBlock(root, s.anchorNode);\n  if (!blk || blk.tagName !== \"P\") return false;\n  const before = textBeforeCaret(blk)?.replace(/ /g, \" \");\n  if (before == null) return false;\n  if (data === \"-\" && before === \"---\" && (blk.textContent ?? \"\").replace(/ /g, \" \") === \"---\") {\n    if (!allows(\"hr\")) return false;\n    const p = emptyP();\n    blk.replaceWith(document.createElement(\"hr\"), p);\n    placeCaret(p);\n    return true;\n  }\n  if (data !== \" \") return false;\n  const h = before.match(/^(#{1,6}) $/);\n  let tag = h ? `h${h[1].length}` : before === \"> \" ? \"blockquote\" : null;\n  let list = before === \"- \" || before === \"* \" ? \"ul\" : /^1[.)] $/.test(before) ? \"ol\" : null;\n  if (tag && !allows(tag as RichTextFeature)) tag = null;\n  if (list && !allows(list as RichTextFeature)) list = null;\n  if (!tag && !list) return false;\n  const r = document.createRange();\n  r.selectNodeContents(blk);\n  r.setEnd(s.anchorNode!, s.anchorOffset);\n  r.deleteContents();\n  const html = blk.textContent || blk.querySelector(\"img\") ? blk.innerHTML : \"<br>\";\n  let target: HTMLElement;\n  if (tag) {\n    target = document.createElement(tag);\n    target.innerHTML = html;\n    blk.replaceWith(target);\n  } else {\n    const l = document.createElement(list!);\n    target = document.createElement(\"li\");\n    target.innerHTML = html;\n    l.append(target);\n    blk.replaceWith(l);\n  }\n  placeCaret(target, false);\n  return true;\n}\n\n/** `text` typed between backticks becomes inline code. */\nexport function liveInlineCode(): boolean {\n  const s = window.getSelection();\n  if (!s || !s.rangeCount || !s.isCollapsed) return false;\n  const r = s.getRangeAt(0);\n  if (r.startContainer.nodeType !== 3 || r.startContainer.parentElement?.closest(\"code,pre\")) return false;\n  const node = r.startContainer as Text;\n  const m = node.data.slice(0, r.startOffset).match(/`([^`\\n]+)`$/);\n  if (!m) return false;\n  const del = document.createRange();\n  del.setStart(node, r.startOffset - m[0].length);\n  del.setEnd(node, r.startOffset);\n  del.deleteContents();\n  const code = document.createElement(\"code\");\n  code.textContent = m[1];\n  del.insertNode(code);\n  const next = code.nextSibling;\n  if (next && next.nodeType === 3 && next.textContent) {\n    const c = document.createRange();\n    c.setStart(next, 0);\n    c.collapse(true);\n    s.removeAllRanges();\n    s.addRange(c);\n  } else {\n    const after = document.createTextNode(\"​\");\n    code.after(after);\n    placeCaret(after);\n  }\n  return true;\n}\n\n/* ── What a field accepts, applied to HTML that arrives from outside (paste, Markdown) ── */\nconst MARK_FEATURE: Record<string, RichTextFeature> = {\n  STRONG: \"bold\", B: \"bold\", EM: \"italic\", I: \"italic\", U: \"underline\", S: \"strike\", STRIKE: \"strike\", DEL: \"strike\", CODE: \"code\", A: \"link\",\n};\nconst BLOCK_FEATURE: Record<string, RichTextFeature> = {\n  H1: \"h1\", H2: \"h2\", H3: \"h3\", H4: \"h4\", H5: \"h5\", H6: \"h6\", BLOCKQUOTE: \"blockquote\", UL: \"ul\", OL: \"ol\", PRE: \"pre\", HR: \"hr\", FIGURE: \"image\", IMG: \"image\",\n};\nconst FEATURE_WORD: Partial<Record<RichTextFeature, string>> = {\n  image: \"images\", hr: \"dividers\", pre: \"code blocks\", ul: \"bulleted lists\", ol: \"numbered lists\", blockquote: \"quotes\", link: \"links\",\n};\n\n/**\n * HTML with every element the field does not accept turned into what it does: a heading / quote / code block becomes a\n * paragraph, a list becomes one paragraph per item, a mark or link is unwrapped to its text, a divider or image is\n * removed. `dropped` names what was taken out entirely (said to the author, never silent).\n */\nexport function restrictHtml(html: string, allows: (f: RichTextFeature) => boolean): { html: string; dropped: string[] } {\n  if (!html) return { html, dropped: [] };\n  const doc = new DOMParser().parseFromString(`<body>${html}</body>`, \"text/html\");\n  const dropped = new Set<string>();\n  const walk = (el: Element) => {\n    for (const ch of Array.from(el.children)) {\n      walk(ch);\n      const mark = MARK_FEATURE[ch.tagName];\n      const block = BLOCK_FEATURE[ch.tagName];\n      if (mark && !allows(mark)) ch.replaceWith(...Array.from(ch.childNodes));\n      else if (block && !allows(block)) {\n        if (block === \"hr\" || block === \"image\") {\n          dropped.add(FEATURE_WORD[block]!);\n          ch.remove();\n        } else if (block === \"ul\" || block === \"ol\") {\n          const ps = Array.from(ch.children).map((li) => {\n            const p = doc.createElement(\"p\");\n            p.innerHTML = li.innerHTML;\n            return p;\n          });\n          ch.replaceWith(...ps);\n        } else {\n          const p = doc.createElement(\"p\");\n          p.innerHTML = block === \"pre\" ? esc(ch.textContent ?? \"\").replace(/\\n/g, \"<br>\") : ch.innerHTML;\n          ch.replaceWith(p);\n        }\n      }\n    }\n  };\n  walk(doc.body);\n  return { html: doc.body.innerHTML, dropped: [...dropped] };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,17 @@
+/**
+ * Plain paragraphs as a growing textarea (V2's `text` control), for hosts where V2 shows long text as a textarea
+ * rather than the rich editor: the canvas Values popover. A rich-text value whose html is only plain paragraphs
+ * reads as one line per `<p>`; one that carries marks, links, line breaks, lists or attributes returns null and
+ * keeps the rich editor, so editing never strips them. The textarea's text goes back as one `<p>` per line through
+ * the field's own codec, so the stored shape is the field's as before.
+ */
+import * as React from "react";
+/** The html as textarea text — one line per `<p>` — or null when a textarea cannot carry it back unchanged. */
+export declare function plainParagraphs(html: unknown): string | null;
+/** Textarea text back to the paragraph html `plainParagraphs` reads: one `<p>` per line. */
+export declare function paragraphsHtml(text: string): string;
+/** Inside this scope a rich-text field holding plain paragraphs is drawn as V2's growing textarea. */
+export declare function PlainRichTextScope({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare const usePlainRichText: () => boolean;

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

@@ -0,0 +1,44 @@
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/controls/rich-text/plain.tsx
+/**
+* Plain paragraphs as a growing textarea (V2's `text` control), for hosts where V2 shows long text as a textarea
+* rather than the rich editor: the canvas Values popover. A rich-text value whose html is only plain paragraphs
+* reads as one line per `<p>`; one that carries marks, links, line breaks, lists or attributes returns null and
+* keeps the rich editor, so editing never strips them. The textarea's text goes back as one `<p>` per line through
+* the field's own codec, so the stored shape is the field's as before.
+*/
+/** The html as textarea text — one line per `<p>` — or null when a textarea cannot carry it back unchanged. */
+function plainParagraphs(html) {
+	if (html === void 0 || html === null || html === "") return "";
+	if (typeof html !== "string") return null;
+	const body = new DOMParser().parseFromString(html, "text/html").body;
+	const lines = [];
+	for (const node of Array.from(body.childNodes)) {
+		if (node.nodeType === Node.TEXT_NODE && !node.textContent?.trim()) continue;
+		if (node.nodeType !== Node.ELEMENT_NODE) return null;
+		const el = node;
+		if (el.tagName !== "P" || el.attributes.length || Array.from(el.childNodes).some((c) => c.nodeType !== Node.TEXT_NODE)) return null;
+		if (el.textContent?.includes("\n")) return null;
+		lines.push(el.textContent ?? "");
+	}
+	return lines.join("\n");
+}
+var escapeHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+/** Textarea text back to the paragraph html `plainParagraphs` reads: one `<p>` per line. */
+function paragraphsHtml(text) {
+	return text.split(/\r?\n/).map((line) => `<p>${escapeHtml(line)}</p>`).join("");
+}
+var PlainRichText = React.createContext(false);
+/** Inside this scope a rich-text field holding plain paragraphs is drawn as V2's growing textarea. */
+function PlainRichTextScope({ children }) {
+	return /* @__PURE__ */ jsx(PlainRichText.Provider, {
+		value: true,
+		children
+	});
+}
+var usePlainRichText = () => React.useContext(PlainRichText);
+//#endregion
+export { PlainRichTextScope, paragraphsHtml, plainParagraphs, usePlainRichText };
+
+//# sourceMappingURL=plain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plain.js","names":[],"sources":["../../../src/controls/rich-text/plain.tsx"],"sourcesContent":["/**\n * Plain paragraphs as a growing textarea (V2's `text` control), for hosts where V2 shows long text as a textarea\n * rather than the rich editor: the canvas Values popover. A rich-text value whose html is only plain paragraphs\n * reads as one line per `<p>`; one that carries marks, links, line breaks, lists or attributes returns null and\n * keeps the rich editor, so editing never strips them. The textarea's text goes back as one `<p>` per line through\n * the field's own codec, so the stored shape is the field's as before.\n */\nimport * as React from \"react\";\n\n/** The html as textarea text — one line per `<p>` — or null when a textarea cannot carry it back unchanged. */\nexport function plainParagraphs(html: unknown): string | null {\n  if (html === undefined || html === null || html === \"\") return \"\";\n  if (typeof html !== \"string\") return null;\n  const body = new DOMParser().parseFromString(html, \"text/html\").body;\n  const lines: string[] = [];\n  for (const node of Array.from(body.childNodes)) {\n    if (node.nodeType === Node.TEXT_NODE && !node.textContent?.trim()) continue;\n    if (node.nodeType !== Node.ELEMENT_NODE) return null;\n    const el = node as Element;\n    if (el.tagName !== \"P\" || el.attributes.length || Array.from(el.childNodes).some((c) => c.nodeType !== Node.TEXT_NODE)) return null;\n    if (el.textContent?.includes(\"\\n\")) return null;\n    lines.push(el.textContent ?? \"\");\n  }\n  return lines.join(\"\\n\");\n}\n\nconst escapeHtml = (s: string) => s.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\");\n\n/** Textarea text back to the paragraph html `plainParagraphs` reads: one `<p>` per line. */\nexport function paragraphsHtml(text: string): string {\n  return text.split(/\\r?\\n/).map((line) => `<p>${escapeHtml(line)}</p>`).join(\"\");\n}\n\nconst PlainRichText = React.createContext(false);\n\n/** Inside this scope a rich-text field holding plain paragraphs is drawn as V2's growing textarea. */\nexport function PlainRichTextScope({ children }: { children: React.ReactNode }) {\n  return <PlainRichText.Provider value>{children}</PlainRichText.Provider>;\n}\n\nexport const usePlainRichText = () => React.useContext(PlainRichText);\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,gBAAgB,MAA8B;CAC5D,IAAI,SAAS,KAAA,KAAa,SAAS,QAAQ,SAAS,IAAI,OAAO;CAC/D,IAAI,OAAO,SAAS,UAAU,OAAO;CACrC,MAAM,OAAO,IAAI,UAAU,CAAC,CAAC,gBAAgB,MAAM,WAAW,CAAC,CAAC;CAChE,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,QAAQ,MAAM,KAAK,KAAK,UAAU,GAAG;EAC9C,IAAI,KAAK,aAAa,KAAK,aAAa,CAAC,KAAK,aAAa,KAAK,GAAG;EACnE,IAAI,KAAK,aAAa,KAAK,cAAc,OAAO;EAChD,MAAM,KAAK;EACX,IAAI,GAAG,YAAY,OAAO,GAAG,WAAW,UAAU,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,MAAM,MAAM,EAAE,aAAa,KAAK,SAAS,GAAG,OAAO;EAC/H,IAAI,GAAG,aAAa,SAAS,IAAI,GAAG,OAAO;EAC3C,MAAM,KAAK,GAAG,eAAe,EAAE;CACjC;CACA,OAAO,MAAM,KAAK,IAAI;AACxB;AAEA,IAAM,cAAc,MAAc,EAAE,QAAQ,MAAM,OAAO,CAAC,CAAC,QAAQ,MAAM,MAAM,CAAC,CAAC,QAAQ,MAAM,MAAM;;AAGrG,SAAgB,eAAe,MAAsB;CACnD,OAAO,KAAK,MAAM,OAAO,CAAC,CAAC,KAAK,SAAS,MAAM,WAAW,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE;AAChF;AAEA,IAAM,gBAAgB,MAAM,cAAc,KAAK;;AAG/C,SAAgB,mBAAmB,EAAE,YAA2C;CAC9E,OAAO,oBAAC,cAAc,UAAf;EAAwB,OAAA;EAAO;CAAiC,CAAA;AACzE;AAEA,IAAa,yBAAyB,MAAM,WAAW,aAAa"}

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

@@ -0,0 +1,89 @@
+/**
+ * RICH TEXT · the field toolbar (V2 HEAD controls/rich-text/toolbar.tsx, production order):
+ *   Style ▾ | B I U S | • 1. | Link, Clear formatting, Comment | ▾ more | + Insert   ·····   Markdown · Open full editor
+ * The overflow is a chevron next to the formatting, never a second "⋯" (the field's label row owns the one ⋯ menu).
+ * It takes no room at rest (h-0, inert, aria-hidden) and slides open to 32px when the field is in use. Items fold into
+ * "More formatting options" as the field narrows. A control whose element the field does not accept is not drawn.
+ */
+import * as React from "react";
+import { type CatalogItem } from "./catalog";
+import type { RichTextFeature } from "./codec";
+export interface Fmt {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strike: boolean;
+    sup: boolean;
+    sub: boolean;
+    ul: boolean;
+    ol: boolean;
+    /** lower-case tag of the caret's top-level block, or "island" */
+    block: string;
+    hasSel: boolean;
+    onLink: boolean;
+}
+export declare const EMPTY_FMT: Fmt;
+export type MarkCmd = "bold" | "italic" | "underline" | "strikeThrough" | "superscript" | "subscript";
+export declare const MARK_FEATURE: Record<MarkCmd, RichTextFeature>;
+export declare const STYLES: {
+    tag: string;
+    label: string;
+    short: string;
+    icon: React.ReactNode;
+}[];
+/** The block styles a field accepts (Text always). */
+export declare const stylesFor: (allows: (f: RichTextFeature) => boolean) => {
+    tag: string;
+    label: string;
+    short: string;
+    icon: React.ReactNode;
+}[];
+export declare function ToolButton({ label, tip, icon, onClick, active, disabled, shortcut, children, className, side, }: {
+    label: string;
+    tip?: string;
+    icon: React.ReactNode;
+    onClick?: () => void;
+    active?: boolean;
+    disabled?: boolean;
+    shortcut?: string;
+    children?: React.ReactNode;
+    className?: string;
+    /** The tooltip's side; the overlay's default (top) when omitted. */
+    side?: "top" | "bottom" | "left" | "right";
+}): import("react/jsx-runtime").JSX.Element;
+/** "Block style" dropdown. Compact trigger: Text / H1…H6 / Quote. */
+export declare function StyleMenu({ block, styles, onPick, onOpenChange, disabled, className, }: {
+    block: string;
+    styles: typeof STYLES;
+    onPick: (tag: string) => void;
+    onOpenChange?: (o: boolean) => void;
+    disabled?: boolean;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function FormatToolbar({ open, sticky, stickyTop, width, dense, fmt, md, allows, hideFullscreen, insertOpen, setInsertOpen, onMenuOpen, onStyle, onMark, onList, onLink, onClear, onComment, onInlineCode, onCodeBlock, onInsert, keepFocusOnInsertClose, onFullscreen, onMarkdown, saveSel, }: {
+    open: boolean;
+    sticky: boolean;
+    stickyTop?: number;
+    width: number;
+    dense: boolean;
+    fmt: Fmt;
+    md: boolean;
+    allows: (f: RichTextFeature) => boolean;
+    hideFullscreen?: boolean;
+    insertOpen: boolean;
+    setInsertOpen: (o: boolean) => void;
+    onMenuOpen: (name: "style" | "more", o: boolean) => void;
+    onStyle: (tag: string) => void;
+    onMark: (cmd: MarkCmd) => void;
+    onList: (kind: "ul" | "ol") => void;
+    onLink: () => void;
+    onClear: () => void;
+    onComment?: () => void;
+    onInlineCode: () => void;
+    onCodeBlock: () => void;
+    onInsert: (it: CatalogItem) => void;
+    keepFocusOnInsertClose: () => boolean;
+    onFullscreen: () => void;
+    onMarkdown: () => void;
+    saveSel: () => void;
+}): import("react/jsx-runtime").JSX.Element;