model

re-exported from @pptx-studio/paint

type ModelErrorCode =
/** A part the chain needs is not in the package. */
'MODEL_PART_MISSING' |
/** A part is present but its root element is not the one its rel promised. */
'MODEL_PART_KIND' |
/** `ppt/presentation.xml` is missing, or the root rels do not name it. */
'MODEL_NO_PRESENTATION' |
/** A slide has no `slideLayout` relationship, or a layout no `slideMaster`. */
'MODEL_NO_PARENT' |
/** A master has no `theme` relationship. */
'MODEL_NO_THEME' |
/** A `p:clrMap` or `a:overrideClrMapping` missing one of its twelve attributes. */
'MODEL_CLRMAP_INCOMPLETE' |
/** A `p:clrMap` attribute naming something that is not one of the twelve slots. */
'MODEL_CLRMAP_SLOT' |
/** A `p:ph/@idx` that is not a non-negative integer below 2^32. */
'MODEL_PLACEHOLDER_IDX' |
/** An `a:off`/`a:ext`/`@rot` attribute that is not an integer. */
'MODEL_XFRM_NUMBER' |
/** A style-matrix reference whose `@idx` does not parse. */
'MODEL_STYLE_IDX' |
/** An `a:fontRef/@idx` outside `major`, `minor` and `none`. */
'MODEL_FONT_COLLECTION' |
/** A theme with no `a:fmtScheme`, asked for a style-matrix entry. */
'MODEL_NO_STYLE_MATRIX' |
/** A `a:fillStyleLst`/`a:lnStyleLst`/`a:bgFillStyleLst` with no entries at all. */
'MODEL_STYLE_LIST_EMPTY' |
/** A sheet chain that returns to a sheet it has already visited. */
'MODEL_SHEET_CYCLE' |
/** A sheet that does not belong to the document it was asked about. */
'MODEL_FOREIGN_SHEET' |
/** `a:prstGeom` with no `@prst`, or an `a:custGeom` command missing a point. */
'MODEL_GEOMETRY' |
/** A text attribute whose value is not of the type its schema names. */
'MODEL_TEXT_ATTR' |
/** An `a:fld` with no `@id`, which is a required `ST_Guid`. */
'MODEL_TEXT_FIELD' |
/**
 * A bullet that contradicts itself or omits what the schema requires.
 *
 * The four kinds are an exclusive group, `a:buAutoNum` must carry a @type and
 * `a:buBlip` must resolve to a relationship. A file that breaks one of those is
 * one PowerPoint would repair, and repairing it here quietly would hide which.
 */
'MODEL_TEXT_BULLET' |
/** 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' |
/** A table-style edge with neither `a:ln` nor `a:lnRef`, or an `a:fill` holding no fill. */
'MODEL_TABLE_STYLE' |
/** A grid position or grid edge asked of a table that has no such position or edge. */
'MODEL_TABLE_POSITION' | 'BLIP_NO_EMBED' | 'BLIP_DUOTONE' | 'BLIP_CLR_CHANGE' | 'BLIP_TILE_ALIGN' | 'BLIP_TILE_FLIP';

class ModelError extends Error {
  readonly name = "ModelError";
  readonly code: ModelErrorCode;
  /** The part the failure is about, when there is one. */
  readonly partName: string | null;
  /** Whatever detail names the failure: an attribute value, a rel id, a slot. */
  readonly detail: string | null;
  constructor(code: ModelErrorCode, message: string, partName?: string | null, detail?: string | null);
}

function isModelError(value: unknown): value is ModelError;

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", "MODEL_TABLE_POSITION", "BLIP_NO_EMBED", "BLIP_DUOTONE", "BLIP_CLR_CHANGE", "BLIP_TILE_ALIGN", "BLIP_TILE_FLIP"];

type ShapeGeometry = {
  readonly kind: 'preset';
  readonly prst: string;
  readonly adjust: readonly PresetGuide[];
} | {
  readonly kind: 'custom';
  readonly geometry: Geometry;
};

function parseGeometry(spPr: XElement | undefined, partName: string): ShapeGeometry | undefined;

type TextAlign = 'l' | 'ctr' | 'r' | 'just' | 'justLow' | 'dist' | 'thaiDist';

type FontAlign = 'auto' | 't' | 'ctr' | 'base' | 'b';

type Underline = 'none' | 'words' | 'sng' | 'dbl' | 'heavy' | 'dotted' | 'dottedHeavy' | 'dash' | 'dashHeavy' | 'dashLong' | 'dashLongHeavy' | 'dotDash' | 'dotDashHeavy' | 'dotDotDash' | 'dotDotDashHeavy' | 'wavy' | 'wavyHeavy' | 'wavyDbl';

