@shapio/schema 0.2.0

package/dist/validate-BQGutaBo.js

@@ -0,0 +1,381 @@
+//#region src/ids.ts
+/**
+* Stable IDs for models, components and fields: random UUIDs (v4).
+*
+* Why UUID rather than ULID: PostgreSQL stores and indexes `uuid` natively (16 bytes) for the system
+* tables that key on model IDs; `crypto.randomUUID()` exists in Node and every browser, so the admin can
+* create field IDs client-side with no dependency; and nothing in Shapio needs IDs to sort by creation time
+* (revisions carry their own version numbers and timestamps). IDs are compared case-insensitively nowhere:
+* they are always lower-case as generated.
+*/
+const STABLE_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+const isStableId = (value) => typeof value === "string" && STABLE_ID_PATTERN.test(value);
+const createStableId = () => globalThis.crypto.randomUUID();
+//#endregion
+//#region src/types/valueFormats.ts
+/**
+* Canonical text formats for values stored as JSON strings (ADR 0001: dates and times are canonical UTC
+* ISO-8601 text so they index and sort as text; decimal and biginteger are strings so no precision is lost).
+* The content validator (package E) and the settings validators here share these patterns.
+*/
+const DATE_PATTERN = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
+const DATETIME_PATTERN = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d{3})?Z$/;
+const TIME_PATTERN = /^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d(\.\d{3})?)?$/;
+const DECIMAL_PATTERN = /^-?(0|[1-9]\d*)(\.\d+)?$/;
+const BIGINTEGER_PATTERN = /^-?(0|[1-9]\d*)$/;
+/** Lower-case words joined by single hyphens, e.g. `summer-sale-2026`. */
+const SLUG_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/** URL-safe identifier characters for `uid` fields. */
+const UID_PATTERN = /^[A-Za-z0-9_.~-]+$/;
+/** The rich-text document envelope version this release reads and writes (ADR 0003). */
+const RICHTEXT_FORMAT = "shapio-richtext";
+const RICHTEXT_FORMAT_VERSION = 1;
+//#endregion
+//#region src/richtext/spec.ts
+const isNullOrString = (max) => (value) => value === null || typeof value === "string" && value.length <= max;
+const isIntegerIn = (min, max) => (value) => typeof value === "number" && Number.isInteger(value) && value >= min && value <= max;
+/** `href` values a link may carry: web, mail and phone links, and same-document/relative paths. */
+const SAFE_LINK_PATTERN = /^(https?:\/\/|mailto:|tel:|\/(?!\/)|#)/i;
+const isSafeHref = (value) => typeof value === "string" && value.length <= 2048 && SAFE_LINK_PATTERN.test(value.trim());
+const CELL_ATTRS = {
+	colspan: {
+		check: isIntegerIn(1, 1e3),
+		default: 1
+	},
+	rowspan: {
+		check: isIntegerIn(1, 1e3),
+		default: 1
+	},
+	colwidth: {
+		check: (value) => value === null || Array.isArray(value) && value.every((width) => isIntegerIn(0, 1e5)(width)),
+		default: null
+	}
+};
+const NODE_RULES = {
+	doc: {
+		group: "doc",
+		content: {
+			allow: ["block"],
+			min: 0
+		}
+	},
+	paragraph: {
+		group: "block",
+		content: {
+			allow: ["inline"],
+			min: 0
+		},
+		marks: true
+	},
+	heading: {
+		group: "block",
+		content: {
+			allow: ["inline"],
+			min: 0
+		},
+		marks: true,
+		attrs: { level: {
+			check: isIntegerIn(1, 6),
+			default: 1
+		} }
+	},
+	blockquote: {
+		group: "block",
+		content: {
+			allow: ["block"],
+			min: 1
+		}
+	},
+	bulletList: {
+		group: "block",
+		content: {
+			allow: ["listItem"],
+			min: 1
+		}
+	},
+	orderedList: {
+		group: "block",
+		content: {
+			allow: ["listItem"],
+			min: 1
+		},
+		attrs: {
+			start: {
+				check: isIntegerIn(0, 1e6),
+				default: 1
+			},
+			type: {
+				check: (value) => value === null || [
+					"1",
+					"a",
+					"A",
+					"i",
+					"I"
+				].includes(value),
+				default: null
+			}
+		}
+	},
+	listItem: {
+		group: "listItem",
+		content: {
+			allow: ["block"],
+			min: 1
+		}
+	},
+	codeBlock: {
+		group: "block",
+		content: {
+			allow: ["text"],
+			min: 0
+		},
+		marks: false,
+		attrs: { language: {
+			check: (value) => value === null || typeof value === "string" && /^[A-Za-z0-9_+#.-]{1,32}$/.test(value),
+			default: null
+		} }
+	},
+	horizontalRule: { group: "block" },
+	image: {
+		group: "block",
+		attrs: {
+			mediaId: {
+				check: isStableId,
+				default: void 0
+			},
+			alt: {
+				check: isNullOrString(1e3),
+				default: null
+			},
+			title: {
+				check: isNullOrString(1e3),
+				default: null
+			}
+		}
+	},
+	table: {
+		group: "block",
+		content: {
+			allow: ["tableRow"],
+			min: 1
+		}
+	},
+	tableRow: {
+		group: "tableRow",
+		content: {
+			allow: ["tableCell"],
+			min: 1
+		}
+	},
+	tableHeader: {
+		group: "tableCell",
+		content: {
+			allow: ["block"],
+			min: 1
+		},
+		attrs: CELL_ATTRS
+	},
+	tableCell: {
+		group: "tableCell",
+		content: {
+			allow: ["block"],
+			min: 1
+		},
+		attrs: CELL_ATTRS
+	},
+	text: { group: "inline" },
+	hardBreak: { group: "inline" }
+};
+const MARK_RULES = {
+	bold: {},
+	italic: {},
+	code: {},
+	link: { attrs: {
+		href: {
+			check: isSafeHref,
+			default: void 0
+		},
+		target: {
+			check: (value) => value === null || value === "_blank",
+			default: null
+		},
+		rel: {
+			check: isNullOrString(200),
+			default: null
+		},
+		class: {
+			check: (value) => value === null,
+			default: null
+		}
+	} }
+};
+/** Nesting deeper than this is rejected (keeps validation and rendering bounded). */
+const MAX_RICHTEXT_DEPTH = 40;
+//#endregion
+//#region src/richtext/validate.ts
+const NODE_KEYS = /* @__PURE__ */ new Set([
+	"type",
+	"attrs",
+	"content",
+	"text",
+	"marks"
+]);
+const MAX_PROBLEMS = 20;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const fail = (walk, path, message) => {
+	if (walk.problems.length < MAX_PROBLEMS) walk.problems.push({
+		path,
+		message
+	});
+};
+const checkAttrs = (walk, path, rules, raw) => {
+	if (raw !== void 0 && !isRecord(raw)) return fail(walk, `${path}/attrs`, "must be an object");
+	const given = raw ?? {};
+	const attrs = {};
+	for (const key of Object.keys(given)) if (!rules || !Object.hasOwn(rules, key)) fail(walk, `${path}/attrs/${key}`, "is not an allowed attribute");
+	for (const [key, rule] of Object.entries(rules ?? {})) {
+		const value = Object.hasOwn(given, key) ? given[key] : rule.default;
+		if (value === void 0 || !rule.check(value)) {
+			fail(walk, `${path}/attrs/${key}`, value === void 0 ? "is required" : "has an invalid value");
+			continue;
+		}
+		attrs[key] = value;
+	}
+	return Object.keys(attrs).length > 0 ? attrs : void 0;
+};
+const checkMarks = (walk, path, raw, allowed) => {
+	if (raw === void 0) return;
+	if (!Array.isArray(raw)) return fail(walk, `${path}/marks`, "must be a list");
+	if (!allowed && raw.length > 0) return fail(walk, `${path}/marks`, "marks are not allowed here");
+	const seen = /* @__PURE__ */ new Set();
+	const marks = [];
+	raw.forEach((mark, index) => {
+		const at = `${path}/marks/${index}`;
+		if (!isRecord(mark) || typeof mark.type !== "string" || !Object.hasOwn(MARK_RULES, mark.type)) {
+			fail(walk, at, "is not an allowed mark");
+			return;
+		}
+		if (Object.keys(mark).some((key) => key !== "type" && key !== "attrs")) fail(walk, at, "has unknown properties");
+		if (seen.has(mark.type)) fail(walk, at, "is repeated");
+		seen.add(mark.type);
+		const attrs = checkAttrs(walk, at, MARK_RULES[mark.type]?.attrs, mark.attrs);
+		marks.push(attrs ? {
+			type: mark.type,
+			attrs
+		} : { type: mark.type });
+	});
+	return marks.length > 0 ? marks : void 0;
+};
+const matchesAllow = (allow, type) => {
+	const rule = NODE_RULES[type];
+	return allow.includes(type) || rule !== void 0 && allow.includes(rule.group);
+};
+const checkNode = (walk, raw, path, depth, context) => {
+	if (depth > 40) return fail(walk, path, "is nested too deeply");
+	if (!isRecord(raw) || typeof raw.type !== "string") return fail(walk, path, "must be a node with a type");
+	const { type } = raw;
+	const rule = Object.hasOwn(NODE_RULES, type) ? NODE_RULES[type] : void 0;
+	if (!rule) return fail(walk, path, `"${type}" is not an allowed node`);
+	if (!matchesAllow(context.allow, type)) return fail(walk, path, `"${type}" is not allowed here`);
+	for (const key of Object.keys(raw)) if (!NODE_KEYS.has(key)) fail(walk, `${path}/${key}`, "is not an allowed property");
+	if (type === "text") {
+		if (typeof raw.text !== "string" || raw.text.length === 0) return fail(walk, `${path}/text`, "must be a non-empty string");
+		walk.textLength += raw.text.length;
+		const marks = checkMarks(walk, path, raw.marks, context.marks);
+		return marks ? {
+			type,
+			text: raw.text,
+			marks
+		} : {
+			type,
+			text: raw.text
+		};
+	}
+	if (raw.text !== void 0) fail(walk, `${path}/text`, "only text nodes carry text");
+	const node = { type };
+	const attrs = checkAttrs(walk, path, rule.attrs, raw.attrs);
+	if (attrs) node.attrs = attrs;
+	const marks = checkMarks(walk, path, raw.marks, context.marks && rule.group === "inline");
+	if (marks) node.marks = marks;
+	if (!rule.content) {
+		if (raw.content !== void 0 && !(Array.isArray(raw.content) && raw.content.length === 0)) fail(walk, `${path}/content`, `"${type}" has no content`);
+		return node;
+	}
+	if (raw.content !== void 0 && !Array.isArray(raw.content)) return fail(walk, `${path}/content`, "must be a list");
+	const children = raw.content ?? [];
+	if (children.length < rule.content.min) fail(walk, `${path}/content`, `"${type}" needs at least ${rule.content.min} child node(s)`);
+	const childContext = {
+		allow: rule.content.allow,
+		marks: rule.marks ?? true
+	};
+	const content = children.flatMap((child, index) => {
+		const checked = checkNode(walk, child, `${path}/content/${index}`, depth + 1, childContext);
+		return checked ? [checked] : [];
+	});
+	if (content.length > 0) node.content = content;
+	if (type === "codeBlock" || type === "paragraph" || type === "heading") walk.textLength += 1;
+	return node;
+};
+/**
+* Validates a stored rich-text value: the versioned envelope `{ format, version, doc }` and the document
+* against the baseline schema. Returns a normalized copy (known keys only, attribute defaults filled).
+*/
+const validateRichText = (value) => {
+	const walk = {
+		problems: [],
+		textLength: 0
+	};
+	if (!isRecord(value)) return {
+		ok: false,
+		problems: [{
+			path: "",
+			message: "must be a rich-text document object"
+		}]
+	};
+	if (value.format !== "shapio-richtext") fail(walk, "/format", `must be "${RICHTEXT_FORMAT}"`);
+	if (value.version !== 1) fail(walk, "/version", `must be 1`);
+	for (const key of Object.keys(value)) if (![
+		"format",
+		"version",
+		"doc"
+	].includes(key)) fail(walk, `/${key}`, "is not an allowed property");
+	const doc = checkNode(walk, value.doc, "/doc", 0, {
+		allow: ["doc"],
+		marks: false
+	});
+	if (walk.problems.length > 0 || !doc) return {
+		ok: false,
+		problems: walk.problems.length > 0 ? walk.problems : [{
+			path: "/doc",
+			message: "is invalid"
+		}]
+	};
+	return {
+		ok: true,
+		document: {
+			format: RICHTEXT_FORMAT,
+			version: 1,
+			doc
+		},
+		textLength: walk.textLength
+	};
+};
+/** True when a document holds no text and no media (an empty editor). */
+const isEmptyRichText = (document) => {
+	const hasSubstance = (node) => node.type === "text" || node.type === "image" || node.type === "horizontalRule" || (node.content ?? []).some(hasSubstance);
+	return !hasSubstance(document.doc);
+};
+/** Media assets a document's images reference, in document order, without repeats. */
+const richTextMediaIds = (document) => {
+	const ids = /* @__PURE__ */ new Set();
+	const walk = (node) => {
+		if (node.type === "image" && typeof node.attrs?.mediaId === "string") ids.add(node.attrs.mediaId);
+		(node.content ?? []).forEach(walk);
+	};
+	walk(document.doc);
+	return [...ids];
+};
+//#endregion
+export { STABLE_ID_PATTERN as _, MAX_RICHTEXT_DEPTH as a, BIGINTEGER_PATTERN as c, DECIMAL_PATTERN as d, RICHTEXT_FORMAT as f, UID_PATTERN as g, TIME_PATTERN as h, MARK_RULES as i, DATETIME_PATTERN as l, SLUG_PATTERN as m, richTextMediaIds as n, NODE_RULES as o, RICHTEXT_FORMAT_VERSION as p, validateRichText as r, SAFE_LINK_PATTERN as s, isEmptyRichText as t, DATE_PATTERN as u, createStableId as v, isStableId as y };
+
+//# sourceMappingURL=validate-BQGutaBo.js.map

package/dist/validate-BQGutaBo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-BQGutaBo.js","names":[],"sources":["../src/ids.ts","../src/types/valueFormats.ts","../src/richtext/spec.ts","../src/richtext/validate.ts"],"sourcesContent":["/**\n * Stable IDs for models, components and fields: random UUIDs (v4).\n *\n * Why UUID rather than ULID: PostgreSQL stores and indexes `uuid` natively (16 bytes) for the system\n * tables that key on model IDs; `crypto.randomUUID()` exists in Node and every browser, so the admin can\n * create field IDs client-side with no dependency; and nothing in Shapio needs IDs to sort by creation time\n * (revisions carry their own version numbers and timestamps). IDs are compared case-insensitively nowhere:\n * they are always lower-case as generated.\n */\nexport const STABLE_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;\n\nexport const isStableId = (value: unknown): value is string =>\n  typeof value === 'string' && STABLE_ID_PATTERN.test(value);\n\nexport const createStableId = (): string => globalThis.crypto.randomUUID();\n","/**\n * Canonical text formats for values stored as JSON strings (ADR 0001: dates and times are canonical UTC\n * ISO-8601 text so they index and sort as text; decimal and biginteger are strings so no precision is lost).\n * The content validator (package E) and the settings validators here share these patterns.\n */\nexport const DATE_PATTERN = /^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$/;\nexport const DATETIME_PATTERN =\n  /^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d{3})?Z$/;\nexport const TIME_PATTERN = /^([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d(\\.\\d{3})?)?$/;\nexport const DECIMAL_PATTERN = /^-?(0|[1-9]\\d*)(\\.\\d+)?$/;\nexport const BIGINTEGER_PATTERN = /^-?(0|[1-9]\\d*)$/;\n/** Lower-case words joined by single hyphens, e.g. `summer-sale-2026`. */\nexport const SLUG_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;\n/** URL-safe identifier characters for `uid` fields. */\nexport const UID_PATTERN = /^[A-Za-z0-9_.~-]+$/;\n\n/** The rich-text document envelope version this release reads and writes (ADR 0003). */\nexport const RICHTEXT_FORMAT = 'shapio-richtext';\nexport const RICHTEXT_FORMAT_VERSION = 1;\n","import { isStableId } from '../ids.js';\n\n/**\n * The rich-text document schema (ADR 0003, build plan §3.9): the baseline Tiptap/ProseMirror node and mark\n * set, as data. The server validates stored documents against it and renders HTML from it; the admin's\n * Tiptap editor (package F) must produce exactly these nodes, marks and attributes. Anything else is\n * rejected, never stripped silently.\n *\n * Why a hand-written structural check instead of `@tiptap/core` headless: the baseline is small and fixed,\n * the check needs no DOM shim, no extra runtime dependency on the server and no schema instantiation per\n * request, and it reports precise paths. Package F keeps the editor in step with this module (it is the\n * contract), and the shared JSON fixtures in this module's tests are what both sides agree on.\n */\n\nexport type AttrRule = {\n  /** Returns true when the value is acceptable. `null` is checked like any other value. */\n  check: (value: unknown) => boolean;\n  /** Used when the attribute is absent. */\n  default: unknown;\n};\n\nexport type NodeRule = {\n  /** `block` nodes sit in block containers; `inline` nodes in textblocks. */\n  group: 'block' | 'inline' | 'listItem' | 'tableRow' | 'tableCell' | 'doc';\n  /** Allowed child groups or node types, and the minimum number of children. */\n  content?: { allow: readonly string[]; min: number };\n  attrs?: Readonly<Record<string, AttrRule>>;\n  /** Inline children may carry marks (text nodes in a textblock); false for code blocks. */\n  marks?: boolean;\n};\n\nconst isNullOrString = (max: number) => (value: unknown) =>\n  value === null || (typeof value === 'string' && value.length <= max);\nconst isIntegerIn = (min: number, max: number) => (value: unknown) =>\n  typeof value === 'number' && Number.isInteger(value) && value >= min && value <= max;\n\n/** `href` values a link may carry: web, mail and phone links, and same-document/relative paths. */\nexport const SAFE_LINK_PATTERN = /^(https?:\\/\\/|mailto:|tel:|\\/(?!\\/)|#)/i;\nconst isSafeHref = (value: unknown) =>\n  typeof value === 'string' && value.length <= 2048 && SAFE_LINK_PATTERN.test(value.trim());\n\nconst CELL_ATTRS: Readonly<Record<string, AttrRule>> = {\n  colspan: { check: isIntegerIn(1, 1000), default: 1 },\n  rowspan: { check: isIntegerIn(1, 1000), default: 1 },\n  colwidth: {\n    check: (value) =>\n      value === null || (Array.isArray(value) && value.every((width) => isIntegerIn(0, 100_000)(width))),\n    default: null,\n  },\n};\n\nexport const NODE_RULES: Readonly<Record<string, NodeRule>> = {\n  doc: { group: 'doc', content: { allow: ['block'], min: 0 } },\n  paragraph: { group: 'block', content: { allow: ['inline'], min: 0 }, marks: true },\n  heading: {\n    group: 'block',\n    content: { allow: ['inline'], min: 0 },\n    marks: true,\n    attrs: { level: { check: isIntegerIn(1, 6), default: 1 } },\n  },\n  blockquote: { group: 'block', content: { allow: ['block'], min: 1 } },\n  bulletList: { group: 'block', content: { allow: ['listItem'], min: 1 } },\n  orderedList: {\n    group: 'block',\n    content: { allow: ['listItem'], min: 1 },\n    attrs: {\n      start: { check: isIntegerIn(0, 1_000_000), default: 1 },\n      type: {\n        check: (value) => value === null || ['1', 'a', 'A', 'i', 'I'].includes(value as string),\n        default: null,\n      },\n    },\n  },\n  listItem: { group: 'listItem', content: { allow: ['block'], min: 1 } },\n  codeBlock: {\n    group: 'block',\n    content: { allow: ['text'], min: 0 },\n    marks: false,\n    attrs: {\n      language: {\n        check: (value) =>\n          value === null || (typeof value === 'string' && /^[A-Za-z0-9_+#.-]{1,32}$/.test(value)),\n        default: null,\n      },\n    },\n  },\n  horizontalRule: { group: 'block' },\n  image: {\n    group: 'block',\n    attrs: {\n      // A media library reference, never a URL: delivery resolves it so private media stays private.\n      mediaId: { check: isStableId, default: undefined },\n      alt: { check: isNullOrString(1000), default: null },\n      title: { check: isNullOrString(1000), default: null },\n    },\n  },\n  table: { group: 'block', content: { allow: ['tableRow'], min: 1 } },\n  tableRow: { group: 'tableRow', content: { allow: ['tableCell'], min: 1 } },\n  tableHeader: { group: 'tableCell', content: { allow: ['block'], min: 1 }, attrs: CELL_ATTRS },\n  tableCell: { group: 'tableCell', content: { allow: ['block'], min: 1 }, attrs: CELL_ATTRS },\n  text: { group: 'inline' },\n  hardBreak: { group: 'inline' },\n};\n\nexport type MarkRule = { attrs?: Readonly<Record<string, AttrRule>> };\n\nexport const MARK_RULES: Readonly<Record<string, MarkRule>> = {\n  bold: {},\n  italic: {},\n  code: {},\n  link: {\n    attrs: {\n      href: { check: isSafeHref, default: undefined },\n      target: { check: (value) => value === null || value === '_blank', default: null },\n      rel: { check: isNullOrString(200), default: null },\n      class: { check: (value) => value === null, default: null },\n    },\n  },\n};\n\n/** Nesting deeper than this is rejected (keeps validation and rendering bounded). */\nexport const MAX_RICHTEXT_DEPTH = 40;\n","import { RICHTEXT_FORMAT, RICHTEXT_FORMAT_VERSION } from '../types/valueFormats.js';\nimport { MARK_RULES, MAX_RICHTEXT_DEPTH, NODE_RULES, type AttrRule } from './spec.js';\n\n/** A ProseMirror JSON node in Shapio's normalized form (only known keys, attributes defaulted). */\nexport type RichTextNode = {\n  type: string;\n  attrs?: Record<string, unknown>;\n  content?: RichTextNode[];\n  text?: string;\n  marks?: Array<{ type: string; attrs?: Record<string, unknown> }>;\n};\n\nexport type RichTextDocument = { format: string; version: number; doc: RichTextNode };\n\nexport type RichTextProblem = { path: string; message: string };\n\nexport type RichTextResult =\n  { ok: true; document: RichTextDocument; textLength: number } | { ok: false; problems: RichTextProblem[] };\n\nconst NODE_KEYS = new Set(['type', 'attrs', 'content', 'text', 'marks']);\nconst MAX_PROBLEMS = 20;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\ntype Walk = { problems: RichTextProblem[]; textLength: number };\n\nconst fail = (walk: Walk, path: string, message: string): undefined => {\n  if (walk.problems.length < MAX_PROBLEMS) {\n    walk.problems.push({ path, message });\n  }\n  return undefined;\n};\n\nconst checkAttrs = (\n  walk: Walk,\n  path: string,\n  rules: Readonly<Record<string, AttrRule>> | undefined,\n  raw: unknown,\n): Record<string, unknown> | undefined => {\n  if (raw !== undefined && !isRecord(raw)) {\n    return fail(walk, `${path}/attrs`, 'must be an object');\n  }\n  const given = raw ?? {};\n  const attrs: Record<string, unknown> = {};\n  for (const key of Object.keys(given)) {\n    if (!rules || !Object.hasOwn(rules, key)) {\n      fail(walk, `${path}/attrs/${key}`, 'is not an allowed attribute');\n    }\n  }\n  for (const [key, rule] of Object.entries(rules ?? {})) {\n    const value = Object.hasOwn(given, key) ? given[key] : rule.default;\n    if (value === undefined || !rule.check(value)) {\n      fail(walk, `${path}/attrs/${key}`, value === undefined ? 'is required' : 'has an invalid value');\n      continue;\n    }\n    attrs[key] = value;\n  }\n  return Object.keys(attrs).length > 0 ? attrs : undefined;\n};\n\nconst checkMarks = (walk: Walk, path: string, raw: unknown, allowed: boolean) => {\n  if (raw === undefined) {\n    return undefined;\n  }\n  if (!Array.isArray(raw)) {\n    return fail(walk, `${path}/marks`, 'must be a list');\n  }\n  if (!allowed && raw.length > 0) {\n    return fail(walk, `${path}/marks`, 'marks are not allowed here');\n  }\n  const seen = new Set<string>();\n  const marks: NonNullable<RichTextNode['marks']> = [];\n  raw.forEach((mark: unknown, index) => {\n    const at = `${path}/marks/${index}`;\n    if (!isRecord(mark) || typeof mark.type !== 'string' || !Object.hasOwn(MARK_RULES, mark.type)) {\n      fail(walk, at, 'is not an allowed mark');\n      return;\n    }\n    if (Object.keys(mark).some((key) => key !== 'type' && key !== 'attrs')) {\n      fail(walk, at, 'has unknown properties');\n    }\n    if (seen.has(mark.type)) {\n      fail(walk, at, 'is repeated');\n    }\n    seen.add(mark.type);\n    const attrs = checkAttrs(walk, at, MARK_RULES[mark.type]?.attrs, mark.attrs);\n    marks.push(attrs ? { type: mark.type, attrs } : { type: mark.type });\n  });\n  return marks.length > 0 ? marks : undefined;\n};\n\nconst matchesAllow = (allow: readonly string[], type: string): boolean => {\n  const rule = NODE_RULES[type];\n  return allow.includes(type) || (rule !== undefined && allow.includes(rule.group));\n};\n\nconst checkNode = (\n  walk: Walk,\n  raw: unknown,\n  path: string,\n  depth: number,\n  context: { allow: readonly string[]; marks: boolean },\n): RichTextNode | undefined => {\n  if (depth > MAX_RICHTEXT_DEPTH) {\n    return fail(walk, path, 'is nested too deeply');\n  }\n  if (!isRecord(raw) || typeof raw.type !== 'string') {\n    return fail(walk, path, 'must be a node with a type');\n  }\n  const { type } = raw;\n  const rule = Object.hasOwn(NODE_RULES, type) ? NODE_RULES[type] : undefined;\n  if (!rule) {\n    return fail(walk, path, `\"${type}\" is not an allowed node`);\n  }\n  if (!matchesAllow(context.allow, type)) {\n    return fail(walk, path, `\"${type}\" is not allowed here`);\n  }\n  for (const key of Object.keys(raw)) {\n    if (!NODE_KEYS.has(key)) {\n      fail(walk, `${path}/${key}`, 'is not an allowed property');\n    }\n  }\n  if (type === 'text') {\n    if (typeof raw.text !== 'string' || raw.text.length === 0) {\n      return fail(walk, `${path}/text`, 'must be a non-empty string');\n    }\n    walk.textLength += raw.text.length;\n    const marks = checkMarks(walk, path, raw.marks, context.marks);\n    return marks ? { type, text: raw.text, marks } : { type, text: raw.text };\n  }\n  if (raw.text !== undefined) {\n    fail(walk, `${path}/text`, 'only text nodes carry text');\n  }\n  const node: RichTextNode = { type };\n  const attrs = checkAttrs(walk, path, rule.attrs, raw.attrs);\n  if (attrs) {\n    node.attrs = attrs;\n  }\n  const marks = checkMarks(walk, path, raw.marks, context.marks && rule.group === 'inline');\n  if (marks) {\n    node.marks = marks;\n  }\n  if (!rule.content) {\n    if (raw.content !== undefined && !(Array.isArray(raw.content) && raw.content.length === 0)) {\n      fail(walk, `${path}/content`, `\"${type}\" has no content`);\n    }\n    return node;\n  }\n  if (raw.content !== undefined && !Array.isArray(raw.content)) {\n    return fail(walk, `${path}/content`, 'must be a list');\n  }\n  const children = (raw.content ?? []) as unknown[];\n  if (children.length < rule.content.min) {\n    fail(walk, `${path}/content`, `\"${type}\" needs at least ${rule.content.min} child node(s)`);\n  }\n  const childContext = { allow: rule.content.allow, marks: rule.marks ?? true };\n  const content = children.flatMap((child, index) => {\n    const checked = checkNode(walk, child, `${path}/content/${index}`, depth + 1, childContext);\n    return checked ? [checked] : [];\n  });\n  if (content.length > 0) {\n    node.content = content;\n  }\n  if (type === 'codeBlock' || type === 'paragraph' || type === 'heading') {\n    walk.textLength += 1;\n  }\n  return node;\n};\n\n/**\n * Validates a stored rich-text value: the versioned envelope `{ format, version, doc }` and the document\n * against the baseline schema. Returns a normalized copy (known keys only, attribute defaults filled).\n */\nexport const validateRichText = (value: unknown): RichTextResult => {\n  const walk: Walk = { problems: [], textLength: 0 };\n  if (!isRecord(value)) {\n    return { ok: false, problems: [{ path: '', message: 'must be a rich-text document object' }] };\n  }\n  if (value.format !== RICHTEXT_FORMAT) {\n    fail(walk, '/format', `must be \"${RICHTEXT_FORMAT}\"`);\n  }\n  if (value.version !== RICHTEXT_FORMAT_VERSION) {\n    fail(walk, '/version', `must be ${RICHTEXT_FORMAT_VERSION}`);\n  }\n  for (const key of Object.keys(value)) {\n    if (!['format', 'version', 'doc'].includes(key)) {\n      fail(walk, `/${key}`, 'is not an allowed property');\n    }\n  }\n  const doc = checkNode(walk, value.doc, '/doc', 0, { allow: ['doc'], marks: false });\n  if (walk.problems.length > 0 || !doc) {\n    return {\n      ok: false,\n      problems: walk.problems.length > 0 ? walk.problems : [{ path: '/doc', message: 'is invalid' }],\n    };\n  }\n  return {\n    ok: true,\n    document: { format: RICHTEXT_FORMAT, version: RICHTEXT_FORMAT_VERSION, doc },\n    textLength: walk.textLength,\n  };\n};\n\n/** True when a document holds no text and no media (an empty editor). */\nexport const isEmptyRichText = (document: RichTextDocument): boolean => {\n  const hasSubstance = (node: RichTextNode): boolean =>\n    node.type === 'text' ||\n    node.type === 'image' ||\n    node.type === 'horizontalRule' ||\n    (node.content ?? []).some(hasSubstance);\n  return !hasSubstance(document.doc);\n};\n\n/** Media assets a document's images reference, in document order, without repeats. */\nexport const richTextMediaIds = (document: RichTextDocument): string[] => {\n  const ids = new Set<string>();\n  const walk = (node: RichTextNode) => {\n    if (node.type === 'image' && typeof node.attrs?.mediaId === 'string') {\n      ids.add(node.attrs.mediaId);\n    }\n    (node.content ?? []).forEach(walk);\n  };\n  walk(document.doc);\n  return [...ids];\n};\n"],"mappings":"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"}

package/dist/validate-Oyo0GJ9j.d.ts

@@ -0,0 +1,41 @@
+//#region src/richtext/validate.d.ts
+/** A ProseMirror JSON node in Shapio's normalized form (only known keys, attributes defaulted). */
+type RichTextNode = {
+  type: string;
+  attrs?: Record<string, unknown>;
+  content?: RichTextNode[];
+  text?: string;
+  marks?: Array<{
+    type: string;
+    attrs?: Record<string, unknown>;
+  }>;
+};
+type RichTextDocument = {
+  format: string;
+  version: number;
+  doc: RichTextNode;
+};
+type RichTextProblem = {
+  path: string;
+  message: string;
+};
+type RichTextResult = {
+  ok: true;
+  document: RichTextDocument;
+  textLength: number;
+} | {
+  ok: false;
+  problems: RichTextProblem[];
+};
+/**
+ * Validates a stored rich-text value: the versioned envelope `{ format, version, doc }` and the document
+ * against the baseline schema. Returns a normalized copy (known keys only, attribute defaults filled).
+ */
+declare const validateRichText: (value: unknown) => RichTextResult;
+/** True when a document holds no text and no media (an empty editor). */
+declare const isEmptyRichText: (document: RichTextDocument) => boolean;
+/** Media assets a document's images reference, in document order, without repeats. */
+declare const richTextMediaIds: (document: RichTextDocument) => string[];
+//#endregion
+export { isEmptyRichText as a, RichTextResult as i, RichTextNode as n, richTextMediaIds as o, RichTextProblem as r, validateRichText as s, RichTextDocument as t };
+//# sourceMappingURL=validate-Oyo0GJ9j.d.ts.map

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@shapio/schema",
+  "version": "0.2.0",
+  "description": "Shapio model definition types, validators, diff and schema file format.",
+  "license": "Apache-2.0",
+  "homepage": "https://shapio.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mybrokengnome/shapio.git",
+    "directory": "packages/schema"
+  },
+  "bugs": {
+    "url": "https://github.com/mybrokengnome/shapio/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": {
+      "@shapio/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./html": {
+      "@shapio/source": "./src/html.ts",
+      "types": "./dist/html.d.ts",
+      "default": "./dist/html.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "parse5": "8.0.1",
+    "pluralize": "8.0.0",
+    "typebox": "1.3.34"
+  },
+  "devDependencies": {
+    "@types/pluralize": "0.0.33",
+    "tsdown": "0.23.0",
+    "typescript": "6.0.3",
+    "vitest": "5.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json"
+  }
+}