@segnavia/format 0.37.0 → 0.39.0

package/dist/book.js

@@ -1,10 +1,12 @@
 import { Direction, resolveDirection } from "./direction.js";
+import { Placement } from "./placement.js";
 import { Scripts } from "./scripts.js";
 import { Slots } from "./slots.js";
 import { FontReference } from "./fonts.js";
 import { NoteMarker, NumberSystem, isHebrew } from "./numbering.js";
-import { ParentPage, bookParentPages } from "./printed-pages.js";
-import { BookChapterEntry, BookContents, BookFrontMatterEntry, BookOpens, BookSection, BookSectionParents, BookTemplate, Chapter, DesignedPage, DesignedSection, REGION_NAME, TemplatedPage, TemplatedSection, bookParentIssues, isBookContents, isChapter, isDesignedSection, isTemplatedSection } from "./book-section.js";
+import { ParentPage, bookParentPages, flowingParentNames, resolveParentPages, textArea } from "./printed-pages.js";
+import { BookChapterEntry, BookContents, BookFrontMatterEntry, BookItem, BookOpens, BookSection, BookSectionParents, BookTemplate, Chapter, DesignedPage, DesignedSection, MAX_PART_DEPTH, Part, PlacedSection, REGION_NAME, TemplatedPage, TemplatedSection, bookParentIssues, bookSections, isBookContents, isChapter, isDesignedSection, isPart, isPlacedSection, isTemplatedSection } from "./book-section.js";
+import { NoteSeries, noteSeriesIssues, resolveNoteSeries } from "./note-series.js";
 import { Orientation, Paper, sheetMm } from "./paper.js";
 import { z } from "zod";
 //#region src/book.ts
@@ -20,23 +22,31 @@ const BookPage = z.object({
 	}),
 	columnGap: z.number().nonnegative().default(4)
 });