type Strike = 'noStrike' | 'sngStrike' | 'dblStrike';

type Caps = 'none' | 'small' | 'all';

type Spacing = {
  readonly kind: 'percent';
  readonly value: number;
} | {
  readonly kind: 'points';
  readonly value: number;
};

interface Typeface {
  readonly typeface: string;
  /** `@panose`, twenty hex characters. */
  readonly panose: string | undefined;
  /** `@pitchFamily`, `(family << 4) | pitch`. */
  readonly pitchFamily: number | undefined;
  /** `@charset`, **signed**: Shift-JIS is -128, not 128. */
  readonly charset: number | undefined;
}

type ThemeFontRef = {
  readonly collection: 'major' | 'minor';
  readonly script: 'latin' | 'ea' | 'cs';
};

function themeFontRef(typeface: string): ThemeFontRef | null;

interface RunProps {
  /** `@sz`, hundredths of a point. 2400 is 24pt. */
  readonly sz: number | undefined;
  readonly b: boolean | undefined;
  readonly i: boolean | undefined;
  readonly u: Underline | undefined;
  readonly strike: Strike | undefined;
  readonly cap: Caps | undefined;
  /** `@spc`, hundredths of a point. May be negative. */
  readonly spc: number | undefined;
  /** `@kern`, hundredths of a point: the size at or above which to kern. */
  readonly kern: number | undefined;
  /** `@baseline`, hundred-thousandths. 30000 is superscript. */
  readonly baseline: number | undefined;
  readonly noProof: boolean | undefined;
  readonly lang: string | undefined;
  readonly altLang: string | undefined;
  readonly latin: Typeface | undefined;
  readonly ea: Typeface | undefined;
  readonly cs: Typeface | undefined;
  readonly sym: Typeface | undefined;
  /** The text's own fill: `a:solidFill` and its siblings inside `a:rPr`. */
  readonly fill: Fill | undefined;
  /** `a:ln` inside `a:rPr`: the outline of the glyphs. */
  readonly line: Line | undefined;
  readonly effects: readonly Effect[] | undefined;
  /** `a:highlight`, which is a colour and not a fill. */
  readonly highlight: Color | undefined;
  /** The element this was read from. Edits go here, never to the fields above. */
  readonly node: XElement;
}

type BulletKind = 'none' | 'char' | 'autonum' | 'blip';

type BulletFont = {
  readonly kind: 'typeface';
  readonly value: Typeface;
} |
/** `a:buFontTx`: follow the text, and cancel anything inherited. */
{
  readonly kind: 'text';
};

type BulletSize =
/** `a:buSzPct/@val`, thousandths of a percent of the first run's size. */
{
  readonly kind: 'percent';
  readonly value: number;
} |
/** `a:buSzPts/@val`, hundredths of a point, absolute. */
{
  readonly kind: 'points';
  readonly value: number;
} | {
  readonly kind: 'text';
};

type BulletColor = {
  readonly kind: 'color';
  readonly value: Color;
} | {
  readonly kind: 'text';
};

interface BulletAutoNum {
  /** `@type`, one of the 41 `ST_TextAutonumberScheme` values. */
  readonly type: string;
  /**
   * `@startAt`. Absent is measured to behave exactly as `1` - but the two are
   * kept apart, because a paragraph whose `startAt` differs from its
   * predecessor's begins a new run, and "absent" has to compare equal to "1"
   * for that rule rather than to nothing.
   */
  readonly startAt: number | undefined;
}

