@segnavia/format 0.15.0 → 0.17.0

package/dist/board-section-constants.d.ts

@@ -0,0 +1,10 @@
+//#region src/board-section-constants.d.ts
+export declare const SECTION_PADDING = 24;
+export declare const SECTION_TITLE_ROOM = 32;
+export declare const SECTION_MIN_SIZE: {
+  readonly width: 240;
+  readonly height: 160;
+};
+export declare const SECTION_GAP = 16;
+export declare const MAKE_ROOM_LIMIT = 50;
+//#endregion

package/dist/board-section-constants.js

@@ -0,0 +1,11 @@
+//#region src/board-section-constants.ts
+const SECTION_PADDING = 24;
+const SECTION_TITLE_ROOM = 32;
+const SECTION_MIN_SIZE = {
+	width: 240,
+	height: 160
+};
+const SECTION_GAP = 16;
+const MAKE_ROOM_LIMIT = 50;
+//#endregion
+export { MAKE_ROOM_LIMIT, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM };

package/dist/board-section-grid.d.ts

@@ -0,0 +1,20 @@
+import { Board, GridCell } from "./board.js";
+import { Box, Point } from "./deck.js";
+import { BoardShapes } from "./board-geometry.js";
+//#region src/board-section-grid.d.ts
+export type GridDropTarget = {
+  anchor: string;
+  side: 'before' | 'after';
+  axis: 'row' | 'column';
+} | {
+  row: number;
+  column: number;
+  axis: 'cell';
+};
+export declare function deriveSectionCells(board: Board, shapes: BoardShapes, id: string): GridCell[];
+export declare function layoutSection(board: Board, shapes: BoardShapes, id: string): Board;
+export declare function gridDropTarget(board: Board, shapes: BoardShapes, id: string, point: Point): GridDropTarget | undefined;
+export declare function gridDropMarkerBox(board: Board, shapes: BoardShapes, id: string, target: GridDropTarget): Box | undefined;
+export declare function removeFromGrid(board: Board, shapes: BoardShapes, ids: readonly string[]): Board;
+export declare function insertIntoGrid(board: Board, shapes: BoardShapes, id: string, ids: readonly string[], target: GridDropTarget): Board;
+//#endregion

package/dist/board-section-grid.js

