slotdeck 0.0.0-stage → 0.1.0

package/dist/deck/spec.js

@@ -0,0 +1,21 @@
+export function isImageRef(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) && typeof value.asset === 'string';
+}
+export function isTableValue(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const table = value;
+    return Array.isArray(table.header) && Array.isArray(table.rows) && table.rows.every((row) => Array.isArray(row));
+}
+export function isChartValue(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const chart = value;
+    return Array.isArray(chart.categories) && Array.isArray(chart.series);
+}
+/** Normalises a text value to paragraphs. */
+export function toParagraphs(value) {
+    const parts = Array.isArray(value) ? value : [value];
+    return parts.flatMap((part) => part.split(/\r?\n/)).map((line) => line.trim());
+}
+//# sourceMappingURL=spec.js.map

package/dist/deck/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/deck/spec.ts"],"names":[],"mappings":"AAyEA,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAQ,KAAkB,CAAC,KAAK,KAAK,QAAQ,CAAC;AAC/H,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,KAAK,GAAG,KAAmB,CAAC;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,KAAK,GAAG,KAAmB,CAAC;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACjF,CAAC"}

package/dist/deck/validate.d.ts

@@ -0,0 +1,49 @@
+import type { SlotDef, TemplateManifest } from '../template/manifest.ts';
+import type { ChartValue, DeckSpec, ImageRef, SlideSpec, TableValue } from './spec.ts';
+export type LayoutMode = 'strict' | 'adaptive';
+export interface Issue {
+    severity: 'error' | 'warning';
+    /** 1-based slide number in the deck; absent for deck-level issues. */
+    slide?: number;
+    slot?: string;
+    message: string;
+}
+export declare class DeckValidationError extends Error {
+    readonly issues: Issue[];
+    constructor(issues: Issue[]);
+}
+/** What the renderer should do with one slot on one slide. */
+export type SlotAction = {
+    type: 'text';
+    paragraphs: string[];
+} | {
+    type: 'image';
+    image: ImageRef;
+} | {
+    type: 'table';
+    table: TableValue;
+} | {
+    type: 'chart';
+    chart: ChartValue;
+} | {
+    type: 'remove';
+} | {
+    type: 'keep';
+};
+export interface ValidateOptions {
+    layout?: LayoutMode;
+    /** Ids of the assets that will be available at render time. When given, image references are checked. */
+    assets?: Iterable<string>;
+}
+/**
+ * Decides what happens to a slot, or reports why it cannot be filled.
+ * Shared by validation and rendering so they can never disagree.
+ * `source` is the deck slot name the value comes from (see `slotSources`).
+ */
+export declare function resolveSlot(slot: SlotDef, slide: SlideSpec, deck: DeckSpec, layout: LayoutMode, source?: string): {
+    action: SlotAction;
+} | {
+    error: string;
+};
+/** Checks a deck against a manifest. Errors block rendering; warnings do not. */
+export declare function validateDeck(manifest: TemplateManifest, deck: DeckSpec, options?: ValidateOptions): Issue[];

package/dist/deck/validate.js

