slotdeck 0.0.0-stage → 0.1.0

package/dist/template/manifest.d.ts

@@ -0,0 +1,226 @@
+export type Direction = 'rtl' | 'ltr';
+export type AlignPolicy = 'flip' | 'keep';
+/**
+ * Describes how a pptx can be reused as a template: which of its slides are
+ * reusable patterns, and which shapes on them are slots to fill.
+ * Shapes that are not listed as slots are copied untouched (logo, rules, decorations).
+ */
+export interface TemplateManifest {
+    version: 1;
+    name: string;
+    /** BCP 47 tag of the template's sample text, e.g. `he`. */
+    language?: string;
+    /** Reading direction the template was designed for. */
+    direction: Direction;
+    /**
+     * What happens to left/right paragraph alignment when a deck reads the other way from the
+     * template. `flip` (default) mirrors it. `keep` leaves it as designed, which suits templates
+     * whose text boxes share one edge but not the other. Slots can override this.
+     */
+    alignOnDirectionChange?: AlignPolicy;
+    patterns: PatternDef[];
+}
+export interface PatternDef {
+    id: string;
+    /** 1-based slide number in the template pptx that this pattern is cloned from. */
+    sourceSlide: number;
+    /** What the pattern is for. Written for the model that picks patterns. */
+    description: string;
+    slots: SlotDef[];
+    /**
+     * The pattern is built around numbers. The planner offers it only when the brief contains
+     * figures, so the model is not led into inventing statistics to fill it.
+     */
+    figures?: boolean;
+    /**
+     * Rows of items (cards, steps, figures). Each row lists its items, first item first in the
+     * template's reading direction, and each item lists its slot names in the same order.
+     * When a deck reads the other way, values are placed mirror-wise within each row, so the
+     * deck's first item still comes first for its readers. A grid is one row per line of cards.
+     * Items of a row should have matching limits.
+     */
+    sequences?: string[][][];
+    /** A row of like items (cards, steps, figures) whose number a deck may choose. */
+    repeat?: RepeatDef;
+}
+/**
+ * A row of items that can hold fewer or more than the template slide shows. Items are removed
+ * or copied and the row is spaced out again; nothing is redrawn.
+ */
+export interface RepeatDef {
+    /** What one item is called in prompts, e.g. `card`. */
+    item: string;
+    /** Slot name templates of one item; `{n}` stands for the item number, from 1. */
+    slots: string[];
+    /**
+     * For each item on the template slide, first in reading order first: the shapes that move
+     * together as that item (its group, and any text box that sits outside the group).
+     */
+    shapes: string[][];
+    /** Fewest and most items the row may hold. Both default to the number on the template slide. */
+    min?: number;
+    max?: number;
+    /** Left and right limits of the row, as fractions of the slide width. Defaults to the row as drawn. */
+    span?: {
+        left: number;
+        right: number;
+    };
+    /**
+     * For a grid: how many items one row holds on the template slide. Items then fill rows in
+     * reading order, spread evenly over as few rows as they need. Leave it out for a single row.
+     */
+    columns?: number;
+}
+/**
+ * How many items each row of a repeat holds for a given count. A single row takes them all.
+ * A grid uses as few rows as the count needs and spreads the items evenly: four items in a
+ * three-column grid make two rows of two, not three and one.
+ */
+export declare function rowLayout(repeat: RepeatDef, count: number): number[];
+/**
+ * For each slot of a pattern, the deck slot name its value is taken from: the slot's own name,
+ * except across a row of `sequences` when the deck reads against the template.
+ */
+export declare function slotSources(pattern: PatternDef, mirrored: boolean, items?: number): Map<string, string>;
+/**
+ * What to do when a deck gives no value for a slot:
+ * - `error`: the slot is required (default)
+ * - `remove`: optional content; the shape is deleted, which needs `layout: 'adaptive'`
+ * - `keep`: leave the template's own content in place (decoration that suits any content)
+ * - `drop`: delete the shape in any layout (decoration drawn for the template's sample
+ *   content, such as a sticker placed on a particular photo)
+ *
+ * Slots with `keep` or `drop` are never offered to the planning model.
+ */
+export type EmptyPolicy = 'error' | 'remove' | 'keep' | 'drop';
+interface SlotBase {
+    /** Name the deck uses to address the slot; unique within the pattern. */
+    name: string;
+    /** `p:cNvPr/@id` of the shape on the source slide. */
+    shapeId: string;
+    description?: string;
+    empty?: EmptyPolicy;
+}
+export interface TextSlotDef extends SlotBase {
+    kind: 'text';
+    /** Soft limit on total characters; exceeding it produces a warning. */
+    maxChars?: number;
+    /** Soft limit on the number of paragraphs. */
+    maxParagraphs?: number;
+    /** Take the value from `deck.fields[deckField]` when the slide does not set it. */
+    deckField?: string;
+    /** Overrides the manifest's `alignOnDirectionChange` for this slot. */
+    alignOnDirectionChange?: AlignPolicy;
+    /**
+     * Which run of the template paragraph supplies the formatting, for paragraphs that mix
+     * styles (e.g. a coloured label followed by plain text). Defaults to `first`.
+     */
+    styleRun?: 'first' | 'last';
+    /** Font size of the slot's text on the template slide, in points. Decides whether a deck's text size applies. */
+    size?: number;
+    /** Sets the font size outright, in points: for a pattern derived from a slide that uses the shape differently. */
+    fontSize?: number;
+    /** Moves and resizes the text box: for a derived pattern. Only for a shape that is not inside a group. */
+    box?: SlideBox;
+    /** Space after each paragraph, in points. */
+    paragraphGap?: number;
+    /** Whether a deck's text size applies. Defaults to body text: 12 pt and under, and not a deck field. */
+    scales?: boolean;
+}
+export type ImageKind = 'photo' | 'icon' | 'graphic';
+/** A rectangle as fractions of the slide (0..1). */
+export interface SlideBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface ImageSlotDef extends SlotBase {
+    kind: 'image';
+    imageKind: ImageKind;
+    /** `cover` crops the image to fill the frame; `contain` shrinks the frame to the image. Defaults by kind. */
+    fit?: 'cover' | 'contain';
+    /**
+     * The area the picture may use, when that is larger or other than the sample picture's own
+     * frame (a chart drawn small in the middle of a slide that has room for a wide diagram).
+     * Only for pictures that are not inside a group.
+     */
+    box?: SlideBox;
+    /** Set on slots of copied items: the template shape the copy was made from. */
+    copyOf?: string;
+}
+/** Formatting for table text, for templates whose sample table leaves it undefined. */
+export interface TableTextStyle {
+    /** Font size in points. */
+    size?: number;
+    bold?: boolean;
+    /** Hex colour without `#`, e.g. `FFFFFF`. */
+    color?: string;
+    /** Typeface name. */
+    font?: string;
+}
+export interface TableSlotDef extends SlotBase {
+    kind: 'table';
+    /** Soft limit on columns. Defaults to the sample table's. */
+    maxColumns?: number;
+    /** Soft limit on body rows (the header row not counted). Defaults to the sample table's. */
+    maxRows?: number;
+    /** Soft limit on the characters in one cell. */
+    maxCellChars?: number;
+    headerText?: TableTextStyle;
+    bodyText?: TableTextStyle;
+}
+/**
+ * A native, editable chart. The slot points at the sample picture of a chart; the picture is
+ * replaced by a real chart with its data in an embedded workbook.
+ */
+export interface ChartSlotDef extends SlotBase {
+    kind: 'chart';
+    /** The area the chart may use, when other than the sample picture's frame. */
+    box?: SlideBox;
+    /** Soft limit on the number of categories (points along the axis, or pie slices). */
+    maxCategories?: number;
+    /** Soft limit on the number of series. */
+    maxSeries?: number;
+    /** Series colours in order, as hex without `#`. They repeat when there are more series. */
+    colors?: string[];
+    /** Formatting of axis labels, data labels and the legend. */
+    text?: TableTextStyle;
+    /** Colour of the gridlines and axis lines, as hex without `#`. */
+    lineColor?: string;
+}
+export type SlotDef = TextSlotDef | ImageSlotDef | TableSlotDef | ChartSlotDef;
+export declare function defaultFit(slot: ImageSlotDef): 'cover' | 'contain';
+/** Copied shapes get the id of their original plus a multiple of this, so the id is known without the file. */
+export declare const COPY_ID_STEP = 10000;
+/** How many items a slide's row holds: what the deck asks for, or the number on the template slide. */
+export declare function itemCount(pattern: PatternDef, items?: number): number;
+/** The range of item counts a pattern accepts, or `undefined` when it has no row to vary. */
+export declare function itemRange(pattern: PatternDef): {
+    min: number;
+    max: number;
+    drawn: number;
+} | undefined;
+/**
+ * The slots of a pattern for a given number of items. Slots of items beyond the count are left
+ * out; items beyond those drawn on the template get copies of the last item's slots, pointing
+ * at the shapes the renderer will copy.
+ */
+export declare function effectiveSlots(pattern: PatternDef, items?: number): SlotDef[];
+/** Deck text sizes by name, as factors on the template's body text. */
+export declare const TEXT_SIZES: {
+    readonly normal: 1;
+    readonly large: 1.25;
+    readonly 'x-large': 1.5;
+};
+export type TextSize = keyof typeof TEXT_SIZES;
+export declare function scalesWithText(slot: TextSlotDef): boolean;
+/**
+ * A text slot's limits at a given text scale. Larger text fits fewer characters per line and
+ * fewer lines in the same box, so the character budget falls with the square of the scale.
+ */
+export declare function textBudget(slot: TextSlotDef, scale?: number): {
+    maxChars?: number;
+    maxParagraphs?: number;
+};
+export {};

