@pptx-studio/model 0.1.4 → 0.2.1

package/dist/index.d.ts

@@ -67,8 +67,10 @@ type ModelErrorCode =
  */
 'MODEL_TEXT_BULLET' |
 /** A paragraph level that is not an integer. */
-'MODEL_TEXT_LEVEL' | 'MODEL_TEXT_TYPEFACE' | 'BLIP_NO_EMBED' | 'BLIP_DUOTONE' | 'BLIP_CLR_CHANGE' | 'BLIP_TILE_ALIGN' | 'BLIP_TILE_FLIP';
-declare class ModelError extends Error {
+'MODEL_TEXT_LEVEL' | 'MODEL_TEXT_TYPEFACE' |
+/** A table attribute missing where the schema requires it, or not of the type it names. */
+'MODEL_TABLE_ATTR' | 'BLIP_NO_EMBED' | 'BLIP_DUOTONE' | 'BLIP_CLR_CHANGE' | 'BLIP_TILE_ALIGN' | 'BLIP_TILE_FLIP';
+export declare class ModelError extends Error {
   readonly name = "ModelError";
   readonly code: ModelErrorCode;
   /** The part the failure is about, when there is one. */
@@ -77,8 +79,8 @@ declare class ModelError extends Error {
   readonly detail: string | null;
   constructor(code: ModelErrorCode, message: string, partName?: string | null, detail?: string | null);
 }
-declare function isModelError(value: unknown): value is ModelError;
-declare const MODEL_ERROR_CODES: readonly ModelErrorCode[];
+export declare function isModelError(value: unknown): value is ModelError;
+export declare const MODEL_ERROR_CODES: readonly ModelErrorCode[];
 //#endregion
 //#region src/parse/geometry.d.ts
 /**
@@ -104,7 +106,7 @@ type ShapeGeometry = {
  * not chosen to be a rectangle, it has said nothing, and `resolve` is what turns
  * that into the layout's answer.
  */
-declare function parseGeometry(spPr: XElement | undefined, partName: string): ShapeGeometry | undefined;
+export declare function parseGeometry(spPr: XElement | undefined, partName: string): ShapeGeometry | undefined;
 //#endregion
 //#region src/text.d.ts
 /** `ST_TextAlignType`. */
@@ -165,7 +167,7 @@ type ThemeFontRef = {
   readonly script: 'latin' | 'ea' | 'cs';
 };
 /** `+mn-lt` and its five siblings, or `null` for a real typeface name. */
-declare function themeFontRef(typeface: string): ThemeFontRef | null;
+export declare function themeFontRef(typeface: string): ThemeFontRef | null;
 /**
  * `CT_TextCharacterProperties` - `a:rPr`, `a:defRPr` and `a:endParaRPr`.
  *
@@ -328,7 +330,7 @@ interface ListStyle {
   readonly node: XElement;
 }
 /** The number of levels a `CT_TextListStyle` holds, and `@lvl`'s range plus one. */
-declare const LEVELS = 9;
+export declare const LEVELS = 9;
 /** `a:r`: a run of text with its own properties. */
 interface TextRun {
   readonly kind: 'run';
@@ -450,6 +452,115 @@ interface TextStyles {
   readonly node: XElement;
 }
 //#endregion
+//#region src/table.d.ts
+/** `a:graphicData/@uri` of a table. */
+export declare const TABLE_URI = "http://schemas.openxmlformats.org/drawingml/2006/table";
+/** The column PowerPoint invents for a grid that declares none, empty: two margins and 2 pt. */
+export declare const INVENTED_COLUMN_WIDTH = 208280;
+/** `a:tblPr`. The seven flags are the file's own and inherit from nothing, so absent is false. */
+interface TableProps {
+  readonly rtl: boolean;
+  readonly firstRow: boolean;
+  readonly firstCol: boolean;
+  readonly lastRow: boolean;
+  readonly lastCol: boolean;
+  readonly bandRow: boolean;
+  readonly bandCol: boolean;
+  readonly fill: Fill | undefined;
+  readonly effects: readonly Effect[] | undefined;
+  readonly style: TableStyleRef | undefined;
+  readonly node: XElement;
+}
+/** `a:tableStyleId`, a GUID resolved in 4.2, or an inline `a:tableStyle`, parsed in 4.3. */
+type TableStyleRef = {
+  readonly kind: 'id';
+  readonly id: string;
+} | {
+  readonly kind: 'inline';
+  readonly node: XElement;
+};
+/** `a:gridCol`. */
+interface TableColumn {
+  /** `@w` in EMU. */
+  readonly w: number;
+  readonly node: XElement;
+}
+/** `a:tr`. */
+interface TableRow {
+  /** `@h` in EMU: the least the row is drawn at, never the most. */
+  readonly h: number;
+  readonly cells: readonly TableCell[];
+  readonly node: XElement;
+}
+/** `a:tc`: an absent span reads as 1 and an absent flag as false; `tableGrid` says what they mean. */
+interface TableCell {
+  readonly gridSpan: number;
+  readonly rowSpan: number;
+  readonly hMerge: boolean;
+  readonly vMerge: boolean;
+  /** `@id`, which `a:headers` in other cells name. */
+  readonly id: string | null;
+  readonly text: TextBody | undefined;
+  readonly props: TableCellProps | undefined;
+  readonly node: XElement;
+}
+/** The six `a:tcPr` borders, each an `a:ln` under another name. */
+interface TableCellBorders {
+  readonly left: Line | undefined;
+  readonly right: Line | undefined;
+  readonly top: Line | undefined;
+  readonly bottom: Line | undefined;
+  readonly tlToBr: Line | undefined;
+  readonly blToTr: Line | undefined;
+}
+/** `a:tcPr`. Margins are EMU as written; the schema's defaults are 91440 and 45720. */
+interface TableCellProps {
+  readonly marL: number | undefined;
+  readonly marR: number | undefined;
+  readonly marT: number | undefined;
+  readonly marB: number | undefined;
+  readonly vert: VerticalText | undefined;
+  readonly anchor: TextAnchor | undefined;
+  readonly anchorCtr: boolean | undefined;
+  readonly horzOverflow: HorzOverflow | undefined;
+  readonly borders: TableCellBorders;
+  readonly fill: Fill | undefined;
+  /** `a:headers/a:header`, the ids of the cells that head this one. */
+  readonly headers: readonly string[];
+  readonly node: XElement;
+}
+interface Table {
+  readonly props: TableProps | undefined;
+  readonly columns: readonly TableColumn[];
+  readonly rows: readonly TableRow[];
+  readonly node: XElement;
+}
+/** A grid position's owner: the anchor cell, its clamped span, and the `a:tc` there. */
+interface GridCell {
+  readonly row: number;
+  readonly col: number;
+  readonly rows: number;
+  readonly cols: number;
+  /** `null` for a position no `a:tc` reached, which PowerPoint draws empty. */
+  readonly cell: TableCell | null;
+}
+/** The grid as drawn: `positions[r][c]` is the owner of (r, c); `anchors` lists each owner once. */
+interface TableGrid {
+  readonly rows: number;
+  readonly cols: number;
+  /** Column widths in EMU. */
+  readonly widths: readonly number[];
+  /** Row heights in EMU, each the least its row is drawn at. */
+  readonly heights: readonly number[];
+  readonly positions: readonly (readonly GridCell[])[];
+  readonly anchors: readonly GridCell[];
+}
+/**
+ * The occupancy C7 measured, 76/76 against 52/76 for the flags: each `a:tc` takes the next
+ * column, a claimed position is covered whatever it says, a span stops at the edge or a claim.
+ */
+export declare function tableGrid(table: Table): TableGrid;
+//#endregion
 //#region src/types.d.ts
 /** `a:off` and `a:ext` together, in EMU, plus the three transform attributes. */
 interface Xfrm {
@@ -481,9 +592,9 @@ interface Xfrm {
  * stock master.
  */
 type PlaceholderType = 'title' | 'body' | 'ctrTitle' | 'subTitle' | 'obj' | 'chart' | 'tbl' | 'clipArt' | 'dgm' | 'media' | 'sldImg' | 'pic' | 'sldNum' | 'hdr' | 'ftr' | 'dt';
-declare const PLACEHOLDER_TYPES: readonly PlaceholderType[];
+export declare const PLACEHOLDER_TYPES: readonly PlaceholderType[];
 /** The six a slide master may carry. Measured; see `PlaceholderType`. */
-declare const MASTER_PLACEHOLDER_TYPES: readonly PlaceholderType[];
+export declare const MASTER_PLACEHOLDER_TYPES: readonly PlaceholderType[];
 /** `@sz`, a sizing hint. Recorded, and not part of matching - measured. */
 type PlaceholderSize = 'full' | 'half' | 'quarter';
 interface Placeholder {
@@ -571,6 +682,8 @@ interface Shape {
    * is one level of the text cascade; the paragraphs are the text itself.
    */
   readonly text: TextBody | undefined;
+  /** The `a:tbl` of a `p:graphicFrame` whose graphic data is a table. */
+  readonly table: Table | undefined;
   /** Children, for a `grpSp`. Empty for everything else. */
   readonly children: readonly Shape[];
   /** The element this was read from. Edits go here, never to the fields above. */
@@ -734,16 +847,16 @@ interface Resolved<T> {
 //#endregion
 //#region src/parse/paint.d.ts
 /** One of the six `EG_ColorChoice` members. */
-declare function parseColorElement(element: XElement): Color;
+export declare function parseColorElement(element: XElement): Color;
 /** The first colour child of a wrapper such as `a:solidFill` or `a:fillRef`. */
-declare function parseColorChild(parent: XElement | undefined): Color | null;
+export declare function parseColorChild(parent: XElement | undefined): Color | null;
 /** One member of `EG_FillProperties`. */
-declare function parseFillElement(element: XElement, partName: string): Fill;
+export declare function parseFillElement(element: XElement, partName: string): Fill;
 /** The fill a container declares, or `undefined` when it declares none. */
-declare function parseFill(parent: XElement, partName: string): Fill | undefined;
+export declare function parseFill(parent: XElement, partName: string): Fill | undefined;
 /** `a:ln`, lazily: every field is `null` when the attribute was absent. */
-declare function parseLineElement(element: XElement, partName: string): Line;
-declare function parseLine(parent: XElement, partName: string): Line | undefined;
+export declare function parseLineElement(element: XElement, partName: string): Line;
+export declare function parseLine(parent: XElement, partName: string): Line | undefined;
 /**
  * `a:effectLst`, in the order the file wrote it.
  *
@@ -755,7 +868,7 @@ declare function parseLine(parent: XElement, partName: string): Line | undefined
  * rather than approximated. PowerPoint writes none but does render one:
  * measured on `a04-effects-03`, where it composites a glow over the fill.
  */
-declare function parseEffects(parent: XElement): readonly Effect[] | undefined;
+export declare function parseEffects(parent: XElement): readonly Effect[] | undefined;
 //#endregion
 //#region src/parse/sheet.d.ts
 /**
@@ -765,13 +878,13 @@ declare function parseEffects(parent: XElement): readonly Effect[] | undefined;
  * rather than a partial opinion, and there is nothing sensible to default the
  * missing one to.
  */
-declare function parseClrMap(element: XElement, partName: string): ClrMap;
-declare function parseTheme(root: XElement, partName: string): Theme;
+export declare function parseClrMap(element: XElement, partName: string): ClrMap;
+export declare function parseTheme(root: XElement, partName: string): Theme;
 /**
  * One part into one sheet. The parent and the theme are filled in by
  * `document.ts`, which is the only thing that can follow a relationship.
  */
-declare function parseSheet(root: XElement, partName: string): Omit<Sheet, 'parent' | 'theme'>;
+export declare function parseSheet(root: XElement, partName: string): Omit<Sheet, 'parent' | 'theme'>;
 //#endregion
 //#region src/resolve/placeholder.d.ts
 /**
@@ -784,11 +897,11 @@ declare function parseSheet(root: XElement, partName: string): Omit<Sheet, 'pare
  * and `body` is already there. They agree, and it is worth knowing why rather
  * than by luck.
  */
-declare const DEFAULT_PLACEHOLDER_TYPE: PlaceholderType;
+export declare const DEFAULT_PLACEHOLDER_TYPE: PlaceholderType;
 /** The `@idx` of a `p:ph` that has none. */
-declare const DEFAULT_PLACEHOLDER_IDX = 0;
+export declare const DEFAULT_PLACEHOLDER_IDX = 0;
 /** Supply the two defaults, so a comparison has something to compare. */
-declare function normalizePlaceholder(ph: Placeholder): NormalPlaceholder;
+export declare function normalizePlaceholder(ph: Placeholder): NormalPlaceholder;
 /**
  * The type a placeholder presents when it asks a master for its parent.
  *
@@ -798,9 +911,9 @@ declare function normalizePlaceholder(ph: Placeholder): NormalPlaceholder;
  * because a master cannot hold them either and `body` is the only remaining
  * content type.
  */
-declare function masterPlaceholderType(type: PlaceholderType): PlaceholderType;
+export declare function masterPlaceholderType(type: PlaceholderType): PlaceholderType;
 /** Every placeholder in a sheet's top-level shape tree, in document order. */
-declare function placeholders(sheet: Sheet): readonly Shape[];
+export declare function placeholders(sheet: Sheet): readonly Shape[];
 /**
  * Slide to layout: the first placeholder whose `@idx` agrees.
  *
@@ -808,9 +921,9 @@ declare function placeholders(sheet: Sheet): readonly Shape[];
  * which PowerPoint accepts without repairing; the first in the shape tree is
  * the one that wins.
  */
-declare function matchInLayout(ph: Placeholder, layout: Sheet): Shape | null;
+export declare function matchInLayout(ph: Placeholder, layout: Sheet): Shape | null;
 /** Layout to master: the first placeholder of the folded type. */
-declare function matchInMaster(ph: Placeholder, master: Sheet): Shape | null;
+export declare function matchInMaster(ph: Placeholder, master: Sheet): Shape | null;
 /** One link of the chain: a shape, the sheet it is on, and how it was reached. */
 interface ChainLink {
   readonly shape: Shape;
@@ -826,7 +939,7 @@ interface ChainLink {
  * with the placeholder of the sheet it is leaving, which is why the layout's
  * `@type` and not the slide's decides the second hop.
  */
-declare function inheritanceChain(shape: Shape, sheet: Sheet): readonly ChainLink[];
+export declare function inheritanceChain(shape: Shape, sheet: Sheet): readonly ChainLink[];
 /**
  * A placeholder that reached no parent and states no geometry of its own.
  *
@@ -835,7 +948,7 @@ declare function inheritanceChain(shape: Shape, sheet: Sheet): readonly ChainLin
  * Measured on four probes: a title where the layout has none, a body at an index
  * nobody has, and both against a layout with no placeholders at all.
  */
-declare const ORPHAN_RECT: {
+export declare const ORPHAN_RECT: {
   readonly x: 0;
   readonly y: 0;
   readonly cx: 0;
@@ -851,7 +964,7 @@ declare const ORPHAN_RECT: {
  * conflating that with silence is how an explicit `a:noFill` gets overwritten by
  * an inherited colour.
  */
-declare function resolve<T>(shape: Shape, sheet: Sheet, pick: (shape: Shape) => T | undefined): Resolved<T> | undefined;
+export declare function resolve<T>(shape: Shape, sheet: Sheet, pick: (shape: Shape) => T | undefined): Resolved<T> | undefined;
 /**
  * The rectangle a shape occupies, and which sheet stated it.
  *
@@ -861,11 +974,11 @@ declare function resolve<T>(shape: Shape, sheet: Sheet, pick: (shape: Shape) =>
  * whole resolved rectangle is baked in at once. So an absent `xfrm` is the
  * statement "still bound to my layout", and it is what Change Layout reads.
  */
-declare function resolveXfrm(shape: Shape, sheet: Sheet): Resolved<Xfrm> | undefined;
+export declare function resolveXfrm(shape: Shape, sheet: Sheet): Resolved<Xfrm> | undefined;
 /** Every sheet from this one up to its master, nearest first. */
-declare function sheetChain(sheet: Sheet): readonly Sheet[];
+export declare function sheetChain(sheet: Sheet): readonly Sheet[];
 /** The master at the top of a sheet's chain, or `null` if the chain is broken. */
-declare function masterOf(sheet: Sheet): Sheet | null;
+export declare function masterOf(sheet: Sheet): Sheet | null;
 /**
  * The theme a sheet resolves against.
  *
@@ -880,8 +993,8 @@ declare function masterOf(sheet: Sheet): Sheet | null;
  * one is repaired on open, so a shared theme is a broken file rather than an
  * economy.
  */
-declare function themeOf(sheet: Sheet): Theme | null;
-declare function schemeOf(sheet: Sheet): ClrScheme | undefined;
+export declare function themeOf(sheet: Sheet): Theme | null;
+export declare function schemeOf(sheet: Sheet): ClrScheme | undefined;
 /**
  * The colour map in force on a sheet.
  *
@@ -892,7 +1005,7 @@ declare function schemeOf(sheet: Sheet): ClrScheme | undefined;
  * its layout's. The element is named for the sheet it usually ends at rather
  * than for the one it asks.
  */
-declare function colorMapOf(sheet: Sheet): ClrMap | undefined;
+export declare function colorMapOf(sheet: Sheet): ClrMap | undefined;
 /**
  * Everything `resolveColor` needs, for a colour written on this sheet.
  *
@@ -901,7 +1014,7 @@ declare function colorMapOf(sheet: Sheet): ClrMap | undefined;
  * `schemeClr val="phClr"` reached any other way throws rather than painting
  * black.
  */
-declare function colorContextOf(sheet: Sheet, phClr?: Rgba): ColorContext;
+export declare function colorContextOf(sheet: Sheet, phClr?: Rgba): ColorContext;
 //#endregion
 //#region src/style.d.ts
 /**
@@ -913,7 +1026,7 @@ declare function colorContextOf(sheet: Sheet, phClr?: Rgba): ColorContext;
  * agreed between the two elements, and `idx="0"` and `idx="1000"` both painted
  * nothing.
  */
-declare const STYLE_MATRIX_OFFSET = 1000;
+export declare const STYLE_MATRIX_OFFSET = 1000;
 /** Which of the two lists an index reaches, and where in it. */
 type StyleMatrixTarget = {
   readonly list: 'none';
@@ -932,18 +1045,18 @@ type StyleMatrixTarget = {
  * entry: PowerPoint clamps, opens the file without repairing it, and a renderer
  * that throws here refuses a deck PowerPoint shows.
  */
-declare function styleMatrixTarget(idx: number): StyleMatrixTarget;
+export declare function styleMatrixTarget(idx: number): StyleMatrixTarget;
 /** The fill a `fillRef`/`bgRef` index names, or `null` for none. */
-declare function styleMatrixFill(ref: StyleRef, theme: Theme): Fill | null;
+export declare function styleMatrixFill(ref: StyleRef, theme: Theme): Fill | null;
 /**
  * The line an `lnRef` index names, or `null` for none.
  *
  * `a:lnStyleLst` has no background counterpart, so an index above 1000 clamps
  * into the same list rather than reaching a second one.
  */
-declare function styleMatrixLine(ref: StyleRef, theme: Theme): Line | null;
+export declare function styleMatrixLine(ref: StyleRef, theme: Theme): Line | null;
 /** The effects an `effectRef` index names. Empty for none. */
-declare function styleMatrixEffects(ref: StyleRef, theme: Theme): readonly Effect[];
+export declare function styleMatrixEffects(ref: StyleRef, theme: Theme): readonly Effect[];
 /**
  * The colour a style reference invokes its entry with.
  *
@@ -953,7 +1066,7 @@ declare function styleMatrixEffects(ref: StyleRef, theme: Theme): readonly Effec
  * its forty-two entries, so `phClr` is a fully transformed colour and not a
  * theme slot name.
  */
-declare function phClrOf(ref: StyleRef, sheet: Sheet): Rgba | null;
+export declare function phClrOf(ref: StyleRef, sheet: Sheet): Rgba | null;
 /** What a shape paints, and where each half of the answer came from. */
 interface ResolvedAppearance {
   /** `null` means nothing is painted: no fill was declared and no style names one. */
@@ -976,7 +1089,7 @@ interface ResolvedAppearance {
  * the whole inheritance chain first, and only if no level declared one does the
  * `p:style` - itself inherited down the same chain - get consulted.
  */
-declare function resolveAppearance(shape: Shape, sheet: Sheet): ResolvedAppearance;
+export declare function resolveAppearance(shape: Shape, sheet: Sheet): ResolvedAppearance;
 /**
  * A shape's fill as a single colour, when it is one.
  *
@@ -984,9 +1097,9 @@ declare function resolveAppearance(shape: Shape, sheet: Sheet): ResolvedAppearan
  * ground-truth fixture is in: PowerPoint's object model reports one RGB per
  * shape, so this is what a measurement can be compared against.
  */
-declare function resolveSolidFill(shape: Shape, sheet: Sheet): Rgba | null;
+export declare function resolveSolidFill(shape: Shape, sheet: Sheet): Rgba | null;
 /** Resolve any colour written on a sheet, with an optional `phClr` in scope. */
-declare function resolveOnSheet(color: Color, sheet: Sheet, phClr?: Rgba): Rgba;
+export declare function resolveOnSheet(color: Color, sheet: Sheet, phClr?: Rgba): Rgba;
 //#endregion
 //#region src/resolve/background.d.ts
 /** A background, with the sheet that declared it and how it was expressed. */
@@ -1002,7 +1115,7 @@ interface ResolvedBackground {
   readonly phClr: Rgba | null;
 }
 /** Which sheet's `p:bg` applies, without unpacking it. */
-declare function backgroundSheet(sheet: Sheet): {
+export declare function backgroundSheet(sheet: Sheet): {
   sheet: Sheet;
   background: Background;
 } | null;
@@ -1012,9 +1125,9 @@ declare function backgroundSheet(sheet: Sheet): {
  * `null` when no sheet in the chain declares one, which is a legal file: a deck
  * whose master has no `p:bg` paints nothing behind its slides.
  */
-declare function resolveBackground(sheet: Sheet): ResolvedBackground | null;
+export declare function resolveBackground(sheet: Sheet): ResolvedBackground | null;
 /** The background as one colour, when it is a solid. `null` otherwise. */
-declare function resolveBackgroundColor(sheet: Sheet): Rgba | null;
+export declare function resolveBackgroundColor(sheet: Sheet): Rgba | null;
 //#endregion
 //#region src/document.d.ts
 /** One thing wrong with the package that did not stop the load. */
@@ -1059,13 +1172,13 @@ interface Document {
   };
   sheet(partName: string): Sheet | undefined;
 }
-declare function loadDocument(store: PartStore): Document;
+export declare function loadDocument(store: PartStore): Document;
 //#endregion
 //#region src/parse/text.d.ts
 /** `a:rPr`, `a:defRPr` or `a:endParaRPr` - one type under three names. */
-declare function parseRunProps(element: XElement, partName: string): RunProps;
+export declare function parseRunProps(element: XElement, partName: string): RunProps;
 /** `a:pPr`, `a:defPPr` or any `a:lvlNpPr` - one type under eleven names. */
-declare function parseParaProps(element: XElement, partName: string): ParaProps;
+export declare function parseParaProps(element: XElement, partName: string): ParaProps;
 /**
  * `a:lstStyle`, or a `p:txStyles` bucket, which is the same type unwrapped.
  *
@@ -1074,15 +1187,15 @@ declare function parseParaProps(element: XElement, partName: string): ParaProps;
  * third to the master. So a level nobody declared stays `undefined` rather than
  * falling back to level one, and the resolver asks per level.
  */
-declare function parseListStyle(element: XElement, partName: string): ListStyle;
+export declare function parseListStyle(element: XElement, partName: string): ListStyle;
 /** `p:txStyles` on a master. */
-declare function parseTextStyles(element: XElement, partName: string): TextStyles;
+export declare function parseTextStyles(element: XElement, partName: string): TextStyles;
 /** `p:defaultTextStyle` on `ppt/presentation.xml`, which is a `CT_TextListStyle`. */
-declare function parseDefaultTextStyle(presentation: XElement, partName: string): ListStyle | undefined;
+export declare function parseDefaultTextStyle(presentation: XElement, partName: string): ListStyle | undefined;
 /** A `p:txBody` or an `a:txBody`. */
-declare function parseTextBody(element: XElement, partName: string): TextBody;
+export declare function parseTextBody(element: XElement, partName: string): TextBody;
 /** The `p:txBody` of a shape, when it has one. */
-declare function parseTextBodyChild(parent: XElement, partName: string): TextBody | undefined;
+export declare function parseTextBodyChild(parent: XElement, partName: string): TextBody | undefined;
 //#endregion
 //#region src/builtin-text-styles.d.ts
 /**
@@ -1126,7 +1239,7 @@ interface BuiltinLevel {
   readonly typeface: string | null;
 }
 /** The three buckets, nine levels each, level 1 first. */
-declare const BUILTIN_TEXT_STYLES: {
+export declare const BUILTIN_TEXT_STYLES: {
   readonly title: readonly BuiltinLevel[];
   readonly body: readonly BuiltinLevel[];
   readonly other: readonly BuiltinLevel[];
@@ -1150,11 +1263,11 @@ declare const BUILTIN_TEXT_STYLES: {
  *
  * The typeface is the minor face on all 6 probes that reach a silent cascade.
  */
-declare const TEXT_FLOOR: BuiltinLevel;
+export declare const TEXT_FLOOR: BuiltinLevel;
 //#endregion
 //#region src/resolve/text.d.ts
 /** Which `p:txStyles` bucket a placeholder type reads, or `null` for none. */
-declare function bucketOf(type: string): 'title' | 'body' | null;
+export declare function bucketOf(type: string): 'title' | 'body' | null;
 /**
  * Everything the cascade needs that is not on the shape.
  *
@@ -1185,7 +1298,7 @@ interface Level {
  * compatibility scoring - needs the same list the resolver walks, not a second
  * opinion about it.
  */
-declare function textLevels(context: TextContext): readonly Level[];
+export declare function textLevels(context: TextContext): readonly Level[];
 /**
  * The values left when every level has been asked and none of them said.
  *
@@ -1197,7 +1310,7 @@ declare function textLevels(context: TextContext): readonly Level[];
  * separate probes precisely because the two are easy to conflate and differ on
  * every partially-specified master.
  */
-declare function floorOf(context: TextContext, level: number): BuiltinLevel;
+export declare function floorOf(context: TextContext, level: number): BuiltinLevel;
 /**
  * A paragraph property, from the paragraph's own `a:pPr` or up the walk.
  *
@@ -1206,7 +1319,7 @@ declare function floorOf(context: TextContext, level: number): BuiltinLevel;
  * reason: a level may legitimately declare a `null`, and conflating that with
  * silence is how an explicit value gets overwritten by an inherited one.
  */
-declare function resolveParagraph<T>(context: TextContext, paragraph: Paragraph, pick: (props: ParaProps) => T | undefined): Resolved<T> | undefined;
+export declare function resolveParagraph<T>(context: TextContext, paragraph: Paragraph, pick: (props: ParaProps) => T | undefined): Resolved<T> | undefined;
 /**
  * A run property, from the run's own `a:rPr` and then every `a:defRPr` above it.
  *
@@ -1214,7 +1327,7 @@ declare function resolveParagraph<T>(context: TextContext, paragraph: Paragraph,
  * between the run and the shape's `a:lstStyle`, which the ladder pinned by
  * declaring a different size at each and reading back which one won.
  */
-declare function resolveRun<T>(context: TextContext, paragraph: Paragraph, run: TextContent | undefined, pick: (props: RunProps) => T | undefined): Resolved<T> | undefined;
+export declare function resolveRun<T>(context: TextContext, paragraph: Paragraph, run: TextContent | undefined, pick: (props: RunProps) => T | undefined): Resolved<T> | undefined;
 /**
  * The font size of a run, in hundredths of a point, always.
  *
@@ -1224,7 +1337,7 @@ declare function resolveRun<T>(context: TextContext, paragraph: Paragraph, run:
  * `schemaDefault` when it does and the bucket said nothing - two different
  * numbers on the same slide, and the field says which was used.
  */
-declare function resolveSize(context: TextContext, paragraph: Paragraph, run: TextContent | undefined): Resolved<number>;
+export declare function resolveSize(context: TextContext, paragraph: Paragraph, run: TextContent | undefined): Resolved<number>;
 /**
  * The Latin typeface of a run, with any theme reference followed.
  *
@@ -1232,11 +1345,11 @@ declare function resolveSize(context: TextContext, paragraph: Paragraph, run: Te
  * some face, and the face when nothing named one is measured rather than
  * chosen - the theme's minor, on all six probes reaching a silent cascade.
  */
-declare function resolveLatinTypeface(context: TextContext, paragraph: Paragraph, run: TextContent | undefined): Resolved<string>;
+export declare function resolveLatinTypeface(context: TextContext, paragraph: Paragraph, run: TextContent | undefined): Resolved<string>;
 /** `@marL` in EMU. Measured to be 0 when nothing declares it, not 347663. */
-declare function resolveMarginLeft(context: TextContext, paragraph: Paragraph): Resolved<number>;
+export declare function resolveMarginLeft(context: TextContext, paragraph: Paragraph): Resolved<number>;
 /** `@indent` in EMU. Measured to be 0 when nothing declares it, not -342900. */
-declare function resolveIndent(context: TextContext, paragraph: Paragraph): Resolved<number>;
+export declare function resolveIndent(context: TextContext, paragraph: Paragraph): Resolved<number>;
 /**
  * The bullet, merged the way T5 measured it: five slots, each on its own.
  *
@@ -1253,13 +1366,13 @@ declare function resolveIndent(context: TextContext, paragraph: Paragraph): Reso
  * Nothing here supplies a default, because a paragraph with no bullet anywhere
  * in its chain genuinely has none.
  */
-declare function resolveBulletKind(context: TextContext, paragraph: Paragraph): Resolved<BulletKind> | undefined;
+export declare function resolveBulletKind(context: TextContext, paragraph: Paragraph): Resolved<BulletKind> | undefined;
 /** `a:buChar/@char`, as written. The symbol mapping belongs to the renderer. */
-declare function resolveBulletChar(context: TextContext, paragraph: Paragraph): Resolved<string> | undefined;
+export declare function resolveBulletChar(context: TextContext, paragraph: Paragraph): Resolved<string> | undefined;
 /** `a:buAutoNum`, type and start value together, since one is meaningless alone. */
-declare function resolveBulletAutoNum(context: TextContext, paragraph: Paragraph): Resolved<BulletAutoNum> | undefined;
+export declare function resolveBulletAutoNum(context: TextContext, paragraph: Paragraph): Resolved<BulletAutoNum> | undefined;
 /** `a:buBlip/a:blip/@r:embed`, which the caller resolves against the part's rels. */
-declare function resolveBulletBlip(context: TextContext, paragraph: Paragraph): Resolved<string> | undefined;
+export declare function resolveBulletBlip(context: TextContext, paragraph: Paragraph): Resolved<string> | undefined;
 /**
  * `a:buFont` or `a:buFontTx`.
  *
@@ -1270,11 +1383,11 @@ declare function resolveBulletBlip(context: TextContext, paragraph: Paragraph):
  * numbers. The resolver still reports it, because the file says it and 1.3 has
  * to write it back; the renderer is where it is ignored.
  */
-declare function resolveBulletFont(context: TextContext, paragraph: Paragraph): Resolved<BulletFont> | undefined;
+export declare function resolveBulletFont(context: TextContext, paragraph: Paragraph): Resolved<BulletFont> | undefined;
 /** `a:buSzPct`, `a:buSzPts` or `a:buSzTx`; a percentage is of the first run's size. */
-declare function resolveBulletSize(context: TextContext, paragraph: Paragraph): Resolved<BulletSize> | undefined;
+export declare function resolveBulletSize(context: TextContext, paragraph: Paragraph): Resolved<BulletSize> | undefined;
 /** `a:buClr` or `a:buClrTx`. Unlike the font, this one *does* reach an autonumber. */
-declare function resolveBulletColor(context: TextContext, paragraph: Paragraph): Resolved<BulletColor> | undefined;
+export declare function resolveBulletColor(context: TextContext, paragraph: Paragraph): Resolved<BulletColor> | undefined;
 //#endregion
 //#region src/resolve/body.d.ts
 /**
@@ -1296,25 +1409,31 @@ interface ResolvedInsets {
  * `pick` returns `undefined` for "this level did not say", the same contract the
  * text cascade uses.
  */
-declare function resolveBody<T>(shape: Shape, sheet: Sheet, pick: (props: BodyProps) => T | undefined): Resolved<T> | undefined;
-declare function resolveAnchor(shape: Shape, sheet: Sheet): Resolved<TextAnchor> | undefined;
-declare function resolveAnchorCtr(shape: Shape, sheet: Sheet): Resolved<boolean> | undefined;
-declare function resolveVertical(shape: Shape, sheet: Sheet): Resolved<VerticalText> | undefined;
-declare function resolveWrap(shape: Shape, sheet: Sheet): Resolved<TextWrap> | undefined;
-declare function resolveColumns(shape: Shape, sheet: Sheet): Resolved<number> | undefined;
+export declare function resolveBody<T>(shape: Shape, sheet: Sheet, pick: (props: BodyProps) => T | undefined): Resolved<T> | undefined;
+export declare function resolveAnchor(shape: Shape, sheet: Sheet): Resolved<TextAnchor> | undefined;
+export declare function resolveAnchorCtr(shape: Shape, sheet: Sheet): Resolved<boolean> | undefined;
+export declare function resolveVertical(shape: Shape, sheet: Sheet): Resolved<VerticalText> | undefined;
+export declare function resolveWrap(shape: Shape, sheet: Sheet): Resolved<TextWrap> | undefined;
+export declare function resolveColumns(shape: Shape, sheet: Sheet): Resolved<number> | undefined;
 /**
  * The four insets, in points, each falling back on its own.
  *
  * A frame stating only `lIns` still gets 3.6 above and below, so this resolves
  * four times rather than once.
  */
-declare function resolveInsets(shape: Shape, sheet: Sheet): ResolvedInsets;
+export declare function resolveInsets(shape: Shape, sheet: Sheet): ResolvedInsets;
 //#endregion
 //#region src/parse/body.d.ts
 /** Parse an `a:bodyPr`. Lengths stay in EMU and angles in 60000ths of a degree. */
-declare function parseBodyProps(element: XElement, partName: string): BodyProps;
+export declare function parseBodyProps(element: XElement, partName: string): BodyProps;
 /** The `a:bodyPr` of a `p:txBody`, when it has one. */
-declare function parseBodyPropsChild(parent: XElement, partName: string): BodyProps | undefined;
+export declare function parseBodyPropsChild(parent: XElement, partName: string): BodyProps | undefined;
+//#endregion
+//#region src/parse/table.d.ts
+/** An `a:tbl`. */
+export declare function parseTable(element: XElement, part: string): Table;
+/** The table of a `p:graphicFrame`, when its `a:graphicData` carries one. */
+export declare function parseTableChild(frame: XElement, part: string): Table | undefined;
 //#endregion
 //#region src/resolve/typeface.d.ts
 /** The four slots a `CT_TextCharacterProperties` can name. */
@@ -1325,16 +1444,16 @@ type ScriptSlot = 'latin' | 'ea' | 'cs' | 'sym';
  * `undefined` means the reference resolved to a collection entry the theme
  * leaves empty, which is not the same as the theme naming nothing.
  */
-declare function resolveTypeface(typeface: string, scheme: FontScheme): string | undefined;
+export declare function resolveTypeface(typeface: string, scheme: FontScheme): string | undefined;
 /** The same, for a whole `CT_TextFont`. */
-declare function resolveTypefaceOf(font: Typeface, scheme: FontScheme): string | undefined;
+export declare function resolveTypefaceOf(font: Typeface, scheme: FontScheme): string | undefined;
 /**
  * Every distinct typeface a set of runs asks for, theme references followed.
  *
  * This is what `fontReport` is given: a report keyed on `+mn-lt` would name a
  * token no user recognises and would collapse two themes into one row.
  */
-declare function requestedTypefaces(fonts: Iterable<Typeface | undefined>, scheme: FontScheme): readonly string[];
+export declare function requestedTypefaces(fonts: Iterable<Typeface | undefined>, scheme: FontScheme): readonly string[];
 //#endregion
-export { BUILTIN_TEXT_STYLES, type Background, type BuiltinLevel, type BulletAutoNum, type BulletColor, type BulletFont, type BulletKind, type BulletSize, COLOR_TRANSFORM_OPS, type Caps, type ChainLink, type ColorMapOverride, DEFAULT_PLACEHOLDER_IDX, DEFAULT_PLACEHOLDER_TYPE, type Document, type DocumentProblem, type FontAlign, type FontCollection, type FontRef, type FontScheme, type FormatScheme, LEVELS, type ListStyle, MASTER_PLACEHOLDER_TYPES, MODEL_ERROR_CODES, ModelError, type ModelErrorCode, type NormalPlaceholder, ORPHAN_RECT, type Origin, PLACEHOLDER_TYPES, type ParaProps, type Paragraph, type Placeholder, type PlaceholderSize, type PlaceholderType, type Resolved, type ResolvedAppearance, type ResolvedBackground, type ResolvedInsets, type RunProps, STYLE_MATRIX_OFFSET, type ScriptSlot, type Shape, type ShapeGeometry, type ShapeKind, type ShapeStyle, type Sheet, type SheetKind, type Spacing, type Strike, type StyleMatrixTarget, type StyleRef, TEXT_FLOOR, type TextAlign, type TextAnchor, type TextBody, type TextBreak, type TextContent, type TextContext, type TextField, type TextRun, type TextStyleBucket, type TextStyles, type Theme, type ThemeFontRef, type Typeface, type Underline, type VerticalText, type Xfrm, backgroundSheet, bucketOf, colorContextOf, colorMapOf, floorOf, inheritanceChain, isModelError, loadDocument, masterOf, masterPlaceholderType, matchInLayout, matchInMaster, normalizePlaceholder, parseBodyProps, parseBodyPropsChild, parseClrMap, parseColorChild, parseColorElement, parseDefaultTextStyle, parseEffects, parseFill, parseFillElement, parseGeometry, parseLine, parseLineElement, parseListStyle, parseParaProps, parseRunProps, parseSheet, parseTextBody, parseTextBodyChild, parseTextStyles, parseTheme, phClrOf, placeholders, requestedTypefaces, resolve, resolveAnchor, resolveAnchorCtr, resolveAppearance, resolveBackground, resolveBackgroundColor, resolveBody, resolveBulletAutoNum, resolveBulletBlip, resolveBulletChar, resolveBulletColor, resolveBulletFont, resolveBulletKind, resolveBulletSize, resolveColumns, resolveIndent, resolveInsets, resolveLatinTypeface, resolveMarginLeft, resolveOnSheet, resolveParagraph, resolveRun, resolveSize, resolveSolidFill, resolveTypeface, resolveTypefaceOf, resolveVertical, resolveWrap, resolveXfrm, schemeOf, sheetChain, styleMatrixEffects, styleMatrixFill, styleMatrixLine, styleMatrixTarget, textLevels, themeFontRef, themeOf };
+export { type Background, type BuiltinLevel, type BulletAutoNum, type BulletColor, type BulletFont, type BulletKind, type BulletSize, COLOR_TRANSFORM_OPS, type Caps, type ChainLink, type ColorMapOverride, type Document, type DocumentProblem, type FontAlign, type FontCollection, type FontRef, type FontScheme, type FormatScheme, type GridCell, type ListStyle, type ModelErrorCode, type NormalPlaceholder, type Origin, type ParaProps, type Paragraph, type Placeholder, type PlaceholderSize, type PlaceholderType, type Resolved, type ResolvedAppearance, type ResolvedBackground, type ResolvedInsets, type RunProps, type ScriptSlot, type Shape, type ShapeGeometry, type ShapeKind, type ShapeStyle, type Sheet, type SheetKind, type Spacing, type Strike, type StyleMatrixTarget, type StyleRef, type Table, type TableCell, type TableCellBorders, type TableCellProps, type TableColumn, type TableGrid, type TableProps, type TableRow, type TableStyleRef, type TextAlign, type TextAnchor, type TextBody, type TextBreak, type TextContent, type TextContext, type TextField, type TextRun, type TextStyleBucket, type TextStyles, type Theme, type ThemeFontRef, type Typeface, type Underline, type VerticalText, type Xfrm };
 //# sourceMappingURL=index.d.ts.map