interface ParaProps {
  /** `@marL`, EMU. Measured to default to **0**, not to the schema's 347663. */
  readonly marL: number | undefined;
  readonly marR: number | undefined;
  /** `@indent`, EMU, usually negative. Defaults to 0, not to -342900. */
  readonly indent: number | undefined;
  readonly algn: TextAlign | undefined;
  /** `@defTabSz`, EMU. */
  readonly defTabSz: number | undefined;
  readonly rtl: boolean | undefined;
  readonly eaLnBrk: boolean | undefined;
  readonly fontAlgn: FontAlign | undefined;
  /** `@latinLnBrk`. ECMA says the default is true; PowerPoint behaves as false. */
  readonly latinLnBrk: boolean | undefined;
  readonly hangingPunct: boolean | undefined;
  readonly lnSpc: Spacing | undefined;
  readonly spcBef: Spacing | undefined;
  readonly spcAft: Spacing | undefined;
  /** `a:defRPr`: the run properties every run in this paragraph starts from. */
  readonly defRPr: RunProps | undefined;
  /**
   * Which of `a:buNone`, `a:buChar`, `a:buAutoNum` and `a:buBlip` this level
   * states, or `undefined` where it states none and inherits instead.
   */
  readonly buKind: BulletKind | undefined;
  /** `a:buChar/@char`, exactly as written. The symbol mapping happens at draw time. */
  readonly buChar: string | undefined;
  readonly buAutoNum: BulletAutoNum | undefined;
  /** `a:buBlip/a:blip/@r:embed`. */
  readonly buBlip: string | undefined;
  /**
   * The three decorations, each its own slot.
   *
   * They merge independently of the kind and of each other, which is measured
   * rather than assumed: a level declaring only `a:buFont` re-faces the
   * character it inherits and keeps its size and colour, and a level declaring
   * only `a:buSzTx` cancels an inherited `a:buSzPct` and keeps the rest.
   * Measured on eleven cases twice - once through a shape's own `a:lstStyle`
   * and once through three hops of the master chain.
   */
  readonly buFont: BulletFont | undefined;
  readonly buSize: BulletSize | undefined;
  readonly buColor: BulletColor | undefined;
  readonly node: XElement;
}

interface ListStyle {
  /** Nine entries, `a:lvl1pPr` through `a:lvl9pPr`, absent ones `undefined`. */
  readonly levels: readonly (ParaProps | undefined)[];
  /** `a:defPPr`. Preserved, never resolved against. */
  readonly defPPr: ParaProps | undefined;
  readonly node: XElement;
}

const LEVELS = 9;

interface TextRun {
  readonly kind: 'run';
  readonly props: RunProps | undefined;
  readonly text: string;
  readonly node: XElement;
}

interface TextBreak {
  readonly kind: 'br';
  readonly props: RunProps | undefined;
  readonly node: XElement;
}

interface TextField {
  readonly kind: 'field';
  /** `@id`, a required `ST_Guid`. Regenerating it is a repair risk. */
  readonly id: string;
  /** `@type`, one of the fourteen reserved names or a custom one. */
  readonly fieldType: string | undefined;
  readonly props: RunProps | undefined;
  readonly text: string;
  readonly node: XElement;
}

type TextContent = TextRun | TextBreak | TextField;

interface Paragraph {
  readonly props: ParaProps | undefined;
  /**
   * `a:pPr/@lvl`, 0 through 8, defaulting to 0.
   *
   * Read off the paragraph rather than inherited, and clamped rather than
   * thrown on: `ST_TextIndentLevelType` bounds it at 8, and a file outside the
   * bound is one PowerPoint still opens.
   */
  readonly level: number;
  readonly content: readonly TextContent[];
  /** `a:endParaRPr`: the properties of the (empty) run after the last one. */
  readonly endParaRPr: RunProps | undefined;
  readonly node: XElement;
}

type TextAnchor = 't' | 'ctr' | 'b' | 'just' | 'dist';

type VerticalText = 'horz' | 'vert' | 'vert270' | 'wordArtVert' | 'eaVert' | 'mongolianVert' | 'wordArtVertRtl';

interface TextBody {
  readonly bodyPr: BodyProps | undefined;
  readonly lstStyle: ListStyle | undefined;
  readonly paragraphs: readonly Paragraph[];
  readonly node: XElement;
}

type TextStyleBucket = 'title' | 'body' | 'other';

interface TextStyles {
  readonly title: ListStyle | undefined;
  readonly body: ListStyle | undefined;
  readonly other: ListStyle | undefined;
  readonly node: XElement;
}

const TABLE_URI = "http://schemas.openxmlformats.org/drawingml/2006/table";

const INVENTED_COLUMN_WIDTH = 208280;

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;
}

type TableStyleRef = {
  readonly kind: 'id';
  readonly id: string;
} | {
  readonly kind: 'inline';
  readonly id: string;
  readonly node: XElement;
};

interface TableColumn {
  /** `@w` in EMU. */
  readonly w: number;
  readonly node: XElement;
}

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;
}

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;
}

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;
}

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;
}

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;
}

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[];
}

function tableGrid(table: Table): TableGrid;

type OnOffStyle = 'on' | 'off' | 'def';

type Themeable<T, Ref = StyleRef> = {
  readonly kind: 'value';
  readonly value: T;
} | {
  readonly kind: 'ref';
  readonly ref: Ref;
};

interface TableStyleText {
  readonly b: OnOffStyle | undefined;
  readonly i: OnOffStyle | undefined;
  readonly font: Themeable<FontCollection, FontRef> | undefined;
  readonly color: Color | undefined;
}

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;
}

