@bettercms-ai/kit 0.1.0 → 1.0.0

package/lib/schema.js

@@ -0,0 +1,287 @@
+import { getIn, isObj, newKey } from "./path.js";
+import { cellValue, isEmptyCell, isTableValue, tableSummary } from "../schema/table.js";
+//#region src/kit/lib/schema.ts
+var PRIMITIVES = new Set([
+	"string",
+	"text",
+	"richtext",
+	"number",
+	"boolean",
+	"slug",
+	"url",
+	"email",
+	"date",
+	"datetime",
+	"color",
+	"select",
+	"multiselect",
+	"tags",
+	"image",
+	"file",
+	"video",
+	"icon",
+	"link",
+	"button",
+	"reference",
+	"code",
+	"json",
+	"geopoint",
+	"rating",
+	"table"
+]);
+var isPrimitive = (t) => PRIMITIVES.has(t);
+/** Types whose value is plain text (counters, AI rewrite, copy/paste as text). */
+var isTextual = (t) => t === "string" || t === "text" || t === "richtext" || t === "slug" || t === "url" || t === "email";
+/** Types that are cheap to show inline inside a small object (no heavy surfaces). */
+var INLINE_OK = new Set([
+	"string",
+	"number",
+	"boolean",
+	"select",
+	"color",
+	"icon",
+	"url",
+	"email",
+	"date",
+	"rating",
+	"slug"
+]);
+var itemSchemas = (f) => Array.isArray(f.of) ? f.of : [];
+var slotAllow = (f) => f.of && !Array.isArray(f.of) ? f.of.allow : void 0;
+var itemSchemaFor = (f, item) => {
+	const of = itemSchemas(f);
+	if (isObj(item) && typeof item._type === "string") return of.find((o) => o.name === item._type) ?? of[0];
+	return of[0];
+};
+/** An array whose single item type is a primitive (tags, gallery, references, list of strings). */
+var primitiveItem = (f) => {
+	const of = itemSchemas(f);
+	return of.length === 1 && isPrimitive(of[0].type) ? of[0] : void 0;
+};
+var isSmallObject = (fields = []) => fields.length > 0 && fields.length <= 3 && fields.every((f) => INLINE_OK.has(f.type));
+/** How an object field / array item opens (CPO D8: inline for ≤3 primitives, else drill). */
+function objectOpenMode(f) {
+	if (f.openMode) return f.openMode;
+	return isSmallObject(f.fields) ? "inline" : "drill";
+}
+/**
+* CPO D43 — one rule for rows: an item of ≤3 simple fields (text, number, switch, select, colour, icon, url, email,
+* date, rating, slug) EXPANDS inline under its row; anything bigger, nested or rich DRILLS into its own frame.
+* `openMode` on the array still wins (developer override). Several item types → drill (they rarely share a shape).
+*/
+function itemOpenMode(arrayField) {
+	if (arrayField.openMode) return arrayField.openMode;
+	const of = itemSchemas(arrayField);
+	return of.length === 1 && isSmallObject(of[0].fields) ? "inline" : "drill";
+}
+function emptyFor(f) {
+	switch (f.type) {
+		case "boolean": return false;
+		case "number":
+		case "rating": return null;
+		case "multiselect":
+		case "tags":
+		case "array":
+		case "slot": return [];
+		case "object": return objectInitial(f.fields ?? []);
+		case "image":
+		case "file":
+		case "video":
+		case "reference":
+		case "link":
+		case "button":
+		case "geopoint":
+		case "json":
+		case "table": return null;
+		default: return "";
+	}
+}
+var initialFor = (f) => f.initialValue !== void 0 ? structuredCloneSafe(f.initialValue) : emptyFor(f);
+function objectInitial(fields) {
+	const o = {};
+	for (const f of fields) if (f.initialValue !== void 0) o[f.name] = structuredCloneSafe(f.initialValue);
+	return o;
+}
+/** A new array item for `itemSchema` (stamped with `_key` and, when the array allows several types, `_type`). */
+function newItem(arrayField, itemSchema) {
+	if (isPrimitive(itemSchema.type)) return initialFor(itemSchema);
+	const base = itemSchema.initialValue && isObj(itemSchema.initialValue) ? structuredCloneSafe(itemSchema.initialValue) : objectInitial(itemSchema.fields ?? []);
+	const multi = itemSchemas(arrayField).length > 1;
+	return {
+		_key: newKey(),
+		...multi ? { _type: itemSchema.name } : {},
+		...base
+	};
+}
+function newBlock(block, settings) {
+	const init = block.initialValue ? structuredCloneSafe(block.initialValue) : objectInitial(block.fields);
+	const s = settings?.length ? { _settings: objectInitial(settings) } : {};
+	return {
+		_key: newKey(),
+		_type: block.name,
+		...block.variants?.[0] ? { _variant: block.variants[0].id } : {},
+		...s,
+		...init
+	};
+}
+function structuredCloneSafe(v) {
+	try {
+		return structuredClone(v);
+	} catch {
+		return JSON.parse(JSON.stringify(v));
+	}
+}
+/** `hidden: true` hides; a Condition SHOWS the field only when the sibling matches (types.ts contract). */
+function isHidden(f, parent) {
+	if (f.hidden === true) return true;
+	if (!f.hidden) return false;
+	const c = f.hidden;
+	const sib = isObj(parent) ? parent[c.field] : void 0;
+	if (c.notEmpty) return isEmptyValue(sib);
+	if (c.equals !== void 0) return !(Array.isArray(c.equals) ? c.equals : [c.equals]).includes(sib);
+	return false;
+}
+/** Portable Text blocks' text, one block per space; "" when the array holds no blocks (a list of items). */
+var blocksText = (v) => v.map((b) => isObj(b) && Array.isArray(b.children) ? b.children.map((c) => isObj(c) && typeof c.text === "string" ? c.text : "").join("") : "").filter(Boolean).join(" ").replace(/\s+/g, " ").trim();
+/**
+* A value as one line of text. Stored rich text reads as its words in every shape production keeps: an html string,
+* Portable Text blocks, and the component props envelope `{ content: { version, content: blocks }, html }`.
+*/
+var plainText = (v) => {
+	if (typeof v === "string") return v.replace(/<[^>]*>/g, " ").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
+	if (typeof v === "number") return String(v);
+	if (Array.isArray(v)) return blocksText(v);
+	if (isObj(v)) {
+		if (typeof v.label === "string" && v.label) return v.label;
+		if (typeof v.title === "string") return v.title;
+		if (typeof v.href === "string") return v.href;
+		if (typeof v.name === "string") return v.name;
+		if ("content" in v && typeof v.content === "object" && v.content !== null) {
+			const t = plainText(v.content);
+			if (t) return t;
+		}
+		if (typeof v.html === "string") return plainText(v.html);
+	}
+	return "";
+};
+function isEmptyValue(v) {
+	if (v == null) return true;
+	if (typeof v === "string") return plainText(v) === "" && !/<img|<hr|<table|data-block|data-embed/.test(v);
+	if (Array.isArray(v)) return v.length === 0;
+	if (isTableValue(v)) return !v.caption?.trim() && v.rows.every((r) => Object.values(r.cells ?? {}).every((c) => isEmptyCell(cellValue(c))));
+	if (isObj(v)) {
+		if ("url" in v) return !v.url;
+		if ("href" in v && !("label" in v)) return !v.href;
+		if ("label" in v && "href" in v) return !v.label && !v.href;
+		return Object.keys(v).filter((k) => !k.startsWith("_")).every((k) => isEmptyValue(v[k]));
+	}
+	return false;
+}
+var imageUrl = (v) => typeof v === "string" && /^(https?:|blob:|data:image|\/)/.test(v) ? v : isObj(v) && typeof v.url === "string" && v.url ? v.url : void 0;
+/** Singular noun for an array's items: itemNoun → item title → field title minus "s". */
+function itemNoun(f) {
+	if (f.itemNoun) return f.itemNoun;
+	const of = itemSchemas(f);
+	if (of.length === 1 && of[0].title && !isPrimitive(of[0].type)) return of[0].title.toLowerCase();
+	const t = f.title.toLowerCase();
+	return t.endsWith("ies") ? `${t.slice(0, -3)}y` : t.endsWith("s") ? t.slice(0, -1) : "item";
+}
+/** Display text of one field value (select → option label). */
+function fieldText(f, v) {
+	if (f?.type === "select") return f.options?.find((o) => o.value === v)?.label ?? plainText(v);
+	return plainText(v);
+}
+function firstText(fields, v, skip) {
+	for (const f of fields) {
+		if (f.name === skip) continue;
+		if (f.type === "select") {
+			const t = fieldText(f, v[f.name]);
+			if (t) return {
+				name: f.name,
+				text: t
+			};
+		}
+		if (f.type === "string" || f.type === "text" || f.type === "richtext" || f.type === "number") {
+			const t = plainText(v[f.name]);
+			if (t) return {
+				name: f.name,
+				text: t
+			};
+		}
+		if (f.type === "button" || f.type === "link") {
+			const t = plainText(v[f.name]);
+			if (t) return {
+				name: f.name,
+				text: t
+			};
+		}
+	}
+	for (const f of fields) {
+		if (f.name === skip || f.type !== "url" && f.type !== "email" && f.type !== "slug") continue;
+		const t = plainText(v[f.name]);
+		if (t) return {
+			name: f.name,
+			text: t
+		};
+	}
+}
+function previewOf(itemSchema, item, index, fallbackTitle) {
+	const v = isObj(item) ? item : {};
+	const fields = (itemSchema && "fields" in itemSchema ? itemSchema.fields : void 0) ?? [];
+	const cfg = itemSchema?.preview;
+	const at = (p) => fieldText(fields.find((f) => f.name === p), getIn(v, p.split(".")));
+	let title = cfg?.title ? at(cfg.title) : "";
+	let titleField = cfg?.title;
+	if (!title) {
+		const t = firstText(fields, v);
+		title = t?.text ?? "";
+		titleField = t?.name;
+	}
+	let subtitle = cfg?.subtitle ? at(cfg.subtitle) : "";
+	if (!subtitle && !cfg?.subtitle) subtitle = firstText(fields, v, titleField)?.text ?? "";
+	let media = cfg?.media ? imageUrl(getIn(v, cfg.media.split("."))) : void 0;
+	if (!media && !cfg?.media) {
+		const img = fields.find((f) => f.type === "image");
+		if (img) media = imageUrl(v[img.name]);
+	}
+	const empty = !title;
+	const noun = fallbackTitle ?? itemSchema?.title ?? "Item";
+	return {
+		title: title || cfg?.fallback || `${noun} ${index + 1}`,
+		subtitle: subtitle ? subtitle.length > 90 ? `${subtitle.slice(0, 88)}…` : subtitle : void 0,
+		media,
+		icon: cfg?.icon ?? itemSchema?.icon,
+		empty
+	};
+}
+/** "Cast iron · 4 items" — one-line summary of an object for collapsed rows and fieldset headers. */
+function summarize(fields, v, max = 2) {
+	if (!isObj(v)) return "";
+	const parts = [];
+	for (const f of fields) {
+		if (parts.length >= max) break;
+		const x = v[f.name];
+		if (isEmptyValue(x)) continue;
+		if (f.type === "reference" || f.type === "json" || f.type === "code" || f.type === "image" || f.type === "file") continue;
+		if (f.type === "table") {
+			parts.push(tableSummary(x));
+			continue;
+		}
+		if (f.type === "rating" && typeof x === "number") {
+			parts.push(`${x} / 5`);
+			continue;
+		}
+		if (Array.isArray(x)) parts.push(`${x.length} ${x.length === 1 ? itemNounSafe(f) : `${itemNounSafe(f)}s`}`);
+		else if (typeof x === "boolean") parts.push(`${f.title}: ${x ? "on" : "off"}`);
+		else {
+			const t = fieldText(f, x);
+			if (t) parts.push(t.length > 40 ? `${t.slice(0, 38)}…` : t);
+		}
+	}
+	return parts.join(" · ");
+}
+var itemNounSafe = (f) => f.type === "array" || f.type === "slot" ? itemNoun(f) : "item";
+//#endregion
+export { initialFor, isEmptyValue, isHidden, isPrimitive, isTextual, itemNoun, itemOpenMode, itemSchemaFor, itemSchemas, newBlock, newItem, objectOpenMode, plainText, previewOf, primitiveItem, slotAllow, summarize };
+
+//# sourceMappingURL=schema.js.map

