@segnavia/format 0.21.0 → 0.23.0

package/dist/board.d.ts

@@ -4,10 +4,10 @@ export declare const BoardItem: z.ZodObject<{
   id: z.ZodString;
   kind: z.ZodEnum<{
     paper: "paper";
+    image: "image";
     page: "page";
     book: "book";
     shot: "shot";
-    image: "image";
     deck: "deck";
   }>;
   address: z.ZodString;
@@ -60,10 +60,10 @@ export declare const Board: z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodEnum<{
       paper: "paper";
+      image: "image";
       page: "page";
       book: "book";
       shot: "shot";
-      image: "image";
       deck: "deck";
     }>;
     address: z.ZodString;

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

@@ -122,5 +122,14 @@ export declare function deckFromSlides(rows: SlideRow[], options: DeckFromSlides
   } | undefined;
   playback?: "continuous" | "segmented" | undefined;
   captions?: "on" | "off" | "viewer" | undefined;
+  slots?: {
+    key: string;
+    label: string;
+    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,6 +438,43 @@ export declare const Deck: z.ZodObject<{
     off: "off";
     viewer: "viewer";
   }>>;
+  slots: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+      text: "text";
+      phone: "phone";
+      email: "email";
+      link: "link";
+      qr: "qr";
+      image: "image";
+    }>;
+    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" | "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/deck.js

@@ -1,5 +1,6 @@
 import { Direction } from "./direction.js";
 import { Scripts } from "./scripts.js";
+import { Slots } from "./slots.js";
 import { SlideTiming, slideTimingIssues } from "./timing.js";
 import { Transition } from "./transition.js";
 import { z } from "zod";
@@ -142,6 +143,7 @@ const DeckShape = z.object({
 		"off",
 		"viewer"
 	]).optional(),
+	slots: Slots.optional(),
 	slides: z.array(Slide).min(1)
 });
 function annotationCueIssues(narration, annotations) {

package/dist/index.d.ts

@@ -17,6 +17,7 @@ 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 { z } from "zod";
 //#region src/index.d.ts
 export declare const Margin: z.ZodObject<{
@@ -249,6 +250,43 @@ 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.ZodPipe<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+      text: "text";
+      phone: "phone";
+      email: "email";
+      link: "link";
+      qr: "qr";
+      image: "image";
+    }>;
+    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" | "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>;
@@ -462,6 +500,43 @@ export declare function jsonSchemas(): {
       safe: z.ZodDefault<z.ZodNumber>;
       marks: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+      key: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodEnum<{
+        text: "text";
+        phone: "phone";
+        email: "email";
+        link: "link";
+        qr: "qr";
+        image: "image";
+      }>;
+      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" | "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<{
@@ -601,6 +676,43 @@ export declare function jsonSchemas(): {
       off: "off";
       viewer: "viewer";
     }>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
+      key: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodEnum<{
+        text: "text";
+        phone: "phone";
+        email: "email";
+        link: "link";
+        qr: "qr";
+        image: "image";
+      }>;
+      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" | "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<{
@@ -822,10 +934,10 @@ export declare function jsonSchemas(): {
       id: z.ZodString;
       kind: z.ZodEnum<{
         paper: "paper";
+        image: "image";
         page: "page";
         book: "book";
         shot: "shot";
-        image: "image";
         deck: "deck";
       }>;
       address: z.ZodString;
@@ -946,6 +1058,80 @@ export declare function jsonSchemas(): {
       landscape: "landscape";
     }>;
   }, z.core.$strict>>;
+  slotDeclaration: z.core.ZodStandardJSONSchemaPayload<z.ZodPipe<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+      text: "text";
+      phone: "phone";
+      email: "email";
+      link: "link";
+      qr: "qr";
+      image: "image";
+    }>;
+    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" | "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<{
+      text: "text";
+      phone: "phone";
+      email: "email";
+      link: "link";
+      qr: "qr";
+      image: "image";
+    }>;
+    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.$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, 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, Scripts, Shot, type ShotUse, Size, Slide, SlideContent, type SlideRow, 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, 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, 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 };

package/dist/index.js

@@ -1,5 +1,6 @@
 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 { 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";
@@ -140,7 +141,8 @@ const Page = z.object({
 	scripts: Scripts.default("refuse"),
 	dir: Direction.optional(),
 	lang: z.string().optional(),
-	print: Print.optional()
+	print: Print.optional(),
+	slots: Slots.optional()
 });
 function jsonSchemas() {
 	return {
@@ -154,8 +156,10 @@ function jsonSchemas() {
 		publishedShot: z.toJSONSchema(PublishedShot, { io: "input" }),
 		board: z.toJSONSchema(Board, { io: "input" }),
 		printSetting: z.toJSONSchema(PrintSetting, { io: "input" }),
-		printSettingInput: z.toJSONSchema(PrintSettingInput, { io: "input" })
+		printSettingInput: z.toJSONSchema(PrintSettingInput, { io: "input" }),
+		slotDeclaration: z.toJSONSchema(SlotDeclaration, { io: "input" }),
+		slotDeclarationInput: z.toJSONSchema(SlotDeclarationInput, { io: "input" })
 	};
 }
 //#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, Scripts, Shot, Size, Slide, SlideContent, 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, 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_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 };

package/dist/slots.d.ts

@@ -0,0 +1,201 @@
+import { z } from "zod";
+//#region src/slots.d.ts
+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.ZodPipe<z.ZodObject<{
+  key: z.ZodString;
+  label: z.ZodString;
+  type: z.ZodEnum<{
+    text: "text";
+    phone: "phone";
+    email: "email";
+    link: "link";
+    qr: "qr";
+    image: "image";
+  }>;
+  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" | "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<{
+    text: "text";
+    phone: "phone";
+    email: "email";
+    link: "link";
+    qr: "qr";
+    image: "image";
+  }>;
+  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.$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.ZodPipe<z.ZodObject<{
+  key: z.ZodString;
+  label: z.ZodString;
+  type: z.ZodEnum<{
+    text: "text";
+    phone: "phone";
+    email: "email";
+    link: "link";
+    qr: "qr";
+    image: "image";
+  }>;
+  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" | "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.ZodPipe<z.ZodObject<{
+  key: z.ZodString;
+  label: z.ZodString;
+  type: z.ZodEnum<{
+    text: "text";
+    phone: "phone";
+    email: "email";
+    link: "link";
+    qr: "qr";
+    image: "image";
+  }>;
+  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.$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;
+};
+export interface Fill {
+  id: string;
+  label?: string;
+  values: Record<string, SlotValue>;
+}
+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. */
+  resolveAsset?: (ref: string, options: {
+    signal: AbortSignal;
+  }) => Promise<string>;
+  report?: (report: SlotReport) => void;
+}
+export declare function mergeSlotDeclarations(...groups: ReadonlyArray<readonly SlotDeclaration[]>): SlotDeclaration[];
+//#endregion

package/dist/slots.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+//#region src/slots.ts
+const SLOT_TYPES = [
+	"text",
+	"phone",
+	"email",
+	"link",
+	"qr",
+	"image"
+];
+const SlotType = z.enum(SLOT_TYPES);
+const SlotDeclarationShape = {
+	key: z.string().regex(/^[^.\s]+(?:\.[^.\s]+)*$/, "a slot key must be a dotted path"),
+	label: z.string().min(1),
+	type: SlotType,
+	required: z.boolean().default(false),
+	placeholder: z.string().optional(),
+	overflow: z.enum([
+		"shrink",
+		"truncate",
+		"wrap",
+		"refuse"
+	]).default("wrap"),
+	minSize: z.number().positive().finite().optional()
+};
+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) => {
+		if (seen.has(slot.key)) ctx.addIssue({
+			code: "custom",
+			path: [index, "key"],
+			message: `slot key "${slot.key}" is used twice`
+		});
+		seen.add(slot.key);
+	});
+});
+const SlotsInput = z.array(SlotDeclarationInput).superRefine((slots, ctx) => {
+	const seen = /* @__PURE__ */ new Set();
+	slots.forEach((slot, index) => {
+		if (seen.has(slot.key)) ctx.addIssue({
+			code: "custom",
+			path: [index, "key"],
+			message: `slot key "${slot.key}" is used twice`
+		});
+		seen.add(slot.key);
+	});
+});
+function mergeSlotDeclarations(...groups) {
+	const merged = /* @__PURE__ */ new Map();
+	for (const slot of groups.flat()) {
+		const previous = merged.get(slot.key);
+		if (!previous) {
+			merged.set(slot.key, slot);
+			continue;
+		}
+		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()];
+}
+//#endregion
+export { SLOT_TYPES, SlotDeclaration, SlotDeclarationInput, SlotType, Slots, SlotsInput, mergeSlotDeclarations };

package/package.json

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