interface TableStyleCell {
  readonly borders: TableStyleBorders | undefined;
  readonly fill: Themeable<Fill> | undefined;
  /** `a:cell3D`, kept as written. */
  readonly cell3D: XElement | undefined;
}

interface TableStylePart {
  readonly text: TableStyleText | undefined;
  readonly cell: TableStyleCell | undefined;
}

interface TableBackground {
  readonly fill: Themeable<Fill> | undefined;
  readonly effect: Themeable<readonly Effect[] | undefined> | undefined;
}

type TableStylePartName = 'wholeTbl' | 'band1H' | 'band2H' | 'band1V' | 'band2V' | 'lastCol' | 'firstCol' | 'lastRow' | 'seCell' | 'swCell' | 'firstRow' | 'neCell' | 'nwCell';

interface TableStyle {
  readonly id: string;
  readonly name: string;
  readonly background: TableBackground | undefined;
  readonly parts: Readonly<Partial<Record<TableStylePartName, TableStylePart>>>;
  readonly node: XElement;
}

interface TableBackgroundLayers {
  readonly fill: TableSourced<Themeable<Fill>> | null;
  readonly effects: TableSourced<Themeable<readonly Effect[] | undefined>> | null;
}

interface TableDiagonals {
  readonly down: Line | null;
  readonly up: Line | null;
}

interface TableEdge {
  readonly axis: 'h' | 'v';
  readonly row: number;
  readonly col: number;
}

type TableSource = TableStylePartName | 'tblBg' | 'tcPr' | 'tblPr' | 'grid';

interface TableSourced<T> {
  readonly value: T;
  readonly source: TableSource;
}

interface Xfrm {
  readonly x: number;
  readonly y: number;
  readonly cx: number;
  readonly cy: number;
  /** `@rot`, sixtieths of a degree. Zero when the attribute was absent. */
  readonly rot: number;
  readonly flipH: boolean;
  readonly flipV: boolean;
  /** `a:chOff`/`a:chExt`, present only on a group's `a:xfrm`. */
  readonly child: {
    readonly x: number;
    readonly y: number;
    readonly cx: number;
    readonly cy: number;
  } | null;
}

type PlaceholderType = 'title' | 'body' | 'ctrTitle' | 'subTitle' | 'obj' | 'chart' | 'tbl' | 'clipArt' | 'dgm' | 'media' | 'sldImg' | 'pic' | 'sldNum' | 'hdr' | 'ftr' | 'dt';

const PLACEHOLDER_TYPES: readonly PlaceholderType[];

const MASTER_PLACEHOLDER_TYPES: readonly PlaceholderType[];

type PlaceholderSize = 'full' | 'half' | 'quarter';

interface Placeholder {
  /**
   * `@type` as written, or `null` when the attribute was absent.
   *
   * `null` is kept rather than defaulted, because "the file said `obj`" and
   * "the file said nothing" are different facts and only the second one is safe
   * to rewrite. `normalizePlaceholder` supplies the default when a comparison
   * needs one.
   */
  readonly type: PlaceholderType | null;
  /** `@idx` as written, or `null` when absent. Defaults to 0 when compared. */
  readonly idx: number | null;
  readonly size: PlaceholderSize | null;
  /** `@orient`. Recorded, and not part of matching. */
  readonly orient: 'horz' | 'vert' | null;
  readonly hasCustomPrompt: boolean;
}

interface NormalPlaceholder {
  readonly type: PlaceholderType;
  readonly idx: number;
}

type ShapeKind = 'sp' | 'pic' | 'grpSp' | 'graphicFrame' | 'cxnSp' | 'contentPart';

interface StyleRef {
  /**
   * `@idx`. Zero means none; 1..999 index the main list; 1001 and up index the
   * background list, offset by 1000. Measured on both `a:fillRef` and
   * `p:bgRef`, which turn out to be the same rule over the same six entries.
   */
  readonly idx: number;
  /** The colour `phClr` takes inside the entry this reference names. */
  readonly color: Color | null;
}

interface FontRef {
  readonly idx: 'major' | 'minor' | 'none';
  readonly color: Color | null;
}

interface ShapeStyle {
  readonly lnRef: StyleRef;
  readonly fillRef: StyleRef;
  readonly effectRef: StyleRef;
  readonly fontRef: FontRef;
}

