@segnavia/format 0.21.0 → 0.22.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,12 @@ 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" | "image";
+    required: boolean;
+    placeholder?: string | undefined;
+  }[] | undefined;
 };
 //#endregion

package/dist/deck.d.ts

@@ -438,6 +438,19 @@ export declare const Deck: z.ZodObject<{
     off: "off";
     viewer: "viewer";
   }>>;
+  slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+      text: "text";
+      phone: "phone";
+      email: "email";
+      link: "link";
+      image: "image";
+    }>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    placeholder: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
   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, 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,19 @@ 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<{
+    key: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+      text: "text";
+      phone: "phone";
+      email: "email";
+      link: "link";
+      image: "image";
+    }>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    placeholder: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type Page = z.infer<typeof Page>;
 export type PageInput = z.input<typeof Page>;
@@ -462,6 +476,19 @@ export declare function jsonSchemas(): {
       safe: z.ZodDefault<z.ZodNumber>;
       marks: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodEnum<{
+        text: "text";
+        phone: "phone";
+        email: "email";
+        link: "link";
+        image: "image";
+      }>;
+      required: z.ZodDefault<z.ZodBoolean>;
+      placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
   lexicon: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
     entries: z.ZodArray<z.ZodObject<{
@@ -601,6 +628,19 @@ export declare function jsonSchemas(): {
       off: "off";
       viewer: "viewer";
     }>>;
+    slots: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodEnum<{
+        text: "text";
+        phone: "phone";
+        email: "email";
+        link: "link";
+        image: "image";
+      }>;
+      required: z.ZodDefault<z.ZodBoolean>;
+      placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     slides: z.ZodArray<z.ZodObject<{
       id: z.ZodString;
       content: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -822,10 +862,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 +986,32 @@ export declare function jsonSchemas(): {
       landscape: "landscape";
     }>;
   }, z.core.$strict>>;
+  slotDeclaration: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+      text: "text";
+      phone: "phone";
+      email: "email";
+      link: "link";
+      image: "image";
+    }>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    placeholder: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  slotDeclarationInput: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    type: z.ZodEnum<{
+      text: "text";
+      phone: "phone";
+      email: "email";
+      link: "link";
+      image: "image";
+    }>;
+    required: z.ZodDefault<z.ZodBoolean>;
+    placeholder: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>;
 };
 //#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, 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,91 @@
+import { z } from "zod";
+//#region src/slots.d.ts
+export declare const SLOT_TYPES: readonly ["text", "phone", "email", "link", "image"];
+export declare const SlotType: z.ZodEnum<{
+  text: "text";
+  phone: "phone";
+  email: "email";
+  link: "link";
+  image: "image";
+}>;
+export type SlotType = z.infer<typeof SlotType>;
+export declare const SlotDeclaration: z.ZodObject<{
+  key: z.ZodString;
+  label: z.ZodString;
+  type: z.ZodEnum<{
+    text: "text";
+    phone: "phone";
+    email: "email";
+    link: "link";
+    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<{
+  key: z.ZodString;
+  label: z.ZodString;
+  type: z.ZodEnum<{
+    text: "text";
+    phone: "phone";
+    email: "email";
+    link: "link";
+    image: "image";
+  }>;
+  required: z.ZodDefault<z.ZodBoolean>;
+  placeholder: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SlotDeclarationInput = z.input<typeof SlotDeclarationInput>;
+export declare const Slots: z.ZodArray<z.ZodObject<{
+  key: z.ZodString;
+  label: z.ZodString;
+  type: z.ZodEnum<{
+    text: "text";
+    phone: "phone";
+    email: "email";
+    link: "link";
+    image: "image";
+  }>;
+  required: z.ZodDefault<z.ZodBoolean>;
+  placeholder: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export type Slots = z.infer<typeof Slots>;
+export declare const SlotsInput: z.ZodArray<z.ZodObject<{
+  key: z.ZodString;
+  label: z.ZodString;
+  type: z.ZodEnum<{
+    text: "text";
+    phone: "phone";
+    email: "email";
+    link: "link";
+    image: "image";
+  }>;
+  required: z.ZodDefault<z.ZodBoolean>;
+  placeholder: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+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 type SlotState = 'filled' | 'placeholder' | 'unavailable' | 'invalid';
+export interface SlotReport {
+  fill: string | null;
+  slots: Record<string, SlotState>;
+}
+export interface SlotsOptions {
+  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,55 @@
+import { z } from "zod";
+//#region src/slots.ts
+const SLOT_TYPES = [
+	"text",
+	"phone",
+	"email",
+	"link",
+	"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()
+};
+const SlotDeclaration = z.object(SlotDeclarationShape);
+const SlotDeclarationInput = z.strictObject(SlotDeclarationShape);
+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) throw new RangeError(`Slot "${slot.key}" has conflicting declarations: type ${previous.type}, required ${previous.required}; type ${slot.type}, required ${slot.required}.`);
+	}
+	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.22.0",
   "type": "module",
   "license": "MIT",
   "repository": {