package/lib/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../src/kit/lib/schema.ts"],"sourcesContent":["/**\n * Schema helpers — pure functions the engine uses to decide HOW a field is edited and WHAT a row shows.\n */\nimport type { Condition, FieldSchema, OpenMode, PrimitiveType, SchemaType, TypeSchema } from \"../schema/types\";\nimport { getIn, isObj, newKey } from \"./path\";\nimport { cellValue, isEmptyCell, isTableValue, tableSummary } from \"../schema/table\";\n\nconst PRIMITIVES: ReadonlySet<SchemaType> = new Set<PrimitiveType>([\n  \"string\", \"text\", \"richtext\", \"number\", \"boolean\", \"slug\", \"url\", \"email\", \"date\", \"datetime\", \"color\", \"select\", \"multiselect\",\n  \"tags\", \"image\", \"file\", \"video\", \"icon\", \"link\", \"button\", \"reference\", \"code\", \"json\", \"geopoint\", \"rating\", \"table\",\n]);\nexport const isPrimitive = (t: SchemaType) => PRIMITIVES.has(t);\n/** Types whose value is plain text (counters, AI rewrite, copy/paste as text). */\nexport const isTextual = (t: SchemaType) => t === \"string\" || t === \"text\" || t === \"richtext\" || t === \"slug\" || t === \"url\" || t === \"email\";\n/** Types that are cheap to show inline inside a small object (no heavy surfaces). */\nconst INLINE_OK: ReadonlySet<SchemaType> = new Set([\"string\", \"number\", \"boolean\", \"select\", \"color\", \"icon\", \"url\", \"email\", \"date\", \"rating\", \"slug\"]);\n\nexport const itemSchemas = (f: FieldSchema): FieldSchema[] => (Array.isArray(f.of) ? f.of : []);\nexport const slotAllow = (f: FieldSchema): string[] | undefined => (f.of && !Array.isArray(f.of) ? f.of.allow : undefined);\nexport const itemSchemaFor = (f: FieldSchema, item: unknown): FieldSchema | undefined => {\n  const of = itemSchemas(f);\n  if (isObj(item) && typeof item._type === \"string\") return of.find((o) => o.name === item._type) ?? of[0];\n  return of[0];\n};\n/** An array whose single item type is a primitive (tags, gallery, references, list of strings). */\nexport const primitiveItem = (f: FieldSchema): FieldSchema | undefined => {\n  const of = itemSchemas(f);\n  return of.length === 1 && isPrimitive(of[0].type) ? of[0] : undefined;\n};\nexport const isSmallObject = (fields: FieldSchema[] = []) => fields.length > 0 && fields.length <= 3 && fields.every((f) => INLINE_OK.has(f.type));\n\n/** How an object field / array item opens (CPO D8: inline for ≤3 primitives, else drill). */\nexport function objectOpenMode(f: FieldSchema): OpenMode {\n  if (f.openMode) return f.openMode;\n  return isSmallObject(f.fields) ? \"inline\" : \"drill\";\n}\n/**\n * CPO D43 — one rule for rows: an item of ≤3 simple fields (text, number, switch, select, colour, icon, url, email,\n * date, rating, slug) EXPANDS inline under its row; anything bigger, nested or rich DRILLS into its own frame.\n * `openMode` on the array still wins (developer override). Several item types → drill (they rarely share a shape).\n */\nexport function itemOpenMode(arrayField: FieldSchema): OpenMode {\n  if (arrayField.openMode) return arrayField.openMode;\n  const of = itemSchemas(arrayField);\n  return of.length === 1 && isSmallObject(of[0].fields) ? \"inline\" : \"drill\";\n}\n\nexport function emptyFor(f: FieldSchema): unknown {\n  switch (f.type) {\n    case \"boolean\": return false;\n    case \"number\": case \"rating\": return null;\n    case \"multiselect\": case \"tags\": case \"array\": case \"slot\": return [];\n    case \"object\": return objectInitial(f.fields ?? []);\n    case \"image\": case \"file\": case \"video\": case \"reference\": case \"link\": case \"button\": case \"geopoint\": case \"json\": case \"table\": return null;\n    default: return \"\";\n  }\n}\nexport const initialFor = (f: FieldSchema) => (f.initialValue !== undefined ? structuredCloneSafe(f.initialValue) : emptyFor(f));\nexport function objectInitial(fields: FieldSchema[]): Record<string, unknown> {\n  const o: Record<string, unknown> = {};\n  for (const f of fields) if (f.initialValue !== undefined) o[f.name] = structuredCloneSafe(f.initialValue);\n  return o;\n}\n/** A new array item for `itemSchema` (stamped with `_key` and, when the array allows several types, `_type`). */\nexport function newItem(arrayField: FieldSchema, itemSchema: FieldSchema): unknown {\n  if (isPrimitive(itemSchema.type)) return initialFor(itemSchema);\n  const base = itemSchema.initialValue && isObj(itemSchema.initialValue) ? structuredCloneSafe(itemSchema.initialValue) : objectInitial(itemSchema.fields ?? []);\n  const multi = itemSchemas(arrayField).length > 1;\n  return { _key: newKey(), ...(multi ? { _type: itemSchema.name } : {}), ...(base as object) };\n}\nexport function newBlock(block: TypeSchema, settings?: FieldSchema[]): Record<string, unknown> {\n  const init = block.initialValue ? structuredCloneSafe(block.initialValue) : objectInitial(block.fields);\n  const s = settings?.length ? { _settings: objectInitial(settings) } : {};\n  return { _key: newKey(), _type: block.name, ...(block.variants?.[0] ? { _variant: block.variants[0].id } : {}), ...s, ...(init as object) };\n}\nexport function structuredCloneSafe<T>(v: T): T {\n  try {\n    return structuredClone(v);\n  } catch {\n    return JSON.parse(JSON.stringify(v)) as T;\n  }\n}\n\n/* ── Conditions ───────────────────────────────────────────────────────── */\n/** `hidden: true` hides; a Condition SHOWS the field only when the sibling matches (types.ts contract). */\nexport function isHidden(f: FieldSchema, parent: unknown): boolean {\n  if (f.hidden === true) return true;\n  if (!f.hidden) return false;\n  const c = f.hidden as Condition;\n  const sib = isObj(parent) ? parent[c.field] : undefined;\n  if (c.notEmpty) return isEmptyValue(sib);\n  if (c.equals !== undefined) {\n    const list = Array.isArray(c.equals) ? c.equals : [c.equals];\n    return !list.includes(sib as never);\n  }\n  return false;\n}\n\n/* ── Values → text ────────────────────────────────────────────────────── */\n/** Portable Text blocks' text, one block per space; \"\" when the array holds no blocks (a list of items). */\nconst blocksText = (v: unknown[]): string =>\n  v\n    .map((b) => (isObj(b) && Array.isArray(b.children) ? b.children.map((c) => (isObj(c) && typeof c.text === \"string\" ? c.text : \"\")).join(\"\") : \"\"))\n    .filter(Boolean)\n    .join(\" \")\n    .replace(/\\s+/g, \" \")\n    .trim();\n/**\n * A value as one line of text. Stored rich text reads as its words in every shape production keeps: an html string,\n * Portable Text blocks, and the component props envelope `{ content: { version, content: blocks }, html }`.\n */\nexport const plainText = (v: unknown): string => {\n  if (typeof v === \"string\") return v.replace(/<[^>]*>/g, \" \").replace(/&nbsp;/g, \" \").replace(/\\s+/g, \" \").trim();\n  if (typeof v === \"number\") return String(v);\n  if (Array.isArray(v)) return blocksText(v);\n  if (isObj(v)) {\n    if (typeof v.label === \"string\" && v.label) return v.label;\n    if (typeof v.title === \"string\") return v.title;\n    if (typeof v.href === \"string\") return v.href;\n    if (typeof v.name === \"string\") return v.name;\n    // the envelope's blocks first: their text is unescaped (the html holds `&amp;`)\n    if (\"content\" in v && typeof v.content === \"object\" && v.content !== null) {\n      const t = plainText(v.content);\n      if (t) return t;\n    }\n    if (typeof v.html === \"string\") return plainText(v.html);\n  }\n  return \"\";\n};\nexport function isEmptyValue(v: unknown): boolean {\n  if (v == null) return true;\n  if (typeof v === \"string\") return plainText(v) === \"\" && !/<img|<hr|<table|data-block|data-embed/.test(v);\n  if (Array.isArray(v)) return v.length === 0;\n  if (isTableValue(v)) return !v.caption?.trim() && v.rows.every((r) => Object.values(r.cells ?? {}).every((c) => isEmptyCell(cellValue(c))));\n  if (isObj(v)) {\n    if (\"url\" in v) return !v.url;\n    if (\"href\" in v && !(\"label\" in v)) return !v.href;\n    if (\"label\" in v && \"href\" in v) return !v.label && !v.href;\n    return Object.keys(v).filter((k) => !k.startsWith(\"_\")).every((k) => isEmptyValue(v[k]));\n  }\n  return false;\n}\nexport const imageUrl = (v: unknown): string | undefined =>\n  typeof v === \"string\" && /^(https?:|blob:|data:image|\\/)/.test(v) ? v : isObj(v) && typeof v.url === \"string\" && v.url ? v.url : undefined;\n\n/** Singular noun for an array's items: itemNoun → item title → field title minus \"s\". */\nexport function itemNoun(f: FieldSchema): string {\n  if (f.itemNoun) return f.itemNoun;\n  const of = itemSchemas(f);\n  if (of.length === 1 && of[0].title && !isPrimitive(of[0].type)) return of[0].title.toLowerCase();\n  const t = f.title.toLowerCase();\n  return t.endsWith(\"ies\") ? `${t.slice(0, -3)}y` : t.endsWith(\"s\") ? t.slice(0, -1) : \"item\";\n}\n\n/* ── Previews (array rows, slot rows, crumbs) ─────────────────────────── */\nexport interface Preview {\n  title: string;\n  subtitle?: string;\n  media?: string;\n  icon?: string;\n  empty: boolean;\n}\n/** Display text of one field value (select → option label). */\nfunction fieldText(f: FieldSchema | undefined, v: unknown): string {\n  if (f?.type === \"select\") return f.options?.find((o) => o.value === v)?.label ?? plainText(v);\n  return plainText(v);\n}\nfunction firstText(fields: FieldSchema[], v: Record<string, unknown>, skip?: string) {\n  for (const f of fields) {\n    if (f.name === skip) continue;\n    if (f.type === \"select\") {\n      const t = fieldText(f, v[f.name]);\n      if (t) return { name: f.name, text: t };\n    }\n    if (f.type === \"string\" || f.type === \"text\" || f.type === \"richtext\" || f.type === \"number\") {\n      const t = plainText(v[f.name]);\n      if (t) return { name: f.name, text: t };\n    }\n    if (f.type === \"button\" || f.type === \"link\") {\n      const t = plainText(v[f.name]);\n      if (t) return { name: f.name, text: t };\n    }\n  }\n  // no prose anywhere: a URL or address still beats \"Item 3\" (D47 — item titles use the first text value)\n  for (const f of fields) {\n    if (f.name === skip || (f.type !== \"url\" && f.type !== \"email\" && f.type !== \"slug\")) continue;\n    const t = plainText(v[f.name]);\n    if (t) return { name: f.name, text: t };\n  }\n  return undefined;\n}\nexport function previewOf(itemSchema: FieldSchema | TypeSchema | undefined, item: unknown, index: number, fallbackTitle?: string): Preview {\n  const v = isObj(item) ? item : {};\n  const fields = (itemSchema && \"fields\" in itemSchema ? itemSchema.fields : undefined) ?? [];\n  const cfg = itemSchema?.preview;\n  const at = (p: string) => fieldText(fields.find((f) => f.name === p), getIn(v, p.split(\".\")));\n  let title = cfg?.title ? at(cfg.title) : \"\";\n  let titleField = cfg?.title;\n  if (!title) {\n    const t = firstText(fields, v);\n    title = t?.text ?? \"\";\n    titleField = t?.name;\n  }\n  let subtitle = cfg?.subtitle ? at(cfg.subtitle) : \"\";\n  if (!subtitle && !cfg?.subtitle) subtitle = firstText(fields, v, titleField)?.text ?? \"\";\n  let media = cfg?.media ? imageUrl(getIn(v, cfg.media.split(\".\"))) : undefined;\n  if (!media && !cfg?.media) {\n    const img = fields.find((f) => f.type === \"image\");\n    if (img) media = imageUrl(v[img.name]);\n  }\n  const empty = !title;\n  const noun = fallbackTitle ?? (itemSchema?.title ?? \"Item\");\n  return {\n    title: title || cfg?.fallback || `${noun} ${index + 1}`,\n    subtitle: subtitle ? (subtitle.length > 90 ? `${subtitle.slice(0, 88)}…` : subtitle) : undefined,\n    media,\n    icon: cfg?.icon ?? (itemSchema as FieldSchema | undefined)?.icon,\n    empty,\n  };\n}\n\n/** \"Cast iron · 4 items\" — one-line summary of an object for collapsed rows and fieldset headers. */\nexport function summarize(fields: FieldSchema[], v: unknown, max = 2): string {\n  if (!isObj(v)) return \"\";\n  const parts: string[] = [];\n  for (const f of fields) {\n    if (parts.length >= max) break;\n    const x = v[f.name];\n    if (isEmptyValue(x)) continue;\n    if (f.type === \"reference\" || f.type === \"json\" || f.type === \"code\" || f.type === \"image\" || f.type === \"file\") continue; // ids and blobs read badly\n    if (f.type === \"table\") {\n      parts.push(tableSummary(x));\n      continue;\n    }\n    if (f.type === \"rating\" && typeof x === \"number\") {\n      parts.push(`${x} / 5`);\n      continue;\n    }\n    if (Array.isArray(x)) parts.push(`${x.length} ${x.length === 1 ? itemNounSafe(f) : `${itemNounSafe(f)}s`}`);\n    else if (typeof x === \"boolean\") parts.push(`${f.title}: ${x ? \"on\" : \"off\"}`);\n    else {\n      const t = fieldText(f, x);\n      if (t) parts.push(t.length > 40 ? `${t.slice(0, 38)}…` : t);\n    }\n  }\n  return parts.join(\" · \");\n}\nconst itemNounSafe = (f: FieldSchema) => (f.type === \"array\" || f.type === \"slot\" ? itemNoun(f) : \"item\");\n"],"mappings":"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"}

