@segnavia/format 0.23.0 → 0.25.0

package/dist/imposition-marks.d.ts

@@ -0,0 +1,18 @@
+import { MarkSegment } from "./paper.js";
+import { Imposition } from "./index.js";
+//#region src/imposition-marks.d.ts
+export declare const MIN_MARK_LENGTH_MM = 2;
+export type ImpositionMarkEdge = 'top' | 'right' | 'bottom' | 'left';
+export interface OmittedImpositionMark {
+  side: 'front' | 'back';
+  edge: ImpositionMarkEdge;
+  cutPosition: number;
+}
+export interface ImpositionSideMarks {
+  side: 'front' | 'back';
+  marks: MarkSegment[];
+  omittedMarks: OmittedImpositionMark[];
+}
+/** Computes physical crop-mark geometry without changing the fixed paper size. */
+export declare function impositionMarks(imposition: Imposition): ImpositionSideMarks[];
+//#endregion

package/dist/imposition-marks.js

@@ -0,0 +1,198 @@
+import { roundMillimeters } from "./paper.js";
+import { impose } from "./imposition.js";
+//#region src/imposition-marks.ts
+const MIN_MARK_LENGTH_MM = 2;
+const unique = (values) => [...new Set(values.map(roundMillimeters))].sort((a, b) => a - b);
+function addMark(result, edge, cutPosition, start, available, horizontal, direction) {
+	const length = Math.min(5, roundMillimeters(available));
+	if (length < 2) {
+		result.omittedMarks.push({
+			side: result.side,
+			edge,
+			cutPosition
+		});
+		return;
+	}
+	const end = roundMillimeters(start + direction * length);
+	result.marks.push(horizontal ? {
+		x1: Math.min(start, end),
+		y1: cutPosition,
+		x2: Math.max(start, end),
+		y2: cutPosition
+	} : {
+		x1: cutPosition,
+		y1: Math.min(start, end),
+		x2: cutPosition,
+		y2: Math.max(start, end)
+	});
+}
+function outerMarks(side, placements, paper) {
+	const verticalCuts = unique(placements.flatMap(({ trim }) => [trim.x, trim.x + trim.width]));
+	const horizontalCuts = unique(placements.flatMap(({ trim }) => [trim.y, trim.y + trim.height]));
+	const top = Math.min(...placements.map(({ bleedBox }) => bleedBox.y));
+	const right = Math.max(...placements.map(({ bleedBox }) => bleedBox.x + bleedBox.width));
+	const bottom = Math.max(...placements.map(({ bleedBox }) => bleedBox.y + bleedBox.height));
+	const left = Math.min(...placements.map(({ bleedBox }) => bleedBox.x));
+	for (const cut of verticalCuts) {
+		addMark(side, "top", cut, roundMillimeters(top - 1), top - 1, false, -1);
+		addMark(side, "bottom", cut, roundMillimeters(bottom + 1), paper.height - bottom - 1, false, 1);
+	}
+	for (const cut of horizontalCuts) {
+		addMark(side, "left", cut, roundMillimeters(left - 1), left - 1, true, -1);
+		addMark(side, "right", cut, roundMillimeters(right + 1), paper.width - right - 1, true, 1);
+	}
+}
+function intersectsBleed(mark, boxes) {
+	return boxes.some((box) => Math.max(mark.x1, box.x) <= Math.min(mark.x2, box.x + box.width) && Math.max(mark.y1, box.y) <= Math.min(mark.y2, box.y + box.height));
+}
+function rayRoom(start, cut, horizontal, direction, boxes) {
+	const obstacles = boxes.filter((box) => {
+		const acrossStart = horizontal ? box.y : box.x;
+		const acrossEnd = acrossStart + (horizontal ? box.height : box.width);
+		if (cut < acrossStart || cut > acrossEnd) return false;
+		const alongStart = horizontal ? box.x : box.y;
+		const alongEnd = alongStart + (horizontal ? box.width : box.height);
+		return direction < 0 ? alongEnd <= start : alongStart >= start;
+	}).map((box) => {
+		const alongStart = horizontal ? box.x : box.y;
+		const alongEnd = alongStart + (horizontal ? box.width : box.height);
+		return direction < 0 ? start - alongEnd - 1 : alongStart - start - 1;
+	});
+	return Math.max(0, Math.min(5, ...obstacles));
+}
+function cornerMarks(side, placements, rows) {
+	const boxes = placements.map(({ bleedBox }) => bleedBox);
+	const left = Math.min(...placements.map(({ trim }) => trim.x));
+	const right = Math.max(...placements.map(({ trim }) => trim.x + trim.width));
+	for (const placement of placements) {
+		const { trim, bleedBox, row } = placement;
+		const candidates = [];
+		if (row > 0) {
+			candidates.push([
+				"top",
+				trim.x,
+				bleedBox.y - 1,
+				false,
+				-1
+			]);
+			candidates.push([
+				"top",
+				trim.x + trim.width,
+				bleedBox.y - 1,
+				false,
+				-1
+			]);
+		}
+		if (row < rows - 1) {
+			candidates.push([
+				"bottom",
+				trim.x,
+				bleedBox.y + bleedBox.height + 1,
+				false,
+				1
+			]);
+			candidates.push([
+				"bottom",
+				trim.x + trim.width,
+				bleedBox.y + bleedBox.height + 1,
+				false,
+				1
+			]);
+		}
+		if (trim.x > left) {
+			candidates.push([
+				"left",
+				trim.y,
+				bleedBox.x - 1,
+				true,
+				-1
+			]);
+			candidates.push([
+				"left",
+				trim.y + trim.height,
+				bleedBox.x - 1,
+				true,
+				-1
+			]);
+		}
+		if (trim.x + trim.width < right) {
+			candidates.push([
+				"right",
+				trim.y,
+				bleedBox.x + bleedBox.width + 1,
+				true,
+				1
+			]);
+			candidates.push([
+				"right",
+				trim.y + trim.height,
+				bleedBox.x + bleedBox.width + 1,
+				true,
+				1
+			]);
+		}
+		for (const [edge, cut, start, horizontal, direction] of candidates) {
+			const before = side.marks.length;
+			addMark(side, edge, roundMillimeters(cut), roundMillimeters(start), rayRoom(start, cut, horizontal, direction, boxes), horizontal, direction);
+			const mark = side.marks.at(-1);
+			if (side.marks.length > before && mark && intersectsBleed(mark, boxes)) {
+				side.marks.pop();
+				side.omittedMarks.push({
+					side: side.side,
+					edge,
+					cutPosition: roundMillimeters(cut)
+				});
+			}
+		}
+	}
+}
+/** Computes physical crop-mark geometry without changing the fixed paper size. */
+function impositionMarks(imposition) {
+	if (!imposition.marks) return [];
+	const cellCount = imposition.columns * imposition.rows;
+	const frontImposed = impose({
+		...imposition,
+		sides: "one",
+		fill: "sequence",
+		skip: 0
+	}, cellCount);
+	const frontPlacements = frontImposed.placements;
+	const build = (sideName, placements) => {
+		const side = {
+			side: sideName,
+			marks: [],
+			omittedMarks: []
+		};
+		outerMarks(side, placements, frontImposed.paper);
+		if (imposition.cornerMarks) cornerMarks(side, placements, imposition.rows);
+		return side;
+	};
+	const front = build("front", frontPlacements);
+	if (imposition.sides === "one") return [front];
+	const portrait = frontImposed.paper.width <= frontImposed.paper.height;
+	const axis = imposition.flip === "long" === portrait ? "x" : "y";
+	const mirrorMark = (mark) => axis === "x" ? {
+		...mark,
+		x1: roundMillimeters(frontImposed.paper.width - mark.x1),
+		x2: roundMillimeters(frontImposed.paper.width - mark.x2)
+	} : {
+		...mark,
+		y1: roundMillimeters(frontImposed.paper.height - mark.y1),
+		y2: roundMillimeters(frontImposed.paper.height - mark.y2)
+	};
+	const mirrorEdge = (edge) => {
+		if (axis === "x") return edge === "left" ? "right" : edge === "right" ? "left" : edge;
+		return edge === "top" ? "bottom" : edge === "bottom" ? "top" : edge;
+	};
+	return [front, {
+		side: "back",
+		marks: front.marks.map(mirrorMark),
+		omittedMarks: front.omittedMarks.map(({ edge, cutPosition }) => ({
+			side: "back",
+			edge: mirrorEdge(edge),
+			cutPosition: roundMillimeters(axis === "x" && (edge === "top" || edge === "bottom") ? frontImposed.paper.width - cutPosition : axis === "y" && (edge === "left" || edge === "right") ? frontImposed.paper.height - cutPosition : cutPosition)
+		}))
+	}];
+}
+//#endregion
+export { MIN_MARK_LENGTH_MM, impositionMarks };

