@segnavia/format 0.22.0 → 0.24.0

package/dist/deck-from-slides.d.ts

@@ -125,9 +125,11 @@ export declare function deckFromSlides(rows: SlideRow[], options: DeckFromSlides
   slots?: {
     key: string;
     label: string;
-    type: "text" | "phone" | "email" | "link" | "image";
+    type: "text" | "phone" | "email" | "link" | "qr" | "image";
     required: boolean;
+    overflow: "refuse" | "shrink" | "truncate" | "wrap";
     placeholder?: string | undefined;
+    minSize?: number | undefined;
   }[] | undefined;
 };
 //#endregion

package/dist/deck.d.ts

@@ -438,7 +438,7 @@ export declare const Deck: z.ZodObject<{
     off: "off";
     viewer: "viewer";
   }>>;
-  slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+  slots: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
     key: z.ZodString;
     label: z.ZodString;
     type: z.ZodEnum<{
@@ -446,11 +446,35 @@ export declare const Deck: z.ZodObject<{
       phone: "phone";
       email: "email";
       link: "link";
+      qr: "qr";
       image: "image";
     }>;
     required: z.ZodDefault<z.ZodBoolean>;
     placeholder: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>>;
+    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" | "phone" | "email" | "link" | "qr" | "image";
+    required: boolean;
+    overflow: "refuse" | "shrink" | "truncate" | "wrap";
+    placeholder?: string | undefined;
+    minSize?: number | undefined;
+  }, {
+    key: string;
+    label: string;
+    type: "text" | "phone" | "email" | "link" | "qr" | "image";
+    required: boolean;
+    overflow: "refuse" | "shrink" | "truncate" | "wrap";
+    placeholder?: string | undefined;
+    minSize?: number | undefined;
+  }>>>>;
   slides: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
     content: z.ZodDiscriminatedUnion<[z.ZodObject<{

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, SlotState, SlotType, SlotValue, Slots, SlotsInput, SlotsOptions, mergeSlotDeclarations } from "./slots.js";
+import { Fill, SLOT_TYPES, SlotDeclaration, SlotDeclarationInput, 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>;
@@ -250,7 +253,7 @@ export declare const Page: z.ZodObject<{
     safe: z.ZodDefault<z.ZodNumber>;
     marks: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>>;
-  slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+  slots: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
     key: z.ZodString;
     label: z.ZodString;
     type: z.ZodEnum<{
@@ -258,11 +261,35 @@ export declare const Page: z.ZodObject<{
       phone: "phone";
       email: "email";
       link: "link";
+      qr: "qr";
       image: "image";
     }>;
     required: z.ZodDefault<z.ZodBoolean>;
     placeholder: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>>;
+    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" | "phone" | "email" | "link" | "qr" | "image";
+    required: boolean;
+    overflow: "refuse" | "shrink" | "truncate" | "wrap";
+    placeholder?: string | undefined;
+    minSize?: number | undefined;
+  }, {
+    key: string;
+    label: string;
+    type: "text" | "phone" | "email" | "link" | "qr" | "image";
+    required: boolean;
+    overflow: "refuse" | "shrink" | "truncate" | "wrap";
+    placeholder?: string | undefined;
+    minSize?: number | undefined;
+  }>>>>;
 }, z.core.$strip>;
 export type Page = z.infer<typeof Page>;
 export type PageInput = z.input<typeof Page>;
@@ -476,7 +503,7 @@ export declare function jsonSchemas(): {
       safe: z.ZodDefault<z.ZodNumber>;
       marks: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
-    slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    slots: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
       key: z.ZodString;
       label: z.ZodString;
       type: z.ZodEnum<{
@@ -484,11 +511,35 @@ export declare function jsonSchemas(): {
         phone: "phone";
         email: "email";
         link: "link";
+        qr: "qr";
         image: "image";
       }>;
       required: z.ZodDefault<z.ZodBoolean>;
       placeholder: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
+      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" | "phone" | "email" | "link" | "qr" | "image";
+      required: boolean;
+      overflow: "refuse" | "shrink" | "truncate" | "wrap";
+      placeholder?: string | undefined;
+      minSize?: number | undefined;
+    }, {
+      key: string;
+      label: string;
+      type: "text" | "phone" | "email" | "link" | "qr" | "image";
+      required: boolean;
+      overflow: "refuse" | "shrink" | "truncate" | "wrap";
+      placeholder?: string | undefined;
+      minSize?: number | undefined;
+    }>>>>;
   }, z.core.$strip>>;
   lexicon: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
     entries: z.ZodArray<z.ZodObject<{
@@ -583,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;
@@ -628,7 +681,7 @@ export declare function jsonSchemas(): {
       off: "off";
       viewer: "viewer";
     }>>;
-    slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    slots: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
       key: z.ZodString;
       label: z.ZodString;
       type: z.ZodEnum<{
@@ -636,11 +689,35 @@ export declare function jsonSchemas(): {
         phone: "phone";
         email: "email";
         link: "link";
+        qr: "qr";
         image: "image";
       }>;
       required: z.ZodDefault<z.ZodBoolean>;
       placeholder: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
+      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" | "phone" | "email" | "link" | "qr" | "image";
+      required: boolean;
+      overflow: "refuse" | "shrink" | "truncate" | "wrap";
+      placeholder?: string | undefined;
+      minSize?: number | undefined;
+    }, {
+      key: string;
+      label: string;
+      type: "text" | "phone" | "email" | "link" | "qr" | "image";
+      required: boolean;
+      overflow: "refuse" | "shrink" | "truncate" | "wrap";
+      placeholder?: string | undefined;
+      minSize?: number | undefined;
+    }>>>>;
     slides: z.ZodArray<z.ZodObject<{
       id: z.ZodString;
       content: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -986,7 +1063,7 @@ export declare function jsonSchemas(): {
       landscape: "landscape";
     }>;
   }, z.core.$strict>>;
-  slotDeclaration: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+  slotDeclaration: z.core.ZodStandardJSONSchemaPayload<z.ZodPipe<z.ZodObject<{
     key: z.ZodString;
     label: z.ZodString;
     type: z.ZodEnum<{
@@ -994,12 +1071,36 @@ export declare function jsonSchemas(): {
       phone: "phone";
       email: "email";
       link: "link";
+      qr: "qr";
       image: "image";
     }>;
     required: z.ZodDefault<z.ZodBoolean>;
     placeholder: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
-  slotDeclarationInput: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+    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" | "phone" | "email" | "link" | "qr" | "image";
+    required: boolean;
+    overflow: "refuse" | "shrink" | "truncate" | "wrap";
+    placeholder?: string | undefined;
+    minSize?: number | undefined;
+  }, {
+    key: string;
+    label: string;
+    type: "text" | "phone" | "email" | "link" | "qr" | "image";
+    required: boolean;
+    overflow: "refuse" | "shrink" | "truncate" | "wrap";
+    placeholder?: string | undefined;
+    minSize?: number | undefined;
+  }>>>;
+  slotDeclarationInput: z.core.ZodStandardJSONSchemaPayload<z.ZodPipe<z.ZodObject<{
     key: z.ZodString;
     label: z.ZodString;
     type: z.ZodEnum<{
@@ -1007,11 +1108,35 @@ export declare function jsonSchemas(): {
       phone: "phone";
       email: "email";
       link: "link";
+      qr: "qr";
       image: "image";
     }>;
     required: z.ZodDefault<z.ZodBoolean>;
     placeholder: z.ZodOptional<z.ZodString>;
-  }, z.core.$strict>>;
+    overflow: z.ZodDefault<z.ZodEnum<{
+      refuse: "refuse";
+      shrink: "shrink";
+      truncate: "truncate";
+      wrap: "wrap";
+    }>>;
+    minSize: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>, z.ZodTransform<{
+    key: string;
+    label: string;
+    type: "text" | "phone" | "email" | "link" | "qr" | "image";
+    required: boolean;
+    overflow: "refuse" | "shrink" | "truncate" | "wrap";
+    placeholder?: string | undefined;
+    minSize?: number | undefined;
+  }, {
+    key: string;
+    label: string;
+    type: "text" | "phone" | "email" | "link" | "qr" | "image";
+    required: boolean;
+    overflow: "refuse" | "shrink" | "truncate" | "wrap";
+    placeholder?: string | undefined;
+    minSize?: number | undefined;
+  }>>>;
 };
 //#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, 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, 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, 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

@@ -6,7 +6,7 @@ import { DEFAULT_TRANSITION_DURATION_MS, MAX_TRANSITION_DURATION_MS, MIN_TRANSIT
 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, 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, 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, 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

@@ -1,15 +1,16 @@
 import { z } from "zod";
 //#region src/slots.d.ts
-export declare const SLOT_TYPES: readonly ["text", "phone", "email", "link", "image"];
+export declare const SLOT_TYPES: readonly ["text", "phone", "email", "link", "qr", "image"];
 export declare const SlotType: z.ZodEnum<{
   text: "text";
   phone: "phone";
   email: "email";
   link: "link";
+  qr: "qr";
   image: "image";
 }>;
 export type SlotType = z.infer<typeof SlotType>;
-export declare const SlotDeclaration: z.ZodObject<{
+export declare const SlotDeclaration: z.ZodPipe<z.ZodObject<{
   key: z.ZodString;
   label: z.ZodString;
   type: z.ZodEnum<{
@@ -17,13 +18,39 @@ export declare const SlotDeclaration: z.ZodObject<{
     phone: "phone";
     email: "email";
     link: "link";
+    qr: "qr";
     image: "image";
   }>;
   required: z.ZodDefault<z.ZodBoolean>;
   placeholder: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type SlotDeclaration = z.infer<typeof SlotDeclaration>;
-export declare const SlotDeclarationInput: z.ZodObject<{
+  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" | "phone" | "email" | "link" | "qr" | "image";
+  required: boolean;
+  overflow: "refuse" | "shrink" | "truncate" | "wrap";
+  placeholder?: string | undefined;
+  minSize?: number | undefined;
+}, {
+  key: string;
+  label: string;
+  type: "text" | "phone" | "email" | "link" | "qr" | "image";
+  required: boolean;
+  overflow: "refuse" | "shrink" | "truncate" | "wrap";
+  placeholder?: string | undefined;
+  minSize?: number | undefined;
+}>>;
+export type SlotDeclaration = Omit<z.infer<typeof SlotDeclaration>, 'overflow'> & {
+  overflow?: z.infer<typeof SlotDeclaration>['overflow'];
+};
+export declare const SlotDeclarationInput: z.ZodPipe<z.ZodObject<{
   key: z.ZodString;
   label: z.ZodString;
   type: z.ZodEnum<{
@@ -31,13 +58,37 @@ export declare const SlotDeclarationInput: z.ZodObject<{
     phone: "phone";
     email: "email";
     link: "link";
+    qr: "qr";
     image: "image";
   }>;
   required: z.ZodDefault<z.ZodBoolean>;
   placeholder: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
+  overflow: z.ZodDefault<z.ZodEnum<{
+    refuse: "refuse";
+    shrink: "shrink";
+    truncate: "truncate";
+    wrap: "wrap";
+  }>>;
+  minSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodTransform<{
+  key: string;
+  label: string;
+  type: "text" | "phone" | "email" | "link" | "qr" | "image";
+  required: boolean;
+  overflow: "refuse" | "shrink" | "truncate" | "wrap";
+  placeholder?: string | undefined;
+  minSize?: number | undefined;
+}, {
+  key: string;
+  label: string;
+  type: "text" | "phone" | "email" | "link" | "qr" | "image";
+  required: boolean;
+  overflow: "refuse" | "shrink" | "truncate" | "wrap";
+  placeholder?: string | undefined;
+  minSize?: number | undefined;
+}>>;
 export type SlotDeclarationInput = z.input<typeof SlotDeclarationInput>;
-export declare const Slots: z.ZodArray<z.ZodObject<{
+export declare const Slots: z.ZodArray<z.ZodPipe<z.ZodObject<{
   key: z.ZodString;
   label: z.ZodString;
   type: z.ZodEnum<{
@@ -45,13 +96,37 @@ export declare const Slots: z.ZodArray<z.ZodObject<{
     phone: "phone";
     email: "email";
     link: "link";
+    qr: "qr";
     image: "image";
   }>;
   required: z.ZodDefault<z.ZodBoolean>;
   placeholder: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>>;
+  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" | "phone" | "email" | "link" | "qr" | "image";
+  required: boolean;
+  overflow: "refuse" | "shrink" | "truncate" | "wrap";
+  placeholder?: string | undefined;
+  minSize?: number | undefined;
+}, {
+  key: string;
+  label: string;
+  type: "text" | "phone" | "email" | "link" | "qr" | "image";
+  required: boolean;
+  overflow: "refuse" | "shrink" | "truncate" | "wrap";
+  placeholder?: string | undefined;
+  minSize?: number | undefined;
+}>>>;
 export type Slots = z.infer<typeof Slots>;
-export declare const SlotsInput: z.ZodArray<z.ZodObject<{
+export declare const SlotsInput: z.ZodArray<z.ZodPipe<z.ZodObject<{
   key: z.ZodString;
   label: z.ZodString;
   type: z.ZodEnum<{
@@ -59,11 +134,35 @@ export declare const SlotsInput: z.ZodArray<z.ZodObject<{
     phone: "phone";
     email: "email";
     link: "link";
+    qr: "qr";
     image: "image";
   }>;
   required: z.ZodDefault<z.ZodBoolean>;
   placeholder: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>>;
+  overflow: z.ZodDefault<z.ZodEnum<{
+    refuse: "refuse";
+    shrink: "shrink";
+    truncate: "truncate";
+    wrap: "wrap";
+  }>>;
+  minSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodTransform<{
+  key: string;
+  label: string;
+  type: "text" | "phone" | "email" | "link" | "qr" | "image";
+  required: boolean;
+  overflow: "refuse" | "shrink" | "truncate" | "wrap";
+  placeholder?: string | undefined;
+  minSize?: number | undefined;
+}, {
+  key: string;
+  label: string;
+  type: "text" | "phone" | "email" | "link" | "qr" | "image";
+  required: boolean;
+  overflow: "refuse" | "shrink" | "truncate" | "wrap";
+  placeholder?: string | undefined;
+  minSize?: number | undefined;
+}>>>;
 export type SlotsInput = z.input<typeof SlotsInput>;
 export type SlotValue = string | {
   asset: string;
@@ -73,15 +172,26 @@ export interface Fill {
   label?: string;
   values: Record<string, SlotValue>;
 }
-export type SlotState = 'filled' | 'placeholder' | 'unavailable' | 'invalid';
+export interface SlotSource {
+  id: string;
+  label: string;
+  fields: string[];
+  list(options: {
+    signal: AbortSignal;
+  }): Promise<Fill[]>;
+}
+export type SlotState = 'filled' | 'placeholder' | 'unavailable' | 'invalid' | 'fit' | 'shrunk' | 'overflowed';
 export interface SlotReport {
   fill: string | null;
   slots: Record<string, SlotState>;
+  origins: Record<string, 'hand' | 'source'>;
 }
 export interface SlotsOptions {
+  /** The fill selected from a host data source; hand values override it per declared key. */
+  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

@@ -5,6 +5,7 @@ const SLOT_TYPES = [
 	"phone",
 	"email",
 	"link",
+	"qr",
 	"image"
 ];
 const SlotType = z.enum(SLOT_TYPES);
@@ -13,10 +14,39 @@ const SlotDeclarationShape = {
 	label: z.string().min(1),
 	type: SlotType,
 	required: z.boolean().default(false),
-	placeholder: z.string().optional()
+	placeholder: z.string().optional(),
+	overflow: z.enum([
+		"shrink",
+		"truncate",
+		"wrap",
+		"refuse"
+	]).default("wrap"),
+	minSize: z.number().positive().finite().optional()
 };
-const SlotDeclaration = z.object(SlotDeclarationShape);
-const SlotDeclarationInput = z.strictObject(SlotDeclarationShape);
+function validateOverflow(slot, ctx) {
+	if ((slot.type === "qr" || slot.type === "image") && slot.overflow !== "wrap") ctx.addIssue({
+		code: "custom",
+		path: ["overflow"],
+		message: `overflow cannot be declared for ${slot.type} slots`
+	});
+	if (slot.type === "qr" || slot.type === "image") {
+		if (slot.minSize !== void 0) ctx.addIssue({
+			code: "custom",
+			path: ["minSize"],
+			message: `minSize cannot be declared for ${slot.type} slots`
+		});
+	} else if (slot.overflow !== "shrink" && slot.minSize !== void 0) ctx.addIssue({
+		code: "custom",
+		path: ["minSize"],
+		message: "minSize can be declared only when overflow is shrink"
+	});
+}
+const withOverflowDefaults = (slot) => slot.overflow === "shrink" ? {
+	...slot,
+	minSize: slot.minSize ?? 6
+} : slot;
+const SlotDeclaration = z.object(SlotDeclarationShape).superRefine(validateOverflow).transform(withOverflowDefaults);
+const SlotDeclarationInput = z.strictObject(SlotDeclarationShape).superRefine(validateOverflow).transform(withOverflowDefaults);
 const Slots = z.array(SlotDeclaration).superRefine((slots, ctx) => {
 	const seen = /* @__PURE__ */ new Set();
 	slots.forEach((slot, index) => {
@@ -47,7 +77,7 @@ function mergeSlotDeclarations(...groups) {
 			merged.set(slot.key, slot);
 			continue;
 		}
-		if (previous.type !== slot.type || previous.required !== slot.required) throw new RangeError(`Slot "${slot.key}" has conflicting declarations: type ${previous.type}, required ${previous.required}; type ${slot.type}, required ${slot.required}.`);
+		if (previous.type !== slot.type || previous.required !== slot.required || (previous.overflow ?? "wrap") !== (slot.overflow ?? "wrap") || previous.minSize !== slot.minSize) throw new RangeError(`Slot "${slot.key}" has conflicting declarations: type ${previous.type}, required ${previous.required}, overflow ${previous.overflow ?? "wrap"}; type ${slot.type}, required ${slot.required}, overflow ${slot.overflow ?? "wrap"}.`);
 	}
 	return [...merged.values()];
 }

package/package.json

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