package/dist/template/manifest.js

@@ -0,0 +1,116 @@
+/**
+ * How many items each row of a repeat holds for a given count. A single row takes them all.
+ * A grid uses as few rows as the count needs and spreads the items evenly: four items in a
+ * three-column grid make two rows of two, not three and one.
+ */
+export function rowLayout(repeat, count) {
+    if (!repeat.columns || repeat.columns >= count)
+        return count > 0 ? [count] : [];
+    const rows = Math.ceil(count / repeat.columns);
+    const layout = [];
+    for (let row = 0, left = count; row < rows; row++) {
+        const here = Math.ceil(left / (rows - row));
+        layout.push(here);
+        left -= here;
+    }
+    return layout;
+}
+/**
+ * For each slot of a pattern, the deck slot name its value is taken from: the slot's own name,
+ * except across a row of `sequences` when the deck reads against the template.
+ */
+export function slotSources(pattern, mirrored, items) {
+    const sources = new Map(effectiveSlots(pattern, items).map((slot) => [slot.name, slot.name]));
+    if (!mirrored)
+        return sources;
+    const rows = [...(pattern.sequences ?? [])];
+    if (pattern.repeat) {
+        // Each row of items is mirrored on its own, so a grid keeps its rows.
+        const repeat = pattern.repeat;
+        let next = 1;
+        for (const size of rowLayout(repeat, itemCount(pattern, items))) {
+            rows.push(Array.from({ length: size }, () => {
+                const n = next++;
+                return repeat.slots.map((name) => name.replace('{n}', String(n)));
+            }));
+        }
+    }
+    for (const items of rows) {
+        items.forEach((item, index) => {
+            const opposite = items[items.length - 1 - index] ?? [];
+            item.forEach((name, position) => {
+                const source = opposite[position];
+                if (source !== undefined)
+                    sources.set(name, source);
+            });
+        });
+    }
+    return sources;
+}
+export function defaultFit(slot) {
+    return slot.fit ?? (slot.imageKind === 'photo' ? 'cover' : 'contain');
+}
+/** Copied shapes get the id of their original plus a multiple of this, so the id is known without the file. */
+export const COPY_ID_STEP = 10000;
+/** How many items a slide's row holds: what the deck asks for, or the number on the template slide. */
+export function itemCount(pattern, items) {
+    if (!pattern.repeat)
+        return 0;
+    return items ?? pattern.repeat.shapes.length;
+}
+/** The range of item counts a pattern accepts, or `undefined` when it has no row to vary. */
+export function itemRange(pattern) {
+    if (!pattern.repeat)
+        return undefined;
+    const drawn = pattern.repeat.shapes.length;
+    return { min: pattern.repeat.min ?? drawn, max: pattern.repeat.max ?? drawn, drawn };
+}
+/**
+ * The slots of a pattern for a given number of items. Slots of items beyond the count are left
+ * out; items beyond those drawn on the template get copies of the last item's slots, pointing
+ * at the shapes the renderer will copy.
+ */
+export function effectiveSlots(pattern, items) {
+    const repeat = pattern.repeat;
+    if (!repeat)
+        return pattern.slots;
+    const drawn = repeat.shapes.length;
+    const count = itemCount(pattern, items);
+    const itemOf = new Map();
+    for (let n = 1; n <= drawn; n++)
+        for (const name of repeat.slots)
+            itemOf.set(name.replace('{n}', String(n)), n);
+    const slots = pattern.slots.filter((slot) => (itemOf.get(slot.name) ?? 0) <= count);
+    for (let n = drawn + 1; n <= count; n++) {
+        for (const name of repeat.slots) {
+            const original = pattern.slots.find((slot) => slot.name === name.replace('{n}', String(drawn)));
+            if (!original)
+                continue;
+            const copy = { ...original, name: name.replace('{n}', String(n)), shapeId: String(Number(original.shapeId) + (n - drawn) * COPY_ID_STEP) };
+            slots.push(copy.kind === 'image' ? { ...copy, copyOf: original.shapeId } : copy);
+        }
+    }
+    return slots;
+}
+/** Deck text sizes by name, as factors on the template's body text. */
+export const TEXT_SIZES = { normal: 1, large: 1.25, 'x-large': 1.5 };
+export function scalesWithText(slot) {
+    if (slot.scales !== undefined)
+        return slot.scales;
+    const size = slot.fontSize ?? slot.size;
+    return !slot.deckField && size !== undefined && size <= 12;
+}
+/**
+ * A text slot's limits at a given text scale. Larger text fits fewer characters per line and
+ * fewer lines in the same box, so the character budget falls with the square of the scale.
+ */
+export function textBudget(slot, scale = 1) {
+    const factor = scalesWithText(slot) ? scale : 1;
+    const budget = {};
+    if (slot.maxChars !== undefined)
+        budget.maxChars = Math.max(1, Math.floor(slot.maxChars / (factor * factor)));
+    if (slot.maxParagraphs !== undefined)
+        budget.maxParagraphs = Math.max(1, Math.floor(slot.maxParagraphs / factor));
+    return budget;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/template/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/template/manifest.ts"],"names":[],"mappings":"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"}

package/dist/template/measure.d.ts

@@ -0,0 +1,80 @@
+import type { Box, ShapeInfo, SlideInfo, TemplateInfo } from './inspect.ts';
+import type { SlotDef } from './manifest.ts';
+/** What a shape is for. `fixed` means it is part of the design and not a slot. */
+export declare const ROLES: readonly ['title', 'subtitle', 'text', 'list', 'number', 'caption', 'photo', 'icon', 'graphic', 'chart', 'table', 'decoration', 'fixed'];
+export type Role = (typeof ROLES)[number];
+export declare const pct: (value: number) => number;
+export declare const normalize: (text: string) => string;
+export declare const shapeText: (shape: ShapeInfo) => string;
+/** A name the manifest can use as a slot name: letters and digits, starting with a lowercase letter. */
+export declare function slotName(raw: string, fallback: string): string;
+/** How much text a box holds, estimated from its size and font, and never less than its sample holds. */
+export declare function textLimits(shape: ShapeInfo, info: TemplateInfo, role: Role): {
+    size: number;
+    maxChars: number;
+    maxParagraphs?: number;
+};
+/**
+ * How many characters an area of the slide holds at a font size, when the text is in several
+ * paragraphs with a gap between them. Each paragraph after the first ends half a line short on average.
+ */
+export declare function boxCapacity(box: Box, info: TemplateInfo, size: number, paragraphs?: number, gap?: number): number;
+/**
+ * What a table holds: its columns and rows as drawn, and the characters that fit in a cell
+ * before the rows grow so tall that the table leaves the slide. The room is measured from the
+ * table's top down to the slide's bottom margin, or to the next shape under the table.
+ * `fontSize` and `columns` give the limits for a table set differently from the sample.
+ */
+export declare function tableLimits(shape: ShapeInfo, info: TemplateInfo, options?: {
+    slide?: SlideInfo;
+    fontSize?: number;
+    columns?: number;
+    rows?: number;
+}): {
+    maxColumns: number;
+    maxRows: number;
+    maxCellChars: number;
+};
+/** The roles a shape can take, by what kind of shape it is. `fixed` is always possible and not listed. */
+export declare function rolesFor(shape: ShapeInfo): Role[];
+/**
+ * The slot a shape becomes in a given role, with limits measured from the shape. `undefined`
+ * when the shape cannot take the role (a picture cannot be a title).
+ */
+export declare function slotFromShape(shape: ShapeInfo, info: TemplateInfo, role: Role, name: string, optional?: boolean, slide?: SlideInfo): SlotDef | undefined;
+/** Whether a shape of a role's kind carries text. */
+export declare function isTextRole(role: Role): boolean;
+/**
+ * A page number, date, footer or header placeholder: part of every slide, never content. A title
+ * or body placeholder is content like any other text box.
+ */
+export declare function isFramePlaceholder(shape: ShapeInfo): boolean;
+export interface FrameFacts {
+    /** On how many slides something must sit in the same place to count as part of the frame. */
+    often: number;
+    /** A logo, rule, page number or other element that repeats across slides. */
+    isFrame(shape: ShapeInfo): boolean;
+    /** Texts that appear on many slides: one value for the whole deck. */
+    repeatedTexts: string[];
+    /** Every distinct sample text, in slide order. */
+    texts: string[];
+}
+/**
+ * Whatever sits in the same place on many slides is part of the frame, not content. A short deck
+ * gives too little evidence of what repeats, so nothing is treated as frame there.
+ */
+export declare function frameFacts(info: TemplateInfo): FrameFacts;
+/** One line of measured facts about a shape, as the model reads it. */
+export declare function describeShape(shape: ShapeInfo, info: TemplateInfo): string;
+/** The smallest box around several shapes, as slide fractions. */
+export declare function unionBox(boxes: Box[]): Box;
+/**
+ * How far a row of items may spread on its slide: from the row as drawn outwards, until the
+ * slide's margin or another shape that sits beside the row. Fractions of the slide width.
+ */
+export declare function rowRoom(slide: SlideInfo, itemShapes: string[][]): {
+    area: Box;
+    itemWidth: number;
+    left: number;
+    right: number;
+};

package/dist/template/measure.js

@@ -0,0 +1,212 @@
+/** What a shape is for. `fixed` means it is part of the design and not a slot. */
+export const ROLES = ['title', 'subtitle', 'text', 'list', 'number', 'caption', 'photo', 'icon', 'graphic', 'chart', 'table', 'decoration', 'fixed'];
+const TEXT_ROLES = new Set(['title', 'subtitle', 'text', 'list', 'number', 'caption']);
+export const pct = (value) => Math.round(value * 100);
+export const normalize = (text) => text.replace(/\s+/g, ' ').trim();
+export const shapeText = (shape) => normalize((shape.paragraphs ?? []).join(' '));
+/** A name the manifest can use as a slot name: letters and digits, starting with a lowercase letter. */
+export function slotName(raw, fallback) {
+    const words = raw.replace(/[^A-Za-z0-9]+/g, ' ').trim().split(' ').filter(Boolean);
+    const name = words.map((word, index) => (index === 0 ? word.charAt(0).toLowerCase() : word.charAt(0).toUpperCase()) + word.slice(1)).join('');
+    return /^[a-z]/.test(name) ? name : fallback;
+}
+/** How much text a box holds, estimated from its size and font, and never less than its sample holds. */
+export function textLimits(shape, info, role) {
+    const size = shape.fontSizes?.[0] ?? 14;
+    const paragraphs = (shape.paragraphs ?? []).filter((paragraph) => paragraph.trim() !== '');
+    const sample = paragraphs.reduce((sum, paragraph) => sum + paragraph.length, 0);
+    const perLine = Math.max(1, Math.floor((shape.box.w * info.slideWidth) / 12700 / (size * 0.5)));
+    // A text box often shrinks to its sample, so the lines the sample takes count as well as the box height.
+    const sampleLines = paragraphs.reduce((sum, paragraph) => sum + Math.max(1, Math.ceil(paragraph.length / perLine)), 0);
+    const boxLines = Math.max(1, Math.round((shape.box.h * info.slideHeight) / 12700 / (size * 1.25)));
+    const estimate = Math.floor(perLine * Math.max(sampleLines, boxLines) * 0.8);
+    const limits = {
+        size,
+        // A big figure fits what the sample shows and little more; other text can use the room there is.
+        maxChars: Math.max(1, role === 'number' ? Math.max(sample, 2) : Math.max(sample, estimate)),
+    };
+    if (role === 'list')
+        limits.maxParagraphs = Math.max(2, paragraphs.length);
+    return limits;
+}
+/**
+ * How many characters an area of the slide holds at a font size, when the text is in several
+ * paragraphs with a gap between them. Each paragraph after the first ends half a line short on average.
+ */
+export function boxCapacity(box, info, size, paragraphs = 1, gap = 0) {
+    const extra = Math.max(0, paragraphs - 1);
+    const perLine = Math.max(1, Math.floor((box.w * info.slideWidth) / 12700 / (size * 0.5)));
+    const height = (box.h * info.slideHeight) / 12700 - extra * gap;
+    const lines = Math.max(1, Math.round(height / (size * 1.25)) - extra * 0.5);
+    return Math.max(1, Math.floor(perLine * lines * 0.8));
+}
+/**
+ * What a table holds: its columns and rows as drawn, and the characters that fit in a cell
+ * before the rows grow so tall that the table leaves the slide. The room is measured from the
+ * table's top down to the slide's bottom margin, or to the next shape under the table.
+ * `fontSize` and `columns` give the limits for a table set differently from the sample.
+ */
+export function tableLimits(shape, info, options = {}) {
+    const columns = options.columns ?? shape.table?.columns ?? 4;
+    const bodyRows = options.rows ?? Math.max(1, (shape.table?.rows ?? 4) - 1);
+    const size = options.fontSize ?? shape.fontSizes?.[0] ?? info.defaultFontSize;
+    const margins = 14.4; // a cell's two opposite margins, in points
+    const points = (fraction, of) => (fraction * of) / 12700;
+    let bottom = 0.93;
+    for (const other of options.slide?.shapes ?? []) {
+        if (other.id === shape.id || other.kind === 'group' || isFramePlaceholder(other))
+            continue;
+        const beside = other.box.x < shape.box.x + shape.box.w && other.box.x + other.box.w > shape.box.x;
+        if (beside && other.box.y > shape.box.y + 0.05)
+            bottom = Math.min(bottom, other.box.y - 0.02);
+    }
+    const width = points(shape.box.w, info.slideWidth) / columns - margins;
+    const height = points(Math.max(bottom - shape.box.y, 0), info.slideHeight) / (bodyRows + 1) - margins;
+    const perLine = Math.max(1, Math.floor(width / (size * 0.5)));
+    const lines = Math.max(1, Math.floor(height / (size * 1.2) + 0.05));
+    return { maxColumns: columns, maxRows: bodyRows, maxCellChars: Math.max(4, Math.floor(perLine * lines * 0.9)) };
+}
+/** The roles a shape can take, by what kind of shape it is. `fixed` is always possible and not listed. */
+export function rolesFor(shape) {
+    if (shape.kind === 'text')
+        return ['title', 'subtitle', 'text', 'list', 'number', 'caption', 'decoration'];
+    if (shape.kind === 'picture')
+        return ['photo', 'icon', 'graphic', 'chart', 'decoration'];
+    if (shape.kind === 'table')
+        return ['table'];
+    // A drawn ornament, a line or a group can only be taken away.
+    return ['decoration'];
+}
+/**
+ * The slot a shape becomes in a given role, with limits measured from the shape. `undefined`
+ * when the shape cannot take the role (a picture cannot be a title).
+ */
+export function slotFromShape(shape, info, role, name, optional = false, slide) {
+    if (!rolesFor(shape).includes(role))
+        return undefined;
+    let slot;
+    if (shape.kind !== 'text' && shape.kind !== 'picture' && shape.kind !== 'table') {
+        // Nothing fills such a shape; the slot exists so that the shape is removed.
+        return { name, kind: 'text', shapeId: shape.id, empty: 'drop' };
+    }
+    if (shape.kind === 'text') {
+        slot = { name, kind: 'text', shapeId: shape.id, ...textLimits(shape, info, role) };
+    }
+    else if (shape.kind === 'table') {
+        return { name, kind: 'table', shapeId: shape.id, ...tableLimits(shape, info, slide ? { slide } : {}) };
+    }
+    else if (role === 'chart') {
+        // A chart replaces the sample picture and may not sit in a group, which a native chart cannot.
+        if (shape.groupId !== undefined)
+            return undefined;
+        return { name, kind: 'chart', shapeId: shape.id, maxCategories: 8, maxSeries: 3 };
+    }
+    else {
+        slot = { name, kind: 'image', imageKind: role === 'photo' || role === 'icon' ? role : 'graphic', shapeId: shape.id };
+    }
+    if (role === 'decoration')
+        slot.empty = 'drop';
+    else if (optional)
+        slot.empty = 'remove';
+    return slot;
+}
+/** Whether a shape of a role's kind carries text. */
+export function isTextRole(role) {
+    return TEXT_ROLES.has(role);
+}
+/**
+ * A page number, date, footer or header placeholder: part of every slide, never content. A title
+ * or body placeholder is content like any other text box.
+ */
+export function isFramePlaceholder(shape) {
+    return shape.placeholder === 'sldNum' || shape.placeholder === 'dt' || shape.placeholder === 'ftr' || shape.placeholder === 'hdr';
+}
+/**
+ * Whatever sits in the same place on many slides is part of the frame, not content. A short deck
+ * gives too little evidence of what repeats, so nothing is treated as frame there.
+ */
+export function frameFacts(info) {
+    const total = info.slides.length;
+    const often = total >= 6 ? Math.max(3, Math.ceil(total * 0.3)) : Infinity;
+    const placeOf = (shape) => `${shape.kind}|${pct(shape.box.x)}|${pct(shape.box.y)}|${pct(shape.box.w)}|${pct(shape.box.h)}|${shape.image?.part ?? ''}`;
+    const places = new Map();
+    const texts = new Map();
+    for (const slide of info.slides) {
+        for (const key of new Set(slide.shapes.filter((shape) => shape.kind !== 'text').map(placeOf)))
+            places.set(key, (places.get(key) ?? 0) + 1);
+        for (const text of new Set(slide.shapes.filter((shape) => shape.kind === 'text' && !isFramePlaceholder(shape)).map(shapeText))) {
+            if (text)
+                texts.set(text, (texts.get(text) ?? 0) + 1);
+        }
+    }
+    return {
+        often,
+        isFrame: (shape) => isFramePlaceholder(shape) || (shape.kind !== 'text' && (places.get(placeOf(shape)) ?? 0) >= often),
+        repeatedTexts: [...texts].filter(([, count]) => count >= often).map(([text]) => text),
+        texts: [...texts.keys()],
+    };
+}
+/** One line of measured facts about a shape, as the model reads it. */
+export function describeShape(shape, info) {
+    const where = `at x${pct(shape.box.x)} y${pct(shape.box.y)}, ${pct(shape.box.w)} wide ${pct(shape.box.h)} high${shape.groupId ? `, in group #${shape.groupId}` : ''}`;
+    if (shape.kind === 'text') {
+        const text = shapeText(shape);
+        const count = shape.paragraphs?.length ?? 1;
+        return `#${shape.id} text ${where} | ${shape.fontSizes?.[0] ?? 14} pt | ${count} paragraph${count === 1 ? '' : 's'}, ${text.length} characters: ${JSON.stringify(text.slice(0, 60))}`;
+    }
+    if (shape.kind === 'table')
+        return `#${shape.id} table ${where} | ${shape.table?.columns ?? '?'} columns, ${shape.table?.rows ?? '?'} rows`;
+    if (shape.kind !== 'picture')
+        return `#${shape.id} ${shape.kind} ${where}`;
+    const image = shape.image;
+    const uses = info.slides.filter((other) => other.shapes.some((candidate) => candidate.image?.part === image?.part)).length;
+    return `#${shape.id} picture ${where} | ${image?.width ?? '?'}x${image?.height ?? '?'} px ${image?.part.split('.').pop() ?? ''}${image?.cropped ? ', cropped to its frame' : ''}${image?.geometry && image.geometry !== 'rect' && image.geometry !== 'custom' ? `, ${image.geometry} frame` : ''}${uses > 1 ? `, same picture on ${uses} slides` : ''}`;
+}
+/** The smallest box around several shapes, as slide fractions. */
+export function unionBox(boxes) {
+    const x = Math.min(...boxes.map((box) => box.x));
+    const y = Math.min(...boxes.map((box) => box.y));
+    return { x, y, w: Math.max(...boxes.map((box) => box.x + box.w)) - x, h: Math.max(...boxes.map((box) => box.y + box.h)) - y };
+}
+/**
+ * How far a row of items may spread on its slide: from the row as drawn outwards, until the
+ * slide's margin or another shape that sits beside the row. Fractions of the slide width.
+ */
+export function rowRoom(slide, itemShapes) {
+    const byId = new Map(slide.shapes.map((shape) => [shape.id, shape]));
+    const inRow = new Set();
+    const mark = (id) => {
+        inRow.add(id);
+        for (const shape of slide.shapes)
+            if (shape.groupId === id)
+                mark(shape.id);
+    };
+    for (const id of itemShapes.flat()) {
+        mark(id);
+        // A group that holds the whole row is not beside it.
+        for (let parent = byId.get(id)?.groupId; parent; parent = byId.get(parent)?.groupId)
+            inRow.add(parent);
+    }
+    const boxes = itemShapes.map((ids) => unionBox(ids.flatMap((id) => (byId.get(id) ? [byId.get(id).box] : []))));
+    const area = unionBox(boxes);
+    const itemWidth = Math.max(...boxes.map((box) => box.w));
+    // The margin the slide's own content keeps from its sides.
+    const content = slide.shapes.filter((shape) => !isFramePlaceholder(shape) && shape.kind !== 'group' && shape.box.w < 0.9 && shape.box.x >= 0 && shape.box.x + shape.box.w <= 1);
+    const margin = Math.max(0.03, Math.min(0.08, ...content.map((shape) => Math.min(shape.box.x, 1 - shape.box.x - shape.box.w)).filter((edge) => edge > 0.005)));
+    const gap = 0.02;
+    let left = Math.min(area.x, margin);
+    let right = Math.max(area.x + area.w, 1 - margin);
+    for (const shape of slide.shapes) {
+        if (inRow.has(shape.id) || isFramePlaceholder(shape) || shape.kind === 'group' || shape.box.w >= 0.9)
+            continue;
+        const overlaps = shape.box.y < area.y + area.h && shape.box.y + shape.box.h > area.y;
+        if (!overlaps)
+            continue;
+        if (shape.box.x + shape.box.w <= area.x + 0.005)
+            left = Math.max(left, Math.min(area.x, shape.box.x + shape.box.w + gap));
+        else if (shape.box.x >= area.x + area.w - 0.005)
+            right = Math.min(right, Math.max(area.x + area.w, shape.box.x - gap));
+    }
+    return { area, itemWidth, left, right };
+}
+//# sourceMappingURL=measure.js.map