@peripheries/renderer 0.2.0 → 0.4.0

package/dist/chunks/structure-OUTX0zxG.js

@@ -0,0 +1,213 @@
+import { SECTION_KINDS as SECTION_KINDS$1 } from "@peripheries/runtime";
+//#region packages/renderer/src/core/structure.ts
+var PAGE_DOCUMENT = "__page__";
+function normalizeStructure(nodes) {
+	if (!Array.isArray(nodes)) return [];
+	return nodes.map((n) => typeof n === "string" ? { cellId: n } : {
+		...n,
+		children: n.children ? normalizeStructure(n.children) : void 0
+	});
+}
+var sortByOrder = (nodes) => [...nodes].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+var isSectionNode = (n) => typeof n.sectionId === "string" && n.sectionId.length > 0;
+var isSectionKind = (v) => typeof v === "string" && SECTION_KINDS$1.includes(v);
+var sectionAnchor = (n) => n.cellId ?? n.sectionId;
+function usesStructureLayout(layout) {
+	const structure = layout?.structure;
+	if (!Array.isArray(structure)) return false;
+	if (layout?.type === "document") return true;
+	return normalizeStructure(structure).some((n) => isSectionNode(n) || (n.children?.length ?? 0) > 0);
+}
+var EMPTY = Object.freeze({
+	numbers: {},
+	levels: {},
+	authoredLevels: {},
+	titles: {},
+	anchors: {}
+});
+var numberingFor = (numbering, documentId) => numbering?.byDocument[documentId ?? "__page__"] ?? EMPTY;
+function deriveSectionNumbering(structure) {
+	const byDocument = {};
+	const unknownKinds = [];
+	const mapsFor = (d) => byDocument[d] ??= {
+		numbers: {},
+		levels: {},
+		authoredLevels: {},
+		titles: {},
+		anchors: {}
+	};
+	const nodes = normalizeStructure(structure);
+	const scan = (list, depth, path, inherited) => sortByOrder(list).forEach((node, i) => {
+		const here = `${path}[${i}]`;
+		const documentId = node.documentId ?? inherited;
+		if (node.kind !== void 0 && !isSectionKind(node.kind)) unknownKinds.push({
+			path: here,
+			...node.sectionId ? { sectionId: node.sectionId } : {},
+			kind: typeof node.kind === "string" ? node.kind : JSON.stringify(node.kind)
+		});
+		const section = isSectionNode(node);
+		if (section) {
+			const maps = mapsFor(documentId);
+			maps.levels[node.sectionId] = depth + 1;
+			if (node.level !== void 0) maps.authoredLevels[node.sectionId] = node.level;
+			if (typeof node.title === "string" && node.title !== "") maps.titles[node.sectionId] = node.title;
+			maps.anchors[node.sectionId] = sectionAnchor(node);
+		}
+		scan(node.children ?? [], section ? depth + 1 : depth, `${here}.children`, documentId);
+	});
+	const articles = (list, inherited) => sortByOrder(list).flatMap((node) => {
+		const documentId = node.documentId ?? inherited;
+		return node.kind === "article" && isSectionNode(node) ? [{
+			node,
+			documentId
+		}] : articles(node.children ?? [], documentId);
+	});
+	const number = (list, prefix, inherited) => {
+		const counters = new Map();
+		for (const { node, documentId } of articles(list, inherited)) {
+			const next = (counters.get(documentId) ?? 0) + 1;
+			counters.set(documentId, next);
+			const trail = [...prefix, next];
+			mapsFor(documentId).numbers[node.sectionId] = trail;
+			number(node.children ?? [], trail, documentId);
+		}
+	};
+	scan(nodes, 0, "structure", PAGE_DOCUMENT);
+	number(nodes, [], PAGE_DOCUMENT);
+	return {
+		byDocument,
+		unknownKinds
+	};
+}
+function uniqueDocumentLabels(documentIds, documents) {
+	const owners = new Map();
+	for (const id of documentIds) {
+		const label = documents?.[id]?.label;
+		if (typeof label === "string" && label !== "") owners.set(label, [...owners.get(label) ?? [], id]);
+	}
+	const out = new Map();
+	for (const [label, ids] of owners) if (ids.length === 1) out.set(label, ids[0]);
+	else console.warn(`[structure] label "${label}" is shared by ${ids.join(", ")}; references to "${label}:…" resolve to nothing.`);
+	return out;
+}
+function deriveSectionReferences(numbering, documents) {
+	const recordFor = (maps, role) => {
+		const anchor = maps.anchors[role];
+		return {
+			...maps.numbers[role] ? { number: maps.numbers[role] } : {},
+			...maps.titles[role] ? { title: maps.titles[role] } : {},
+			anchor,
+			href: `#${anchor}`,
+			openable: true
+		};
+	};
+	const cross = {};
+	for (const [label, id] of uniqueDocumentLabels(Object.keys(numbering.byDocument), documents)) {
+		const maps = numbering.byDocument[id];
+		for (const role of Object.keys(maps.anchors)) cross[`${label}:${role}`] = recordFor(maps, role);
+	}
+	const out = {};
+	for (const [id, maps] of Object.entries(numbering.byDocument)) {
+		const own = {};
+		for (const role of Object.keys(maps.anchors)) own[role] = recordFor(maps, role);
+		out[id] = {
+			...cross,
+			...own
+		};
+	}
+	return out;
+}
+function clauseItemsOf(blocks) {
+	if (!Array.isArray(blocks)) return [];
+	return blocks.flatMap((b) => b && typeof b === "object" && b.kind === "clause" && Array.isArray(b.items) ? b.items.filter((i) => i && typeof i === "object") : []);
+}
+function deriveElementReferences(structure, blocksByCellId, documents) {
+	const numbering = deriveSectionNumbering(structure);
+	const sections = [];
+	const walk = (nodes, inherited) => {
+		for (const node of sortByOrder(nodes)) {
+			const documentId = node.documentId ?? inherited;
+			if (isSectionNode(node)) {
+				const body = (node.children ?? []).filter((c) => c.cellId && !c.sectionId).map((c) => c.cellId);
+				sections.push({
+					documentId,
+					role: node.sectionId,
+					cellIds: [...node.cellId ? [node.cellId] : [], ...body]
+				});
+			}
+			walk(node.children ?? [], documentId);
+		}
+	};
+	walk(normalizeStructure(structure), PAGE_DOCUMENT);
+	const perDocument = {};
+	for (const { documentId, role, cellIds } of sections) {
+		const items = cellIds.flatMap((id) => clauseItemsOf(blocksByCellId[id]));
+		if (!items.some((i) => typeof i.id === "string" && i.id !== "")) continue;
+		const shape = items.map((i) => ({
+			...typeof i.level === "number" ? { level: i.level } : {},
+			...typeof i.marker === "string" ? { marker: i.marker } : {}
+		}));
+		const maps = numberingFor(numbering, documentId);
+		const anchor = maps.anchors[role] ?? role;
+		items.forEach((item, index) => {
+			if (typeof item.id !== "string" || item.id === "") return;
+			(perDocument[documentId] ??= {})[`${role}#${item.id}`] = {
+				...maps.numbers[role] ? { number: maps.numbers[role] } : {},
+				...maps.titles[role] ? { title: maps.titles[role] } : {},
+				anchor,
+				href: `#${anchor}`,
+				openable: true,
+				element: {
+					index,
+					shape
+				}
+			};
+		});
+	}
+	const cross = {};
+	for (const [label, id] of uniqueDocumentLabels(Object.keys(numbering.byDocument), documents)) for (const [key, record] of Object.entries(perDocument[id] ?? {})) cross[`${label}:${key}`] = record;
+	const out = {};
+	for (const id of Object.keys(numbering.byDocument)) {
+		const own = perDocument[id] ?? {};
+		if (Object.keys(own).length || Object.keys(cross).length) out[id] = {
+			...cross,
+			...own
+		};
+	}
+	return out;
+}
+function mergeSectionReferences(samePage, other) {
+	if (!other || Object.keys(other).length === 0) return samePage;
+	const out = {};
+	for (const id of new Set([...Object.keys(samePage), ...Object.keys(other)])) out[id] = {
+		...other[id],
+		...samePage[id]
+	};
+	return out;
+}
+var referencesFor = (refs, documentId) => refs?.[documentId ?? "__page__"] ?? {};
+function structureIssues(structure, cells) {
+	const ids = new Set(cells.map((c) => c.id));
+	const issues = [];
+	const visit = (nodes, path) => nodes.forEach((n, i) => {
+		if (n.cellId && !ids.has(n.cellId)) issues.push(`${path}[${i}]: cell '${n.cellId}' is not on the page`);
+		visit(n.children ?? [], `${path}[${i}].children`);
+	});
+	visit(normalizeStructure(structure), "structure");
+	for (const u of deriveSectionNumbering(structure).unknownKinds) issues.push(`${u.path}: unknown section kind '${u.kind}'${u.sectionId ? ` on '${u.sectionId}'` : ""}; expected ${SECTION_KINDS$1.join(", ")}`);
+	return issues;
+}
+function nodePrintStyle(node) {
+	const p = node.print;
+	if (!p) return void 0;
+	const breakBefore = p.breakBefore ? "page" : p.keepWithPrevious ? "avoid" : void 0;
+	const breakInside = p.breakInside === "avoid" ? "avoid" : void 0;
+	return breakBefore || breakInside ? {
+		...breakBefore ? { breakBefore } : {},
+		...breakInside ? { breakInside } : {}
+	} : void 0;
+}
+//#endregion
+export { deriveSectionReferences as a, nodePrintStyle as c, referencesFor as d, sectionAnchor as f, usesStructureLayout as h, deriveSectionNumbering as i, normalizeStructure as l, structureIssues as m, SECTION_KINDS$1 as n, isSectionNode as o, sortByOrder as p, deriveElementReferences as r, mergeSectionReferences as s, PAGE_DOCUMENT as t, numberingFor as u };
+
+//# sourceMappingURL=structure-OUTX0zxG.js.map