@@ -0,0 +1,353 @@
+import { itemHeight } from "./board-geometry.js";
+import { SECTION_MIN_SIZE } from "./board-section-constants.js";
+//#region src/board-section-grid.ts
+function sectionOf(board, id) {
+	return board.sections.find((section) => section.id === id);
+}
+function dimensions(board, shapes, id) {
+	const item = board.items.find((entry) => entry.id === id);
+	const shape = shapes.items[id];
+	if (!item || !shape) throw new Error(`item "${id}" has no supplied shape; supply shapes.items["${id}"]`);
+	return {
+		width: item.width,
+		height: itemHeight(item, shape)
+	};
+}
+function deriveSectionCells(board, shapes, id) {
+	const section = sectionOf(board, id);
+	if (!section) return [];
+	const direction = board.direction === "rtl" ? -1 : 1;
+	const members = section.items.map((member) => {
+		const item = board.items.find((entry) => entry.id === member);
+		if (!item) return void 0;
+		return {
+			id: member,
+			x: item.x,
+			y: item.y,
+			bottom: item.y + dimensions(board, shapes, member).height
+		};
+	}).filter((item) => item !== void 0).sort((a, b) => a.y - b.y || direction * (a.x - b.x));
+	const cells = [];
+	let row = -1;
+	let bottom = Number.NEGATIVE_INFINITY;
+	let column = 0;
+	for (const member of members) {
+		if (row < 0 || member.y > bottom) {
+			row += 1;
+			column = 0;
+			bottom = member.bottom;
+		} else bottom = Math.max(bottom, member.bottom);
+		cells.push({
+			id: member.id,
+			row,
+			column
+		});
+		column += 1;
+	}
+	return cells;
+}
+function cellsFor(board, shapes, section) {
+	const members = new Set(section.items);
+	return section.cells?.filter((cell) => members.has(cell.id)).map((cell) => ({ ...cell })) ?? deriveSectionCells(board, shapes, section.id);
+}
+function normalized(cells) {
+	const rows = [...new Set(cells.map((cell) => cell.row))].sort((a, b) => a - b);
+	const columns = [...new Set(cells.map((cell) => cell.column))].sort((a, b) => a - b);
+	const rowIndex = new Map(rows.map((value, index) => [value, index]));
+	const columnIndex = new Map(columns.map((value, index) => [value, index]));
+	return cells.map((cell) => ({
+		...cell,
+		row: rowIndex.get(cell.row) ?? 0,
+		column: columnIndex.get(cell.column) ?? 0
+	})).sort((a, b) => a.row - b.row || a.column - b.column);
+}
+function trackSizes(board, shapes, cells) {
+	const widths = Array.from({ length: Math.max(0, ...cells.map((cell) => cell.column + 1)) }, () => 0);
+	const heights = Array.from({ length: Math.max(0, ...cells.map((cell) => cell.row + 1)) }, () => 0);
+	for (const cell of cells) {
+		const size = dimensions(board, shapes, cell.id);
+		widths[cell.column] = Math.max(widths[cell.column] ?? 0, size.width);
+		heights[cell.row] = Math.max(heights[cell.row] ?? 0, size.height);
+	}
+	return {
+		widths,
+		heights
+	};
+}
+function starts(sizes) {
+	const result = [];
+	let value = 0;
+	for (const size of sizes) {
+		result.push(value);
+		value += size + 16;
+	}
+	return result;
+}
+function span(sizes) {
+	return sizes.reduce((sum, size) => sum + size, 0) + 16 * Math.max(0, sizes.length - 1);
+}
+function sectionGrid(board, shapes, section) {
+	const cells = normalized(cellsFor(board, shapes, section));
+	const { widths, heights } = trackSizes(board, shapes, cells);
+	return {
+		cells,
+		widths,
+		heights,
+		columnStarts: starts(widths),
+		rowStarts: starts(heights),
+		width: span(widths),
+		height: span(heights),
+		innerX: section.rectangle.x + 24,
+		innerY: section.rectangle.y + 24 + 32
+	};
+}
+function physicalX(board, grid, logicalStart, width) {
+	return board.direction === "rtl" ? grid.innerX + grid.width - logicalStart - width : grid.innerX + logicalStart;
+}
+function layoutSection(board, shapes, id) {
+	const section = sectionOf(board, id);
+	if (!section || section.layout === "manual") return board;
+	if (section.items.length === 0) return {
+		...board,
+		sections: board.sections.map((entry) => entry.id === id ? {
+			...entry,
+			cells: [],
+			rectangle: {
+				...entry.rectangle,
+				...SECTION_MIN_SIZE
+			}
+		} : entry)
+	};
+	const grid = sectionGrid(board, shapes, section);
+	const { cells } = grid;
+	const positions = /* @__PURE__ */ new Map();
+	for (const cell of cells) {
+		const width = dimensions(board, shapes, cell.id).width;
+		positions.set(cell.id, {
+			x: physicalX(board, grid, grid.columnStarts[cell.column] ?? 0, width),
+			y: grid.innerY + (grid.rowStarts[cell.row] ?? 0)
+		});
+	}
+	return {
+		...board,
+		items: board.items.map((item) => {
+			const position = positions.get(item.id);
+			return position ? {
+				...item,
+				...position
+			} : item;
+		}),
+		sections: board.sections.map((entry) => entry.id === id ? {
+			...entry,
+			cells,
+			items: cells.map((cell) => cell.id),
+			rectangle: {
+				...entry.rectangle,
+				width: grid.width + 48,
+				height: grid.height + 48 + 32
+			}
+		} : entry)
+	};
+}
+function trackAt(value, sizes, offsets) {
+	if (value <= 0) return {
+		index: 0,
+		gap: false
+	};
+	for (let index = 0; index < sizes.length; index += 1) {
+		const end = (offsets[index] ?? 0) + (sizes[index] ?? 0);
+		if (value <= end) return {
+			index,
+			gap: false
+		};
+		if (index < sizes.length - 1 && value < end + 16) return {
+			index: index + 1,
+			gap: true
+		};
+	}
+	return {
+		index: Math.max(0, sizes.length - 1),
+		gap: false
+	};
+}
+function gridDropTarget(board, shapes, id, point) {
+	const section = sectionOf(board, id);
+	if (!section || section.layout === "manual") return void 0;
+	const box = section.rectangle;
+	if (point.x < box.x || point.x > box.x + box.width || point.y < box.y || point.y > box.y + box.height) return void 0;
+	const grid = sectionGrid(board, shapes, section);
+	const { cells } = grid;
+	if (cells.length === 0) return {
+		row: 0,
+		column: 0,
+		axis: "cell"
+	};
+	const xOffsets = grid.columnStarts;
+	const yOffsets = grid.rowStarts;
+	const fromStart = point.x - grid.innerX;
+	const x = board.direction === "rtl" ? grid.width - fromStart : fromStart;
+	const y = point.y - grid.innerY;
+	const columnTrack = trackAt(x, grid.widths, xOffsets);
+	const rowTrack = trackAt(y, grid.heights, yOffsets);
+	if (columnTrack.gap) return targetAtGap(cells, rowTrack.index, columnTrack.index, "row");
+	if (rowTrack.gap) return targetAtGap(cells, rowTrack.index, columnTrack.index, "column");
+	const cell = cells.find((entry) => entry.row === rowTrack.index && entry.column === columnTrack.index);
+	if (!cell) return {
+		row: rowTrack.index,
+		column: columnTrack.index,
+		axis: "cell"
+	};
+	const size = dimensions(board, shapes, cell.id);
+	const localX = x - (xOffsets[cell.column] ?? 0);
+	const localY = y - (yOffsets[cell.row] ?? 0);
+	return [
+		{
+			distance: Math.abs(localX),
+			target: {
+				anchor: cell.id,
+				side: "before",
+				axis: "row"
+			}
+		},
+		{
+			distance: Math.abs(size.width - localX),
+			target: {
+				anchor: cell.id,
+				side: "after",
+				axis: "row"
+			}
+		},
+		{
+			distance: Math.abs(localY),
+			target: {
+				anchor: cell.id,
+				side: "before",
+				axis: "column"
+			}
+		},
+		{
+			distance: Math.abs(size.height - localY),
+			target: {
+				anchor: cell.id,
+				side: "after",
+				axis: "column"
+			}
+		}
+	].reduce((best, edge) => edge.distance < best.distance ? edge : best).target;
+}
+function targetAtGap(cells, row, column, axis) {
+	const track = cells.filter((cell) => axis === "row" ? cell.row === row : cell.column === column).sort((a, b) => axis === "row" ? a.column - b.column : a.row - b.row);
+	const coordinate = axis === "row" ? column : row;
+	const after = track.find((cell) => (axis === "row" ? cell.column : cell.row) >= coordinate);
+	if (after) return {
+		anchor: after.id,
+		side: "before",
+		axis
+	};
+	const before = track.at(-1);
+	return before ? {
+		anchor: before.id,
+		side: "after",
+		axis
+	} : void 0;
+}
+function gridDropMarkerBox(board, shapes, id, target) {
+	const section = sectionOf(board, id);
+	if (!section || section.layout === "manual") return void 0;
+	const grid = sectionGrid(board, shapes, section);
+	const { innerX, innerY } = grid;
+	if (grid.cells.length === 0) return {
+		x: innerX,
+		y: innerY,
+		width: Math.max(0, section.rectangle.width - 48),
+		height: Math.max(0, section.rectangle.height - 48 - 32)
+	};
+	const cell = target.axis === "cell" ? target : grid.cells.find((entry) => entry.id === target.anchor);
+	if (!cell) return void 0;
+	const columnStart = grid.columnStarts[cell.column] ?? grid.width;
+	const rowStart = grid.rowStarts[cell.row] ?? grid.height;
+	const width = grid.widths[cell.column] ?? 0;
+	const height = grid.heights[cell.row] ?? 0;
+	const x = physicalX(board, grid, columnStart, width);
+	const y = innerY + rowStart;
+	if (target.axis === "cell") return {
+		x,
+		y,
+		width,
+		height
+	};
+	if (target.axis === "row") return {
+		x: physicalX(board, grid, columnStart + (target.side === "after" ? width : 0), 0),
+		y,
+		width: 2,
+		height
+	};
+	return {
+		x,
+		y: y + (target.side === "after" ? height : 0),
+		width,
+		height: 2
+	};
+}
+function updateSection(section, cells) {
+	const next = normalized(cells);
+	return {
+		...section,
+		cells: next,
+		items: next.map((cell) => cell.id)
+	};
+}
+function removeFromGrid(board, shapes, ids) {
+	const removed = new Set(ids);
+	return {
+		...board,
+		sections: board.sections.map((section) => {
+			if (section.layout === "manual") return {
+				...section,
+				items: section.items.filter((id) => !removed.has(id))
+			};
+			const cells = cellsFor(board, shapes, section);
+			const removedCells = cells.filter((cell) => removed.has(cell.id));
+			return updateSection(section, cells.filter((cell) => !removed.has(cell.id)).map((cell) => ({
+				...cell,
+				column: cell.column - removedCells.filter((gone) => gone.row === cell.row && gone.column < cell.column).length
+			})));
+		})
+	};
+}
+function insertIntoGrid(board, shapes, id, ids, target) {
+	const unique = ids.filter((member, index) => ids.indexOf(member) === index);
+	const moved = new Set(unique);
+	if (target.axis !== "cell" && moved.has(target.anchor)) return board;
+	const removed = removeFromGrid(board, shapes, unique);
+	const section = sectionOf(removed, id);
+	if (!section || section.layout === "manual") return removed;
+	const cells = [...section.cells ?? []];
+	const anchor = target.axis === "cell" ? void 0 : cells.find((cell) => cell.id === target.anchor);
+	if (target.axis !== "cell" && !anchor) return removed;
+	const axis = target.axis === "cell" ? "row" : target.axis;
+	const row = target.axis === "cell" ? target.row : (anchor?.row ?? 0) + (axis === "column" && target.side === "after" ? 1 : 0);
+	const column = target.axis === "cell" ? target.column : (anchor?.column ?? 0) + (axis === "row" && target.side === "after" ? 1 : 0);
+	const inserted = unique.map((member, index) => ({
+		id: member,
+		row: row + (axis === "column" ? index : 0),
+		column: column + (axis === "row" ? index : 0)
+	}));
+	const shifted = inserted.some((placement) => cells.some((cell) => cell.row === placement.row && cell.column === placement.column)) ? cells.map((cell) => {
+		if (axis === "row" && cell.row === row && cell.column >= column) return {
+			...cell,
+			column: cell.column + unique.length
+		};
+		if (axis === "column" && cell.column === column && cell.row >= row) return {
+			...cell,
+			row: cell.row + unique.length
+		};
+		return cell;
+	}) : cells;
+	return {
+		...removed,
+		sections: removed.sections.map((entry) => entry.id === id ? updateSection(entry, [...shifted, ...inserted]) : entry)
+	};
+}
+//#endregion
+export { deriveSectionCells, gridDropMarkerBox, gridDropTarget, insertIntoGrid, layoutSection, removeFromGrid };

