@segnavia/format 0.26.0 → 0.28.0

package/dist/printed-pages.js

@@ -0,0 +1,196 @@
+import { BOOK_FURNITURE } from "./motif.js";
+import { NumberSystem } from "./numbering.js";
+import { z } from "zod";
+//#region src/printed-pages.ts
+const PRINTED_PAGE_LIMIT = 500;
+const PRINTED_PAGE_ROLES = [
+	"every",
+	"first",
+	"recto",
+	"verso",
+	"last"
+];
+const ParentPageMargin = z.object({
+	top: z.number().nonnegative(),
+	bottom: z.number().nonnegative(),
+	inner: z.number().nonnegative(),
+	outer: z.number().nonnegative()
+});
+const ParentPage = z.object({
+	name: z.string().min(1),
+	basedOn: z.string().min(1).optional(),
+	margin: ParentPageMargin.optional(),
+	head: z.string().optional(),
+	foot: z.string().optional()
+});
+const ParentName = z.string().min(1);
+const PrintedPageRules = z.object({
+	every: z.string({ error: "every is required; name the default parent page to clear this refusal" }).min(1),
+	first: ParentName.optional(),
+	recto: ParentName.optional(),
+	verso: ParentName.optional(),
+	last: ParentName.optional()
+}).passthrough().superRefine((rules, ctx) => {
+	const unknown = Object.keys(rules).filter((key) => !PRINTED_PAGE_ROLES.includes(key));
+	if (unknown.length) ctx.addIssue({
+		code: "custom",
+		message: `unknown printed-page role ${unknown.map((key) => JSON.stringify(key)).join(", ")}; use only every, first, recto, verso or last to clear this refusal`
+	});
+}).transform(({ every, first, recto, verso, last }) => ({
+	every,
+	...first === void 0 ? {} : { first },
+	...recto === void 0 ? {} : { recto },
+	...verso === void 0 ? {} : { verso },
+	...last === void 0 ? {} : { last }
+}));
+const PrintedPages = z.object({
+	parents: z.array(ParentPage).min(1),
+	rules: PrintedPageRules,
+	numbering: NumberSystem.optional()
+});
+const BOOK_PARENT_NAMES = {
+	recto: "segnavia:recto",
+	verso: "segnavia:verso",
+	opener: "segnavia:opener",
+	blank: "segnavia:blank"
+};
+function furniture(region) {
+	return BOOK_FURNITURE.filter((item) => item.region === region).filter((item) => item.fields.every((field) => !("required" in field) || !field.required)).map((item) => `<div class="${item.className}" data-motif="${item.key}"></div>`).join("");
+}
+function bookParentPages(margin) {
+	const held = () => ({ ...margin });
+	const head = furniture("head");
+	const foot = furniture("foot");
+	return [
+		{
+			name: BOOK_PARENT_NAMES.recto,
+			margin: held(),
+			head,
+			foot
+		},
+		{
+			name: BOOK_PARENT_NAMES.verso,
+			margin: held(),
+			head,
+			foot
+		},
+		{
+			name: BOOK_PARENT_NAMES.opener,
+			margin: held(),
+			foot
+		},
+		{
+			name: BOOK_PARENT_NAMES.blank,
+			margin: held()
+		}
+	];
+}
+const ZERO_PARENT_MARGIN = {
+	top: 0,
+	bottom: 0,
+	inner: 0,
+	outer: 0
+};
+function resolveParentPages(parents) {
+	const source = new Map(parents.map((parent) => [parent.name, parent]));
+	const resolved = /* @__PURE__ */ new Map();
+	const resolve = (parent) => {
+		const held = resolved.get(parent.name);
+		if (held) return held;
+		const baseParent = parent.basedOn ? source.get(parent.basedOn) : void 0;
+		const base = baseParent ? resolve(baseParent) : void 0;
+		const result = {
+			name: parent.name,
+			margin: parent.margin ?? base?.margin ?? ZERO_PARENT_MARGIN,
+			head: parent.head ?? base?.head ?? "",
+			foot: parent.foot ?? base?.foot ?? ""
+		};
+		resolved.set(parent.name, result);
+		return result;
+	};
+	return parents.map(resolve);
+}
+function parentListIssues(parents, options = {}) {
+	const issues = [];
+	const root = options.path ?? ["parents"];
+	const listed = /* @__PURE__ */ new Map();
+	const known = /* @__PURE__ */ new Set([...options.known ?? []]);
+	parents.forEach((parent, index) => {
+		if (listed.has(parent.name)) issues.push({
+			path: [
+				...root,
+				index,
+				"name"
+			],
+			message: `parent page "${parent.name}" is duplicated; give every parent page a unique name to clear this refusal`
+		});
+		listed.set(parent.name, parent);
+		known.add(parent.name);
+	});
+	parents.forEach((parent, index) => {
+		if (parent.basedOn && !known.has(parent.basedOn)) issues.push({
+			path: [
+				...root,
+				index,
+				"basedOn"
+			],
+			message: `parent page "${parent.name}" is based on unknown parent page "${parent.basedOn}"; add that parent page or remove basedOn to clear this refusal`
+		});
+		const chain = [];
+		let cursor = parent;
+		while (cursor) {
+			if (chain.includes(cursor.name)) {
+				issues.push({
+					path: [
+						...root,
+						index,
+						"basedOn"
+					],
+					message: `parent page inheritance has a cycle ${[...chain, cursor.name].join(" -> ")}; remove a basedOn link to clear this refusal`
+				});
+				break;
+			}
+			chain.push(cursor.name);
+			cursor = cursor.basedOn ? listed.get(cursor.basedOn) : void 0;
+		}
+	});
+	return issues;
+}
+function printedPagesIssues(value) {
+	const issues = parentListIssues(value.parents);
+	const names = new Set(value.parents.map((parent) => parent.name));
+	for (const [role, name] of Object.entries(value.rules)) {
+		if (name === void 0) continue;
+		if (!names.has(name)) issues.push({
+			path: ["rules", role],
+			message: `${role} names unknown parent page "${name}"; add that parent page or name an existing one to clear this refusal`
+		});
+	}
+	return issues;
+}
+function pagePrintedPagesIssues(page) {
+	if (!page.printedPages) return [];
+	const issues = printedPagesIssues(page.printedPages).map((issue) => ({
+		...issue,
+		path: ["printedPages", ...issue.path]
+	}));
+	if (!page.print) issues.push({
+		path: ["print"],
+		message: "printedPages could not establish a paper; add print.paper to clear this refusal"
+	});
+	if (page.scripts !== "refuse") issues.push({
+		path: ["scripts"],
+		message: "printedPages could not establish deterministic cloned content; set scripts to \"refuse\" to clear this refusal"
+	});
+	if (page.print?.margin) issues.push({
+		path: ["print", "margin"],
+		message: "printedPages and print.margin both own the margins; remove print.margin to clear this refusal"
+	});
+	if (page.print && (page.print.bleed > 0 || page.print.marks)) issues.push({
+		path: ["print"],
+		message: "printedPages could not establish one composed paper with bleed or marks; remove bleed and marks to clear this refusal"
+	});
+	return issues;
+}
+//#endregion
+export { BOOK_PARENT_NAMES, PRINTED_PAGE_LIMIT, PRINTED_PAGE_ROLES, ParentPage, ParentPageMargin, PrintedPageRules, PrintedPages, bookParentPages, pagePrintedPagesIssues, parentListIssues, printedPagesIssues, resolveParentPages };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segnavia/format",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "type": "module",
   "license": "MIT",
   "repository": {