package/dist/chunks/structure-OUTX0zxG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-OUTX0zxG.js","names":["SECTION_KINDS"],"sources":["../../src/core/structure.ts"],"mappings":"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"}

package/dist/chunks/validate--WdSPgWe.js

@@ -0,0 +1,275 @@
+import { h as usesStructureLayout, m as structureIssues } from "./structure-OUTX0zxG.js";
+import { STATE_NAMES, isStateName } from "@peripheries/runtime";
+//#region packages/renderer/src/core/validate.ts
+var RESPONSIVE_BUCKETS = [
+	"narrow",
+	"compact",
+	"wide"
+];
+var STORE_SCOPES = ["page", "project"];
+var WALK_DIRECTIONS = [
+	"incoming",
+	"outgoing",
+	"both"
+];
+var BUCKETS = RESPONSIVE_BUCKETS;
+var SCOPES = STORE_SCOPES;
+var DIRECTIONS = WALK_DIRECTIONS;
+function checkBindings(queries, path, push, cellId, template = false) {
+	if (queries === void 0) return;
+	if (!queries || typeof queries !== "object" || Array.isArray(queries)) {
+		push({
+			severity: "error",
+			code: "BINDING_INVALID",
+			cellId,
+			path,
+			message: "data.queries must be an object of label → binding"
+		});
+		return;
+	}
+	for (const [label, raw] of Object.entries(queries)) {
+		const at = `${path}.${label}`;
+		const b = raw;
+		if (!b || typeof b !== "object") {
+			push({
+				severity: "error",
+				code: "BINDING_INVALID",
+				cellId,
+				label,
+				path: at,
+				message: `"${label}" isn't a binding`
+			});
+			continue;
+		}
+		if (typeof b.registry === "string") {
+			push({
+				severity: "warning",
+				code: "UNSUPPORTED_REGISTRY_BINDING",
+				cellId,
+				label,
+				path: at,
+				message: `"${label}" names the registry query ${b.registry}, which the host no longer runs (R2 maps or retires it)`
+			});
+			continue;
+		}
+		if (typeof b.graph_node_id !== "string" || !b.graph_node_id) {
+			if (!template) push({
+				severity: "error",
+				code: "BINDING_INVALID",
+				cellId,
+				label,
+				path: at,
+				message: `"${label}" names no graph_node_id`
+			});
+			continue;
+		}
+		if (b.as !== void 0 && b.as !== "value" && b.as !== "record") push({
+			severity: "error",
+			code: "BINDING_INVALID",
+			cellId,
+			label,
+			path: `${at}.as`,
+			message: `"${label}".as is "${String(b.as)}"; expected value or record`
+		});
+		for (const s of b.state === void 0 ? [] : Array.isArray(b.state) ? b.state : [b.state]) if (!isStateName(s)) push({
+			severity: "error",
+			code: "STATE_UNKNOWN_NAME",
+			cellId,
+			label,
+			path: `${at}.state`,
+			message: `"${label}" names state "${String(s)}"; expected one of ${STATE_NAMES.join(", ")}`
+		});
+	}
+}
+function checkTraversal(t, path, push, cellId) {
+	if (t === void 0) return;
+	const w = t;
+	if (!Array.isArray(w.edgeTypes) || w.edgeTypes.length === 0) push({
+		severity: "error",
+		code: "WALK_EDGE_TYPES_REQUIRED",
+		cellId,
+		path: `${path}.edgeTypes`,
+		message: "traversal.edgeTypes is required: without it a walk follows every edge type"
+	});
+	if (w.direction !== void 0 && !DIRECTIONS.includes(String(w.direction))) push({
+		severity: "error",
+		code: "WALK_BAD_DIRECTION",
+		cellId,
+		path: `${path}.direction`,
+		message: `traversal.direction "${String(w.direction)}" isn't incoming, outgoing or both`
+	});
+	if (Array.isArray(w.nodeTypes) && w.nodeTypes.length === 0) push({
+		severity: "warning",
+		code: "WALK_NODE_TYPES_EMPTY",
+		cellId,
+		path: `${path}.nodeTypes`,
+		message: "traversal.nodeTypes is empty, which filters nothing: leave it out, or name the types the walk may enter"
+	});
+	if (typeof w.maxNodes === "number" && w.maxNodes > 500) push({
+		severity: "warning",
+		code: "WALK_MAX_NODES_CLAMPED",
+		cellId,
+		path: `${path}.maxNodes`,
+		message: `traversal.maxNodes ${w.maxNodes} is above 500; clamped`
+	});
+	for (const s of Array.isArray(w.include_state) ? w.include_state : []) if (!isStateName(s)) push({
+		severity: "error",
+		code: "STATE_UNKNOWN_NAME",
+		cellId,
+		path: `${path}.include_state`,
+		message: `include_state "${String(s)}" isn't a system name`
+	});
+}
+function checkStore(cell, path, push) {
+	for (const [kind, key] of [
+		["selections", "channel"],
+		["viewState", "key"],
+		["live", "channel"]
+	]) for (const [name, decl] of Object.entries(cell[kind] ?? {})) {
+		const at = `${path}.${kind}.${name}`;
+		if (typeof decl?.[key] !== "string" || !decl[key]) push({
+			severity: "error",
+			code: "STORE_INVALID",
+			cellId: cell.id,
+			path: at,
+			message: `${kind}.${name} names no ${key}`
+		});
+		if (kind !== "live" && !SCOPES.includes(String(decl?.scope))) push({
+			severity: "error",
+			code: "STORE_INVALID",
+			cellId: cell.id,
+			path: `${at}.scope`,
+			message: `${kind}.${name}.scope must be page or project`
+		});
+	}
+}
+function validateCell(cell, catalog, path = "cell", ids, options = {}) {
+	const out = [];
+	const push = (d) => out.push(d);
+	if (typeof cell?.id !== "string" || !cell.id) {
+		push({
+			severity: "error",
+			code: "CELL_NO_ID",
+			path,
+			message: "a cell needs an id"
+		});
+		return out;
+	}
+	const cellId = cell.id;
+	const ref = cell.ref;
+	if (ref !== void 0 && (typeof ref?.graph_node_id !== "string" || !ref.graph_node_id)) push({
+		severity: "error",
+		code: "REF_INVALID",
+		cellId,
+		path: `${path}.ref`,
+		message: "ref names no graph_node_id"
+	});
+	const nodeManaged = Boolean(ref?.graph_node_id) || Boolean(cell.graph_node_id) && !cell.component;
+	if (!ref && cell.graph_node_id && !cell.component) push({
+		severity: "legacy",
+		code: "LEGACY_THIN_REF",
+		cellId,
+		path,
+		message: "a thin ref `{ id, graph_node_id }`: publish it as `{ id, ref: { graph_node_id } }`"
+	});
+	else if (!ref && cell.graph_node_id) push({
+		severity: "legacy",
+		code: "LEGACY_INLINE_NODE",
+		cellId,
+		path,
+		message: "an inline cell with a graph_node_id: its node only starts its walk. Give it a `ref` if the node should manage the cell"
+	});
+	if (!nodeManaged && !cell.component) push({
+		severity: "error",
+		code: "CELL_NO_COMPONENT",
+		cellId,
+		path,
+		message: "an inline cell needs a component"
+	});
+	if (cell.component && catalog && !cell.component.startsWith("@core/")) {
+		const entry = catalog.components[cell.component];
+		if (!entry) push({
+			severity: nodeManaged ? "warning" : "error",
+			code: "CELL_UNKNOWN_COMPONENT",
+			cellId,
+			path: `${path}.component`,
+			message: `no bundle in scope exports ${cell.component}`
+		});
+		else for (const prop of entry.props_schema?.required ?? []) if ((prop === "children" ? cell.props?.children ?? (cell.children?.length ? cell.children : void 0) : cell.props?.[prop]) === void 0) push({
+			severity: nodeManaged ? "warning" : "error",
+			code: "PROP_REQUIRED",
+			cellId,
+			path: `${path}.props.${prop}`,
+			message: `${cell.component} requires ${prop}`
+		});
+	}
+	for (const child of cell.children ?? []) if (child === cellId) push({
+		severity: "error",
+		code: "CELL_CHILD_CYCLE",
+		cellId,
+		path: `${path}.children`,
+		message: "a cell lists itself as a child"
+	});
+	else if (ids && !ids.has(child)) push({
+		severity: "error",
+		code: "CELL_UNKNOWN_CHILD",
+		cellId,
+		path: `${path}.children`,
+		message: `child cell "${child}" is not on the page`
+	});
+	checkBindings(cell.data?.queries, `${path}.data.queries`, push, cellId, options.template);
+	checkTraversal(cell.traversal, `${path}.traversal`, push, cellId);
+	checkStore(cell, path, push);
+	for (const key of [
+		"hideWhen",
+		"showWhen",
+		"stackWhen",
+		"truncateWhen"
+	]) {
+		const v = cell.layout?.[key];
+		if (v !== void 0 && !BUCKETS.includes(v)) push({
+			severity: "warning",
+			code: "LAYOUT_INVALID",
+			cellId,
+			path: `${path}.layout.${key}`,
+			message: `layout.${key} "${v}" isn't narrow, compact or wide`
+		});
+	}
+	return out;
+}
+function validatePage(page, catalog) {
+	const options = { template: Boolean(page.is_template) };
+	const out = [];
+	const cells = page.content?.cells;
+	if (cells !== void 0 && !Array.isArray(cells)) return [{
+		severity: "error",
+		code: "PAGE_INVALID",
+		path: "content.cells",
+		message: "content.cells must be a list"
+	}];
+	const list = cells ?? [];
+	const ids = new Set();
+	list.forEach((cell, i) => {
+		if (typeof cell?.id === "string" && ids.has(cell.id)) out.push({
+			severity: "error",
+			code: "CELL_DUPLICATE_ID",
+			cellId: cell.id,
+			path: `content.cells[${i}].id`,
+			message: `two cells share the id "${cell.id}"`
+		});
+		if (typeof cell?.id === "string") ids.add(cell.id);
+	});
+	list.forEach((cell, i) => out.push(...validateCell(cell, catalog, `content.cells[${i}]`, ids, options)));
+	checkBindings(page.content?.data?.queries, "content.data.queries", (d) => out.push(d), void 0, options.template);
+	if (usesStructureLayout(page.layout)) for (const issue of structureIssues(page.layout?.structure, list)) out.push({
+		severity: "error",
+		code: "STRUCTURE_INVALID",
+		path: "layout.structure",
+		message: issue
+	});
+	return out;
+}
+//#endregion
+export { validatePage as a, validateCell as i, STORE_SCOPES as n, WALK_DIRECTIONS as r, RESPONSIVE_BUCKETS as t };
+
+//# sourceMappingURL=validate--WdSPgWe.js.map

package/dist/chunks/validate--WdSPgWe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate--WdSPgWe.js","names":[],"sources":["../../src/core/validate.ts"],"mappings":"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"}