@@ -0,0 +1,189 @@
+import { effectiveSlots, itemRange, slotSources, textBudget } from '../template/manifest.js';
+import { isChartValue, isImageRef, isTableValue, toParagraphs } from './spec.js';
+export class DeckValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super(`Deck cannot be rendered:\n${issues
+            .map((issue) => `  - ${issue.slide ? `slide ${issue.slide}` : 'deck'}${issue.slot ? ` / ${issue.slot}` : ''}: ${issue.message}`)
+            .join('\n')}`);
+        this.name = 'DeckValidationError';
+        this.issues = issues;
+    }
+}
+/**
+ * Decides what happens to a slot, or reports why it cannot be filled.
+ * Shared by validation and rendering so they can never disagree.
+ * `source` is the deck slot name the value comes from (see `slotSources`).
+ */
+export function resolveSlot(slot, slide, deck, layout, source = slot.name) {
+    let value = slide.slots[source];
+    if (value === undefined && slot.kind === 'text' && slot.deckField) {
+        value = deck.fields?.[slot.deckField];
+    }
+    const policy = slot.empty ?? 'error';
+    if (value === null || value === undefined || (typeof value === 'string' && value.trim() === '')) {
+        const explicit = value === null;
+        if (policy === 'keep' && !explicit)
+            return { action: { type: 'keep' } };
+        if (policy === 'drop')
+            return { action: { type: 'remove' } };
+        if (policy === 'error')
+            return { error: 'this slot is required' };
+        if (layout !== 'adaptive')
+            return { error: "leaving this slot empty needs layout: 'adaptive'" };
+        return { action: { type: 'remove' } };
+    }
+    if (slot.kind === 'table') {
+        if (!isTableValue(value))
+            return { error: 'expected a table such as { "header": [...], "rows": [[...]] }' };
+        const header = value.header.map((cell) => String(cell ?? '').trim());
+        if (header.length === 0)
+            return { error: 'the table has no columns' };
+        const rows = value.rows.map((row) => row.map((cell) => String(cell ?? '').trim()));
+        const uneven = rows.findIndex((row) => row.length !== header.length);
+        if (uneven >= 0)
+            return { error: `row ${uneven + 1} has ${rows[uneven]?.length} cells; the table has ${header.length} columns` };
+        return { action: { type: 'table', table: { header, rows } } };
+    }
+    if (slot.kind === 'chart') {
+        if (!isChartValue(value)) {
+            return { error: 'expected a chart such as { "type": "column", "categories": [...], "series": [{ "name": "...", "values": [...] }] }' };
+        }
+        if (!['column', 'bar', 'line', 'pie'].includes(value.type))
+            return { error: `unknown chart type "${String(value.type)}"` };
+        const categories = value.categories.map((category) => String(category ?? '').trim());
+        if (categories.length === 0)
+            return { error: 'the chart has no categories' };
+        const series = value.series.map((entry) => ({
+            name: String(entry?.name ?? '').trim(),
+            values: (Array.isArray(entry?.values) ? entry.values : []).map(Number),
+        }));
+        if (series.length === 0)
+            return { error: 'the chart has no series' };
+        for (const entry of series) {
+            const label = entry.name ? `series "${entry.name}"` : 'a series';
+            if (entry.values.length !== categories.length) {
+                return { error: `${label} has ${entry.values.length} values; the chart has ${categories.length} categories` };
+            }
+            if (entry.values.some((number) => !Number.isFinite(number)))
+                return { error: `${label} has a value that is not a number` };
+        }
+        if (value.type === 'pie' && series.length > 1)
+            return { error: 'a pie chart takes exactly one series' };
+        const chart = { type: value.type, categories, series };
+        if (value.format === 'percent' || value.format === 'number')
+            chart.format = value.format;
+        return { action: { type: 'chart', chart } };
+    }
+    if (slot.kind === 'text') {
+        if (isImageRef(value) || isTableValue(value) || isChartValue(value))
+            return { error: 'expected text' };
+        const paragraphs = toParagraphs(value).filter((paragraph) => paragraph !== '');
+        if (paragraphs.length === 0)
+            return { error: 'this slot is required' };
+        return { action: { type: 'text', paragraphs } };
+    }
+    if (!isImageRef(value))
+        return { error: 'expected an image reference such as { "asset": "id" }' };
+    return { action: { type: 'image', image: value } };
+}
+/** Checks a deck against a manifest. Errors block rendering; warnings do not. */
+export function validateDeck(manifest, deck, options = {}) {
+    const issues = [];
+    const layout = options.layout ?? 'strict';
+    const assets = options.assets ? new Set(options.assets) : undefined;
+    const patterns = new Map(manifest.patterns.map((pattern) => [pattern.id, pattern]));
+    const mirrored = (deck.direction ?? manifest.direction) !== manifest.direction;
+    if (!Array.isArray(deck.slides) || deck.slides.length === 0) {
+        issues.push({ severity: 'error', message: 'the deck has no slides' });
+        return issues;
+    }
+    deck.slides.forEach((slide, index) => {
+        const number = index + 1;
+        const pattern = patterns.get(slide.pattern);
+        if (!pattern) {
+            issues.push({
+                severity: 'error',
+                slide: number,
+                message: `unknown pattern "${slide.pattern}" (available: ${[...patterns.keys()].join(', ')})`,
+            });
+            return;
+        }
+        const range = itemRange(pattern);
+        if (slide.items !== undefined && !range) {
+            issues.push({ severity: 'warning', slide: number, message: `pattern "${pattern.id}" has a fixed number of items; "items" is ignored` });
+        }
+        if (range && slide.items !== undefined && (!Number.isInteger(slide.items) || slide.items < range.min || slide.items > range.max)) {
+            issues.push({
+                severity: 'error',
+                slide: number,
+                message: `pattern "${pattern.id}" takes ${range.min} to ${range.max} ${pattern.repeat?.item ?? 'item'}s, not ${slide.items}`,
+            });
+            return;
+        }
+        const slots = effectiveSlots(pattern, slide.items);
+        const known = new Set(slots.map((slot) => slot.name));
+        for (const name of Object.keys(slide.slots ?? {})) {
+            if (!known.has(name)) {
+                issues.push({ severity: 'warning', slide: number, slot: name, message: `pattern "${pattern.id}" has no such slot; ignored` });
+            }
+        }
+        const sources = slotSources(pattern, mirrored, slide.items);
+        for (const slot of slots) {
+            // Problems are reported under the name the deck used, which differs across a mirrored sequence.
+            const source = sources.get(slot.name) ?? slot.name;
+            const resolved = resolveSlot(slot, { ...slide, slots: slide.slots ?? {} }, deck, layout, source);
+            if ('error' in resolved) {
+                issues.push({ severity: 'error', slide: number, slot: source, message: resolved.error });
+                continue;
+            }
+            const action = resolved.action;
+            if (action.type === 'text' && slot.kind === 'text') {
+                // Larger deck text leaves less room in the same box.
+                const budget = textBudget(slot, deck.textScale);
+                const chars = action.paragraphs.reduce((sum, paragraph) => sum + paragraph.length, 0);
+                if (budget.maxChars !== undefined && chars > budget.maxChars) {
+                    issues.push({
+                        severity: 'warning',
+                        slide: number,
+                        slot: source,
+                        message: `text is ${chars} characters; the slot fits about ${budget.maxChars}`,
+                    });
+                }
+                if (budget.maxParagraphs !== undefined && action.paragraphs.length > budget.maxParagraphs) {
+                    issues.push({
+                        severity: 'warning',
+                        slide: number,
+                        slot: source,
+                        message: `text has ${action.paragraphs.length} paragraphs; the slot fits ${budget.maxParagraphs}`,
+                    });
+                }
+            }
+            if (action.type === 'table' && slot.kind === 'table') {
+                const { header, rows } = action.table;
+                const warn = (message) => issues.push({ severity: 'warning', slide: number, slot: source, message });
+                if (slot.maxColumns !== undefined && header.length > slot.maxColumns)
+                    warn(`the table has ${header.length} columns; the slot fits ${slot.maxColumns}`);
+                if (slot.maxRows !== undefined && rows.length > slot.maxRows)
+                    warn(`the table has ${rows.length} rows; the slot fits ${slot.maxRows}`);
+                const longest = Math.max(0, ...[header, ...rows].flat().map((cell) => cell.length));
+                if (slot.maxCellChars !== undefined && longest > slot.maxCellChars)
+                    warn(`a cell is ${longest} characters; cells fit about ${slot.maxCellChars}`);
+            }
+            if (action.type === 'chart' && slot.kind === 'chart') {
+                const { categories, series } = action.chart;
+                const warn = (message) => issues.push({ severity: 'warning', slide: number, slot: source, message });
+                if (slot.maxCategories !== undefined && categories.length > slot.maxCategories) {
+                    warn(`the chart has ${categories.length} categories; the slot fits ${slot.maxCategories}`);
+                }
+                if (slot.maxSeries !== undefined && series.length > slot.maxSeries)
+                    warn(`the chart has ${series.length} series; the slot fits ${slot.maxSeries}`);
+            }
+            if (action.type === 'image' && assets && !assets.has(action.image.asset)) {
+                issues.push({ severity: 'error', slide: number, slot: source, message: `asset "${action.image.asset}" was not provided` });
+            }
+        }
+    });
+    return issues;
+}
+//# sourceMappingURL=validate.js.map

