slotdeck 0.0.0-stage → 0.1.0

package/dist/plan/catalog.js

@@ -0,0 +1,302 @@
+import { effectiveSlots, itemRange, textBudget } from '../template/manifest.js';
+/**
+ * Works out which slots of a pattern the model writes, or why the pattern cannot be used.
+ * Slots named in `skip` are already taken care of (carried over from an existing slide)
+ * and are neither offered nor required.
+ */
+export function planPattern(def, context, skip = new Set(), items) {
+    if (def.figures && !context.figures)
+        return { reason: 'is built around numbers, and the brief gives none' };
+    const hasGraphics = context.assets.some((asset) => asset.kind === 'graphic');
+    const slots = [];
+    let reason;
+    let needsPhoto = false;
+    for (const slot of effectiveSlots(def, items)) {
+        if (skip.has(slot.name))
+            continue;
+        const policy = slot.empty ?? 'error';
+        // In strict layout nothing may be removed, so a removable slot has to be filled like any other.
+        const mustFill = policy === 'error' || (policy === 'remove' && context.layout === 'strict');
+        const mayFill = policy !== 'keep' && policy !== 'drop';
+        if (slot.kind === 'text') {
+            if (slot.deckField) {
+                if (!context.fields[slot.deckField] && mustFill)
+                    reason = `needs the deck field "${slot.deckField}"`;
+                continue;
+            }
+            if (!mayFill)
+                continue;
+            slots.push({ slot, mode: (slot.maxParagraphs ?? 1) > 1 ? 'paragraphs' : 'text', required: mustFill });
+            continue;
+        }
+        if (slot.kind === 'table') {
+            if (mayFill)
+                slots.push({ slot, mode: 'table', required: mustFill });
+            continue;
+        }
+        if (slot.kind === 'chart') {
+            if (mayFill)
+                slots.push({ slot, mode: 'chart', required: mustFill });
+            continue;
+        }
+        let available;
+        if (slot.imageKind === 'photo')
+            available = context.imageDensity !== 'none';
+        else if (slot.imageKind === 'icon')
+            available = context.icons.length > 0;
+        else
+            available = hasGraphics;
+        if (!available || !mayFill) {
+            if (mustFill) {
+                reason =
+                    slot.imageKind === 'photo'
+                        ? 'needs a photo, and images are turned off'
+                        : slot.imageKind === 'icon'
+                            ? 'needs icons, and no icon set was supplied'
+                            : 'needs a graphic asset, and none was supplied';
+            }
+            continue;
+        }
+        if (slot.imageKind === 'photo' && mustFill)
+            needsPhoto = true;
+        slots.push({ slot, mode: slot.imageKind, required: mustFill });
+    }
+    if (reason)
+        return { reason };
+    const pattern = { def, slots, needsPhoto };
+    if (def.repeat && items !== undefined)
+        pattern.items = items;
+    return { pattern };
+}
+/** Works out which patterns can be filled with what the caller supplied, and which of their slots the model writes. */
+export function buildCatalog(manifest, context) {
+    const patterns = [];
+    const excluded = [];
+    for (const def of manifest.patterns) {
+        if (context.allow && !context.allow.includes(def.id))
+            continue;
+        const planned = planPattern(def, context);
+        if ('reason' in planned)
+            excluded.push({ id: def.id, reason: planned.reason });
+        else
+            patterns.push(planned.pattern);
+    }
+    return { patterns, excluded };
+}
+function limits(slot, scale = 1) {
+    if (slot.kind === 'table') {
+        const parts = [];
+        if (slot.maxColumns !== undefined)
+            parts.push(`at most ${slot.maxColumns} columns`);
+        if (slot.maxRows !== undefined)
+            parts.push(`at most ${slot.maxRows} rows`);
+        if (slot.maxCellChars !== undefined)
+            parts.push(`at most ${slot.maxCellChars} characters in a cell`);
+        return parts.join(', ');
+    }
+    if (slot.kind === 'chart') {
+        const parts = [];
+        if (slot.maxCategories !== undefined)
+            parts.push(`at most ${slot.maxCategories} categories`);
+        if (slot.maxSeries !== undefined)
+            parts.push(`at most ${slot.maxSeries} series`);
+        return parts.join(', ');
+    }
+    if (slot.kind !== 'text')
+        return '';
+    const budget = textBudget(slot, scale);
+    const several = (slot.maxParagraphs ?? 1) > 1;
+    const parts = [];
+    if (budget.maxChars !== undefined)
+        parts.push(`at most ${budget.maxChars} characters${several ? ' in total' : ''}`);
+    if (several)
+        parts.push(`at most ${budget.maxParagraphs} items`);
+    return parts.join(', ');
+}
+/** The pattern list as the outline prompt shows it. */
+export function describeCatalog(catalog, textScale = 1) {
+    return catalog.patterns
+        .map((pattern) => {
+        const repeat = pattern.def.repeat;
+        const range = itemRange(pattern.def);
+        // A row of items is described once, by its first item, with the number it may hold.
+        const itemSlot = new Map();
+        for (let n = 1; repeat && n <= (range?.drawn ?? 0); n++) {
+            for (const name of repeat.slots)
+                itemSlot.set(name.replace('{n}', String(n)), { n, label: name.replace('{n}', 'N') });
+        }
+        const slots = pattern.slots
+            .filter((planned) => (itemSlot.get(planned.slot.name)?.n ?? 1) === 1)
+            .map((planned) => {
+            const { slot } = planned;
+            const kind = planned.mode === 'text' || planned.mode === 'paragraphs'
+                ? limits(slot, textScale) || 'text'
+                : planned.mode === 'table' || planned.mode === 'chart'
+                    ? [planned.mode, limits(slot)].filter(Boolean).join(': ')
+                    : planned.mode;
+            return `${itemSlot.get(slot.name)?.label ?? slot.name}${planned.required ? '' : '?'} (${kind})`;
+        })
+            .join('; ');
+        const count = repeat && range && range.max > range.min ? `\n  items: ${range.min} to ${range.max} ${repeat.item}s, numbered N = 1, 2, ...` : '';
+        return `- ${pattern.def.id}: ${pattern.def.description}\n  slots: ${slots}${count}`;
+    })
+        .join('\n');
+}
+function slotSchema(planned, context) {
+    const { slot } = planned;
+    const note = [slot.description, limits(slot, context.textScale)].filter(Boolean).join('. ');
+    switch (planned.mode) {
+        case 'text':
+            return { type: 'string', description: note || 'Text' };
+        case 'paragraphs': {
+            const schema = { type: 'array', items: { type: 'string' }, minItems: 1, description: note || 'One string per paragraph' };
+            const most = textBudget(planned.slot, context.textScale).maxParagraphs;
+            if (most !== undefined)
+                schema.maxItems = most;
+            return schema;
+        }
+        case 'table': {
+            const cells = { type: 'array', items: { type: 'string' }, minItems: 2 };
+            const rows = { type: 'array', minItems: 1, description: 'Body rows. Every row has one cell per column, in column order.' };
+            if (planned.slot.maxColumns !== undefined)
+                cells.maxItems = planned.slot.maxColumns;
+            if (planned.slot.maxRows !== undefined)
+                rows.maxItems = planned.slot.maxRows;
+            rows.items = { ...cells };
+            return {
+                type: 'object',
+                description: note || 'A table',
+                properties: { header: { ...cells, description: 'Column headings, a word or two each' }, rows },
+                required: ['header', 'rows'],
+            };
+        }
+        case 'chart': {
+            const categories = { type: 'array', items: { type: 'string' }, minItems: 2, description: 'Labels along the axis, or the names of the pie slices' };
+            const series = {
+                type: 'array',
+                minItems: 1,
+                description: 'One or more series. A pie takes exactly one.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', description: 'What the series measures, a word or two' },
+                        values: { type: 'array', items: { type: 'number' }, description: 'One number per category, in category order' },
+                    },
+                    required: ['name', 'values'],
+                },
+            };
+            if (planned.slot.maxCategories !== undefined)
+                categories.maxItems = planned.slot.maxCategories;
+            if (planned.slot.maxSeries !== undefined)
+                series.maxItems = planned.slot.maxSeries;
+            return {
+                type: 'object',
+                description: (note ? `${note}. ` : '') +
+                    'A chart of numbers the brief states. Use only those numbers: never estimate, interpolate or invent a value to complete a series.',
+                properties: {
+                    type: { type: 'string', enum: ['column', 'bar', 'line', 'pie'], description: 'column: compare items. bar: compare items with long names. line: change over time. pie: shares of a whole.' },
+                    categories,
+                    series,
+                    format: { type: 'string', enum: ['number', 'percent'], description: 'percent when the values are percentages (write 45 for 45%)' },
+                },
+                required: ['type', 'categories', 'series', 'format'],
+            };
+        }
+        case 'icon':
+            return { type: 'string', enum: context.icons.map((icon) => icon.id), description: note || 'Id of the icon that best matches the item' };
+        case 'graphic':
+            return {
+                type: 'string',
+                enum: context.assets.filter((asset) => asset.kind === 'graphic').map((asset) => asset.id),
+                description: note || 'Id of the supplied graphic to show here',
+            };
+        case 'photo': {
+            const properties = {
+                prompt: {
+                    type: 'string',
+                    description: 'What the photo shows, in English: subject, setting, light and mood, in one or two sentences. No text, logos or brand names in the picture.',
+                },
+                alt: { type: 'string', description: 'Short alternative text for screen readers, in the deck language' },
+            };
+            const photos = context.assets.filter((asset) => asset.kind === 'photo');
+            if (photos.length > 0) {
+                properties.asset = {
+                    type: 'string',
+                    enum: photos.map((asset) => asset.id),
+                    description: 'Set only when one of the supplied photos fits; it is then used instead of generating one.',
+                };
+            }
+            return { type: 'object', properties, required: ['prompt', 'alt'], description: note || 'Photo for this slide' };
+        }
+    }
+}
+/**
+ * Schema for the content of a fixed set of slides: one property per slide (`s1`, `s2`, ...),
+ * each holding exactly that pattern's slots. Having no unions keeps it small and easy to enforce.
+ */
+export function contentSchema(items, context) {
+    const properties = {};
+    for (const { number, pattern, purpose } of items) {
+        const slotProperties = {};
+        for (const planned of pattern.slots)
+            slotProperties[planned.slot.name] = slotSchema(planned, context);
+        properties[`s${number}`] = {
+            type: 'object',
+            description: `Slide ${number} (${pattern.def.id}): ${purpose}`,
+            properties: slotProperties,
+            required: pattern.slots.filter((planned) => planned.required).map((planned) => planned.slot.name),
+        };
+    }
+    return { type: 'object', properties, required: Object.keys(properties) };
+}
+export function outlineSchema(catalog, count) {
+    return {
+        type: 'object',
+        properties: {
+            title: { type: 'string', description: 'Title of the deck' },
+            slides: {
+                type: 'array',
+                minItems: count.min,
+                maxItems: count.max,
+                items: {
+                    type: 'object',
+                    properties: {
+                        pattern: { type: 'string', enum: catalog.patterns.map((pattern) => pattern.def.id) },
+                        purpose: { type: 'string', description: 'The one point this slide makes, in a sentence' },
+                        ...itemsProperty(catalog),
+                    },
+                    required: ['pattern', 'purpose'],
+                },
+            },
+        },
+        required: ['title', 'slides'],
+    };
+}
+/** The `items` property of an outline entry, when some pattern on offer has a row of items to vary. */
+export function itemsProperty(catalog) {
+    const ranges = catalog.patterns.map((pattern) => itemRange(pattern.def)).filter((range) => range !== undefined && range.max > range.min);
+    if (ranges.length === 0)
+        return {};
+    return {
+        items: {
+            type: 'integer',
+            minimum: Math.min(...ranges.map((range) => range.min)),
+            maximum: Math.max(...ranges.map((range) => range.max)),
+            description: 'For a pattern with a row of items: how many items the content calls for. Leave it out for other patterns.',
+        },
+    };
+}
+/** Reads the item count of an outline entry: the pattern's own number when it has no choice or none was given. */
+export function readItems(pattern, value) {
+    const range = itemRange(pattern);
+    if (!range)
+        return {};
+    const items = Number(value);
+    if (value === undefined || value === null || !Number.isInteger(items))
+        return { items: range.drawn };
+    if (items < range.min || items > range.max) {
+        return { problem: `pattern "${pattern.id}" takes ${range.min} to ${range.max} ${pattern.repeat?.item ?? 'item'}s, not ${items}` };
+    }
+    return { items };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/plan/catalog.js.map

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

package/dist/plan/edit.d.ts

@@ -0,0 +1,31 @@
+import type { Issue } from '../deck/validate.ts';
+import type { DeckSpec } from '../deck/spec.ts';
+import type { Template } from '../render/render.ts';
+import type { Direction } from '../template/manifest.ts';
+import type { ImageDensity } from './catalog.ts';
+import type { PlanOptions } from './plan.ts';
+export interface EditOptions extends PlanOptions {
+    /** Replaces the deck-level values, e.g. a translated header text. Defaults to the deck's own. */
+    fields?: Record<string, string>;
+    /** Reading direction after the edit. Defaults to the direction of the deck's language. */
+    direction?: Direction;
+    /** Whether slides added by the edit may use photo patterns. Defaults to `medium`. */
+    imageDensity?: ImageDensity;
+}
+export interface EditResult {
+    deck: DeckSpec;
+    /** One sentence from the model on what it changed, for the person who asked. */
+    summary: string;
+    /** Slide numbers in the new deck that were written or rewritten. Every other slide is copied as it was. */
+    rewritten: number[];
+    warnings: Issue[];
+}
+/**
+ * Applies an instruction such as "shorten slide 3" or "add a slide about pricing" to a deck.
+ *
+ * Two model calls: the first decides what the deck looks like after the change (which slides
+ * stay, move, go, get rewritten or are new); the second writes only the slides that change.
+ * Untouched slides are copied by code, so they cannot drift, and pictures are kept unless the
+ * instruction is about them.
+ */
+export declare function planEdit(template: Template, deck: DeckSpec, instruction: string, options: EditOptions): Promise<EditResult>;