package/lib/utils.d.ts

@@ -0,0 +1,7 @@
+export declare const sleep: (ms: number) => Promise<unknown>;
+export declare const uid: (p?: string) => string;
+export declare function formatNumber(n: number): string;
+export declare function plural(n: number, one: string, many?: string): string;
+export declare function initials(name: string): string;
+export declare function relTime(iso: string | number | Date): string;
+export declare const slugify: (s: string) => string;

package/lib/utils.js

@@ -0,0 +1,37 @@
+//#region src/kit/lib/utils.ts
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var uid = (p = "id") => `${p}_${Math.random().toString(36).slice(2, 9)}`;
+function formatNumber(n) {
+	if (n >= 1e6) return `${(n / 1e6).toFixed(n >= 1e7 ? 0 : 1)}M`;
+	if (n >= 1e3) return `${(n / 1e3).toFixed(n >= 1e4 ? 0 : 1)}k`;
+	return `${n}`;
+}
+function plural(n, one, many = `${one}s`) {
+	return `${n} ${n === 1 ? one : many}`;
+}
+function initials(name) {
+	return name.split(/\s+/).map((p) => p[0]).slice(0, 2).join("").toUpperCase();
+}
+function relTime(iso) {
+	const d = new Date(iso).getTime();
+	const s = Math.round((Date.now() - d) / 1e3);
+	if (s < 45) return "just now";
+	const m = Math.round(s / 60);
+	if (m < 60) return `${m}m ago`;
+	const h = Math.round(m / 60);
+	if (h < 24) return `${h}h ago`;
+	const days = Math.round(h / 24);
+	if (days < 7) return `${days}d ago`;
+	const w = Math.round(days / 7);
+	if (w < 5) return `${w}w ago`;
+	return new Date(iso).toLocaleDateString("en-US", {
+		month: "short",
+		day: "numeric",
+		year: "numeric"
+	});
+}
+var slugify = (s) => s.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+//#endregion
+export { formatNumber, initials, plural, relTime, sleep, slugify, uid };
+
+//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/kit/lib/utils.ts"],"sourcesContent":["export const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));\nexport const uid = (p = \"id\") => `${p}_${Math.random().toString(36).slice(2, 9)}`;\nexport function formatNumber(n: number) {\n  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(n >= 10_000_000 ? 0 : 1)}M`;\n  if (n >= 1000) return `${(n / 1000).toFixed(n >= 10000 ? 0 : 1)}k`;\n  return `${n}`;\n}\nexport function plural(n: number, one: string, many = `${one}s`) {\n  return `${n} ${n === 1 ? one : many}`;\n}\nexport function initials(name: string) {\n  return name.split(/\\s+/).map((p) => p[0]).slice(0, 2).join(\"\").toUpperCase();\n}\nexport function relTime(iso: string | number | Date) {\n  const d = new Date(iso).getTime();\n  const s = Math.round((Date.now() - d) / 1000);\n  if (s < 45) return \"just now\";\n  const m = Math.round(s / 60); if (m < 60) return `${m}m ago`;\n  const h = Math.round(m / 60); if (h < 24) return `${h}h ago`;\n  const days = Math.round(h / 24); if (days < 7) return `${days}d ago`;\n  const w = Math.round(days / 7); if (w < 5) return `${w}w ago`;\n  return new Date(iso).toLocaleDateString(\"en-US\", { month: \"short\", day: \"numeric\", year: \"numeric\" });\n}\nexport const slugify = (s: string) => s.toLowerCase().trim().replace(/[^a-z0-9]+/g, \"-\").replace(/^-|-$/g, \"\");\n"],"mappings":";AAAA,IAAa,SAAS,OAAe,IAAI,SAAS,MAAM,WAAW,GAAG,GAAG,CAAC;AAC1E,IAAa,OAAO,IAAI,SAAS,GAAG,EAAE,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE;AAC/E,SAAgB,aAAa,GAAW;AACtC,KAAI,KAAK,IAAW,QAAO,IAAI,IAAI,KAAW,QAAQ,KAAK,MAAa,IAAI,EAAE,CAAC;AAC/E,KAAI,KAAK,IAAM,QAAO,IAAI,IAAI,KAAM,QAAQ,KAAK,MAAQ,IAAI,EAAE,CAAC;AAChE,QAAO,GAAG;;AAEZ,SAAgB,OAAO,GAAW,KAAa,OAAO,GAAG,IAAI,IAAI;AAC/D,QAAO,GAAG,EAAE,GAAG,MAAM,IAAI,MAAM;;AAEjC,SAAgB,SAAS,MAAc;AACrC,QAAO,KAAK,MAAM,MAAM,CAAC,KAAK,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,aAAa;;AAE9E,SAAgB,QAAQ,KAA6B;CACnD,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC,SAAS;CACjC,MAAM,IAAI,KAAK,OAAO,KAAK,KAAK,GAAG,KAAK,IAAK;AAC7C,KAAI,IAAI,GAAI,QAAO;CACnB,MAAM,IAAI,KAAK,MAAM,IAAI,GAAG;AAAE,KAAI,IAAI,GAAI,QAAO,GAAG,EAAE;CACtD,MAAM,IAAI,KAAK,MAAM,IAAI,GAAG;AAAE,KAAI,IAAI,GAAI,QAAO,GAAG,EAAE;CACtD,MAAM,OAAO,KAAK,MAAM,IAAI,GAAG;AAAE,KAAI,OAAO,EAAG,QAAO,GAAG,KAAK;CAC9D,MAAM,IAAI,KAAK,MAAM,OAAO,EAAE;AAAE,KAAI,IAAI,EAAG,QAAO,GAAG,EAAE;AACvD,QAAO,IAAI,KAAK,IAAI,CAAC,mBAAmB,SAAS;EAAE,OAAO;EAAS,KAAK;EAAW,MAAM;EAAW,CAAC;;AAEvG,IAAa,WAAW,MAAc,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,eAAe,IAAI,CAAC,QAAQ,UAAU,GAAG"}