interface Shape {
  readonly kind: ShapeKind;
  /** `p:cNvPr/@id`. Unique within a part, and may repeat across parts. */
  readonly cNvPrId: number;
  readonly name: string;
  /** `p:cNvPr/@descr`, the alt text. */
  readonly descr: string | null;
  readonly hidden: boolean;
  readonly placeholder: Placeholder | null;
  readonly xfrm: Xfrm | undefined;
  readonly fill: Fill | undefined;
  readonly line: Line | undefined;
  readonly effects: readonly Effect[] | undefined;
  readonly style: ShapeStyle | undefined;
  /** `a:prstGeom/@prst`, or `null` for a `custGeom` or no geometry at all. */
  readonly prstGeom: string | undefined;
  /**
   * `a:prstGeom` or `a:custGeom`, parsed far enough to draw.
   *
   * `undefined` when the shape declares neither, which is the ordinary state of
   * a slide placeholder: it inherits its outline from its layout exactly as it
   * inherits its rectangle, and `resolve` is what asks.
   */
  readonly geometry: ShapeGeometry | undefined;
  /**
   * `p:txBody`, when the shape has one.
   *
   * Present on every `p:sp` PowerPoint writes, including the ones with no text
   * in them, and absent from a `p:pic` or a `p:graphicFrame`. Its `a:lstStyle`
   * 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. */
  readonly node: XElement;
}

type Background = {
  readonly kind: 'fill';
  readonly fill: Fill;
  readonly effects: readonly Effect[] | undefined;
} | {
  readonly kind: 'ref';
  readonly ref: StyleRef;
};

interface FormatScheme {
  readonly name: string | null;
  /** `a:fillStyleLst`. Each entry is a whole `EG_FillProperties` element. */
  readonly fillStyles: readonly Fill[];
  /** `a:lnStyleLst`. Each entry is a whole `a:ln`. */
  readonly lineStyles: readonly Line[];
  /** `a:effectStyleLst`. Each entry's `a:effectLst`, flattened. */
  readonly effectStyles: readonly (readonly Effect[])[];
  /** `a:bgFillStyleLst`, which `@idx` 1001 and up reach. */
  readonly bgFillStyles: readonly Fill[];
}

interface FontCollection {
  /** `a:latin/@typeface`. An empty string means the theme states none. */
  readonly latin: string | null;
  readonly ea: string | null;
  readonly cs: string | null;
}

interface FontScheme {
  readonly name: string | null;
  readonly major: FontCollection;
  readonly minor: FontCollection;
}

interface Theme {
  readonly partName: string;
  readonly name: string | null;
  readonly scheme: ClrScheme;
  readonly fonts: FontScheme;
  readonly format: FormatScheme | null;
  readonly node: XElement;
}

type SheetKind = 'slide' | 'layout' | 'master';

type ColorMapOverride = {
  readonly kind: 'inherit';
} | {
  readonly kind: 'override';
  readonly map: ClrMap;
};

interface Sheet {
  readonly kind: SheetKind;
  readonly partName: string;
  /** `p:cSld/@name`. */
  readonly name: string | null;
  /** `p:sldLayout/@type`, one of `ST_SlideLayoutType`. Layouts only. */
  readonly layoutType: string | null;
  /** `p:sldLayout/@matchingName`. Layouts only, and only when written. */
  readonly matchingName: string | null;
  readonly shapes: readonly Shape[];
  readonly background: Background | undefined;
  /** `p:clrMap`, on a master. `undefined` everywhere else. */
  readonly clrMap: ClrMap | undefined;
  /**
   * `p:txStyles`, on a master. `undefined` everywhere else, and meaningfully so.
   *
   * A master that declares none does not get a partial one: PowerPoint
   * substitutes its whole built-in set, measured in 3.1. So the difference
   * between `undefined` and a `p:txStyles` whose buckets say nothing is the
   * difference between a 28-point body placeholder and an 18-point one.
   */
  readonly txStyles: TextStyles | undefined;
  /** `p:clrMapOvr`, on a layout or a slide. */
  readonly clrMapOvr: ColorMapOverride | undefined;
  /** `@showMasterSp`, defaulting to true. Slides and layouts. */
  readonly showMasterShapes: boolean;
  /** The layout of a slide, the master of a layout, `null` for a master and for
   *  a sheet whose binding is missing - which PowerPoint repairs rather than
   *  refuses, so it has to be representable. */
  readonly parent: Sheet | null;
  /** The theme, on a master. Every other sheet reaches it through `parent`. */
  readonly theme: Theme | null;
  readonly node: XElement;
}

type Origin =
/** The run's own `a:rPr`. */
'run' |
/** The paragraph's `a:pPr`, or its `a:defRPr`. */
'paragraph' |
/** The shape itself: its `p:spPr`, or its own `a:lstStyle`. */
'shape' |
/** A table cell's own `a:txBody/a:lstStyle`. */
'cell' |
/** What a table's style, or PowerPoint's default grid, gives a cell's text. */
'tableStyle' | 'layoutPh' | 'masterPh' |
/** The master's `p:txStyles`: the bucket a shape's chain selects, `p:otherStyle` for a cell. */
'txStyles' |
/** `p:defaultTextStyle`, which only a shape with no bucket reaches. */
'defaultTextStyle' |
/** PowerPoint's own text styles, substituted for a master that declares none. */
'builtin' | 'theme' | 'schemaDefault';

