slotdeck 0.0.0-stage → 0.1.0

package/dist/plan/plan.js

@@ -0,0 +1,243 @@
+import { unstatedChartValues } from '../deck/numbers.js';
+import { DeckValidationError } from '../deck/validate.js';
+import { TEXT_SIZES } from '../template/manifest.js';
+import { buildCatalog, describeCatalog, itemsProperty, outlineSchema, planPattern, readItems } from './catalog.js';
+import { cleanText, suppliesText, systemPrompt, writeSlides } from './write.js';
+export class PlanError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PlanError';
+    }
+}
+const RTL_LANGUAGES = new Set(['ar', 'dv', 'fa', 'he', 'ps', 'sd', 'ug', 'ur', 'yi']);
+export function directionOf(language) {
+    return RTL_LANGUAGES.has(language.toLowerCase().split('-')[0] ?? '') ? 'rtl' : 'ltr';
+}
+/** Whether a text contains any digit, in any script. */
+export function hasFigures(text) {
+    return /\p{Nd}/u.test(text);
+}
+/** Binds a provider to a system prompt and an optional abort signal. */
+export function asker(llm, system, signal) {
+    return (prompt, schema) => llm.generateJson(signal ? { system, prompt, schema, signal } : { system, prompt, schema });
+}
+const DENSITY_GUIDANCE = {
+    none: 'Do not plan any photos.',
+    low: 'Use a pattern with a photo on at most a quarter of the slides.',
+    medium: 'Use a pattern with a photo on about half of the slides.',
+    high: 'Prefer patterns with a photo wherever they suit the content.',
+};
+function briefText(brief) {
+    return [`Brief:\n${brief.prompt.trim()}`, brief.instructions?.trim() ? `Also respect:\n${brief.instructions.trim()}` : '']
+        .filter(Boolean)
+        .join('\n\n');
+}
+function outlinePrompt(brief, catalog, count, density, textScale = 1) {
+    const size = count.min === count.max ? `exactly ${count.min}` : `${count.min} to ${count.max}`;
+    return [
+        briefText(brief),
+        `Plan a deck of ${size} slides. Choose one pattern for each slide from this list ("?" marks an optional slot):`,
+        describeCatalog(catalog, textScale),
+        [
+            '- Open with an opening pattern and end with a closing pattern when the list has them.',
+            '- For a pattern with a row of items, set "items" to the number the content really has. Do not pad a list to fill a row.',
+            '- Choose a pattern only when the content can fill every required slot within its limits.',
+            '- Vary the patterns across the deck.',
+            `- ${DENSITY_GUIDANCE[density]}`,
+        ].join('\n'),
+    ].join('\n\n');
+}
+function writePrompt(brief, items, context) {
+    const slides = items.map(({ number, pattern, purpose }) => `s${number}: ${pattern.def.id}. ${purpose}`).join('\n');
+    return [
+        briefText(brief),
+        `Write the content of each slide of this deck:\n${slides}`,
+        ...suppliesText(items, context),
+        'Fill every required property. Leave an optional property out when the slide is better without it.',
+    ].join('\n\n');
+}
+/** Everything the planning stages derive from a brief and the caller's options, so they cannot disagree. */
+function planning(template, brief, options) {
+    const { manifest } = template;
+    const layout = options.layout ?? 'strict';
+    const language = brief.language ?? manifest.language ?? 'en';
+    const direction = brief.direction ?? directionOf(language);
+    const density = brief.imageDensity ?? 'medium';
+    const fields = brief.fields ?? {};
+    const numbers = options.numberPatterns ?? 'from-brief';
+    const figures = numbers === 'always' || (numbers === 'from-brief' && hasFigures(`${brief.prompt} ${brief.instructions ?? ''}`));
+    const textScale = TEXT_SIZES[brief.textSize ?? 'normal'] ?? 1;
+    const context = { layout, fields, icons: options.icons ?? [], assets: options.assets ?? [], imageDensity: density, figures, textScale };
+    if (options.patterns)
+        context.allow = options.patterns;
+    const catalog = buildCatalog(manifest, context);
+    if (catalog.patterns.length === 0) {
+        const reasons = catalog.excluded.map((entry) => `${entry.id} ${entry.reason}`).join('; ');
+        throw new PlanError(`No pattern of template "${manifest.name}" can be used${reasons ? `: ${reasons}` : ''}`);
+    }
+    return { layout, language, direction, density, fields, context, catalog, byId: new Map(catalog.patterns.map((pattern) => [pattern.def.id, pattern])) };
+}
+function readOutline(answer, byId) {
+    const raw = answer;
+    const list = Array.isArray(raw?.slides) ? raw.slides : [];
+    const problems = [];
+    const entries = list.map((item, index) => {
+        const raw = item;
+        const entry = { pattern: cleanText(raw?.pattern), purpose: cleanText(raw?.purpose) };
+        const pattern = byId.get(entry.pattern);
+        if (pattern) {
+            const count = readItems(pattern.def, raw?.items);
+            if (count.problem)
+                problems.push(`slide ${index + 1}: ${count.problem}`);
+            if (count.items !== undefined)
+                entry.items = count.items;
+        }
+        return entry;
+    });
+    const unknown = entries.filter((entry) => !byId.has(entry.pattern)).map((entry) => entry.pattern || '(empty)');
+    const outline = { title: cleanText(raw?.title), entries };
+    if (entries.length === 0)
+        return { ...outline, problem: 'the answer contained no slides' };
+    if (unknown.length > 0)
+        return { ...outline, problem: `these patterns are not in the list: ${[...new Set(unknown)].join(', ')}` };
+    if (problems.length > 0)
+        return { ...outline, problem: problems.join('; ') };
+    return outline;
+}
+/**
+ * First stage: decides which pattern each slide uses and the point it makes. One model call.
+ * The result is small and quick to produce, so it is the thing to show a person and let them change.
+ */
+export async function planOutline(template, brief, options) {
+    const { language, density, catalog, byId, context } = planning(template, brief, options);
+    const count = typeof brief.slideCount === 'number'
+        ? { min: brief.slideCount, max: brief.slideCount }
+        : (brief.slideCount ?? { min: 6, max: 10 });
+    const ask = asker(options.llm, systemPrompt(language, 'brief'), options.signal);
+    options.onProgress?.({ stage: 'outline' });
+    const request = outlinePrompt(brief, catalog, count, density, context.textScale);
+    let outline = readOutline(await ask(request, outlineSchema(catalog, count)), byId);
+    if (outline.problem) {
+        const retry = `${request}\n\nYour previous answer could not be used: ${outline.problem}. Answer again using only the listed patterns.`;
+        outline = readOutline(await ask(retry, outlineSchema(catalog, count)), byId);
+        if (outline.problem)
+            throw new PlanError(`The model did not produce a usable outline: ${outline.problem}`);
+    }
+    return { version: 1, title: outline.title, brief, slides: outline.entries };
+}
+/**
+ * Changes a plan by instruction ("add a slide about pricing", "make it shorter", "in English").
+ * One model call. The instruction is kept with the brief, so facts it adds reach the writing stage.
+ */
+export async function editPlan(template, plan, instruction, options) {
+    const request = instruction.trim();
+    const brief = { ...plan.brief, instructions: [plan.brief.instructions?.trim(), request].filter(Boolean).join('\n') };
+    const { language, density, catalog, byId, context } = planning(template, brief, options);
+    options.onProgress?.({ stage: 'outline' });
+    const prompt = [
+        briefText(plan.brief),
+        `The plan as it is now${plan.title ? ` ("${plan.title}")` : ''}, in the language with BCP 47 tag "${language}":\n${plan.slides
+            .map((slide, index) => `${index + 1}. ${slide.pattern}${slide.items !== undefined ? ` (${slide.items} items)` : ''}: ${slide.purpose}`)
+            .join('\n')}`,
+        `Requested change:\n${request}`,
+        `Return the whole plan after the change. Choose patterns from this list ("?" marks an optional slot):`,
+        describeCatalog(catalog, context.textScale),
+        [
+            '- Change only what the request asks for. Keep every other slide, its pattern, its purpose and its place.',
+            '- Choose a pattern only when the content can fill every required slot within its limits.',
+            `- ${DENSITY_GUIDANCE[density]}`,
+        ].join('\n'),
+    ].join('\n\n');
+    const schema = {
+        type: 'object',
+        properties: {
+            summary: { type: 'string', description: 'One sentence saying what you changed, written for the person who asked, in their language' },
+            language: { type: 'string', description: 'BCP 47 tag of the deck language after the change' },
+            title: { type: 'string', description: 'Title of the deck after the change' },
+            slides: {
+                type: 'array',
+                minItems: 1,
+                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: ['summary', 'language', 'title', 'slides'],
+    };
+    const ask = asker(options.llm, systemPrompt(language, 'brief'), options.signal);
+    let answer = (await ask(prompt, schema));
+    let outline = readOutline(answer, byId);
+    if (outline.problem) {
+        answer = (await ask(`${prompt}\n\nYour previous answer could not be used: ${outline.problem}. Answer again using only the listed patterns.`, schema));
+        outline = readOutline(answer, byId);
+        if (outline.problem)
+            throw new PlanError(`The model did not produce a usable plan: ${outline.problem}`);
+    }
+    const nextLanguage = cleanText(answer?.language) || language;
+    if (nextLanguage !== language) {
+        brief.language = nextLanguage;
+        delete brief.direction; // follows the new language
+    }
+    delete brief.slideCount; // the plan itself now says how many slides there are
+    return { plan: { version: 1, title: outline.title || plan.title, brief, slides: outline.entries }, summary: cleanText(answer?.summary) };
+}
+/**
+ * Second stage: writes the content of every slot of a plan's slides, against a schema built for
+ * exactly that sequence. Drafts that break the template's limits go back to the model.
+ */
+export async function writeDeck(template, plan, options) {
+    const { brief } = plan;
+    const { layout, language, direction, fields, context, byId } = planning(template, brief, options);
+    const missing = plan.slides.filter((slide) => !byId.has(slide.pattern)).map((slide) => slide.pattern);
+    if (missing.length > 0) {
+        throw new PlanError(`The plan uses patterns that cannot be filled with what was supplied: ${[...new Set(missing)].join(', ')}`);
+    }
+    const items = plan.slides.map((entry, index) => {
+        const usable = byId.get(entry.pattern);
+        // A row of items gets the slots of exactly the number the plan settled on.
+        const sized = entry.items !== undefined ? planPattern(usable.def, context, undefined, entry.items) : undefined;
+        return { number: index + 1, pattern: sized && 'pattern' in sized ? sized.pattern : usable, purpose: entry.purpose };
+    });
+    options.onProgress?.({ stage: 'write', slides: items.length });
+    const draft = await writeSlides({
+        ask: asker(options.llm, systemPrompt(language, 'brief'), options.signal),
+        request: writePrompt(brief, items, context),
+        jobs: items,
+        context,
+        assemble: (written) => {
+            const deck = {
+                version: 1,
+                language,
+                direction,
+                brief: [brief.prompt.trim(), brief.instructions?.trim()].filter(Boolean).join('\n'),
+                slides: items.map((item) => written.get(item.number) ?? { pattern: item.pattern.def.id, slots: {} }),
+            };
+            if (context.textScale !== 1)
+                deck.textScale = context.textScale;
+            if (plan.title)
+                deck.title = plan.title;
+            if (Object.keys(fields).length > 0)
+                deck.fields = fields;
+            return deck;
+        },
+        manifest: template.manifest,
+        layout,
+        maxRepairs: options.maxRepairs ?? 2,
+        onRepair: (attempt, issues) => options.onProgress?.({ stage: 'repair', attempt, issues }),
+    });
+    const errors = draft.issues.filter((issue) => issue.severity === 'error');
+    if (errors.length > 0)
+        throw new DeckValidationError(errors);
+    return { deck: draft.deck, warnings: [...draft.issues, ...unstatedChartValues(template.manifest, draft.deck)], outline: plan.slides };
+}
+/** Brief to deck spec in one go: {@link planOutline}, then {@link writeDeck}. */
+export async function planDeck(template, brief, options) {
+    return writeDeck(template, await planOutline(template, brief, options), options);
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan/plan.js.map

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

package/dist/plan/write.d.ts

@@ -0,0 +1,39 @@
+import type { Issue, LayoutMode } from '../deck/validate.ts';
+import type { DeckSpec, SlideSpec, SlotValue } from '../deck/spec.ts';
+import type { JsonSchema } from '../llm/provider.ts';
+import type { TemplateManifest } from '../template/manifest.ts';
+import type { CatalogContext, UsablePattern, WriteItem } from './catalog.ts';
+export declare function systemPrompt(language: string, source: 'brief' | 'deck'): string;
+export declare function cleanText(value: unknown): string;
+/** Stable short id for a generated picture, so the same description maps to the same asset across edits. */
+export declare function generatedAssetId(prompt: string): string;
+/** Turns the model's answer for one slide into a slide spec, tidying text on the way. */
+export declare function toSlide(pattern: UsablePattern, content: unknown, context: CatalogContext): SlideSpec;
+/** The icon and picture lists appended to a writing prompt, when the slides being written can use them. */
+export declare function suppliesText(items: WriteItem[], context: CatalogContext): string[];
+export interface WriteJob extends WriteItem {
+    /** Slot values taken over unchanged from an existing slide. They are not offered to the model. */
+    carried?: Record<string, SlotValue>;
+}
+export interface WriteArgs {
+    ask: (prompt: string, schema: JsonSchema) => Promise<unknown>;
+    /** The writing prompt. Repair rounds append the previous answer and its problems. */
+    request: string;
+    jobs: WriteJob[];
+    context: CatalogContext;
+    /** Builds the whole deck from the freshly written slides, keyed by slide number. */
+    assemble: (written: Map<number, SlideSpec>) => DeckSpec;
+    manifest: TemplateManifest;
+    layout: LayoutMode;
+    maxRepairs: number;
+    onRepair?: (attempt: number, issues: number) => void;
+}
+/**
+ * Asks for the content of the given slides and checks the resulting deck. Problems on the
+ * written slides go back to the model, up to `maxRepairs` times. Returns the last draft with
+ * every issue it still has; the caller decides what is fatal.
+ */
+export declare function writeSlides(args: WriteArgs): Promise<{
+    deck: DeckSpec;
+    issues: Issue[];
+}>;

package/dist/plan/write.js

@@ -0,0 +1,179 @@
+// The part of planning that planDeck and planEdit share: asking the model for the content of
+// a set of slides, turning its answer into slide specs, and sending drafts back for repair.
+import { validateDeck } from '../deck/validate.js';
+import { isImageRef } from '../deck/spec.js';
+import { readImageInfo } from '../util/image.js';
+import { contentSchema } from './catalog.js';
+export function systemPrompt(language, source) {
+    return [
+        "You write presentation decks for a fixed slide template. You do not design layouts: you choose from the template's slide patterns and write the content for their slots.",
+        '',
+        'Rules:',
+        `- Write all slide text in the language with BCP 47 tag "${language}".`,
+        '- Character limits are hard and count spaces. Stay under them. Slides carry short text: a phrase beats a sentence.',
+        '- Plain text only: no markdown, no bullet characters, no line breaks inside a string, no placeholder text.',
+        source === 'brief'
+            ? '- Every figure on a slide must come from the brief. Never make up statistics, quotes or names.'
+            : '- Every figure on a slide must come from the request or from the deck as it is. Never make up statistics, quotes or names.',
+        source === 'brief' ? '- Follow the brief. Do not add topics it does not call for.' : '- Do what the request asks and nothing more.',
+    ].join('\n');
+}
+export function cleanText(value) {
+    return String(value ?? '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** Stable short id for a generated picture, so the same description maps to the same asset across edits. */
+export function generatedAssetId(prompt) {
+    let a = 0x811c9dc5;
+    let b = 0x01000193;
+    for (let i = 0; i < prompt.length; i++) {
+        const code = prompt.charCodeAt(i);
+        a = Math.imul(a ^ code, 0x01000193);
+        b = Math.imul(b ^ code, 0x85ebca6b) + 0x9e3779b9;
+    }
+    const hex = (value) => (value >>> 0).toString(16).padStart(8, '0');
+    return `gen-${hex(a)}${hex(b)}`;
+}
+/** Turns the model's answer for one slide into a slide spec, tidying text on the way. */
+export function toSlide(pattern, content, context) {
+    const values = (typeof content === 'object' && content !== null ? content : {});
+    const slots = {};
+    for (const planned of pattern.slots) {
+        const value = values[planned.slot.name];
+        if (value === undefined || value === null)
+            continue;
+        if (planned.mode === 'text') {
+            slots[planned.slot.name] = cleanText(Array.isArray(value) ? value.join(' ') : value);
+        }
+        else if (planned.mode === 'paragraphs') {
+            const items = Array.isArray(value) ? value : String(value).split(/\r?\n/);
+            slots[planned.slot.name] = items.map((item) => cleanText(item).replace(/^[•\-–]\s+/, '')).filter(Boolean);
+        }
+        else if (planned.mode === 'table') {
+            const table = (typeof value === 'object' ? value : {});
+            const header = (Array.isArray(table.header) ? table.header : []).map(cleanText);
+            if (header.length === 0)
+                continue;
+            // A row the model made too short or too long is squared up rather than rejected.
+            const rows = (Array.isArray(table.rows) ? table.rows : [])
+                .filter((row) => Array.isArray(row))
+                .map((row) => header.map((_, index) => cleanText(row[index])));
+            slots[planned.slot.name] = { header, rows };
+        }
+        else if (planned.mode === 'chart') {
+            const chart = (typeof value === 'object' ? value : {});
+            const type = chart.type === 'bar' || chart.type === 'line' || chart.type === 'pie' ? chart.type : 'column';
+            const categories = (Array.isArray(chart.categories) ? chart.categories : []).map(cleanText);
+            const series = (Array.isArray(chart.series) ? chart.series : []).map((entry) => {
+                const item = (entry ?? {});
+                // Lengths are left as the model gave them: a short series is a problem to send back, not to pad.
+                return { name: cleanText(item.name), values: (Array.isArray(item.values) ? item.values : []).map(Number).filter(Number.isFinite) };
+            });
+            if (categories.length === 0 || series.length === 0)
+                continue;
+            slots[planned.slot.name] = chart.format === 'percent' ? { type, categories, series, format: 'percent' } : { type, categories, series };
+        }
+        else if (planned.mode === 'photo') {
+            if (typeof value !== 'object')
+                continue;
+            const photo = value;
+            const alt = cleanText(photo.alt);
+            const supplied = context.assets.find((asset) => asset.kind === 'photo' && asset.id === photo.asset);
+            const prompt = cleanText(photo.prompt);
+            let ref;
+            if (supplied)
+                ref = { asset: supplied.id };
+            else if (prompt)
+                ref = { asset: generatedAssetId(prompt), prompt };
+            if (!ref)
+                continue;
+            if (alt)
+                ref.alt = alt;
+            slots[planned.slot.name] = ref;
+        }
+        else {
+            slots[planned.slot.name] = { asset: cleanText(value) };
+        }
+    }
+    return { pattern: pattern.def.id, slots };
+}
+/** The icon and picture lists appended to a writing prompt, when the slides being written can use them. */
+export function suppliesText(items, context) {
+    const usesIcons = items.some(({ pattern }) => pattern.slots.some((planned) => planned.mode === 'icon'));
+    const usesPictures = items.some(({ pattern }) => pattern.slots.some((planned) => planned.mode === 'photo' || planned.mode === 'graphic'));
+    return [
+        usesIcons ? `Icons to choose from:\n${context.icons.map((icon) => `- ${icon.id}: ${icon.description}`).join('\n')}` : '',
+        usesPictures && context.assets.length > 0
+            ? `Supplied pictures. Match a picture's proportions to the slide: a wide picture for a wide area.\n${context.assets
+                .map((asset) => `- ${asset.id} (${asset.kind}, ${proportions(asset.data)}): ${asset.description}`)
+                .join('\n')}`
+            : '',
+    ].filter(Boolean);
+}
+/** A picture's shape in words the model can match to a slide, e.g. "wide, 3.2:1". */
+function proportions(data) {
+    try {
+        const { width, height } = readImageInfo(data);
+        const ratio = width / height;
+        const shape = ratio >= 2 ? 'wide' : ratio > 1.15 ? 'landscape' : ratio >= 0.87 ? 'square' : 'portrait';
+        return `${shape}, ${ratio >= 1 ? `${Math.round(ratio * 10) / 10}:1` : `1:${Math.round((1 / ratio) * 10) / 10}`}`;
+    }
+    catch {
+        return 'unknown size';
+    }
+}
+/** Ids the renderer will be able to resolve: supplied icons and assets, plus pictures that carry a description. */
+function knownAssets(deck, context) {
+    const known = new Set([...context.icons.map((icon) => icon.id), ...context.assets.map((asset) => asset.id)]);
+    for (const slide of deck.slides) {
+        for (const value of Object.values(slide.slots)) {
+            if (isImageRef(value) && value.prompt)
+                known.add(value.asset);
+        }
+    }
+    return known;
+}
+/**
+ * Asks for the content of the given slides and checks the resulting deck. Problems on the
+ * written slides go back to the model, up to `maxRepairs` times. Returns the last draft with
+ * every issue it still has; the caller decides what is fatal.
+ */
+export async function writeSlides(args) {
+    const { jobs, context } = args;
+    const schema = contentSchema(jobs, context);
+    const numbers = new Set(jobs.map((job) => job.number));
+    const build = (answer) => {
+        const content = (typeof answer === 'object' && answer !== null ? answer : {});
+        const written = new Map();
+        for (const job of jobs) {
+            const slide = toSlide(job.pattern, content[`s${job.number}`], context);
+            const next = { pattern: slide.pattern, slots: { ...job.carried, ...slide.slots } };
+            if (job.pattern.items !== undefined)
+                next.items = job.pattern.items;
+            written.set(job.number, next);
+        }
+        const deck = args.assemble(written);
+        return { deck, issues: validateDeck(args.manifest, deck, { layout: args.layout, assets: knownAssets(deck, context) }) };
+    };
+    // Only slides that were just written can be fixed by asking again.
+    const repairable = (issues) => issues.filter((issue) => issue.slide !== undefined && numbers.has(issue.slide));
+    let answer = await args.ask(args.request, schema);
+    let draft = build(answer);
+    for (let attempt = 1; attempt <= args.maxRepairs; attempt++) {
+        const problems = repairable(draft.issues);
+        if (problems.length === 0)
+            break;
+        args.onRepair?.(attempt, problems.length);
+        const repair = [
+            args.request,
+            `Your previous answer:\n${JSON.stringify(answer)}`,
+            `It has these problems:\n${problems.map((issue) => `- s${issue.slide}${issue.slot ? `.${issue.slot}` : ''}: ${issue.message}`).join('\n')}`,
+            'Return the full content again with these problems fixed. Change nothing else.',
+        ].join('\n\n');
+        answer = await args.ask(repair, schema);
+        draft = build(answer);
+    }
+    return draft;
+}
+//# sourceMappingURL=write.js.map

package/dist/plan/write.js.map

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

package/dist/pptx/package.d.ts

@@ -0,0 +1,48 @@
+/** An Office Open XML package: a flat map of part path to bytes. */
+export declare class PptxPackage {
+    private readonly files;
+    private constructor();
+    static load(bytes: Uint8Array): PptxPackage;
+    /** Cheap copy: the byte arrays are shared and must be treated as immutable. */
+    clone(): PptxPackage;
+    has(partPath: string): boolean;
+    paths(): string[];
+    read(partPath: string): Uint8Array;
+    readText(partPath: string): string;
+    write(partPath: string, data: Uint8Array | string): void;
+    delete(partPath: string): void;
+    save(): Uint8Array;
+}
+export interface Relationship {
+    id: string;
+    type: string;
+    target: string;
+    external: boolean;
+}
+/** `ppt/slides/slide1.xml` -> `ppt/slides/_rels/slide1.xml.rels`; the package root is `''`. */
+export declare function relsPath(partPath: string): string;
+/** Inverse of {@link relsPath}, or `undefined` when the path is not a relationships part. */
+export declare function relsOwner(path: string): string | undefined;
+export declare function readRels(pkg: PptxPackage, partPath: string): Relationship[];
+export declare function writeRels(pkg: PptxPackage, partPath: string, rels: Relationship[]): void;
+/** True when the relationship type ends with the given name, e.g. `isRelType(rel, 'slide')`. */
+export declare function isRelType(rel: Relationship, name: string): boolean;
+export declare function nextRelId(rels: Relationship[]): string;
+/** Resolves a relationship target against the part that owns it. */
+export declare function resolveTarget(partPath: string, target: string): string;
+/** The relative target that points from one part to another. */
+export declare function relativeTarget(fromPart: string, toPart: string): string;
+export declare class ContentTypes {
+    private readonly defaults;
+    private readonly overrides;
+    static read(pkg: PptxPackage): ContentTypes;
+    ensureDefault(extension: string, contentType: string): void;
+    /** `partPath` is the package path without a leading slash. */
+    setOverride(partPath: string, contentType: string): void;
+    removeOverride(partPath: string): void;
+    save(pkg: PptxPackage): void;
+}
+/** Every part that can be reached from the package root by following relationships. */
+export declare function reachableParts(pkg: PptxPackage): Set<string>;
+/** Deletes parts nothing points to any more (old slides, their notes, unused media). */
+export declare function pruneUnreachable(pkg: PptxPackage, types: ContentTypes): void;