@qvac/harness 0.7.3 → 0.8.0

package/dist-lib/lib/office/engine/pptx/template.js

@@ -0,0 +1,391 @@
+import * as xml from '../xml.js';
+import { DocsError } from '../errors.js';
+import { isRecord } from '../../../guards.js';
+const { a: A, p: P, r: R } = xml.ns;
+const REL_BASE = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/';
+const PML = 'application/vnd.openxmlformats-officedocument.presentationml.';
+const TYPES = {
+    presentation: PML + 'presentation.main+xml',
+    master: PML + 'slideMaster+xml',
+    layout: PML + 'slideLayout+xml',
+    presProps: PML + 'presProps+xml',
+    viewProps: PML + 'viewProps+xml',
+    tableStyles: PML + 'tableStyles+xml',
+    theme: 'application/vnd.openxmlformats-officedocument.theme+xml',
+    core: 'application/vnd.openxmlformats-package.core-properties+xml',
+    app: 'application/vnd.openxmlformats-officedocument.extended-properties+xml'
+};
+export const SIZES = {
+    '16:9': { width: 12192000, height: 6858000 },
+    '4:3': { width: 9144000, height: 6858000 }
+};
+const DEFAULT_COLORS = {
+    dark1: '000000',
+    light1: 'FFFFFF',
+    dark2: '44546A',
+    light2: 'E7E6E6',
+    accent1: '4472C4',
+    accent2: 'ED7D31',
+    accent3: 'A5A5A5',
+    accent4: 'FFC000',
+    accent5: '5B9BD5',
+    accent6: '70AD47',
+    hyperlink: '0563C1',
+    followedHyperlink: '954F72'
+};
+const DEFAULT_FONTS = { heading: 'Calibri Light', body: 'Calibri' };
+const SCHEME_NAMES = {
+    dark1: 'dk1',
+    light1: 'lt1',
+    dark2: 'dk2',
+    light2: 'lt2',
+    accent1: 'accent1',
+    accent2: 'accent2',
+    accent3: 'accent3',
+    accent4: 'accent4',
+    accent5: 'accent5',
+    accent6: 'accent6',
+    hyperlink: 'hlink',
+    followedHyperlink: 'folHlink'
+};
+export const TABLE_STYLE = '{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}';
+const FOOTER_BODY_PR = '<a:bodyPr vert="horz" lIns="91440" tIns="45720" rIns="91440" bIns="45720" rtlCol="0" anchor="ctr"/>';
+function isThemeColor(key) {
+    return key in DEFAULT_COLORS;
+}
+function isFontKey(key) {
+    return key in DEFAULT_FONTS;
+}
+function isSizeName(value) {
+    return value === '16:9' || value === '4:3';
+}
+function sizeSource(value) {
+    if (value === undefined || value === '') {
+        return SIZES['16:9'];
+    }
+    if (isSizeName(value)) {
+        return SIZES[value];
+    }
+    return isRecord(value) ? value : null;
+}
+function inRange(n) {
+    return typeof n === 'number' && Number.isInteger(n) && n >= 914400 && n <= 51206400;
+}
+function resolveSize(value) {
+    const raw = sizeSource(value);
+    const width = raw?.width;
+    const height = raw?.height;
+    if (!inRange(width) || !inRange(height)) {
+        throw new DocsError('INVALID_OPTIONS', 'size must be "16:9", "4:3" or { width, height } in EMU between 1 and 56 inches');
+    }
+    return { width, height };
+}
+function resolveColors(value) {
+    const colors = { ...DEFAULT_COLORS };
+    for (const [key, color] of Object.entries(isRecord(value) ? value : {})) {
+        if (!isThemeColor(key)) {
+            throw new DocsError('INVALID_OPTIONS', `unknown theme color "${key}"; use ${Object.keys(DEFAULT_COLORS).join(', ')}`);
+        }
+        if (typeof color !== 'string' || !/^#?[0-9a-fA-F]{6}$/.test(color)) {
+            throw new DocsError('INVALID_OPTIONS', `theme color ${key} must be hex RGB, got ${String(color)}`);
+        }
+        colors[key] = color.replace('#', '').toUpperCase();
+    }
+    return colors;
+}
+function resolveFonts(value) {
+    const fonts = { ...DEFAULT_FONTS };
+    for (const [key, face] of Object.entries(isRecord(value) ? value : {})) {
+        if (!isFontKey(key)) {
+            throw new DocsError('INVALID_OPTIONS', `unknown theme font "${key}"; use heading or body`);
+        }
+        if (typeof face !== 'string' || !face.trim()) {
+            throw new DocsError('INVALID_OPTIONS', `theme font ${key} must be a typeface name`);
+        }
+        fonts[key] = face;
+    }
+    return fonts;
+}
+function options(opts) {
+    const input = isRecord(opts) ? opts : {};
+    return {
+        size: resolveSize(input.size),
+        colors: resolveColors(input.colors),
+        fonts: resolveFonts(input.fonts),
+        title: typeof input.title === 'string' ? input.title : undefined
+    };
+}
+function escape(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function geometry(size) {
+    const sx = (n) => Math.round((n * size.width) / 12192000);
+    const sy = (n) => Math.round((n * size.height) / 6858000);
+    const rect = (at) => ({ x: sx(at.x), y: sy(at.y), cx: sx(at.cx), cy: sy(at.cy) });
+    return {
+        title: rect({ x: 838200, y: 365125, cx: 10515600, cy: 1325563 }),
+        body: rect({ x: 838200, y: 1825625, cx: 10515600, cy: 4351338 }),
+        date: rect({ x: 838200, y: 6356350, cx: 2743200, cy: 365125 }),
+        footer: rect({ x: 4038600, y: 6356350, cx: 4114800, cy: 365125 }),
+        number: rect({ x: 8610600, y: 6356350, cx: 2743200, cy: 365125 }),
+        coverTitle: rect({ x: 1524000, y: 1122363, cx: 9144000, cy: 2387600 }),
+        coverSubtitle: rect({ x: 1524000, y: 3602038, cx: 9144000, cy: 1655762 }),
+        sectionTitle: rect({ x: 831850, y: 1709738, cx: 10515600, cy: 2852737 }),
+        sectionBody: rect({ x: 831850, y: 4589463, cx: 10515600, cy: 1500187 }),
+        left: rect({ x: 838200, y: 1825625, cx: 5181600, cy: 4351338 }),
+        right: rect({ x: 6172200, y: 1825625, cx: 5181600, cy: 4351338 })
+    };
+}
+function xfrm(b) {
+    return `<a:xfrm><a:off x="${b.x}" y="${b.y}"/><a:ext cx="${b.cx}" cy="${b.cy}"/></a:xfrm>`;
+}
+function run(text) {
+    return `<a:p><a:r><a:rPr lang="en-US"/><a:t>${escape(text)}</a:t></a:r></a:p>`;
+}
+function placeholder(spec) {
+    const attrs = Object.entries(spec.ph)
+        .map(([k, v]) => ` ${k}="${v}"`)
+        .join('');
+    const box = spec.box ? xfrm(spec.box) : '';
+    const bodyPr = spec.bodyPr ?? '<a:bodyPr/>';
+    const lstStyle = spec.lstStyle ?? '<a:lstStyle/>';
+    return `<p:sp><p:nvSpPr><p:cNvPr id="${spec.id}" name="${escape(spec.name)}"/><p:cNvSpPr><a:spLocks noGrp="1"/></p:cNvSpPr><p:nvPr><p:ph${attrs}/></p:nvPr></p:nvSpPr><p:spPr>${box}</p:spPr><p:txBody>${bodyPr}${lstStyle}${run(spec.prompt)}</p:txBody></p:sp>`;
+}
+function tree(shapes) {
+    return `<p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr><p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>${shapes.join('')}</p:spTree>`;
+}
+function footerStyle(align) {
+    return `<a:lstStyle><a:lvl1pPr algn="${align}"><a:defRPr sz="1200"><a:solidFill><a:schemeClr val="tx1"><a:tint val="75000"/></a:schemeClr></a:solidFill></a:defRPr></a:lvl1pPr></a:lstStyle>`;
+}
+function footers(g, spec) {
+    const { start, boxed } = spec;
+    const parts = [
+        { name: 'Date Placeholder', ph: { type: 'dt', sz: 'half', idx: 10 }, box: g.date, align: 'l' },
+        {
+            name: 'Footer Placeholder',
+            ph: { type: 'ftr', sz: 'quarter', idx: 11 },
+            box: g.footer,
+            align: 'ctr'
+        },
+        {
+            name: 'Slide Number Placeholder',
+            ph: { type: 'sldNum', sz: 'quarter', idx: 12 },
+            box: g.number,
+            align: 'r'
+        }
+    ];
+    return parts.map((part, i) => placeholder({
+        id: start + i,
+        name: part.name,
+        ph: part.ph,
+        box: boxed ? part.box : undefined,
+        bodyPr: boxed ? FOOTER_BODY_PR : undefined,
+        lstStyle: boxed ? footerStyle(part.align) : undefined,
+        prompt: ''
+    }));
+}
+function rootXml(spec) {
+    return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<p:${spec.local} xmlns:a="${A}" xmlns:r="${R}" xmlns:p="${P}"${spec.attrs}>${spec.body}</p:${spec.local}>`;
+}
+function titlePlaceholder(prompt = 'Click to edit Master title style') {
+    return placeholder({ id: 2, name: 'Title 1', ph: { type: 'title' }, prompt });
+}
+function coverLayout(g) {
+    const noBullets = '<a:lstStyle><a:lvl1pPr marL="0" indent="0" algn="ctr"><a:buNone/><a:defRPr sz="2400"/></a:lvl1pPr></a:lstStyle>';
+    return {
+        name: 'Title Slide',
+        type: 'title',
+        shapes: [
+            placeholder({
+                id: 2,
+                name: 'Title 1',
+                ph: { type: 'ctrTitle' },
+                box: g.coverTitle,
+                bodyPr: '<a:bodyPr anchor="b"/>',
+                lstStyle: '<a:lstStyle><a:lvl1pPr algn="ctr"><a:defRPr sz="6000"/></a:lvl1pPr></a:lstStyle>',
+                prompt: 'Click to edit Master title style'
+            }),
+            placeholder({
+                id: 3,
+                name: 'Subtitle 2',
+                ph: { type: 'subTitle', idx: 1 },
+                box: g.coverSubtitle,
+                lstStyle: noBullets,
+                prompt: 'Click to edit Master subtitle style'
+            }),
+            ...footers(g, { start: 4, boxed: false })
+        ]
+    };
+}
+function sectionLayout(g) {
+    return {
+        name: 'Section Header',
+        type: 'secHead',
+        shapes: [
+            placeholder({
+                id: 2,
+                name: 'Title 1',
+                ph: { type: 'title' },
+                box: g.sectionTitle,
+                bodyPr: '<a:bodyPr anchor="b"/>',
+                lstStyle: '<a:lstStyle><a:lvl1pPr><a:defRPr sz="6000"/></a:lvl1pPr></a:lstStyle>',
+                prompt: 'Click to edit Master title style'
+            }),
+            placeholder({
+                id: 3,
+                name: 'Text Placeholder 2',
+                ph: { type: 'body', idx: 1 },
+                box: g.sectionBody,
+                lstStyle: '<a:lstStyle><a:lvl1pPr marL="0" indent="0"><a:buNone/><a:defRPr sz="2400"><a:solidFill><a:schemeClr val="tx1"><a:tint val="75000"/></a:schemeClr></a:solidFill></a:defRPr></a:lvl1pPr></a:lstStyle>',
+                prompt: 'Click to edit Master text styles'
+            }),
+            ...footers(g, { start: 4, boxed: false })
+        ]
+    };
+}
+function twoContentLayout(g) {
+    const content = (id, box) => placeholder({
+        id,
+        name: `Content Placeholder ${id - 1}`,
+        ph: { sz: 'half', idx: id - 2 },
+        box,
+        prompt: 'Click to edit Master text styles'
+    });
+    return {
+        name: 'Two Content',
+        type: 'twoObj',
+        shapes: [
+            titlePlaceholder(),
+            content(3, g.left),
+            content(4, g.right),
+            ...footers(g, { start: 5, boxed: false })
+        ]
+    };
+}
+function layouts(g) {
+    const body = placeholder({
+        id: 3,
+        name: 'Content Placeholder 2',
+        ph: { idx: 1 },
+        prompt: 'Click to edit Master text styles'
+    });
+    return [
+        coverLayout(g),
+        {
+            name: 'Title and Content',
+            type: 'obj',
+            shapes: [titlePlaceholder(), body, ...footers(g, { start: 4, boxed: false })]
+        },
+        sectionLayout(g),
+        twoContentLayout(g),
+        {
+            name: 'Title Only',
+            type: 'titleOnly',
+            shapes: [titlePlaceholder(), ...footers(g, { start: 3, boxed: false })]
+        },
+        { name: 'Blank', type: 'blank', shapes: footers(g, { start: 2, boxed: false }) }
+    ];
+}
+function font(major) {
+    return `<a:latin typeface="+${major}-lt"/><a:ea typeface="+${major}-ea"/><a:cs typeface="+${major}-cs"/>`;
+}
+function bodyLevel(sz, i) {
+    const lvl = i + 1;
+    return `<a:lvl${lvl}pPr marL="${228600 + 457200 * i}" indent="-228600" algn="l" defTabSz="914400" rtl="0" eaLnBrk="1" latinLnBrk="0" hangingPunct="1"><a:lnSpc><a:spcPct val="90000"/></a:lnSpc><a:spcBef><a:spcPts val="${i === 0 ? 1000 : 500}"/></a:spcBef><a:buFont typeface="Arial"/><a:buChar char="&#8226;"/><a:defRPr sz="${sz}" kern="1200"><a:solidFill><a:schemeClr val="tx1"/></a:solidFill>${font('mn')}</a:defRPr></a:lvl${lvl}pPr>`;
+}
+function otherLevel(lvl) {
+    return `<a:lvl${lvl}pPr marL="${457200 * (lvl - 1)}" algn="l" defTabSz="914400" rtl="0" eaLnBrk="1" latinLnBrk="0" hangingPunct="1"><a:defRPr sz="1800" kern="1200"><a:solidFill><a:schemeClr val="tx1"/></a:solidFill>${font('mn')}</a:defRPr></a:lvl${lvl}pPr>`;
+}
+function textStyles() {
+    const body = [2800, 2400, 2000, 1800, 1800, 1800, 1800, 1800, 1800].map(bodyLevel).join('');
+    const other = [1, 2, 3, 4, 5, 6, 7, 8, 9].map(otherLevel).join('');
+    return `<p:txStyles><p:titleStyle><a:lvl1pPr algn="l" defTabSz="914400" rtl="0" eaLnBrk="1" latinLnBrk="0" hangingPunct="1"><a:lnSpc><a:spcPct val="90000"/></a:lnSpc><a:spcBef><a:spcPct val="0"/></a:spcBef><a:buNone/><a:defRPr sz="4400" kern="1200"><a:solidFill><a:schemeClr val="tx1"/></a:solidFill>${font('mj')}</a:defRPr></a:lvl1pPr></p:titleStyle><p:bodyStyle>${body}</p:bodyStyle><p:otherStyle><a:defPPr><a:defRPr lang="en-US"/></a:defPPr>${other}</p:otherStyle></p:txStyles>`;
+}
+function master(g, layoutCount) {
+    const shapes = [
+        placeholder({
+            id: 2,
+            name: 'Title Placeholder 1',
+            ph: { type: 'title' },
+            box: g.title,
+            bodyPr: '<a:bodyPr vert="horz" lIns="91440" tIns="45720" rIns="91440" bIns="45720" rtlCol="0" anchor="ctr"><a:normAutofit/></a:bodyPr>',
+            prompt: 'Click to edit Master title style'
+        }),
+        placeholder({
+            id: 3,
+            name: 'Text Placeholder 2',
+            ph: { type: 'body', idx: 1 },
+            box: g.body,
+            bodyPr: '<a:bodyPr vert="horz" lIns="91440" tIns="45720" rIns="91440" bIns="45720" rtlCol="0"><a:normAutofit/></a:bodyPr>',
+            prompt: 'Click to edit Master text styles'
+        }),
+        ...footers(g, { start: 4, boxed: true })
+    ];
+    const ids = Array.from({ length: layoutCount }, (_, i) => `<p:sldLayoutId id="${2147483649 + i}" r:id="rId${i + 1}"/>`).join('');
+    return rootXml({
+        local: 'sldMaster',
+        attrs: '',
+        body: `<p:cSld><p:bg><p:bgRef idx="1001"><a:schemeClr val="bg1"/></p:bgRef></p:bg>${tree(shapes)}</p:cSld><p:clrMap bg1="lt1" tx1="dk1" bg2="lt2" tx2="dk2" accent1="accent1" accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5" accent6="accent6" hlink="hlink" folHlink="folHlink"/><p:sldLayoutIdLst>${ids}</p:sldLayoutIdLst>${textStyles()}`
+    });
+}
+function theme(colors, fonts) {
+    const scheme = Object.entries(SCHEME_NAMES)
+        .map(([key, tag]) => `<a:${tag}><a:srgbClr val="${isThemeColor(key) ? colors[key] : ''}"/></a:${tag}>`)
+        .join('');
+    const face = (name) => `<a:latin typeface="${escape(name)}"/><a:ea typeface=""/><a:cs typeface=""/>`;
+    const solid = '<a:solidFill><a:schemeClr val="phClr"/></a:solidFill>';
+    const line = (w) => `<a:ln w="${w}" cap="flat" cmpd="sng" algn="ctr"><a:solidFill><a:schemeClr val="phClr"/></a:solidFill><a:prstDash val="solid"/><a:miter lim="800000"/></a:ln>`;
+    return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<a:theme xmlns:a="${A}" name="QVAC"><a:themeElements><a:clrScheme name="QVAC">${scheme}</a:clrScheme><a:fontScheme name="QVAC"><a:majorFont>${face(fonts.heading)}</a:majorFont><a:minorFont>${face(fonts.body)}</a:minorFont></a:fontScheme><a:fmtScheme name="QVAC"><a:fillStyleLst>${solid}${solid}${solid}</a:fillStyleLst><a:lnStyleLst>${line(6350)}${line(12700)}${line(19050)}</a:lnStyleLst><a:effectStyleLst><a:effectStyle><a:effectLst/></a:effectStyle><a:effectStyle><a:effectLst/></a:effectStyle><a:effectStyle><a:effectLst/></a:effectStyle></a:effectStyleLst><a:bgFillStyleLst>${solid}${solid}${solid}</a:bgFillStyleLst></a:fmtScheme></a:themeElements><a:objectDefaults/><a:extraClrSchemeLst/></a:theme>`;
+}
+function addLayouts(pkg, g) {
+    const all = layouts(g);
+    all.forEach((layout, i) => {
+        const name = `/ppt/slideLayouts/slideLayout${i + 1}.xml`;
+        const body = `<p:cSld name="${escape(layout.name)}">${tree(layout.shapes)}</p:cSld><p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr>`;
+        pkg.add(name, xml.parse(rootXml({ local: 'sldLayout', attrs: ` type="${layout.type}" preserve="1"`, body })), TYPES.layout);
+        pkg.rels(name).add(REL_BASE + 'slideMaster', '/ppt/slideMasters/slideMaster1.xml');
+        pkg.rels('/ppt/slideMasters/slideMaster1.xml').add(REL_BASE + 'slideLayout', name);
+    });
+    return all.length;
+}
+function addProps(pkg, title) {
+    pkg.add('/ppt/presProps.xml', xml.parse(rootXml({ local: 'presentationPr', attrs: '', body: '' })), TYPES.presProps);
+    pkg.add('/ppt/viewProps.xml', xml.parse(rootXml({ local: 'viewPr', attrs: '', body: '<p:gridSpacing cx="76200" cy="76200"/>' })), TYPES.viewProps);
+    pkg.add('/ppt/tableStyles.xml', xml.parse(`<a:tblStyleLst xmlns:a="${A}" def="${TABLE_STYLE}"/>`), TYPES.tableStyles);
+    const dcTitle = title ? `<dc:title>${escape(title)}</dc:title>` : '';
+    pkg.add('/docProps/core.xml', xml.parse(`<cp:coreProperties xmlns:cp="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" xmlns:dc="http://purl.org/dc/elements/1.1/">${dcTitle}</cp:coreProperties>`), TYPES.core);
+    pkg.add('/docProps/app.xml', xml.parse('<Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties"><Application>QVAC</Application></Properties>'), TYPES.app);
+}
+function addRelationships(pkg) {
+    const main = pkg.rels('/ppt/presentation.xml');
+    main.add(REL_BASE + 'slideMaster', '/ppt/slideMasters/slideMaster1.xml');
+    main.add(REL_BASE + 'theme', '/ppt/theme/theme1.xml');
+    main.add(REL_BASE + 'presProps', '/ppt/presProps.xml');
+    main.add(REL_BASE + 'viewProps', '/ppt/viewProps.xml');
+    main.add(REL_BASE + 'tableStyles', '/ppt/tableStyles.xml');
+    pkg.rels('/').add(REL_BASE + 'officeDocument', '/ppt/presentation.xml');
+    pkg
+        .rels('/')
+        .add('http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties', '/docProps/core.xml');
+    pkg.rels('/').add(REL_BASE + 'extended-properties', '/docProps/app.xml');
+}
+export function build(pkg, opts = {}) {
+    const { size, colors, fonts, title } = options(opts);
+    const g = geometry(size);
+    const presentation = `<p:sldMasterIdLst><p:sldMasterId id="2147483648" r:id="rId1"/></p:sldMasterIdLst><p:sldSz cx="${size.width}" cy="${size.height}"/><p:notesSz cx="6858000" cy="9144000"/>`;
+    pkg.add('/ppt/presentation.xml', xml.parse(rootXml({ local: 'presentation', attrs: ' saveSubsetFonts="1"', body: presentation })), TYPES.presentation);
+    pkg.add('/ppt/slideMasters/slideMaster1.xml', xml.parse(master(g, layouts(g).length)), TYPES.master);
+    addLayouts(pkg, g);
+    pkg.add('/ppt/theme/theme1.xml', xml.parse(theme(colors, fonts)), TYPES.theme);
+    pkg.rels('/ppt/slideMasters/slideMaster1.xml').add(REL_BASE + 'theme', '/ppt/theme/theme1.xml');
+    addProps(pkg, title);
+    addRelationships(pkg);
+}
+export function notesTheme() {
+    return xml.serialize(xml.parse(theme(DEFAULT_COLORS, DEFAULT_FONTS)));
+}

package/dist-lib/lib/office/engine/pptx/types.d.ts

@@ -0,0 +1,120 @@
+import type { Box } from './inherit.ts';
+import type { ShapeKind } from './shapes.ts';
+import type { ReadParagraph, Losses, TextInput, Style } from '../drawingml/text.ts';
+import type { ChartInfo, ChartSpec } from '../drawingml/chart.ts';
+export type { Box } from './inherit.ts';
+export type { ShapeKind } from './shapes.ts';
+export type ShapeId = number | 'title' | 'subtitle' | 'body';
+export interface ShapeRef {
+    slide: number;
+    shape: ShapeId;
+}
+export interface CellRef extends ShapeRef {
+    row: number;
+    column: number;
+}
+export interface ReadOptions {
+    from?: number;
+    count?: number;
+    slides?: number[];
+}
+export interface ShapeInfo {
+    id: number | null;
+    name: string;
+    kind: ShapeKind;
+    placeholder?: string;
+    group?: number;
+    paragraphs?: ReadParagraph[];
+    rows?: string[][];
+    box?: Box;
+    chart?: ChartInfo;
+}
+export interface SlideInfo {
+    index: number;
+    layout: string | null;
+    shapes: ShapeInfo[];
+    notes?: string;
+}
+export interface LayoutInfo {
+    name: string;
+    type: string;
+}
+export interface TextResult {
+    paragraphs: number;
+    changed: boolean;
+    removed?: Losses;
+    overflow?: boolean;
+    fontScale?: number;
+}
+export interface FitOptions {
+    fit?: 'shrink';
+}
+export interface StyleOptions {
+    paragraph?: number;
+}
+export interface RunCount {
+    runs: number;
+}
+export interface AddSlideOptions {
+    like?: number;
+    layout?: string;
+    at?: number;
+    title?: TextInput;
+    body?: TextInput;
+}
+export interface AddedSlide {
+    index: number;
+    layout: string;
+    shapes: ShapeInfo[];
+}
+export interface Placement {
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+}
+export interface PictureOptions extends Placement {
+    name?: string;
+    description?: string;
+}
+export interface TextBoxOptions extends Placement {
+    text?: TextInput;
+    style?: Style;
+    fill?: string;
+    name?: string;
+}
+export interface TableOptions extends Placement {
+    rows: (string | number | null)[][];
+    header?: boolean;
+    name?: string;
+}
+export interface ChartOptions extends Partial<ChartSpec>, Placement {
+    name?: string;
+}
+export interface PlacedShape extends Box {
+    id: number;
+}
+export interface ReplaceOptions {
+    stretch?: boolean;
+}
+export interface ReplacedPicture extends Partial<Box> {
+    id: number | null;
+}
+export interface MoveOptions {
+    to: number;
+}
+export interface Moved {
+    moved: boolean;
+}
+export interface Deleted {
+    deleted: number | null;
+    removed?: {
+        animations: true;
+    };
+}
+export interface Remaining {
+    slides: number;
+}
+export interface Changed {
+    changed: boolean;
+}

package/dist-lib/lib/office/engine/pptx/types.js

@@ -0,0 +1 @@
+export {};

package/dist-lib/lib/office/engine/units.d.ts

@@ -0,0 +1,3 @@
+export declare function inches(n: number): number;
+export declare function points(n: number): number;
+export declare function cm(n: number): number;

package/dist-lib/lib/office/engine/units.js

@@ -0,0 +1,12 @@
+const EMU_PER_INCH = 914400;
+const EMU_PER_POINT = 12700;
+const EMU_PER_CM = 360000;
+export function inches(n) {
+    return Math.round(n * EMU_PER_INCH);
+}
+export function points(n) {
+    return Math.round(n * EMU_PER_POINT);
+}
+export function cm(n) {
+    return Math.round(n * EMU_PER_CM);
+}

package/dist-lib/lib/office/engine/utf8.d.ts

@@ -0,0 +1,2 @@
+export declare function encode(text: string): Uint8Array;
+export declare function decode(bytes: Uint8Array): string;

package/dist-lib/lib/office/engine/utf8.js

@@ -0,0 +1,103 @@
+const encoder = typeof TextEncoder === 'function' ? new TextEncoder() : null;
+const decoder = typeof TextDecoder === 'function' ? new TextDecoder('utf-8', { ignoreBOM: true }) : null;
+function codePointAt(text, i) {
+    const c = text.charCodeAt(i);
+    if (c < 0xd800 || c > 0xdfff) {
+        return { code: c, width: 1 };
+    }
+    const next = text.charCodeAt(i + 1);
+    if (c <= 0xdbff && next >= 0xdc00 && next <= 0xdfff) {
+        return { code: 0x10000 + ((c - 0xd800) << 10) + (next - 0xdc00), width: 2 };
+    }
+    return { code: 0xfffd, width: 1 };
+}
+function writeCodePoint(out, at, c) {
+    if (c < 0x80) {
+        out[at] = c;
+        return 1;
+    }
+    if (c < 0x800) {
+        out[at] = 0xc0 | (c >> 6);
+        out[at + 1] = 0x80 | (c & 0x3f);
+        return 2;
+    }
+    if (c < 0x10000) {
+        out[at] = 0xe0 | (c >> 12);
+        out[at + 1] = 0x80 | ((c >> 6) & 0x3f);
+        out[at + 2] = 0x80 | (c & 0x3f);
+        return 3;
+    }
+    out[at] = 0xf0 | (c >> 18);
+    out[at + 1] = 0x80 | ((c >> 12) & 0x3f);
+    out[at + 2] = 0x80 | ((c >> 6) & 0x3f);
+    out[at + 3] = 0x80 | (c & 0x3f);
+    return 4;
+}
+export function encode(text) {
+    if (encoder) {
+        return encoder.encode(text);
+    }
+    const out = new Uint8Array(text.length * 3);
+    let n = 0;
+    for (let i = 0; i < text.length;) {
+        const { code, width } = codePointAt(text, i);
+        n += writeCodePoint(out, n, code);
+        i += width;
+    }
+    return out.slice(0, n);
+}
+function sequence(bytes, at) {
+    const b = bytes[at];
+    if (b < 0x80) {
+        return { code: b, next: at + 1 };
+    }
+    let need = 0;
+    let code = 0;
+    if (b >= 0xc2 && b < 0xe0) {
+        need = 1;
+        code = b & 0x1f;
+    }
+    else if (b >= 0xe0 && b < 0xf0) {
+        need = 2;
+        code = b & 0x0f;
+    }
+    else if (b >= 0xf0 && b < 0xf5) {
+        need = 3;
+        code = b & 0x07;
+    }
+    else {
+        return { code: 0xfffd, next: at + 1 };
+    }
+    for (let k = 1; k <= need; k++) {
+        const cont = bytes[at + k];
+        if (cont === undefined || (cont & 0xc0) !== 0x80) {
+            return { code: 0xfffd, next: at + k };
+        }
+        code = (code << 6) | (cont & 0x3f);
+    }
+    const overlong = (need === 2 && code < 0x800) || (need === 3 && code < 0x10000);
+    const invalid = (code >= 0xd800 && code <= 0xdfff) || code > 0x10ffff;
+    return { code: overlong || invalid ? 0xfffd : code, next: at + need + 1 };
+}
+export function decode(bytes) {
+    if (decoder) {
+        return decoder.decode(bytes);
+    }
+    let out = '';
+    let chunk = [];
+    for (let i = 0; i < bytes.length;) {
+        const { code, next } = sequence(bytes, i);
+        if (code >= 0x10000) {
+            chunk.push(0xd800 + ((code - 0x10000) >> 10), 0xdc00 + ((code - 0x10000) & 0x3ff));
+        }
+        else {
+            chunk.push(code);
+        }
+        if (chunk.length > 8192) {
+            out += String.fromCharCode(...chunk);
+            chunk = [];
+        }
+        i = next;
+    }
+    return out + String.fromCharCode(...chunk);
+}