interface Resolved<T> {
  readonly value: T;
  readonly origin: Origin;
  readonly explicit: boolean;
  /** The sheet the value was found on, when one was involved. */
  readonly sheet: Sheet | null;
  /** The shape the value was found on, when one was involved. */
  readonly shape: Shape | null;
}

function parseColorElement(element: XElement): Color;

function parseColorChild(parent: XElement | undefined): Color | null;

function parseFillElement(element: XElement, partName: string): Fill;

function parseFill(parent: XElement, partName: string): Fill | undefined;

function parseLineElement(element: XElement, partName: string): Line;

function parseLine(parent: XElement, partName: string): Line | undefined;

function parseEffects(parent: XElement): readonly Effect[] | undefined;

function parseClrMap(element: XElement, partName: string): ClrMap;

function parseTheme(root: XElement, partName: string): Theme;

function parseSheet(root: XElement, partName: string): Omit<Sheet, 'parent' | 'theme'>;

const DEFAULT_PLACEHOLDER_TYPE: PlaceholderType;

const DEFAULT_PLACEHOLDER_IDX = 0;

function normalizePlaceholder(ph: Placeholder): NormalPlaceholder;

function masterPlaceholderType(type: PlaceholderType): PlaceholderType;

function placeholders(sheet: Sheet): readonly Shape[];

function matchInLayout(ph: Placeholder, layout: Sheet): Shape | null;

function matchInMaster(ph: Placeholder, master: Sheet): Shape | null;

interface ChainLink {
  readonly shape: Shape;
  readonly sheet: Sheet;
  /** `shape` for the first link, then `layoutPh`, then `masterPh`. */
  readonly origin: 'shape' | 'layoutPh' | 'masterPh';
}

function inheritanceChain(shape: Shape, sheet: Sheet): readonly ChainLink[];

const ORPHAN_RECT: {
  readonly x: 0;
  readonly y: 0;
  readonly cx: 0;
  readonly cy: 0;
};

function resolve<T>(shape: Shape, sheet: Sheet, pick: (shape: Shape) => T | undefined): Resolved<T> | undefined;

function resolveXfrm(shape: Shape, sheet: Sheet): Resolved<Xfrm> | undefined;

function sheetChain(sheet: Sheet): readonly Sheet[];

function masterOf(sheet: Sheet): Sheet | null;

function themeOf(sheet: Sheet): Theme | null;

function schemeOf(sheet: Sheet): ClrScheme | undefined;

function colorMapOf(sheet: Sheet): ClrMap | undefined;

function colorContextOf(sheet: Sheet, phClr?: Rgba): ColorContext;

const STYLE_MATRIX_OFFSET = 1000;

type StyleMatrixTarget = {
  readonly list: 'none';
} | {
  readonly list: 'main';
  readonly at: number;
} | {
  readonly list: 'background';
  readonly at: number;
};

function styleMatrixTarget(idx: number): StyleMatrixTarget;

function styleMatrixFill(ref: StyleRef, theme: Theme): Fill | null;

function styleMatrixLine(ref: StyleRef, theme: Theme): Line | null;

function styleMatrixEffects(ref: StyleRef, theme: Theme): readonly Effect[];

function phClrOf(ref: StyleRef, sheet: Sheet): Rgba | null;

interface ResolvedAppearance {
  /** `null` means nothing is painted: no fill was declared and no style names one. */
  readonly fill: Fill | null;
  readonly fillOrigin: Origin | null;
  /** The colour `phClr` resolves to inside `fill`, when it came from the theme. */
  readonly fillPhClr: Rgba | null;
  readonly line: Line | null;
  readonly lineOrigin: Origin | null;
  readonly linePhClr: Rgba | null;
  readonly effects: readonly Effect[] | null;
}

function resolveAppearance(shape: Shape, sheet: Sheet): ResolvedAppearance;

function resolveSolidFill(shape: Shape, sheet: Sheet): Rgba | null;

function resolveOnSheet(color: Color, sheet: Sheet, phClr?: Rgba): Rgba;