-const BookRunningHeadSource = z.union([z.literal("title"), z.object({
-	mark: z.string().min(1),
-	which: z.enum(["first", "last"])
-})]);
+const BookRunningHeadSource = z.union([
+	z.literal("title"),
+	z.object({
+		mark: z.string().min(1),
+		which: z.enum(["first", "last"])
+	}),
+	z.object({ part: z.string().regex(REGION_NAME) })
+]);
 const BookRunningHead = z.object({
 	recto: BookRunningHeadSource.default("title"),
 	verso: BookRunningHeadSource.default("title")
 });
 const BookShape = z.object({
 	title: z.string(),
+	authors: z.array(z.string()).optional(),
+	subject: z.string().optional(),
 	mode: BookMode,
 	page: BookPage.optional(),
 	scripts: Scripts.default("refuse"),
 	dir: Direction.optional(),
 	lang: z.string().optional(),
-	frontMatter: z.array(BookFrontMatterEntry).default([]),
-	chapters: z.array(BookChapterEntry).min(1),
+	frontMatter: z.array(BookItem).default([]),
+	body: z.array(BookItem).optional(),
+	endMatter: z.array(BookItem).default([]),
+	chapters: z.array(BookChapterEntry).optional(),
 	parentPages: z.array(ParentPage).default([]),
 	templates: z.array(BookTemplate).default([]),
 	slots: Slots.optional(),
@@ -55,6 +65,7 @@ const BookShape = z.object({
 		placement: z.enum(["book", "chapter"]).default("book"),
 		title: z.string().optional()
 	}).default({ placement: "book" }),
+	notes: z.array(NoteSeries).default([]),
 	rectoOpenings: z.boolean().default(false),
 	orphans: z.number().int().min(1).default(2),
 	widows: z.number().int().min(1).default(2),
@@ -106,31 +117,138 @@ const BookView = BookShape.pick({
 	flow: z.string().optional(),
 	pagination: BookViewPagination.optional()
 });
-const Book = BookShape.transform((book) => {
+const ResolvedBook = BookShape.superRefine((book, ctx) => {
+	for (const { entry, path } of bookSections({
+		...book,
+		body: book.body ?? book.chapters ?? []
+	})) {
+		if (!isPlacedSection(entry)) continue;
+		try {
+			Placement.parse(entry.placement, "book");
+		} catch (error) {
+			ctx.addIssue({
+				code: "custom",
+				path: [...path, "placement"],
+				message: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	const seen = /* @__PURE__ */ new Set();
+	book.notes.forEach(({ name }, index) => {
+		if (seen.has(name)) ctx.addIssue({
+			code: "custom",
+			path: [
+				"notes",
+				index,
+				"name"
+			],
+			message: `note series ${name} is duplicated; give every series a unique name`
+		});
+		seen.add(name);
+		if (name !== "footnote" && name !== "endnote") {
+			if (book.notes[index]?.placement === void 0) ctx.addIssue({
+				code: "custom",
+				path: [
+					"notes",
+					index,
+					"placement"
+				],
+				message: `note series ${name} needs placement`
+			});
+			if (book.notes[index]?.numbering === void 0) ctx.addIssue({
+				code: "custom",
+				path: [
+					"notes",
+					index,
+					"numbering"
+				],
+				message: `note series ${name} needs numbering`
+			});
+		}
+	});
+}).transform((book, ctx) => {
 	const hebrew = isHebrew(book.lang);
+	const { chapters, ...fields } = book;
+	if (book.body !== void 0 && chapters !== void 0) {
+		ctx.addIssue({
+			code: "custom",
+			path: ["body"],
+			message: "body and chapters were both given; keep body and remove chapters"
+		});
+		ctx.addIssue({
+			code: "custom",
+			path: ["chapters"],
+			message: "chapters and body were both given; keep body and remove chapters"
+		});
+	}
+	const notes = resolveNoteSeries({
+		lang: book.lang,
+		footnotes: book.footnotes,
+		endnotes: book.endnotes,
+		notes: book.notes
+	});
+	const footnote = notes[0];
+	const endnote = notes[1];
+	if (!footnote || !endnote) throw new Error("note series resolution did not produce the two default series");
 	return {
-		...book,
+		...fields,
+		body: book.body ?? chapters ?? [],
+		bodyKey: book.body === void 0 && chapters !== void 0 ? "chapters" : "body",
 		numbering: {
 			frontMatter: book.numbering.frontMatter ?? (hebrew ? "arabic" : "roman-lower"),
 			body: book.numbering.body ?? (hebrew ? "hebrew" : "arabic")
 		},
 		footnotes: {
 			...book.footnotes,
-			marker: book.footnotes.marker ?? (hebrew ? "hebrew" : "symbols")
+			marker: footnote.marker
 		},
 		endnotes: {
 			...book.endnotes,
-			marker: book.endnotes.marker ?? "arabic",
-			title: book.endnotes.title ?? (hebrew ? "הערות" : "Notes")
-		}
+			marker: endnote.marker,
+			title: endnote.title
+		},
+		notes
 	};
-}).superRefine((book, ctx) => {
-	const contentsPositions = book.frontMatter.flatMap((entry, index) => isBookContents(entry) ? [index + 1] : []);
-	if (contentsPositions.length > 1) ctx.addIssue({
-		code: "custom",
+});
+function partSectionIssues(items, path) {
+	return items.flatMap((entry, index) => {
+		if (!isPart(entry)) return [];
+		const partPath = [...path, index];
+		return [...!(entry.html !== void 0 || bookSections({
+			frontMatter: [],
+			body: entry.children,
+			endMatter: []
+		}).some(({ entry: child }) => !isPart(child) || child.html !== void 0)) ? [{
+			path: partPath,
+			message: `part ${partPath.join(".")} has no section; add html or a section inside it to clear this refusal`
+		}] : [], ...partSectionIssues(entry.children, [...partPath, "children"])];
+	});
+}
+function structuralBookIssues(book) {
+	const issues = [];
+	if (book.body.length === 0) issues.push({
+		path: ["body"],
+		message: "a book needs at least one body entry; add a chapter or part"
+	});
+	issues.push(...partSectionIssues(book.frontMatter, ["frontMatter"]), ...partSectionIssues(book.body, [book.bodyKey]), ...partSectionIssues(book.endMatter, ["endMatter"]));
+	const sections = bookSections(book);
+	for (const section of sections) if (isBookContents(section.entry) && section.division !== "front") issues.push({
+		path: section.path,
+		message: `contents belongs in frontMatter; move this ${section.division} contents entry there`
+	});
+	const paths = sections.flatMap(({ entry, division, path }) => division === "front" && isBookContents(entry) ? [path.join(".")] : []);
+	if (paths.length > 1) issues.push({
 		path: ["frontMatter"],
-		message: `front-matter entries at positions ${contentsPositions[0]} and ${contentsPositions[1]} are both contents entries; one must go`
+		message: `front-matter entries at ${paths[0]} and ${paths[1]} are both contents entries; one must go`
 	});
+	return issues;
+}
+const RefinedBook = ResolvedBook.superRefine((book, ctx) => {
+	for (const issue of structuralBookIssues(book)) ctx.addIssue({
+		code: "custom",
+		...issue
+	});
+	const sections = bookSections(book);
 	if (book.mode === "paginated" && !book.page) ctx.addIssue({
 		code: "custom",
 		path: ["page"],
@@ -141,10 +259,9 @@ const Book = BookShape.transform((book) => {
 		path: ["numbering"],
 		message: `front-matter and body numbering are both ${book.numbering.body}; the two must differ when front matter is present`
 	});
-	if (book.endnotes.placement === "chapter" && book.mode === "continuous") ctx.addIssue({
+	for (const issue of noteSeriesIssues(book.notes, book.mode)) ctx.addIssue({
 		code: "custom",
-		path: ["endnotes", "placement"],
-		message: "endnotes are placed at the end of each chapter only in paginated mode; use book placement or paginated mode"
+		...issue
 	});
 	for (const issue of bookParentIssues(book)) ctx.addIssue({
 		code: "custom",
@@ -152,19 +269,105 @@ const Book = BookShape.transform((book) => {
 	});
 	if (!book.page) return;
 	const trim = sheetMm(book.page);
-	const vertical = book.page.margin.top + book.page.margin.bottom;
-	const horizontal = book.page.margin.inner + book.page.margin.outer;
-	if (vertical >= trim.height) ctx.addIssue({
-		code: "custom",
-		path: ["page", "margin"],
-		message: `the top and bottom margins total ${vertical}mm and the page is ${trim.height}mm high; reduce the vertical margins to leave a text area`
+	const parents = resolveParentPages([...bookParentPages(book.page.margin), ...book.parentPages]);
+	const defaults = new Set(bookParentPages(book.page.margin).map((parent) => parent.name));
+	for (const parent of parents) {
+		const area = textArea(parent, trim);
+		const path = defaults.has(parent.name) ? ["page", "margin"] : ["parentPages"];
+		if (area.height <= 0) {
+			const total = parent.margin.top + parent.margin.bottom;
+			ctx.addIssue({
+				code: "custom",
+				path,
+				message: `parent page "${parent.name}" has top and bottom margins totaling ${total}mm on paper ${trim.height}mm high; reduce the vertical margins to leave a text area`
+			});
+		}
+		if (area.width <= 0) {
+			const total = parent.margin.inner + parent.margin.outer;
+			ctx.addIssue({
+				code: "custom",
+				path,
+				message: `parent page "${parent.name}" has inner and outer margins totaling ${total}mm on paper ${trim.width}mm wide; reduce the horizontal margins to leave a text area`
+			});
+		}
+	}
+	const byName = new Map(parents.map((parent) => [parent.name, parent]));
+	sections.filter(({ entry }) => !isDesignedSection(entry) && !isTemplatedSection(entry)).forEach(({ entry: flow, path }, index) => {
+		const names = flowingParentNames(flow.parents);
+		const widths = Object.entries(names).flatMap(([role, name]) => {
+			const parent = byName.get(name);
+			return parent ? [{
+				role,
+				name,
+				width: textArea(parent, trim).width
+			}] : [];
+		});
+		const first = widths[0];
+		const different = widths.find((candidate) => candidate.width !== first?.width);
+		if (!first || !different) return;
+		const label = flow.title ?? `flow ${index + 1}`;
+		ctx.addIssue({
+			code: "custom",
+			path,
+			message: `the ${label} flow uses parent pages "${first.name}" (${first.width}mm) and "${different.name}" (${different.width}mm) with different text widths; make the widths equal or split the flow into sections to clear this refusal`
+		});
 	});
-	if (horizontal >= trim.width) ctx.addIssue({
+});
+function partDepthIssues(value) {
+	if (typeof value !== "object" || value === null) return [];
+	const input = value;
+	const roots = [
+		["frontMatter", input.frontMatter],
+		["body", input.body],
+		["chapters", input.chapters],
+		["endMatter", input.endMatter]
+	];
+	const stack = [];
+	for (const [key, entries] of roots) {
+		if (!Array.isArray(entries)) continue;
+		entries.forEach((entry, index) => {
+			stack.push({
+				value: entry,
+				path: [key, index],
+				depth: 0
+			});
+		});
+	}
+	const issues = [];
+	while (stack.length > 0) {
+		const current = stack.pop();
+		if (!current || typeof current.value !== "object" || current.value === null || !("name" in current.value)) continue;
+		const depth = current.depth + 1;
+		if (depth > 6) {
+			issues.push({
+				path: current.path,
+				message: `part ${current.path.join(".")} exceeds the maximum part depth of 6; reduce the nesting to clear this refusal`
+			});
+			continue;
+		}
+		const children = current.value.children;
+		if (!Array.isArray(children)) continue;
+		children.forEach((child, index) => {
+			stack.push({
+				value: child,
+				path: [
+					...current.path,
+					"children",
+					index
+				],
+				depth
+			});
+		});
+	}
+	return issues;
+}
+const Book = z.preprocess((value, ctx) => {
+	for (const issue of partDepthIssues(value)) ctx.addIssue({
 		code: "custom",
-		path: ["page", "margin"],
-		message: `the inner and outer margins total ${horizontal}mm and the page is ${trim.width}mm wide; reduce the horizontal margins to leave a text area`
+		...issue
 	});
-});
+	return value;
+}, RefinedBook).transform(({ bodyKey: _bodyKey, ...book }) => book);
 function resolveBookPagination(book) {
 	if (book.mode !== "paginated" || !book.page) return void 0;
 	return {
@@ -182,9 +385,5 @@ function resolveBookPagination(book) {
 		runningHead: book.runningHead
 	};
 }
-function noteMarkerIssues(book, used) {
-	if (!used.footnotes || !used.endnotes || book.footnotes.marker !== book.endnotes.marker) return [];
-	return [`footnote and endnote markers are both ${book.footnotes.marker}; the two must differ when both kinds are used`];
-}
 //#endregion
-export { Book, BookChapterEntry, BookContents, BookFrontMatterEntry, BookMode, BookOpens, BookPage, BookRunningHead, BookRunningHeadSource, BookSection, BookSectionParents, BookShape, BookTemplate, BookView, BookViewPagination, Chapter, DesignedPage, DesignedSection, REGION_NAME, TemplatedPage, TemplatedSection, isBookContents, isChapter, isDesignedSection, isTemplatedSection, noteMarkerIssues, resolveBookPagination };
+export { Book, BookChapterEntry, BookContents, BookFrontMatterEntry, BookItem, BookMode, BookOpens, BookPage, BookRunningHead, BookRunningHeadSource, BookSection, BookSectionParents, BookShape, BookTemplate, BookView, BookViewPagination, Chapter, DesignedPage, DesignedSection, MAX_PART_DEPTH, Part, PlacedSection, REGION_NAME, TemplatedPage, TemplatedSection, bookSections, isBookContents, isChapter, isDesignedSection, isPart, isPlacedSection, isTemplatedSection, resolveBookPagination };

package/dist/cover.d.ts

@@ -0,0 +1,337 @@
+import { Motif } from "./motif.js";
+import { Page } from "./page.js";
+import { z } from "zod";
+//#region src/cover.d.ts
+export declare const COVER_SHEET: {
+  readonly width: 160;
+  readonly height: 100;
+};
+export declare const COVER_DRAWING_VERSION = 1;
+export declare const Cover: z.ZodPipe<z.ZodObject<{
+  page: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    html: z.ZodString;
+    size: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"fluid">, z.ZodObject<{
+      width: z.ZodNumber;
+      height: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+      width: z.ZodNumber;
+      height: z.ZodLiteral<"auto">;
+    }, z.core.$strip>]>>;
+    scripts: z.ZodDefault<z.ZodEnum<{
+      refuse: "refuse";
+      sandboxed: "sandboxed";
+    }>>;
+    dir: z.ZodOptional<z.ZodEnum<{
+      auto: "auto";
+      ltr: "ltr";
+      rtl: "rtl";
+    }>>;
+    lang: z.ZodOptional<z.ZodString>;
+    print: z.ZodOptional<z.ZodObject<{
+      paper: z.ZodUnion<readonly [z.ZodEnum<{
+        letter: "letter";
+        legal: "legal";
+        tabloid: "tabloid";
+        a3: "a3";
+        a4: "a4";
+        a5: "a5";
+        "business-card-us": "business-card-us";
+        "business-card-eu": "business-card-eu";
+        "business-card-square-us": "business-card-square-us";
+        "business-card-slim-us": "business-card-slim-us";
+        "postcard-4x6": "postcard-4x6";
+        "postcard-5x7": "postcard-5x7";
+        "postcard-6x9": "postcard-6x9";
+        "postcard-6x11": "postcard-6x11";
+        "card-square-4in": "card-square-4in";
+        "half-letter": "half-letter";
+        a6: "a6";
+        dl: "dl";
+        "rack-card-4x9": "rack-card-4x9";
+        "rack-card-3.5x8.5": "rack-card-3.5x8.5";
+        "poster-12x18": "poster-12x18";
+        "poster-16x20": "poster-16x20";
+        "poster-18x24": "poster-18x24";
+        "poster-24x36": "poster-24x36";
+        a2: "a2";
+        a1: "a1";
+        a0: "a0";
+      }>, z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        unit: z.ZodEnum<{
+          mm: "mm";
+          in: "in";
+          pt: "pt";
+        }>;
+      }, z.core.$strip>]>;
+      orientation: z.ZodDefault<z.ZodEnum<{
+        portrait: "portrait";
+        landscape: "landscape";
+      }>>;
+      margin: z.ZodOptional<z.ZodObject<{
+        top: z.ZodDefault<z.ZodNumber>;
+        right: z.ZodDefault<z.ZodNumber>;
+        bottom: z.ZodDefault<z.ZodNumber>;
+        left: z.ZodDefault<z.ZodNumber>;
+      }, z.core.$strip>>;
+      bleed: z.ZodDefault<z.ZodNumber>;
+      safe: z.ZodDefault<z.ZodNumber>;
+      marks: z.ZodDefault<z.ZodBoolean>;
+      markColor: z.ZodDefault<z.ZodEnum<{
+        black: "black";
+        registration: "registration";
+      }>>;
+    }, z.core.$strip>>;
+    printedPages: z.ZodOptional<z.ZodObject<{
+      parents: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        basedOn: z.ZodOptional<z.ZodString>;
+        margin: z.ZodOptional<z.ZodObject<{
+          top: z.ZodNumber;
+          bottom: z.ZodNumber;
+          inner: z.ZodNumber;
+          outer: z.ZodNumber;
+        }, z.core.$strip>>;
+        head: z.ZodOptional<z.ZodString>;
+        foot: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+      rules: z.ZodPipe<z.ZodObject<{
+        every: z.ZodString;
+        first: z.ZodOptional<z.ZodString>;
+        recto: z.ZodOptional<z.ZodString>;
+        verso: z.ZodOptional<z.ZodString>;
+        last: z.ZodOptional<z.ZodString>;
+      }, z.core.$loose>, z.ZodTransform<{
+        last?: string | undefined;
+        verso?: string | undefined;
+        recto?: string | undefined;
+        first?: string | undefined;
+        every: string;
+      }, {
+        [x: string]: unknown;
+        every: string;
+        first?: string | undefined;
+        recto?: string | undefined;
+        verso?: string | undefined;
+        last?: string | undefined;
+      }>>;
+      numbering: z.ZodOptional<z.ZodEnum<{
+        arabic: "arabic";
+        "roman-lower": "roman-lower";
+        "roman-upper": "roman-upper";
+        hebrew: "hebrew";
+      }>>;
+    }, z.core.$strip>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+      key: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodEnum<{
+        text: "text";
+        image: "image";
+        phone: "phone";
+        email: "email";
+        link: "link";
+        qr: "qr";
+      }>;
+      required: z.ZodDefault<z.ZodBoolean>;
+      placeholder: z.ZodOptional<z.ZodString>;
+      overflow: z.ZodDefault<z.ZodEnum<{
+        refuse: "refuse";
+        shrink: "shrink";
+        truncate: "truncate";
+        wrap: "wrap";
+      }>>;
+      minSize: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodTransform<{
+      key: string;
+      label: string;
+      type: "text" | "image" | "phone" | "email" | "link" | "qr";
+      required: boolean;
+      overflow: "refuse" | "shrink" | "truncate" | "wrap";
+      placeholder?: string | undefined;
+      minSize?: number | undefined;
+    }, {
+      key: string;
+      label: string;
+      type: "text" | "image" | "phone" | "email" | "link" | "qr";
+      required: boolean;
+      overflow: "refuse" | "shrink" | "truncate" | "wrap";
+      placeholder?: string | undefined;
+      minSize?: number | undefined;
+    }>>>>;
+    fonts: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+      app: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      local: z.ZodString;
+      fallback: z.ZodString;
+    }, z.core.$strip>]>>>;
+  }, z.core.$strip>;
+  id: z.ZodOptional<z.ZodString>;
+  name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+  page: {
+    print: {
+      paper: "letter" | "legal" | "tabloid" | "a3" | "a4" | "a5" | "business-card-us" | "business-card-eu" | "business-card-square-us" | "business-card-slim-us" | "postcard-4x6" | "postcard-5x7" | "postcard-6x9" | "postcard-6x11" | "card-square-4in" | "half-letter" | "a6" | "dl" | "rack-card-4x9" | "rack-card-3.5x8.5" | "poster-12x18" | "poster-16x20" | "poster-18x24" | "poster-24x36" | "a2" | "a1" | "a0" | {
+        width: number;
+        height: number;
+        unit: "mm" | "in" | "pt";
+      };
+      orientation: "portrait" | "landscape";
+      bleed: number;
+      safe: number;
+      marks: boolean;
+      markColor: "black" | "registration";
+      margin?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+      } | undefined;
+    };
+    html: string;
+    size: "fluid" | {
+      width: number;
+      height: number;
+    } | {
+      width: number;
+      height: "auto";
+    };
+    scripts: "refuse" | "sandboxed";
+    id?: string | undefined;
+    dir?: "auto" | "ltr" | "rtl" | undefined;
+    lang?: string | undefined;
+    printedPages?: {
+      parents: {
+        name: string;
+        basedOn?: string | undefined;
+        margin?: {
+          top: number;
+          bottom: number;
+          inner: number;
+          outer: number;
+        } | undefined;
+        head?: string | undefined;
+        foot?: string | undefined;
+      }[];
+      rules: {
+        last?: string | undefined;
+        verso?: string | undefined;
+        recto?: string | undefined;
+        first?: string | undefined;
+        every: string;
+      };
+      numbering?: "arabic" | "roman-lower" | "roman-upper" | "hebrew" | undefined;
+    } | undefined;
+    slots?: {
+      key: string;
+      label: string;
+      type: "text" | "image" | "phone" | "email" | "link" | "qr";
+      required: boolean;
+      overflow: "refuse" | "shrink" | "truncate" | "wrap";
+      placeholder?: string | undefined;
+      minSize?: number | undefined;
+    }[] | undefined;
+    fonts?: ({
+      app: string;
+    } | {
+      local: string;
+      fallback: string;
+    })[] | undefined;
+  };
+  id?: string | undefined;
+  name?: string | undefined;
+}, {
+  page: {
+    html: string;
+    size: "fluid" | {
+      width: number;
+      height: number;
+    } | {
+      width: number;
+      height: "auto";
+    };
+    scripts: "refuse" | "sandboxed";
+    id?: string | undefined;
+    dir?: "auto" | "ltr" | "rtl" | undefined;
+    lang?: string | undefined;
+    print?: {
+      paper: "letter" | "legal" | "tabloid" | "a3" | "a4" | "a5" | "business-card-us" | "business-card-eu" | "business-card-square-us" | "business-card-slim-us" | "postcard-4x6" | "postcard-5x7" | "postcard-6x9" | "postcard-6x11" | "card-square-4in" | "half-letter" | "a6" | "dl" | "rack-card-4x9" | "rack-card-3.5x8.5" | "poster-12x18" | "poster-16x20" | "poster-18x24" | "poster-24x36" | "a2" | "a1" | "a0" | {
+        width: number;
+        height: number;
+        unit: "mm" | "in" | "pt";
+      };
+      orientation: "portrait" | "landscape";
+      bleed: number;
+      safe: number;
+      marks: boolean;
+      markColor: "black" | "registration";
+      margin?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+      } | undefined;
+    } | undefined;
+    printedPages?: {
+      parents: {
+        name: string;
+        basedOn?: string | undefined;
+        margin?: {
+          top: number;
+          bottom: number;
+          inner: number;
+          outer: number;
+        } | undefined;
+        head?: string | undefined;
+        foot?: string | undefined;
+      }[];
+      rules: {
+        last?: string | undefined;
+        verso?: string | undefined;
+        recto?: string | undefined;
+        first?: string | undefined;
+        every: string;
+      };
+      numbering?: "arabic" | "roman-lower" | "roman-upper" | "hebrew" | undefined;
+    } | undefined;
+    slots?: {
+      key: string;
+      label: string;
+      type: "text" | "image" | "phone" | "email" | "link" | "qr";
+      required: boolean;
+      overflow: "refuse" | "shrink" | "truncate" | "wrap";
+      placeholder?: string | undefined;
+      minSize?: number | undefined;
+    }[] | undefined;
+    fonts?: ({
+      app: string;
+    } | {
+      local: string;
+      fallback: string;
+    })[] | undefined;
+  };
+  id?: string | undefined;
+  name?: string | undefined;
+}>>;
+export type Cover = z.infer<typeof Cover>;
+export type CoverInput = z.input<typeof Cover>;
+export interface CoverDigestMaterial {
+  page: Page;
+  sheet: {
+    width: number;
+    height: number;
+  };
+  drawingVersion: number;
+  stamp: string;
+  fonts: readonly string[];
+  motifs: readonly Motif[];
+}
+export declare function digestCoverMaterial(material: CoverDigestMaterial): Promise<string>;
+export declare function coverDigest(cover: Cover, inputs: {
+  stamp: string;
+  fonts?: readonly string[];
+  motifs?: readonly Motif[];
+}): Promise<string>;
+//#endregion