@bettercms-ai/kit 0.1.0 → 1.0.0

package/adapters/values.js

@@ -0,0 +1,553 @@
+import { BUTTON_SIZES, BUTTON_VARIANTS, DOCK_ICON_NAME_SET, LINK_RELS, LINK_VALUE_TYPES, VIDEO_VALUE_KEYS } from "./prod-types.js";
+//#region src/kit/adapters/values.ts
+var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+/** The keys only a button carries; a link field never stores them. */
+var BUTTON_ONLY = [
+	"style",
+	"variant",
+	"size",
+	"arrow",
+	"icon",
+	"fullWidth"
+];
+var isScriptHref = (href) => /^(javascript|data|vbscript):/i.test(href.replace(/[\u0000- \u007F]/g, ""));
+/**
+* F1 stores the V2 link object as sent (link-value.ts: the kit's pageId, entryId, anchor, email, phone, label… are
+* kept), plus `ref` for a page / entry link so delivery resolves it. A bare href string stays a string.
+*/
+function linkToProd(v) {
+	if (v == null) return {
+		value: null,
+		lost: []
+	};
+	if (typeof v === "string") return isScriptHref(v) ? {
+		value: null,
+		lost: [""]
+	} : {
+		value: v,
+		lost: []
+	};
+	if (isScriptHref(v.href)) return {
+		value: null,
+		lost: [""]
+	};
+	const lost = [];
+	const out = {};
+	for (const [k, x] of Object.entries(v)) if (BUTTON_ONLY.includes(k)) lost.push(k);
+	else out[k] = x;
+	if (v.type !== void 0 && !LINK_VALUE_TYPES.includes(v.type)) {
+		lost.push("type");
+		delete out.type;
+	}
+	if (typeof v.newTab === "boolean" && v.target !== void 0 && v.newTab !== (v.target === "_blank")) {
+		lost.push("target");
+		delete out.target;
+	}
+	const ref = v.type === "page" ? v.pageId : v.type === "entry" ? v.entryId : void 0;
+	if (ref) out.ref = ref;
+	return {
+		value: out,
+		lost
+	};
+}
+function linkFromProd(v) {
+	if (typeof v === "string") return v;
+	if (!isObj(v) || typeof v.href !== "string") return null;
+	const { ref, ...rest } = v;
+	const out = rest;
+	if (typeof ref === "string") {
+		if (out.type === "page" && out.pageId === void 0) out.pageId = ref;
+		if (out.type === "entry" && out.entryId === void 0) out.entryId = ref;
+	}
+	return out;
+}
+/**
+* A V2 button is a link with a label and a look, flattened. Prod's ButtonValue reads `label`, `href` (string or link
+* object), `variant`, `size`, `arrow`, `icon` (a dock icon name), `newTab`, `rel`; other keys are kept and ignored,
+* so the link half (type, pageId, anchor…) rides along as sent. The look is written as `variant` (what renderers read).
+*/
+function buttonToProd(v) {
+	if (v == null) return {
+		value: null,
+		lost: []
+	};
+	if (typeof v.href === "string" && isScriptHref(v.href)) return {
+		value: null,
+		lost: [""]
+	};
+	const lost = [];
+	const out = { ...v };
+	const valid = (x) => typeof x === "string" && BUTTON_VARIANTS.includes(x);
+	const look = [v.variant, v.style].find(valid);
+	if (look !== void 0) out.variant = look;
+	else delete out.variant;
+	if (v.variant !== void 0 && !valid(v.variant)) lost.push("variant");
+	if (v.style !== void 0 && v.variant !== void 0 && v.style === v.variant) lost.push("variant");
+	if (v.size !== void 0 && !BUTTON_SIZES.includes(v.size)) {
+		lost.push("size");
+		delete out.size;
+	}
+	if (v.icon !== void 0 && !DOCK_ICON_NAME_SET.has(v.icon)) {
+		lost.push("icon");
+		delete out.icon;
+	}
+	if (v.rel !== void 0 && !LINK_RELS.includes(v.rel)) {
+		lost.push("rel");
+		delete out.rel;
+	}
+	if (typeof v.newTab === "boolean" && v.target !== void 0 && v.newTab !== (v.target === "_blank")) {
+		lost.push("target");
+		delete out.target;
+	}
+	if (v.fullWidth !== void 0 && typeof v.fullWidth !== "boolean") {
+		lost.push("fullWidth");
+		delete out.fullWidth;
+	}
+	if (typeof out.label !== "string") {
+		out.label = "";
+		lost.push("label");
+	}
+	if (typeof out.href !== "string") {
+		out.href = "";
+		lost.push("href");
+	}
+	return {
+		value: out,
+		lost: [...new Set(lost)]
+	};
+}
+function buttonFromProd(v) {
+	if (!isObj(v)) return null;
+	const out = { ...v };
+	if (isObj(v.href)) {
+		const link = linkFromProd(v.href);
+		if (isObj(link)) Object.assign(out, link);
+	}
+	if (out.style !== void 0 && out.variant === out.style) delete out.variant;
+	if (out.icon === null) delete out.icon;
+	return out;
+}
+var ZONED = /^(.*)\[([^\]]+)\]$/;
+var NO_SECONDS = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2})(Z|[+-]\d{2}:?\d{2})?$/;
+var OFFSET = /(?:Z|[+-]\d{2}:?\d{2})$/;
+/** A date is the same "YYYY-MM-DD" string on both sides. */
+var dateToProd = (v) => ({
+	value: v ?? null,
+	lost: []
+});
+var dateFromProd = (v) => typeof v === "string" ? v : null;
+/**
+* V2 stores RFC 9557 (`2026-10-14T09:00:00+05:30[Asia/Kolkata]`). Prod keeps the ISO instant with seconds and its
+* offset; a `[Zone]` suffix is checked and dropped on write. So the zone survives only as the field's own
+* `config.timezone` when that names it (pass it as `zone`); otherwise it is lost.
+*/
+function datetimeToProd(v, opts = {}) {
+	if (v == null || v === "") return {
+		value: v ?? null,
+		lost: []
+	};
+	const lost = [];
+	const m = ZONED.exec(v);
+	let bare = m ? m[1] : v;
+	if (m && (m[2] !== opts.zone || !OFFSET.test(bare))) lost.push("zone");
+	const short = NO_SECONDS.exec(bare);
+	if (short) {
+		bare = `${short[1]}:00${short[2] ?? ""}`;
+		lost.push("format");
+	}
+	return {
+		value: bare,
+		lost
+	};
+}
+function datetimeFromProd(v, opts = {}) {
+	if (typeof v !== "string") return null;
+	const zone = opts.zone && opts.zone !== "site" ? opts.zone : void 0;
+	return zone && OFFSET.test(v) && !ZONED.test(v) ? `${v}[${zone}]` : v;
+}
+var CROPS = {
+	"16:9": 16 / 9,
+	"4:3": 4 / 3,
+	"1:1": 1,
+	"4:5": 4 / 5
+};
+var round = (n) => Math.round(n * 1e6) / 1e6;
+var clamp01 = (n) => Math.min(1, Math.max(0, n));
+/** A crop preset → the centred-on-focal rect prod stores. Needs the image's pixel size. */
+function cropRect(crop, width, height, focal = {
+	x: 50,
+	y: 50
+}) {
+	if (crop === "original" || !(width > 0 && height > 0)) return void 0;
+	const want = CROPS[crop];
+	const have = width / height;
+	const w = want < have ? want / have : 1;
+	const h = want < have ? 1 : have / want;
+	const left = clamp01(Math.min(1 - w, Math.max(0, focal.x / 100 - w / 2)));
+	const top = clamp01(Math.min(1 - h, Math.max(0, focal.y / 100 - h / 2)));
+	return {
+		top: round(top),
+		right: round(1 - left - w),
+		bottom: round(1 - top - h),
+		left: round(left)
+	};
+}
+/** A stored rect → the preset whose aspect it cuts (within 1%), when the image's pixel size is known. */
+function cropPreset(rect, width, height) {
+	const w = (1 - rect.left - rect.right) * width;
+	const h = (1 - rect.top - rect.bottom) * height;
+	if (!(w > 0 && h > 0)) return void 0;
+	const ratio = w / h;
+	return Object.entries(CROPS).find(([, r]) => Math.abs(ratio - r) / r < .01)?.[0];
+}
+/**
+* The contract holds against `imageFromProd(value)` with no asset (how stored defaults are read): a crop rect needs the
+* image's pixel size to read back as its preset, and width / height / size live on the asset, so all four are named in
+* `lost`. Passing the asset to imageFromProd restores them.
+*/
+function imageToProd(v) {
+	if (v == null) return {
+		value: null,
+		lost: []
+	};
+	if (typeof v === "string") return {
+		value: v,
+		lost: []
+	};
+	const lost = [];
+	const out = { url: v.url };
+	if (v.id !== void 0) out.id = v.id;
+	if (v.name !== void 0) out.name = v.name;
+	if (v.alt !== void 0) out.altText = v.alt;
+	if (v.focal) out.focal = {
+		x: round(v.focal.x / 100),
+		y: round(v.focal.y / 100)
+	};
+	if (v.crop !== void 0 && v.crop !== "original") {
+		const rect = v.width && v.height ? cropRect(v.crop, v.width, v.height, v.focal) : void 0;
+		if (rect) out.crop = rect;
+		lost.push("crop");
+	} else if (v.crop === "original") lost.push("crop");
+	for (const k of [
+		"caption",
+		"width",
+		"height",
+		"size"
+	]) if (v[k] !== void 0) lost.push(k);
+	for (const k of Object.keys(v)) if (![
+		"url",
+		"id",
+		"name",
+		"alt",
+		"focal",
+		"crop",
+		"caption",
+		"width",
+		"height",
+		"size"
+	].includes(k)) lost.push(k);
+	return {
+		value: out,
+		lost
+	};
+}
+/** Pass the asset's pixel size to read a stored crop rect back as its preset and to restore width / height / size. */
+function imageFromProd(v, asset = {}) {
+	if (typeof v === "string") return v;
+	if (!isObj(v) || typeof v.url !== "string") return null;
+	const p = v;
+	const out = { url: p.url };
+	if (p.id !== void 0) out.id = p.id;
+	if (p.name !== void 0) out.name = p.name;
+	if (p.altText !== void 0) out.alt = p.altText;
+	if (p.focal) out.focal = {
+		x: round(p.focal.x * 100),
+		y: round(p.focal.y * 100)
+	};
+	if (p.crop && asset.width && asset.height) {
+		const preset = cropPreset(p.crop, asset.width, asset.height);
+		if (preset) out.crop = preset;
+	}
+	if (asset.width !== void 0) out.width = asset.width;
+	if (asset.height !== void 0) out.height = asset.height;
+	if (asset.size !== void 0) out.size = asset.size;
+	return out;
+}
+/**
+* V2 stores the target id (`"en_12"`; a list for many). Prod stores the same id, or `{ entryId, modelSlug }` on a
+* polymorphic field (pass `modelSlug`), or `{ formId }` on a component `form` prop (`to: "form"`).
+*/
+function referenceToProd(v, opts = {}) {
+	if (v == null || v === "") return {
+		value: null,
+		lost: []
+	};
+	if (Array.isArray(v)) return {
+		value: [...v],
+		lost: []
+	};
+	if (opts.to === "form") return {
+		value: { formId: v },
+		lost: []
+	};
+	if (opts.modelSlug) return {
+		value: {
+			entryId: v,
+			modelSlug: opts.modelSlug
+		},
+		lost: []
+	};
+	return {
+		value: v,
+		lost: []
+	};
+}
+var refId = (v) => typeof v === "string" ? v || null : isObj(v) ? typeof v.entryId === "string" && v.entryId || typeof v.formId === "string" && v.formId || null : null;
+function referenceFromProd(v) {
+	if (Array.isArray(v)) return v.map(refId).filter((x) => !!x);
+	return refId(v);
+}
+/**
+* Prod has no table type: the schema adapter stores a V2 table as a `json` field (named in the lossy ledger), and
+* `json` keeps any JSON value, so the TableValue itself is stored verbatim (typed columns, groups, footer,
+* footnotes, caption, design, jsonLd).
+*/
+function tableToProd(v) {
+	return {
+		value: v == null ? null : JSON.parse(JSON.stringify(v)),
+		lost: []
+	};
+}
+var tableFromProd = (v) => isObj(v) ? v : null;
+var SCALE_UNITS = [
+	"px",
+	"%",
+	"rem",
+	"em",
+	"vw",
+	"vh"
+];
+/**
+* Prod stores the three V2 scale shapes as they are (CPO D41, reference-validation.ts scaleValueProblem): a bare number,
+* a token step's string, a custom `{ value, unit }`. Pass the field's scale: a token it does not list, or a custom value
+* it does not allow (allowCustom off, a unit outside its units, past its bounds), is refused by the backend, so it is
+* not written (`lost: [""]`). With no scale only a number is known to fit.
+*/
+function scaleToProd(v, scale) {
+	if (v == null) return {
+		value: null,
+		lost: []
+	};
+	if (typeof v === "number") return Number.isFinite(v) ? {
+		value: v,
+		lost: []
+	} : {
+		value: null,
+		lost: [""]
+	};
+	const refused = {
+		value: null,
+		lost: [""]
+	};
+	if (!scale) return refused;
+	if (typeof v === "string") return Array.isArray(scale.steps) && scale.steps.some((x) => x.value === v) ? {
+		value: v,
+		lost: []
+	} : refused;
+	if (!isObj(v) || !scale.allowCustom || typeof v.value !== "number" || !Number.isFinite(v.value) || Object.keys(v).some((k) => k !== "value" && k !== "unit")) return refused;
+	const custom = typeof scale.allowCustom === "object" ? scale.allowCustom : {};
+	if (!(custom.units ?? scale.units ?? SCALE_UNITS).includes(v.unit)) return refused;
+	const bound = (b) => typeof b === "number" ? b : b?.[v.unit];
+	const min = bound(custom.min);
+	const max = bound(custom.max);
+	if (min !== void 0 && v.value < min || max !== void 0 && v.value > max) return refused;
+	return {
+		value: {
+			value: v.value,
+			unit: v.unit
+		},
+		lost: []
+	};
+}
+function scaleFromProd(v) {
+	if (typeof v === "number") return Number.isFinite(v) ? v : null;
+	if (typeof v === "string") return v;
+	if (isObj(v) && typeof v.value === "number" && typeof v.unit === "string" && SCALE_UNITS.includes(v.unit)) return {
+		value: v.value,
+		unit: v.unit
+	};
+	return null;
+}
+/** An http(s) URL or a site path; "" is an unset one (video-value.ts isVideoUrl). */
+var isVideoUrl = (s) => s === "" || /^https?:\/\/[^\s]+$/i.test(s.trim()) || /^\/(?!\/)\S*$/.test(s.trim());
+/**
+* The V2 video value and prod's are the same shape: a URL string, or `{ url, poster?, autoplay?, loop?, transcript? }`
+* (the video block's props). The backend refuses any other key, and a url or poster that is not an http(s) URL or a
+* site path (video_value_invalid): another key is left out and named, a bad url refuses the value whole.
+*/
+function videoToProd(v) {
+	if (v == null) return {
+		value: null,
+		lost: []
+	};
+	if (typeof v === "string") return isVideoUrl(v) ? {
+		value: v,
+		lost: []
+	} : {
+		value: null,
+		lost: [""]
+	};
+	if (!isObj(v) || typeof v.url !== "string" || !isVideoUrl(v.url)) return {
+		value: null,
+		lost: [""]
+	};
+	const lost = [];
+	const out = {};
+	for (const [k, x] of Object.entries(v)) if (!VIDEO_VALUE_KEYS.includes(k) ? false : k === "url" ? true : k === "poster" ? typeof x === "string" && isVideoUrl(x) : k === "transcript" ? typeof x === "string" && x.length <= 1e5 : typeof x === "boolean") out[k] = x;
+	else if (x !== void 0) lost.push(k);
+	return {
+		value: out,
+		lost
+	};
+}
+function videoFromProd(v) {
+	if (typeof v === "string") return v;
+	if (!isObj(v) || typeof v.url !== "string") return null;
+	return { ...v };
+}
+/**
+* A V2 list of one primitive (`of: [{ type }]`) is a prod `array` with `config.itemType`, each item judged and normalized
+* as a field of its type: an image item stores prod's image keys (altText, 0–1 focal), a link item its stored link. Scalar
+* and rich text items pass as they are. `lost` names `<index>/<key>` (or `<index>` for a whole item) per item.
+*/
+function listToProd(v, itemType) {
+	if (v == null) return {
+		value: null,
+		lost: []
+	};
+	if (!Array.isArray(v)) return {
+		value: null,
+		lost: [""]
+	};
+	const lost = [];
+	const out = [];
+	v.forEach((x, i) => {
+		const r = itemType === "image" ? imageToProd(x) : itemType === "link" ? linkToProd(x) : {
+			value: x,
+			lost: []
+		};
+		for (const l of r.lost) lost.push(l ? `${i}/${l}` : String(i));
+		out.push(r.value);
+	});
+	return {
+		value: out,
+		lost
+	};
+}
+function listFromProd(v, itemType) {
+	if (!Array.isArray(v)) return [];
+	return itemType === "image" ? v.map((x) => imageFromProd(x)) : itemType === "link" ? v.map((x) => linkFromProd(x)) : [...v];
+}
+/**
+* The backend judges tags trimmed and case-insensitively (reference-validation.ts tagsValueProblem): a field write
+* trims and de-dupes, a prop value is refused (tags_value_invalid). So the value is written clean for both: trimmed,
+* first spelling of a case-repeat kept, and an empty, over-long, off-list (`allowCustom: false`) or over-`max` tag left
+* out. `lost` names each changed or dropped tag by its index in `v`.
+*/
+function tagsToProd(v, opts = {}) {
+	if (v == null) return {
+		value: null,
+		lost: []
+	};
+	const allowed = opts.allowCustom === false ? new Set((opts.options ?? []).map((o) => (typeof o === "string" ? o : o.value).trim().toLowerCase())) : void 0;
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	const lost = [];
+	v.forEach((x, i) => {
+		const t = typeof x === "string" ? x.trim() : "";
+		const folded = t.toLowerCase();
+		const keep = t !== "" && Array.from(t).length <= 64 && !seen.has(folded) && (!allowed || allowed.has(folded)) && (opts.max === void 0 || out.length < opts.max);
+		if (keep) {
+			seen.add(folded);
+			out.push(t);
+		}
+		if (!keep || t !== x) lost.push(String(i));
+	});
+	return {
+		value: out,
+		lost
+	};
+}
+var tagsFromProd = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+/**
+* A prod rating runs from config.min (0 unset) to config.max (5 unset) in steps of config.step (1 unset), and 0 is "not
+* rated" on every scale (validation-parity.ts ratingScale / onRatingScale). V2's empty rating is null: it is written as
+* null, and any other number off the scale is refused by the backend (rating_value_invalid), so it is not written either.
+*/
+function ratingToProd(v, opts = {}) {
+	if (v == null) return {
+		value: null,
+		lost: []
+	};
+	const min = opts.min ?? 0;
+	const max = opts.max ?? 5;
+	const step = opts.step ?? 1;
+	const steps = (v - min) / step;
+	return Number.isFinite(v) && v >= min && v <= max && Math.abs(steps - Math.round(steps)) < 1e-9 ? {
+		value: v,
+		lost: []
+	} : {
+		value: null,
+		lost: [""]
+	};
+}
+/** A stored number back; 0 on a scale that starts above it is prod's "not rated", which V2 holds as null. */
+function ratingFromProd(v, opts = {}) {
+	if (typeof v !== "number" || !Number.isFinite(v)) return null;
+	return v === 0 && (opts.min ?? 0) > 0 ? null : v;
+}
+/**
+* Prod stores a code value as a string, or `{ language?, code }` (no other key). A language outside the field's
+* `config.languages` is refused by the backend (code_value_invalid), so it is left out and named; a value over
+* CODE_MAX_LENGTH characters is refused whole.
+*/
+function codeToProd(v, opts = {}) {
+	if (v == null) return {
+		value: null,
+		lost: []
+	};
+	const code = typeof v === "string" ? v : v.code;
+	if (typeof code !== "string" || code.length > 1e5) return {
+		value: null,
+		lost: [""]
+	};
+	if (typeof v === "string") return {
+		value: v,
+		lost: []
+	};
+	const lost = Object.keys(v).filter((k) => k !== "code" && k !== "language");
+	const out = { code };
+	if (v.language !== void 0) if (typeof v.language === "string" && (!opts.languages || opts.languages.includes(v.language))) out.language = v.language;
+	else lost.push("language");
+	return {
+		value: out,
+		lost
+	};
+}
+function codeFromProd(v) {
+	if (typeof v === "string") return v;
+	if (!isObj(v) || typeof v.code !== "string") return null;
+	return typeof v.language === "string" ? {
+		language: v.language,
+		code: v.code
+	} : { code: v.code };
+}
+/** A V2 list of object items is stored by prod as the repeatable zone of its array: `{ repeatable: [...] }`. */
+var zoneListToProd = (v) => ({ repeatable: v ? [...v] : [] });
+var zoneListFromProd = (v) => isObj(v) && Array.isArray(v.repeatable) ? [...v.repeatable] : Array.isArray(v) ? [...v] : [];
+/** A dock icon name passes through; anything else is not a prod icon. */
+var isDockIcon = (v) => typeof v === "string" && DOCK_ICON_NAME_SET.has(v);
+//#endregion
+export { buttonFromProd, buttonToProd, codeFromProd, codeToProd, cropPreset, cropRect, dateFromProd, dateToProd, datetimeFromProd, datetimeToProd, imageFromProd, imageToProd, isDockIcon, linkFromProd, linkToProd, listFromProd, listToProd, ratingFromProd, ratingToProd, referenceFromProd, referenceToProd, scaleFromProd, scaleToProd, tableFromProd, tableToProd, tagsFromProd, tagsToProd, videoFromProd, videoToProd, zoneListFromProd, zoneListToProd };
+
+//# sourceMappingURL=values.js.map

