@bettercms-ai/kit 2.0.0 → 2.0.1

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

@@ -0,0 +1,233 @@
+import { useRichTextRefs } from "../../context.js";
+import { ArticleEmpty, ArticlePanelBlock } from "./article-shell.js";
+import * as React from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { IconPlus } from "@tabler/icons-react";
+//#region src/controls/rich-text/related.tsx
+/**
+* RICH TEXT · Related posts (kit-richtext-ui-spec.md §6): V2's article block, stored as the PT block object
+* `{ _type: "relatedPosts", title?, mode, count, posts: { _ref }[] }`. Each post's title, cover, category and URL are
+* derived from the referenced or queried entries, never stored.
+*
+*   modes     e1 2026-10-24 (signed deviation from V2's Automatic | Hand-picked): Same topic (topic) · Newest (newest) ·
+*             Hand-picked (manual). "How many" shows for the two automatic modes, Posts for Hand-picked. The schema's
+*             `hidden` is "show only when" (schema/types.ts), as V2's was.
+*   form      V2 article.ts:167-195: Title (≤40, default "Related stories"), Stories (segmented), How many (1–6),
+*             Posts (1–6 unique references to the field's collection). Four settings → the floating panel (D54).
+*   preview   V2 article-blocks.tsx:572-597: the title with the automatic mode's tag, three post cards (4:3 cover,
+*             two-line title, category); "Pick stories" when Hand-picked holds nothing that resolves.
+*   data      KitServices.resolveRichTextRefs (useRichTextRefs): ids for Hand-picked, a query for the automatic modes.
+*             A fresh insert focuses the card (V2 article-blocks.tsx:131).
+*/
+var RELATED_LABEL = "Related posts";
+/** `topic: false`: the collection has nothing to rank Same topic by, so a new block is Newest. */
+var relatedDefault = (topic = true) => ({
+	title: "Related stories",
+	mode: topic ? "topic" : "newest",
+	count: 3,
+	posts: []
+});
+/** Why Same topic is not offered (RichTextRead.references.topic false; the entry write's relatedPosts.no_topic_field). */
+var NO_TOPIC_REASON = "Same topic needs a tags or category field on this collection.";
+var MODE_TAG = {
+	topic: "Same topic",
+	newest: "Newest"
+};
+var asMode = (v) => v === "newest" || v === "manual" ? v : "topic";
+var clampCount = (v) => Math.min(6, Math.max(1, Math.round(Number(v) || 3)));
+/**
+* The panel form; `to` is the field's collection. "How many" explains the chosen automatic mode. With `topic` false,
+* Same topic is left out and Stories says why (a stored Same topic block keeps the option, so its value still shows).
+*/
+var relatedSchema = (to, mode, topic = true, pick = {}) => ({
+	name: "relatedPosts",
+	title: RELATED_LABEL,
+	kind: "object",
+	icon: "news",
+	fields: [
+		{
+			name: "title",
+			title: "Title",
+			type: "string",
+			validation: { max: 40 }
+		},
+		{
+			name: "mode",
+			title: "Stories",
+			type: "select",
+			layout: "segmented",
+			initialValue: topic ? "topic" : "newest",
+			options: [
+				...topic || mode === "topic" ? [{
+					value: "topic",
+					label: "Same topic"
+				}] : [],
+				{
+					value: "newest",
+					label: "Newest"
+				},
+				{
+					value: "manual",
+					label: "Hand-picked"
+				}
+			],
+			...topic ? {} : { description: NO_TOPIC_REASON }
+		},
+		{
+			name: "count",
+			title: "How many",
+			type: "number",
+			hidden: {
+				field: "mode",
+				op: "in",
+				value: ["topic", "newest"]
+			},
+			numeric: {
+				min: 1,
+				max: 6,
+				step: 1
+			},
+			description: mode === "newest" ? "Newest first." : "Same topic, newest first."
+		},
+		{
+			name: "posts",
+			title: "Posts",
+			type: "array",
+			hidden: {
+				field: "mode",
+				equals: "manual"
+			},
+			validation: {
+				min: 1,
+				max: 6,
+				unique: true
+			},
+			of: [{
+				name: "post",
+				title: "Post",
+				type: "reference",
+				reference: {
+					to,
+					...pick.noun ? { noun: pick.noun } : {},
+					...pick.excludeId ? { excludeId: pick.excludeId } : {}
+				}
+			}]
+		}
+	]
+});
+/** What the preview asks the host for: the picked ids, or the automatic mode's query. */
+function relatedRequest(m, collection, excludeId) {
+	if (m.mode === "manual") return m.posts.length ? {
+		kind: "relatedPosts",
+		ids: m.posts
+	} : null;
+	return {
+		kind: "relatedPosts",
+		query: {
+			collection,
+			mode: m.mode,
+			count: m.count,
+			excludeId
+		}
+	};
+}
+function RelatedPreview({ m, onPick, ro, collection, excludeId }) {
+	const { items, loading, error } = useRichTextRefs(relatedRequest(m, collection, excludeId));
+	const posts = m.mode === "manual" ? m.posts.map((id) => items.find((x) => x.id === id)).filter((x) => !!x) : items;
+	if (m.mode === "manual" && !loading && !error && !posts.length) return /* @__PURE__ */ jsx(ArticleEmpty, {
+		icon: /* @__PURE__ */ jsx(IconPlus, { stroke: 1.5 }),
+		title: m.title || "Related posts",
+		action: "Pick stories",
+		onAction: onPick,
+		ro
+	});
+	return /* @__PURE__ */ jsxs("aside", {
+		className: "rounded-kit-lg border border-kit-line bg-kit-surface px-4 py-3",
+		"aria-label": m.title || "Related posts",
+		"aria-busy": loading || void 0,
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "mb-2 flex items-baseline gap-2",
+			children: [m.title ? /* @__PURE__ */ jsx("p", {
+				"data-field": "title",
+				className: "text-kit-sm font-semibold text-kit-fg",
+				children: m.title
+			}) : null, m.mode !== "manual" ? /* @__PURE__ */ jsx("span", {
+				"data-field": "mode",
+				className: "text-kit-2xs text-kit-fg-3",
+				children: MODE_TAG[m.mode]
+			}) : null]
+		}), error ? /* @__PURE__ */ jsxs("p", {
+			role: "status",
+			className: "text-kit-sm text-kit-warning-fg",
+			children: ["The stories couldn't load: ", error]
+		}) : /* @__PURE__ */ jsx("ul", {
+			className: "m-0 grid grid-cols-3 gap-3 p-0",
+			"data-field": m.mode === "manual" ? "posts" : "count",
+			children: posts.map((e) => /* @__PURE__ */ jsxs("li", {
+				className: "min-w-0 list-none",
+				children: [
+					e.cover ? /* @__PURE__ */ jsx("img", {
+						src: e.cover,
+						alt: "",
+						draggable: false,
+						className: "block aspect-[4/3] w-full rounded-kit-md border border-kit-line object-cover"
+					}) : /* @__PURE__ */ jsx("div", { className: "aspect-[4/3] rounded-kit-md bg-kit-muted" }),
+					/* @__PURE__ */ jsx("p", {
+						className: "mt-1.5 line-clamp-2 text-kit-xs font-medium leading-snug text-kit-fg",
+						children: e.title
+					}),
+					e.category ? /* @__PURE__ */ jsx("p", {
+						className: "mt-0.5 truncate text-kit-2xs text-kit-fg-3",
+						children: e.category
+					}) : null
+				]
+			}, e.id))
+		})]
+	});
+}
+function RelatedBlock({ m, set, el, ctx, autoFocus, collection, excludeId, topic = true, noun }) {
+	const schema = React.useMemo(() => relatedSchema([collection], m.mode, topic, {
+		noun,
+		excludeId
+	}), [
+		collection,
+		m.mode,
+		topic,
+		noun,
+		excludeId
+	]);
+	return /* @__PURE__ */ jsx(ArticlePanelBlock, {
+		label: RELATED_LABEL,
+		kind: "related",
+		schema,
+		m,
+		set,
+		el,
+		ctx,
+		autoFocus,
+		openOnInsert: false,
+		toForm: (x) => ({
+			title: x.title,
+			mode: x.mode,
+			count: x.count,
+			posts: x.posts
+		}),
+		fromForm: (v) => ({
+			title: String(v.title ?? ""),
+			mode: asMode(v.mode),
+			count: clampCount(v.count),
+			posts: Array.isArray(v.posts) ? v.posts.filter((x) => typeof x === "string") : []
+		}),
+		children: (open, ro) => /* @__PURE__ */ jsx(RelatedPreview, {
+			m,
+			onPick: () => open("posts"),
+			ro,
+			collection,
+			excludeId
+		})
+	});
+}
+//#endregion
+export { NO_TOPIC_REASON, RELATED_LABEL, RelatedBlock, RelatedPreview, relatedDefault, relatedRequest, relatedSchema };
+
+//# sourceMappingURL=related.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"related.js","names":[],"sources":["../../../src/controls/rich-text/related.tsx"],"sourcesContent":["/**\n * RICH TEXT · Related posts (kit-richtext-ui-spec.md §6): V2's article block, stored as the PT block object\n * `{ _type: \"relatedPosts\", title?, mode, count, posts: { _ref }[] }`. Each post's title, cover, category and URL are\n * derived from the referenced or queried entries, never stored.\n *\n *   modes     e1 2026-10-24 (signed deviation from V2's Automatic | Hand-picked): Same topic (topic) · Newest (newest) ·\n *             Hand-picked (manual). \"How many\" shows for the two automatic modes, Posts for Hand-picked. The schema's\n *             `hidden` is \"show only when\" (schema/types.ts), as V2's was.\n *   form      V2 article.ts:167-195: Title (≤40, default \"Related stories\"), Stories (segmented), How many (1–6),\n *             Posts (1–6 unique references to the field's collection). Four settings → the floating panel (D54).\n *   preview   V2 article-blocks.tsx:572-597: the title with the automatic mode's tag, three post cards (4:3 cover,\n *             two-line title, category); \"Pick stories\" when Hand-picked holds nothing that resolves.\n *   data      KitServices.resolveRichTextRefs (useRichTextRefs): ids for Hand-picked, a query for the automatic modes.\n *             A fresh insert focuses the card (V2 article-blocks.tsx:131).\n */\nimport * as React from \"react\";\nimport { IconPlus } from \"@tabler/icons-react\";\nimport { useRichTextRefs, type KitRichTextRefRequest } from \"../../context\";\nimport type { TypeSchema } from \"../../schema/types\";\nimport { ArticleEmpty, ArticlePanelBlock } from \"./article-shell\";\nimport type { IslandCtx } from \"./blocks\";\nimport type { IslandEl } from \"./dom\";\n\nexport type RelatedMode = \"topic\" | \"newest\" | \"manual\";\nexport interface RelatedModel {\n  title: string;\n  mode: RelatedMode;\n  count: number;\n  /** entry ids, Hand-picked only; the PT form wraps each as `{ _key, _ref }` */\n  posts: string[];\n}\nexport const RELATED_LABEL = \"Related posts\";\n/** `topic: false`: the collection has nothing to rank Same topic by, so a new block is Newest. */\nexport const relatedDefault = (topic = true): RelatedModel => ({ title: \"Related stories\", mode: topic ? \"topic\" : \"newest\", count: 3, posts: [] });\n/** Why Same topic is not offered (RichTextRead.references.topic false; the entry write's relatedPosts.no_topic_field). */\nexport const NO_TOPIC_REASON = \"Same topic needs a tags or category field on this collection.\";\nconst MODE_TAG: Record<Exclude<RelatedMode, \"manual\">, string> = { topic: \"Same topic\", newest: \"Newest\" };\nconst asMode = (v: unknown): RelatedMode => (v === \"newest\" || v === \"manual\" ? v : \"topic\");\nconst clampCount = (v: unknown) => Math.min(6, Math.max(1, Math.round(Number(v) || 3)));\n\n/**\n * The panel form; `to` is the field's collection. \"How many\" explains the chosen automatic mode. With `topic` false,\n * Same topic is left out and Stories says why (a stored Same topic block keeps the option, so its value still shows).\n */\nexport const relatedSchema = (to: string[], mode: RelatedMode, topic = true, pick: { noun?: string; excludeId?: string } = {}): TypeSchema => ({\n  name: \"relatedPosts\",\n  title: RELATED_LABEL,\n  kind: \"object\",\n  icon: \"news\",\n  fields: [\n    { name: \"title\", title: \"Title\", type: \"string\", validation: { max: 40 } },\n    {\n      name: \"mode\",\n      title: \"Stories\",\n      type: \"select\",\n      layout: \"segmented\",\n      initialValue: topic ? \"topic\" : \"newest\",\n      options: [\n        ...(topic || mode === \"topic\" ? [{ value: \"topic\", label: \"Same topic\" }] : []),\n        { value: \"newest\", label: \"Newest\" },\n        { value: \"manual\", label: \"Hand-picked\" },\n      ],\n      ...(topic ? {} : { description: NO_TOPIC_REASON }),\n    },\n    {\n      name: \"count\",\n      title: \"How many\",\n      type: \"number\",\n      hidden: { field: \"mode\", op: \"in\", value: [\"topic\", \"newest\"] },\n      numeric: { min: 1, max: 6, step: 1 },\n      description: mode === \"newest\" ? \"Newest first.\" : \"Same topic, newest first.\",\n    },\n    {\n      name: \"posts\",\n      title: \"Posts\",\n      type: \"array\",\n      hidden: { field: \"mode\", equals: \"manual\" },\n      validation: { min: 1, max: 6, unique: true },\n      // Hand-picked never lists the entry being edited, and names a post as its collection does\n      of: [{ name: \"post\", title: \"Post\", type: \"reference\", reference: { to, ...(pick.noun ? { noun: pick.noun } : {}), ...(pick.excludeId ? { excludeId: pick.excludeId } : {}) } }],\n    },\n  ],\n});\n\n/** What the preview asks the host for: the picked ids, or the automatic mode's query. */\nexport function relatedRequest(m: RelatedModel, collection?: string, excludeId?: string): KitRichTextRefRequest | null {\n  if (m.mode === \"manual\") return m.posts.length ? { kind: \"relatedPosts\", ids: m.posts } : null;\n  return { kind: \"relatedPosts\", query: { collection, mode: m.mode, count: m.count, excludeId } };\n}\n\nexport function RelatedPreview({ m, onPick, ro, collection, excludeId }: { m: RelatedModel; onPick: () => void; ro: boolean; collection?: string; excludeId?: string }) {\n  const { items, loading, error } = useRichTextRefs(relatedRequest(m, collection, excludeId));\n  // Hand-picked keeps the picked order; a post that no longer resolves is skipped (V2 .filter)\n  const posts = m.mode === \"manual\" ? m.posts.map((id) => items.find((x) => x.id === id)).filter((x): x is NonNullable<typeof x> => !!x) : items;\n  if (m.mode === \"manual\" && !loading && !error && !posts.length)\n    return <ArticleEmpty icon={<IconPlus stroke={1.5} />} title={m.title || RELATED_LABEL} action=\"Pick stories\" onAction={onPick} ro={ro} />;\n  return (\n    <aside className=\"rounded-kit-lg border border-kit-line bg-kit-surface px-4 py-3\" aria-label={m.title || RELATED_LABEL} aria-busy={loading || undefined}>\n      <div className=\"mb-2 flex items-baseline gap-2\">\n        {m.title ? (\n          <p data-field=\"title\" className=\"text-kit-sm font-semibold text-kit-fg\">\n            {m.title}\n          </p>\n        ) : null}\n        {m.mode !== \"manual\" ? (\n          <span data-field=\"mode\" className=\"text-kit-2xs text-kit-fg-3\">\n            {MODE_TAG[m.mode]}\n          </span>\n        ) : null}\n      </div>\n      {error ? (\n        <p role=\"status\" className=\"text-kit-sm text-kit-warning-fg\">\n          The stories couldn't load: {error}\n        </p>\n      ) : (\n        <ul className=\"m-0 grid grid-cols-3 gap-3 p-0\" data-field={m.mode === \"manual\" ? \"posts\" : \"count\"}>\n          {posts.map((e) => (\n            <li key={e.id} className=\"min-w-0 list-none\">\n              {e.cover ? (\n                <img src={e.cover} alt=\"\" draggable={false} className=\"block aspect-[4/3] w-full rounded-kit-md border border-kit-line object-cover\" />\n              ) : (\n                <div className=\"aspect-[4/3] rounded-kit-md bg-kit-muted\" />\n              )}\n              <p className=\"mt-1.5 line-clamp-2 text-kit-xs font-medium leading-snug text-kit-fg\">{e.title}</p>\n              {e.category ? <p className=\"mt-0.5 truncate text-kit-2xs text-kit-fg-3\">{e.category}</p> : null}\n            </li>\n          ))}\n        </ul>\n      )}\n    </aside>\n  );\n}\n\nexport function RelatedBlock({\n  m, set, el, ctx, autoFocus, collection, excludeId, topic = true, noun,\n}: {\n  m: RelatedModel;\n  set: (fn: (m: RelatedModel) => RelatedModel, label?: string) => void;\n  el: IslandEl;\n  ctx: IslandCtx;\n  autoFocus: boolean;\n  /** the posts collection (the field's config) */\n  collection: string;\n  /** the entry being edited, left out of the automatic modes */\n  excludeId?: string;\n  /** false: the collection has no topic field, so Same topic is not offered */\n  topic?: boolean;\n  /** what one post is called (the collection's singular); absent → the picker's own noun */\n  noun?: string;\n}) {\n  const schema = React.useMemo(() => relatedSchema([collection], m.mode, topic, { noun, excludeId }), [collection, m.mode, topic, noun, excludeId]);\n  return (\n    <ArticlePanelBlock<RelatedModel>\n      label={RELATED_LABEL}\n      kind=\"related\"\n      schema={schema}\n      m={m}\n      set={set}\n      el={el}\n      ctx={ctx}\n      autoFocus={autoFocus}\n      openOnInsert={false}\n      toForm={(x) => ({ title: x.title, mode: x.mode, count: x.count, posts: x.posts })}\n      fromForm={(v) => ({\n        title: String(v.title ?? \"\"),\n        mode: asMode(v.mode),\n        count: clampCount(v.count),\n        posts: Array.isArray(v.posts) ? v.posts.filter((x): x is string => typeof x === \"string\") : [],\n      })}\n    >\n      {(open, ro) => <RelatedPreview m={m} onPick={() => open(\"posts\")} ro={ro} collection={collection} excludeId={excludeId} />}\n    </ArticlePanelBlock>\n  );\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,47 @@
+import { slugify } from "@bettercms-ai/types";
+import type { TypeSchema } from "../../schema/types";
+import type { IslandCtx } from "./blocks";
+import { type IslandEl } from "./dom";
+export interface TocModel {
+    title: string;
+    depth: "2" | "3";
+}
+export declare const TOC_LABEL = "Table of contents";
+export declare const tocDefault: () => TocModel;
+/** The popover form (V2 ARTICLE_SCHEMAS.toc). Two settings → the shell's popover (D54). */
+export declare const TOC_SCHEMA: TypeSchema;
+export interface OutlineItem {
+    id: string;
+    text: string;
+    depth: 2 | 3;
+}
+/** V2 article.ts:250-251, the one heading-id rule the site stamps too (types heading-id.ts, plan RT5). */
+export { slugify };
+/** The body's H2 and H3, top level only, in order, with stable de-duplicated ids. */
+export declare function outlineOf(root: ParentNode): OutlineItem[];
+export declare const tocVisible: (outline: OutlineItem[], depth: TocModel["depth"]) => OutlineItem[];
+/** One live outline per editor: the editor sets it after each input, every TOC preview subscribes. */
+export interface OutlineStore {
+    get: () => OutlineItem[];
+    subscribe: (fn: () => void) => () => void;
+    set: (next: OutlineItem[]) => void;
+}
+export declare function createOutlineStore(): OutlineStore;
+export declare const NO_OUTLINE: OutlineStore;
+/** `host` is the TOC's island element; its parent is the editor surface whose headings it lists. */
+export declare function TocPreview({ m, outline, host }: {
+    m: TocModel;
+    outline: OutlineStore;
+    host: HTMLElement;
+}): import("react/jsx-runtime").JSX.Element;
+export interface TocBlockProps {
+    m: TocModel;
+    set: (fn: (m: TocModel) => TocModel, label?: string) => void;
+    el: IslandEl;
+    /** the editor's live outline rides the island context */
+    ctx: IslandCtx & {
+        outline?: OutlineStore;
+    };
+    autoFocus: boolean;
+}
+export declare function TocBlock({ m, set, el, ctx, autoFocus }: TocBlockProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,160 @@
+import { cn } from "../../lib/cn.js";
+import { ArticlePopoverBlock } from "./article-shell.js";
+import { placeCaret } from "./dom.js";
+import { slugify } from "@bettercms-ai/types";
+import * as React from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/controls/rich-text/toc.tsx
+/**
+* RICH TEXT · Table of contents (kit-richtext-ui-spec.md §5): V2's article block, stored as the PT block object
+* `{ _type: "tableOfContents", title?, depth: "2" | "3" }`. The list is derived from the same body's top-level H2/H3,
+* never stored.
+*
+*   form      V2 article.ts:137-156: Title (max 40, default "In this article"), Headings H2 | H2 and H3 (segmented)
+*   outline   V2 article.ts:248-266: the body's top-level non-empty H2/H3 in order, ids slugified and de-duplicated
+*             (x, x-2, …), the same ids the site stamps on its headings
+*   preview   V2 article-blocks.tsx:537-568: the nav as the reader sees it; each entry a button that scrolls the
+*             heading to the centre and puts the caret in it; "No headings yet." when there are none
+*   store     V2 article-blocks.tsx:45-66: one live outline per editor, so every TOC follows the headings as they are typed
+*
+* The block itself (card, chip, popover at its corner) is the shared article shell (article-shell.tsx, kit-40); it
+* opens on a fresh insert by focusing the card only (V2 article-blocks.tsx:131).
+*/
+var TOC_LABEL = "Table of contents";
+var tocDefault = () => ({
+	title: "In this article",
+	depth: "3"
+});
+/** The popover form (V2 ARTICLE_SCHEMAS.toc). Two settings → the shell's popover (D54). */
+var TOC_SCHEMA = {
+	name: "tableOfContents",
+	title: TOC_LABEL,
+	kind: "object",
+	icon: "list-tree",
+	fields: [{
+		name: "title",
+		title: "Title",
+		type: "string",
+		validation: { max: 40 }
+	}, {
+		name: "depth",
+		title: "Headings",
+		type: "select",
+		layout: "segmented",
+		initialValue: "3",
+		options: [{
+			value: "2",
+			label: "H2"
+		}, {
+			value: "3",
+			label: "H2 and H3"
+		}]
+	}]
+};
+/** The body's H2 and H3, top level only, in order, with stable de-duplicated ids. */
+function outlineOf(root) {
+	const used = /* @__PURE__ */ new Set();
+	const out = [];
+	root.querySelectorAll(":scope > h2, :scope > h3").forEach((h) => {
+		const text = (h.textContent ?? "").replace(/​/g, "").trim();
+		if (!text) return;
+		let id = slugify(text);
+		for (let n = 2; used.has(id); n++) id = `${slugify(text)}-${n}`;
+		used.add(id);
+		out.push({
+			id,
+			text,
+			depth: h.tagName === "H2" ? 2 : 3
+		});
+	});
+	return out;
+}
+var tocVisible = (outline, depth) => outline.filter((o) => o.depth === 2 || depth === "3");
+function createOutlineStore() {
+	let cur = [];
+	const subs = /* @__PURE__ */ new Set();
+	return {
+		get: () => cur,
+		subscribe: (fn) => (subs.add(fn), () => void subs.delete(fn)),
+		set: (next) => {
+			if (JSON.stringify(next) === JSON.stringify(cur)) return;
+			cur = next;
+			subs.forEach((f) => f());
+		}
+	};
+}
+var NO_OUTLINE = {
+	get: () => [],
+	subscribe: () => () => {},
+	set: () => {}
+};
+/** `host` is the TOC's island element; its parent is the editor surface whose headings it lists. */
+function TocPreview({ m, outline, host }) {
+	const all = React.useSyncExternalStore(outline.subscribe, outline.get, outline.get);
+	const items = tocVisible(all, m.depth);
+	const go = (it) => {
+		const root = host.parentElement;
+		if (!root) return;
+		const h = Array.from(root.querySelectorAll(":scope > h2, :scope > h3")).filter((h) => (h.textContent ?? "").replace(/​/g, "").trim())[all.indexOf(it)];
+		if (!h) return;
+		h.scrollIntoView?.({
+			block: "center",
+			behavior: "smooth"
+		});
+		root.focus({ preventScroll: true });
+		placeCaret(h);
+	};
+	return /* @__PURE__ */ jsxs("nav", {
+		"aria-label": m.title || "Table of contents",
+		className: "rounded-kit-lg border border-kit-line bg-kit-surface px-4 py-3",
+		children: [m.title ? /* @__PURE__ */ jsx("p", {
+			"data-field": "title",
+			className: "mb-1.5 text-kit-sm font-semibold text-kit-fg",
+			children: m.title
+		}) : null, items.length ? /* @__PURE__ */ jsx("ol", {
+			className: "m-0 flex list-none flex-col gap-0.5 p-0 text-kit-sm",
+			children: items.map((it, i) => /* @__PURE__ */ jsx("li", {
+				className: cn(it.depth === 3 && "pl-4"),
+				children: /* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: (e) => (e.stopPropagation(), go(it)),
+					className: "max-w-full truncate rounded-kit-sm text-left text-kit-fg-2 hover:text-kit-fg hover:underline",
+					children: it.text
+				})
+			}, `${it.id}-${i}`))
+		}) : /* @__PURE__ */ jsx("p", {
+			className: "text-kit-sm text-kit-fg-3",
+			children: "No headings yet."
+		})]
+	});
+}
+function TocBlock({ m, set, el, ctx, autoFocus }) {
+	return /* @__PURE__ */ jsx(ArticlePopoverBlock, {
+		label: TOC_LABEL,
+		kind: "toc",
+		schema: TOC_SCHEMA,
+		m,
+		set,
+		el,
+		ctx,
+		autoFocus,
+		openOnInsert: false,
+		toForm: (x) => ({
+			title: x.title,
+			depth: x.depth
+		}),
+		fromForm: (v) => ({
+			title: String(v.title ?? ""),
+			depth: v.depth === "2" ? "2" : "3"
+		}),
+		children: () => /* @__PURE__ */ jsx(TocPreview, {
+			m,
+			outline: ctx.outline ?? NO_OUTLINE,
+			host: el
+		})
+	});
+}
+//#endregion
+export { NO_OUTLINE, TOC_LABEL, TOC_SCHEMA, TocBlock, TocPreview, createOutlineStore, outlineOf, slugify, tocDefault, tocVisible };
+
+//# sourceMappingURL=toc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toc.js","names":[],"sources":["../../../src/controls/rich-text/toc.tsx"],"sourcesContent":["/**\n * RICH TEXT · Table of contents (kit-richtext-ui-spec.md §5): V2's article block, stored as the PT block object\n * `{ _type: \"tableOfContents\", title?, depth: \"2\" | \"3\" }`. The list is derived from the same body's top-level H2/H3,\n * never stored.\n *\n *   form      V2 article.ts:137-156: Title (max 40, default \"In this article\"), Headings H2 | H2 and H3 (segmented)\n *   outline   V2 article.ts:248-266: the body's top-level non-empty H2/H3 in order, ids slugified and de-duplicated\n *             (x, x-2, …), the same ids the site stamps on its headings\n *   preview   V2 article-blocks.tsx:537-568: the nav as the reader sees it; each entry a button that scrolls the\n *             heading to the centre and puts the caret in it; \"No headings yet.\" when there are none\n *   store     V2 article-blocks.tsx:45-66: one live outline per editor, so every TOC follows the headings as they are typed\n *\n * The block itself (card, chip, popover at its corner) is the shared article shell (article-shell.tsx, kit-40); it\n * opens on a fresh insert by focusing the card only (V2 article-blocks.tsx:131).\n */\nimport * as React from \"react\";\nimport { cn } from \"../../lib/cn\";\nimport { slugify } from \"@bettercms-ai/types\";\nimport type { TypeSchema } from \"../../schema/types\";\nimport { ArticlePopoverBlock } from \"./article-shell\";\nimport type { IslandCtx } from \"./blocks\";\nimport { placeCaret, type IslandEl } from \"./dom\";\n\nexport interface TocModel {\n  title: string;\n  depth: \"2\" | \"3\";\n}\nexport const TOC_LABEL = \"Table of contents\";\nexport const tocDefault = (): TocModel => ({ title: \"In this article\", depth: \"3\" });\n\n/** The popover form (V2 ARTICLE_SCHEMAS.toc). Two settings → the shell's popover (D54). */\nexport const TOC_SCHEMA: TypeSchema = {\n  name: \"tableOfContents\",\n  title: TOC_LABEL,\n  kind: \"object\",\n  icon: \"list-tree\",\n  fields: [\n    { name: \"title\", title: \"Title\", type: \"string\", validation: { max: 40 } },\n    {\n      name: \"depth\",\n      title: \"Headings\",\n      type: \"select\",\n      layout: \"segmented\",\n      initialValue: \"3\",\n      options: [\n        { value: \"2\", label: \"H2\" },\n        { value: \"3\", label: \"H2 and H3\" },\n      ],\n    },\n  ],\n};\n\n/* ── Outline ───────────────────────────────────────────────────────── */\nexport interface OutlineItem {\n  id: string;\n  text: string;\n  depth: 2 | 3;\n}\n/** V2 article.ts:250-251, the one heading-id rule the site stamps too (types heading-id.ts, plan RT5). */\nexport { slugify };\n\n/** The body's H2 and H3, top level only, in order, with stable de-duplicated ids. */\nexport function outlineOf(root: ParentNode): OutlineItem[] {\n  const used = new Set<string>();\n  const out: OutlineItem[] = [];\n  root.querySelectorAll(\":scope > h2, :scope > h3\").forEach((h) => {\n    const text = (h.textContent ?? \"\").replace(/​/g, \"\").trim();\n    if (!text) return;\n    let id = slugify(text);\n    for (let n = 2; used.has(id); n++) id = `${slugify(text)}-${n}`;\n    used.add(id);\n    out.push({ id, text, depth: h.tagName === \"H2\" ? 2 : 3 });\n  });\n  return out;\n}\nexport const tocVisible = (outline: OutlineItem[], depth: TocModel[\"depth\"]) => outline.filter((o) => o.depth === 2 || depth === \"3\");\n\n/** One live outline per editor: the editor sets it after each input, every TOC preview subscribes. */\nexport interface OutlineStore {\n  get: () => OutlineItem[];\n  subscribe: (fn: () => void) => () => void;\n  set: (next: OutlineItem[]) => void;\n}\nexport function createOutlineStore(): OutlineStore {\n  let cur: OutlineItem[] = [];\n  const subs = new Set<() => void>();\n  return {\n    get: () => cur,\n    subscribe: (fn) => (subs.add(fn), () => void subs.delete(fn)),\n    set: (next) => {\n      if (JSON.stringify(next) === JSON.stringify(cur)) return;\n      cur = next;\n      subs.forEach((f) => f());\n    },\n  };\n}\nexport const NO_OUTLINE: OutlineStore = { get: () => [], subscribe: () => () => {}, set: () => {} };\n\n/* ── Preview (what the reader sees) ────────────────────────────────── */\n/** `host` is the TOC's island element; its parent is the editor surface whose headings it lists. */\nexport function TocPreview({ m, outline, host }: { m: TocModel; outline: OutlineStore; host: HTMLElement }) {\n  const all = React.useSyncExternalStore(outline.subscribe, outline.get, outline.get);\n  const items = tocVisible(all, m.depth);\n  const go = (it: OutlineItem) => {\n    const root = host.parentElement;\n    if (!root) return;\n    const hs = Array.from(root.querySelectorAll<HTMLElement>(\":scope > h2, :scope > h3\")).filter((h) => (h.textContent ?? \"\").replace(/​/g, \"\").trim());\n    const h = hs[all.indexOf(it)];\n    if (!h) return;\n    h.scrollIntoView?.({ block: \"center\", behavior: \"smooth\" });\n    root.focus({ preventScroll: true });\n    placeCaret(h);\n  };\n  return (\n    <nav aria-label={m.title || TOC_LABEL} className=\"rounded-kit-lg border border-kit-line bg-kit-surface px-4 py-3\">\n      {m.title ? (\n        <p data-field=\"title\" className=\"mb-1.5 text-kit-sm font-semibold text-kit-fg\">\n          {m.title}\n        </p>\n      ) : null}\n      {items.length ? (\n        <ol className=\"m-0 flex list-none flex-col gap-0.5 p-0 text-kit-sm\">\n          {items.map((it, i) => (\n            <li key={`${it.id}-${i}`} className={cn(it.depth === 3 && \"pl-4\")}>\n              <button type=\"button\" onClick={(e) => (e.stopPropagation(), go(it))} className=\"max-w-full truncate rounded-kit-sm text-left text-kit-fg-2 hover:text-kit-fg hover:underline\">\n                {it.text}\n              </button>\n            </li>\n          ))}\n        </ol>\n      ) : (\n        <p className=\"text-kit-sm text-kit-fg-3\">No headings yet.</p>\n      )}\n    </nav>\n  );\n}\n\n/* ── The block (V2 ArticleBlock, surface \"popover\") ────────────────── */\nexport interface TocBlockProps {\n  m: TocModel;\n  set: (fn: (m: TocModel) => TocModel, label?: string) => void;\n  el: IslandEl;\n  /** the editor's live outline rides the island context */\n  ctx: IslandCtx & { outline?: OutlineStore };\n  autoFocus: boolean;\n}\n\nexport function TocBlock({ m, set, el, ctx, autoFocus }: TocBlockProps) {\n  return (\n    <ArticlePopoverBlock<TocModel>\n      label={TOC_LABEL}\n      kind=\"toc\"\n      schema={TOC_SCHEMA}\n      m={m}\n      set={set}\n      el={el}\n      ctx={ctx}\n      autoFocus={autoFocus}\n      openOnInsert={false}\n      toForm={(x) => ({ title: x.title, depth: x.depth })}\n      fromForm={(v) => ({ title: String(v.title ?? \"\"), depth: v.depth === \"2\" ? \"2\" : \"3\" })}\n    >\n      {() => <TocPreview m={m} outline={ctx.outline ?? NO_OUTLINE} host={el} />}\n    </ArticlePopoverBlock>\n  );\n}\n"],"mappings":"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"}

package/dist/controls/slot-register.d.ts

@@ -1 +1,6 @@
-export {};
+/**
+ * Lane L3: a component slot (a json field the host marks `componentSlot`) draws the slot control; every other json
+ * field keeps the json editor. It wraps the registered json control, so it imports json-register itself (a bundler may
+ * reorder the barrel's bare imports).
+ */
+import "./json-register";

package/dist/controls/slot-register.js

@@ -1,12 +1,9 @@
 import { JsonControl } from "./json.js";
 import { CONTROLS } from "../engine/kit-field.js";
+import "./json-register.js";
 import { ComponentSlotControl } from "./slot.js";
 import { createElement } from "react";
 //#region src/controls/slot-register.ts
-/**
-* Lane L3: a component slot (a json field the host marks `componentSlot`) draws the slot control; every other json
-* field keeps the json editor. Imported after json-register (kit barrel), so it wraps the registered json control.
-*/
 var Json = CONTROLS.json ?? JsonControl;
 CONTROLS.json = function JsonOrSlotControl(props) {
 	return createElement(props.field.componentSlot ? ComponentSlotControl : Json, props);

package/dist/controls/slot-register.js.map

@@ -1 +1 @@
-{"version":3,"file":"slot-register.js","names":[],"sources":["../../src/controls/slot-register.ts"],"sourcesContent":["/**\n * Lane L3: a component slot (a json field the host marks `componentSlot`) draws the slot control; every other json\n * field keeps the json editor. Imported after json-register (kit barrel), so it wraps the registered json control.\n */\nimport { createElement } from \"react\";\nimport type { ControlProps } from \"../types\";\nimport { CONTROLS } from \"../engine/kit-field\";\nimport { JsonControl } from \"./json\";\nimport { ComponentSlotControl } from \"./slot\";\n\nconst Json = CONTROLS.json ?? JsonControl;\nCONTROLS.json = function JsonOrSlotControl(props: ControlProps) {\n  return createElement(props.field.componentSlot ? ComponentSlotControl : Json, props);\n};\n"],"mappings":";;;;;;;;;AAUA,IAAM,OAAO,SAAS,QAAQ;AAC9B,SAAS,OAAO,SAAS,kBAAkB,OAAqB;CAC9D,OAAO,cAAc,MAAM,MAAM,gBAAgB,uBAAuB,MAAM,KAAK;AACrF"}
+{"version":3,"file":"slot-register.js","names":[],"sources":["../../src/controls/slot-register.ts"],"sourcesContent":["/**\n * Lane L3: a component slot (a json field the host marks `componentSlot`) draws the slot control; every other json\n * field keeps the json editor. It wraps the registered json control, so it imports json-register itself (a bundler may\n * reorder the barrel's bare imports).\n */\nimport \"./json-register\";\nimport { createElement } from \"react\";\nimport type { ControlProps } from \"../types\";\nimport { CONTROLS } from \"../engine/kit-field\";\nimport { JsonControl } from \"./json\";\nimport { ComponentSlotControl } from \"./slot\";\n\nconst Json = CONTROLS.json ?? JsonControl;\nCONTROLS.json = function JsonOrSlotControl(props: ControlProps) {\n  return createElement(props.field.componentSlot ? ComponentSlotControl : Json, props);\n};\n"],"mappings":";;;;;;AAYA,IAAM,OAAO,SAAS,QAAQ;AAC9B,SAAS,OAAO,SAAS,kBAAkB,OAAqB;CAC9D,OAAO,cAAc,MAAM,MAAM,gBAAgB,uBAAuB,MAAM,KAAK;AACrF"}

package/dist/core/core.d.ts

@@ -9,12 +9,15 @@
  * Laws (PBT, src/core/__tests__): norm∘embed = id on C (P1); normProd(embedProd(c)) equals c except under the paths
  * the adapter names (P2); prod zod accepts embedProd(c) (P3); every named loss is excluded, pending or out of its bound
  * (P4); both normalisers are idempotent (P5); the hash is byte-stable (P6); one prod key per facet (P7); out-of-domain
- * prod keys survive a write (P8).
+ * prod keys survive a write (P8). The hash is `core1:` + sha256 of types' canonicalJson.
  *
  * V2's equivalences folded by normV2 (what the V2 engine draws the same, so C cannot tell apart):
  *   - a list's itemNoun equal to the engine's fallback (lib/schema.ts itemNoun) is the absent one
  *   - a fieldset a field names but the schema does not declare is the declared { name, title: name } (engine/field-list
  *     arrange), appended after the declared ones in first-use order
+ *   - a rich text's references naming neither posts nor authors are the absent ones
+ *   - a rich text's features are read through types normaliseRichTextFeatures (an alias is its names: `headings` is
+ *     h1–h6), each name once; naming every RICHTEXT_FEATURES entry, in any order, is the absent list (V2 offers them all)
  */
 import { type AdapterTarget, type FromTypeSchemaResult, type ToTypeSchemaOptions } from "../adapters/schema";
 import type { ProdComponent, ProdContentModel } from "../adapters/prod-types";
@@ -33,9 +36,14 @@ export declare function embedProd(c: CoreSchema, lane: "fields"): FromTypeSchema
 export declare function embedProd(c: CoreSchema, lane: "props"): FromTypeSchemaResult<ProdComponent>;
 export declare function embedProd(c: CoreSchema, lane: AdapterTarget): FromTypeSchemaResult<ProdContentModel | ProdComponent>;
 export declare function normProd(prod: ProdContentModel | ProdComponent, lane: AdapterTarget, opts?: ToTypeSchemaOptions): CoreSchema;
-/** Byte-stable serialisation of C: the hash input, and the form fixtures are frozen in. */
+/** Byte-stable serialisation of C: types' canonicalJson (the bytes the backend's schema_hash is taken over, same rules). */
 export declare const coreJson: (c: CoreSchema) => string;
-/** `schema_hash`: "v1:" + sha256 of coreJson (Web Crypto: the same in the browser, Node and Bun). */
+/**
+ * A Core hash's prefix: `core<v>:`. Disjoint from the backend's `schema_hash` prefix (`v<n>:`, taken over a stored
+ * definition, types' schemaHashInput), so a Core hash can never be read as, or compared with, a stored one.
+ */
+export declare const CORE_HASH_PREFIX: "core1:";
+/** CORE_HASH_PREFIX + sha256 of coreJson (Web Crypto: the same in the browser, Node and Bun). */
 export declare function coreHash(c: CoreSchema): Promise<string>;
 /** The leaf paths where two JSON values differ ("/fields/0/title"); a missing object or list compares as an empty one. */
 export declare function leafDiff(a: unknown, b: unknown, path?: string, out?: string[]): string[];

package/dist/core/core.js

@@ -2,6 +2,7 @@ import { SERVER_CONFIG_KEYS, isHostConfigKey } from "../adapters/lossy.js";
 import { fromTypeSchema, propsToTypeSchema, toTypeSchema } from "../adapters/schema.js";
 import { itemNoun } from "../lib/schema.js";
 import { facetOf } from "./facets.js";
+import { RICHTEXT_FEATURES, canonicalJson, normaliseRichTextFeatures } from "@bettercms-ai/types";
 //#region src/core/core.ts
 /**
 * THE CORE SCHEMA `C` (P2 C1): one canonical, versioned form of a V2 schema that both directions meet in.
@@ -14,12 +15,15 @@ import { facetOf } from "./facets.js";
 * Laws (PBT, src/core/__tests__): norm∘embed = id on C (P1); normProd(embedProd(c)) equals c except under the paths
 * the adapter names (P2); prod zod accepts embedProd(c) (P3); every named loss is excluded, pending or out of its bound
 * (P4); both normalisers are idempotent (P5); the hash is byte-stable (P6); one prod key per facet (P7); out-of-domain
-* prod keys survive a write (P8).
+* prod keys survive a write (P8). The hash is `core1:` + sha256 of types' canonicalJson.
 *
 * V2's equivalences folded by normV2 (what the V2 engine draws the same, so C cannot tell apart):
 *   - a list's itemNoun equal to the engine's fallback (lib/schema.ts itemNoun) is the absent one
 *   - a fieldset a field names but the schema does not declare is the declared { name, title: name } (engine/field-list
 *     arrange), appended after the declared ones in first-use order
+*   - a rich text's references naming neither posts nor authors are the absent ones
+*   - a rich text's features are read through types normaliseRichTextFeatures (an alias is its names: `headings` is
+*     h1–h6), each name once; naming every RICHTEXT_FEATURES entry, in any order, is the absent list (V2 offers them all)
 */
 var CORE_VERSION = 1;
 var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
@@ -31,6 +35,8 @@ function canonical(v) {
 	for (const k of Object.keys(v).sort()) if (v[k] !== void 0) out[k] = canonical(v[k]);
 	return out;
 }
+/** Every feature, canonical: RICHTEXT_FEATURES through normaliseRichTextFeatures, so no alias is ever in it. */
+var ALL_RICH_FEATURES = normaliseRichTextFeatures(RICHTEXT_FEATURES).features;
 function foldField(f) {
 	const out = { ...f };
 	if (out.fields) out.fields = out.fields.map(foldField);
@@ -40,6 +46,13 @@ function foldField(f) {
 		...out,
 		itemNoun: void 0
 	})) delete out.itemNoun;
+	if (out.references && out.references.posts === void 0 && out.references.authors === void 0) delete out.references;
+	if (Array.isArray(out.features)) {
+		const { features, unknown } = normaliseRichTextFeatures(out.features.filter((x) => typeof x === "string"));
+		const names = [.../* @__PURE__ */ new Set([...features, ...unknown])];
+		if (unknown.length === 0 && ALL_RICH_FEATURES.every((x) => names.includes(x))) delete out.features;
+		else out.features = names;
+	}
 	return out;
 }
 /** The fieldsets fields name, depth first, the way the adapter visits them (fromTypeSchema propSetsFor / fieldsetsFor). */
@@ -76,11 +89,16 @@ function embedProd(c, lane) {
 function normProd(prod, lane, opts = {}) {
 	return normV2(lane === "fields" ? toTypeSchema(prod, opts) : propsToTypeSchema(prod, opts));
 }
-/** Byte-stable serialisation of C: the hash input, and the form fixtures are frozen in. */
-var coreJson = (c) => JSON.stringify(canonical(c));
-/** `schema_hash`: "v1:" + sha256 of coreJson (Web Crypto: the same in the browser, Node and Bun). */
+/** Byte-stable serialisation of C: types' canonicalJson (the bytes the backend's schema_hash is taken over, same rules). */
+var coreJson = (c) => canonicalJson(c);
+/**
+* A Core hash's prefix: `core<v>:`. Disjoint from the backend's `schema_hash` prefix (`v<n>:`, taken over a stored
+* definition, types' schemaHashInput), so a Core hash can never be read as, or compared with, a stored one.
+*/
+var CORE_HASH_PREFIX = `core1:`;
+/** CORE_HASH_PREFIX + sha256 of coreJson (Web Crypto: the same in the browser, Node and Bun). */
 async function coreHash(c) {
-	return `v1:${[...new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(coreJson(c))))].map((b) => b.toString(16).padStart(2, "0")).join("")}`;
+	return `${CORE_HASH_PREFIX}${[...new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(coreJson(c))))].map((b) => b.toString(16).padStart(2, "0")).join("")}`;
 }
 /** The leaf paths where two JSON values differ ("/fields/0/title"); a missing object or list compares as an empty one. */
 function leafDiff(a, b, path = "", out = []) {
@@ -166,6 +184,6 @@ function preserveOutOfDomain(written, stored, lane) {
 	};
 }
 //#endregion
-export { CORE_VERSION, canonical, coreHash, coreJson, embedProd, embedV2, leafDiff, normProd, normV2, preserveOutOfDomain, roundTripCore };
+export { CORE_HASH_PREFIX, CORE_VERSION, canonical, coreHash, coreJson, embedProd, embedV2, leafDiff, normProd, normV2, preserveOutOfDomain, roundTripCore };
 
 //# sourceMappingURL=core.js.map