ooxml-core 1.1.0 → 1.2.0

package/dist/diagram/model/node.d.ts

@@ -0,0 +1,194 @@
+/**
+ * SmartArt data-model node types: per-run text, per-node visual override, and
+ * the node itself. `S` is the reader's resolved run style (pptx: its
+ * `TextStyle`); the layout engine never reads it. Moved from
+ * `pptx/core/types/smart-art-node.ts`.
+ */
+import type { DiagramNodeCustomLayout } from '../types.js';
+/**
+ * A single run of text inside a SmartArt node, capturing the run text and the
+ * raw `a:rPr` run-properties object verbatim so per-run formatting (bold,
+ * colour, size, etc.) survives a load -> edit -> save round-trip instead of
+ * collapsing to a single unstyled run.
+ *
+ * @example
+ * ```ts
+ * const run: DiagramNodeTextRun = {
+ *   text: "Bold",
+ *   rPr: { "@_b": "1", "@_lang": "en-US" },
+ * };
+ * // => satisfies DiagramNodeTextRun
+ * ```
+ */
+export interface DiagramNodeTextRun<S = unknown> {
+    /** Run text content. */
+    text: string;
+    /**
+     * Raw parsed `a:rPr` run-properties object, preserved verbatim for
+     * round-trip. Untyped XML, hence the loose record shape.
+     */
+    rPr?: Record<string, unknown>;
+    /** Resolved standard shape-text style derived from {@link rPr}. */
+    style?: S;
+    /** Raw run XML used to retain unmodelled extension children on save. */
+    rawXml?: Record<string, unknown>;
+    /** Original direct-child order, including unmodelled extension children. */
+    childOrder?: string[];
+}
+/** An ordered item within a SmartArt text paragraph. */
+export type DiagramNodeTextParagraphItem<S = unknown> = {
+    kind: 'run';
+    run: DiagramNodeTextRun<S>;
+} | {
+    kind: 'break';
+    rPr?: Record<string, unknown>;
+    style?: S;
+    rawXml?: Record<string, unknown>;
+    childOrder?: string[];
+} | {
+    kind: 'field';
+    id?: string;
+    fieldType?: string;
+    text: string;
+    rPr?: Record<string, unknown>;
+    style?: S;
+    pPr?: Record<string, unknown>;
+    rawXml?: Record<string, unknown>;
+    childOrder?: string[];
+} | {
+    kind: 'tab';
+    rawXml?: Record<string, unknown>;
+    childOrder?: string[];
+} | {
+    kind: 'raw';
+    name: string;
+    value: unknown;
+};
+/** A complete `a:p` paragraph in a SmartArt data-model text body. */
+export interface DiagramNodeTextParagraph<S = unknown> {
+    /** Paragraph properties (`a:pPr`) preserved verbatim. */
+    pPr?: Record<string, unknown>;
+    /** Text children in source order. */
+    items: DiagramNodeTextParagraphItem<S>[];
+    /** End-paragraph run properties (`a:endParaRPr`) preserved verbatim. */
+    endParaRPr?: Record<string, unknown>;
+    /** Resolved style for the paragraph terminator. */
+    endParaStyle?: S;
+    /** Raw paragraph XML used to retain unmodelled extension children on save. */
+    rawXml?: Record<string, unknown>;
+}
+/**
+ * Per-node visual override for a SmartArt node.
+ *
+ * Captures the individual fill / line / font colour and the bold / italic
+ * emphasis a user has set on one specific node, independent of the diagram's
+ * colour scheme and quick style. All colours are hex strings (e.g. "#FF0000").
+ * Every field is optional: only the overridden aspects are carried, so an
+ * empty object means "no per-node override".
+ *
+ * The parser reads these from the data point's `spPr` solid fill / line colour
+ * and the first run's `rPr` (b / i / solidFill) when present, and the save path
+ * writes them back so the override survives a load -> edit -> save round-trip.
+ *
+ * @example
+ * ```ts
+ * const style: DiagramNodeStyle = {
+ *   fillColor: "#FF0000",
+ *   fontColor: "#FFFFFF",
+ *   bold: true,
+ * };
+ * // => satisfies DiagramNodeStyle
+ * ```
+ */
+export interface DiagramNodeStyle {
+    /** Solid fill colour override (hex, e.g. "#4F81BD"). */
+    fillColor?: string;
+    /** Outline / line colour override (hex). */
+    lineColor?: string;
+    /** Text (font) colour override (hex). */
+    fontColor?: string;
+    /** Bold emphasis override for the node's runs. */
+    bold?: boolean;
+    /** Italic emphasis override for the node's runs. */
+    italic?: boolean;
+}
+/**
+ * A single node in the SmartArt data model.
+ *
+ * @example
+ * ```ts
+ * const node: DiagramNode = {
+ *   id: "1",
+ *   text: "CEO",
+ *   children: [
+ *     { id: "2", text: "VP Marketing", parentId: "1" },
+ *     { id: "3", text: "VP Engineering", parentId: "1" },
+ *   ],
+ * };
+ * // => satisfies DiagramNode
+ * ```
+ */
+export interface DiagramNode<S = unknown> {
+    id: string;
+    text: string;
+    /** CT_Pt connection identifier, when the point references a connection. */
+    connectionId?: string | null;
+    parentId?: string | undefined;
+    children?: DiagramNode<S>[];
+    /** Node type from `@_type` attribute (e.g. "doc", "node", "asst", "pres"). */
+    nodeType?: string;
+    /**
+     * The node's own quick-style role (`dgm:prSet/@presStyleLbl` from its
+     * paired `type="pres"` presentation point, resolved via a `presOf`
+     * connection back to this content point). Structural names like `node1`,
+     * `asst2`, `bgShp`, `revTx`; distinct from {@link nodeType}, which is the
+     * data-model `@_type` ("node"/"asst"/...). Used to pick this node's own
+     * colour list from a colour transform's per-role palettes instead of the
+     * generic cycled palette (see `applySmartArtRoleColors`).
+     */
+    styleRole?: string;
+    /**
+     * `dgm:prSet/@coherent3DOff` (`CT_ElemPropSet`) resolved from the node's
+     * paired presentation point: when true, this node opts out of the
+     * diagram's overall coherent-3D scene rotation (a `dgm:scene3d`/`dgm:sp3d`
+     * quick-style variation) applied to every other node.
+     */
+    coherent3DOff?: boolean;
+    /**
+     * The layout variables PowerPoint recorded for each presentation node
+     * this point drives (`dgm:prSet/@presName` -> `dgm:presLayoutVars`
+     * variable -> `@val`), e.g. `{ hierRoot1: { hierBranch: 'l' } }` for an
+     * org-chart manager set to "Left Hanging". Read-only: the presentation
+     * points themselves round-trip verbatim.
+     */
+    presLayoutVarsByName?: Record<string, Record<string, string>>;
+    /**
+     * Per-run text + run-properties for the node's first paragraph, captured at
+     * parse time. When the joined run text still equals {@link text} (the node
+     * was not edited, or was edited only in ways that preserve the run split),
+     * the save path rebuilds the paragraph from these runs so per-run rich text
+     * is not flattened. When {@link text} diverges, the runs are ignored.
+     */
+    runs?: DiagramNodeTextRun<S>[];
+    /**
+     * Complete typed paragraph model. Unlike {@link runs}, this retains every
+     * paragraph and the ordered run, field, break, and tab children within it.
+     */
+    paragraphs?: DiagramNodeTextParagraph<S>[];
+    /**
+     * Optional per-node visual override (fill / line / font colour, bold /
+     * italic). Read at parse time from the point's `spPr` / first-run `rPr`, set
+     * by the editing op, honoured by the render path, and written back on save so
+     * it round-trips.
+     */
+    style?: DiagramNodeStyle;
+    /**
+     * Manual layout override read from the node's `dgm:prSet` `cust*`
+     * attributes (drag/resize/rotate/flip performed in PowerPoint's own diagram
+     * editor). Applied as a final transform after algorithmic layout by
+     * {@link module:smartart-layout-interpreter-custom} so it survives even
+     * when there is no cached `dsp:` drawing to fall back on.
+     */
+    customLayout?: DiagramNodeCustomLayout;
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/diagram/model/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../diagram/model/node.ts"],"names":[],"mappings":"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"}

package/dist/diagram/model/style-definition.d.ts

@@ -0,0 +1,131 @@
+/** Editable metadata shared by DiagramML quick-style and color definitions. */
+export interface DiagramDefinitionText {
+    value: string;
+    language?: string;
+}
+export interface DiagramDefinitionCategory {
+    type: string;
+    priority: number;
+}
+export type DiagramColorApplicationMethod = 'span' | 'cycle' | 'repeat';
+export type DiagramHueDirection = 'cw' | 'ccw';
+/** CT_Colors application metadata. Color-choice children remain preserved XML. */
+export interface DiagramColorListMetadata {
+    method?: DiagramColorApplicationMethod;
+    hueDirection?: DiagramHueDirection;
+}
+/**
+ * A quick-style label's `a:lnRef`/`a:fillRef`/`a:effectRef`/`a:fontRef`
+ * (`CT_ShapeStyle`, the same complex type an ordinary shape's `p:style`
+ * uses), resolved against the theme's `fmtScheme` at parse time instead of
+ * the coarse subtle/moderate/intense enum ({@link DiagramQuickStyle.effectIntensity}).
+ * Only populated when a theme format scheme was available when the quick
+ * style was parsed. See G13 in the 2026-09 diagram audit.
+ */
+export interface DiagramResolvedStyleRef {
+    fillColor?: string;
+    fillMode?: 'solid' | 'gradient' | 'pattern' | 'none' | 'theme';
+    strokeColor?: string;
+    strokeWidth?: number;
+    /** `a:effectRef`'s theme-resolved outer shadow colour, when the style has one. */
+    shadowColor?: string;
+    /** `a:fontRef`'s theme-resolved typeface (`+mn-lt`/`+mj-lt` -> the theme's actual font). */
+    fontTypeface?: string;
+}
+/** CT_StyleLabel metadata from a quick-style definition. */
+export interface DiagramQuickStyleLabel<Scene = unknown, Shape = unknown, Text = unknown> {
+    name: string;
+    /** Theme-resolved `dgm:style` refs for this label's role, when available. */
+    resolvedStyle?: DiagramResolvedStyleRef;
+    /**
+     * The label's own `dgm:scene3d` (per-shape camera + light rig). PowerPoint
+     * copies it onto a shape's cached `a:scene3d` unless it is the default
+     * front camera with a `threePt` light (see `applySmartArtQuickStyle3d`).
+     */
+    scene3d?: Scene;
+    /** The label's own `dgm:sp3d` (bevel / extrusion / contour / material); absent when empty. */
+    shape3d?: Shape;
+    /** The label's `dgm:txPr/a:sp3d` label-text extrusion (Bird's Eye Scene). */
+    text3d?: Text;
+}
+/** CT_CTStyleLabel metadata from a color-transform definition. */
+export interface DiagramColorTransformLabel {
+    name: string;
+    fill?: DiagramColorListMetadata;
+    line?: DiagramColorListMetadata;
+    effect?: DiagramColorListMetadata;
+    textLine?: DiagramColorListMetadata;
+    textFill?: DiagramColorListMetadata;
+    textEffect?: DiagramColorListMetadata;
+}
+export interface DiagramDefinitionMetadata {
+    uniqueId?: string;
+    minimumVersion?: string;
+    titles?: DiagramDefinitionText[];
+    descriptions?: DiagramDefinitionText[];
+    categories?: DiagramDefinitionCategory[];
+}
+/** Typed CT_ColorTransform metadata and the resolved legacy color palette. */
+export interface DiagramColorTransform extends DiagramDefinitionMetadata {
+    /** Legacy resolved display name. */
+    name?: string;
+    /** Ordered resolved fill colors for rendering. */
+    fillColors: string[];
+    /** Ordered resolved line colors for rendering. */
+    lineColors: string[];
+    /** Ordered resolved text-fill colors (primary styleLbl `txFillClrLst`). */
+    textFillColors?: string[];
+    /** Ordered resolved text-line colors (primary styleLbl `txLinClrLst`). */
+    textLineColors?: string[];
+    /** Ordered resolved effect colors (primary styleLbl `effectClrLst`). */
+    effectColors?: string[];
+    /** Ordered resolved text-effect colors (primary styleLbl `txEffectClrLst`). */
+    textEffectColors?: string[];
+    /** Fill-list span/cycle + hue-direction interpolation of the primary styleLbl. */
+    fillInterpolation?: DiagramColorListMetadata;
+    /** Line-list span/cycle + hue-direction interpolation of the primary styleLbl. */
+    lineInterpolation?: DiagramColorListMetadata;
+    /** Ordered CT_CTStyleLabel metadata. */
+    labels?: DiagramColorTransformLabel[];
+    /**
+     * Every `styleLbl`'s own resolved fill/line colour list, keyed by name
+     * (e.g. `node1`, `asst0`, `bgShp`, `revTx`). Unlike {@link fillColors} /
+     * {@link lineColors} (which collapse to ONE "primary" node-role list),
+     * this keeps every role so a node can be coloured from its OWN role's
+     * palette (see `DiagramNode.styleRole` and `applySmartArtRoleColors`)
+     * instead of a generic cycled colour.
+     */
+    roleColors?: Record<string, DiagramRoleColorList>;
+}
+/** One colour-transform `styleLbl`'s resolved colour lists. */
+export interface DiagramRoleColorList {
+    fill: string[];
+    line: string[];
+    /**
+     * `txFillClrLst`, when the label declares one (`revTx` -> `tx1`). A text
+     * node's colour comes from here; see `smartart-merged-text-label`.
+     */
+    textFill?: string[];
+}
+/** Typed CT_StyleDefinition metadata and legacy rendering hint. */
+export interface DiagramQuickStyle<Scene = unknown, Shape = unknown, Text = unknown> extends DiagramDefinitionMetadata {
+    /** Legacy resolved display name. */
+    name?: string;
+    /** Legacy effect-intensity rendering hint. */
+    effectIntensity?: string;
+    /** Ordered CT_StyleLabel metadata. Complex style payload remains preserved XML. */
+    labels?: DiagramQuickStyleLabel<Scene, Shape, Text>[];
+    /**
+     * Whole-diagram 3D scene (camera preset/rotation/zoom/fov, light rig,
+     * backdrop) from the quick style's own `dgm:styleDef/dgm:scene3d`, present
+     * for the "Scene" quick styles (Brick, Flat, Metallic, Sunset, Bird's Eye
+     * Scene). One camera renders the whole diagram; per-shape `a:scene3d` is
+     * absent for those styles (see the cached drawing shape's own `scene3d`). Each
+     * `dgm:styleLbl` also carries its own per-label `dgm:scene3d`/`dgm:sp3d`
+     * ({@link DiagramQuickStyleLabel.scene3d} / `shape3d` / `text3d`),
+     * which PowerPoint bakes onto each cached shape; they are re-applied when a
+     * structural edit regenerates the shapes.
+     */
+    scene3d?: Scene;
+}
+//# sourceMappingURL=style-definition.d.ts.map

package/dist/diagram/model/style-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-definition.d.ts","sourceRoot":"","sources":["../../../diagram/model/style-definition.ts"],"names":[],"mappings":"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"}

package/dist/docx/chart-paint.d.ts

@@ -0,0 +1,14 @@
+import type { ThemeColorScheme } from '../drawingml/theme-model.js';
+import type { DocxChart } from './chart.js';
+import type { ThemeCatalog } from './theme-model.js';
+/** The painted chart (`svg`), or only the frame label when the chart is not drawn. */
+export interface DocxChartPaint {
+    svg?: string;
+    /** `Chart`, or `Chart (bubble)` for a family the painter does not draw. */
+    label: string;
+}
+/** The document theme's colour slots as a DrawingML colour scheme. */
+export declare function themeCatalogColorScheme(theme: ThemeCatalog | undefined): ThemeColorScheme;
+/** Paints a chart at the drawing extent (CSS pixels). Never throws: failures give the frame. */
+export declare function docxChartPaint(chart: DocxChart | undefined, widthPx: number, heightPx: number, theme?: ThemeCatalog): DocxChartPaint;
+//# sourceMappingURL=chart-paint.d.ts.map

package/dist/docx/chart-paint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-paint.d.ts","sourceRoot":"","sources":["../../docx/chart-paint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACd;AAED,sEAAsE;AACtE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,gBAAgB,CAQzF;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,YAAY,GAClB,cAAc,CAsBhB"}

package/dist/docx/chart.d.ts

@@ -0,0 +1,43 @@
+import { type ChartParseIssue, type ChartSpace, type ChartStyleDefinition } from '../chart/index.js';
+import type { Block } from './model.js';
+import type { Relationship } from './package-parts.js';
+import { type XmlElement } from './xml.js';
+/** The `a:graphicData/@uri` of a chart. */
+export declare const CHART_GRAPHIC_URI = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+/** A chart (`c:chart` in a `w:drawing`). The chart part is read-only and preserved on save. */
+export interface DocxChart {
+    /** `inline` (`wp:inline`) or `anchor` (`wp:anchor`, floating). */
+    placement: 'inline' | 'anchor';
+    /** `wp:docPr/@name` and `@id`. */
+    name?: string;
+    id?: string;
+    /** `c:chart/@r:id`, in the part that holds the drawing. */
+    relId?: string;
+    /** The chart part, e.g. `word/charts/chart1.xml`, once the relationship resolves. */
+    partName?: string;
+    /** The parsed chart part (`c:chartSpace`); absent when the part could not be read. */
+    chartSpace?: ChartSpace;
+    /** Direct formatting read from the chart part (`readChartFormatting`), for painting. */
+    formatting?: ChartStyleDefinition;
+    /** The Office colour style id of the part's `chartColorStyle` relationship, when present. */
+    colorPalette?: number;
+    /** The chart title text, when the chart shows one. */
+    title?: string;
+    /** The embedded workbook part holding the chart data (`c:externalData`), when it is in the package. */
+    workbookPartName?: string;
+    /** What this model does and does not provide. */
+    notice: string;
+    /** Problems met resolving and reading the chart part, and what the chart model does not cover. */
+    issues: ChartParseIssue[];
+}
+/** The honest status shown with every chart. */
+export declare const CHART_NOTICE = "The chart is drawn from the values cached in its part (bar, column, line, area, pie, doughnut, scatter and radar charts; other kinds show a labelled frame). It is not editable, and the chart part and its workbook are preserved unchanged on save.";
+/** Reads the host side of a chart graphic. Synchronous: resolves the relationship, reads no part. */
+export declare function parseChartGraphic(graphicData: XmlElement, docPr: XmlElement | undefined, rels: ReadonlyMap<string, Relationship>, isAnchor: boolean): DocxChart;
+/** Reads the chart part (and its relationships) into the model. Never throws; problems go to `issues`. */
+export declare function resolveChartPart(chart: DocxChart, readText: (partName: string) => Promise<string | undefined>): Promise<void>;
+/** Every chart in the given blocks, in document order. */
+export declare function chartsIn(blocks: Block[]): DocxChart[];
+/** Reads the part of every chart in `blocks` (body, headers, footers, notes) through `readText`. */
+export declare function resolveDocumentCharts(blocks: Block[], readText: (partName: string) => Promise<string | undefined>): Promise<void>;
+//# sourceMappingURL=chart.d.ts.map

package/dist/docx/chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../docx/chart.ts"],"names":[],"mappings":"AAMA,OAAO,EAIN,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAEzD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,2DAA2D,CAAC;AAM1F,+FAA+F;AAC/F,MAAM,WAAW,SAAS;IACzB,kEAAkE;IAClE,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,wFAAwF;IACxF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,kGAAkG;IAClG,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,gDAAgD;AAChD,eAAO,MAAM,YAAY,0PAC+N,CAAC;AAEzP,qGAAqG;AACrG,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,UAAU,EACvB,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,EACvC,QAAQ,EAAE,OAAO,GACf,SAAS,CAqCX;AAED,0GAA0G;AAC1G,wBAAsB,gBAAgB,CACrC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,CAMrD;AAED,oGAAoG;AACpG,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/docx/drawing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drawing.d.ts","sourceRoot":"","sources":["../../docx/drawing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,SAAS,CAAC;AAC7D,OAAO,EAGN,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAWzD,+CAA+C;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChC;AAgOD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,WAAW,CAInF"}
+{"version":3,"file":"drawing.d.ts","sourceRoot":"","sources":["../../docx/drawing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,SAAS,CAAC;AAC7D,OAAO,EAGN,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAYzD,+CAA+C;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChC;AAqOD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,WAAW,CAInF"}