package/adapters/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","names":[],"sources":["../../src/kit/adapters/values.ts"],"sourcesContent":["/**\n * VALUE ADAPTERS — a V2 stored value ↔ the value production stores for the same field (Lane C map,\n * docs/design-system/v2-map/C-controls.md §2, updated for F1). Storage stays prod's: `*ToProd` returns what the\n * backend accepts, `*FromProd` the V2 shape the kit controls edit.\n *\n * Every `*ToProd` returns `{ value, lost }`. `lost` names the V2 keys prod cannot keep (relative to the value), so\n * `*FromProd(*ToProd(v).value)` equals `v` minus exactly those keys. Nothing is dropped without being named.\n */\nimport type { ScaleSchema, ScaleValue } from \"../schema/types\";\nimport type { TableValue } from \"../schema/table\";\nimport {\n  BUTTON_SIZES,\n  BUTTON_VARIANTS,\n  CODE_MAX_LENGTH,\n  DOCK_ICON_NAME_SET,\n  LINK_RELS,\n  LINK_VALUE_TYPES,\n  RATING_DEFAULT_MAX,\n  TAG_VALUE_MAX_LENGTH,\n  VIDEO_TRANSCRIPT_MAX,\n  VIDEO_VALUE_KEYS,\n  type DockIconName,\n  type ProdButtonValue,\n  type ProdFormRef,\n  type ProdImageCrop,\n  type ProdImageValue,\n  type ProdLinkValue,\n  type ProdPolymorphicRef,\n  type ProdVideoValue,\n  type ScaleUnit,\n} from \"./prod-types\";\n\nexport interface ValueResult<T> {\n  value: T;\n  /** V2 keys (dotted, relative to the value) production cannot keep. */\n  lost: string[];\n}\n\ntype Obj = Record<string, unknown>;\nconst isObj = (v: unknown): v is Obj => !!v && typeof v === \"object\" && !Array.isArray(v);\n\n/* ── V2 value shapes (DESIGN §6.7, §6.9; V2 HEAD controls/link.tsx, controls/media.tsx) ── */\nexport type V2LinkType = \"page\" | \"entry\" | \"url\" | \"section\" | \"email\" | \"phone\" | \"file\";\nexport type V2ButtonStyle = \"primary\" | \"secondary\" | \"outline\" | \"link\";\nexport interface V2LinkValue {\n  type?: V2LinkType;\n  href: string;\n  label?: string;\n  title?: string;\n  pageId?: string;\n  entryId?: string;\n  anchor?: string;\n  assetId?: string;\n  email?: string;\n  subject?: string;\n  phone?: string;\n  target?: \"_self\" | \"_blank\";\n  newTab?: boolean;\n  rel?: \"follow\" | \"nofollow\" | \"ugc\" | \"sponsored\";\n}\nexport interface V2ButtonValue extends V2LinkValue {\n  style?: V2ButtonStyle;\n  variant?: V2ButtonStyle;\n  size?: \"sm\" | \"md\" | \"lg\";\n  arrow?: boolean;\n  icon?: string;\n  fullWidth?: boolean;\n}\nexport type V2ImageCrop = \"original\" | \"16:9\" | \"4:3\" | \"1:1\" | \"4:5\";\nexport interface V2ImageValue {\n  url: string;\n  alt?: string;\n  /** percent */\n  focal?: { x: number; y: number };\n  crop?: V2ImageCrop;\n  caption?: string;\n  name?: string;\n  width?: number;\n  height?: number;\n  size?: number;\n  id?: string;\n}\n\n/** The keys only a button carries; a link field never stores them. */\nconst BUTTON_ONLY = [\"style\", \"variant\", \"size\", \"arrow\", \"icon\", \"fullWidth\"] as const;\nconst isScriptHref = (href: string) => /^(javascript|data|vbscript):/i.test(href.replace(/[\\u0000- \\u007F]/g, \"\"));\n\n/* ── link ─────────────────────────────────────────────────────────────── */\n/**\n * F1 stores the V2 link object as sent (link-value.ts: the kit's pageId, entryId, anchor, email, phone, label… are\n * kept), plus `ref` for a page / entry link so delivery resolves it. A bare href string stays a string.\n */\nexport function linkToProd(v: V2LinkValue | string | null | undefined): ValueResult<ProdLinkValue | string | null> {\n  if (v == null) return { value: null, lost: [] };\n  if (typeof v === \"string\") return isScriptHref(v) ? { value: null, lost: [\"\"] } : { value: v, lost: [] };\n  if (isScriptHref(v.href)) return { value: null, lost: [\"\"] };\n  const lost: string[] = [];\n  const out: Obj = {};\n  for (const [k, x] of Object.entries(v)) {\n    if ((BUTTON_ONLY as readonly string[]).includes(k)) lost.push(k);\n    else out[k] = x;\n  }\n  if (v.type !== undefined && !(LINK_VALUE_TYPES as readonly string[]).includes(v.type)) {\n    lost.push(\"type\");\n    delete out.type;\n  }\n  // The backend refuses a target that disagrees with newTab; newTab is the one the kit reads.\n  if (typeof v.newTab === \"boolean\" && v.target !== undefined && v.newTab !== (v.target === \"_blank\")) {\n    lost.push(\"target\");\n    delete out.target;\n  }\n  const ref = v.type === \"page\" ? v.pageId : v.type === \"entry\" ? v.entryId : undefined;\n  if (ref) out.ref = ref;\n  return { value: out as unknown as ProdLinkValue, lost };\n}\n\nexport function linkFromProd(v: unknown): V2LinkValue | string | null {\n  if (typeof v === \"string\") return v;\n  if (!isObj(v) || typeof v.href !== \"string\") return null;\n  const { ref, ...rest } = v;\n  const out = rest as unknown as V2LinkValue;\n  // `ref` mirrors the kit's own id key; a ref with no twin (written by another client) becomes that key.\n  if (typeof ref === \"string\") {\n    if (out.type === \"page\" && out.pageId === undefined) out.pageId = ref;\n    if (out.type === \"entry\" && out.entryId === undefined) out.entryId = ref;\n  }\n  return out;\n}\n\n/* ── button ───────────────────────────────────────────────────────────── */\n/**\n * A V2 button is a link with a label and a look, flattened. Prod's ButtonValue reads `label`, `href` (string or link\n * object), `variant`, `size`, `arrow`, `icon` (a dock icon name), `newTab`, `rel`; other keys are kept and ignored,\n * so the link half (type, pageId, anchor…) rides along as sent. The look is written as `variant` (what renderers read).\n */\nexport function buttonToProd(v: V2ButtonValue | null | undefined): ValueResult<ProdButtonValue | null> {\n  if (v == null) return { value: null, lost: [] };\n  if (typeof v.href === \"string\" && isScriptHref(v.href)) return { value: null, lost: [\"\"] };\n  const lost: string[] = [];\n  const out: Obj = { ...v };\n  const valid = (x: unknown) => typeof x === \"string\" && (BUTTON_VARIANTS as readonly string[]).includes(x);\n  // the first valid of variant, style is the look prod renders; an invalid variant never shadows a valid style\n  const look = [v.variant, v.style].find(valid);\n  if (look !== undefined) out.variant = look;\n  else delete out.variant;\n  if (v.variant !== undefined && !valid(v.variant)) lost.push(\"variant\");\n  // Both set: the kit writes them in sync, prod keeps one look.\n  if (v.style !== undefined && v.variant !== undefined && v.style === v.variant) lost.push(\"variant\");\n  if (v.size !== undefined && !(BUTTON_SIZES as readonly string[]).includes(v.size)) {\n    lost.push(\"size\");\n    delete out.size;\n  }\n  if (v.icon !== undefined && !DOCK_ICON_NAME_SET.has(v.icon)) {\n    lost.push(\"icon\");\n    delete out.icon;\n  }\n  // A button's rel is one of nofollow / sponsored / ugc; \"follow\" is no rel at all.\n  if (v.rel !== undefined && !(LINK_RELS as readonly string[]).includes(v.rel)) {\n    lost.push(\"rel\");\n    delete out.rel;\n  }\n  if (typeof v.newTab === \"boolean\" && v.target !== undefined && v.newTab !== (v.target === \"_blank\")) {\n    lost.push(\"target\");\n    delete out.target;\n  }\n  // fullWidth is true or false (the backend refuses anything else a write brings: button_full_width_invalid)\n  if (v.fullWidth !== undefined && typeof v.fullWidth !== \"boolean\") {\n    lost.push(\"fullWidth\");\n    delete out.fullWidth;\n  }\n  // prod's ButtonValue requires both; a filled-in \"\" reads back where the kit had nothing, so it is named\n  if (typeof out.label !== \"string\") {\n    out.label = \"\";\n    lost.push(\"label\");\n  }\n  if (typeof out.href !== \"string\") {\n    out.href = \"\";\n    lost.push(\"href\");\n  }\n  return { value: out as unknown as ProdButtonValue, lost: [...new Set(lost)] };\n}\n\nexport function buttonFromProd(v: unknown): V2ButtonValue | null {\n  if (!isObj(v)) return null;\n  const out: Obj = { ...v };\n  if (isObj(v.href)) {\n    // A link object in `href` (written by another client): flatten it the way the kit stores a button.\n    const link = linkFromProd(v.href);\n    if (isObj(link)) Object.assign(out, link);\n  }\n  if (out.style !== undefined && out.variant === out.style) delete out.variant;\n  if (out.icon === null) delete out.icon;\n  return out as unknown as V2ButtonValue;\n}\n\n/* ── date / datetime ──────────────────────────────────────────────────── */\nconst ZONED = /^(.*)\\[([^\\]]+)\\]$/;\nconst NO_SECONDS = /^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2})(Z|[+-]\\d{2}:?\\d{2})?$/;\nconst OFFSET = /(?:Z|[+-]\\d{2}:?\\d{2})$/;\n\n/** A date is the same \"YYYY-MM-DD\" string on both sides. */\nexport const dateToProd = (v: string | null | undefined): ValueResult<string | null> => ({ value: v ?? null, lost: [] });\nexport const dateFromProd = (v: unknown): string | null => (typeof v === \"string\" ? v : null);\n\n/**\n * V2 stores RFC 9557 (`2026-10-14T09:00:00+05:30[Asia/Kolkata]`). Prod keeps the ISO instant with seconds and its\n * offset; a `[Zone]` suffix is checked and dropped on write. So the zone survives only as the field's own\n * `config.timezone` when that names it (pass it as `zone`); otherwise it is lost.\n */\nexport function datetimeToProd(v: string | null | undefined, opts: { zone?: string } = {}): ValueResult<string | null> {\n  if (v == null || v === \"\") return { value: v ?? null, lost: [] };\n  const lost: string[] = [];\n  const m = ZONED.exec(v);\n  let bare = m ? m[1] : v;\n  // the zone reads back only from config.timezone, and only onto a value with an offset\n  if (m && (m[2] !== opts.zone || !OFFSET.test(bare))) lost.push(\"zone\");\n  const short = NO_SECONDS.exec(bare);\n  if (short) {\n    bare = `${short[1]}:00${short[2] ?? \"\"}`;\n    lost.push(\"format\");\n  }\n  return { value: bare, lost };\n}\n\nexport function datetimeFromProd(v: unknown, opts: { zone?: string } = {}): string | null {\n  if (typeof v !== \"string\") return null;\n  const zone = opts.zone && opts.zone !== \"site\" ? opts.zone : undefined;\n  return zone && OFFSET.test(v) && !ZONED.test(v) ? `${v}[${zone}]` : v;\n}\n\n/* ── image ────────────────────────────────────────────────────────────── */\nconst CROPS: Record<Exclude<V2ImageCrop, \"original\">, number> = { \"16:9\": 16 / 9, \"4:3\": 4 / 3, \"1:1\": 1, \"4:5\": 4 / 5 };\nconst round = (n: number) => Math.round(n * 1e6) / 1e6;\nconst clamp01 = (n: number) => Math.min(1, Math.max(0, n));\n\n/** A crop preset → the centred-on-focal rect prod stores. Needs the image's pixel size. */\nexport function cropRect(crop: V2ImageCrop, width: number, height: number, focal = { x: 50, y: 50 }): ProdImageCrop | undefined {\n  if (crop === \"original\" || !(width > 0 && height > 0)) return undefined;\n  const want = CROPS[crop];\n  const have = width / height;\n  const w = want < have ? want / have : 1;\n  const h = want < have ? 1 : have / want;\n  const left = clamp01(Math.min(1 - w, Math.max(0, focal.x / 100 - w / 2)));\n  const top = clamp01(Math.min(1 - h, Math.max(0, focal.y / 100 - h / 2)));\n  return { top: round(top), right: round(1 - left - w), bottom: round(1 - top - h), left: round(left) };\n}\n\n/** A stored rect → the preset whose aspect it cuts (within 1%), when the image's pixel size is known. */\nexport function cropPreset(rect: ProdImageCrop, width: number, height: number): V2ImageCrop | undefined {\n  const w = (1 - rect.left - rect.right) * width;\n  const h = (1 - rect.top - rect.bottom) * height;\n  if (!(w > 0 && h > 0)) return undefined;\n  const ratio = w / h;\n  const hit = (Object.entries(CROPS) as [V2ImageCrop, number][]).find(([, r]) => Math.abs(ratio - r) / r < 0.01);\n  return hit?.[0];\n}\n\n/** The asset facts an image value refers to but prod does not store in the value (width, height, size). */\nexport interface ImageAsset {\n  width?: number;\n  height?: number;\n  size?: number;\n}\n\n/**\n * The contract holds against `imageFromProd(value)` with no asset (how stored defaults are read): a crop rect needs the\n * image's pixel size to read back as its preset, and width / height / size live on the asset, so all four are named in\n * `lost`. Passing the asset to imageFromProd restores them.\n */\nexport function imageToProd(v: V2ImageValue | string | null | undefined): ValueResult<ProdImageValue | string | null> {\n  if (v == null) return { value: null, lost: [] };\n  if (typeof v === \"string\") return { value: v, lost: [] };\n  const lost: string[] = [];\n  const out: ProdImageValue = { url: v.url };\n  if (v.id !== undefined) out.id = v.id;\n  if (v.name !== undefined) out.name = v.name;\n  if (v.alt !== undefined) out.altText = v.alt;\n  if (v.focal) out.focal = { x: round(v.focal.x / 100), y: round(v.focal.y / 100) };\n  if (v.crop !== undefined && v.crop !== \"original\") {\n    const rect = v.width && v.height ? cropRect(v.crop, v.width, v.height, v.focal) : undefined;\n    if (rect) out.crop = rect;\n    lost.push(\"crop\"); // written as a rect, it reads back as the preset only with the asset's size\n  } else if (v.crop === \"original\") lost.push(\"crop\");\n  // The normaliser rebuilds the value from these keys; the rest is the asset's (width, height, size) or has no home.\n  for (const k of [\"caption\", \"width\", \"height\", \"size\"] as const) if (v[k] !== undefined) lost.push(k);\n  for (const k of Object.keys(v)) if (![\"url\", \"id\", \"name\", \"alt\", \"focal\", \"crop\", \"caption\", \"width\", \"height\", \"size\"].includes(k)) lost.push(k);\n  return { value: out, lost };\n}\n\n/** Pass the asset's pixel size to read a stored crop rect back as its preset and to restore width / height / size. */\nexport function imageFromProd(v: unknown, asset: ImageAsset = {}): V2ImageValue | string | null {\n  if (typeof v === \"string\") return v;\n  if (!isObj(v) || typeof v.url !== \"string\") return null;\n  const p = v as unknown as ProdImageValue;\n  const out: V2ImageValue = { url: p.url };\n  if (p.id !== undefined) out.id = p.id;\n  if (p.name !== undefined) out.name = p.name;\n  if (p.altText !== undefined) out.alt = p.altText;\n  if (p.focal) out.focal = { x: round(p.focal.x * 100), y: round(p.focal.y * 100) };\n  if (p.crop && asset.width && asset.height) {\n    const preset = cropPreset(p.crop, asset.width, asset.height);\n    if (preset) out.crop = preset;\n  }\n  if (asset.width !== undefined) out.width = asset.width;\n  if (asset.height !== undefined) out.height = asset.height;\n  if (asset.size !== undefined) out.size = asset.size;\n  return out;\n}\n\n/* ── reference ────────────────────────────────────────────────────────── */\n/**\n * V2 stores the target id (`\"en_12\"`; a list for many). Prod stores the same id, or `{ entryId, modelSlug }` on a\n * polymorphic field (pass `modelSlug`), or `{ formId }` on a component `form` prop (`to: \"form\"`).\n */\nexport function referenceToProd(\n  v: string | string[] | null | undefined,\n  opts: { to?: \"form\"; modelSlug?: string } = {},\n): ValueResult<string | string[] | ProdPolymorphicRef | ProdFormRef | null> {\n  if (v == null || v === \"\") return { value: null, lost: [] };\n  if (Array.isArray(v)) return { value: [...v], lost: [] };\n  if (opts.to === \"form\") return { value: { formId: v }, lost: [] };\n  if (opts.modelSlug) return { value: { entryId: v, modelSlug: opts.modelSlug }, lost: [] };\n  return { value: v, lost: [] };\n}\n\nconst refId = (v: unknown): string | null =>\n  typeof v === \"string\" ? v || null : isObj(v) ? ((typeof v.entryId === \"string\" && v.entryId) || (typeof v.formId === \"string\" && v.formId) || null) : null;\n\nexport function referenceFromProd(v: unknown): string | string[] | null {\n  if (Array.isArray(v)) return v.map(refId).filter((x): x is string => !!x);\n  return refId(v);\n}\n\n/* ── table ────────────────────────────────────────────────────────────── */\n/**\n * Prod has no table type: the schema adapter stores a V2 table as a `json` field (named in the lossy ledger), and\n * `json` keeps any JSON value, so the TableValue itself is stored verbatim (typed columns, groups, footer,\n * footnotes, caption, design, jsonLd).\n */\nexport function tableToProd(v: TableValue | null | undefined): ValueResult<TableValue | null> {\n  return { value: v == null ? null : (JSON.parse(JSON.stringify(v)) as TableValue), lost: [] };\n}\nexport const tableFromProd = (v: unknown): TableValue | null => (isObj(v) ? (v as unknown as TableValue) : null);\n\n/* ── scale ────────────────────────────────────────────────────────────── */\nconst SCALE_UNITS: readonly ScaleUnit[] = [\"px\", \"%\", \"rem\", \"em\", \"vw\", \"vh\"];\n/**\n * Prod stores the three V2 scale shapes as they are (CPO D41, reference-validation.ts scaleValueProblem): a bare number,\n * a token step's string, a custom `{ value, unit }`. Pass the field's scale: a token it does not list, or a custom value\n * it does not allow (allowCustom off, a unit outside its units, past its bounds), is refused by the backend, so it is\n * not written (`lost: [\"\"]`). With no scale only a number is known to fit.\n */\nexport function scaleToProd(v: ScaleValue | null | undefined, scale?: ScaleSchema): ValueResult<ScaleValue | null> {\n  if (v == null) return { value: null, lost: [] };\n  if (typeof v === \"number\") return Number.isFinite(v) ? { value: v, lost: [] } : { value: null, lost: [\"\"] };\n  const refused = { value: null, lost: [\"\"] };\n  if (!scale) return refused;\n  if (typeof v === \"string\") return Array.isArray(scale.steps) && scale.steps.some((x) => x.value === v) ? { value: v, lost: [] } : refused;\n  if (!isObj(v) || !scale.allowCustom || typeof v.value !== \"number\" || !Number.isFinite(v.value) || Object.keys(v).some((k) => k !== \"value\" && k !== \"unit\")) return refused;\n  const custom = typeof scale.allowCustom === \"object\" ? scale.allowCustom : {};\n  const units = custom.units ?? scale.units ?? SCALE_UNITS;\n  if (!units.includes(v.unit)) return refused;\n  const bound = (b: number | Partial<Record<ScaleUnit, number>> | undefined) => (typeof b === \"number\" ? b : b?.[v.unit]);\n  const min = bound(custom.min);\n  const max = bound(custom.max);\n  if ((min !== undefined && v.value < min) || (max !== undefined && v.value > max)) return refused;\n  return { value: { value: v.value, unit: v.unit }, lost: [] };\n}\nexport function scaleFromProd(v: unknown): ScaleValue | null {\n  if (typeof v === \"number\") return Number.isFinite(v) ? v : null;\n  if (typeof v === \"string\") return v;\n  if (isObj(v) && typeof v.value === \"number\" && typeof v.unit === \"string\" && (SCALE_UNITS as readonly string[]).includes(v.unit)) return { value: v.value, unit: v.unit as ScaleUnit };\n  return null;\n}\n\n/* ── video ────────────────────────────────────────────────────────────── */\nexport type V2VideoValue = string | { url: string; poster?: string; autoplay?: boolean; loop?: boolean; transcript?: string };\n/** An http(s) URL or a site path; \"\" is an unset one (video-value.ts isVideoUrl). */\nconst isVideoUrl = (s: string) => s === \"\" || /^https?:\\/\\/[^\\s]+$/i.test(s.trim()) || /^\\/(?!\\/)\\S*$/.test(s.trim());\n/**\n * The V2 video value and prod's are the same shape: a URL string, or `{ url, poster?, autoplay?, loop?, transcript? }`\n * (the video block's props). The backend refuses any other key, and a url or poster that is not an http(s) URL or a\n * site path (video_value_invalid): another key is left out and named, a bad url refuses the value whole.\n */\nexport function videoToProd(v: V2VideoValue | null | undefined): ValueResult<ProdVideoValue | string | null> {\n  if (v == null) return { value: null, lost: [] };\n  if (typeof v === \"string\") return isVideoUrl(v) ? { value: v, lost: [] } : { value: null, lost: [\"\"] };\n  if (!isObj(v) || typeof v.url !== \"string\" || !isVideoUrl(v.url)) return { value: null, lost: [\"\"] };\n  const lost: string[] = [];\n  const out: Obj = {};\n  for (const [k, x] of Object.entries(v)) {\n    const ok =\n      !(VIDEO_VALUE_KEYS as readonly string[]).includes(k) ? false\n      : k === \"url\" ? true\n      : k === \"poster\" ? typeof x === \"string\" && isVideoUrl(x)\n      : k === \"transcript\" ? typeof x === \"string\" && x.length <= VIDEO_TRANSCRIPT_MAX\n      : typeof x === \"boolean\";\n    if (ok) out[k] = x;\n    else if (x !== undefined) lost.push(k);\n  }\n  return { value: out as unknown as ProdVideoValue, lost };\n}\nexport function videoFromProd(v: unknown): V2VideoValue | null {\n  if (typeof v === \"string\") return v;\n  if (!isObj(v) || typeof v.url !== \"string\") return null;\n  return { ...v } as V2VideoValue;\n}\n\n/* ── primitive lists ──────────────────────────────────────────────────── */\nexport type ListItemType = \"text\" | \"number\" | \"date\" | \"image\" | \"link\" | \"richtext\";\n/**\n * A V2 list of one primitive (`of: [{ type }]`) is a prod `array` with `config.itemType`, each item judged and normalized\n * as a field of its type: an image item stores prod's image keys (altText, 0–1 focal), a link item its stored link. Scalar\n * and rich text items pass as they are. `lost` names `<index>/<key>` (or `<index>` for a whole item) per item.\n */\nexport function listToProd(v: unknown, itemType: ListItemType): ValueResult<unknown[] | null> {\n  if (v == null) return { value: null, lost: [] };\n  if (!Array.isArray(v)) return { value: null, lost: [\"\"] };\n  const lost: string[] = [];\n  const out: unknown[] = [];\n  v.forEach((x, i) => {\n    const r = itemType === \"image\" ? imageToProd(x as V2ImageValue) : itemType === \"link\" ? linkToProd(x as V2LinkValue) : { value: x, lost: [] };\n    for (const l of r.lost) lost.push(l ? `${i}/${l}` : String(i));\n    out.push(r.value);\n  });\n  return { value: out, lost };\n}\nexport function listFromProd(v: unknown, itemType: ListItemType): unknown[] {\n  if (!Array.isArray(v)) return [];\n  return itemType === \"image\" ? v.map((x) => imageFromProd(x)) : itemType === \"link\" ? v.map((x) => linkFromProd(x)) : [...v];\n}\n\n/* ── tags ─────────────────────────────────────────────────────────────── */\n/**\n * The backend judges tags trimmed and case-insensitively (reference-validation.ts tagsValueProblem): a field write\n * trims and de-dupes, a prop value is refused (tags_value_invalid). So the value is written clean for both: trimmed,\n * first spelling of a case-repeat kept, and an empty, over-long, off-list (`allowCustom: false`) or over-`max` tag left\n * out. `lost` names each changed or dropped tag by its index in `v`.\n */\nexport function tagsToProd(\n  v: string[] | null | undefined,\n  opts: { max?: number; allowCustom?: boolean; options?: (string | { value: string })[] } = {},\n): ValueResult<string[] | null> {\n  if (v == null) return { value: null, lost: [] };\n  const allowed = opts.allowCustom === false ? new Set((opts.options ?? []).map((o) => (typeof o === \"string\" ? o : o.value).trim().toLowerCase())) : undefined;\n  const out: string[] = [];\n  const seen = new Set<string>();\n  const lost: string[] = [];\n  v.forEach((x, i) => {\n    const t = typeof x === \"string\" ? x.trim() : \"\";\n    const folded = t.toLowerCase();\n    const keep =\n      t !== \"\" && Array.from(t).length <= TAG_VALUE_MAX_LENGTH && !seen.has(folded) && (!allowed || allowed.has(folded)) && (opts.max === undefined || out.length < opts.max);\n    if (keep) {\n      seen.add(folded);\n      out.push(t);\n    }\n    if (!keep || t !== x) lost.push(String(i));\n  });\n  return { value: out, lost };\n}\nexport const tagsFromProd = (v: unknown): string[] => (Array.isArray(v) ? v.filter((x): x is string => typeof x === \"string\") : []);\n\n/* ── rating ───────────────────────────────────────────────────────────── */\nexport interface RatingScale {\n  min?: number;\n  max?: number;\n  step?: number;\n}\n/**\n * A prod rating runs from config.min (0 unset) to config.max (5 unset) in steps of config.step (1 unset), and 0 is \"not\n * rated\" on every scale (validation-parity.ts ratingScale / onRatingScale). V2's empty rating is null: it is written as\n * null, and any other number off the scale is refused by the backend (rating_value_invalid), so it is not written either.\n */\nexport function ratingToProd(v: number | null | undefined, opts: RatingScale = {}): ValueResult<number | null> {\n  if (v == null) return { value: null, lost: [] };\n  const min = opts.min ?? 0;\n  const max = opts.max ?? RATING_DEFAULT_MAX;\n  const step = opts.step ?? 1;\n  const steps = (v - min) / step;\n  const ok = Number.isFinite(v) && v >= min && v <= max && Math.abs(steps - Math.round(steps)) < 1e-9;\n  return ok ? { value: v, lost: [] } : { value: null, lost: [\"\"] };\n}\n/** A stored number back; 0 on a scale that starts above it is prod's \"not rated\", which V2 holds as null. */\nexport function ratingFromProd(v: unknown, opts: RatingScale = {}): number | null {\n  if (typeof v !== \"number\" || !Number.isFinite(v)) return null;\n  return v === 0 && (opts.min ?? 0) > 0 ? null : v;\n}\n\n/* ── code ─────────────────────────────────────────────────────────────── */\nexport type V2CodeValue = string | { language?: string; code: string };\n/**\n * Prod stores a code value as a string, or `{ language?, code }` (no other key). A language outside the field's\n * `config.languages` is refused by the backend (code_value_invalid), so it is left out and named; a value over\n * CODE_MAX_LENGTH characters is refused whole.\n */\nexport function codeToProd(v: V2CodeValue | null | undefined, opts: { languages?: string[] } = {}): ValueResult<V2CodeValue | null> {\n  if (v == null) return { value: null, lost: [] };\n  const code = typeof v === \"string\" ? v : v.code;\n  if (typeof code !== \"string\" || code.length > CODE_MAX_LENGTH) return { value: null, lost: [\"\"] };\n  if (typeof v === \"string\") return { value: v, lost: [] };\n  const lost = Object.keys(v).filter((k) => k !== \"code\" && k !== \"language\");\n  const out: { language?: string; code: string } = { code };\n  if (v.language !== undefined) {\n    if (typeof v.language === \"string\" && (!opts.languages || opts.languages.includes(v.language))) out.language = v.language;\n    else lost.push(\"language\");\n  }\n  return { value: out, lost };\n}\nexport function codeFromProd(v: unknown): V2CodeValue | null {\n  if (typeof v === \"string\") return v;\n  if (!isObj(v) || typeof v.code !== \"string\") return null;\n  return typeof v.language === \"string\" ? { language: v.language, code: v.code } : { code: v.code };\n}\n\n/* ── zoned arrays ─────────────────────────────────────────────────────── */\n/** A V2 list of object items is stored by prod as the repeatable zone of its array: `{ repeatable: [...] }`. */\nexport const zoneListToProd = (v: unknown[] | null | undefined): { repeatable: unknown[] } => ({ repeatable: v ? [...v] : [] });\nexport const zoneListFromProd = (v: unknown): unknown[] => (isObj(v) && Array.isArray(v.repeatable) ? [...v.repeatable] : Array.isArray(v) ? [...v] : []);\n\n/** A dock icon name passes through; anything else is not a prod icon. */\nexport const isDockIcon = (v: unknown): v is DockIconName => typeof v === \"string\" && DOCK_ICON_NAME_SET.has(v);\n"],"mappings":"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"}

