@pptx-glimpse/document 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1250 @@
+/**
+ * Source handle related types.
+ *
+ * PptxSourceModel source node is a writer / editor / round-trip
+ * In order to do this, we can use ``which package part and which node it came from'' as a stable handle.
+ * A handle is not a direct mutable pointer, but a stable reference
+ * (see part path / relationship id / node id / order within siblings / raw sidecar)
+ * composes it.
+ */
+declare const PartPathBrand: unique symbol;
+declare const RelationshipIdBrand: unique symbol;
+declare const SourceNodeIdBrand: unique symbol;
+declare const RawSidecarIdBrand: unique symbol;
+/** Part path inside the OOXML package (Example: `ppt/slides/slide1.xml`). */
+type PartPath = string & {
+    readonly [PartPathBrand]: typeof PartPathBrand;
+};
+/** Relationship id (Example: `rId1`).`_rels/*.rels` source. */
+type RelationshipId = string & {
+    readonly [RelationshipIdBrand]: typeof RelationshipIdBrand;
+};
+/** An id that uniquely points to an element within the source part (spid / generation id, etc.). */
+type SourceNodeId = string & {
+    readonly [SourceNodeIdBrand]: typeof SourceNodeIdBrand;
+};
+/** Id pointing to a raw sidecar. */
+type RawSidecarId = string & {
+    readonly [RawSidecarIdBrand]: typeof RawSidecarIdBrand;
+};
+declare function asPartPath(value: string): PartPath;
+declare function asRelationshipId(value: string): RelationshipId;
+declare function asSourceNodeId(value: string): SourceNodeId;
+declare function asRawSidecarId(value: string): RawSidecarId;
+/**
+ * Stable handle describing a source node's provenance. The writer uses the handle to decide whether a generated
+ * node can be spliced into an existing part or whether a broader scope must be regenerated.
+ *
+ */
+interface SourceHandle {
+    /** Package part that owns this node. */
+    readonly partPath: PartPath;
+    /** Node id inside the part (when available). */
+    readonly nodeId?: SourceNodeId;
+    /** The relationship id referencing this node (e.g. `r:embed` in blip). */
+    readonly relationshipId?: RelationshipId;
+    /** The child's order slot within the parent element. Used to restore order with raw sidecar. */
+    readonly orderingSlot?: number;
+    /** Raw sidecar ids associated with this node. */
+    readonly rawSidecarIds?: readonly RawSidecarId[];
+}
+
+/**
+ * Diagnostics type. Document correctness (round-trip / preservation / reference resolution)
+ * and are not warnings about rendering fidelity or UI behavior.
+ */
+
+type DiagnosticSeverity = "info" | "warning" | "error";
+interface Diagnostic {
+    readonly severity: DiagnosticSeverity;
+    /** Stable machine-readable code (Example: `unsupported-node-dropped`). */
+    readonly code: string;
+    readonly message: string;
+    /** The source node from which the diagnosis originates, if it can be determined. */
+    readonly handle?: SourceHandle;
+}
+
+declare function findTextRunBySourceHandle(source: PptxSourceModel, handle: SourceHandle): SourceTextRun | undefined;
+declare function findParagraphBySourceHandle(source: PptxSourceModel, handle: SourceHandle): SourceParagraph | undefined;
+declare function replaceTextRunPlainText(source: PptxSourceModel, handle: SourceHandle, text: string): PptxSourceModel;
+declare function replaceParagraphPlainText(source: PptxSourceModel, handle: SourceHandle, text: string): PptxSourceModel;
+interface UpdateShapeTransformInput {
+    readonly offsetX: Emu;
+    readonly offsetY: Emu;
+    readonly width: Emu;
+    readonly height: Emu;
+}
+declare function findShapeNodeBySourceHandle(source: PptxSourceModel, handle: SourceHandle): SourceShapeNode | undefined;
+declare function updateShapeTransform(source: PptxSourceModel, handle: SourceHandle, transform: UpdateShapeTransformInput): PptxSourceModel;
+
+/**
+ * Types for the raw OOXML escape hatch.
+ *
+ * PptxSourceModel represents supported semantics as typed fields, while preserving
+ * unsupported or partially supported XML as raw sidecars and unedited parts as raw
+ * package parts. This enables structural round-tripping; byte equality is not a goal.
+ */
+
+/**
+ * Partially parsed raw OOXML node. It preserves the namespace-prefixed qualified name,
+ * attributes, child nodes, and text for elements that PptxSourceModel does not represent
+ * as typed fields, such as vendor extensions, `mc:AlternateContent`, and unknown
+ * DrawingML.
+ */
+interface RawOoxmlNode {
+    /** Element name including the namespace prefix (Example: `a:extLst`). */
+    readonly name: string;
+    readonly attributes?: Readonly<Record<string, string>>;
+    readonly children?: readonly RawOoxmlNode[];
+    /** Element text content (when present). */
+    readonly text?: string;
+}
+/**
+ * Raw XML sidecar associated with a PptxSourceModel source node. It is attached to the nearest source node
+ * and keeps ordering metadata within the parent element to restore order during write-back.
+ */
+interface RawSidecar {
+    readonly id: RawSidecarId;
+    readonly node: RawOoxmlNode;
+    /** Ordering slot within the owning element's child sequence. */
+    readonly orderingSlot?: number;
+}
+/**
+ * Raw fallback for writing an unedited package part back as-is. It keeps either bytes
+ * for binary assets or an XML tree as a discriminated union. The type rules out invalid
+ * states with both or neither representation.
+ */
+type RawPackagePart = {
+    readonly kind: "binary";
+    readonly partPath: PartPath;
+    readonly contentType: string;
+    /** Original byte string of binary part (image, embedded workbook, etc.). */
+    readonly bytes: Uint8Array;
+} | {
+    readonly kind: "xml";
+    readonly partPath: PartPath;
+    readonly contentType: string;
+    /** The root node when storing the XML part as a tree. */
+    readonly xml: RawOoxmlNode;
+};
+
+/**
+ * Package graph type. package part / relationship / content type / media
+ * Represented as source-model data.
+ */
+
+/** target mode of relationship. */
+type RelationshipTargetMode = "Internal" | "External";
+/** 1 entry in `_rels/*.rels`. */
+interface Relationship {
+    readonly id: RelationshipId;
+    /** relationship type URI. */
+    readonly type: string;
+    /** Target relative to sourcePartPath, or an external URL. */
+    readonly target: string;
+    readonly targetMode?: RelationshipTargetMode;
+}
+/** Relationships owned by a source part (`<part>/_rels/<part>.rels`). */
+interface PartRelationships {
+    readonly sourcePartPath: PartPath;
+    readonly relationships: readonly Relationship[];
+}
+/** Default entry in `[Content_Types].xml` (extension -> content type). */
+interface ContentTypeDefault {
+    readonly extension: string;
+    readonly contentType: string;
+}
+/** Override entry (part name -> content type) in `[Content_Types].xml`. */
+interface ContentTypeOverride {
+    readonly partName: PartPath;
+    readonly contentType: string;
+}
+interface ContentTypes {
+    readonly defaults: readonly ContentTypeDefault[];
+    readonly overrides: readonly ContentTypeOverride[];
+}
+/** Package part reference (path + content type). */
+interface PackagePartRef {
+    readonly partPath: PartPath;
+    readonly contentType: string;
+}
+/** Part of a media asset (image, audio, video, etc.). Keep bytes as is. */
+interface MediaPart {
+    readonly partPath: PartPath;
+    readonly contentType: string;
+    readonly bytes: Uint8Array;
+}
+/**
+ * The overall structure of the package. content types / part list / relationship by part /
+ * media, and retain the raw fallback of the unedited part.
+ */
+interface PackageGraph {
+    readonly contentTypes: ContentTypes;
+    readonly parts: readonly PackagePartRef[];
+    readonly relationships: readonly PartRelationships[];
+    readonly media: readonly MediaPart[];
+    /** Raw fallback for writing back parts that are not typed / were not edited. */
+    readonly rawParts?: readonly RawPackagePart[];
+}
+
+/**
+ * PptxSourceModel PPTX-native typed units used by source model.
+ *
+ * The source model does not perform pixel conversion and keeps the units defined by OOXML
+ * Hold as a type. The unit type on the renderer side (`@pptx-glimpse/renderer`) is
+ * the lower-level foundation `@pptx-glimpse/document` cannot reference, so this module
+ * Define branded types independently. Zero runtime cost (JS output is
+ * (same as plain number).
+ */
+declare const EmuBrand: unique symbol;
+declare const PtBrand: unique symbol;
+declare const HundredthPtBrand: unique symbol;
+declare const OoxmlPercentBrand: unique symbol;
+declare const OoxmlAngleBrand: unique symbol;
+/** English Metric Units (1 inch = 914,400 EMU). Used for coordinates and size. */
+type Emu = number & {
+    readonly [EmuBrand]: typeof EmuBrand;
+};
+/** points (1 pt = 1/72 inch).font size. */
+type Pt = number & {
+    readonly [PtBrand]: typeof PtBrand;
+};
+/** 1/100 point (ECMA-376 `a:spcPts` etc.). */
+type HundredthPt = number & {
+    readonly [HundredthPtBrand]: typeof HundredthPtBrand;
+};
+/**
+ * OOXML percentage (ST_Percentage).Integer value where 1% = 1000.
+ * `a:spcPct` / `a:lumMod` / `a:tint` and similar transforms.
+ */
+type OoxmlPercent = number & {
+    readonly [OoxmlPercentBrand]: typeof OoxmlPercentBrand;
+};
+/**
+ * OOXML angle (ST_Angle).1 degree = 60,000.`a:xfrm@rot` and similar fields.
+ */
+type OoxmlAngle = number & {
+    readonly [OoxmlAngleBrand]: typeof OoxmlAngleBrand;
+};
+declare function asEmu(value: number): Emu;
+declare function asPt(value: number): Pt;
+declare function asHundredthPt(value: number): HundredthPt;
+declare function asOoxmlPercent(value: number): OoxmlPercent;
+declare function asOoxmlAngle(value: number): OoxmlAngle;
+
+/**
+ * Source node types for simple shapes, text runs, and images.
+ *
+ * The current supported drawing subset, centered on simple shapes, text, and images, is
+ * represented as typed nodes. Theme colors and relationships stay as unresolved source
+ * references, and cascade resolution is handled by the computed view. Unsupported nodes
+ * are preserved through the raw escape hatch.
+ */
+
+/** Source transform from `a:xfrm`. Keep the coordinates and size as EMU. */
+interface SourceTransform {
+    readonly offsetX: Emu;
+    readonly offsetY: Emu;
+    readonly width: Emu;
+    readonly height: Emu;
+    readonly rotation?: OoxmlAngle;
+    readonly flipHorizontal?: boolean;
+    readonly flipVertical?: boolean;
+}
+/** Source reference for preset geometry (`a:prstGeom`). Keep only the preset name. */
+interface SourcePresetGeometry {
+    /** Preset name (Example: `rect`, `roundRect`). */
+    readonly preset: string;
+    readonly adjustValues?: Readonly<Record<string, number>>;
+}
+interface SourceCustomGeometryPath {
+    readonly width: number;
+    readonly height: number;
+    readonly commands: string;
+}
+interface SourceCustomGeometry {
+    readonly kind: "custom";
+    readonly paths: readonly SourceCustomGeometryPath[];
+}
+type SourceGeometry = SourcePresetGeometry | SourceCustomGeometry;
+/**
+ * Unresolved source color reference. `schemeClr` keeps the scheme name and resolves to a
+ * concrete color through `clrMap` / `colorScheme` in the computed view. `srgbClr` and
+ * `sysClr` hold concrete values, but transformations such as lumMod are kept unapplied.
+ */
+type SourceColor = {
+    readonly kind: "srgb";
+    readonly hex: string;
+    readonly transforms?: readonly SourceColorTransform[];
+} | {
+    readonly kind: "scheme";
+    readonly scheme: string;
+    readonly transforms?: readonly SourceColorTransform[];
+} | {
+    readonly kind: "system";
+    /** `a:sysClr@val` (Example: `windowText`). */
+    readonly value: string;
+    /** Resolved fallback hex for `a:sysClr@lastClr`, when present. */
+    readonly lastColor?: string;
+    readonly transforms?: readonly SourceColorTransform[];
+};
+/** Color conversions such as lumMod / tint / shade (values are OOXML percentages). */
+interface SourceColorTransform {
+    readonly kind: "lumMod" | "lumOff" | "tint" | "shade" | "alpha";
+    readonly value: OoxmlPercent;
+}
+/** shape fill (source level, minimum). Unsupported fills are saved as raw. */
+type SourceFill = {
+    readonly kind: "none";
+} | {
+    readonly kind: "solid";
+    readonly color: SourceColor;
+} | ({
+    readonly kind: "gradient";
+    readonly stops: readonly SourceGradientStop[];
+} & SourceGradient) | {
+    readonly kind: "pattern";
+    readonly preset: string;
+    readonly foregroundColor: SourceColor;
+    readonly backgroundColor: SourceColor;
+} | {
+    readonly kind: "image";
+    readonly blipRelationshipId?: RelationshipId;
+    readonly tile?: SourceImageFillTile;
+} | {
+    readonly kind: "raw";
+    readonly raw: RawSidecar;
+};
+interface SourceGradientStop {
+    readonly position: number;
+    readonly color: SourceColor;
+}
+type SourceGradient = {
+    readonly gradientType: "linear";
+    readonly angle: OoxmlAngle;
+} | {
+    readonly gradientType: "radial";
+    readonly centerX: number;
+    readonly centerY: number;
+};
+type SourceRectangleAlignment = "tl" | "t" | "tr" | "l" | "ctr" | "r" | "bl" | "b" | "br";
+interface SourceImageFillTile {
+    readonly tx: Emu;
+    readonly ty: Emu;
+    readonly sx: number;
+    readonly sy: number;
+    readonly flip: "none" | "x" | "y" | "xy";
+    readonly align: SourceRectangleAlignment;
+}
+interface SourceStyleReference {
+    readonly index: number;
+    readonly color?: SourceColor;
+}
+interface SourceShapeStyle {
+    readonly fillRef?: SourceStyleReference;
+    readonly lineRef?: SourceStyleReference;
+    readonly effectRef?: SourceStyleReference;
+}
+interface SourceEffectList {
+    readonly outerShadow?: SourceOuterShadow;
+    readonly innerShadow?: SourceInnerShadow;
+    readonly glow?: SourceGlow;
+    readonly softEdge?: SourceSoftEdge;
+}
+interface SourceOuterShadow {
+    readonly blurRadius: Emu;
+    readonly distance: Emu;
+    readonly direction: OoxmlAngle;
+    readonly color: SourceColor;
+    readonly alignment: SourceRectangleAlignment;
+    readonly rotateWithShape: boolean;
+}
+interface SourceInnerShadow {
+    readonly blurRadius: Emu;
+    readonly distance: Emu;
+    readonly direction: OoxmlAngle;
+    readonly color: SourceColor;
+}
+interface SourceGlow {
+    readonly radius: Emu;
+    readonly color: SourceColor;
+}
+interface SourceSoftEdge {
+    readonly radius: Emu;
+}
+interface SourceBlipEffects {
+    readonly grayscale: boolean;
+    readonly biLevel?: SourceBiLevelEffect;
+    readonly blur?: SourceBlurEffect;
+    readonly lum?: SourceLumEffect;
+    readonly duotone?: SourceDuotoneEffect;
+    readonly clrChange?: SourceColorChangeEffect;
+}
+interface SourceBiLevelEffect {
+    readonly threshold: number;
+}
+interface SourceBlurEffect {
+    readonly radius: Emu;
+    readonly grow: boolean;
+}
+interface SourceLumEffect {
+    readonly brightness: number;
+    readonly contrast: number;
+}
+interface SourceDuotoneEffect {
+    readonly color1: SourceColor;
+    readonly color2: SourceColor;
+}
+interface SourceColorChangeEffect {
+    readonly from: SourceColor;
+    readonly to: SourceColor;
+}
+/** simple solid line outline (`a:ln`). Minimal representation of color and width only. */
+interface SourceOutline {
+    readonly width?: Emu;
+    readonly fill?: SourceFill;
+    readonly dashStyle?: SourceDashStyle;
+    readonly customDash?: readonly number[];
+    readonly lineCap?: SourceLineCap;
+    readonly lineJoin?: SourceLineJoin;
+    readonly headEnd?: SourceArrowEndpoint;
+    readonly tailEnd?: SourceArrowEndpoint;
+}
+type SourceArrowType = "triangle" | "stealth" | "diamond" | "oval" | "arrow";
+type SourceArrowSize = "sm" | "med" | "lg";
+interface SourceArrowEndpoint {
+    readonly type: SourceArrowType;
+    readonly width: SourceArrowSize;
+    readonly length: SourceArrowSize;
+}
+type SourceDashStyle = "solid" | "dash" | "dot" | "dashDot" | "lgDash" | "lgDashDot" | "sysDash" | "sysDot";
+type SourceLineCap = "butt" | "round" | "square";
+type SourceLineJoin = "miter" | "round" | "bevel";
+/** placeholder declaration (`p:ph`). Keep type / idx unresolved. */
+interface SourcePlaceholder {
+    readonly type?: string;
+    readonly index?: number;
+}
+/** Minimal subset of run properties (`a:rPr`) of text run (`a:r`). */
+interface SourceRunProperties {
+    readonly bold?: boolean;
+    readonly italic?: boolean;
+    readonly underline?: boolean;
+    readonly strikethrough?: boolean;
+    readonly baseline?: number;
+    /** Font size. Stored as pt in the OOXML domain. */
+    readonly fontSize?: Pt;
+    /** latin typeface name (kept unresolved including theme token). */
+    readonly typeface?: string;
+    /** East Asian typeface name (kept unresolved including theme token). */
+    readonly typefaceEa?: string;
+    /** Complex script typeface name (kept unresolved including theme token). */
+    readonly typefaceCs?: string;
+    readonly color?: SourceColor;
+}
+type SourceAutoNumScheme = "arabicPeriod" | "arabicParenR" | "romanUcPeriod" | "romanLcPeriod" | "alphaUcPeriod" | "alphaLcPeriod" | "alphaLcParenR" | "alphaUcParenR" | "arabicPlain";
+type SourceBulletType = {
+    readonly type: "none";
+} | {
+    readonly type: "char";
+    readonly char: string;
+} | {
+    readonly type: "autoNum";
+    readonly scheme: SourceAutoNumScheme;
+    readonly startAt: number;
+};
+type SourceSpacingValue = {
+    readonly type: "pts";
+    readonly value: HundredthPt;
+} | {
+    readonly type: "pct";
+    readonly value: number;
+};
+/** text run (`a:r`). */
+interface SourceTextRun {
+    readonly kind: "textRun";
+    readonly text: string;
+    readonly properties?: SourceRunProperties;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+type SourceTextAlign = "left" | "center" | "right" | "justify";
+interface SourceTabStop {
+    readonly position: Emu;
+    readonly alignment: "l" | "ctr" | "r" | "dec";
+}
+/** Minimum subset of paragraph properties (`a:pPr`) of paragraph (`a:p`). */
+interface SourceParagraphProperties {
+    readonly align?: SourceTextAlign;
+    /** Indentation level (`a:pPr@lvl`). */
+    readonly level?: number;
+    readonly lineSpacing?: SourceSpacingValue;
+    readonly spaceBefore?: SourceSpacingValue;
+    readonly spaceAfter?: SourceSpacingValue;
+    readonly marginLeft?: Emu;
+    readonly indent?: Emu;
+    readonly bullet?: SourceBulletType;
+    readonly bulletFont?: string;
+    readonly bulletColor?: SourceColor;
+    readonly bulletSizePct?: number;
+    readonly tabStops?: readonly SourceTabStop[];
+    readonly defaultRunProperties?: SourceRunProperties;
+}
+/** paragraph (`a:p`). */
+interface SourceParagraph {
+    readonly runs: readonly SourceTextRun[];
+    readonly properties?: SourceParagraphProperties;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+/** vertical anchor (`a:bodyPr@anchor`). */
+type SourceVerticalAnchor = "top" | "middle" | "bottom";
+type SourceTextWrap = "square" | "none";
+type SourceTextVerticalType = "horz" | "vert" | "vert270" | "eaVert" | "wordArtVert" | "mongolianVert";
+type SourceTextAutoFit = "noAutofit" | "normAutofit" | "spAutofit";
+/** Minimal subset of text body properties (`a:bodyPr`): insets and vertical anchor. */
+interface SourceTextBodyProperties {
+    readonly marginLeft?: Emu;
+    readonly marginRight?: Emu;
+    readonly marginTop?: Emu;
+    readonly marginBottom?: Emu;
+    readonly anchor?: SourceVerticalAnchor;
+    readonly wrap?: SourceTextWrap;
+    readonly autoFit?: SourceTextAutoFit;
+    readonly fontScale?: number;
+    readonly lnSpcReduction?: number;
+    readonly numCol?: number;
+    readonly vert?: SourceTextVerticalType;
+}
+/** text body (`p:txBody`). */
+interface SourceTextBody {
+    readonly paragraphs: readonly SourceParagraph[];
+    readonly properties?: SourceTextBodyProperties;
+    readonly listStyle?: SourceTextStyle;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+interface SourceTextStyle {
+    readonly defaultParagraph?: SourceParagraphProperties;
+    readonly levels: readonly (SourceParagraphProperties | undefined)[];
+}
+/** simple shape (`p:sp`). */
+interface SourceShape {
+    readonly kind: "shape";
+    readonly nodeId?: SourceNodeId;
+    readonly name?: string;
+    readonly transform?: SourceTransform;
+    readonly geometry?: SourceGeometry;
+    readonly fill?: SourceFill;
+    readonly outline?: SourceOutline;
+    readonly effects?: SourceEffectList;
+    readonly style?: SourceShapeStyle;
+    readonly textBody?: SourceTextBody;
+    readonly placeholder?: SourcePlaceholder;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+interface SourceConnector {
+    readonly kind: "connector";
+    readonly nodeId?: SourceNodeId;
+    readonly name?: string;
+    readonly transform?: SourceTransform;
+    readonly geometry?: SourceGeometry;
+    readonly outline?: SourceOutline;
+    readonly effects?: SourceEffectList;
+    readonly style?: SourceShapeStyle;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+interface SourceGroup {
+    readonly kind: "group";
+    readonly nodeId?: SourceNodeId;
+    readonly name?: string;
+    readonly transform?: SourceTransform;
+    readonly childTransform?: SourceTransform;
+    readonly fill?: SourceFill;
+    readonly effects?: SourceEffectList;
+    readonly children: readonly SourceShapeNode[];
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+/** crop (`a:srcRect`) of image. Preserve insets on each edge as OOXML percentages. */
+interface SourceImageCrop {
+    readonly left?: OoxmlPercent;
+    readonly top?: OoxmlPercent;
+    readonly right?: OoxmlPercent;
+    readonly bottom?: OoxmlPercent;
+}
+interface SourceImageStretch {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+}
+/** image (`p:pic`). The blip keeps the relationship id (`r:embed`) unresolved. */
+interface SourceImage {
+    readonly kind: "image";
+    readonly nodeId?: SourceNodeId;
+    readonly name?: string;
+    readonly transform?: SourceTransform;
+    /** Relationship id of `a:blip@r:embed`. The media part is resolved by the computed view. */
+    readonly blipRelationshipId?: RelationshipId;
+    readonly crop?: SourceImageCrop;
+    readonly stretch?: SourceImageStretch;
+    readonly tile?: SourceImageFillTile;
+    readonly effects?: SourceEffectList;
+    readonly blipEffects?: SourceBlipEffects;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+interface SourceTable {
+    readonly kind: "table";
+    readonly nodeId?: SourceNodeId;
+    readonly name?: string;
+    readonly transform?: SourceTransform;
+    readonly table: SourceTableData;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+interface SourceTableData {
+    readonly columns: readonly SourceTableColumn[];
+    readonly rows: readonly SourceTableRow[];
+    readonly tableStyleId?: string;
+}
+interface SourceTableColumn {
+    readonly width: Emu;
+}
+interface SourceTableRow {
+    readonly height: Emu;
+    readonly cells: readonly SourceTableCell[];
+}
+interface SourceTableCell {
+    readonly textBody?: SourceTextBody;
+    readonly fill?: SourceFill;
+    readonly borders?: SourceCellBorders;
+    readonly gridSpan: number;
+    readonly rowSpan: number;
+    readonly hMerge: boolean;
+    readonly vMerge: boolean;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+interface SourceCellBorders {
+    readonly top?: SourceOutline;
+    readonly bottom?: SourceOutline;
+    readonly left?: SourceOutline;
+    readonly right?: SourceOutline;
+}
+interface SourceChart {
+    readonly kind: "chart";
+    readonly nodeId?: SourceNodeId;
+    readonly name?: string;
+    readonly transform?: SourceTransform;
+    /** Relationship id of `c:chart@r:id`. The chart part is resolved by the computed view. */
+    readonly chartRelationshipId?: RelationshipId;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+interface SourceSmartArt {
+    readonly kind: "smartArt";
+    readonly nodeId?: SourceNodeId;
+    readonly name?: string;
+    readonly transform?: SourceTransform;
+    /** Relationship id of `dgm:relIds@r:dm`. Diagram data/drawing parts are resolved by the computed view. */
+    readonly dataRelationshipId?: RelationshipId;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+/**
+ * Raw escape hatch for shape tree nodes that are not represented as typed nodes. Unsupported shapes,
+ * groups, connectors, and similar nodes are saved for round trips.
+ */
+interface SourceRawShapeNode {
+    readonly kind: "raw";
+    readonly nodeId?: SourceNodeId;
+    readonly raw: RawSidecar;
+    readonly handle?: SourceHandle;
+}
+/** Shape tree source node union. */
+type SourceShapeNode = SourceShape | SourceConnector | SourceGroup | SourceImage | SourceTable | SourceChart | SourceSmartArt | SourceRawShapeNode;
+
+/**
+ * Source types for the presentation hierarchy.
+ *
+ * Slide, layout, master, and theme relationships are represented by part paths. Each
+ * part stays separate; resolving the master -> layout -> slide cascade is the computed
+ * view's responsibility. Materials needed for that resolution, such as background,
+ * clrMap, clrMapOvr, theme scheme, and showMasterSp, are kept as source-local values so
+ * the source model can retain them without falling back to raw XML.
+ */
+
+/** Slide size (`p:sldSz`), kept in EMUs. */
+interface SlideSize {
+    readonly width: Emu;
+    readonly height: Emu;
+}
+/**
+ * Color map (`p:clrMap`) / color map override (`p:clrMapOvr`). Keeps the mapping from
+ * logical names (`bg1` / `tx1` / `accent1`, etc.) to theme scheme slots (`dk1` / `lt1`,
+ * etc.) unresolved.
+ */
+interface SourceColorMap {
+    readonly mapping: Readonly<Record<string, string>>;
+}
+/**
+ * Slide / layout / master background (`p:bg`). This is either a direct fill
+ * (`p:bgPr`), a theme style matrix reference (`p:bgRef`), or raw content.
+ */
+type SourceBackground = {
+    readonly kind: "fill";
+    readonly fill: SourceFill;
+} | {
+    readonly kind: "styleReference";
+    readonly index: number;
+    readonly color: SourceColor;
+} | {
+    readonly kind: "raw";
+    readonly raw: RawSidecar;
+};
+/** Theme color scheme (`a:clrScheme`). Maps slot names to unconverted concrete colors. */
+interface SourceThemeColorScheme {
+    /** `dk1` / `lt1` / `dk2` / `lt2` / `accent1`..`accent6` / `hlink` / `folHlink`. */
+    readonly colors: Readonly<Record<string, SourceColor>>;
+}
+/** Minimal subset of the theme font scheme (`a:fontScheme`). */
+interface SourceThemeFontScheme {
+    readonly majorLatin?: string;
+    readonly minorLatin?: string;
+    readonly majorEastAsian?: string;
+    readonly minorEastAsian?: string;
+    readonly majorComplexScript?: string;
+    readonly minorComplexScript?: string;
+    readonly majorJapanese?: string;
+    readonly minorJapanese?: string;
+}
+/** Subset of the theme format scheme (`a:fmtScheme`) used for shape style ref resolution. */
+interface SourceThemeFormatScheme {
+    readonly fillStyles: readonly SourceFill[];
+    readonly lineStyles: readonly SourceOutline[];
+    readonly effectStyles: readonly (SourceEffectList | undefined)[];
+    readonly backgroundFillStyles: readonly SourceFill[];
+}
+/** theme part (`ppt/theme/themeN.xml`). */
+interface SourceTheme {
+    readonly partPath: PartPath;
+    readonly name?: string;
+    readonly colorScheme?: SourceThemeColorScheme;
+    readonly fontScheme?: SourceThemeFontScheme;
+    readonly formatScheme?: SourceThemeFormatScheme;
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+/** Slide master part. References the theme and child layouts. */
+interface SourceSlideMaster {
+    readonly partPath: PartPath;
+    /** Theme part referenced by this master. */
+    readonly themePartPath?: PartPath;
+    /** Layout parts belonging to this master. */
+    readonly layoutPartPaths: readonly PartPath[];
+    readonly background?: SourceBackground;
+    /** Master `p:clrMap`. */
+    readonly colorMap?: SourceColorMap;
+    readonly txStyles?: SourceMasterTextStyles;
+    readonly shapes: readonly SourceShapeNode[];
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+interface SourceMasterTextStyles {
+    readonly titleStyle?: SourceTextStyle;
+    readonly bodyStyle?: SourceTextStyle;
+    readonly otherStyle?: SourceTextStyle;
+}
+/** Slide layout part. References the parent master. */
+interface SourceSlideLayout {
+    readonly partPath: PartPath;
+    /** Parent slide master part for this layout. */
+    readonly masterPartPath: PartPath;
+    /** layout type (`p:sldLayout@type`). */
+    readonly type?: string;
+    readonly background?: SourceBackground;
+    /** Layout `p:clrMapOvr` (when overridden). */
+    readonly colorMapOverride?: SourceColorMap;
+    /** `p:sldLayout@showMasterSp` (master shape visibility). */
+    readonly showMasterShapes?: boolean;
+    readonly shapes: readonly SourceShapeNode[];
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+/** Slide part. References the applied layout. */
+interface SourceSlide {
+    readonly partPath: PartPath;
+    /** Layout part referenced by this slide. */
+    readonly layoutPartPath: PartPath;
+    readonly background?: SourceBackground;
+    /** Slide `p:clrMapOvr` (when overridden). */
+    readonly colorMapOverride?: SourceColorMap;
+    /** `p:sld@showMasterSp` (master shape visibility). */
+    readonly showMasterShapes?: boolean;
+    readonly shapes: readonly SourceShapeNode[];
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+/** Presentation part (`ppt/presentation.xml`). Maintains slide order. */
+interface SourcePresentation {
+    readonly partPath: PartPath;
+    readonly slideSize?: SlideSize;
+    readonly defaultTextStyle?: SourceTextStyle;
+    /** Slide part paths reflecting `p:sldIdLst` order. */
+    readonly slidePartPaths: readonly PartPath[];
+    readonly handle?: SourceHandle;
+    readonly rawSidecars?: readonly RawSidecar[];
+}
+
+/**
+ * Top-level types for the PptxSourceModel source model.
+ *
+ * This is the canonical PPTX document representation owned by
+ * `@pptx-glimpse/document`. Rather than exposing package parts directly as the public
+ * API, it groups presentation, slides, layouts, masters, themes, relationships, media,
+ * and content types as OOXML source semantics. Upper layers such as core, editor-core,
+ * and pom may consume this package, but this package must not depend on them. Renderer
+ * output is produced by the core adapter, and PptxSourceModel does not know about it.
+ *
+ * This model is the source of truth for writer, editor, and round-trip workflows. It
+ * keeps source-local values, relationship ids, part paths, element ordering, typed
+ * PPTX-domain units, stable source handles, diagnostics, and raw preservation hooks.
+ * Unsupported OOXML, vendor extensions, mc:AlternateContent, and unsupported DrawingML
+ * are not mixed into the typed operation API. They are preserved as raw sidecars or raw
+ * package parts for structural round-tripping.
+ *
+ * PptxSourceModel must not include renderer-specific fallbacks, environment-specific
+ * font substitution, SVG/PNG output, pixel-output values, or pom authoring primitives.
+ * Slide/layout/master/theme cascades, relationship resolution, theme color resolution,
+ * placeholder and text style resolution, and similar effective values are derived from
+ * the source as a non-mutating computed view.
+ */
+
+interface PptxSourceModel {
+    /** Structure of package part / relationship / content type / media. */
+    readonly packageGraph: PackageGraph;
+    readonly presentation: SourcePresentation;
+    readonly slides: readonly SourceSlide[];
+    readonly slideLayouts: readonly SourceSlideLayout[];
+    readonly slideMasters: readonly SourceSlideMaster[];
+    readonly themes: readonly SourceTheme[];
+    /** Diagnostics about document correctness. */
+    readonly diagnostics: readonly Diagnostic[];
+    /** typed PptxSourceModel operation and dirty scope. The writer determines the minimum update range from this. */
+    readonly edits?: readonly PptxSourceModelEdit[];
+}
+type PptxSourceModelEdit = PptxSourceModelTextRunEdit | PptxSourceModelParagraphTextEdit | PptxSourceModelShapeTransformEdit;
+interface PptxSourceModelTextRunEdit {
+    readonly kind: "replaceTextRunPlainText";
+    readonly handle: SourceHandle;
+    readonly text: string;
+}
+interface PptxSourceModelParagraphTextEdit {
+    readonly kind: "replaceParagraphPlainText";
+    readonly handle: SourceHandle;
+    readonly text: string;
+}
+interface PptxSourceModelShapeTransformEdit {
+    readonly kind: "updateShapeTransform";
+    readonly handle: SourceHandle;
+    readonly offsetX: Emu;
+    readonly offsetY: Emu;
+    readonly width: Emu;
+    readonly height: Emu;
+}
+
+/**
+ * PptxSourceModel computed view types.
+ *
+ * This view derives effective document values from the slide / layout / master / theme
+ * cascade without mutating the source model. The source keeps each package part's
+ * authored state and raw preservation hooks, while this view deterministically resolves
+ * presentation order, slide size, the per-slide layout/master/theme chain, relationship
+ * targets, background fallback, theme color maps and schemes, placeholder matches, text
+ * style cascades, showMasterSp visibility, and computed element ordering.
+ *
+ * The computed view is a projection of document semantics, not an editable source of
+ * truth. It keeps the part path, source node, and source layer needed for source
+ * provenance and diagnostics, but it does not materialize renderer-contract-friendly
+ * required defaults or `null` fallbacks here. Chart XML type, series, categories,
+ * legend, and similar data are projected into parsed chart data as OOXML document
+ * semantics, while renderer-specific drawing completion and pixel layout decisions
+ * remain in the adapter / renderer.
+ *
+ * Renderer-specific pixel conversion, system font discovery, font fallback, text
+ * measurement / wrapping, text-to-path, SVG/PNG output decisions, and renderer warning
+ * policy remain the responsibility of the core adapter or renderer. Raw elements, raw
+ * fills, and raw backgrounds are kept for preservation and diagnostics, and the adapter
+ * decides direct rendering policy.
+ */
+
+interface CreateComputedViewOptions {
+    /** 1-based slide numbers. When omitted, all slides in presentation order are used. */
+    readonly slides?: readonly number[];
+    /** Applies `p:sld@showMasterSp` / `p:sldLayout@showMasterSp`. Defaults to true. */
+    readonly applyMasterVisibility?: boolean;
+}
+interface PptxComputedView {
+    readonly slideSize?: ComputedSlideSize;
+    readonly slides: readonly ComputedSlide[];
+}
+interface ComputedSlideSize {
+    readonly width: Emu;
+    readonly height: Emu;
+}
+interface ComputedSlide {
+    readonly slideNumber: number;
+    readonly partPath: PartPath;
+    readonly layoutPartPath?: PartPath;
+    readonly masterPartPath?: PartPath;
+    readonly themePartPath?: PartPath;
+    readonly slideSize?: ComputedSlideSize;
+    readonly relationships: readonly ComputedRelationship[];
+    readonly colorMap: Readonly<Record<string, string>>;
+    readonly colorScheme: Readonly<Record<string, string>>;
+    readonly background?: ComputedBackground;
+    readonly showMasterShapes: boolean;
+    readonly layoutShowMasterShapes: boolean;
+    readonly elements: readonly ComputedElement[];
+}
+interface ComputedRelationship {
+    readonly id: RelationshipId;
+    readonly type: string;
+    readonly source: Relationship;
+    readonly target: string;
+    readonly targetMode?: "Internal" | "External";
+    readonly targetPartPath?: PartPath;
+    readonly media?: MediaPart;
+}
+type ComputedElement = ComputedShapeElement | ComputedConnectorElement | ComputedGroupElement | ComputedImageElement | ComputedTableElement | ComputedChartElement | ComputedSmartArtElement | ComputedRawElement;
+type ComputedElementLayer = "master" | "layout" | "slide";
+interface ComputedElementBase {
+    readonly sourceLayer: ComputedElementLayer;
+    readonly sourcePartPath: PartPath;
+    readonly sourceNode: SourceShapeNode;
+}
+interface ComputedShapeElement extends ComputedElementBase {
+    readonly kind: "shape";
+    readonly sourceNode: SourceShape;
+    readonly transform?: SourceTransform;
+    readonly geometry?: SourceShape["geometry"];
+    readonly fill?: ComputedFill;
+    readonly outline?: ComputedOutline;
+    readonly effects?: ComputedEffectList;
+    readonly textBody?: ComputedTextBody;
+    readonly placeholderMatch?: ComputedPlaceholderMatch;
+}
+interface ComputedImageElement extends ComputedElementBase {
+    readonly kind: "image";
+    readonly sourceNode: SourceImage;
+    readonly transform?: SourceTransform;
+    readonly relationship?: ComputedRelationship;
+    readonly media?: MediaPart;
+    readonly effects?: ComputedEffectList;
+    readonly blipEffects?: ComputedBlipEffects;
+}
+interface ComputedConnectorElement extends ComputedElementBase {
+    readonly kind: "connector";
+    readonly sourceNode: SourceConnector;
+    readonly transform?: SourceTransform;
+    readonly geometry?: SourceConnector["geometry"];
+    readonly outline?: ComputedOutline;
+    readonly effects?: ComputedEffectList;
+}
+interface ComputedGroupElement extends ComputedElementBase {
+    readonly kind: "group";
+    readonly sourceNode: SourceGroup;
+    readonly transform?: SourceTransform;
+    readonly childTransform?: SourceTransform;
+    readonly fill?: ComputedFill;
+    readonly effects?: ComputedEffectList;
+    readonly children: readonly ComputedElement[];
+}
+interface ComputedTableElement extends ComputedElementBase {
+    readonly kind: "table";
+    readonly sourceNode: SourceTable;
+    readonly transform?: SourceTransform;
+    readonly table: ComputedTableData;
+}
+interface ComputedChartElement extends ComputedElementBase {
+    readonly kind: "chart";
+    readonly sourceNode: SourceChart;
+    readonly transform?: SourceTransform;
+    readonly relationship?: ComputedRelationship;
+    readonly chartXml?: string;
+    readonly chartData?: ComputedChartData;
+}
+type ComputedChartType = "bar" | "line" | "pie" | "doughnut" | "scatter" | "bubble" | "area" | "radar" | "stock" | "surface" | "ofPie";
+interface ComputedChartData {
+    readonly chartType: ComputedChartType;
+    readonly title: string | null;
+    readonly series: readonly ComputedChartSeries[];
+    readonly categories: readonly string[];
+    readonly barDirection?: "col" | "bar";
+    readonly holeSize?: number;
+    readonly radarStyle?: "standard" | "marker" | "filled";
+    readonly ofPieType?: "pie" | "bar";
+    readonly secondPieSize?: number;
+    readonly splitPos?: number;
+    readonly legend: ComputedChartLegend | null;
+}
+interface ComputedChartSeries {
+    readonly name: string | null;
+    readonly values: readonly number[];
+    readonly xValues?: readonly number[];
+    readonly bubbleSizes?: readonly number[];
+    readonly color: ComputedColor;
+}
+interface ComputedChartLegend {
+    readonly position: "b" | "t" | "l" | "r" | "tr";
+}
+interface ComputedSmartArtElement extends ComputedElementBase {
+    readonly kind: "smartArt";
+    readonly sourceNode: SourceSmartArt;
+    readonly transform?: SourceTransform;
+    readonly dataRelationship?: ComputedRelationship;
+    readonly drawingRelationship?: ComputedRelationship;
+    readonly drawingPartPath?: PartPath;
+    readonly drawingXml?: string;
+    readonly drawingRelationships: readonly ComputedRelationship[];
+    readonly media: readonly MediaPart[];
+    readonly diagramDrawing?: ComputedDiagramDrawing;
+}
+interface ComputedDiagramDrawing {
+    readonly sourcePartPath: PartPath;
+    readonly rawXml: string;
+    readonly rawPart?: RawPackagePart;
+    readonly rawHandle: {
+        readonly partPath: PartPath;
+    };
+    readonly relationships: readonly ComputedRelationship[];
+    readonly media: readonly MediaPart[];
+    readonly childTransform?: SourceTransform;
+    readonly children: readonly ComputedElement[];
+    readonly diagnostics: readonly ComputedDiagramDrawingDiagnostic[];
+}
+interface ComputedDiagramDrawingDiagnostic {
+    readonly severity: "warning";
+    readonly code: "diagram-drawing-shape-tree-missing";
+    readonly message: string;
+    readonly sourcePartPath: PartPath;
+}
+interface ComputedTableData {
+    readonly columns: readonly SourceTableColumn[];
+    readonly rows: readonly ComputedTableRow[];
+}
+interface ComputedTableRow {
+    readonly source: SourceTableRow;
+    readonly height: SourceTableRow["height"];
+    readonly cells: readonly ComputedTableCell[];
+}
+interface ComputedTableCell {
+    readonly source: SourceTableCell;
+    readonly textBody?: ComputedTextBody;
+    readonly fill?: ComputedFill;
+    readonly borders?: ComputedCellBorders;
+    readonly gridSpan: number;
+    readonly rowSpan: number;
+    readonly hMerge: boolean;
+    readonly vMerge: boolean;
+}
+type ComputedCellBorders = {
+    readonly [K in keyof SourceCellBorders]?: ComputedOutline;
+};
+interface ComputedRawElement extends ComputedElementBase {
+    readonly kind: "raw";
+    readonly sourceNode: SourceRawShapeNode;
+}
+interface ComputedPlaceholderMatch {
+    readonly layout?: SourceShape;
+    readonly master?: SourceShape;
+}
+type ComputedBackground = {
+    readonly kind: "fill";
+    readonly source: SourceBackground;
+    readonly fill: ComputedFill;
+    readonly sourceLayer: ComputedElementLayer;
+} | {
+    readonly kind: "styleReference";
+    readonly source: SourceBackground;
+    readonly index: number;
+    readonly color?: ComputedColor;
+    readonly sourceLayer: ComputedElementLayer;
+} | {
+    readonly kind: "raw";
+    readonly source: SourceBackground;
+    readonly sourceLayer: ComputedElementLayer;
+};
+type ComputedFill = {
+    readonly kind: "none";
+    readonly source: SourceFill;
+} | {
+    readonly kind: "solid";
+    readonly source: SourceFill;
+    readonly color: ComputedColor;
+} | {
+    readonly kind: "gradient";
+    readonly source: SourceFill;
+    readonly stops: readonly ComputedGradientStop[];
+    readonly gradientType: "linear" | "radial";
+    readonly angle?: number;
+    readonly centerX?: number;
+    readonly centerY?: number;
+} | {
+    readonly kind: "pattern";
+    readonly source: SourceFill;
+    readonly preset: string;
+    readonly foregroundColor: ComputedColor;
+    readonly backgroundColor: ComputedColor;
+} | {
+    readonly kind: "image";
+    readonly source: SourceFill;
+    readonly relationship?: ComputedRelationship;
+    readonly media?: MediaPart;
+    readonly tile?: Extract<SourceFill, {
+        readonly kind: "image";
+    }>["tile"];
+} | {
+    readonly kind: "raw";
+    readonly source: SourceFill;
+};
+interface ComputedGradientStop {
+    readonly position: number;
+    readonly color: ComputedColor;
+}
+interface ComputedOutline {
+    readonly width?: Emu;
+    readonly fill?: ComputedFill;
+    readonly source: SourceOutline;
+}
+interface ComputedEffectList {
+    readonly source: SourceEffectList;
+    readonly outerShadow?: ComputedOuterShadow;
+    readonly innerShadow?: ComputedInnerShadow;
+    readonly glow?: ComputedGlow;
+    readonly softEdge?: SourceEffectList["softEdge"];
+}
+interface ComputedOuterShadow {
+    readonly blurRadius: Emu;
+    readonly distance: Emu;
+    readonly direction: number;
+    readonly color: ComputedColor;
+    readonly alignment: SourceRectangleAlignment;
+    readonly rotateWithShape: boolean;
+}
+interface ComputedInnerShadow {
+    readonly blurRadius: Emu;
+    readonly distance: Emu;
+    readonly direction: number;
+    readonly color: ComputedColor;
+}
+interface ComputedGlow {
+    readonly radius: Emu;
+    readonly color: ComputedColor;
+}
+interface ComputedBlipEffects {
+    readonly source: SourceBlipEffects;
+    readonly grayscale: boolean;
+    readonly biLevel?: SourceBlipEffects["biLevel"];
+    readonly blur?: SourceBlipEffects["blur"];
+    readonly lum?: SourceBlipEffects["lum"];
+    readonly duotone?: ComputedDuotoneEffect;
+    readonly clrChange?: ComputedColorChangeEffect;
+}
+interface ComputedDuotoneEffect {
+    readonly color1: ComputedColor;
+    readonly color2: ComputedColor;
+}
+interface ComputedColorChangeEffect {
+    readonly from: ComputedColor;
+    readonly to: ComputedColor;
+}
+interface ComputedColor {
+    /** `#rrggbb`. */
+    readonly hex: string;
+    /** Normalized opacity in the 0-1 range. */
+    readonly alpha: number;
+}
+interface ComputedTextBody {
+    readonly properties?: SourceTextBodyProperties;
+    readonly paragraphs: readonly ComputedParagraph[];
+}
+interface ComputedParagraph {
+    readonly properties?: ComputedParagraphProperties;
+    readonly runs: readonly ComputedTextRun[];
+}
+interface ComputedParagraphProperties extends Omit<SourceParagraphProperties, "bulletColor" | "defaultRunProperties"> {
+    readonly bulletColor?: ComputedColor;
+}
+interface ComputedTextRun {
+    readonly text: string;
+    readonly properties?: ComputedRunProperties;
+}
+type ComputedRunProperties = Omit<SourceRunProperties, "color"> & {
+    readonly color?: ComputedColor;
+};
+
+declare function createComputedView(source: PptxSourceModel, options?: CreateComputedViewOptions): PptxComputedView;
+
+/**
+ * `readPptx(input)` - initial slice of the PptxSourceModel source reader.
+ *
+ * Reads the PPTX ZIP package, package graph (content types, relationships, and media),
+ * and presentation metadata (slide size and slide order), then returns them as a
+ * PptxSourceModel source. For each slide in presentation order, it follows the
+ * slide -> layout -> master -> theme chain and reads simple shapes, text, and images as
+ * typed source nodes. Unedited or unsupported parts and child elements are retained as
+ * raw package material or raw sidecars and used as the basis for structural round-trip
+ * preservation.
+ *
+ * Slide, layout, master, and theme parts that contain typed nodes also keep their
+ * original bytes through `packageGraph.rawParts` for writeback when the part is
+ * untouched. The typed model is for editing and computed views; the raw part is for
+ * round-tripping.
+ *
+ * Computed view generation and writer output are responsibilities of modules separate from the reader.
+ */
+
+/** Input bytes for `readPptx`. */
+type ReadPptxInput = Uint8Array;
+/**
+ * Reads a PPTX byte string and returns a PptxSourceModel source.
+ *
+ * @throws If presentation part is not found (= not a valid PPTX).
+ */
+declare function readPptx(input: ReadPptxInput): PptxSourceModel;
+
+/**
+ * `writePptx(source)` - the first round-trip slice of the PptxSourceModel source writer.
+ *
+ * The writer targets structural round-trip preservation rather than byte equality. It is
+ * not a package patcher that preserves XML attribute order, namespace prefix placement,
+ * ZIP metadata, or defaulted OOXML values. Content types and relationships are
+ * regenerated structurally from `packageGraph`; media bytes, unknown parts, and
+ * non-bookkeeping raw parts prefer the raw package material preserved by the reader.
+ * Only dirty scopes are updated according to supported PptxSourceModel operations.
+ *
+ * The current slice supports plain text-run replacement and top-level shape transform
+ * offset/extent edits, reserializing dirty slide XML parts and replacing only the
+ * targeted values via stable source handles.
+ * Node-level XML splicing, precise unsupported raw-sidecar invalidation, and package
+ * topology rewrites belong to later writer slices, but the API and dirty-scope tracking
+ * remain shaped for that extension path.
+ */
+
+/** `writePptx` output. */
+type WritePptxOutput = Uint8Array;
+/**
+ * Writes a PptxSourceModel source back to PPTX package bytes.
+ *
+ * This initial round-trip writer prefers unedited package material
+ * to create preserved output. If the raw bytes needed to patch a dirty part are unavailable, or
+ * a non-bookkeeping part lacks required raw bytes,
+ * it throws instead of regenerating content implicitly.
+ */
+declare function writePptx(source: PptxSourceModel): WritePptxOutput;
+
+export { type ComputedBackground, type ComputedBlipEffects, type ComputedCellBorders, type ComputedChartData, type ComputedChartElement, type ComputedChartLegend, type ComputedChartSeries, type ComputedChartType, type ComputedColor, type ComputedColorChangeEffect, type ComputedConnectorElement, type ComputedDiagramDrawing, type ComputedDiagramDrawingDiagnostic, type ComputedDuotoneEffect, type ComputedEffectList, type ComputedElement, type ComputedElementLayer, type ComputedFill, type ComputedGroupElement, type ComputedImageElement, type ComputedOutline, type ComputedParagraph, type ComputedPlaceholderMatch, type ComputedRawElement, type ComputedRelationship, type ComputedRunProperties, type ComputedShapeElement, type ComputedSlide, type ComputedSlideSize, type ComputedSmartArtElement, type ComputedTableCell, type ComputedTableData, type ComputedTableElement, type ComputedTableRow, type ComputedTextBody, type ComputedTextRun, type ContentTypeDefault, type ContentTypeOverride, type ContentTypes, type CreateComputedViewOptions, type Diagnostic, type DiagnosticSeverity, type Emu, type HundredthPt, type MediaPart, type OoxmlAngle, type OoxmlPercent, type PackageGraph, type PackagePartRef, type PartPath, type PartRelationships, type PptxComputedView, type PptxSourceModel, type PptxSourceModelEdit, type PptxSourceModelParagraphTextEdit, type PptxSourceModelShapeTransformEdit, type PptxSourceModelTextRunEdit, type Pt, type RawOoxmlNode, type RawPackagePart, type RawSidecar, type RawSidecarId, type ReadPptxInput, type Relationship, type RelationshipId, type RelationshipTargetMode, type SlideSize, type SourceArrowEndpoint, type SourceArrowSize, type SourceArrowType, type SourceAutoNumScheme, type SourceBackground, type SourceBiLevelEffect, type SourceBlipEffects, type SourceBlurEffect, type SourceBulletType, type SourceCellBorders, type SourceChart, type SourceColor, type SourceColorChangeEffect, type SourceColorMap, type SourceColorTransform, type SourceConnector, type SourceCustomGeometry, type SourceCustomGeometryPath, type SourceDashStyle, type SourceDuotoneEffect, type SourceEffectList, type SourceFill, type SourceGeometry, type SourceGlow, type SourceGradient, type SourceGradientStop, type SourceGroup, type SourceHandle, type SourceImage, type SourceImageCrop, type SourceImageFillTile, type SourceImageStretch, type SourceInnerShadow, type SourceLineCap, type SourceLineJoin, type SourceLumEffect, type SourceMasterTextStyles, type SourceNodeId, type SourceOuterShadow, type SourceOutline, type SourceParagraph, type SourceParagraphProperties, type SourcePlaceholder, type SourcePresentation, type SourcePresetGeometry, type SourceRawShapeNode, type SourceRectangleAlignment, type SourceRunProperties, type SourceShape, type SourceShapeNode, type SourceShapeStyle, type SourceSlide, type SourceSlideLayout, type SourceSlideMaster, type SourceSmartArt, type SourceSoftEdge, type SourceSpacingValue, type SourceStyleReference, type SourceTabStop, type SourceTable, type SourceTableCell, type SourceTableColumn, type SourceTableData, type SourceTableRow, type SourceTextAlign, type SourceTextAutoFit, type SourceTextBody, type SourceTextBodyProperties, type SourceTextRun, type SourceTextStyle, type SourceTextVerticalType, type SourceTextWrap, type SourceTheme, type SourceThemeColorScheme, type SourceThemeFontScheme, type SourceThemeFormatScheme, type SourceTransform, type SourceVerticalAnchor, type UpdateShapeTransformInput, type WritePptxOutput, asEmu, asHundredthPt, asOoxmlAngle, asOoxmlPercent, asPartPath, asPt, asRawSidecarId, asRelationshipId, asSourceNodeId, createComputedView, findParagraphBySourceHandle, findShapeNodeBySourceHandle, findTextRunBySourceHandle, readPptx, replaceParagraphPlainText, replaceTextRunPlainText, updateShapeTransform, writePptx };