interface ResolvedBackground {
  readonly fill: Fill;
  /** The sheet whose `p:bg` this is. */
  readonly sheet: Sheet;
  /** True when the sheet asked for it is the one that declared it. */
  readonly explicit: boolean;
  /** `bgPr` or `bgRef`, because they round-trip differently. */
  readonly form: 'bgPr' | 'bgRef';
  /** The colour `phClr` takes inside `fill`, for a `bgRef`. */
  readonly phClr: Rgba | null;
}

function backgroundSheet(sheet: Sheet): {
  sheet: Sheet;
  background: Background;
} | null;

function resolveBackground(sheet: Sheet): ResolvedBackground | null;

function resolveBackgroundColor(sheet: Sheet): Rgba | null;

interface DocumentProblem {
  readonly code: 'MODEL_NO_PARENT' | 'MODEL_NO_THEME' | 'MODEL_PART_MISSING' | 'MODEL_PART_KIND';
  readonly partName: string;
  readonly message: string;
}

interface Document {
  /** The presentation part, for the parts of it 2.9 does not model. */
  readonly presentation: XElement;
  readonly presentationPartName: string;
  /** In `p:sldIdLst` order, which *is* the deck's order. */
  readonly slides: readonly Sheet[];
  /** In `p:sldMasterIdLst` order. */
  readonly masters: readonly Sheet[];
  /** Every layout reachable from a master, in the order its master lists it. */
  readonly layouts: readonly Sheet[];
  readonly themes: readonly Theme[];
  readonly problems: readonly DocumentProblem[];
  /**
   * `p:defaultTextStyle`, the terminus of the text cascade for every shape that
   * reaches no `p:txStyles` bucket - which is every shape that is not a
   * placeholder, and the `dt`, `ftr`, `sldNum` and `hdr` placeholders besides.
   *
   * It lives on the presentation part, so it belongs to the package rather than
   * to any sheet, and `undefined` means the package declared none.
   */
  readonly defaultTextStyle: ListStyle | undefined;
  /** Slide size in EMU, from `p:sldSz`. */
  readonly slideSize: {
    readonly cx: number;
    readonly cy: number;
  };
  sheet(partName: string): Sheet | undefined;
}

function loadDocument(store: PartStore): Document;

function parseRunProps(element: XElement, partName: string): RunProps;

function parseParaProps(element: XElement, partName: string): ParaProps;

function parseListStyle(element: XElement, partName: string): ListStyle;

function parseTextStyles(element: XElement, partName: string): TextStyles;

function parseDefaultTextStyle(presentation: XElement, partName: string): ListStyle | undefined;

function parseTextBody(element: XElement, partName: string): TextBody;

function parseTextBodyChild(parent: XElement, partName: string): TextBody | undefined;

interface BuiltinLevel {
  /** Hundredths of a point, as `a:defRPr/@sz` holds it. */
  readonly sz: number;
  /** EMU, as `a:lvlNpPr/@marL` holds it. */
  readonly marL: number;
  /** EMU, as `a:lvlNpPr/@indent` holds it. Negative is a hanging indent. */
  readonly indent: number;
  readonly bullet: boolean;
  /**
   * The theme reference this level names, or `null` where it names none.
   *
   * A reference and not a face, because the built-in styles are the same
   * whatever theme a package carries: `+mj-lt` measured as the theme's major
   * face and `+mn-lt` as its minor.
   */
  readonly typeface: string | null;
}

const BUILTIN_TEXT_STYLES: {
  readonly title: readonly BuiltinLevel[];
  readonly body: readonly BuiltinLevel[];
  readonly other: readonly BuiltinLevel[];
};

const TEXT_FLOOR: BuiltinLevel;

interface BuiltinTableStyle {
  readonly id: string;
  readonly name: string;
  /** The `a:tblStyle` PowerPoint writes into `ppt/tableStyles.xml` for this style. */
  readonly xml: string;
}

const BUILTIN_TABLE_STYLES: readonly BuiltinTableStyle[];

function bucketOf(type: string): 'title' | 'body' | null;

interface TextContext {
  readonly sheet: Sheet;
  readonly shape: Shape;
  readonly defaultTextStyle: ListStyle | undefined;
  /** Set for the text of a table cell, whose walk is its own (C9, ADR 0064). */
  readonly cell?: TableCellText;
}

interface TableCellText {
  readonly lstStyle: ListStyle | undefined;
  /** `tableTextLayer`'s answer for the cell. */
  readonly layer: RunProps;
}

function textLevels(context: TextContext): readonly Level[];

function floorOf(context: TextContext, level: number): BuiltinLevel;

function resolveParagraph<T>(context: TextContext, paragraph: Paragraph, pick: (props: ParaProps) => T | undefined): Resolved<T> | undefined;