package/brand/logo.d.ts

@@ -0,0 +1,17 @@
+/** boxicons:sparkle-circle-filled — path from public/brand/ai-sparkle-glyph.svg (viewBox 2 2 16 16). */
+export declare const SPARKLE_PATH = "M9.4668 2.37243C9.64848 1.87586 10.351 1.87586 10.5326 2.37243L11.0754 3.85459C11.501 5.01732 12.1751 6.07325 13.0506 6.94879C13.9262 7.82432 14.9821 8.4984 16.1448 8.92405L17.627 9.4668C18.1243 9.64848 18.1243 10.351 17.627 10.5326L16.1448 11.0754C14.9821 11.501 13.9262 12.1751 13.0506 13.0506C12.1751 13.9262 11.501 14.9821 11.0754 16.1448L10.5326 17.627C10.351 18.1243 9.64848 18.1243 9.4668 17.627L8.92405 16.1448C8.4984 14.9821 7.82432 13.9262 6.94879 13.0506C6.07325 12.1751 5.01732 11.501 3.85459 11.0754L2.37243 10.5326C1.87586 10.351 1.87586 9.64848 2.37243 9.4668L3.85459 8.92405C5.01732 8.4984 6.07325 7.82432 6.94879 6.94879C7.82432 6.07325 8.4984 5.01732 8.92405 3.85459L9.4668 2.37243Z";
+export declare const BRAND_STOPS: {
+    offset: number;
+    color: string;
+}[];
+/** The mark alone (square). */
+export declare function LogoMark({ size, className }: {
+    size?: number;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/** Full lockup: mark + "BetterCMS" wordmark. Height-driven (default 24px → 106px wide). */
+export declare function Logo({ className, compact, height }: {
+    className?: string;
+    compact?: boolean;
+    height?: number;
+}): import("react/jsx-runtime").JSX.Element;

package/brand/logo.js

@@ -0,0 +1,9 @@
+import "react";
+import "react/jsx-runtime";
+//#region src/kit/brand/logo.tsx
+/** boxicons:sparkle-circle-filled — path from public/brand/ai-sparkle-glyph.svg (viewBox 2 2 16 16). */
+var SPARKLE_PATH = "M9.4668 2.37243C9.64848 1.87586 10.351 1.87586 10.5326 2.37243L11.0754 3.85459C11.501 5.01732 12.1751 6.07325 13.0506 6.94879C13.9262 7.82432 14.9821 8.4984 16.1448 8.92405L17.627 9.4668C18.1243 9.64848 18.1243 10.351 17.627 10.5326L16.1448 11.0754C14.9821 11.501 13.9262 12.1751 13.0506 13.0506C12.1751 13.9262 11.501 14.9821 11.0754 16.1448L10.5326 17.627C10.351 18.1243 9.64848 18.1243 9.4668 17.627L8.92405 16.1448C8.4984 14.9821 7.82432 13.9262 6.94879 13.0506C6.07325 12.1751 5.01732 11.501 3.85459 11.0754L2.37243 10.5326C1.87586 10.351 1.87586 9.64848 2.37243 9.4668L3.85459 8.92405C5.01732 8.4984 6.07325 7.82432 6.94879 6.94879C7.82432 6.07325 8.4984 5.01732 8.92405 3.85459L9.4668 2.37243Z";
+//#endregion
+export { SPARKLE_PATH };
+
+//# sourceMappingURL=logo.js.map