package/lib/validate.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Validation — rules live in the schema (`validation`), messages state the rule in plain words.
+ * Two kinds: "required" (shown after blur or a publish attempt) and "rule" (shown on blur too, never while
+ * typing for the first time — the shell decides). Warnings (recommendedMax, missing alt) never block publish.
+ */
+import type { FieldPath, FieldSchema, TypeSchema } from "../schema/types";
+export interface KitIssue {
+    key: string;
+    path: FieldPath;
+    level: "error" | "warning";
+    kind: "required" | "rule";
+    message: string;
+}
+type Raw = Omit<KitIssue, "key" | "path">;
+export declare const textLength: (v: unknown) => number;
+/** Validate one value against its field (not recursing into children). */
+export declare function validateValue(f: FieldSchema, v: unknown): Raw | null;
+/** Walk fields under `obj` and collect every issue, recursing into objects, array items and slot blocks. */
+export declare function collectIssues(fields: FieldSchema[], obj: unknown, base: FieldPath, resolveSchema?: (t: string) => TypeSchema | undefined, out?: KitIssue[]): KitIssue[];
+export {};

package/lib/validate.js

@@ -0,0 +1,150 @@
+import { isObj, pathKey } from "./path.js";
+import { tableIssues } from "../schema/table.js";
+import { isEmptyValue, isHidden, itemSchemaFor, plainText, primitiveItem } from "./schema.js";
+//#region src/kit/lib/validate.ts
+var textLength = (v) => plainText(v).length;
+var counted = (f) => f.type === "string" || f.type === "text" || f.type === "richtext";
+/** Validate one value against its field (not recursing into children). */
+function validateValue(f, v) {
+	const r = f.validation ?? {};
+	const label = f.title;
+	if (r.required && isEmptyValue(v)) return {
+		level: "error",
+		kind: "required",
+		message: f.type === "image" ? `Add an image for ${label.toLowerCase()}` : f.type === "reference" ? `Choose ${label.toLowerCase()}` : f.type === "array" || f.type === "slot" ? `Add at least one item to ${label.toLowerCase()}` : `${label} is required`
+	};
+	if (isEmptyValue(v)) return null;
+	if (counted(f)) {
+		const n = textLength(v);
+		if (r.max && n > r.max) return {
+			level: "error",
+			kind: "rule",
+			message: `Keep it under ${r.max} characters (${n - r.max} over)`
+		};
+		if (r.min && n < r.min) return {
+			level: "error",
+			kind: "rule",
+			message: `Use at least ${r.min} characters`
+		};
+		if (r.recommendedMax && n > r.recommendedMax) return {
+			level: "warning",
+			kind: "rule",
+			message: `Longer than the recommended ${r.recommendedMax} characters. It may get cut off.`
+		};
+	}
+	if ((f.type === "array" || f.type === "slot" || f.type === "tags" || f.type === "multiselect") && Array.isArray(v)) {
+		if (r.min && v.length < r.min) return {
+			level: "error",
+			kind: "rule",
+			message: `Add at least ${r.min} ${r.min === 1 ? "item" : "items"}`
+		};
+		if (r.max && v.length > r.max) return {
+			level: "error",
+			kind: "rule",
+			message: `Use at most ${r.max} items`
+		};
+	}
+	if (f.type === "number" && typeof v === "number") {
+		const lo = r.min ?? f.numeric?.min;
+		const hi = r.max ?? f.numeric?.max;
+		if (lo != null && v < lo) return {
+			level: "error",
+			kind: "rule",
+			message: `Use ${lo} or more`
+		};
+		if (hi != null && v > hi) return {
+			level: "error",
+			kind: "rule",
+			message: `Use ${hi} or less`
+		};
+	}
+	if (typeof v === "string") {
+		if (f.type === "email" && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v)) return {
+			level: "error",
+			kind: "rule",
+			message: "Use a full email address, like hello@caldera.com"
+		};
+		if (f.type === "url" && !/^(https?:\/\/|\/|#|mailto:|tel:)[^\s]*$/.test(v)) return {
+			level: "error",
+			kind: "rule",
+			message: "Use a full URL, like https://example.com, or a path like /shop"
+		};
+		if (f.type === "url" && /^(javascript|data):/i.test(v)) return {
+			level: "error",
+			kind: "rule",
+			message: "This kind of link isn't allowed"
+		};
+		if (f.type === "slug" && !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(v)) return {
+			level: "error",
+			kind: "rule",
+			message: "Use lowercase letters, numbers and hyphens"
+		};
+		if (f.type === "json") try {
+			JSON.parse(v);
+		} catch {
+			return {
+				level: "error",
+				kind: "rule",
+				message: "Invalid JSON"
+			};
+		}
+		if (r.pattern && !new RegExp(r.pattern).test(v)) return {
+			level: "error",
+			kind: "rule",
+			message: r.patternMessage ?? "This doesn't match the expected format"
+		};
+	}
+	if (f.type === "table") {
+		const issues = tableIssues(v, {
+			...f.table,
+			minRows: f.table?.minRows ?? r.min,
+			maxRows: f.table?.maxRows ?? r.max
+		});
+		const first = issues.find((i) => i.level === "error") ?? issues[0];
+		if (first) return {
+			level: first.level,
+			kind: "rule",
+			message: first.message
+		};
+	}
+	if (f.type === "image" && isObj(v) && v.url && !v.alt && r.required) return {
+		level: "warning",
+		kind: "rule",
+		message: "No alt text. Describe the image for accessibility."
+	};
+	return null;
+}
+/** Walk fields under `obj` and collect every issue, recursing into objects, array items and slot blocks. */
+function collectIssues(fields, obj, base, resolveSchema, out = []) {
+	const v = isObj(obj) ? obj : {};
+	for (const f of fields) {
+		if (isHidden(f, v)) continue;
+		const p = [...base, f.name];
+		const val = v[f.name];
+		const raw = validateValue(f, val);
+		if (raw) out.push({
+			...raw,
+			key: pathKey(p),
+			path: p
+		});
+		if (f.type === "object" && f.fields) collectIssues(f.fields, val, p, resolveSchema, out);
+		if (f.type === "array" && Array.isArray(val) && !primitiveItem(f)) val.forEach((it, i) => {
+			const s = itemSchemaFor(f, it);
+			if (s?.fields) collectIssues(s.fields, it, [...p, i], resolveSchema, out);
+		});
+		if (f.type === "slot" && Array.isArray(val) && resolveSchema) val.forEach((it, i) => {
+			const b = isObj(it) && typeof it._type === "string" ? resolveSchema(it._type) : void 0;
+			if (b) collectIssues(b.fields, it, [...p, i], resolveSchema, out);
+			if (f.slotSettings && isObj(it)) collectIssues(f.slotSettings, it._settings, [
+				...p,
+				i,
+				"_settings"
+			], resolveSchema, out);
+		});
+	}
+	return out;
+}
+//#endregion
+export { collectIssues, textLength };
+
+//# sourceMappingURL=validate.js.map