package/dist/board-sections.d.ts

@@ -1,18 +1,12 @@
 import { Board, BoardSection } from "./board.js";
 import { Point } from "./deck.js";
 import { BoardShapes } from "./board-geometry.js";
+import { MAKE_ROOM_LIMIT, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM } from "./board-section-constants.js";
 //#region src/board-sections.d.ts
-export declare const SECTION_PADDING = 24;
-export declare const SECTION_TITLE_ROOM = 32;
-export declare const SECTION_MIN_SIZE: {
-  readonly width: 240;
-  readonly height: 160;
-};
-export declare const SECTION_GAP = 16;
-export declare const MAKE_ROOM_LIMIT = 50;
 export declare function fitSection(board: Board, shapes: BoardShapes, sectionId: string): Board;
 export declare function assignMembership(board: Board, shapes: BoardShapes, ids: readonly string[], point: Point, startingSections?: readonly BoardSection[]): Board;
 export declare function makeRoom(board: Board, shapes: BoardShapes, changed: readonly string[]): Board;
 export declare function fitTouchedSections(previous: Board, board: Board, shapes: BoardShapes, touched: readonly string[]): Board;
 export declare function settleBoard(previous: Board, board: Board, shapes: BoardShapes, touched: readonly string[]): Board;
-//#endregion
+//#endregion
+export { MAKE_ROOM_LIMIT, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM };

package/dist/board-sections.js

@@ -1,14 +1,8 @@
 import { moveItems, moveSection } from "./board-edit.js";
 import { itemHeight } from "./board-geometry.js";
+import { MAKE_ROOM_LIMIT, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM } from "./board-section-constants.js";
+import { layoutSection } from "./board-section-grid.js";
 //#region src/board-sections.ts
-const SECTION_PADDING = 24;
-const SECTION_TITLE_ROOM = 32;
-const SECTION_MIN_SIZE = {
-	width: 240,
-	height: 160
-};
-const SECTION_GAP = 16;
-const MAKE_ROOM_LIMIT = 50;
 function itemRectangle(board, shapes, id) {
 	const item = board.items.find((entry) => entry.id === id);
 	if (!item) return void 0;
@@ -197,10 +191,14 @@ function touchedSections(previous, board, touched) {
 	return [...previous.sections, ...board.sections].filter((section) => touchedIds.has(section.id) || section.items.some((id) => touchedIds.has(id))).map((section) => section.id).filter((id, index, ids) => ids.indexOf(id) === index);
 }
 function fitSections(board, shapes, sectionIds) {
-	return sectionIds.reduce((value, id) => fitSection(value, shapes, id), board);
+	return sectionIds.reduce((value, id) => {
+		return value.sections.find((entry) => entry.id === id)?.layout === "manual" ? fitSection(value, shapes, id) : layoutSection(value, shapes, id);
+	}, board);
 }
 function fitTouchedSections(previous, board, shapes, touched) {
-	return fitSections(board, shapes, touchedSections(previous, board, touched));
+	return touchedSections(previous, board, touched).reduce((value, id) => {
+		return value.sections.find((entry) => entry.id === id)?.layout === "manual" ? fitSection(value, shapes, id) : value;
+	}, board);
 }
 function settleBoard(previous, board, shapes, touched) {
 	const sectionIds = touchedSections(previous, board, touched);

package/dist/board.d.ts

@@ -23,6 +23,12 @@ export declare const BoardLabel: z.ZodObject<{
   y: z.ZodNumber;
 }, z.core.$strip>;
 export type BoardLabel = z.infer<typeof BoardLabel>;
+export declare const GridCell: z.ZodObject<{
+  id: z.ZodString;
+  row: z.ZodNumber;
+  column: z.ZodNumber;
+}, z.core.$strip>;
+export type GridCell = z.infer<typeof GridCell>;
 export declare const BoardSection: z.ZodObject<{
   id: z.ZodString;
   title: z.ZodString;
@@ -33,6 +39,15 @@ export declare const BoardSection: z.ZodObject<{
     height: z.ZodNumber;
   }, z.core.$strip>;
   items: z.ZodArray<z.ZodString>;
+  layout: z.ZodOptional<z.ZodEnum<{
+    auto: "auto";
+    manual: "manual";
+  }>>;
+  cells: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    row: z.ZodNumber;
+    column: z.ZodNumber;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type BoardSection = z.infer<typeof BoardSection>;
 export declare const Board: z.ZodObject<{
@@ -72,6 +87,15 @@ export declare const Board: z.ZodObject<{
       height: z.ZodNumber;
     }, z.core.$strip>;
     items: z.ZodArray<z.ZodString>;
+    layout: z.ZodOptional<z.ZodEnum<{
+      auto: "auto";
+      manual: "manual";
+    }>>;
+    cells: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      row: z.ZodNumber;
+      column: z.ZodNumber;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Board = z.infer<typeof Board>;

package/dist/board.js

@@ -24,11 +24,18 @@ const BoardLabel = z.object({
 	x: z.number(),
 	y: z.number()
 });
+const GridCell = z.object({
+	id: z.string(),
+	row: z.number(),
+	column: z.number()
+});
 const BoardSection = z.object({
 	id: z.string(),
 	title: z.string(),
 	rectangle: Box,
-	items: z.array(z.string())
+	items: z.array(z.string()),
+	layout: z.enum(["auto", "manual"]).optional(),
+	cells: z.array(GridCell).optional()
 });
 const Board = z.object({
 	title: z.string(),
@@ -69,7 +76,51 @@ const Board = z.object({
 				message: `section member "${id}" is not a board item id; use the id of an existing item`
 			});
 		});
+		if (section.layout === "manual" || !section.cells) return;
+		const members = new Set(section.items);
+		const positions = /* @__PURE__ */ new Set();
+		const cellIds = /* @__PURE__ */ new Set();
+		section.cells.forEach((cell, cellIndex) => {
+			const path = [
+				"sections",
+				sectionIndex,
+				"cells",
+				cellIndex
+			];
+			if (!members.has(cell.id)) ctx.addIssue({
+				code: "custom",
+				path,
+				message: `section "${section.id}" cell "${cell.id}" is not a member; use the id of a section member`
+			});
+			if (!Number.isInteger(cell.row) || cell.row < 0 || !Number.isInteger(cell.column) || cell.column < 0) ctx.addIssue({
+				code: "custom",
+				path,
+				message: `section "${section.id}" cell "${cell.id}" has an invalid track index; use non-negative integer row and column indexes`
+			});
+			const position = `${cell.row}:${cell.column}`;
+			if (positions.has(position)) ctx.addIssue({
+				code: "custom",
+				path,
+				message: `section "${section.id}" cell "${cell.id}" shares position (${cell.row}, ${cell.column}); give every cell a unique position`
+			});
+			positions.add(position);
+			if (cellIds.has(cell.id)) ctx.addIssue({
+				code: "custom",
+				path,
+				message: `section "${section.id}" cell "${cell.id}" is duplicated; provide exactly one cell for each member`
+			});
+			cellIds.add(cell.id);
+		});
+		for (const id of section.items) if (!cellIds.has(id)) ctx.addIssue({
+			code: "custom",
+			path: [
+				"sections",
+				sectionIndex,
+				"cells"
+			],
+			message: `section "${section.id}" member "${id}" has no cell; add one cell for every member`
+		});
 	});
 });
 //#endregion
