@segnavia/format 0.22.0 → 0.23.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/index.d.ts

@@ -17,7 +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, 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<{
@@ -250,7 +250,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 +258,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 +500,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 +508,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<{
@@ -628,7 +676,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 +684,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 +1058,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 +1066,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 +1103,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, 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/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,12 +172,23 @@ 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. */

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.23.0",
   "type": "module",
   "license": "MIT",
   "repository": {