@bettercms-ai/kit 2.0.0-next.2 → 2.0.0-next.3

package/dist/controls/rich-text/link-form.d.ts

@@ -1,7 +1,17 @@
+import { type LinkRel, type LinkValue } from "../link";
 export interface TextLink {
     href: string;
     newTab?: boolean;
+    /** absent = follow (V2 writes no rel for it) */
+    rel?: Exclude<LinkRel, "follow">;
 }
+/** An anchor's link as stored: href, a new tab, and its rel (a new tab's noopener/noreferrer are the renderer's). */
+export declare function textLinkOf(a: HTMLAnchorElement): TextLink;
+/** Writes a link onto its anchor: href, target and rel (none for follow). */
+export declare function applyTextLink(a: HTMLAnchorElement, l: TextLink): void;
+export declare const toLinkValue: (l: TextLink) => LinkValue;
+/** V2 saveLink (RTE:883-899): the resolved href is what is stored; a page or section pick re-reads from it. */
+export declare const fromLinkValue: (v: LinkValue, allowNewTab: boolean) => TextLink;
 /** An address a link may carry: http(s), mailto, tel, a site path or an in-page anchor. */
 export declare function linkProblem(href: string): string | null;
 export declare function LinkForm({ initial, allowNewTab, onSave, onCancel, onDetach, dirty, }: {

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

@@ -7,11 +7,45 @@ 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.
+* RICH TEXT · a link inside the text. A text link and a button are edited in V2's own link panel (controls/link.tsx
+* LinkPopoverBody: Type, the page/section/address, new tab and Rel; RTE:1696) and stored as production's link mark:
+* the resolved href, target and rel (`toLinkValue` / `fromLinkValue`). `LinkForm` below is the address-only form an
+* image block links with.
 */
+var RELS = [
+	"nofollow",
+	"sponsored",
+	"ugc"
+];
+/** An anchor's link as stored: href, a new tab, and its rel (a new tab's noopener/noreferrer are the renderer's). */
+function textLinkOf(a) {
+	const tokens = (a.getAttribute("rel") ?? "").toLowerCase().split(/\s+/);
+	const rel = RELS.find((r) => tokens.includes(r));
+	return {
+		href: a.getAttribute("href") ?? "",
+		newTab: a.getAttribute("target") === "_blank",
+		...rel ? { rel } : {}
+	};
+}
+/** Writes a link onto its anchor: href, target and rel (none for follow). */
+function applyTextLink(a, l) {
+	a.setAttribute("href", l.href);
+	if (l.newTab) a.setAttribute("target", "_blank");
+	else a.removeAttribute("target");
+	if (l.rel) a.setAttribute("rel", l.rel);
+	else a.removeAttribute("rel");
+}
+var toLinkValue = (l) => ({
+	href: l.href,
+	newTab: !!l.newTab,
+	rel: l.rel ?? "follow"
+});
+/** V2 saveLink (RTE:883-899): the resolved href is what is stored; a page or section pick re-reads from it. */
+var fromLinkValue = (v, allowNewTab) => ({
+	href: v.href,
+	newTab: allowNewTab && !!v.newTab,
+	...v.rel && v.rel !== "follow" ? { rel: v.rel } : {}
+});
 /** 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();
@@ -142,6 +176,6 @@ function LinkForm({ initial, allowNewTab, onSave, onCancel, onDetach, dirty = fa
 	});
 }
 //#endregion
-export { LinkForm, linkProblem };
+export { LinkForm, applyTextLink, fromLinkValue, linkProblem, textLinkOf, toLinkValue };
 
 //# sourceMappingURL=link-form.js.map

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

@@ -1 +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  dirty = false,\n}: {\n  initial: TextLink;\n  allowNewTab: boolean;\n  onSave: (v: TextLink) => void;\n  onCancel: () => void;\n  onDetach?: () => void;\n  /** something the host draws beside the form changed (a button's label), so Apply has something to save */\n  dirty?: boolean;\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 = dirty || 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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"}
+{"version":3,"file":"link-form.js","names":[],"sources":["../../../src/controls/rich-text/link-form.tsx"],"sourcesContent":["/**\n * RICH TEXT · a link inside the text. A text link and a button are edited in V2's own link panel (controls/link.tsx\n * LinkPopoverBody: Type, the page/section/address, new tab and Rel; RTE:1696) and stored as production's link mark:\n * the resolved href, target and rel (`toLinkValue` / `fromLinkValue`). `LinkForm` below is the address-only form an\n * image block links with.\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, type LinkRel, type LinkValue } from \"../link\";\n\nexport interface TextLink {\n  href: string;\n  newTab?: boolean;\n  /** absent = follow (V2 writes no rel for it) */\n  rel?: Exclude<LinkRel, \"follow\">;\n}\n\nconst RELS: Exclude<LinkRel, \"follow\">[] = [\"nofollow\", \"sponsored\", \"ugc\"];\n/** An anchor's link as stored: href, a new tab, and its rel (a new tab's noopener/noreferrer are the renderer's). */\nexport function textLinkOf(a: HTMLAnchorElement): TextLink {\n  const tokens = (a.getAttribute(\"rel\") ?? \"\").toLowerCase().split(/\\s+/);\n  const rel = RELS.find((r) => tokens.includes(r));\n  return { href: a.getAttribute(\"href\") ?? \"\", newTab: a.getAttribute(\"target\") === \"_blank\", ...(rel ? { rel } : {}) };\n}\n/** Writes a link onto its anchor: href, target and rel (none for follow). */\nexport function applyTextLink(a: HTMLAnchorElement, l: TextLink) {\n  a.setAttribute(\"href\", l.href);\n  if (l.newTab) a.setAttribute(\"target\", \"_blank\");\n  else a.removeAttribute(\"target\");\n  if (l.rel) a.setAttribute(\"rel\", l.rel);\n  else a.removeAttribute(\"rel\");\n}\nexport const toLinkValue = (l: TextLink): LinkValue => ({ href: l.href, newTab: !!l.newTab, rel: l.rel ?? \"follow\" });\n/** V2 saveLink (RTE:883-899): the resolved href is what is stored; a page or section pick re-reads from it. */\nexport const fromLinkValue = (v: LinkValue, allowNewTab: boolean): TextLink => ({\n  href: v.href,\n  newTab: allowNewTab && !!v.newTab,\n  ...(v.rel && v.rel !== \"follow\" ? { rel: v.rel } : {}),\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  dirty = false,\n}: {\n  initial: TextLink;\n  allowNewTab: boolean;\n  onSave: (v: TextLink) => void;\n  onCancel: () => void;\n  onDetach?: () => void;\n  /** something the host draws beside the form changed (a button's label), so Apply has something to save */\n  dirty?: boolean;\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 = dirty || 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/related.d.ts

@@ -11,9 +11,15 @@ export interface RelatedModel {
     posts: string[];
 }
 export declare const RELATED_LABEL = "Related posts";
-export declare const relatedDefault: () => RelatedModel;
-/** The panel form; `to` is the field's collection. "How many" explains the chosen automatic mode. */
-export declare const relatedSchema: (to: string[], mode: RelatedMode) => TypeSchema;
+/** `topic: false`: the collection has nothing to rank Same topic by, so a new block is Newest. */
+export declare const relatedDefault: (topic?: boolean) => RelatedModel;
+/** Why Same topic is not offered (RichTextRead.references.topic false; the entry write's relatedPosts.no_topic_field). */
+export declare const NO_TOPIC_REASON = "Same topic needs a tags or category field on this collection.";
+/**
+ * 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).
+ */
+export declare const relatedSchema: (to: string[], mode: RelatedMode, topic?: boolean) => TypeSchema;
 /** What the preview asks the host for: the picked ids, or the automatic mode's query. */
 export declare function relatedRequest(m: RelatedModel, collection?: string, excludeId?: string): KitRichTextRefRequest | null;
 export declare function RelatedPreview({ m, onPick, ro, collection, excludeId }: {
@@ -23,7 +29,7 @@ export declare function RelatedPreview({ m, onPick, ro, collection, excludeId }:
     collection?: string;
     excludeId?: string;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function RelatedBlock({ m, set, el, ctx, autoFocus, collection, excludeId, }: {
+export declare function RelatedBlock({ m, set, el, ctx, autoFocus, collection, excludeId, topic, }: {
     m: RelatedModel;
     set: (fn: (m: RelatedModel) => RelatedModel, label?: string) => void;
     el: IslandEl;
@@ -33,4 +39,6 @@ export declare function RelatedBlock({ m, set, el, ctx, autoFocus, collection, e
     collection: string;
     /** the entry being edited, left out of the automatic modes */
     excludeId?: string;
+    /** false: the collection has no topic field, so Same topic is not offered */
+    topic?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

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

@@ -20,20 +20,26 @@ import { IconPlus } from "@tabler/icons-react";
 *             A fresh insert focuses the card (V2 article-blocks.tsx:131).
 */
 var RELATED_LABEL = "Related posts";
-var relatedDefault = () => ({
+/** `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",
+	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. */
-var relatedSchema = (to, mode) => ({
+/**
+* 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) => ({
 	name: "relatedPosts",
 	title: RELATED_LABEL,
 	kind: "object",
@@ -50,12 +56,12 @@ var relatedSchema = (to, mode) => ({
 			title: "Stories",
 			type: "select",
 			layout: "segmented",
-			initialValue: "topic",
+			initialValue: topic ? "topic" : "newest",
 			options: [
-				{
+				...topic || mode === "topic" ? [{
 					value: "topic",
 					label: "Same topic"
-				},
+				}] : [],
 				{
 					value: "newest",
 					label: "Newest"
@@ -64,7 +70,8 @@ var relatedSchema = (to, mode) => ({
 					value: "manual",
 					label: "Hand-picked"
 				}
-			]
+			],
+			...topic ? {} : { description: NO_TOPIC_REASON }
 		},
 		{
 			name: "count",
@@ -174,8 +181,12 @@ function RelatedPreview({ m, onPick, ro, collection, excludeId }) {
 		})]
 	});
 }
-function RelatedBlock({ m, set, el, ctx, autoFocus, collection, excludeId }) {
-	const schema = React.useMemo(() => relatedSchema([collection], m.mode), [collection, m.mode]);
+function RelatedBlock({ m, set, el, ctx, autoFocus, collection, excludeId, topic = true }) {
+	const schema = React.useMemo(() => relatedSchema([collection], m.mode, topic), [
+		collection,
+		m.mode,
+		topic
+	]);
 	return /* @__PURE__ */ jsx(ArticlePanelBlock, {
 		label: RELATED_LABEL,
 		kind: "related",
@@ -208,6 +219,6 @@ function RelatedBlock({ m, set, el, ctx, autoFocus, collection, excludeId }) {
 	});
 }
 //#endregion
-export { RELATED_LABEL, RelatedBlock, RelatedPreview, relatedDefault, relatedRequest, relatedSchema };
+export { NO_TOPIC_REASON, RELATED_LABEL, RelatedBlock, RelatedPreview, relatedDefault, relatedRequest, relatedSchema };
 
 //# sourceMappingURL=related.js.map

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

@@ -1 +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\";\nexport const relatedDefault = (): RelatedModel => ({ title: \"Related stories\", mode: \"topic\", count: 3, posts: [] });\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/** The panel form; `to` is the field's collection. \"How many\" explains the chosen automatic mode. */\nexport const relatedSchema = (to: string[], mode: RelatedMode): 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\",\n      options: [\n        { value: \"topic\", label: \"Same topic\" },\n        { value: \"newest\", label: \"Newest\" },\n        { value: \"manual\", label: \"Hand-picked\" },\n      ],\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      of: [{ name: \"post\", title: \"Post\", type: \"reference\", reference: { to } }],\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,\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}) {\n  const schema = React.useMemo(() => relatedSchema([collection], m.mode), [collection, m.mode]);\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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"}
+{"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): 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      of: [{ name: \"post\", title: \"Post\", type: \"reference\", reference: { to } }],\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,\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}) {\n  const schema = React.useMemo(() => relatedSchema([collection], m.mode, topic), [collection, m.mode, topic]);\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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"}