-export { Board, BoardItem, BoardLabel, BoardSection };
+export { Board, BoardItem, BoardLabel, BoardSection, GridCell };

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

@@ -119,7 +119,7 @@ export declare function deckFromSlides(rows: SlideRow[], options: DeckFromSlides
     kind: "none" | "fade" | "slide";
     duration: number;
   } | undefined;
-  playback?: "continuous" | "step" | undefined;
+  playback?: "continuous" | "segmented" | undefined;
   captions?: "on" | "off" | "viewer" | undefined;
 };
 //#endregion

package/dist/deck.d.ts

@@ -385,6 +385,13 @@ export declare const DECK_SIZE: {
   readonly width: 1280;
   readonly height: 720;
 };
+export declare const PLAYBACK_MODES: readonly ["segmented", "continuous"];
+export type PlaybackMode = (typeof PLAYBACK_MODES)[number];
+export declare const Playback: z.ZodUnion<readonly [z.ZodEnum<{
+  continuous: "continuous";
+  segmented: "segmented";
+}>, z.ZodPipe<z.ZodLiteral<"step">, z.ZodTransform<"continuous" | "segmented", "step">>]>;
+export declare function parsePlayback(value: unknown): PlaybackMode | undefined;
 export declare function annotationCueIssues(narration: Slide['narration'], annotations: number): string[];
 export declare const Deck: z.ZodObject<{
   title: z.ZodString;
@@ -421,10 +428,10 @@ export declare const Deck: z.ZodObject<{
     }>;
     duration: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>>;
-  playback: z.ZodOptional<z.ZodEnum<{
+  playback: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
     continuous: "continuous";
-    step: "step";
-  }>>;
+    segmented: "segmented";
+  }>, z.ZodPipe<z.ZodLiteral<"step">, z.ZodTransform<"continuous" | "segmented", "step">>]>>;
   captions: z.ZodOptional<z.ZodEnum<{
     on: "on";
     off: "off";

package/dist/deck.js

@@ -119,6 +119,12 @@ const DECK_SIZE = {
 	width: 1280,
 	height: 720
 };
+const PLAYBACK_MODES = ["segmented", "continuous"];
+const Playback = z.union([z.enum(PLAYBACK_MODES), z.literal("step").transform(() => "segmented")]);
+function parsePlayback(value) {
+	const parsed = Playback.safeParse(value);
+	return parsed.success ? parsed.data : void 0;
+}
 const DeckShape = z.object({
 	title: z.string(),
 	size: Size.default(DECK_SIZE),
@@ -129,7 +135,7 @@ const DeckShape = z.object({
 	dir: Direction.optional(),
 	lang: z.string().optional(),
 	transition: Transition.optional(),
-	playback: z.enum(["step", "continuous"]).optional(),
+	playback: Playback.optional(),
 	captions: z.enum([
 		"on",
 		"off",
@@ -208,4 +214,4 @@ function exceedsLimits(deck, limits) {
 	return reasons;
 }
 //#endregion
-export { Annotation, Box, Cue, DECK_SIZE, Deck, DeckShape, ImageFit, Manifest, Narration, Point, PublishedShot, SHOT_KEY, Shot, Size, Slide, SlideContent, Word, annotationCueIssues, exceedsLimits };
+export { 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 };

package/dist/index.d.ts

@@ -1,9 +1,11 @@
-import { Board, BoardInput, BoardItem, BoardLabel, BoardSection } from "./board.js";
-import { Annotation, Box, Cue, DECK_SIZE, Deck, DeckInput, DeckLimits, ImageFit, Manifest, Narration, Point, PublishedShot, SHOT_KEY, Shot, Size, Slide, SlideContent, Word, annotationCueIssues, exceedsLimits } from "./deck.js";
+import { Board, BoardInput, BoardItem, BoardLabel, BoardSection, GridCell } from "./board.js";
+import { Annotation, Box, Cue, DECK_SIZE, Deck, DeckInput, DeckLimits, ImageFit, Manifest, Narration, PLAYBACK_MODES, Playback, PlaybackMode, Point, PublishedShot, SHOT_KEY, Shot, Size, Slide, SlideContent, Word, annotationCueIssues, exceedsLimits, parsePlayback } from "./deck.js";
 import { BoardItemAnchor, MIN_BOARD_ITEM_WIDTH, addItem, moveItems, moveSection, removeItems, resizeItem } from "./board-edit.js";
 import { ArrangeOptions, BoardShapes, BoardView, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, ZoomBounds, arrange, boardBounds, boardToScreen, itemAt, itemHeight, revealView, screenToBoard, visibleItems, zoomAt, zoomToFit } from "./board-geometry.js";
 import { BoardListingGroup, boardListing, boardListingIsEmpty, foldForSearch, nameMatches } from "./board-listing.js";
-import { MAKE_ROOM_LIMIT, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, assignMembership, fitSection, fitTouchedSections, makeRoom, settleBoard } from "./board-sections.js";
+import { GridDropTarget, deriveSectionCells, gridDropMarkerBox, gridDropTarget, insertIntoGrid, layoutSection, removeFromGrid } from "./board-section-grid.js";
+import { MAKE_ROOM_LIMIT, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM } from "./board-section-constants.js";
+import { assignMembership, fitSection, fitTouchedSections, makeRoom, settleBoard } from "./board-sections.js";
 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";
@@ -462,10 +464,10 @@ export declare function jsonSchemas(): {
       }>;
       duration: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
-    playback: z.ZodOptional<z.ZodEnum<{
+    playback: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
       continuous: "continuous";
-      step: "step";
-    }>>;
+      segmented: "segmented";
+    }>, z.ZodPipe<z.ZodLiteral<"step">, z.ZodTransform<"continuous" | "segmented", "step">>]>>;
     captions: z.ZodOptional<z.ZodEnum<{
       on: "on";
       off: "off";
@@ -718,8 +720,17 @@ export declare function jsonSchemas(): {
         height: z.ZodNumber;
       }, z.core.$strip>;
       items: z.ZodArray<z.ZodString>;
+      layout: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        manual: "manual";
+      }>>;
+      cells: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        row: z.ZodNumber;
+        column: z.ZodNumber;
+      }, z.core.$strip>>>;
     }, z.core.$strip>>;
   }, z.core.$strip>>;
 };
 //#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, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, type DeckFromSlidesOptions, type DeckInput, type DeckLimits, Direction, 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, Narration, NoteMarker, NumberSystem, PAPER_MM, PX_PER_MM, type PageFit, type PagePlacementKind, type PagePlacementLayout, Paper, type PaperBox, type Placement, Point, 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, exceedsLimits, firstStrongDirection, fitPage, fitSection, fitTouchedSections, foldForSearch, formatNumber, impose, isBookContents, isHebrew, itemAt, itemHeight, languageDirection, lexiconVersion, makeRoom, mirrorPlacement, moveItems, moveSection, nameMatches, noteMarker, noteMarkerIssues, pagePlacementLayout, printBoxes, printPadding, printProperties, 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, 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, Narration, NoteMarker, NumberSystem, PAPER_MM, PLAYBACK_MODES, PX_PER_MM, type PageFit, type PagePlacementKind, type PagePlacementLayout, Paper, type PaperBox, type Placement, Playback, type PlaybackMode, Point, 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, 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 };

package/dist/index.js

@@ -2,8 +2,8 @@ import { Direction, TextDirection, firstStrongDirection, languageDirection, reso
 import { Scripts } from "./scripts.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, Point, PublishedShot, SHOT_KEY, Shot, Size, Slide, SlideContent, Word, annotationCueIssues, exceedsLimits } from "./deck.js";
-import { Board, BoardItem, BoardLabel, BoardSection } from "./board.js";
+import { Annotation, Box, Cue, DECK_SIZE, Deck, DeckShape, ImageFit, Manifest, Narration, PLAYBACK_MODES, Playback, Point, PublishedShot, SHOT_KEY, Shot, Size, Slide, SlideContent, Word, annotationCueIssues, exceedsLimits, parsePlayback } from "./deck.js";
+import { Board, BoardItem, BoardLabel, BoardSection, GridCell } from "./board.js";
 import { NoteMarker, NumberSystem, formatNumber, noteMarker } from "./numbering.js";
 import { MARK_GAP_MM, MARK_LENGTH_MM, MM_PER_PT, NAMED_PAPERS, PAPER_MM, PX_PER_MM, Paper, 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";
@@ -11,7 +11,9 @@ import { Lexicon, PronunciationEntry, lexiconVersion } from "./lexicon.js";
 import { MIN_BOARD_ITEM_WIDTH, addItem, moveItems, moveSection, removeItems, resizeItem } from "./board-edit.js";
 import { MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, arrange, boardBounds, boardToScreen, itemAt, itemHeight, revealView, screenToBoard, visibleItems, zoomAt, zoomToFit } from "./board-geometry.js";
 import { boardListing, boardListingIsEmpty, foldForSearch, nameMatches } from "./board-listing.js";
-import { MAKE_ROOM_LIMIT, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, assignMembership, fitSection, fitTouchedSections, makeRoom, settleBoard } from "./board-sections.js";
+import { MAKE_ROOM_LIMIT, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM } from "./board-section-constants.js";
+import { deriveSectionCells, gridDropMarkerBox, gridDropTarget, insertIntoGrid, layoutSection, removeFromGrid } from "./board-section-grid.js";
+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 { shotsUsed } from "./shots-used.js";
@@ -157,4 +159,4 @@ function jsonSchemas() {
 	};
 }
 //#endregion
-export { Annotation, Board, BoardItem, BoardLabel, BoardSection, Book, BookContents, BookFrontMatterEntry, BookMode, BookPage, BookSection, BookView, Box, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, Direction, 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, PAPER_MM, PX_PER_MM, Page, PageSize, Paper, Point, Print, 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, exceedsLimits, firstStrongDirection, fitPage, fitSection, fitTouchedSections, foldForSearch, formatNumber, impose, isBookContents, isHebrew, itemAt, itemHeight, jsonSchemas, languageDirection, lexiconVersion, makeRoom, mirrorPlacement, moveItems, moveSection, nameMatches, noteMarker, noteMarkerIssues, pagePlacementLayout, printBoxes, printPadding, printProperties, 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, 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, PAPER_MM, PLAYBACK_MODES, PX_PER_MM, Page, PageSize, Paper, Playback, Point, Print, 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, 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 };

package/package.json

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