package/dist/index.d.ts

@@ -9,15 +9,16 @@ import { assignMembership, fitSection, fitTouchedSections, makeRoom, settleBoard
 import { Book, BookContents, BookFrontMatterEntry, BookInput, BookMode, BookPage, BookSection, BookView, BookViewInput, Chapter, isBookContents, isHebrew, noteMarkerIssues } from "./book.js";
 import { DeckFromSlidesOptions, SlideRow, deckFromSlides } from "./deck-from-slides.js";
 import { Direction, TextDirection, firstStrongDirection, languageDirection, resolveDirection } from "./direction.js";
-import { CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, MARK_GAP_MM, MARK_LENGTH_MM, MM_PER_PT, NAMED_PAPERS, NamedPaper, NamedPaperMetadata, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, Paper, PaperBox, PaperGroup, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters } from "./paper.js";
+import { CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, MARK_GAP_MM, MARK_LENGTH_MM, MM_PER_PT, MarkSegment, NAMED_PAPERS, NamedPaper, NamedPaperMetadata, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, Paper, PaperBox, PaperGroup, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, paperPixels, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters } from "./paper.js";
 import { Imposed, MillimeterEdges, PageFit, PagePlacementKind, PagePlacementLayout, Placement, fitPage, impose, mirrorPlacement, pagePlacementLayout } from "./imposition.js";
+import { ImpositionMarkEdge, ImpositionSideMarks, MIN_MARK_LENGTH_MM, OmittedImpositionMark, impositionMarks } from "./imposition-marks.js";
 import { Lexicon, PronunciationEntry, lexiconVersion } from "./lexicon.js";
 import { NoteMarker, NumberSystem, formatNumber, noteMarker } from "./numbering.js";
 import { Scripts } from "./scripts.js";
 import { ShotUse, shotsUsed } from "./shots-used.js";
 import { MAX_SLIDE_TIMING_MS } from "./timing.js";
 import { DEFAULT_TRANSITION_DURATION_MS, MAX_TRANSITION_DURATION_MS, MIN_TRANSITION_DURATION_MS, Transition, TransitionInput } from "./transition.js";
-import { Fill, SLOT_TYPES, SlotDeclaration, SlotDeclarationInput, SlotReport, SlotSource, SlotState, SlotType, SlotValue, Slots, SlotsInput, SlotsOptions, mergeSlotDeclarations } from "./slots.js";
+import { Fill, FillValues, SLOT_TYPES, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotReport, SlotSource, SlotState, SlotType, SlotValue, Slots, SlotsInput, SlotsOptions, mergeSlotDeclarations } from "./slots.js";
 import { z } from "zod";
 //#region src/index.d.ts
 export declare const Margin: z.ZodObject<{
@@ -167,6 +168,8 @@ export declare const Imposition: z.ZodObject<{
     ltr: "ltr";
     rtl: "rtl";
   }>>;
+  marks: z.ZodDefault<z.ZodBoolean>;
+  cornerMarks: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type Imposition = z.infer<typeof Imposition>;
 export type ImpositionInput = z.input<typeof Imposition>;
@@ -631,6 +634,8 @@ export declare function jsonSchemas(): {
       ltr: "ltr";
       rtl: "rtl";
     }>>;
+    marks: z.ZodDefault<z.ZodBoolean>;
+    cornerMarks: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
   deck: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
     title: z.ZodString;
@@ -1134,4 +1139,4 @@ export declare function jsonSchemas(): {
   }>>>;
 };
 //#endregion
-export { Annotation, type ArrangeOptions, Board, type BoardInput, BoardItem, type BoardItemAnchor, BoardLabel, type BoardListingGroup, BoardSection, type BoardShapes, type BoardView, Book, BookContents, BookFrontMatterEntry, type BookInput, BookMode, BookPage, BookSection, BookView, type BookViewInput, Box, CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, type DeckFromSlidesOptions, type DeckInput, type DeckLimits, Direction, Fill, GridCell, type GridDropTarget, ImageFit, type Imposed, Lexicon, MAKE_ROOM_LIMIT, MARK_GAP_MM, MARK_LENGTH_MM, MAX_BOARD_ZOOM, MAX_SLIDE_TIMING_MS, MAX_TRANSITION_DURATION_MS, MIN_BOARD_ITEM_WIDTH, MIN_BOARD_ZOOM, MIN_TRANSITION_DURATION_MS, MM_PER_PT, Manifest, type MillimeterEdges, NAMED_PAPERS, type NamedPaper, type NamedPaperMetadata, Narration, NoteMarker, NumberSystem, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PLAYBACK_MODES, PX_PER_MM, type PageFit, type PagePlacementKind, type PagePlacementLayout, Paper, type PaperBox, type PaperGroup, PaperUnit, type Placement, Playback, type PlaybackMode, Point, PrintSetting, PrintSettingInput, PronunciationEntry, PublishedShot, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, SHOT_KEY, SLOT_TYPES, Scripts, Shot, type ShotUse, Size, Slide, SlideContent, type SlideRow, SlotDeclaration, SlotDeclarationInput, SlotReport, SlotSource, SlotState, SlotType, SlotValue, Slots, SlotsInput, SlotsOptions, TextDirection, Transition, TransitionInput, Word, type ZoomBounds, addItem, annotationCueIssues, arrange, assignMembership, boardBounds, boardListing, boardListingIsEmpty, boardToScreen, deckFromSlides, deriveSectionCells, exceedsLimits, firstStrongDirection, fitPage, fitSection, fitTouchedSections, foldForSearch, formatNumber, fromMillimeters, gridDropMarkerBox, gridDropTarget, impose, insertIntoGrid, isBookContents, isHebrew, itemAt, itemHeight, languageDirection, layoutSection, lexiconVersion, makeRoom, mergeSlotDeclarations, mirrorPlacement, moveItems, moveSection, nameMatches, noteMarker, noteMarkerIssues, pagePlacementLayout, parsePlayback, printBoxes, printPadding, printProperties, removeFromGrid, removeItems, resizeItem, resolveDirection, revealView, roundMillimeters, screenToBoard, settleBoard, sheetMm, shotsUsed, toMillimeters, visibleItems, zoomAt, zoomToFit };
+export { Annotation, type ArrangeOptions, Board, type BoardInput, BoardItem, type BoardItemAnchor, BoardLabel, type BoardListingGroup, BoardSection, type BoardShapes, type BoardView, Book, BookContents, BookFrontMatterEntry, type BookInput, BookMode, BookPage, BookSection, BookView, type BookViewInput, Box, CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, type DeckFromSlidesOptions, type DeckInput, type DeckLimits, Direction, Fill, FillValues, GridCell, type GridDropTarget, ImageFit, type Imposed, type ImpositionMarkEdge, type ImpositionSideMarks, Lexicon, MAKE_ROOM_LIMIT, MARK_GAP_MM, MARK_LENGTH_MM, MAX_BOARD_ZOOM, MAX_SLIDE_TIMING_MS, MAX_TRANSITION_DURATION_MS, MIN_BOARD_ITEM_WIDTH, MIN_BOARD_ZOOM, MIN_MARK_LENGTH_MM, MIN_TRANSITION_DURATION_MS, MM_PER_PT, Manifest, type MarkSegment, type MillimeterEdges, NAMED_PAPERS, type NamedPaper, type NamedPaperMetadata, Narration, NoteMarker, NumberSystem, ORIENTATIONS, type OmittedImpositionMark, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PLAYBACK_MODES, PX_PER_MM, type PageFit, type PagePlacementKind, type PagePlacementLayout, Paper, type PaperBox, type PaperGroup, PaperUnit, type Placement, Playback, type PlaybackMode, Point, PrintSetting, PrintSettingInput, PronunciationEntry, PublishedShot, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, SHOT_KEY, SLOT_TYPES, Scripts, Shot, type ShotUse, Size, Slide, SlideContent, type SlideRow, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotReport, SlotSource, SlotState, SlotType, SlotValue, Slots, SlotsInput, SlotsOptions, TextDirection, Transition, TransitionInput, Word, type ZoomBounds, addItem, annotationCueIssues, arrange, assignMembership, boardBounds, boardListing, boardListingIsEmpty, boardToScreen, deckFromSlides, deriveSectionCells, exceedsLimits, firstStrongDirection, fitPage, fitSection, fitTouchedSections, foldForSearch, formatNumber, fromMillimeters, gridDropMarkerBox, gridDropTarget, impose, impositionMarks, insertIntoGrid, isBookContents, isHebrew, itemAt, itemHeight, languageDirection, layoutSection, lexiconVersion, makeRoom, mergeSlotDeclarations, mirrorPlacement, moveItems, moveSection, nameMatches, noteMarker, noteMarkerIssues, pagePlacementLayout, paperPixels, parsePlayback, printBoxes, printPadding, printProperties, removeFromGrid, removeItems, resizeItem, resolveDirection, revealView, roundMillimeters, screenToBoard, settleBoard, sheetMm, shotsUsed, toMillimeters, visibleItems, zoomAt, zoomToFit };

package/dist/index.js

@@ -1,12 +1,12 @@
 import { Direction, TextDirection, firstStrongDirection, languageDirection, resolveDirection } from "./direction.js";
 import { Scripts } from "./scripts.js";
-import { SLOT_TYPES, SlotDeclaration, SlotDeclarationInput, SlotType, Slots, SlotsInput, mergeSlotDeclarations } from "./slots.js";
+import { FillValues, SLOT_TYPES, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotType, SlotValue, Slots, SlotsInput, mergeSlotDeclarations } from "./slots.js";
 import { MAX_SLIDE_TIMING_MS } from "./timing.js";
 import { DEFAULT_TRANSITION_DURATION_MS, MAX_TRANSITION_DURATION_MS, MIN_TRANSITION_DURATION_MS, Transition } from "./transition.js";
 import { Annotation, Box, Cue, DECK_SIZE, Deck, DeckShape, ImageFit, Manifest, Narration, PLAYBACK_MODES, Playback, Point, PublishedShot, SHOT_KEY, Shot, Size, Slide, SlideContent, Word, annotationCueIssues, exceedsLimits, parsePlayback } from "./deck.js";
 import { Board, BoardItem, BoardLabel, BoardSection, GridCell } from "./board.js";
 import { NoteMarker, NumberSystem, formatNumber, noteMarker } from "./numbering.js";
-import { CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, MARK_GAP_MM, MARK_LENGTH_MM, MM_PER_PT, NAMED_PAPERS, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, Paper, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters } from "./paper.js";
+import { CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, MARK_GAP_MM, MARK_LENGTH_MM, MM_PER_PT, NAMED_PAPERS, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, Paper, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, paperPixels, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters } from "./paper.js";
 import { Book, BookContents, BookFrontMatterEntry, BookMode, BookPage, BookSection, BookShape, BookView, Chapter, isBookContents, isHebrew, noteMarkerIssues } from "./book.js";
 import { Lexicon, PronunciationEntry, lexiconVersion } from "./lexicon.js";
 import { MIN_BOARD_ITEM_WIDTH, addItem, moveItems, moveSection, removeItems, resizeItem } from "./board-edit.js";
@@ -17,6 +17,7 @@ import { deriveSectionCells, gridDropMarkerBox, gridDropTarget, insertIntoGrid,
 import { assignMembership, fitSection, fitTouchedSections, makeRoom, settleBoard } from "./board-sections.js";
 import { deckFromSlides } from "./deck-from-slides.js";
 import { fitPage, impose, mirrorPlacement, pagePlacementLayout } from "./imposition.js";
+import { MIN_MARK_LENGTH_MM, impositionMarks } from "./imposition-marks.js";
 import { shotsUsed } from "./shots-used.js";
 import { z } from "zod";
 //#region src/index.ts
@@ -78,9 +79,16 @@ const Imposition = z.object({
 	sides: z.enum(["one", "two"]).default("one"),
 	flip: z.enum(["long", "short"]).default("long"),
 	skip: z.number().int().nonnegative().default(0),
-	dir: z.enum(["ltr", "rtl"]).default("ltr")
+	dir: z.enum(["ltr", "rtl"]).default("ltr"),
+	marks: z.boolean().default(false),
+	cornerMarks: z.boolean().default(false)
 }).superRefine((imposition, ctx) => {
 	const cellCount = BigInt(imposition.columns) * BigInt(imposition.rows);
+	if (imposition.cornerMarks && !imposition.marks) ctx.addIssue({
+		code: "custom",
+		path: ["cornerMarks"],
+		message: "cornerMarks requires marks to be true"
+	});
 	if (imposition.columns > 1e4 || imposition.rows > 1e4 || cellCount > BigInt(1e4)) {
 		ctx.addIssue({
 			code: "custom",
@@ -162,4 +170,4 @@ function jsonSchemas() {
 	};
 }
 //#endregion
-export { Annotation, Board, BoardItem, BoardLabel, BoardSection, Book, BookContents, BookFrontMatterEntry, BookMode, BookPage, BookSection, BookView, Box, CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, Direction, GridCell, ImageFit, Imposition, Lexicon, MAKE_ROOM_LIMIT, MARK_GAP_MM, MARK_LENGTH_MM, MAX_BOARD_ZOOM, MAX_IMPOSITION_CELLS, MAX_SLIDE_TIMING_MS, MAX_TRANSITION_DURATION_MS, MIN_BOARD_ITEM_WIDTH, MIN_BOARD_ZOOM, MIN_TRANSITION_DURATION_MS, MM_PER_PT, Manifest, Margin, NAMED_PAPERS, Narration, NoteMarker, NumberSystem, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PLAYBACK_MODES, PX_PER_MM, Page, PageSize, Paper, PaperUnit, Playback, Point, Print, PrintSetting, PrintSettingInput, PronunciationEntry, PublishedShot, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, SHOT_KEY, SLOT_TYPES, Scripts, Shot, Size, Slide, SlideContent, SlotDeclaration, SlotDeclarationInput, SlotType, Slots, SlotsInput, TextDirection, Transition, Word, addItem, annotationCueIssues, arrange, assignMembership, boardBounds, boardListing, boardListingIsEmpty, boardToScreen, deckFromSlides, deriveSectionCells, exceedsLimits, firstStrongDirection, fitPage, fitSection, fitTouchedSections, foldForSearch, formatNumber, fromMillimeters, gridDropMarkerBox, gridDropTarget, impose, insertIntoGrid, isBookContents, isHebrew, itemAt, itemHeight, jsonSchemas, languageDirection, layoutSection, lexiconVersion, makeRoom, mergeSlotDeclarations, mirrorPlacement, moveItems, moveSection, nameMatches, noteMarker, noteMarkerIssues, pagePlacementLayout, parsePlayback, printBoxes, printPadding, printProperties, removeFromGrid, removeItems, resizeItem, resolveDirection, revealView, roundMillimeters, screenToBoard, settleBoard, sheetMm, shotsUsed, toMillimeters, visibleItems, zoomAt, zoomToFit };
+export { Annotation, Board, BoardItem, BoardLabel, BoardSection, Book, BookContents, BookFrontMatterEntry, BookMode, BookPage, BookSection, BookView, Box, CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, Direction, FillValues, GridCell, ImageFit, Imposition, Lexicon, MAKE_ROOM_LIMIT, MARK_GAP_MM, MARK_LENGTH_MM, MAX_BOARD_ZOOM, MAX_IMPOSITION_CELLS, MAX_SLIDE_TIMING_MS, MAX_TRANSITION_DURATION_MS, MIN_BOARD_ITEM_WIDTH, MIN_BOARD_ZOOM, MIN_MARK_LENGTH_MM, MIN_TRANSITION_DURATION_MS, MM_PER_PT, Manifest, Margin, NAMED_PAPERS, Narration, NoteMarker, NumberSystem, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PLAYBACK_MODES, PX_PER_MM, Page, PageSize, Paper, PaperUnit, Playback, Point, Print, PrintSetting, PrintSettingInput, PronunciationEntry, PublishedShot, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, SHOT_KEY, SLOT_TYPES, Scripts, Shot, Size, Slide, SlideContent, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotType, SlotValue, Slots, SlotsInput, TextDirection, Transition, Word, addItem, annotationCueIssues, arrange, assignMembership, boardBounds, boardListing, boardListingIsEmpty, boardToScreen, deckFromSlides, deriveSectionCells, exceedsLimits, firstStrongDirection, fitPage, fitSection, fitTouchedSections, foldForSearch, formatNumber, fromMillimeters, gridDropMarkerBox, gridDropTarget, impose, impositionMarks, insertIntoGrid, isBookContents, isHebrew, itemAt, itemHeight, jsonSchemas, languageDirection, layoutSection, lexiconVersion, makeRoom, mergeSlotDeclarations, mirrorPlacement, moveItems, moveSection, nameMatches, noteMarker, noteMarkerIssues, pagePlacementLayout, paperPixels, parsePlayback, printBoxes, printPadding, printProperties, removeFromGrid, removeItems, resizeItem, resolveDirection, revealView, roundMillimeters, screenToBoard, settleBoard, sheetMm, shotsUsed, toMillimeters, visibleItems, zoomAt, zoomToFit };

package/dist/paper.d.ts

@@ -303,6 +303,7 @@ export declare function sheetMm(print: Pick<Print, 'paper' | 'orientation'>): {
   height: number;
 };
 export declare const PX_PER_MM: number;
+export declare const paperPixels: (millimeters: number) => number;
 export declare function printProperties(print: Pick<Print, 'bleed' | 'safe'>, unit?: 'mm' | 'in' | 'pt'): string;
 export declare function printPadding(edges: {
   top: number;

package/dist/paper.js

@@ -373,6 +373,7 @@ function sheetMm(print) {
 	};
 }
 const PX_PER_MM = 96 / 25.4;
+const paperPixels = (millimeters) => Math.ceil(millimeters * PX_PER_MM - 1e-9);
 function printProperties(print, unit = "mm") {
 	return `:root{--segnavia-bleed:${roundMillimeters(toMillimeters(print.bleed, unit))}mm;--segnavia-safe:${roundMillimeters(toMillimeters(print.safe, unit))}mm}`;
 }
@@ -482,4 +483,4 @@ function printBoxes(print) {
 	};
 }
 //#endregion
-export { CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, MARK_GAP_MM, MARK_LENGTH_MM, MM_PER_PT, NAMED_PAPERS, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, Paper, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters };
+export { CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, MARK_GAP_MM, MARK_LENGTH_MM, MM_PER_PT, NAMED_PAPERS, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, Paper, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, paperPixels, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters };

package/dist/slots.d.ts

@@ -10,6 +10,8 @@ export declare const SlotType: z.ZodEnum<{
   image: "image";
 }>;
 export type SlotType = z.infer<typeof SlotType>;
+export declare const SlotKey: z.ZodString;
+export type SlotKey = z.infer<typeof SlotKey>;
 export declare const SlotDeclaration: z.ZodPipe<z.ZodObject<{
   key: z.ZodString;
   label: z.ZodString;
@@ -164,13 +166,18 @@ export declare const SlotsInput: z.ZodArray<z.ZodPipe<z.ZodObject<{
   minSize?: number | undefined;
 }>>>;
 export type SlotsInput = z.input<typeof SlotsInput>;
-export type SlotValue = string | {
-  asset: string;
-};
+export declare const SlotValue: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+  asset: z.ZodString;
+}, z.core.$strip>]>;
+export type SlotValue = z.infer<typeof SlotValue>;
+export declare const FillValues: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+  asset: z.ZodString;
+}, z.core.$strip>]>>;
+export type FillValues = z.infer<typeof FillValues>;
 export interface Fill {
   id: string;
   label?: string;
-  values: Record<string, SlotValue>;
+  values: FillValues;
 }
 export interface SlotSource {
   id: string;
@@ -191,7 +198,7 @@ export interface SlotsOptions {
   source?: Fill;
   fill?: Fill;
   declarations?: SlotDeclarationInput[];
-  /** Resolve an asset without network access. Hosts should honour the signal so timed-out renders stop this work promptly. */
+  /** Resolve an asset without network access. Hosts should honor the signal so timed-out renders stop this work promptly. */
   resolveAsset?: (ref: string, options: {
     signal: AbortSignal;
   }) => Promise<string>;

package/dist/slots.js

@@ -9,8 +9,9 @@ const SLOT_TYPES = [
 	"image"
 ];
 const SlotType = z.enum(SLOT_TYPES);
+const SlotKey = z.string().regex(/^[^.\s]+(?:\.[^.\s]+)*$/, "a slot key must be a dotted path");
 const SlotDeclarationShape = {
-	key: z.string().regex(/^[^.\s]+(?:\.[^.\s]+)*$/, "a slot key must be a dotted path"),
+	key: SlotKey,
 	label: z.string().min(1),
 	type: SlotType,
 	required: z.boolean().default(false),
@@ -69,6 +70,8 @@ const SlotsInput = z.array(SlotDeclarationInput).superRefine((slots, ctx) => {
 		seen.add(slot.key);
 	});
 });
+const SlotValue = z.union([z.string(), z.object({ asset: z.string() })]);
+const FillValues = z.record(SlotKey, SlotValue);
 function mergeSlotDeclarations(...groups) {
 	const merged = /* @__PURE__ */ new Map();
 	for (const slot of groups.flat()) {
@@ -82,4 +85,4 @@ function mergeSlotDeclarations(...groups) {
 	return [...merged.values()];
 }
 //#endregion
-export { SLOT_TYPES, SlotDeclaration, SlotDeclarationInput, SlotType, Slots, SlotsInput, mergeSlotDeclarations };
+export { FillValues, SLOT_TYPES, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotType, SlotValue, Slots, SlotsInput, mergeSlotDeclarations };

package/package.json

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