function resolveRun<T>(context: TextContext, paragraph: Paragraph, run: TextContent | undefined, pick: (props: RunProps) => T | undefined): Resolved<T> | undefined;

function resolveSize(context: TextContext, paragraph: Paragraph, run: TextContent | undefined): Resolved<number>;

function resolveLatinTypeface(context: TextContext, paragraph: Paragraph, run: TextContent | undefined): Resolved<string>;

function resolveMarginLeft(context: TextContext, paragraph: Paragraph): Resolved<number>;

function resolveIndent(context: TextContext, paragraph: Paragraph): Resolved<number>;

function resolveBulletKind(context: TextContext, paragraph: Paragraph): Resolved<BulletKind> | undefined;

function resolveBulletChar(context: TextContext, paragraph: Paragraph): Resolved<string> | undefined;

function resolveBulletAutoNum(context: TextContext, paragraph: Paragraph): Resolved<BulletAutoNum> | undefined;

function resolveBulletBlip(context: TextContext, paragraph: Paragraph): Resolved<string> | undefined;

function resolveBulletFont(context: TextContext, paragraph: Paragraph): Resolved<BulletFont> | undefined;

function resolveBulletSize(context: TextContext, paragraph: Paragraph): Resolved<BulletSize> | undefined;

function resolveBulletColor(context: TextContext, paragraph: Paragraph): Resolved<BulletColor> | undefined;

interface ResolvedInsets {
  readonly left: number;
  readonly top: number;
  readonly right: number;
  readonly bottom: number;
}

function resolveBody<T>(shape: Shape, sheet: Sheet, pick: (props: BodyProps) => T | undefined): Resolved<T> | undefined;

function resolveAnchor(shape: Shape, sheet: Sheet): Resolved<TextAnchor> | undefined;

function resolveAnchorCtr(shape: Shape, sheet: Sheet): Resolved<boolean> | undefined;

function resolveVertical(shape: Shape, sheet: Sheet): Resolved<VerticalText> | undefined;

function resolveWrap(shape: Shape, sheet: Sheet): Resolved<TextWrap> | undefined;

function resolveColumns(shape: Shape, sheet: Sheet): Resolved<number> | undefined;

function resolveInsets(shape: Shape, sheet: Sheet): ResolvedInsets;

function parseBodyProps(element: XElement, partName: string): BodyProps;

function parseBodyPropsChild(parent: XElement, partName: string): BodyProps | undefined;

function parseTable(element: XElement, part: string): Table;

function parseTableChild(frame: XElement, part: string): Table | undefined;

function parseTableStyle(element: XElement, part: string): TableStyle;

function builtinTableStyle(id: string): TableStyle | undefined;

function tableStyleOf(table: Table): TableStyle | null;

const TABLE_PART_ORDER: readonly ["wholeTbl", "band1H", "band2H", "band1V", "band2V", "lastCol", "firstCol", "lastRow", "seCell", "swCell", "firstRow", "neCell", "nwCell"];

function tablePartsAt(props: TableProps | undefined, rows: number, cols: number, row: number, col: number): readonly TableStylePartName[];

function tableCellFill(table: Table, style: TableStyle | null, grid: TableGrid, row: number, col: number): TableSourced<Themeable<Fill>> | null;

function tableBackground(table: Table, style: TableStyle | null): TableBackgroundLayers;

function tableCellDiagonals(table: Table, grid: TableGrid, row: number, col: number): TableDiagonals;

const DEFAULT_GRID_LINE: Line;

function tableEdgeLine(table: Table, style: TableStyle | null, grid: TableGrid, edge: TableEdge): TableSourced<Themeable<Line>> | null;

function tableTextLayer(table: Table, style: TableStyle | null, grid: TableGrid, row: number, col: number): RunProps;

function themedFill(fill: Themeable<Fill>, theme: Theme, colors: ColorContext): {
  readonly fill: Fill | null;
  readonly phClr: Rgba | null;
};

function themedEffects(effects: Themeable<readonly Effect[] | undefined>, theme: Theme, colors: ColorContext): {
  readonly effects: readonly Effect[];
  readonly phClr: Rgba | null;
};

function themedLine(line: Themeable<Line>, theme: Theme, colors: ColorContext): {
  readonly line: Line | null;
  readonly phClr: Rgba | null;
};

type ScriptSlot = 'latin' | 'ea' | 'cs' | 'sym';

function resolveTypeface(typeface: string, scheme: FontScheme): string | undefined;

function resolveTypefaceOf(font: Typeface, scheme: FontScheme): string | undefined;

function requestedTypefaces(fonts: Iterable<Typeface | undefined>, scheme: FontScheme): readonly string[];