package/dist/deck/validate.js.map

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

package/dist/generate.d.ts

@@ -0,0 +1,53 @@
+import type { Issue } from './deck/validate.ts';
+import type { DeckSpec } from './deck/spec.ts';
+import type { ImageProvider } from './llm/provider.ts';
+import type { EditOptions } from './plan/edit.ts';
+import type { Brief, OutlineEntry, PlanOptions, PlanProgress } from './plan/plan.ts';
+import type { Template } from './render/render.ts';
+export type GenerateProgress = PlanProgress | {
+    stage: 'images';
+    done: number;
+    total: number;
+} | {
+    stage: 'render';
+};
+interface PictureOptions {
+    /** Generates photos. Without it, and without supplied photos, new slides are planned with no photos. */
+    images?: ImageProvider;
+    /** Generated pictures by asset id; reuse it across calls to avoid generating the same picture twice. */
+    cache?: Map<string, Uint8Array>;
+    /** How many pictures to generate at once. Defaults to 3. */
+    imageConcurrency?: number;
+    onProgress?: (event: GenerateProgress) => void;
+}
+export interface GenerateOptions extends Omit<PlanOptions, 'onProgress'>, PictureOptions {
+}
+export interface GenerateResult {
+    pptx: Uint8Array;
+    /** The deck as JSON. Store it: it is what gets edited and re-rendered. */
+    deck: DeckSpec;
+    /** Every picture the deck uses, by asset id. */
+    assets: Record<string, Uint8Array>;
+    warnings: Issue[];
+    outline: OutlineEntry[];
+}
+export interface EditDeckOptions extends Omit<EditOptions, 'onProgress'>, PictureOptions {
+}
+export interface EditDeckResult {
+    pptx: Uint8Array;
+    deck: DeckSpec;
+    assets: Record<string, Uint8Array>;
+    warnings: Issue[];
+    /** One sentence from the model on what it changed. */
+    summary: string;
+    /** Slide numbers in the new deck that were written or rewritten. */
+    rewritten: number[];
+}
+/** Brief in, pptx out: plans the deck with the language model, gathers its pictures and renders it. */
+export declare function generateDeck(template: Template, brief: Brief, options: GenerateOptions): Promise<GenerateResult>;
+/**
+ * Applies an instruction to an existing deck and renders the result. Pass the pictures of the
+ * earlier version in `cache` (see `extractAssets`) so unchanged photos are not generated again.
+ */
+export declare function editDeck(template: Template, deck: DeckSpec, instruction: string, options: EditDeckOptions): Promise<EditDeckResult>;
+export {};