package/lib/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","names":[],"sources":["../../src/kit/lib/validate.ts"],"sourcesContent":["/**\n * Validation — rules live in the schema (`validation`), messages state the rule in plain words.\n * Two kinds: \"required\" (shown after blur or a publish attempt) and \"rule\" (shown on blur too, never while\n * typing for the first time — the shell decides). Warnings (recommendedMax, missing alt) never block publish.\n */\nimport type { FieldPath, FieldSchema, TypeSchema } from \"../schema/types\";\nimport { isObj, pathKey } from \"./path\";\nimport { tableIssues } from \"../schema/table\";\nimport { isEmptyValue, isHidden, itemSchemaFor, plainText, primitiveItem } from \"./schema\";\n\nexport interface KitIssue {\n  key: string;\n  path: FieldPath;\n  level: \"error\" | \"warning\";\n  kind: \"required\" | \"rule\";\n  message: string;\n}\ntype Raw = Omit<KitIssue, \"key\" | \"path\">;\n\nexport const textLength = (v: unknown) => plainText(v).length;\nconst counted = (f: FieldSchema) => f.type === \"string\" || f.type === \"text\" || f.type === \"richtext\";\n\n/** Validate one value against its field (not recursing into children). */\nexport function validateValue(f: FieldSchema, v: unknown): Raw | null {\n  const r = f.validation ?? {};\n  const label = f.title;\n  if (r.required && isEmptyValue(v)) {\n    const msg =\n      f.type === \"image\" ? `Add an image for ${label.toLowerCase()}` :\n      f.type === \"reference\" ? `Choose ${label.toLowerCase()}` :\n      f.type === \"array\" || f.type === \"slot\" ? `Add at least one item to ${label.toLowerCase()}` :\n      `${label} is required`;\n    return { level: \"error\", kind: \"required\", message: msg };\n  }\n  if (isEmptyValue(v)) return null;\n\n  if (counted(f)) {\n    const n = textLength(v);\n    if (r.max && n > r.max) return { level: \"error\", kind: \"rule\", message: `Keep it under ${r.max} characters (${n - r.max} over)` };\n    if (r.min && n < r.min) return { level: \"error\", kind: \"rule\", message: `Use at least ${r.min} characters` };\n    if (r.recommendedMax && n > r.recommendedMax)\n      return { level: \"warning\", kind: \"rule\", message: `Longer than the recommended ${r.recommendedMax} characters. It may get cut off.` };\n  }\n  if ((f.type === \"array\" || f.type === \"slot\" || f.type === \"tags\" || f.type === \"multiselect\") && Array.isArray(v)) {\n    if (r.min && v.length < r.min) return { level: \"error\", kind: \"rule\", message: `Add at least ${r.min} ${r.min === 1 ? \"item\" : \"items\"}` };\n    if (r.max && v.length > r.max) return { level: \"error\", kind: \"rule\", message: `Use at most ${r.max} items` };\n  }\n  if (f.type === \"number\" && typeof v === \"number\") {\n    const lo = r.min ?? f.numeric?.min;\n    const hi = r.max ?? f.numeric?.max;\n    if (lo != null && v < lo) return { level: \"error\", kind: \"rule\", message: `Use ${lo} or more` };\n    if (hi != null && v > hi) return { level: \"error\", kind: \"rule\", message: `Use ${hi} or less` };\n  }\n  if (typeof v === \"string\") {\n    if (f.type === \"email\" && !/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(v)) return { level: \"error\", kind: \"rule\", message: \"Use a full email address, like hello@caldera.com\" };\n    if (f.type === \"url\" && !/^(https?:\\/\\/|\\/|#|mailto:|tel:)[^\\s]*$/.test(v)) return { level: \"error\", kind: \"rule\", message: \"Use a full URL, like https://example.com, or a path like /shop\" };\n    if (f.type === \"url\" && /^(javascript|data):/i.test(v)) return { level: \"error\", kind: \"rule\", message: \"This kind of link isn't allowed\" };\n    if (f.type === \"slug\" && !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(v)) return { level: \"error\", kind: \"rule\", message: \"Use lowercase letters, numbers and hyphens\" };\n    if (f.type === \"json\") {\n      try {\n        JSON.parse(v);\n      } catch {\n        return { level: \"error\", kind: \"rule\", message: \"Invalid JSON\" };\n      }\n    }\n    if (r.pattern && !new RegExp(r.pattern).test(v)) return { level: \"error\", kind: \"rule\", message: r.patternMessage ?? \"This doesn't match the expected format\" };\n  }\n  if (f.type === \"table\") {\n    // caption, header labels, typed cells, row limits, markup readiness (src/schema/table.ts) — first error wins\n    const issues = tableIssues(v, { ...f.table, minRows: f.table?.minRows ?? r.min, maxRows: f.table?.maxRows ?? r.max });\n    const first = issues.find((i) => i.level === \"error\") ?? issues[0];\n    if (first) return { level: first.level, kind: \"rule\", message: first.message };\n  }\n  if (f.type === \"image\" && isObj(v) && v.url && !v.alt && r.required) return { level: \"warning\", kind: \"rule\", message: \"No alt text. Describe the image for accessibility.\" };\n  return null;\n}\n\n/** Walk fields under `obj` and collect every issue, recursing into objects, array items and slot blocks. */\nexport function collectIssues(\n  fields: FieldSchema[],\n  obj: unknown,\n  base: FieldPath,\n  resolveSchema?: (t: string) => TypeSchema | undefined,\n  out: KitIssue[] = [],\n): KitIssue[] {\n  const v = isObj(obj) ? obj : {};\n  for (const f of fields) {\n    if (isHidden(f, v)) continue;\n    const p = [...base, f.name];\n    const val = v[f.name];\n    const raw = validateValue(f, val);\n    if (raw) out.push({ ...raw, key: pathKey(p), path: p });\n    if (f.type === \"object\" && f.fields) collectIssues(f.fields, val, p, resolveSchema, out);\n    if (f.type === \"array\" && Array.isArray(val) && !primitiveItem(f)) {\n      val.forEach((it, i) => {\n        const s = itemSchemaFor(f, it);\n        if (s?.fields) collectIssues(s.fields, it, [...p, i], resolveSchema, out);\n      });\n    }\n    if (f.type === \"slot\" && Array.isArray(val) && resolveSchema) {\n      val.forEach((it, i) => {\n        const b = isObj(it) && typeof it._type === \"string\" ? resolveSchema(it._type) : undefined;\n        if (b) collectIssues(b.fields, it, [...p, i], resolveSchema, out);\n        if (f.slotSettings && isObj(it)) collectIssues(f.slotSettings, it._settings, [...p, i, \"_settings\"], resolveSchema, out);\n      });\n    }\n  }\n  return out;\n}\n"],"mappings":"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"}