@pptx-studio/model 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -69,8 +69,10 @@ type ModelErrorCode =
 /** A paragraph level that is not an integer. */
 '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';
-declare class ModelError extends Error {
+'MODEL_TABLE_ATTR' |
+/** A table-style edge with neither `a:ln` nor `a:lnRef`, or an `a:fill` holding no fill. */
+'MODEL_TABLE_STYLE' | '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. */
@@ -79,8 +81,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 ["MODEL_PART_MISSING", "MODEL_PART_KIND", "MODEL_NO_PRESENTATION", "MODEL_NO_PARENT", "MODEL_NO_THEME", "MODEL_CLRMAP_INCOMPLETE", "MODEL_CLRMAP_SLOT", "MODEL_PLACEHOLDER_IDX", "MODEL_XFRM_NUMBER", "MODEL_GEOMETRY", "MODEL_STYLE_IDX", "MODEL_FONT_COLLECTION", "MODEL_NO_STYLE_MATRIX", "MODEL_STYLE_LIST_EMPTY", "MODEL_SHEET_CYCLE", "MODEL_FOREIGN_SHEET", "MODEL_TEXT_ATTR", "MODEL_TEXT_FIELD", "MODEL_TEXT_LEVEL", "MODEL_TEXT_BULLET", "MODEL_TEXT_TYPEFACE", "MODEL_TABLE_ATTR", "MODEL_TABLE_STYLE", "BLIP_NO_EMBED", "BLIP_DUOTONE", "BLIP_CLR_CHANGE", "BLIP_TILE_ALIGN", "BLIP_TILE_FLIP"];
 //#endregion
 //#region src/parse/geometry.d.ts
 /**
@@ -106,7 +108,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`. */
@@ -167,7 +169,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`.
  *
@@ -330,7 +332,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';
@@ -454,9 +456,9 @@ interface TextStyles {
 //#endregion
 //#region src/table.d.ts
 /** `a:graphicData/@uri` of a table. */
-declare const TABLE_URI = "http://schemas.openxmlformats.org/drawingml/2006/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. */
-declare const INVENTED_COLUMN_WIDTH = 208280;
+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;
@@ -471,12 +473,13 @@ interface TableProps {
   readonly style: TableStyleRef | undefined;
   readonly node: XElement;
 }
-/** `a:tableStyleId`, a GUID resolved in 4.2, or an inline `a:tableStyle`, parsed in 4.3. */
+/** `a:tableStyleId`, or an inline `a:tableStyle`, which PowerPoint resolves by its `@styleId` alone. */
 type TableStyleRef = {
   readonly kind: 'id';
   readonly id: string;
 } | {
   readonly kind: 'inline';
+  readonly id: string;
   readonly node: XElement;
 };
 /** `a:gridCol`. */
@@ -559,7 +562,62 @@ interface TableGrid {
  * 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.
  */
-declare function tableGrid(table: Table): TableGrid;
+export declare function tableGrid(table: Table): TableGrid;
+/** `ST_OnOffStyleType`. */
+type OnOffStyle = 'on' | 'off' | 'def';
+/** A value written out, or a reference into the theme: the `EG_Themeable*` choices. */
+type Themeable<T, Ref = StyleRef> = {
+  readonly kind: 'value';
+  readonly value: T;
+} | {
+  readonly kind: 'ref';
+  readonly ref: Ref;
+};
+/** `a:tcTxStyle`. */
+interface TableStyleText {
+  readonly b: OnOffStyle | undefined;
+  readonly i: OnOffStyle | undefined;
+  readonly font: Themeable<FontCollection, FontRef> | undefined;
+  readonly color: Color | undefined;
+}
+/** `a:tcBdr`; `tl2br` and `tr2bl` take the names `TableCellBorders` gives the diagonals. */
+interface TableStyleBorders {
+  readonly left: Themeable<Line> | undefined;
+  readonly right: Themeable<Line> | undefined;
+  readonly top: Themeable<Line> | undefined;
+  readonly bottom: Themeable<Line> | undefined;
+  readonly insideH: Themeable<Line> | undefined;
+  readonly insideV: Themeable<Line> | undefined;
+  readonly tlToBr: Themeable<Line> | undefined;
+  readonly blToTr: Themeable<Line> | undefined;
+}
+/** `a:tcStyle`. */
+interface TableStyleCell {
+  readonly borders: TableStyleBorders | undefined;
+  readonly fill: Themeable<Fill> | undefined;
+  /** `a:cell3D`, kept as written. */
+  readonly cell3D: XElement | undefined;
+}
+/** One of a style's thirteen parts. */
+interface TableStylePart {
+  readonly text: TableStyleText | undefined;
+  readonly cell: TableStyleCell | undefined;
+}
+/** `a:tblBg`. An `a:effect` holding an `a:effectDag` reads as `undefined`, as `parseEffects` does. */
+interface TableBackground {
+  readonly fill: Themeable<Fill> | undefined;
+  readonly effect: Themeable<readonly Effect[] | undefined> | undefined;
+}
+/** The thirteen parts in schema order, which is not the order they compose in. */
+type TableStylePartName = 'wholeTbl' | 'band1H' | 'band2H' | 'band1V' | 'band2V' | 'lastCol' | 'firstCol' | 'lastRow' | 'seCell' | 'swCell' | 'firstRow' | 'neCell' | 'nwCell';
+/** `CT_TableStyle`: an `a:tblStyle`, or an inline `a:tableStyle`. Nothing absent is defaulted. */
+interface TableStyle {
+  readonly id: string;
+  readonly name: string;
+  readonly background: TableBackground | undefined;
+  readonly parts: Readonly<Partial<Record<TableStylePartName, TableStylePart>>>;
+  readonly node: XElement;
+}
 //#endregion
 //#region src/types.d.ts
 /** `a:off` and `a:ext` together, in EMU, plus the three transform attributes. */
@@ -592,9 +650,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 {
@@ -847,16 +905,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.
  *
@@ -868,7 +926,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
 /**
@@ -878,13 +936,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
 /**
@@ -897,11 +955,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.
  *
@@ -911,9 +969,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.
  *
@@ -921,9 +979,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;
@@ -939,7 +997,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.
  *
@@ -948,7 +1006,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;
@@ -964,7 +1022,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.
  *
@@ -974,11 +1032,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.
  *
@@ -993,8 +1051,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.
  *
@@ -1005,7 +1063,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.
  *
@@ -1014,7 +1072,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
 /**
@@ -1026,7 +1084,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';
@@ -1045,18 +1103,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.
  *
@@ -1066,7 +1124,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. */
@@ -1089,7 +1147,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.
  *
@@ -1097,9 +1155,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. */
@@ -1115,7 +1173,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;
@@ -1125,9 +1183,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. */
@@ -1172,13 +1230,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.
  *
@@ -1187,17 +1245,17 @@ 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
+//#region src/builtin/text-styles.d.ts
 /**
  * PowerPoint's own `p:txStyles`, substituted when a master declares none.
  *
@@ -1239,7 +1297,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[];
@@ -1263,11 +1321,26 @@ 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/builtin/table-styles.d.ts
+/**
+ * PowerPoint's 74 built-in table styles, each `a:tblStyle` byte for byte as PowerPoint writes it.
+ * GENERATED by tools/ground-truth/model/tables/styles/write-tables.ts from
+ * corpus/ground-truth/table-styles.json. Do not edit: table.test.ts re-derives it.
+ */
+interface BuiltinTableStyle {
+  readonly id: string;
+  readonly name: string;
+  /** The `a:tblStyle` PowerPoint writes into `ppt/tableStyles.xml` for this style. */
+  readonly xml: string;
+}
+/** In the order of PowerPoint's Table Styles gallery. */
+export declare const BUILTIN_TABLE_STYLES: readonly BuiltinTableStyle[];
 //#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.
  *
@@ -1298,7 +1371,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.
  *
@@ -1310,7 +1383,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.
  *
@@ -1319,7 +1392,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.
  *
@@ -1327,7 +1400,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.
  *
@@ -1337,7 +1410,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.
  *
@@ -1345,11 +1418,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.
  *
@@ -1366,13 +1439,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`.
  *
@@ -1383,11 +1456,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
 /**
@@ -1409,31 +1482,42 @@ 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`. */
-declare function parseTable(element: XElement, part: string): Table;
+export declare function parseTable(element: XElement, part: string): Table;
 /** The table of a `p:graphicFrame`, when its `a:graphicData` carries one. */
-declare function parseTableChild(frame: XElement, part: string): Table | undefined;
+export declare function parseTableChild(frame: XElement, part: string): Table | undefined;
+/** An `a:tblStyle` or an inline `a:tableStyle`: `CT_TableStyle`. */
+export declare function parseTableStyle(element: XElement, part: string): TableStyle;
+//#endregion
+//#region src/resolve/table.d.ts
+/** One of PowerPoint's 74 built-ins by GUID, in any case, parsed afresh; `undefined` for any other. */
+export declare function builtinTableStyle(id: string): TableStyle | undefined;
+/**
+ * The built-in style a table is drawn with, or `null` for PowerPoint's default: a 1-pt black
+ * grid and no fill, whatever the theme and whatever the package defines.
+ */
+export declare function tableStyleOf(table: Table): TableStyle | null;
 //#endregion
 //#region src/resolve/typeface.d.ts
 /** The four slots a `CT_TextCharacterProperties` can name. */
@@ -1444,16 +1528,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, type GridCell, INVENTED_COLUMN_WIDTH, 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, TABLE_URI, TEXT_FLOOR, 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, 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, parseTable, parseTableChild, 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, tableGrid, textLevels, themeFontRef, themeOf };
+export { type Background, type BuiltinLevel, type BuiltinTableStyle, 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 OnOffStyle, 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 TableBackground, type TableCell, type TableCellBorders, type TableCellProps, type TableColumn, type TableGrid, type TableProps, type TableRow, type TableStyle, type TableStyleBorders, type TableStyleCell, type TableStylePart, type TableStylePartName, type TableStyleRef, type TableStyleText, 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 Themeable, type Typeface, type Underline, type VerticalText, type Xfrm };
 //# sourceMappingURL=index.d.ts.map