package/dist/generate.js

@@ -0,0 +1,44 @@
+import { resolveAssets } from './plan/assets.js';
+import { planEdit } from './plan/edit.js';
+import { planDeck } from './plan/plan.js';
+import { renderDeck } from './render/render.js';
+function canMakePhotos(options) {
+    return !!options.images || (options.assets ?? []).some((asset) => asset.kind === 'photo');
+}
+async function picturesAndPptx(template, deck, options) {
+    const resolve = {};
+    if (options.images)
+        resolve.images = options.images;
+    if (options.icons)
+        resolve.icons = options.icons;
+    if (options.assets)
+        resolve.assets = options.assets;
+    if (options.cache)
+        resolve.cache = options.cache;
+    if (options.imageConcurrency)
+        resolve.concurrency = options.imageConcurrency;
+    if (options.onProgress)
+        resolve.onProgress = options.onProgress;
+    if (options.signal)
+        resolve.signal = options.signal;
+    const assets = await resolveAssets(template, deck, resolve);
+    options.onProgress?.({ stage: 'render' });
+    const rendered = renderDeck(template, deck, options.layout ? { assets, layout: options.layout } : { assets });
+    return { pptx: rendered.pptx, assets };
+}
+/** Brief in, pptx out: plans the deck with the language model, gathers its pictures and renders it. */
+export async function generateDeck(template, brief, options) {
+    const plan = await planDeck(template, canMakePhotos(options) ? brief : { ...brief, imageDensity: 'none' }, options);
+    const output = await picturesAndPptx(template, plan.deck, options);
+    return { ...output, deck: plan.deck, warnings: plan.warnings, outline: plan.outline };
+}
+/**
+ * Applies an instruction to an existing deck and renders the result. Pass the pictures of the
+ * earlier version in `cache` (see `extractAssets`) so unchanged photos are not generated again.
+ */
+export async function editDeck(template, deck, instruction, options) {
+    const edit = await planEdit(template, deck, instruction, canMakePhotos(options) ? options : { ...options, imageDensity: 'none' });
+    const output = await picturesAndPptx(template, edit.deck, options);
+    return { ...output, deck: edit.deck, warnings: edit.warnings, summary: edit.summary, rewritten: edit.rewritten };
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAwChD,SAAS,aAAa,CAAC,OAA8D;IACnF,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;AAC5F,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,QAAkB,EAClB,IAAc,EACd,OAA6D;IAE7D,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpD,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACjD,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpD,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACjD,IAAI,OAAO,CAAC,gBAAgB;QAAE,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAC7E,IAAI,OAAO,CAAC,UAAU;QAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAChE,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACpD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE5D,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9G,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAkB,EAAE,KAAY,EAAE,OAAwB;IAC3F,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACpH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnE,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;AACxF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAkB,EAAE,IAAc,EAAE,WAAmB,EAAE,OAAwB;IAC9G,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IAClI,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnE,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;AACnH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+export { editDeck, generateDeck } from './generate.ts';
+export type { EditDeckOptions, EditDeckResult, GenerateOptions, GenerateProgress, GenerateResult } from './generate.ts';
+export { TOOL_NAMES, presentationTools, storeKeys } from './tools.ts';
+export type { PresentationTools, PresentationToolsOptions, ToolDefinition, ToolResult } from './tools.ts';
+export { memoryStore } from './store.ts';
+export type { BlobStore } from './store.ts';
+export { PlanError, directionOf, editPlan, planDeck, planOutline, writeDeck } from './plan/plan.ts';
+export type { Brief, DeckPlan, OutlineEntry, PlanOptions, PlanProgress, PlanResult } from './plan/plan.ts';
+export { planEdit } from './plan/edit.ts';
+export type { EditOptions, EditResult } from './plan/edit.ts';
+export { resolveAssets } from './plan/assets.ts';
+export type { ResolveOptions } from './plan/assets.ts';
+export { extractAssets } from './render/extract.ts';
+export type { AssetDef, IconDef, ImageDensity } from './plan/catalog.ts';
+export { loadTemplate, renderDeck } from './render/render.ts';
+export type { RenderOptions, RenderResult, Template } from './render/render.ts';
+export type { ImageProvider, ImageRequest, JsonRequest, JsonSchema, LlmProvider } from './llm/provider.ts';
+export { GEMINI_DEVELOPER_ENDPOINT, GeminiError, gemini, geminiImages, vertexEndpoint } from './llm/gemini.ts';
+export type { GeminiImageOptions, GeminiOptions } from './llm/gemini.ts';
+export { DeckValidationError, validateDeck } from './deck/validate.ts';
+export type { Issue, LayoutMode, ValidateOptions } from './deck/validate.ts';
+export type { ChartType, ChartValue, DeckSpec, ImageRef, SlideSpec, SlotValue, TableValue } from './deck/spec.ts';
+export { isChartValue, isImageRef, isTableValue } from './deck/spec.ts';
+export { draftManifest } from './template/draft.ts';
+export type { DraftOptions, DraftResult, SlidePicture } from './template/draft.ts';
+export { checkManifest } from './template/check.ts';
+export type { ManifestIssue } from './template/check.ts';
+export { sampleDeck } from './template/sample.ts';
+export type { SampleOptions } from './template/sample.ts';
+export { changeManifest, describeSlot } from './template/change.ts';
+export type { ChangeResult, ManifestChange, SlotPatch } from './template/change.ts';
+export { describeManifest, editManifest } from './template/instruct.ts';
+export type { ManifestEditOptions, ManifestEditResult } from './template/instruct.ts';
+export { studioView } from './template/view.ts';
+export type { StudioShape, StudioSlide, StudioView } from './template/view.ts';
+export { ROLES } from './template/measure.ts';
+export type { Role } from './template/measure.ts';
+export { inspectTemplate } from './template/inspect.ts';
+export type { Box, ShapeInfo, ShapeKind, SlideInfo, TemplateInfo } from './template/inspect.ts';
+export type { AlignPolicy, ChartSlotDef, Direction, EmptyPolicy, ImageKind, ImageSlotDef, PatternDef, RepeatDef, SlideBox, SlotDef, TableSlotDef, TableTextStyle, TemplateManifest, TextSize, TextSlotDef, } from './template/manifest.ts';
+export { TEXT_SIZES } from './template/manifest.ts';
+export { PptxPackage } from './pptx/package.ts';

package/dist/index.js

@@ -0,0 +1,27 @@
+// Brief in, pptx out; and an instruction applied to an existing deck.
+export { editDeck, generateDeck } from './generate.js';
+// Tools for a chat model: plan, change the plan, create, change the deck.
+export { TOOL_NAMES, presentationTools, storeKeys } from './tools.js';
+export { memoryStore } from './store.js';
+// The steps of generateDeck, usable on their own.
+export { PlanError, directionOf, editPlan, planDeck, planOutline, writeDeck } from './plan/plan.js';
+export { planEdit } from './plan/edit.js';
+export { resolveAssets } from './plan/assets.js';
+export { extractAssets } from './render/extract.js';
+export { loadTemplate, renderDeck } from './render/render.js';
+export { GEMINI_DEVELOPER_ENDPOINT, GeminiError, gemini, geminiImages, vertexEndpoint } from './llm/gemini.js';
+// Decks.
+export { DeckValidationError, validateDeck } from './deck/validate.js';
+export { isChartValue, isImageRef, isTableValue } from './deck/spec.js';
+// Templates.
+export { draftManifest } from './template/draft.js';
+export { checkManifest } from './template/check.js';
+export { sampleDeck } from './template/sample.js';
+export { changeManifest, describeSlot } from './template/change.js';
+export { describeManifest, editManifest } from './template/instruct.js';
+export { studioView } from './template/view.js';
+export { ROLES } from './template/measure.js';
+export { inspectTemplate } from './template/inspect.js';
+export { TEXT_SIZES } from './template/manifest.js';
+export { PptxPackage } from './pptx/package.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGvD,0EAA0E;AAC1E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,kDAAkD;AAClD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEpG,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAK9D,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG/G,SAAS;AACT,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAExE,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAmBxD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/llm/gemini.d.ts

@@ -0,0 +1,39 @@
+import type { ImageProvider, LlmProvider } from './provider.ts';
+export declare const GEMINI_DEVELOPER_ENDPOINT = "https://generativelanguage.googleapis.com/v1/interactions";
+/** Endpoint of the Interactions API on Vertex AI. Authenticate with a bearer token via `headers`. */
+export declare function vertexEndpoint(project: string, location?: string): string;
+type Headers = Record<string, string>;
+interface GeminiConnection {
+    model: string;
+    /** Gemini Developer API key, sent as `x-goog-api-key`. */
+    apiKey?: string;
+    /** Interactions endpoint. Defaults to the Developer API; use {@link vertexEndpoint} for Vertex AI. */
+    endpoint?: string;
+    /** Extra headers, or a function returning them, e.g. a fresh `Authorization: Bearer` token. */
+    headers?: Headers | (() => Headers | Promise<Headers>);
+    /** Custom fetch, for proxies and tests. */
+    fetch?: typeof fetch;
+    /** Gives up on a request that has not answered after this long. Defaults to 3 minutes; 0 waits for ever. */
+    timeoutMs?: number;
+}
+export interface GeminiOptions extends GeminiConnection {
+    thinkingLevel?: 'minimal' | 'low' | 'medium' | 'high';
+    maxOutputTokens?: number;
+}
+export interface GeminiImageOptions extends GeminiConnection {
+    /** Output size class. Defaults to `1K`. */
+    imageSize?: '512' | '1K' | '2K' | '4K';
+    /** Appended to every prompt, e.g. a house photo style. */
+    style?: string;
+}
+export declare class GeminiError extends Error {
+    readonly status: number | undefined;
+    constructor(message: string, status?: number);
+}
+/** A Gemini text model as an {@link LlmProvider}. */
+export declare function gemini(options: GeminiOptions): LlmProvider;
+/** The supported output ratio closest to the frame (compared on a log scale, so 2:1 and 1:2 are equally far from 1:1). */
+export declare function nearestAspectRatio(ratio: number): string;
+/** A Gemini image model as an {@link ImageProvider}. */
+export declare function geminiImages(options: GeminiImageOptions): ImageProvider;
+export {};