@office-open/core 0.8.1 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/README.md +32 -60
  2. package/dist/chart/index.d.mts +2 -2
  3. package/dist/chart/index.mjs +2 -2
  4. package/dist/chart-DNpai28f.mjs +365 -0
  5. package/dist/descriptor/index.d.mts +2 -0
  6. package/dist/descriptor/index.mjs +2 -0
  7. package/dist/descriptor-DKmR7pw-.mjs +282 -0
  8. package/dist/drawingml/index.d.mts +2 -2
  9. package/dist/drawingml/index.mjs +2 -2
  10. package/dist/index-BI-1SKm5.d.mts +153 -0
  11. package/dist/{index-Cj2Yf5mk.d.mts → index-DByjp6ug.d.mts} +10 -7
  12. package/dist/index-DNH2sizc.d.mts +137 -0
  13. package/dist/{index-DEvpdl1o.d.mts → index-RWXzxibP.d.mts} +1416 -1837
  14. package/dist/{index-D0N5Bw2M.d.mts → index-eu1aFQCm.d.mts} +39 -28
  15. package/dist/index.d.mts +7 -557
  16. package/dist/index.mjs +7 -2091
  17. package/dist/smartart/index.d.mts +2 -2
  18. package/dist/smartart/index.mjs +2 -2
  19. package/dist/{smartart-9ZpWgmIy.mjs → smartart-DCY-Vdv7.mjs} +120 -204
  20. package/dist/src-CU2AFKyt.mjs +7413 -0
  21. package/dist/theme/index.d.mts +2 -2
  22. package/dist/theme/index.mjs +2 -2
  23. package/dist/{theme-FWD_20fH.mjs → theme-CiNzdl-9.mjs} +117 -22
  24. package/dist/{values.d.mts → util/values.d.mts} +1 -1
  25. package/dist/{values.mjs → util/values.mjs} +1 -1
  26. package/dist/{values-BOWpTgBE.mjs → values-CVIZcTRw.mjs} +1 -1
  27. package/dist/{values-COjPGYkS.d.mts → values-Dqj8cbcy.d.mts} +1 -1
  28. package/package.json +12 -7
  29. package/dist/chart-CigYrDhf.mjs +0 -1242
  30. package/dist/drawingml-B-2eEHAF.mjs +0 -7109
  31. package/dist/index-Bh6s66Up.d.mts +0 -381
  32. package/dist/index-CoTp4wVf.d.mts +0 -202
  33. package/dist/xml-components-BuFdDxHN.mjs +0 -322
@@ -1,7 +1,21 @@
1
- import { a as BuilderElement, b as XmlComponent, w as IXmlableObject } from "./index-CoTp4wVf.mjs";
1
+ import { m as CustomDescriptor } from "./index-BI-1SKm5.mjs";
2
+ import { s as UniversalMeasure } from "./values-Dqj8cbcy.mjs";
3
+ import { Element } from "@office-open/xml";
4
+ import { ZipOptions, Zippable, Zippable as Zippable$1, strFromU8 as strFromU8$1, unzipSync as unzipSync$1 } from "fflate";
5
+ import { DataType, toUint8Array } from "undio";
2
6
  import { Buffer } from "\u0000polyfill-node.buffer";
3
7
 
4
8
  //#region src/drawingml/color/color-transform.d.ts
9
+ /**
10
+ * Color transform elements for DrawingML colors.
11
+ *
12
+ * This module provides color transformation elements defined in EG_ColorTransform,
13
+ * which can be applied as child elements to any color type (srgbClr, schemeClr, etc.).
14
+ *
15
+ * Reference: ISO/IEC 29500-4, dml-main.xsd, EG_ColorTransform
16
+ *
17
+ * @module
18
+ */
5
19
  /**
6
20
  * Options for color transforms.
7
21
  *
@@ -12,64 +26,64 @@ import { Buffer } from "\u0000polyfill-node.buffer";
12
26
  */
13
27
  interface ColorTransformOptions {
14
28
  /** Tint: moves color toward white (0-100000) */
15
- readonly tint?: number;
29
+ tint?: number;
16
30
  /** Shade: moves color toward black (0-100000) */
17
- readonly shade?: number;
31
+ shade?: number;
18
32
  /** Complement: inverts the color (no value) */
19
- readonly comp?: boolean;
33
+ comp?: boolean;
20
34
  /** Inverse: inverts the color (no value) */
21
- readonly inv?: boolean;
35
+ inv?: boolean;
22
36
  /** Grayscale: converts to grayscale (no value) */
23
- readonly gray?: boolean;
37
+ gray?: boolean;
24
38
  /** Alpha: sets transparency (0-100000) */
25
- readonly alpha?: number;
39
+ alpha?: number;
26
40
  /** Alpha offset: adjusts alpha by fixed amount (-100000 to 100000) */
27
- readonly alphaOff?: number;
41
+ alphaOff?: number;
28
42
  /** Alpha modulation: scales alpha by percentage (0-100000) */
29
- readonly alphaMod?: number;
43
+ alphaMod?: number;
30
44
  /** Hue: sets hue angle (0-21600000) */
31
- readonly hue?: number;
45
+ hue?: number;
32
46
  /** Hue offset: adjusts hue by angle (-5400000 to 5400000) */
33
- readonly hueOff?: number;
47
+ hueOff?: number;
34
48
  /** Hue modulation: scales hue by percentage (0-100000) */
35
- readonly hueMod?: number;
49
+ hueMod?: number;
36
50
  /** Saturation: sets saturation (-100000 to 100000) */
37
- readonly sat?: number;
51
+ sat?: number;
38
52
  /** Saturation offset: adjusts saturation (-100000 to 100000) */
39
- readonly satOff?: number;
53
+ satOff?: number;
40
54
  /** Saturation modulation: scales saturation (0-100000) */
41
- readonly satMod?: number;
55
+ satMod?: number;
42
56
  /** Luminance: sets luminance (-100000 to 100000) */
43
- readonly lum?: number;
57
+ lum?: number;
44
58
  /** Luminance offset: adjusts luminance (-100000 to 100000) */
45
- readonly lumOff?: number;
59
+ lumOff?: number;
46
60
  /** Luminance modulation: scales luminance (0-100000) */
47
- readonly lumMod?: number;
61
+ lumMod?: number;
48
62
  /** Red: sets red channel (-100000 to 100000) */
49
- readonly red?: number;
63
+ red?: number;
50
64
  /** Red offset: adjusts red channel (-100000 to 100000) */
51
- readonly redOff?: number;
65
+ redOff?: number;
52
66
  /** Red modulation: scales red channel (0-100000) */
53
- readonly redMod?: number;
67
+ redMod?: number;
54
68
  /** Green: sets green channel (-100000 to 100000) */
55
- readonly green?: number;
69
+ green?: number;
56
70
  /** Green offset: adjusts green channel (-100000 to 100000) */
57
- readonly greenOff?: number;
71
+ greenOff?: number;
58
72
  /** Green modulation: scales green channel (0-100000) */
59
- readonly greenMod?: number;
73
+ greenMod?: number;
60
74
  /** Blue: sets blue channel (-100000 to 100000) */
61
- readonly blue?: number;
75
+ blue?: number;
62
76
  /** Blue offset: adjusts blue channel (-100000 to 100000) */
63
- readonly blueOff?: number;
77
+ blueOff?: number;
64
78
  /** Blue modulation: scales blue channel (0-100000) */
65
- readonly blueMod?: number;
79
+ blueMod?: number;
66
80
  /** Gamma correction (no value) */
67
- readonly gamma?: boolean;
81
+ gamma?: boolean;
68
82
  /** Inverse gamma correction (no value) */
69
- readonly invGamma?: boolean;
83
+ invGamma?: boolean;
70
84
  }
71
85
  /**
72
- * Creates color transform child elements.
86
+ * Creates color transform child elements as XML strings.
73
87
  *
74
88
  * These elements modify the parent color according to OOXML color transform rules.
75
89
  * Multiple transforms can be applied in sequence.
@@ -82,7 +96,7 @@ interface ColorTransformOptions {
82
96
  * createColorTransforms({ alpha: 50000 });
83
97
  * ```
84
98
  */
85
- declare const createColorTransforms: (options: ColorTransformOptions) => readonly XmlComponent[];
99
+ declare const createColorTransforms: (options: ColorTransformOptions) => readonly string[];
86
100
  //#endregion
87
101
  //#region src/drawingml/color/hsl-color.d.ts
88
102
  /**
@@ -90,16 +104,16 @@ declare const createColorTransforms: (options: ColorTransformOptions) => readonl
90
104
  */
91
105
  interface HslColorOptions {
92
106
  /** Hue angle in 60,000ths of a degree (0-21600000) */
93
- readonly hue: number;
107
+ hue: number;
94
108
  /** Saturation in 1/1000th of a percent (0-100000) */
95
- readonly saturation: number;
109
+ saturation: number;
96
110
  /** Luminance in 1/1000th of a percent (0-100000) */
97
- readonly luminance: number;
111
+ luminance: number;
98
112
  /** Optional color transforms */
99
- readonly transforms?: ColorTransformOptions;
113
+ transforms?: ColorTransformOptions;
100
114
  }
101
115
  /**
102
- * Creates an HSL color element.
116
+ * Creates an HSL color element as an XML string.
103
117
  *
104
118
  * Specifies a color using Hue, Saturation, and Luminance values.
105
119
  *
@@ -115,7 +129,7 @@ interface HslColorOptions {
115
129
  * </xsd:complexType>
116
130
  * ```
117
131
  */
118
- declare const createHslColor: (options: HslColorOptions) => XmlComponent;
132
+ declare const createHslColor: (options: HslColorOptions) => string;
119
133
  //#endregion
120
134
  //#region src/drawingml/color/preset-color.d.ts
121
135
  /**
@@ -286,12 +300,12 @@ declare const PresetColor: {
286
300
  */
287
301
  interface PresetColorOptions {
288
302
  /** Preset color value */
289
- readonly value: (typeof PresetColor)[keyof typeof PresetColor];
303
+ value: (typeof PresetColor)[keyof typeof PresetColor];
290
304
  /** Optional color transforms */
291
- readonly transforms?: ColorTransformOptions;
305
+ transforms?: ColorTransformOptions;
292
306
  }
293
307
  /**
294
- * Creates a preset color element.
308
+ * Creates a preset color element as an XML string.
295
309
  *
296
310
  * Specifies a color using a named preset (CSS named color).
297
311
  *
@@ -305,7 +319,7 @@ interface PresetColorOptions {
305
319
  * </xsd:complexType>
306
320
  * ```
307
321
  */
308
- declare const createPresetColor: (options: PresetColorOptions) => XmlComponent;
322
+ declare const createPresetColor: (options: PresetColorOptions) => string;
309
323
  //#endregion
310
324
  //#region src/drawingml/color/rgb-color.d.ts
311
325
  /**
@@ -313,12 +327,12 @@ declare const createPresetColor: (options: PresetColorOptions) => XmlComponent;
313
327
  */
314
328
  interface RgbColorOptions {
315
329
  /** Hex color value (e.g., "FF0000" for red) */
316
- readonly value: string;
330
+ value: string;
317
331
  /** Optional color transforms */
318
- readonly transforms?: ColorTransformOptions;
332
+ transforms?: ColorTransformOptions;
319
333
  }
320
334
  /**
321
- * Creates an sRGB color element.
335
+ * Creates an sRGB color element as an XML string.
322
336
  *
323
337
  * Specifies a color using RGB hex values.
324
338
  *
@@ -339,7 +353,7 @@ interface RgbColorOptions {
339
353
  * const semiRed = createRgbColor({ value: "FF0000", transforms: { alpha: 50000 } });
340
354
  * ```
341
355
  */
342
- declare const createRgbColor: (options: RgbColorOptions) => XmlComponent;
356
+ declare const createRgbColor: (options: RgbColorOptions) => string;
343
357
  //#endregion
344
358
  //#region src/drawingml/color/sc-rgb-color.d.ts
345
359
  /**
@@ -347,16 +361,16 @@ declare const createRgbColor: (options: RgbColorOptions) => XmlComponent;
347
361
  */
348
362
  interface ScRgbColorOptions {
349
363
  /** Red percentage (e.g., "50%" or "100%") */
350
- readonly r: string;
364
+ r: string;
351
365
  /** Green percentage (e.g., "50%" or "100%") */
352
- readonly g: string;
366
+ g: string;
353
367
  /** Blue percentage (e.g., "50%" or "100%") */
354
- readonly b: string;
368
+ b: string;
355
369
  /** Optional color transforms */
356
- readonly transforms?: ColorTransformOptions;
370
+ transforms?: ColorTransformOptions;
357
371
  }
358
372
  /**
359
- * Creates an scRGB color element.
373
+ * Creates an scRGB color element as an XML string.
360
374
  *
361
375
  * Specifies a color using percentage-based RGB values.
362
376
  *
@@ -379,7 +393,7 @@ interface ScRgbColorOptions {
379
393
  * const semiRed = createScRgbColor({ r: "100%", g: "0%", b: "0%", transforms: { alpha: 50000 } });
380
394
  * ```
381
395
  */
382
- declare const createScRgbColor: (options: ScRgbColorOptions) => XmlComponent;
396
+ declare const createScRgbColor: (options: ScRgbColorOptions) => string;
383
397
  //#endregion
384
398
  //#region src/drawingml/color/scheme-color.d.ts
385
399
  /**
@@ -387,9 +401,9 @@ declare const createScRgbColor: (options: ScRgbColorOptions) => XmlComponent;
387
401
  */
388
402
  interface SchemeColorOptions {
389
403
  /** Scheme color value */
390
- readonly value: (typeof SchemeColor)[keyof typeof SchemeColor];
404
+ value: (typeof SchemeColor)[keyof typeof SchemeColor];
391
405
  /** Optional color transforms */
392
- readonly transforms?: ColorTransformOptions;
406
+ transforms?: ColorTransformOptions;
393
407
  }
394
408
  /**
395
409
  * Scheme color values for theme-based colors.
@@ -416,7 +430,7 @@ declare const SchemeColor: {
416
430
  readonly PHCLR: "phClr";
417
431
  };
418
432
  /**
419
- * Creates a scheme color element.
433
+ * Creates a scheme color element as an XML string.
420
434
  *
421
435
  * Specifies a color using a theme color scheme reference.
422
436
  *
@@ -440,7 +454,7 @@ declare const SchemeColor: {
440
454
  * });
441
455
  * ```
442
456
  */
443
- declare const createSchemeColor: (options: SchemeColorOptions) => XmlComponent;
457
+ declare const createSchemeColor: (options: SchemeColorOptions) => string;
444
458
  //#endregion
445
459
  //#region src/drawingml/color/system-color.d.ts
446
460
  /**
@@ -495,14 +509,14 @@ declare const SystemColor: {
495
509
  */
496
510
  interface SystemColorOptions {
497
511
  /** System color value */
498
- readonly value: (typeof SystemColor)[keyof typeof SystemColor];
512
+ value: (typeof SystemColor)[keyof typeof SystemColor];
499
513
  /** Last known RGB color value (optional fallback) */
500
- readonly lastClr?: string;
514
+ lastClr?: string;
501
515
  /** Optional color transforms */
502
- readonly transforms?: ColorTransformOptions;
516
+ transforms?: ColorTransformOptions;
503
517
  }
504
518
  /**
505
- * Creates a system color element.
519
+ * Creates a system color element as an XML string.
506
520
  *
507
521
  * References a system-defined UI color (e.g., window background, button face).
508
522
  *
@@ -517,7 +531,7 @@ interface SystemColorOptions {
517
531
  * </xsd:complexType>
518
532
  * ```
519
533
  */
520
- declare const createSystemColor: (options: SystemColorOptions) => XmlComponent;
534
+ declare const createSystemColor: (options: SystemColorOptions) => string;
521
535
  //#endregion
522
536
  //#region src/drawingml/color/solid-fill.d.ts
523
537
  /**
@@ -527,9 +541,9 @@ declare const createSystemColor: (options: SystemColorOptions) => XmlComponent;
527
541
  * RGB, scheme, HSL, system, and preset colors.
528
542
  */
529
543
  type SolidFillOptions = ScRgbColorOptions | RgbColorOptions | SchemeColorOptions | HslColorOptions | SystemColorOptions | PresetColorOptions;
530
- declare const createColorElement: (color: SolidFillOptions) => XmlComponent;
544
+ declare const createColorElement: (color: SolidFillOptions) => string;
531
545
  /**
532
- * Creates a solid fill element.
546
+ * Creates a solid fill element as an XML string.
533
547
  *
534
548
  * Specifies a solid color fill using any supported color type.
535
549
  *
@@ -555,7 +569,7 @@ declare const createColorElement: (color: SolidFillOptions) => XmlComponent;
555
569
  * const hslFill = createSolidFill({ hue: 120000, saturation: 100000, luminance: 50000 });
556
570
  * ```
557
571
  */
558
- declare const createSolidFill: (options: SolidFillOptions) => XmlComponent;
572
+ declare const createSolidFill: (options: SolidFillOptions) => string;
559
573
  //#endregion
560
574
  //#region src/drawingml/blip/blip-effects.d.ts
561
575
  /**
@@ -569,9 +583,9 @@ declare const createSolidFill: (options: SolidFillOptions) => XmlComponent;
569
583
  */
570
584
  interface LuminanceEffectOptions$1 {
571
585
  /** Brightness adjustment in percentage points (-100 to 100). Default 0. */
572
- readonly bright?: number;
586
+ bright?: number;
573
587
  /** Contrast adjustment in percentage points (-100 to 100). Default 0. */
574
- readonly contrast?: number;
588
+ contrast?: number;
575
589
  }
576
590
  /**
577
591
  * Options for HSL effect.
@@ -585,11 +599,11 @@ interface LuminanceEffectOptions$1 {
585
599
  */
586
600
  interface HSLEffectOptions$1 {
587
601
  /** Hue rotation in 60000ths of a degree. Default 0. */
588
- readonly hue?: number;
602
+ hue?: number;
589
603
  /** Saturation adjustment in percentage points (-100 to 100). Default 0. */
590
- readonly saturation?: number;
604
+ saturation?: number;
591
605
  /** Luminance adjustment in percentage points (-100 to 100). Default 0. */
592
- readonly luminance?: number;
606
+ luminance?: number;
593
607
  }
594
608
  /**
595
609
  * Options for tint effect.
@@ -602,9 +616,9 @@ interface HSLEffectOptions$1 {
602
616
  */
603
617
  interface TintEffectOptions$1 {
604
618
  /** Hue in 60000ths of a degree. Default 0. */
605
- readonly hue?: number;
619
+ hue?: number;
606
620
  /** Amount in percentage points (0 to 100). Default 0. */
607
- readonly amount?: number;
621
+ amount?: number;
608
622
  }
609
623
  /**
610
624
  * Options for duotone effect.
@@ -616,9 +630,9 @@ interface TintEffectOptions$1 {
616
630
  */
617
631
  interface DuotoneEffectOptions$1 {
618
632
  /** First color (dark). */
619
- readonly color1: SolidFillOptions;
633
+ color1: SolidFillOptions;
620
634
  /** Second color (light). */
621
- readonly color2: SolidFillOptions;
635
+ color2: SolidFillOptions;
622
636
  }
623
637
  /**
624
638
  * Options for biLevel (black & white threshold) effect.
@@ -630,7 +644,7 @@ interface DuotoneEffectOptions$1 {
630
644
  */
631
645
  interface BiLevelEffectOptions {
632
646
  /** Threshold percentage (0 to 100). Pixels above are white, below are black. */
633
- readonly threshold: number;
647
+ threshold: number;
634
648
  }
635
649
  /**
636
650
  * Options for alpha replace effect.
@@ -642,7 +656,7 @@ interface BiLevelEffectOptions {
642
656
  */
643
657
  interface AlphaReplaceEffectOptions$1 {
644
658
  /** Alpha percentage (0 = fully transparent, 100 = fully opaque). */
645
- readonly amount: number;
659
+ amount: number;
646
660
  }
647
661
  /**
648
662
  * Options for alpha bi-level effect.
@@ -654,7 +668,7 @@ interface AlphaReplaceEffectOptions$1 {
654
668
  */
655
669
  interface AlphaBiLevelEffectOptions$1 {
656
670
  /** Threshold percentage (0 to 100). Alpha above is fully opaque, below is fully transparent. */
657
- readonly threshold: number;
671
+ threshold: number;
658
672
  }
659
673
  /**
660
674
  * Options for alpha modulate fixed effect.
@@ -666,7 +680,7 @@ interface AlphaBiLevelEffectOptions$1 {
666
680
  */
667
681
  interface AlphaModulateFixedEffectOptions$1 {
668
682
  /** Alpha amount in percentage (0 to 100). Default 100. */
669
- readonly amount?: number;
683
+ amount?: number;
670
684
  }
671
685
  /**
672
686
  * Options for color change effect.
@@ -680,11 +694,11 @@ interface AlphaModulateFixedEffectOptions$1 {
680
694
  */
681
695
  interface ColorChangeEffectOptions$1 {
682
696
  /** Source color to change from. */
683
- readonly from: SolidFillOptions;
697
+ from: SolidFillOptions;
684
698
  /** Target color to change to. */
685
- readonly to: SolidFillOptions;
699
+ to: SolidFillOptions;
686
700
  /** Whether to use alpha channel. Default true. */
687
- readonly useAlpha?: boolean;
701
+ useAlpha?: boolean;
688
702
  }
689
703
  /**
690
704
  * Options for color replace effect.
@@ -696,7 +710,7 @@ interface ColorChangeEffectOptions$1 {
696
710
  */
697
711
  interface ColorReplaceEffectOptions {
698
712
  /** Replacement color. */
699
- readonly color: SolidFillOptions;
713
+ color: SolidFillOptions;
700
714
  }
701
715
  /**
702
716
  * Options for blur effect on blip.
@@ -709,51 +723,51 @@ interface ColorReplaceEffectOptions {
709
723
  */
710
724
  interface BlipBlurEffectOptions {
711
725
  /** Blur radius in EMUs. Default 0. */
712
- readonly radius?: number;
726
+ radius?: number;
713
727
  /** Whether to grow the blur boundary. Default true. */
714
- readonly grow?: boolean;
728
+ grow?: boolean;
715
729
  }
716
730
  /**
717
731
  * All blip image adjustment effects.
718
732
  */
719
733
  interface BlipEffectsOptions {
720
734
  /** Grayscale effect (no options needed). */
721
- readonly grayscale?: boolean;
735
+ grayscale?: boolean;
722
736
  /** Luminance (brightness/contrast) effect. */
723
- readonly luminance?: LuminanceEffectOptions$1;
737
+ luminance?: LuminanceEffectOptions$1;
724
738
  /** HSL adjustment effect. */
725
- readonly hsl?: HSLEffectOptions$1;
739
+ hsl?: HSLEffectOptions$1;
726
740
  /** Tint effect. */
727
- readonly tint?: TintEffectOptions$1;
741
+ tint?: TintEffectOptions$1;
728
742
  /** Duotone effect (two-color mapping). */
729
- readonly duotone?: DuotoneEffectOptions$1;
743
+ duotone?: DuotoneEffectOptions$1;
730
744
  /** Black & white threshold effect. */
731
- readonly biLevel?: BiLevelEffectOptions;
745
+ biLevel?: BiLevelEffectOptions;
732
746
  /** Alpha ceiling effect (no options needed). */
733
- readonly alphaCeiling?: boolean;
747
+ alphaCeiling?: boolean;
734
748
  /** Alpha floor effect (no options needed). */
735
- readonly alphaFloor?: boolean;
749
+ alphaFloor?: boolean;
736
750
  /** Alpha inverse effect (with optional color). */
737
- readonly alphaInverse?: SolidFillOptions;
751
+ alphaInverse?: SolidFillOptions;
738
752
  /** Alpha modulate fixed effect. */
739
- readonly alphaModFix?: AlphaModulateFixedEffectOptions$1;
753
+ alphaModFix?: AlphaModulateFixedEffectOptions$1;
740
754
  /** Alpha replace effect. */
741
- readonly alphaRepl?: AlphaReplaceEffectOptions$1;
755
+ alphaRepl?: AlphaReplaceEffectOptions$1;
742
756
  /** Alpha bi-level effect. */
743
- readonly alphaBiLevel?: AlphaBiLevelEffectOptions$1;
757
+ alphaBiLevel?: AlphaBiLevelEffectOptions$1;
744
758
  /** Color change effect. */
745
- readonly colorChange?: ColorChangeEffectOptions$1;
759
+ colorChange?: ColorChangeEffectOptions$1;
746
760
  /** Color replace effect. */
747
- readonly colorRepl?: ColorReplaceEffectOptions;
761
+ colorRepl?: ColorReplaceEffectOptions;
748
762
  /** Blur effect on blip. */
749
- readonly blur?: BlipBlurEffectOptions;
763
+ blur?: BlipBlurEffectOptions;
750
764
  }
751
765
  /**
752
766
  * Creates blip effect elements from BlipEffectsOptions.
753
767
  *
754
- * @returns Array of XML components representing blip effects
768
+ * @returns Array of XML strings representing blip effects
755
769
  */
756
- declare const createBlipEffects: (options: BlipEffectsOptions) => XmlComponent[];
770
+ declare const createBlipEffects: (options: BlipEffectsOptions) => string[];
757
771
  //#endregion
758
772
  //#region src/drawingml/blip/source-rectangle.d.ts
759
773
  /**
@@ -764,13 +778,13 @@ declare const createBlipEffects: (options: BlipEffectsOptions) => XmlComponent[]
764
778
  */
765
779
  interface SourceRectangleOptions {
766
780
  /** Left inset percentage (0-100000) */
767
- readonly left?: number;
781
+ left?: number;
768
782
  /** Top inset percentage (0-100000) */
769
- readonly top?: number;
783
+ top?: number;
770
784
  /** Right inset percentage (0-100000) */
771
- readonly right?: number;
785
+ right?: number;
772
786
  /** Bottom inset percentage (0-100000) */
773
- readonly bottom?: number;
787
+ bottom?: number;
774
788
  }
775
789
  /**
776
790
  * Creates a source rectangle element for blip fill cropping.
@@ -796,7 +810,7 @@ interface SourceRectangleOptions {
796
810
  * createSourceRectangle({ left: 10000, right: 10000 });
797
811
  * ```
798
812
  */
799
- declare const createSourceRectangle: (options?: SourceRectangleOptions) => BuilderElement<{}>;
813
+ declare const createSourceRectangle: (options?: SourceRectangleOptions) => string;
800
814
  //#endregion
801
815
  //#region src/drawingml/blip/tile.d.ts
802
816
  /**
@@ -834,17 +848,17 @@ declare const TileAlignment: {
834
848
  */
835
849
  interface TileOptions {
836
850
  /** Horizontal offset for the tile origin (in EMUs) */
837
- readonly tx?: number;
851
+ tx?: number;
838
852
  /** Vertical offset for the tile origin (in EMUs) */
839
- readonly ty?: number;
853
+ ty?: number;
840
854
  /** Horizontal scale factor as percentage (e.g., 50 = 50%) */
841
- readonly sx?: number;
855
+ sx?: number;
842
856
  /** Vertical scale factor as percentage (e.g., 50 = 50%) */
843
- readonly sy?: number;
857
+ sy?: number;
844
858
  /** Flip mode for alternating tiles */
845
- readonly flip?: (typeof TileFlipMode$1)[keyof typeof TileFlipMode$1];
859
+ flip?: (typeof TileFlipMode$1)[keyof typeof TileFlipMode$1];
846
860
  /** Alignment of the first tile within the shape */
847
- readonly align?: (typeof TileAlignment)[keyof typeof TileAlignment];
861
+ align?: (typeof TileAlignment)[keyof typeof TileAlignment];
848
862
  }
849
863
  /**
850
864
  * Creates a tile fill mode element for blip fills.
@@ -875,7 +889,7 @@ interface TileOptions {
875
889
  * createTileInfo({ flip: "XY", align: "CENTER" });
876
890
  * ```
877
891
  */
878
- declare const createTileInfo: (options?: TileOptions) => BuilderElement<{}>;
892
+ declare const createTileInfo: (options?: TileOptions) => string;
879
893
  //#endregion
880
894
  //#region src/drawingml/fill/gradient-fill.d.ts
881
895
  /**
@@ -883,9 +897,9 @@ declare const createTileInfo: (options?: TileOptions) => BuilderElement<{}>;
883
897
  */
884
898
  interface GradientStop {
885
899
  /** Position of the color stop (0-100000) */
886
- readonly position: number;
900
+ position: number;
887
901
  /** Color at this stop */
888
- readonly color: SolidFillOptions;
902
+ color: SolidFillOptions;
889
903
  }
890
904
  /**
891
905
  * Path shade type for radial gradients.
@@ -921,9 +935,9 @@ declare const TileFlipMode: {
921
935
  */
922
936
  interface LinearShadeOptions {
923
937
  /** Angle in 60,000ths of a degree (e.g., 5400000 = 90°) */
924
- readonly angle?: number;
938
+ angle?: number;
925
939
  /** Whether the angle scales with the shape */
926
- readonly scaled?: boolean;
940
+ scaled?: boolean;
927
941
  }
928
942
  /**
929
943
  * Relative rectangle (CT_RelativeRect) with percentage offsets.
@@ -940,26 +954,26 @@ interface LinearShadeOptions {
940
954
  */
941
955
  interface RelativeRect {
942
956
  /** Left offset percentage (e.g., "0%") */
943
- readonly left?: string;
957
+ left?: string;
944
958
  /** Top offset percentage (e.g., "0%") */
945
- readonly top?: string;
959
+ top?: string;
946
960
  /** Right offset percentage (e.g., "0%") */
947
- readonly right?: string;
961
+ right?: string;
948
962
  /** Bottom offset percentage (e.g., "0%") */
949
- readonly bottom?: string;
963
+ bottom?: string;
950
964
  }
951
965
  /**
952
966
  * Options for path (radial) gradient shading.
953
967
  */
954
968
  interface PathShadeOptions {
955
969
  /** Path type */
956
- readonly path?: (typeof PathShadeType)[keyof typeof PathShadeType];
970
+ path?: (typeof PathShadeType)[keyof typeof PathShadeType];
957
971
  /**
958
972
  * Fill-to rectangle for path gradient.
959
973
  *
960
974
  * Defines the rectangle to which the gradient fills.
961
975
  */
962
- readonly fillToRect?: RelativeRect;
976
+ fillToRect?: RelativeRect;
963
977
  }
964
978
  /**
965
979
  * Gradient shade options (linear or path).
@@ -983,23 +997,23 @@ type GradientShadeOptions = LinearShadeOptions | PathShadeOptions;
983
997
  */
984
998
  interface GradientFillOptions {
985
999
  /** Gradient color stops (minimum 2) */
986
- readonly stops: readonly GradientStop[];
1000
+ stops: readonly GradientStop[];
987
1001
  /** Shade type (linear or path) */
988
- readonly shade?: GradientShadeOptions;
1002
+ shade?: GradientShadeOptions;
989
1003
  /**
990
1004
  * Tile flip mode.
991
1005
  *
992
1006
  * Controls how the gradient is flipped when tiled.
993
1007
  */
994
- readonly flip?: (typeof TileFlipMode)[keyof typeof TileFlipMode];
1008
+ flip?: (typeof TileFlipMode)[keyof typeof TileFlipMode];
995
1009
  /**
996
1010
  * Tile rectangle for gradient tiling.
997
1011
  *
998
1012
  * Defines the rectangle used for gradient tiling.
999
1013
  */
1000
- readonly tileRect?: RelativeRect;
1014
+ tileRect?: RelativeRect;
1001
1015
  /** Whether gradient rotates with the shape */
1002
- readonly rotateWithShape?: boolean;
1016
+ rotateWithShape?: boolean;
1003
1017
  }
1004
1018
  /**
1005
1019
  * Creates a gradient stop element (a:gs).
@@ -1010,7 +1024,7 @@ interface GradientFillOptions {
1010
1024
  * createGradientStop({ position: 100000, color: { value: "0000FF" } });
1011
1025
  * ```
1012
1026
  */
1013
- declare const createGradientStop: (stop: GradientStop) => XmlComponent;
1027
+ declare const createGradientStop: (stop: GradientStop) => string;
1014
1028
  /**
1015
1029
  * Creates a gradient fill element.
1016
1030
  *
@@ -1037,7 +1051,7 @@ declare const createGradientStop: (stop: GradientStop) => XmlComponent;
1037
1051
  * });
1038
1052
  * ```
1039
1053
  */
1040
- declare const createGradientFill: (options: GradientFillOptions) => XmlComponent;
1054
+ declare const createGradientFill: (options: GradientFillOptions) => string;
1041
1055
  //#endregion
1042
1056
  //#region src/drawingml/fill/fill-options.d.ts
1043
1057
  /**
@@ -1045,35 +1059,35 @@ declare const createGradientFill: (options: GradientFillOptions) => XmlComponent
1045
1059
  * Position is 0-100 (percentage), color is a hex string or SolidFillOptions.
1046
1060
  */
1047
1061
  interface GradientStopOptions {
1048
- readonly position: number;
1049
- readonly color: string | SolidFillOptions;
1062
+ position: number;
1063
+ color: string | SolidFillOptions;
1050
1064
  }
1051
1065
  /**
1052
1066
  * Blip fill options (image fill) for DrawingML shapes.
1053
1067
  */
1054
1068
  interface BlipFillConfigOptions {
1055
1069
  /** Image data (raw bytes) */
1056
- readonly data: Uint8Array | ArrayBuffer | Buffer;
1070
+ data: Uint8Array | ArrayBuffer | Buffer;
1057
1071
  /** Image type */
1058
- readonly imageType: "png" | "jpg" | "gif" | "bmp" | "tif" | "ico" | "emf" | "wmf";
1072
+ imageType: "png" | "jpg" | "gif" | "bmp" | "tif" | "ico" | "emf" | "wmf";
1059
1073
  /** DPI of the image */
1060
- readonly dpi?: number;
1074
+ dpi?: number;
1061
1075
  /** Whether the fill rotates with the shape */
1062
- readonly rotWithShape?: boolean;
1076
+ rotWithShape?: boolean;
1063
1077
  /** Image adjustment effects (brightness, contrast, grayscale, etc.) */
1064
- readonly blipEffects?: BlipEffectsOptions;
1078
+ blipEffects?: BlipEffectsOptions;
1065
1079
  /** Source rectangle for cropping */
1066
- readonly srcRect?: SourceRectangleOptions;
1080
+ srcRect?: SourceRectangleOptions;
1067
1081
  /** Tile fill mode (if omitted, defaults to stretch) */
1068
- readonly tile?: TileOptions;
1082
+ tile?: TileOptions;
1069
1083
  }
1070
1084
  /**
1071
1085
  * Media data extracted from a blip fill, for registration with the document's media store.
1072
1086
  */
1073
1087
  interface BlipFillMediaData {
1074
- readonly fileName: string;
1075
- readonly data: Uint8Array;
1076
- readonly type: string;
1088
+ fileName: string;
1089
+ data: Uint8Array;
1090
+ type: string;
1077
1091
  }
1078
1092
  /**
1079
1093
  * Fill options — discriminated union for DrawingML EG_FillProperties.
@@ -1103,28 +1117,28 @@ interface BlipFillMediaData {
1103
1117
  * fill: { type: "group" }
1104
1118
  */
1105
1119
  type FillOptions = string | {
1106
- readonly type: "solid";
1107
- readonly color: string | SolidFillOptions;
1120
+ type: "solid";
1121
+ color: string | SolidFillOptions;
1108
1122
  } | {
1109
- readonly type: "none";
1123
+ type: "none";
1110
1124
  } | {
1111
- readonly type: "gradient";
1112
- readonly angle?: number;
1113
- readonly scaled?: boolean;
1114
- readonly path?: "shape" | "circle" | "rect";
1115
- readonly stops: readonly GradientStopOptions[];
1125
+ type: "gradient";
1126
+ angle?: number;
1127
+ scaled?: boolean;
1128
+ path?: "shape" | "circle" | "rect";
1129
+ stops: readonly GradientStopOptions[];
1116
1130
  } | {
1117
- readonly type: "gradient";
1118
- readonly options: GradientFillOptions;
1131
+ type: "gradient";
1132
+ options: GradientFillOptions;
1119
1133
  } | ({
1120
- readonly type: "blip";
1134
+ type: "blip";
1121
1135
  } & BlipFillConfigOptions) | {
1122
- readonly type: "pattern";
1123
- readonly pattern: string;
1124
- readonly foregroundColor?: string | SolidFillOptions;
1125
- readonly backgroundColor?: string | SolidFillOptions;
1136
+ type: "pattern";
1137
+ pattern: string;
1138
+ foregroundColor?: string | SolidFillOptions;
1139
+ backgroundColor?: string | SolidFillOptions;
1126
1140
  } | {
1127
- readonly type: "group";
1141
+ type: "group";
1128
1142
  };
1129
1143
  /**
1130
1144
  * Extracts media data from a blip fill option, if present.
@@ -1135,9 +1149,9 @@ type FillOptions = string | {
1135
1149
  */
1136
1150
  declare const extractBlipFillMedia: (fill: FillOptions) => BlipFillMediaData | undefined;
1137
1151
  /**
1138
- * Builds a DrawingML fill XmlComponent from a FillOptions config.
1152
+ * Builds a DrawingML fill XML string from a FillOptions config.
1139
1153
  */
1140
- declare const buildFill: (options: FillOptions) => XmlComponent;
1154
+ declare const buildFill: (options: FillOptions) => string;
1141
1155
  //#endregion
1142
1156
  //#region src/drawingml/fill/no-fill.d.ts
1143
1157
  /**
@@ -1155,7 +1169,7 @@ declare const buildFill: (options: FillOptions) => XmlComponent;
1155
1169
  * const noFill = createNoFill();
1156
1170
  * ```
1157
1171
  */
1158
- declare const createNoFill: () => XmlComponent;
1172
+ declare const createNoFill: () => string;
1159
1173
  //#endregion
1160
1174
  //#region src/drawingml/fill/pattern-fill.d.ts
1161
1175
  /**
@@ -1244,11 +1258,11 @@ declare const PresetPattern: {
1244
1258
  */
1245
1259
  interface PatternFillOptions {
1246
1260
  /** Preset pattern type */
1247
- readonly pattern: (typeof PresetPattern)[keyof typeof PresetPattern];
1261
+ pattern: (typeof PresetPattern)[keyof typeof PresetPattern];
1248
1262
  /** Foreground color */
1249
- readonly foregroundColor?: SolidFillOptions;
1263
+ foregroundColor?: SolidFillOptions;
1250
1264
  /** Background color */
1251
- readonly backgroundColor?: SolidFillOptions;
1265
+ backgroundColor?: SolidFillOptions;
1252
1266
  }
1253
1267
  /**
1254
1268
  * Creates a pattern fill element (a:pattFill).
@@ -1284,7 +1298,7 @@ interface PatternFillOptions {
1284
1298
  * });
1285
1299
  * ```
1286
1300
  */
1287
- declare const createPatternFill: (options: PatternFillOptions) => XmlComponent;
1301
+ declare const createPatternFill: (options: PatternFillOptions) => string;
1288
1302
  //#endregion
1289
1303
  //#region src/drawingml/fill/group-fill.d.ts
1290
1304
  /**
@@ -1305,7 +1319,684 @@ declare const createPatternFill: (options: PatternFillOptions) => XmlComponent;
1305
1319
  * createGroupFill();
1306
1320
  * ```
1307
1321
  */
1308
- declare const createGroupFill: () => XmlComponent;
1322
+ declare const createGroupFill: () => string;
1323
+ //#endregion
1324
+ //#region src/opc/app-properties.d.ts
1325
+ /** Static app properties XML constant. */
1326
+ declare const APP_PROPS_XML = "<Properties xmlns=\"http://schemas.openxmlformats.org/officeDocument/2006/extended-properties\" xmlns:vt=\"http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes\"><Application>Microsoft Office Word</Application></Properties>";
1327
+ //#endregion
1328
+ //#region src/opc/relationships.d.ts
1329
+ type RelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" | "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramData" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramLayout" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramQuickStyle" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramColors" | "http://schemas.microsoft.com/office/2007/relationships/diagramLayout" | "http://schemas.microsoft.com/office/2007/relationships/diagramStyle" | "http://schemas.microsoft.com/office/2007/relationships/diagramColors" | "http://schemas.microsoft.com/office/2007/relationships/diagramDrawing" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/custom-properties" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/bibliography" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/glossaryDocument" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/aFChunk" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/subDocument" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/presProps" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/viewProps" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/tableStyles" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/handoutMaster" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideSyncProperties" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/commentAuthors" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/video" | "http://schemas.microsoft.com/office/2007/relationships/media" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartsheet" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/calcChain" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheRecords" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/table" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLink" | "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLinkPath";
1330
+ declare const TargetModeType: {
1331
+ readonly EXTERNAL: "External";
1332
+ };
1333
+ /**
1334
+ * Manages OOXML relationship entries and serializes to XML.
1335
+ *
1336
+ * Standalone class — no XmlComponent inheritance.
1337
+ * Pure string concatenation for zero-allocation XML output.
1338
+ */
1339
+ declare class Relationships {
1340
+ private entries;
1341
+ addRelationship(id: number | string, type: RelationshipType, target: string, targetMode?: (typeof TargetModeType)[keyof typeof TargetModeType]): void;
1342
+ get relationshipCount(): number;
1343
+ /** Directly builds XML string — zero intermediate tree allocation. */
1344
+ serialize(): string;
1345
+ }
1346
+ //#endregion
1347
+ //#region src/opc/content-types.d.ts
1348
+ /**
1349
+ * Content Types components for OPC (Open Packaging Convention).
1350
+ *
1351
+ * Provides Default and Override elements used in [Content_Types].xml
1352
+ * to map file extensions and part paths to MIME content types.
1353
+ *
1354
+ * Reference: ECMA-376 Part 2, Section 10.1
1355
+ *
1356
+ * @module
1357
+ */
1358
+ interface DefaultAttributes {
1359
+ readonly contentType: string;
1360
+ readonly extension?: string;
1361
+ }
1362
+ /**
1363
+ * Creates a Default element mapping a file extension to a MIME content type.
1364
+ */
1365
+ declare const createDefault: (contentType: string, extension?: string) => string;
1366
+ interface OverrideAttributes {
1367
+ readonly contentType: string;
1368
+ readonly partName?: string;
1369
+ }
1370
+ /**
1371
+ * Creates an Override element mapping a specific part path to a MIME content type.
1372
+ */
1373
+ declare const createOverride: (contentType: string, partName?: string) => string;
1374
+ //#endregion
1375
+ //#region src/opc/core.d.ts
1376
+ type IXmlableObject = Readonly<Record<string, unknown>>;
1377
+ interface CoreProperties {
1378
+ title?: string;
1379
+ subject?: string;
1380
+ creator?: string;
1381
+ keywords?: string;
1382
+ description?: string;
1383
+ lastModifiedBy?: string;
1384
+ revision?: string;
1385
+ created?: string;
1386
+ modified?: string;
1387
+ }
1388
+ /**
1389
+ * Parse core properties from an already-parsed XML element.
1390
+ * Shared by docx and pptx to extract Dublin Core metadata.
1391
+ */
1392
+ declare function parseCorePropsElement(el: Element | undefined): CoreProperties;
1393
+ /**
1394
+ * Build a cp:coreProperties XML object from metadata.
1395
+ *
1396
+ * Shared by docx and pptx to avoid duplicating namespace declarations
1397
+ * and Dublin Core property construction.
1398
+ */
1399
+ declare function buildCorePropertiesXml(opts: {
1400
+ readonly title?: string;
1401
+ readonly subject?: string;
1402
+ readonly creator?: string;
1403
+ readonly keywords?: string;
1404
+ readonly description?: string;
1405
+ readonly lastModifiedBy?: string;
1406
+ readonly revision?: number;
1407
+ }): IXmlableObject;
1408
+ /**
1409
+ * Build a cp:coreProperties XML string directly (fast path).
1410
+ *
1411
+ * Shared by pptx and xlsx to bypass the toXml() → xml() pipeline.
1412
+ */
1413
+ declare function buildCorePropertiesXmlString(opts: {
1414
+ readonly title?: string;
1415
+ readonly subject?: string;
1416
+ readonly creator?: string;
1417
+ readonly keywords?: string;
1418
+ readonly description?: string;
1419
+ readonly lastModifiedBy?: string;
1420
+ readonly revision?: number;
1421
+ }): string;
1422
+ //#endregion
1423
+ //#region src/opc/output.d.ts
1424
+ /**
1425
+ * Output type definitions for OOXML document export.
1426
+ *
1427
+ * @module
1428
+ */
1429
+ interface OutputByType {
1430
+ readonly base64: string;
1431
+ readonly string: string;
1432
+ readonly text: string;
1433
+ readonly binarystring: string;
1434
+ readonly array: readonly number[];
1435
+ readonly uint8array: Uint8Array;
1436
+ readonly arraybuffer: ArrayBuffer;
1437
+ readonly blob: Blob;
1438
+ readonly nodebuffer: Buffer;
1439
+ }
1440
+ type OutputType = keyof OutputByType;
1441
+ declare const OoxmlMimeType: {
1442
+ readonly DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
1443
+ readonly PPTX: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
1444
+ readonly XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
1445
+ };
1446
+ declare const convertOutput: <T extends OutputType>(data: Uint8Array, type: T, mimeType?: string) => OutputByType[T];
1447
+ //#endregion
1448
+ //#region src/opc/packer.d.ts
1449
+ interface XmlifyedFile {
1450
+ path: string;
1451
+ data: string | Uint8Array;
1452
+ }
1453
+ /** Default DEFLATE level for XML entries (SuperFast, matching MS Office). */
1454
+ declare const ZIP_DEFLATE_LEVEL = 1;
1455
+ /** Default level for media entries (STORE — no compression). */
1456
+ declare const ZIP_STORED_LEVEL = 0;
1457
+ /** Compression options for ZIP output (zlib levels 0-9, matching fflate). */
1458
+ interface CompressionOptions {
1459
+ /** DEFLATE level for XML files. Default: 1 (SuperFast, matching MS Office). */
1460
+ xml?: number;
1461
+ /** DEFLATE level for media files. Default: 0 (STORE, no compression). */
1462
+ media?: number;
1463
+ }
1464
+ /** Options for Packer output methods. */
1465
+ interface PackerOptions<T extends OutputType = "nodebuffer"> {
1466
+ /** Output format. Defaults to `"nodebuffer"` (Node.js Buffer). */
1467
+ type?: T;
1468
+ /** Custom XML/ZIP file overrides. */
1469
+ overrides?: XmlifyedFile[];
1470
+ /** Compression levels for ZIP entries. */
1471
+ compression?: CompressionOptions;
1472
+ }
1473
+ /**
1474
+ * Asynchronously compress files and convert to the requested output format.
1475
+ *
1476
+ * Uses fflate Web Workers for non-blocking DEFLATE compression.
1477
+ * XML entries use DEFLATE by default; media entries should explicitly set
1478
+ * `{ level: ZIP_STORED_LEVEL }` to avoid redundant compression.
1479
+ */
1480
+ declare const zipAndConvert: <T extends OutputType>(files: Zippable, type: T, mimeType: string, level?: number) => Promise<OutputByType[T]>;
1481
+ /**
1482
+ * Synchronously compress files and convert to the requested output format.
1483
+ *
1484
+ * Uses synchronous DEFLATE compression for maximum throughput.
1485
+ * Blocks the event loop — prefer {@link zipAndConvert} in server contexts.
1486
+ */
1487
+ declare const zipSyncAndConvert: <T extends OutputType>(files: Zippable, type: T, mimeType: string, level?: number) => OutputByType[T];
1488
+ /**
1489
+ * Create a `ReadableStream<Uint8Array>` from compressed file entries.
1490
+ *
1491
+ * Uses fflate's `AsyncZipDeflate` for non-blocking DEFLATE compression.
1492
+ * `STORED` entries (media) pass through synchronously.
1493
+ * Works in both Node.js and browsers (Web Streams API).
1494
+ */
1495
+ declare const createZipStream: (files: Zippable, defaultLevel?: number) => ReadableStream<Uint8Array>;
1496
+ /**
1497
+ * Compile function provided by each package to convert a file object into a Zippable map.
1498
+ */
1499
+ type CompileFn<TFile> = (file: TFile, overrides?: XmlifyedFile[], mediaLevel?: number) => Zippable;
1500
+ /**
1501
+ * Packer interface returned by {@link createPacker}.
1502
+ *
1503
+ * Async methods use fflate Web Workers for non-blocking compression.
1504
+ * Sync methods use synchronous compression for maximum throughput in
1505
+ * CLI scripts and build tools.
1506
+ */
1507
+ interface Packer<TFile> {
1508
+ /** Compile file to Zippable map (synchronous). */
1509
+ compile: CompileFn<TFile>;
1510
+ /** Generic async output — returns the requested OutputType. */
1511
+ pack<T extends OutputType = "nodebuffer">(file: TFile, options?: PackerOptions<T>): Promise<OutputByType[T]>;
1512
+ /** Generic sync output — returns the requested OutputType. */
1513
+ packSync<T extends OutputType = "nodebuffer">(file: TFile, options?: PackerOptions<T>): OutputByType[T];
1514
+ /** Async → `Promise<Uint8Array>` (like `Response.bytes()`). */
1515
+ toBytes(file: TFile, options?: PackerOptions): Promise<Uint8Array>;
1516
+ /** Sync → `Uint8Array`. */
1517
+ toBytesSync(file: TFile, options?: PackerOptions): Uint8Array;
1518
+ /** Async → `Promise<string>` (raw ZIP content as string). */
1519
+ toString(file: TFile, options?: PackerOptions): Promise<string>;
1520
+ /** Sync → `string`. */
1521
+ toStringSync(file: TFile, options?: PackerOptions): string;
1522
+ /** Async → `Promise<Buffer>` (Node.js). */
1523
+ toBuffer(file: TFile, options?: PackerOptions): Promise<Buffer>;
1524
+ /** Sync → `Buffer` (Node.js). */
1525
+ toBufferSync(file: TFile, options?: PackerOptions): Buffer;
1526
+ /** Async → `Promise<string>` (base64-encoded). */
1527
+ toBase64String(file: TFile, options?: PackerOptions): Promise<string>;
1528
+ /** Sync → `string` (base64-encoded). */
1529
+ toBase64StringSync(file: TFile, options?: PackerOptions): string;
1530
+ /** Async → `Promise<Blob>` (browser). */
1531
+ toBlob(file: TFile, options?: PackerOptions): Promise<Blob>;
1532
+ /** Sync → `Blob`. */
1533
+ toBlobSync(file: TFile, options?: PackerOptions): Blob;
1534
+ /** Async → `Promise<ArrayBuffer>`. */
1535
+ toArrayBuffer(file: TFile, options?: PackerOptions): Promise<ArrayBuffer>;
1536
+ /** Sync → `ArrayBuffer`. */
1537
+ toArrayBufferSync(file: TFile, options?: PackerOptions): ArrayBuffer;
1538
+ /** Streaming output via `ReadableStream<Uint8Array>` (cross-platform, uses Web Workers). */
1539
+ toStream(file: TFile, options?: PackerOptions): ReadableStream<Uint8Array>;
1540
+ }
1541
+ /**
1542
+ * Create a Packer object with all output format methods.
1543
+ *
1544
+ * Centralises the ZIP → convert pipeline and the streaming implementation
1545
+ * so that each OOXML package only needs to provide a `compile` function and
1546
+ * a MIME type.
1547
+ */
1548
+ declare const createPacker: <TFile>(options: {
1549
+ readonly compile: CompileFn<TFile>;
1550
+ readonly mimeType: string;
1551
+ }) => Packer<TFile>;
1552
+ //#endregion
1553
+ //#region src/opc/parser.d.ts
1554
+ /**
1555
+ * Parsed OOXML archive backed by an unzipped ZIP map.
1556
+ *
1557
+ * Provides unstorage-style API (get/set/getRaw/setRaw/remove/has/keys)
1558
+ * for reading and modifying individual parts, then serializing back to a ZIP buffer.
1559
+ */
1560
+ declare class ParsedArchive {
1561
+ private readonly zip;
1562
+ private readonly modified;
1563
+ private readonly wrapperCache;
1564
+ constructor(data: Uint8Array);
1565
+ /** Read an XML part as an Element tree. */
1566
+ get(path: string): Element | undefined;
1567
+ /** Write an XML part (Element → XML string). */
1568
+ set(path: string, element: Element): void;
1569
+ /** Read raw binary data (images, media, etc.). */
1570
+ getRaw(path: string): Uint8Array | undefined;
1571
+ /** Write raw binary data. */
1572
+ setRaw(path: string, data: Uint8Array): void;
1573
+ /** Remove a part. Returns true if it existed. */
1574
+ remove(path: string): boolean;
1575
+ /** Check if a part exists. */
1576
+ has(path: string): boolean;
1577
+ /** List all paths matching an optional prefix. */
1578
+ keys(prefix?: string): string[];
1579
+ /** Serialize back to a ZIP buffer, merging original zip + modifications. */
1580
+ save(): Uint8Array;
1581
+ }
1582
+ /** Parse an OOXML archive (.docx, .pptx, .xlsx) into a ParsedArchive. */
1583
+ declare function parseArchive(data: Uint8Array): ParsedArchive;
1584
+ //#endregion
1585
+ //#region src/util/compile.d.ts
1586
+ /**
1587
+ * Convert a mapping of XML files + overrides + media into a Zippable structure.
1588
+ *
1589
+ * Centralises the mapping→Zippable conversion shared by all three compilers.
1590
+ */
1591
+ declare function compileMapping(mapping: Record<string, {
1592
+ data: string;
1593
+ path: string;
1594
+ }>, overrides?: XmlifyedFile[], media?: {
1595
+ data: Uint8Array;
1596
+ path: string;
1597
+ }[], mediaLevel?: number): Zippable$1;
1598
+ //#endregion
1599
+ //#region src/util/converters.d.ts
1600
+ /**
1601
+ * OOXML unit conversion utilities.
1602
+ *
1603
+ * @module
1604
+ */
1605
+ /**
1606
+ * Converts millimeters to TWIP (twentieths of a point).
1607
+ */
1608
+ declare const convertMillimetersToTwip: (millimeters: number) => number;
1609
+ /**
1610
+ * Converts inches to TWIP (twentieths of a point).
1611
+ */
1612
+ declare const convertInchesToTwip: (inches: number) => number;
1613
+ /**
1614
+ * Converts pixels to EMU (96 DPI).
1615
+ */
1616
+ declare const convertPixelsToEmu: (pixels: number) => number;
1617
+ /**
1618
+ * Converts EMU to pixels (96 DPI).
1619
+ */
1620
+ declare const convertEmuToPixels: (emus: number) => number;
1621
+ /**
1622
+ * Converts inches to EMU.
1623
+ */
1624
+ declare const convertInchesToEmu: (inches: number) => number;
1625
+ /**
1626
+ * Converts EMU to inches.
1627
+ */
1628
+ declare const convertEmuToInches: (emus: number) => number;
1629
+ /**
1630
+ * Converts points to EMU.
1631
+ */
1632
+ declare const convertPointsToEmu: (points: number) => number;
1633
+ /**
1634
+ * Converts EMU to points.
1635
+ */
1636
+ declare const convertEmuToPoints: (emus: number) => number;
1637
+ /** A rectangular position in pixels. */
1638
+ interface PixelPosition {
1639
+ readonly x: number;
1640
+ readonly y: number;
1641
+ readonly width: number;
1642
+ readonly height: number;
1643
+ }
1644
+ /** An EMU-based rectangular position. */
1645
+ interface EmuPosition {
1646
+ readonly x: number;
1647
+ readonly y: number;
1648
+ readonly cx: number;
1649
+ readonly cy: number;
1650
+ }
1651
+ /**
1652
+ * Converts a pixel-based position to EMU coordinates.
1653
+ */
1654
+ declare const convertPositionToEmu: (pos: PixelPosition) => EmuPosition;
1655
+ /** Parsed result of a UniversalMeasure string. */
1656
+ interface ParsedMeasure {
1657
+ value: number;
1658
+ unit: "mm" | "cm" | "in" | "pt" | "pc" | "pi";
1659
+ }
1660
+ /**
1661
+ * Parse a UniversalMeasure string into its numeric value and unit.
1662
+ *
1663
+ * @param measure - A universal measure string like "2.54cm", "-10mm", "1in"
1664
+ * @returns The parsed value and unit
1665
+ * @throws Error if the format is invalid
1666
+ *
1667
+ * @example
1668
+ * ```typescript
1669
+ * parseUniversalMeasure("2.54cm"); // { value: 2.54, unit: "cm" }
1670
+ * parseUniversalMeasure("-10mm"); // { value: -10, unit: "mm" }
1671
+ * ```
1672
+ */
1673
+ declare const parseUniversalMeasure: (measure: string) => ParsedMeasure;
1674
+ /**
1675
+ * Converts a UniversalMeasure string to TWIP (twentieths of a point).
1676
+ *
1677
+ * Supports units: mm, cm, in, pt, pc (picas, 1pc = 12pt), pi (alias for pc).
1678
+ *
1679
+ * @param measure - A universal measure string like "2.54cm", "1in", "12pt"
1680
+ * @returns The value in TWIP
1681
+ *
1682
+ * @example
1683
+ * ```typescript
1684
+ * convertUniversalMeasureToTwip("1in"); // 1440
1685
+ * convertUniversalMeasureToTwip("2.54cm"); // ~1440 (1 inch)
1686
+ * convertUniversalMeasureToTwip("72pt"); // 1440 (1 inch = 72pt = 1440 twips)
1687
+ * ```
1688
+ */
1689
+ declare const convertUniversalMeasureToTwip: (measure: string) => number;
1690
+ /**
1691
+ * Converts a measurement value (number or UniversalMeasure) to TWIP.
1692
+ *
1693
+ * If the value is already a number, it is returned as-is (assumed to be in twips).
1694
+ * If the value is a UniversalMeasure string, it is converted to twips.
1695
+ *
1696
+ * Useful for accepting both `number` and `UniversalMeasure` inputs where
1697
+ * the XSD type is a union (e.g., ST_TwipsMeasure, ST_SignedTwipsMeasure).
1698
+ *
1699
+ * @param val - A numeric twip value or a universal measure string
1700
+ * @returns The value in TWIP
1701
+ *
1702
+ * @example
1703
+ * ```typescript
1704
+ * convertToTwip(1440); // 1440 (already twips)
1705
+ * convertToTwip("1in"); // 1440
1706
+ * convertToTwip("2.54cm"); // ~1440
1707
+ * ```
1708
+ */
1709
+ declare const convertToTwip: (val: number | string) => number;
1710
+ /**
1711
+ * Converts a UniversalMeasure string to EMU (English Metric Units).
1712
+ *
1713
+ * Supports units: mm, cm, in, pt, pc (picas, 1pc = 12pt), pi (alias for pc).
1714
+ *
1715
+ * @param measure - A universal measure string like "2.54cm", "1in", "12pt"
1716
+ * @returns The value in EMU
1717
+ *
1718
+ * @example
1719
+ * ```typescript
1720
+ * convertUniversalMeasureToEmu("1in"); // 914400
1721
+ * convertUniversalMeasureToEmu("2.54cm"); // 914400
1722
+ * convertUniversalMeasureToEmu("12pt"); // 152400
1723
+ * ```
1724
+ */
1725
+ declare const convertUniversalMeasureToEmu: (measure: string) => number;
1726
+ /**
1727
+ * Converts a measurement value (number or UniversalMeasure) to EMU.
1728
+ *
1729
+ * If the value is already a number, it is returned as-is (assumed to be in EMU).
1730
+ * If the value is a UniversalMeasure string, it is converted to EMU.
1731
+ *
1732
+ * Useful for accepting both `number` and `UniversalMeasure` inputs in DrawingML
1733
+ * where the XSD type is a union (e.g., ST_Coordinate).
1734
+ *
1735
+ * @param val - A numeric EMU value or a universal measure string
1736
+ * @returns The value in EMU
1737
+ *
1738
+ * @example
1739
+ * ```typescript
1740
+ * convertToEmu(914400); // 914400 (already EMU)
1741
+ * convertToEmu("1in"); // 914400
1742
+ * convertToEmu("2.54cm"); // 914400
1743
+ * ```
1744
+ */
1745
+ declare const convertToEmu: (val: number | string) => number;
1746
+ //#endregion
1747
+ //#region src/util/crypto.d.ts
1748
+ /**
1749
+ * Password hashing utilities for OOXML document protection.
1750
+ *
1751
+ * Implements ECMA-376 Agile Encryption password derivation.
1752
+ * Passwords are encoded as UTF-16LE per the OOXML specification.
1753
+ *
1754
+ * @module
1755
+ */
1756
+ /**
1757
+ * Generates cryptographically secure random bytes.
1758
+ */
1759
+ declare function randomBytes(length: number): Uint8Array;
1760
+ /**
1761
+ * Computes the ECMA-376 Agile Encryption hash for a password.
1762
+ *
1763
+ * Algorithm: SHA-512(salt + UTF-16LE(password)), then iterate SHA-512(hash + i.toUint32LE()) spinCount times.
1764
+ */
1765
+ declare function hashPasswordAgile(password: string, salt: Uint8Array, spinCount: number): string;
1766
+ /**
1767
+ * Derives a password hash for OOXML document protection.
1768
+ *
1769
+ * Returns base64-encoded hashValue, saltValue, spinCount, and algorithmName
1770
+ * suitable for direct use in document protection options.
1771
+ */
1772
+ declare function derivePasswordHash(password: string, spinCount?: number): {
1773
+ hashValue: string;
1774
+ saltValue: string;
1775
+ spinCount: number;
1776
+ algorithmName: string;
1777
+ };
1778
+ //#endregion
1779
+ //#region src/util/generators.d.ts
1780
+ /**
1781
+ * A function that generates unique sequential numeric IDs.
1782
+ */
1783
+ type UniqueNumericIdCreator = () => number;
1784
+ /**
1785
+ * Creates a unique numeric ID generator with sequential numbering.
1786
+ */
1787
+ declare const uniqueNumericIdCreator: (initial?: number) => UniqueNumericIdCreator;
1788
+ /**
1789
+ * Generates a unique lowercase alphanumeric ID using nanoid.
1790
+ */
1791
+ declare const uniqueId: () => string;
1792
+ /**
1793
+ * Generates a SHA-1 hash of the provided data.
1794
+ */
1795
+ declare const hashedId: (data: Buffer | string | Uint8Array | ArrayBuffer) => string;
1796
+ /**
1797
+ * Generates a UUID v4-style unique identifier.
1798
+ */
1799
+ declare const uniqueUuid: () => string;
1800
+ //#endregion
1801
+ //#region src/util/mappings.d.ts
1802
+ /**
1803
+ * Bidirectional mappings between user-friendly values and XSD abbreviated values.
1804
+ *
1805
+ * When XSD uses full English words (e.g. "center", "start"), values are used directly — no mapping needed.
1806
+ * When XSD uses abbreviations (e.g. "ctr", "l", "rnd"), this module maps them to full words.
1807
+ *
1808
+ * Usage in generation (Options → XML): xsdAlign.to("center") → "ctr"
1809
+ * Usage in parsing (XML → Options): xsdAlign.from("ctr") → "center"
1810
+ */
1811
+ /** Invert a Record<K, V> into Record<V, K>. */
1812
+ declare function invertMap<K extends string, V extends string>(map: Record<K, V>): Record<V, K>;
1813
+ declare const xsdRectAlignment: {
1814
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1815
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1816
+ forward: Record<"topLeft" | "top" | "topRight" | "left" | "center" | "right" | "bottomLeft" | "bottom" | "bottomRight", "b" | "ctr" | "l" | "r" | "t" | "tl" | "tr" | "bl" | "br">; /** The reverse map (XSD → user) */
1817
+ reverse: Record<"b" | "ctr" | "l" | "r" | "t" | "tl" | "tr" | "bl" | "br", "topLeft" | "top" | "topRight" | "left" | "center" | "right" | "bottomLeft" | "bottom" | "bottomRight">;
1818
+ };
1819
+ declare const xsdTextAlign: {
1820
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1821
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1822
+ forward: Record<"left" | "center" | "right" | "justify", "ctr" | "l" | "r" | "just">; /** The reverse map (XSD → user) */
1823
+ reverse: Record<"ctr" | "l" | "r" | "just", "left" | "center" | "right" | "justify">;
1824
+ };
1825
+ declare const xsdTextAnchor: {
1826
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1827
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1828
+ forward: Record<"top" | "center" | "bottom" | "justify" | "distribute", "b" | "ctr" | "t" | "just" | "dist">; /** The reverse map (XSD → user) */
1829
+ reverse: Record<"b" | "ctr" | "t" | "just" | "dist", "top" | "center" | "bottom" | "justify" | "distribute">;
1830
+ };
1831
+ declare const xsdLineCap: {
1832
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1833
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1834
+ forward: Record<"round" | "square" | "flat", "rnd" | "sq" | "flat">; /** The reverse map (XSD → user) */
1835
+ reverse: Record<"rnd" | "sq" | "flat", "round" | "square" | "flat">;
1836
+ };
1837
+ declare const xsdCompoundLine: {
1838
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1839
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1840
+ forward: Record<"single" | "double" | "thickThin" | "thinThick" | "triple", "sng" | "dbl" | "thickThin" | "thinThick" | "tri">; /** The reverse map (XSD → user) */
1841
+ reverse: Record<"sng" | "dbl" | "thickThin" | "thinThick" | "tri", "single" | "double" | "thickThin" | "thinThick" | "triple">;
1842
+ };
1843
+ declare const xsdPenAlignment: {
1844
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1845
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1846
+ forward: Record<"center" | "inside", "in" | "ctr">; /** The reverse map (XSD → user) */
1847
+ reverse: Record<"in" | "ctr", "center" | "inside">;
1848
+ };
1849
+ declare const xsdLineEndSize: {
1850
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1851
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1852
+ forward: Record<"small" | "medium" | "large", "sm" | "med" | "lg">; /** The reverse map (XSD → user) */
1853
+ reverse: Record<"sm" | "med" | "lg", "small" | "medium" | "large">;
1854
+ };
1855
+ declare const xsdBlendMode: {
1856
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1857
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1858
+ forward: Record<"over" | "multiply" | "screen" | "darken" | "lighten", "over" | "mult" | "screen" | "darken" | "lighten">; /** The reverse map (XSD → user) */
1859
+ reverse: Record<"over" | "mult" | "screen" | "darken" | "lighten", "over" | "multiply" | "screen" | "darken" | "lighten">;
1860
+ };
1861
+ declare const xsdPathFillMode: {
1862
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1863
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1864
+ forward: Record<"none" | "darken" | "lighten" | "normal" | "lightenLess" | "darkenLess", "none" | "darken" | "lighten" | "norm" | "lightenLess" | "darkenLess">; /** The reverse map (XSD → user) */
1865
+ reverse: Record<"none" | "darken" | "lighten" | "norm" | "lightenLess" | "darkenLess", "none" | "darken" | "lighten" | "normal" | "lightenLess" | "darkenLess">;
1866
+ };
1867
+ declare const xsdEffectContainer: {
1868
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1869
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1870
+ forward: Record<"sibling" | "tree", "sib" | "tree">; /** The reverse map (XSD → user) */
1871
+ reverse: Record<"sib" | "tree", "sibling" | "tree">;
1872
+ };
1873
+ declare const xsdPresetShadow: {
1874
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1875
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1876
+ forward: Record<"shadow1" | "shadow2" | "shadow3" | "shadow4" | "shadow5" | "shadow6" | "shadow7" | "shadow8" | "shadow9" | "shadow10" | "shadow11" | "shadow12" | "shadow13" | "shadow14" | "shadow15" | "shadow16" | "shadow17" | "shadow18" | "shadow19" | "shadow20", "shdw1" | "shdw2" | "shdw3" | "shdw4" | "shdw5" | "shdw6" | "shdw7" | "shdw8" | "shdw9" | "shdw10" | "shdw11" | "shdw12" | "shdw13" | "shdw14" | "shdw15" | "shdw16" | "shdw17" | "shdw18" | "shdw19" | "shdw20">; /** The reverse map (XSD → user) */
1877
+ reverse: Record<"shdw1" | "shdw2" | "shdw3" | "shdw4" | "shdw5" | "shdw6" | "shdw7" | "shdw8" | "shdw9" | "shdw10" | "shdw11" | "shdw12" | "shdw13" | "shdw14" | "shdw15" | "shdw16" | "shdw17" | "shdw18" | "shdw19" | "shdw20", "shadow1" | "shadow2" | "shadow3" | "shadow4" | "shadow5" | "shadow6" | "shadow7" | "shadow8" | "shadow9" | "shadow10" | "shadow11" | "shadow12" | "shadow13" | "shadow14" | "shadow15" | "shadow16" | "shadow17" | "shadow18" | "shadow19" | "shadow20">;
1878
+ };
1879
+ declare const xsdMaterialType: {
1880
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1881
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1882
+ forward: Record<"flat" | "legacyMatte" | "legacyPlastic" | "legacyMetal" | "legacyWireframe" | "matte" | "plastic" | "metal" | "warmMatte" | "translucentPowder" | "powder" | "darkEdge" | "softEdge" | "clear" | "softMetal", "flat" | "legacyMatte" | "legacyPlastic" | "legacyMetal" | "legacyWireframe" | "matte" | "plastic" | "metal" | "warmMatte" | "translucentPowder" | "powder" | "dkEdge" | "softEdge" | "clear" | "softmetal">; /** The reverse map (XSD → user) */
1883
+ reverse: Record<"flat" | "legacyMatte" | "legacyPlastic" | "legacyMetal" | "legacyWireframe" | "matte" | "plastic" | "metal" | "warmMatte" | "translucentPowder" | "powder" | "dkEdge" | "softEdge" | "clear" | "softmetal", "flat" | "legacyMatte" | "legacyPlastic" | "legacyMetal" | "legacyWireframe" | "matte" | "plastic" | "metal" | "warmMatte" | "translucentPowder" | "powder" | "darkEdge" | "softEdge" | "clear" | "softMetal">;
1884
+ };
1885
+ declare const xsdPattern: {
1886
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1887
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1888
+ forward: Record<"percent5" | "percent10" | "percent20" | "percent25" | "percent30" | "percent40" | "percent50" | "percent60" | "percent70" | "percent75" | "percent80" | "percent90" | "horizontal" | "vertical" | "lightHorizontal" | "lightVertical" | "darkHorizontal" | "darkVertical" | "narrowHorizontal" | "narrowVertical" | "dashedHorizontal" | "dashedVertical" | "cross" | "downDiagonal" | "upDiagonal" | "lightDownDiagonal" | "lightUpDiagonal" | "darkDownDiagonal" | "darkUpDiagonal" | "wideDownDiagonal" | "wideUpDiagonal" | "dashedDownDiagonal" | "dashedUpDiagonal" | "diagonalCross" | "smallChecker" | "largeChecker" | "smallGrid" | "largeGrid" | "dotGrid" | "smallConfetti" | "largeConfetti" | "horizontalBrick" | "diagonalBrick" | "solidDiamond" | "openDiamond" | "dottedDiamond" | "plaid" | "sphere" | "weave" | "divot" | "shingle" | "wave" | "trellis" | "zigZag", "pct5" | "pct10" | "pct20" | "pct25" | "pct30" | "pct40" | "pct50" | "pct60" | "pct70" | "pct75" | "pct80" | "pct90" | "horz" | "vert" | "ltHorz" | "ltVert" | "dkHorz" | "dkVert" | "narHorz" | "narVert" | "dashHorz" | "dashVert" | "cross" | "dnDiag" | "upDiag" | "ltDnDiag" | "ltUpDiag" | "dkDnDiag" | "dkUpDiag" | "wdDnDiag" | "wdUpDiag" | "dashDnDiag" | "dashUpDiag" | "diagCross" | "smCheck" | "lgCheck" | "smGrid" | "lgGrid" | "dotGrid" | "smConfetti" | "lgConfetti" | "horzBrick" | "diagBrick" | "solidDmnd" | "openDmnd" | "dotDmnd" | "plaid" | "sphere" | "weave" | "divot" | "shingle" | "wave" | "trellis" | "zigZag">; /** The reverse map (XSD → user) */
1889
+ reverse: Record<"pct5" | "pct10" | "pct20" | "pct25" | "pct30" | "pct40" | "pct50" | "pct60" | "pct70" | "pct75" | "pct80" | "pct90" | "horz" | "vert" | "ltHorz" | "ltVert" | "dkHorz" | "dkVert" | "narHorz" | "narVert" | "dashHorz" | "dashVert" | "cross" | "dnDiag" | "upDiag" | "ltDnDiag" | "ltUpDiag" | "dkDnDiag" | "dkUpDiag" | "wdDnDiag" | "wdUpDiag" | "dashDnDiag" | "dashUpDiag" | "diagCross" | "smCheck" | "lgCheck" | "smGrid" | "lgGrid" | "dotGrid" | "smConfetti" | "lgConfetti" | "horzBrick" | "diagBrick" | "solidDmnd" | "openDmnd" | "dotDmnd" | "plaid" | "sphere" | "weave" | "divot" | "shingle" | "wave" | "trellis" | "zigZag", "percent5" | "percent10" | "percent20" | "percent25" | "percent30" | "percent40" | "percent50" | "percent60" | "percent70" | "percent75" | "percent80" | "percent90" | "horizontal" | "vertical" | "lightHorizontal" | "lightVertical" | "darkHorizontal" | "darkVertical" | "narrowHorizontal" | "narrowVertical" | "dashedHorizontal" | "dashedVertical" | "cross" | "downDiagonal" | "upDiagonal" | "lightDownDiagonal" | "lightUpDiagonal" | "darkDownDiagonal" | "darkUpDiagonal" | "wideDownDiagonal" | "wideUpDiagonal" | "dashedDownDiagonal" | "dashedUpDiagonal" | "diagonalCross" | "smallChecker" | "largeChecker" | "smallGrid" | "largeGrid" | "dotGrid" | "smallConfetti" | "largeConfetti" | "horizontalBrick" | "diagonalBrick" | "solidDiamond" | "openDiamond" | "dottedDiamond" | "plaid" | "sphere" | "weave" | "divot" | "shingle" | "wave" | "trellis" | "zigZag">;
1890
+ };
1891
+ declare const xsdVerticalMergeRev: {
1892
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1893
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1894
+ forward: Record<"continue" | "restart", "cont" | "rest">; /** The reverse map (XSD → user) */
1895
+ reverse: Record<"cont" | "rest", "continue" | "restart">;
1896
+ };
1897
+ declare const xsdUnderlineStyle: {
1898
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1899
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1900
+ forward: Record<"none" | "single" | "double", "none" | "sng" | "dbl">; /** The reverse map (XSD → user) */
1901
+ reverse: Record<"none" | "sng" | "dbl", "none" | "single" | "double">;
1902
+ };
1903
+ declare const xsdStrikeStyle: {
1904
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1905
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1906
+ forward: Record<"singleStrike" | "doubleStrike" | "noStrike", "sngStrike" | "dblStrike" | "noStrike">; /** The reverse map (XSD → user) */
1907
+ reverse: Record<"sngStrike" | "dblStrike" | "noStrike", "singleStrike" | "doubleStrike" | "noStrike">;
1908
+ };
1909
+ declare const xsdTextCaps: {
1910
+ /** User-friendly value → XSD value */to: (key: string) => string; /** XSD value → user-friendly value */
1911
+ from: (xsd: string) => string; /** The forward map (user → XSD) */
1912
+ forward: Record<"none" | "small" | "all", "none" | "small" | "all">; /** The reverse map (XSD → user) */
1913
+ reverse: Record<"none" | "small" | "all", "none" | "small" | "all">;
1914
+ };
1915
+ //#endregion
1916
+ //#region src/util/placeholder.d.ts
1917
+ /**
1918
+ * Placeholder detection and replacement utilities for compiler post-processing.
1919
+ *
1920
+ * Both DOCX and PPTX compilers use placeholder tokens (e.g. `{chart:key}`)
1921
+ * in XML strings to defer relationship ID assignment. This module provides
1922
+ * fast pre-check utilities and shared replacement functions.
1923
+ */
1924
+ type IdFormat = "rId" | "plain";
1925
+ declare const formatId: (offset: number, index: number, style: IdFormat) => string;
1926
+ declare function hasPlaceholders(xml: string): boolean;
1927
+ declare function collectPlaceholderKeys(xml: string, prefix: string): string[];
1928
+ declare function replaceImagePlaceholders(xml: string, mediaData: {
1929
+ fileName: string;
1930
+ }[], offset: number, idFormat?: IdFormat): string;
1931
+ declare function getReferencedMedia(xml: string, mediaArray: {
1932
+ fileName: string;
1933
+ }[]): {
1934
+ fileName: string;
1935
+ }[];
1936
+ /**
1937
+ * Combined find + replace for image placeholders in a single pass.
1938
+ *
1939
+ * Scans XML for `{fileName}` placeholders, replaces them with formatted IDs,
1940
+ * and returns the list of referenced media items for relationship registration.
1941
+ * More efficient than calling getReferencedMedia() + replaceImagePlaceholders() separately.
1942
+ */
1943
+ declare function findAndReplaceImagePlaceholders(xml: string, mediaArray: {
1944
+ fileName: string;
1945
+ }[], offset: number, idFormat?: IdFormat): {
1946
+ xml: string;
1947
+ referenced: {
1948
+ fileName: string;
1949
+ }[];
1950
+ };
1951
+ /**
1952
+ * Replace all placeholder types in a single pass.
1953
+ *
1954
+ * Combines image, chart, smartart, and arbitrary key-value replacements
1955
+ * into one regex scan of the XML string. Used by compilers to avoid
1956
+ * multiple full-string passes on large documents.
1957
+ */
1958
+ declare function replaceAllPlaceholders(xml: string, entries: Array<{
1959
+ prefix?: string;
1960
+ key: string;
1961
+ value: string;
1962
+ }>): string;
1963
+ declare function replaceChartPlaceholders(xml: string, chartKeys: string[], offset: number, idFormat?: IdFormat): string;
1964
+ interface SmartArtRelOptions {
1965
+ pathPrefix: string;
1966
+ styleRelType: RelationshipType;
1967
+ }
1968
+ declare function replaceSmartArtPlaceholders(xml: string, keys: string[], dataOffset: number, idFormat?: IdFormat): string;
1969
+ declare function addSmartArtRelationships(keys: string[], addRel: (id: number, type: RelationshipType, target: string, targetMode?: string) => void, baseOffset: number, globalStartIndex: number, options: SmartArtRelOptions): void;
1970
+ /** Replace `{reference-instance}` placeholders with numId values. */
1971
+ declare function replaceNumberingPlaceholders(xml: string, concreteNumberings: readonly {
1972
+ reference: string;
1973
+ instance: number;
1974
+ numId: number;
1975
+ }[]): string;
1976
+ /** Replace `{media:fileName}` placeholders with relationship IDs. */
1977
+ declare function replaceMediaPlaceholders(xml: string, mediaData: {
1978
+ fileName: string;
1979
+ }[], offset: number): string;
1980
+ /** Replace `{video:fileName}` placeholders with relationship IDs. */
1981
+ declare function replaceVideoPlaceholders(xml: string, mediaData: {
1982
+ fileName: string;
1983
+ }[], offset: number): string;
1984
+ /** Collect media items referenced by `{media:...}` placeholders in XML. */
1985
+ declare function getMediaRefs(xml: string, mediaArray: {
1986
+ fileName: string;
1987
+ }[]): {
1988
+ fileName: string;
1989
+ }[];
1990
+ /** Collect media items referenced by `{video:...}` placeholders in XML. */
1991
+ declare function getVideoRefs(xml: string, mediaArray: {
1992
+ fileName: string;
1993
+ }[]): {
1994
+ fileName: string;
1995
+ }[];
1996
+ /** Replace `{hlink:key}` placeholders with relationship IDs. */
1997
+ declare function replaceHyperlinkPlaceholders(xml: string, hyperlinks: {
1998
+ key: string;
1999
+ }[], offset: number): string;
1309
2000
  //#endregion
1310
2001
  //#region src/drawingml/outline/custom-dash.d.ts
1311
2002
  /**
@@ -1330,9 +2021,9 @@ declare const createGroupFill: () => XmlComponent;
1330
2021
  */
1331
2022
  interface DashStop {
1332
2023
  /** Dash length as a percentage of line width (e.g., "500%") */
1333
- readonly d: string;
2024
+ d: string;
1334
2025
  /** Space length as a percentage of line width (e.g., "200%") */
1335
- readonly sp: string;
2026
+ sp: string;
1336
2027
  }
1337
2028
  /**
1338
2029
  * Creates a custom dash element (a:custDash) for outlines.
@@ -1364,7 +2055,7 @@ interface DashStop {
1364
2055
  * ]);
1365
2056
  * ```
1366
2057
  */
1367
- declare const createCustomDash: (stops: readonly DashStop[]) => XmlComponent;
2058
+ declare const createCustomDash: (stops: readonly DashStop[]) => string;
1368
2059
  //#endregion
1369
2060
  //#region src/drawingml/outline/line-end.d.ts
1370
2061
  /**
@@ -1432,7 +2123,7 @@ declare const LineEndWidth: {
1432
2123
  * @publicApi
1433
2124
  */
1434
2125
  declare const LineEndLength: {
1435
- /** Small length */readonly SMALL: "small"; /** Medium length */
2126
+ /** Small length */readonly SMALL: "small"; /** MEDIUM length */
1436
2127
  readonly MEDIUM: "medium"; /** Large length */
1437
2128
  readonly LARGE: "large";
1438
2129
  };
@@ -1450,11 +2141,11 @@ declare const LineEndLength: {
1450
2141
  */
1451
2142
  interface LineEndOptions {
1452
2143
  /** Arrow/head type */
1453
- readonly type: (typeof LineEndType)[keyof typeof LineEndType];
2144
+ type: (typeof LineEndType)[keyof typeof LineEndType];
1454
2145
  /** Arrow width */
1455
- readonly width?: (typeof LineEndWidth)[keyof typeof LineEndWidth];
2146
+ width?: (typeof LineEndWidth)[keyof typeof LineEndWidth];
1456
2147
  /** Arrow length */
1457
- readonly length?: (typeof LineEndLength)[keyof typeof LineEndLength];
2148
+ length?: (typeof LineEndLength)[keyof typeof LineEndLength];
1458
2149
  }
1459
2150
  /**
1460
2151
  * Creates a line end element (a:headEnd or a:tailEnd).
@@ -1467,7 +2158,7 @@ interface LineEndOptions {
1467
2158
  * createLineEnd("a:tailEnd", { type: "TRIANGLE" });
1468
2159
  * ```
1469
2160
  */
1470
- declare const createLineEnd: (name: string, options: LineEndOptions) => XmlComponent;
2161
+ declare const createLineEnd: (name: string, options: LineEndOptions) => string;
1471
2162
  //#endregion
1472
2163
  //#region src/drawingml/outline/outline.d.ts
1473
2164
  /**
@@ -1548,34 +2239,34 @@ declare const LineJoin: {
1548
2239
  * Attributes for configuring outline properties.
1549
2240
  */
1550
2241
  interface OutlineAttributes {
1551
- /** Line width in EMUs (English Metric Units) */
1552
- readonly width?: number;
2242
+ /** Line width in EMUs (English Metric Units) or universal measure (e.g., "1pt", "2mm") */
2243
+ width?: number | UniversalMeasure;
1553
2244
  /** Line cap style */
1554
- readonly cap?: (typeof LineCap)[keyof typeof LineCap];
2245
+ cap?: (typeof LineCap)[keyof typeof LineCap];
1555
2246
  /** Compound line type */
1556
- readonly compoundLine?: (typeof CompoundLine)[keyof typeof CompoundLine];
2247
+ compoundLine?: (typeof CompoundLine)[keyof typeof CompoundLine];
1557
2248
  /** Pen alignment */
1558
- readonly align?: (typeof PenAlignment)[keyof typeof PenAlignment];
2249
+ align?: (typeof PenAlignment)[keyof typeof PenAlignment];
1559
2250
  /**
1560
2251
  * Preset dash style.
1561
2252
  *
1562
2253
  * Mutually exclusive with `customDash` — only one can be specified.
1563
2254
  */
1564
- readonly dash?: (typeof PresetDash)[keyof typeof PresetDash];
2255
+ dash?: (typeof PresetDash)[keyof typeof PresetDash];
1565
2256
  /**
1566
2257
  * Custom dash pattern (list of dash/space stops).
1567
2258
  *
1568
2259
  * Mutually exclusive with `dash` — only one can be specified.
1569
2260
  */
1570
- readonly customDash?: readonly DashStop[];
2261
+ customDash?: readonly DashStop[];
1571
2262
  /** Line join style */
1572
- readonly join?: (typeof LineJoin)[keyof typeof LineJoin];
2263
+ join?: (typeof LineJoin)[keyof typeof LineJoin];
1573
2264
  /** Miter limit (only when join is MITER) */
1574
- readonly miterLimit?: number;
2265
+ miterLimit?: number;
1575
2266
  /** Line start arrow/head */
1576
- readonly headEnd?: LineEndOptions;
2267
+ headEnd?: LineEndOptions;
1577
2268
  /** Line end arrow/tail */
1578
- readonly tailEnd?: LineEndOptions;
2269
+ tailEnd?: LineEndOptions;
1579
2270
  }
1580
2271
  /**
1581
2272
  * Fill properties for outline (EG_LineFillProperties).
@@ -1585,13 +2276,13 @@ interface OutlineAttributes {
1585
2276
  */
1586
2277
  interface OutlineFillProperties {
1587
2278
  /** Fill type */
1588
- readonly type?: "noFill" | "solidFill" | "gradFill" | "pattFill";
2279
+ type?: "noFill" | "solidFill" | "gradFill" | "pattFill";
1589
2280
  /** Color definition (required when type is "solidFill") */
1590
- readonly color?: SolidFillOptions;
2281
+ color?: SolidFillOptions;
1591
2282
  /** Gradient fill options (required when type is "gradFill") */
1592
- readonly gradientFill?: GradientFillOptions;
2283
+ gradientFill?: GradientFillOptions;
1593
2284
  /** Pattern fill options (required when type is "pattFill") */
1594
- readonly patternFill?: PatternFillOptions;
2285
+ patternFill?: PatternFillOptions;
1595
2286
  }
1596
2287
  /**
1597
2288
  * Complete outline configuration options.
@@ -1631,7 +2322,7 @@ type OutlineOptions = OutlineAttributes & OutlineFillProperties;
1631
2322
  * });
1632
2323
  * ```
1633
2324
  */
1634
- declare const createOutline: (options: OutlineOptions) => XmlComponent;
2325
+ declare const createOutline: (options: OutlineOptions) => string;
1635
2326
  //#endregion
1636
2327
  //#region src/drawingml/effects/fill-overlay.d.ts
1637
2328
  /**
@@ -1662,17 +2353,17 @@ declare const BlendMode: {
1662
2353
  */
1663
2354
  interface FillOverlayEffectOptions {
1664
2355
  /** Blend mode (required) */
1665
- readonly blend: (typeof BlendMode)[keyof typeof BlendMode];
2356
+ blend: (typeof BlendMode)[keyof typeof BlendMode];
1666
2357
  /** Solid fill color */
1667
- readonly solidFill?: SolidFillOptions;
2358
+ solidFill?: SolidFillOptions;
1668
2359
  /** Gradient fill */
1669
- readonly gradientFill?: GradientFillOptions;
2360
+ gradientFill?: GradientFillOptions;
1670
2361
  /** Pattern fill */
1671
- readonly patternFill?: PatternFillOptions;
2362
+ patternFill?: PatternFillOptions;
1672
2363
  /** Group fill (inherit from parent) */
1673
- readonly groupFill?: boolean;
2364
+ groupFill?: boolean;
1674
2365
  /** No fill */
1675
- readonly noFill?: boolean;
2366
+ noFill?: boolean;
1676
2367
  }
1677
2368
  /**
1678
2369
  * Creates a fill overlay effect element.
@@ -1702,7 +2393,7 @@ interface FillOverlayEffectOptions {
1702
2393
  * });
1703
2394
  * ```
1704
2395
  */
1705
- declare const createFillOverlayEffect: (options: FillOverlayEffectOptions) => XmlComponent;
2396
+ declare const createFillOverlayEffect: (options: FillOverlayEffectOptions) => string;
1706
2397
  //#endregion
1707
2398
  //#region src/drawingml/effects/glow.d.ts
1708
2399
  /**
@@ -1710,9 +2401,9 @@ declare const createFillOverlayEffect: (options: FillOverlayEffectOptions) => Xm
1710
2401
  */
1711
2402
  interface GlowEffectOptions {
1712
2403
  /** Glow radius in EMUs */
1713
- readonly radius?: number;
2404
+ radius?: number;
1714
2405
  /** Glow color */
1715
- readonly color: SolidFillOptions;
2406
+ color: SolidFillOptions;
1716
2407
  }
1717
2408
  /**
1718
2409
  * Creates a glow effect element.
@@ -1727,7 +2418,7 @@ interface GlowEffectOptions {
1727
2418
  * </xsd:complexType>
1728
2419
  * ```
1729
2420
  */
1730
- declare const createGlowEffect: (options: GlowEffectOptions) => XmlComponent;
2421
+ declare const createGlowEffect: (options: GlowEffectOptions) => string;
1731
2422
  //#endregion
1732
2423
  //#region src/drawingml/effects/inner-shadow.d.ts
1733
2424
  /**
@@ -1735,13 +2426,13 @@ declare const createGlowEffect: (options: GlowEffectOptions) => XmlComponent;
1735
2426
  */
1736
2427
  interface InnerShadowEffectOptions {
1737
2428
  /** Blur radius in EMUs */
1738
- readonly blurRadius?: number;
2429
+ blurRadius?: number;
1739
2430
  /** Distance from shape edge in EMUs */
1740
- readonly distance?: number;
2431
+ distance?: number;
1741
2432
  /** Direction angle in 60,000ths of a degree */
1742
- readonly direction?: number;
2433
+ direction?: number;
1743
2434
  /** Shadow color */
1744
- readonly color: SolidFillOptions;
2435
+ color: SolidFillOptions;
1745
2436
  }
1746
2437
  /**
1747
2438
  * Creates an inner shadow effect element.
@@ -1758,7 +2449,7 @@ interface InnerShadowEffectOptions {
1758
2449
  * </xsd:complexType>
1759
2450
  * ```
1760
2451
  */
1761
- declare const createInnerShadowEffect: (options: InnerShadowEffectOptions) => XmlComponent;
2452
+ declare const createInnerShadowEffect: (options: InnerShadowEffectOptions) => string;
1762
2453
  //#endregion
1763
2454
  //#region src/drawingml/effects/outer-shadow.d.ts
1764
2455
  /**
@@ -1780,25 +2471,25 @@ declare const RectAlignment: {
1780
2471
  */
1781
2472
  interface OuterShadowEffectOptions {
1782
2473
  /** Blur radius in EMUs */
1783
- readonly blurRadius?: number;
2474
+ blurRadius?: number;
1784
2475
  /** Distance from shape in EMUs */
1785
- readonly distance?: number;
2476
+ distance?: number;
1786
2477
  /** Direction angle in 60,000ths of a degree */
1787
- readonly direction?: number;
2478
+ direction?: number;
1788
2479
  /** Horizontal scale percentage (e.g., 100000 = 100%) */
1789
- readonly scaleX?: number;
2480
+ scaleX?: number;
1790
2481
  /** Vertical scale percentage */
1791
- readonly scaleY?: number;
2482
+ scaleY?: number;
1792
2483
  /** Horizontal skew angle in 60,000ths of a degree */
1793
- readonly skewX?: number;
2484
+ skewX?: number;
1794
2485
  /** Vertical skew angle */
1795
- readonly skewY?: number;
2486
+ skewY?: number;
1796
2487
  /** Shadow alignment */
1797
- readonly alignment?: (typeof RectAlignment)[keyof typeof RectAlignment];
2488
+ alignment?: (typeof RectAlignment)[keyof typeof RectAlignment];
1798
2489
  /** Whether shadow rotates with shape */
1799
- readonly rotWithShape?: boolean;
2490
+ rotWithShape?: boolean;
1800
2491
  /** Shadow color */
1801
- readonly color: SolidFillOptions;
2492
+ color: SolidFillOptions;
1802
2493
  }
1803
2494
  /**
1804
2495
  * Creates an outer shadow effect element.
@@ -1821,7 +2512,7 @@ interface OuterShadowEffectOptions {
1821
2512
  * </xsd:complexType>
1822
2513
  * ```
1823
2514
  */
1824
- declare const createOuterShadowEffect: (options: OuterShadowEffectOptions) => XmlComponent;
2515
+ declare const createOuterShadowEffect: (options: OuterShadowEffectOptions) => string;
1825
2516
  //#endregion
1826
2517
  //#region src/drawingml/effects/preset-shadow.d.ts
1827
2518
  /**
@@ -1856,13 +2547,13 @@ declare const PresetShadowVal: {
1856
2547
  */
1857
2548
  interface PresetShadowEffectOptions {
1858
2549
  /** Preset shadow type (required) */
1859
- readonly preset: (typeof PresetShadowVal)[keyof typeof PresetShadowVal];
2550
+ preset: (typeof PresetShadowVal)[keyof typeof PresetShadowVal];
1860
2551
  /** Distance from shape in EMUs */
1861
- readonly distance?: number;
2552
+ distance?: number;
1862
2553
  /** Direction angle in 60,000ths of a degree */
1863
- readonly direction?: number;
2554
+ direction?: number;
1864
2555
  /** Shadow color */
1865
- readonly color: SolidFillOptions;
2556
+ color: SolidFillOptions;
1866
2557
  }
1867
2558
  /**
1868
2559
  * Creates a preset shadow effect element.
@@ -1879,7 +2570,7 @@ interface PresetShadowEffectOptions {
1879
2570
  * </xsd:complexType>
1880
2571
  * ```
1881
2572
  */
1882
- declare const createPresetShadowEffect: (options: PresetShadowEffectOptions) => XmlComponent;
2573
+ declare const createPresetShadowEffect: (options: PresetShadowEffectOptions) => string;
1883
2574
  //#endregion
1884
2575
  //#region src/drawingml/effects/reflection.d.ts
1885
2576
  /**
@@ -1889,33 +2580,33 @@ declare const createPresetShadowEffect: (options: PresetShadowEffectOptions) =>
1889
2580
  */
1890
2581
  interface ReflectionEffectOptions {
1891
2582
  /** Blur radius in EMUs */
1892
- readonly blurRadius?: number;
2583
+ blurRadius?: number;
1893
2584
  /** Start opacity (fixed percentage, e.g., 100000 = 100%) */
1894
- readonly startAlpha?: number;
2585
+ startAlpha?: number;
1895
2586
  /** Start position (fixed percentage) */
1896
- readonly startPosition?: number;
2587
+ startPosition?: number;
1897
2588
  /** End opacity (fixed percentage) */
1898
- readonly endAlpha?: number;
2589
+ endAlpha?: number;
1899
2590
  /** End position (fixed percentage) */
1900
- readonly endPosition?: number;
2591
+ endPosition?: number;
1901
2592
  /** Distance from shape in EMUs */
1902
- readonly distance?: number;
2593
+ distance?: number;
1903
2594
  /** Direction angle in 60,000ths of a degree */
1904
- readonly direction?: number;
2595
+ direction?: number;
1905
2596
  /** Fade direction angle in 60,000ths of a degree */
1906
- readonly fadeDirection?: number;
2597
+ fadeDirection?: number;
1907
2598
  /** Horizontal scale percentage */
1908
- readonly scaleX?: number;
2599
+ scaleX?: number;
1909
2600
  /** Vertical scale percentage */
1910
- readonly scaleY?: number;
2601
+ scaleY?: number;
1911
2602
  /** Horizontal skew angle */
1912
- readonly skewX?: number;
2603
+ skewX?: number;
1913
2604
  /** Vertical skew angle */
1914
- readonly skewY?: number;
2605
+ skewY?: number;
1915
2606
  /** Alignment */
1916
- readonly alignment?: string;
2607
+ alignment?: string;
1917
2608
  /** Whether reflection rotates with shape */
1918
- readonly rotWithShape?: boolean;
2609
+ rotWithShape?: boolean;
1919
2610
  }
1920
2611
  /**
1921
2612
  * Creates a reflection effect element.
@@ -1940,17 +2631,44 @@ interface ReflectionEffectOptions {
1940
2631
  * </xsd:complexType>
1941
2632
  * ```
1942
2633
  */
1943
- declare const createReflectionEffect: (options?: ReflectionEffectOptions) => BuilderElement<{}>;
2634
+ declare const createReflectionEffect: (options?: ReflectionEffectOptions) => string;
1944
2635
  //#endregion
1945
2636
  //#region src/drawingml/effects/effect-list.d.ts
2637
+ /**
2638
+ * Effect extent calculation result.
2639
+ * Represents the additional space needed on each edge (in EMUs).
2640
+ */
2641
+ interface EffectExtent {
2642
+ /** Left edge extension */
2643
+ l: number;
2644
+ /** Top edge extension */
2645
+ t: number;
2646
+ /** Right edge extension */
2647
+ r: number;
2648
+ /** Bottom edge extension */
2649
+ b: number;
2650
+ }
2651
+ /**
2652
+ * Calculates the effect extent for a given set of effects.
2653
+ *
2654
+ * The effectExtent specifies the additional extent which shall be added to each edge
2655
+ * of the image (top, bottom, left, right) in order to compensate for any drawing effects
2656
+ * applied to the DrawingML object.
2657
+ *
2658
+ * Reference: CT_EffectExtent in dml-wordprocessingDrawing.xsd
2659
+ *
2660
+ * @param options - Effect list options
2661
+ * @returns The calculated effect extent in EMUs
2662
+ */
2663
+ declare const calculateEffectExtent: (options?: EffectListOptions) => EffectExtent;
1946
2664
  /**
1947
2665
  * Blur effect options.
1948
2666
  */
1949
2667
  interface BlurEffectOptions {
1950
2668
  /** Blur radius in EMUs */
1951
- readonly radius?: number;
2669
+ radius?: number;
1952
2670
  /** Whether to grow the shape boundary */
1953
- readonly grow?: boolean;
2671
+ grow?: boolean;
1954
2672
  }
1955
2673
  /**
1956
2674
  * Options for the effect list container.
@@ -1960,21 +2678,21 @@ interface BlurEffectOptions {
1960
2678
  */
1961
2679
  interface EffectListOptions {
1962
2680
  /** Blur effect */
1963
- readonly blur?: BlurEffectOptions;
2681
+ blur?: BlurEffectOptions;
1964
2682
  /** Fill overlay effect */
1965
- readonly fillOverlay?: FillOverlayEffectOptions;
2683
+ fillOverlay?: FillOverlayEffectOptions;
1966
2684
  /** Glow effect */
1967
- readonly glow?: GlowEffectOptions;
2685
+ glow?: GlowEffectOptions;
1968
2686
  /** Inner shadow effect */
1969
- readonly innerShadow?: InnerShadowEffectOptions;
2687
+ innerShadow?: InnerShadowEffectOptions;
1970
2688
  /** Outer shadow effect */
1971
- readonly outerShadow?: OuterShadowEffectOptions;
2689
+ outerShadow?: OuterShadowEffectOptions;
1972
2690
  /** Preset shadow effect */
1973
- readonly presetShadow?: PresetShadowEffectOptions;
2691
+ presetShadow?: PresetShadowEffectOptions;
1974
2692
  /** Reflection effect (pass object for attributes, or true for defaults) */
1975
- readonly reflection?: ReflectionEffectOptions | true;
2693
+ reflection?: ReflectionEffectOptions | true;
1976
2694
  /** Soft edge radius in EMUs */
1977
- readonly softEdge?: number;
2695
+ softEdge?: number;
1978
2696
  }
1979
2697
  /**
1980
2698
  * Creates an effect list element (a:effectLst).
@@ -1998,7 +2716,7 @@ interface EffectListOptions {
1998
2716
  * </xsd:complexType>
1999
2717
  * ```
2000
2718
  */
2001
- declare const createEffectList: (options: EffectListOptions) => XmlComponent;
2719
+ declare const createEffectList: (options: EffectListOptions) => string;
2002
2720
  //#endregion
2003
2721
  //#region src/drawingml/effects/effect-dag.d.ts
2004
2722
  /**
@@ -2025,113 +2743,113 @@ declare const EffectContainerType: {
2025
2743
  /** Alpha bi-level effect — clips alpha to threshold (CT_AlphaBiLevelEffect). */
2026
2744
  interface AlphaBiLevelEffectOptions {
2027
2745
  /** Alpha threshold (fixed percentage, required) */
2028
- readonly threshold: number;
2746
+ threshold: number;
2029
2747
  }
2030
2748
  /** Alpha inverse effect — inverts alpha, optionally with color (CT_AlphaInverseEffect). */
2031
2749
  interface AlphaInverseEffectOptions {
2032
2750
  /** Optional color to apply inverse to */
2033
- readonly color?: SolidFillOptions;
2751
+ color?: SolidFillOptions;
2034
2752
  }
2035
2753
  /** Alpha modulate fixed effect (CT_AlphaModulateFixedEffect). */
2036
2754
  interface AlphaModulateFixedEffectOptions {
2037
2755
  /** Amount percentage (default 100%) */
2038
- readonly amount?: number;
2756
+ amount?: number;
2039
2757
  }
2040
2758
  /** Alpha outset effect (CT_AlphaOutsetEffect). */
2041
2759
  interface AlphaOutsetEffectOptions {
2042
2760
  /** Outset radius */
2043
- readonly radius?: number;
2761
+ radius?: number;
2044
2762
  }
2045
2763
  /** Alpha replace effect — replaces alpha value (CT_AlphaReplaceEffect). */
2046
2764
  interface AlphaReplaceEffectOptions {
2047
2765
  /** New alpha value (fixed percentage, required) */
2048
- readonly alpha: number;
2766
+ alpha: number;
2049
2767
  }
2050
2768
  /** Blend effect — blends with nested container (CT_BlendEffect). */
2051
2769
  interface BlendEffectOptions {
2052
2770
  /** Blend mode (required) */
2053
- readonly blend: (typeof BlendMode)[keyof typeof BlendMode];
2771
+ blend: (typeof BlendMode)[keyof typeof BlendMode];
2054
2772
  /** Nested effect container */
2055
- readonly container: EffectDagOptions;
2773
+ container: EffectDagOptions;
2056
2774
  }
2057
2775
  /** Color change effect — maps one color to another (CT_ColorChangeEffect). */
2058
2776
  interface ColorChangeEffectOptions {
2059
2777
  /** Source color to replace */
2060
- readonly from: SolidFillOptions;
2778
+ from: SolidFillOptions;
2061
2779
  /** Target color */
2062
- readonly to: SolidFillOptions;
2780
+ to: SolidFillOptions;
2063
2781
  /** Whether to use alpha channel (default true) */
2064
- readonly useA?: boolean;
2782
+ useA?: boolean;
2065
2783
  }
2066
2784
  /** Duotone effect — two-color tone mapping (CT_DuotoneEffect). */
2067
2785
  interface DuotoneEffectOptions {
2068
2786
  /** First color */
2069
- readonly color1: SolidFillOptions;
2787
+ color1: SolidFillOptions;
2070
2788
  /** Second color */
2071
- readonly color2: SolidFillOptions;
2789
+ color2: SolidFillOptions;
2072
2790
  }
2073
2791
  /** Fill effect — applies a fill as an effect (CT_FillEffect). */
2074
2792
  interface FillEffectOptions {
2075
2793
  /** Solid fill */
2076
- readonly solidFill?: SolidFillOptions;
2794
+ solidFill?: SolidFillOptions;
2077
2795
  /** Gradient fill */
2078
- readonly gradientFill?: GradientFillOptions;
2796
+ gradientFill?: GradientFillOptions;
2079
2797
  /** Pattern fill */
2080
- readonly patternFill?: PatternFillOptions;
2798
+ patternFill?: PatternFillOptions;
2081
2799
  /** Group fill (inherit from parent) */
2082
- readonly groupFill?: boolean;
2800
+ groupFill?: boolean;
2083
2801
  /** No fill */
2084
- readonly noFill?: boolean;
2802
+ noFill?: boolean;
2085
2803
  }
2086
2804
  /** HSL effect — adjusts hue, saturation, luminance (CT_HSLEffect). */
2087
2805
  interface HSLEffectOptions {
2088
2806
  /** Hue angle in 60,000ths of a degree (default 0) */
2089
- readonly hue?: number;
2807
+ hue?: number;
2090
2808
  /** Saturation percentage (default 0%) */
2091
- readonly saturation?: number;
2809
+ saturation?: number;
2092
2810
  /** Luminance percentage (default 0%) */
2093
- readonly luminance?: number;
2811
+ luminance?: number;
2094
2812
  }
2095
2813
  /** Luminance effect — adjusts brightness and contrast (CT_LuminanceEffect). */
2096
2814
  interface LuminanceEffectOptions {
2097
2815
  /** Brightness percentage (default 0%) */
2098
- readonly bright?: number;
2816
+ bright?: number;
2099
2817
  /** Contrast percentage (default 0%) */
2100
- readonly contrast?: number;
2818
+ contrast?: number;
2101
2819
  }
2102
2820
  /** Tint effect — applies tint with hue and amount (CT_TintEffect). */
2103
2821
  interface TintEffectOptions {
2104
2822
  /** Hue angle in 60,000ths of a degree (default 0) */
2105
- readonly hue?: number;
2823
+ hue?: number;
2106
2824
  /** Tint amount percentage (default 0%) */
2107
- readonly amount?: number;
2825
+ amount?: number;
2108
2826
  }
2109
2827
  /** Relative offset effect (CT_RelativeOffsetEffect). */
2110
2828
  interface RelativeOffsetEffectOptions {
2111
2829
  /** Horizontal offset percentage (default 0%) */
2112
- readonly translateX?: number;
2830
+ translateX?: number;
2113
2831
  /** Vertical offset percentage (default 0%) */
2114
- readonly translateY?: number;
2832
+ translateY?: number;
2115
2833
  }
2116
2834
  /** Transform effect — scale, skew, translate (CT_TransformEffect). */
2117
2835
  interface TransformEffectOptions {
2118
2836
  /** Horizontal scale percentage (default 100%) */
2119
- readonly scaleX?: number;
2837
+ scaleX?: number;
2120
2838
  /** Vertical scale percentage (default 100%) */
2121
- readonly scaleY?: number;
2839
+ scaleY?: number;
2122
2840
  /** Horizontal skew angle (default 0) */
2123
- readonly skewX?: number;
2841
+ skewX?: number;
2124
2842
  /** Vertical skew angle (default 0) */
2125
- readonly skewY?: number;
2843
+ skewY?: number;
2126
2844
  /** Horizontal translation */
2127
- readonly translateX?: number;
2845
+ translateX?: number;
2128
2846
  /** Vertical translation */
2129
- readonly translateY?: number;
2847
+ translateY?: number;
2130
2848
  }
2131
2849
  /** Effect reference — references an effect by ID (CT_EffectReference). */
2132
2850
  interface EffectReferenceOptions {
2133
2851
  /** Reference ID (required) */
2134
- readonly ref: string;
2852
+ ref: string;
2135
2853
  }
2136
2854
  /**
2137
2855
  * Options for an effect container (CT_EffectContainer).
@@ -2149,63 +2867,63 @@ interface EffectReferenceOptions {
2149
2867
  */
2150
2868
  interface EffectDagOptions {
2151
2869
  /** Container type: "sib" (parallel) or "tree" (sequential) */
2152
- readonly type?: (typeof EffectContainerType)[keyof typeof EffectContainerType];
2870
+ type?: (typeof EffectContainerType)[keyof typeof EffectContainerType];
2153
2871
  /** Container name */
2154
- readonly name?: string;
2155
- readonly blur?: BlurEffectOptions;
2156
- readonly fillOverlay?: FillOverlayEffectOptions;
2157
- readonly glow?: GlowEffectOptions;
2158
- readonly innerShadow?: InnerShadowEffectOptions;
2159
- readonly outerShadow?: OuterShadowEffectOptions;
2160
- readonly presetShadow?: PresetShadowEffectOptions;
2161
- readonly reflection?: ReflectionEffectOptions | true;
2162
- readonly softEdge?: number;
2872
+ name?: string;
2873
+ blur?: BlurEffectOptions;
2874
+ fillOverlay?: FillOverlayEffectOptions;
2875
+ glow?: GlowEffectOptions;
2876
+ innerShadow?: InnerShadowEffectOptions;
2877
+ outerShadow?: OuterShadowEffectOptions;
2878
+ presetShadow?: PresetShadowEffectOptions;
2879
+ reflection?: ReflectionEffectOptions | true;
2880
+ softEdge?: number;
2163
2881
  /** Nested effect containers */
2164
- readonly containers?: readonly EffectDagOptions[];
2882
+ containers?: readonly EffectDagOptions[];
2165
2883
  /** Effect references */
2166
- readonly effectRefs?: readonly EffectReferenceOptions[];
2884
+ effectRefs?: readonly EffectReferenceOptions[];
2167
2885
  /** Alpha bi-level effect */
2168
- readonly alphaBiLevel?: AlphaBiLevelEffectOptions;
2886
+ alphaBiLevel?: AlphaBiLevelEffectOptions;
2169
2887
  /** Alpha ceiling effect (empty element) */
2170
- readonly alphaCeiling?: boolean;
2888
+ alphaCeiling?: boolean;
2171
2889
  /** Alpha floor effect (empty element) */
2172
- readonly alphaFloor?: boolean;
2890
+ alphaFloor?: boolean;
2173
2891
  /** Alpha inverse effect */
2174
- readonly alphaInverse?: AlphaInverseEffectOptions;
2892
+ alphaInverse?: AlphaInverseEffectOptions;
2175
2893
  /** Alpha modulate effect (requires nested container) */
2176
- readonly alphaModulate?: EffectDagOptions;
2894
+ alphaModulate?: EffectDagOptions;
2177
2895
  /** Alpha modulate fixed effect */
2178
- readonly alphaModulateFixed?: AlphaModulateFixedEffectOptions;
2896
+ alphaModulateFixed?: AlphaModulateFixedEffectOptions;
2179
2897
  /** Alpha outset effect */
2180
- readonly alphaOutset?: AlphaOutsetEffectOptions;
2898
+ alphaOutset?: AlphaOutsetEffectOptions;
2181
2899
  /** Alpha replace effect */
2182
- readonly alphaReplace?: AlphaReplaceEffectOptions;
2900
+ alphaReplace?: AlphaReplaceEffectOptions;
2183
2901
  /** Bi-level effect (threshold) */
2184
- readonly biLevel?: {
2185
- readonly threshold: number;
2902
+ biLevel?: {
2903
+ threshold: number;
2186
2904
  };
2187
2905
  /** Blend effect (requires nested container) */
2188
- readonly blend?: BlendEffectOptions;
2906
+ blend?: BlendEffectOptions;
2189
2907
  /** Color change effect */
2190
- readonly colorChange?: ColorChangeEffectOptions;
2908
+ colorChange?: ColorChangeEffectOptions;
2191
2909
  /** Color replace effect */
2192
- readonly colorReplace?: SolidFillOptions;
2910
+ colorReplace?: SolidFillOptions;
2193
2911
  /** Duotone effect */
2194
- readonly duotone?: DuotoneEffectOptions;
2912
+ duotone?: DuotoneEffectOptions;
2195
2913
  /** Fill effect */
2196
- readonly fill?: FillEffectOptions;
2914
+ fill?: FillEffectOptions;
2197
2915
  /** Grayscale effect (empty element) */
2198
- readonly grayscale?: boolean;
2916
+ grayscale?: boolean;
2199
2917
  /** HSL effect */
2200
- readonly hsl?: HSLEffectOptions;
2918
+ hsl?: HSLEffectOptions;
2201
2919
  /** Luminance effect */
2202
- readonly luminance?: LuminanceEffectOptions;
2920
+ luminance?: LuminanceEffectOptions;
2203
2921
  /** Tint effect */
2204
- readonly tint?: TintEffectOptions;
2922
+ tint?: TintEffectOptions;
2205
2923
  /** Relative offset effect */
2206
- readonly relativeOffset?: RelativeOffsetEffectOptions;
2924
+ relativeOffset?: RelativeOffsetEffectOptions;
2207
2925
  /** Transform effect */
2208
- readonly transform?: TransformEffectOptions;
2926
+ transform?: TransformEffectOptions;
2209
2927
  }
2210
2928
  /**
2211
2929
  * Creates an effect DAG element (a:effectDag).
@@ -2231,9 +2949,16 @@ interface EffectDagOptions {
2231
2949
  * });
2232
2950
  * ```
2233
2951
  */
2234
- declare const createEffectDag: (options: EffectDagOptions) => XmlComponent;
2952
+ declare const createEffectDag: (options: EffectDagOptions) => string;
2235
2953
  //#endregion
2236
2954
  //#region src/drawingml/effects/soft-edge.d.ts
2955
+ /**
2956
+ * Soft edge effect for DrawingML shapes.
2957
+ *
2958
+ * Reference: ISO/IEC 29500-4, dml-main.xsd, CT_SoftEdgesEffect
2959
+ *
2960
+ * @module
2961
+ */
2237
2962
  /**
2238
2963
  * Creates a soft edge effect element.
2239
2964
  *
@@ -2246,9 +2971,7 @@ declare const createEffectDag: (options: EffectDagOptions) => XmlComponent;
2246
2971
  *
2247
2972
  * @param rad - Soft edge radius in EMUs (required)
2248
2973
  */
2249
- declare const createSoftEdgeEffect: (rad: number) => BuilderElement<{
2250
- readonly rad: number;
2251
- }>;
2974
+ declare const createSoftEdgeEffect: (rad: number) => string;
2252
2975
  //#endregion
2253
2976
  //#region src/drawingml/three-d/scene-3d.d.ts
2254
2977
  /**
@@ -2267,11 +2990,11 @@ declare const createSoftEdgeEffect: (rad: number) => BuilderElement<{
2267
2990
  */
2268
2991
  interface SphereCoords {
2269
2992
  /** Latitude angle (0 to 21600000, in 1/60000 degree units) */
2270
- readonly lat: number;
2993
+ lat: number;
2271
2994
  /** Longitude angle (0 to 21600000) */
2272
- readonly lon: number;
2995
+ lon: number;
2273
2996
  /** Revolution angle (0 to 21600000) */
2274
- readonly rev: number;
2997
+ rev: number;
2275
2998
  }
2276
2999
  /**
2277
3000
  * Camera options (CT_Camera).
@@ -2292,13 +3015,13 @@ interface SphereCoords {
2292
3015
  */
2293
3016
  interface CameraOptions {
2294
3017
  /** Preset camera type (e.g., "perspectiveFront", "isometricTopUp") */
2295
- readonly preset: string;
3018
+ preset: string;
2296
3019
  /** Field of view angle (0 to 10800000, in 1/60000 degree units, max 180°) */
2297
- readonly fov?: number;
3020
+ fov?: number;
2298
3021
  /** Zoom percentage (e.g., "100%") */
2299
- readonly zoom?: string;
3022
+ zoom?: string;
2300
3023
  /** Camera rotation */
2301
- readonly rotation?: SphereCoords;
3024
+ rotation?: SphereCoords;
2302
3025
  }
2303
3026
  /**
2304
3027
  * Light rig options (CT_LightRig).
@@ -2318,27 +3041,27 @@ interface CameraOptions {
2318
3041
  */
2319
3042
  interface LightRigOptions {
2320
3043
  /** Light rig type (e.g., "threePt", "balanced", "soft") */
2321
- readonly rig: string;
3044
+ rig: string;
2322
3045
  /** Light direction (e.g., "tl", "t", "tr", "l", "r", "bl", "b", "br") */
2323
- readonly direction: string;
3046
+ direction: string;
2324
3047
  /** Light rig rotation */
2325
- readonly rotation?: SphereCoords;
3048
+ rotation?: SphereCoords;
2326
3049
  }
2327
3050
  /**
2328
3051
  * 3D point (CT_Point3D).
2329
3052
  */
2330
3053
  interface Point3D {
2331
- readonly x: number;
2332
- readonly y: number;
2333
- readonly z: number;
3054
+ x: number;
3055
+ y: number;
3056
+ z: number;
2334
3057
  }
2335
3058
  /**
2336
3059
  * 3D vector (CT_Vector3D).
2337
3060
  */
2338
3061
  interface Vector3D {
2339
- readonly dx: number;
2340
- readonly dy: number;
2341
- readonly dz: number;
3062
+ dx: number;
3063
+ dy: number;
3064
+ dz: number;
2342
3065
  }
2343
3066
  /**
2344
3067
  * Backdrop options (CT_Backdrop).
@@ -2358,11 +3081,11 @@ interface Vector3D {
2358
3081
  */
2359
3082
  interface BackdropOptions {
2360
3083
  /** Anchor point */
2361
- readonly anchor: Point3D;
3084
+ anchor: Point3D;
2362
3085
  /** Normal vector */
2363
- readonly normal: Vector3D;
3086
+ normal: Vector3D;
2364
3087
  /** Up vector */
2365
- readonly up: Vector3D;
3088
+ up: Vector3D;
2366
3089
  }
2367
3090
  /**
2368
3091
  * Options for a 3D scene (CT_Scene3D).
@@ -2390,11 +3113,11 @@ interface BackdropOptions {
2390
3113
  */
2391
3114
  interface Scene3DOptions {
2392
3115
  /** Camera settings (required) */
2393
- readonly camera: CameraOptions;
3116
+ camera: CameraOptions;
2394
3117
  /** Light rig settings (required) */
2395
- readonly lightRig: LightRigOptions;
3118
+ lightRig: LightRigOptions;
2396
3119
  /** Backdrop settings (optional) */
2397
- readonly backdrop?: BackdropOptions;
3120
+ backdrop?: BackdropOptions;
2398
3121
  }
2399
3122
  /**
2400
3123
  * Creates a 3D scene element (a:scene3d).
@@ -2422,7 +3145,7 @@ interface Scene3DOptions {
2422
3145
  * });
2423
3146
  * ```
2424
3147
  */
2425
- declare const createScene3D: (options: Scene3DOptions) => XmlComponent;
3148
+ declare const createScene3D: (options: Scene3DOptions) => string;
2426
3149
  //#endregion
2427
3150
  //#region src/drawingml/three-d/bevel.d.ts
2428
3151
  /**
@@ -2449,11 +3172,11 @@ declare const BevelPresetType: {
2449
3172
  */
2450
3173
  interface BevelOptions {
2451
3174
  /** Bevel width in EMUs (default 76200) */
2452
- readonly w?: number;
3175
+ w?: number;
2453
3176
  /** Bevel height in EMUs (default 76200) */
2454
- readonly h?: number;
3177
+ h?: number;
2455
3178
  /** Bevel preset type */
2456
- readonly prst?: (typeof BevelPresetType)[keyof typeof BevelPresetType];
3179
+ prst?: (typeof BevelPresetType)[keyof typeof BevelPresetType];
2457
3180
  }
2458
3181
  /**
2459
3182
  * Creates a bevel element.
@@ -2467,11 +3190,11 @@ interface BevelOptions {
2467
3190
  * </xsd:complexType>
2468
3191
  * ```
2469
3192
  */
2470
- declare const createBevel: (options?: BevelOptions) => BuilderElement<{}>;
3193
+ declare const createBevel: (options?: BevelOptions) => string;
2471
3194
  /**
2472
3195
  * Creates a bottom bevel element (a:bevelB).
2473
3196
  */
2474
- declare const createBottomBevel: (options?: BevelOptions) => BuilderElement<{}>;
3197
+ declare const createBottomBevel: (options?: BevelOptions) => string;
2475
3198
  //#endregion
2476
3199
  //#region src/drawingml/three-d/shape-3d.d.ts
2477
3200
  /**
@@ -2501,21 +3224,21 @@ declare const PresetMaterialType: {
2501
3224
  */
2502
3225
  interface Shape3DOptions {
2503
3226
  /** Top bevel options */
2504
- readonly bevelT?: BevelOptions;
3227
+ bevelT?: BevelOptions;
2505
3228
  /** Bottom bevel options */
2506
- readonly bevelB?: BevelOptions;
3229
+ bevelB?: BevelOptions;
2507
3230
  /** Extrusion color (CT_Color / EG_ColorChoice) */
2508
- readonly extrusionColor?: SolidFillOptions;
3231
+ extrusionColor?: SolidFillOptions;
2509
3232
  /** Contour color (CT_Color / EG_ColorChoice) */
2510
- readonly contourColor?: SolidFillOptions;
3233
+ contourColor?: SolidFillOptions;
2511
3234
  /** Depth in EMUs (default 0) */
2512
- readonly z?: number;
3235
+ z?: number;
2513
3236
  /** Extrusion height in EMUs (default 0) */
2514
- readonly extrusionH?: number;
3237
+ extrusionH?: number;
2515
3238
  /** Contour width in EMUs (default 0) */
2516
- readonly contourW?: number;
3239
+ contourW?: number;
2517
3240
  /** Material preset type */
2518
- readonly prstMaterial?: (typeof PresetMaterialType)[keyof typeof PresetMaterialType];
3241
+ prstMaterial?: (typeof PresetMaterialType)[keyof typeof PresetMaterialType];
2519
3242
  }
2520
3243
  /**
2521
3244
  * Creates a 3D shape properties element (a:sp3d).
@@ -2536,116 +3259,37 @@ interface Shape3DOptions {
2536
3259
  * </xsd:complexType>
2537
3260
  * ```
2538
3261
  */
2539
- declare const createShape3D: (options: Shape3DOptions) => XmlComponent;
3262
+ declare const createShape3D: (options: Shape3DOptions) => string;
2540
3263
  //#endregion
2541
3264
  //#region src/drawingml/geometry/adjustment-values.d.ts
2542
3265
  /**
2543
- * A single geometry guide that defines an adjustment value.
2544
- *
2545
- * ## XSD Schema
2546
- * ```xml
2547
- * <xsd:complexType name="CT_GeomGuide">
2548
- * <xsd:attribute name="name" type="ST_GeomGuideName" use="required"/>
2549
- * <xsd:attribute name="fmla" type="ST_GeomGuideFormula" use="required"/>
2550
- * </xsd:complexType>
2551
- * ```
2552
- *
2553
- * @example
2554
- * ```typescript
2555
- * // Adjust rounded rectangle corner radius
2556
- * { name: "adj", formula: "val 16667" }
2557
- *
2558
- * // Adjust star inner radius
2559
- * { name: "val", formula: "val 50000" }
2560
- * ```
3266
+ * Adjustment values module for preset geometries.
2561
3267
  *
2562
- * Note: Formula examples like `val 16667` define fixed adjustment values.
3268
+ * @module
3269
+ */
3270
+ /**
3271
+ * A single geometry guide that defines an adjustment value.
2563
3272
  */
2564
3273
  interface GeometryGuide {
2565
3274
  /** Guide name (identifier) */
2566
- readonly name: string;
3275
+ name: string;
2567
3276
  /** Guide formula (e.g., "val 16667") */
2568
- readonly formula: string;
3277
+ formula: string;
2569
3278
  }
2570
3279
  /**
2571
- * Creates an adjustment values list element (a:avLst).
2572
- *
2573
- * The adjustment values list contains geometry guides that modify
2574
- * the appearance of a preset geometric shape. When empty, default
2575
- * values are used.
2576
- *
2577
- * ## XSD Schema
2578
- * ```xml
2579
- * <xsd:complexType name="CT_GeomGuideList">
2580
- * <xsd:sequence>
2581
- * <xsd:element name="gd" type="CT_GeomGuide" minOccurs="0" maxOccurs="unbounded"/>
2582
- * </xsd:sequence>
2583
- * </xsd:complexType>
2584
- * ```
2585
- *
2586
- * @example
2587
- * ```typescript
2588
- * // Empty adjustment values (defaults)
2589
- * createAdjustmentValues();
2590
- *
2591
- * // With guides
2592
- * createAdjustmentValues([
2593
- * { name: "adj", formula: "val 16667" },
2594
- * ]);
2595
- * ```
3280
+ * Build a:avLst XML string from geometry guides.
2596
3281
  */
2597
- declare const createAdjustmentValues: (guides?: readonly GeometryGuide[]) => XmlComponent;
3282
+ declare function stringifyAdjustmentValues(guides?: readonly GeometryGuide[]): string;
2598
3283
  //#endregion
2599
3284
  //#region src/drawingml/geometry/preset-geometry.d.ts
2600
- /**
2601
- * Options for preset geometry.
2602
- */
2603
3285
  interface PresetGeometryOptions {
2604
- /**
2605
- * Preset shape type (ST_ShapeType).
2606
- *
2607
- * Defaults to `"rect"` if not specified.
2608
- */
2609
- readonly preset?: string;
2610
- /**
2611
- * Adjustment values that modify the base shape.
2612
- *
2613
- * Each guide has a name and formula (e.g., `{ name: "adj", formula: "val 16667" }`).
2614
- */
2615
- readonly adjustmentValues?: readonly GeometryGuide[];
3286
+ preset?: string;
3287
+ adjustmentValues?: readonly GeometryGuide[];
2616
3288
  }
2617
3289
  /**
2618
- * Represents a preset geometry for a DrawingML shape.
2619
- *
2620
- * This element specifies when a preset geometric shape should be used instead
2621
- * of a custom geometry. It includes a shape preset identifier and optional
2622
- * adjustment values that modify the base shape.
2623
- *
2624
- * ## XSD Schema
2625
- * ```xml
2626
- * <xsd:complexType name="CT_PresetGeometry2D">
2627
- * <xsd:sequence>
2628
- * <xsd:element name="avLst" type="CT_GeomGuideList" minOccurs="0" maxOccurs="1"/>
2629
- * </xsd:sequence>
2630
- * <xsd:attribute name="prst" type="ST_ShapeType" use="required"/>
2631
- * </xsd:complexType>
2632
- * ```
2633
- *
2634
- * @example
2635
- * ```typescript
2636
- * // Default rectangle
2637
- * const geometry = new PresetGeometry();
2638
- *
2639
- * // Rounded rectangle with adjustment
2640
- * const geometry = new PresetGeometry({
2641
- * preset: "roundRect",
2642
- * adjustmentValues: [{ name: "adj", formula: "val 16667" }],
2643
- * });
2644
- * ```
3290
+ * Build a:prstGeom XML string.
2645
3291
  */
2646
- declare class PresetGeometry extends XmlComponent {
2647
- constructor(options?: PresetGeometryOptions);
2648
- }
3292
+ declare function stringifyPresetGeometry(options?: PresetGeometryOptions): string;
2649
3293
  //#endregion
2650
3294
  //#region src/drawingml/geometry/custom-geometry.d.ts
2651
3295
  /**
@@ -2680,41 +3324,41 @@ declare const PathFillMode: {
2680
3324
  */
2681
3325
  interface AdjPoint {
2682
3326
  /** X coordinate (absolute value or guide name) */
2683
- readonly x: string;
3327
+ x: string;
2684
3328
  /** Y coordinate (absolute value or guide name) */
2685
- readonly y: string;
3329
+ y: string;
2686
3330
  }
2687
3331
  /** Move-to path command (CT_Path2DMoveTo). */
2688
3332
  interface PathMoveTo {
2689
- readonly command: "moveTo";
2690
- readonly point: AdjPoint;
3333
+ command: "moveTo";
3334
+ point: AdjPoint;
2691
3335
  }
2692
3336
  /** Line-to path command (CT_Path2DLineTo). */
2693
3337
  interface PathLineTo {
2694
- readonly command: "lineTo";
2695
- readonly point: AdjPoint;
3338
+ command: "lineTo";
3339
+ point: AdjPoint;
2696
3340
  }
2697
3341
  /** Arc-to path command (CT_Path2DArcTo). */
2698
3342
  interface PathArcTo {
2699
- readonly command: "arcTo";
2700
- readonly widthRadius: string;
2701
- readonly heightRadius: string;
2702
- readonly startAngle: string;
2703
- readonly sweepAngle: string;
3343
+ command: "arcTo";
3344
+ widthRadius: string;
3345
+ heightRadius: string;
3346
+ startAngle: string;
3347
+ sweepAngle: string;
2704
3348
  }
2705
3349
  /** Quadratic Bezier-to path command (CT_Path2DQuadBezierTo). */
2706
3350
  interface PathQuadBezTo {
2707
- readonly command: "quadBezTo";
2708
- readonly points: readonly [AdjPoint, AdjPoint];
3351
+ command: "quadBezTo";
3352
+ points: readonly [AdjPoint, AdjPoint];
2709
3353
  }
2710
3354
  /** Cubic Bezier-to path command (CT_Path2DCubicBezierTo). */
2711
3355
  interface PathCubicBezTo {
2712
- readonly command: "cubicBezTo";
2713
- readonly points: readonly [AdjPoint, AdjPoint, AdjPoint];
3356
+ command: "cubicBezTo";
3357
+ points: readonly [AdjPoint, AdjPoint, AdjPoint];
2714
3358
  }
2715
3359
  /** Close path command (CT_Path2DClose). */
2716
3360
  interface PathClose {
2717
- readonly command: "close";
3361
+ command: "close";
2718
3362
  }
2719
3363
  /** A path command within a custom geometry path. */
2720
3364
  type PathCommand = PathMoveTo | PathLineTo | PathArcTo | PathQuadBezTo | PathCubicBezTo | PathClose;
@@ -2742,24 +3386,24 @@ type PathCommand = PathMoveTo | PathLineTo | PathArcTo | PathQuadBezTo | PathCub
2742
3386
  */
2743
3387
  interface PathOptions {
2744
3388
  /** Path width (coordinate value, default 0 = use shape width) */
2745
- readonly w?: number;
3389
+ w?: number;
2746
3390
  /** Path height (coordinate value, default 0 = use shape height) */
2747
- readonly h?: number;
3391
+ h?: number;
2748
3392
  /** Fill mode for this path */
2749
- readonly fill?: (typeof PathFillMode)[keyof typeof PathFillMode];
3393
+ fill?: (typeof PathFillMode)[keyof typeof PathFillMode];
2750
3394
  /** Whether to stroke the path */
2751
- readonly stroke?: boolean;
3395
+ stroke?: boolean;
2752
3396
  /** Whether extrusion is allowed */
2753
- readonly extrusionOk?: boolean;
3397
+ extrusionOk?: boolean;
2754
3398
  /** Path commands (moveTo, lineTo, arcTo, etc.) */
2755
- readonly commands: readonly PathCommand[];
3399
+ commands: readonly PathCommand[];
2756
3400
  }
2757
3401
  /**
2758
3402
  * A position reference for adjust handles and connection sites.
2759
3403
  */
2760
3404
  interface AdjustHandlePosition {
2761
- readonly x: string;
2762
- readonly y: string;
3405
+ x: string;
3406
+ y: string;
2763
3407
  }
2764
3408
  /**
2765
3409
  * XY adjust handle (CT_XYAdjustHandle).
@@ -2767,14 +3411,14 @@ interface AdjustHandlePosition {
2767
3411
  * Allows the user to drag a handle in X/Y directions.
2768
3412
  */
2769
3413
  interface XYAdjustHandle {
2770
- readonly type: "xy";
2771
- readonly guideRefX?: string;
2772
- readonly minX?: string;
2773
- readonly maxX?: string;
2774
- readonly guideRefY?: string;
2775
- readonly minY?: string;
2776
- readonly maxY?: string;
2777
- readonly position: AdjustHandlePosition;
3414
+ type: "xy";
3415
+ guideRefX?: string;
3416
+ minX?: string;
3417
+ maxX?: string;
3418
+ guideRefY?: string;
3419
+ minY?: string;
3420
+ maxY?: string;
3421
+ position: AdjustHandlePosition;
2778
3422
  }
2779
3423
  /**
2780
3424
  * Polar adjust handle (CT_PolarAdjustHandle).
@@ -2782,14 +3426,14 @@ interface XYAdjustHandle {
2782
3426
  * Allows the user to drag a handle in radius/angle directions.
2783
3427
  */
2784
3428
  interface PolarAdjustHandle {
2785
- readonly type: "polar";
2786
- readonly guideRefRadius?: string;
2787
- readonly minRadius?: string;
2788
- readonly maxRadius?: string;
2789
- readonly guideRefAngle?: string;
2790
- readonly minAngle?: string;
2791
- readonly maxAngle?: string;
2792
- readonly position: AdjustHandlePosition;
3429
+ type: "polar";
3430
+ guideRefRadius?: string;
3431
+ minRadius?: string;
3432
+ maxRadius?: string;
3433
+ guideRefAngle?: string;
3434
+ minAngle?: string;
3435
+ maxAngle?: string;
3436
+ position: AdjustHandlePosition;
2793
3437
  }
2794
3438
  /** An adjust handle (XY or Polar). */
2795
3439
  type AdjustHandle = XYAdjustHandle | PolarAdjustHandle;
@@ -2800,9 +3444,9 @@ type AdjustHandle = XYAdjustHandle | PolarAdjustHandle;
2800
3444
  */
2801
3445
  interface ConnectionSite {
2802
3446
  /** Angle (absolute value or guide name) */
2803
- readonly angle: string;
3447
+ angle: string;
2804
3448
  /** Position */
2805
- readonly position: AdjustHandlePosition;
3449
+ position: AdjustHandlePosition;
2806
3450
  }
2807
3451
  /**
2808
3452
  * Text insertion rectangle (CT_GeomRect).
@@ -2811,10 +3455,10 @@ interface ConnectionSite {
2811
3455
  * Coordinates can be absolute values or references to geometry guide names.
2812
3456
  */
2813
3457
  interface GeomRect {
2814
- readonly left: string;
2815
- readonly top: string;
2816
- readonly right: string;
2817
- readonly bottom: string;
3458
+ left: string;
3459
+ top: string;
3460
+ right: string;
3461
+ bottom: string;
2818
3462
  }
2819
3463
  /**
2820
3464
  * Options for a custom 2D geometry (CT_CustomGeometry2D).
@@ -2852,20 +3496,20 @@ interface GeomRect {
2852
3496
  */
2853
3497
  interface CustomGeometryOptions {
2854
3498
  /** Adjustment value guides (a:avLst) */
2855
- readonly adjustmentValues?: readonly GeometryGuide[];
3499
+ adjustmentValues?: readonly GeometryGuide[];
2856
3500
  /** Geometry guide formulas (a:gdLst) */
2857
- readonly guides?: readonly GeometryGuide[];
3501
+ guides?: readonly GeometryGuide[];
2858
3502
  /** Adjust handles (a:ahLst) */
2859
- readonly adjustHandles?: readonly AdjustHandle[];
3503
+ adjustHandles?: readonly AdjustHandle[];
2860
3504
  /** Connection sites (a:cxnLst) */
2861
- readonly connectionSites?: readonly ConnectionSite[];
3505
+ connectionSites?: readonly ConnectionSite[];
2862
3506
  /** Text insertion rectangle (a:rect) */
2863
- readonly textRect?: GeomRect;
3507
+ textRect?: GeomRect;
2864
3508
  /** Path definitions (a:pathLst) — required */
2865
- readonly pathList: readonly PathOptions[];
3509
+ pathList: readonly PathOptions[];
2866
3510
  }
2867
3511
  /**
2868
- * Creates a custom 2D geometry element (a:custGeom).
3512
+ * Creates a custom 2D geometry element as an XML string (a:custGeom).
2869
3513
  *
2870
3514
  * @example
2871
3515
  * ```typescript
@@ -2884,7 +3528,7 @@ interface CustomGeometryOptions {
2884
3528
  * });
2885
3529
  * ```
2886
3530
  */
2887
- declare const createCustomGeometry: (options: CustomGeometryOptions) => XmlComponent;
3531
+ declare const createCustomGeometry: (options: CustomGeometryOptions) => string;
2888
3532
  //#endregion
2889
3533
  //#region src/drawingml/blip/blip.d.ts
2890
3534
  /**
@@ -2892,11 +3536,11 @@ declare const createCustomGeometry: (options: CustomGeometryOptions) => XmlCompo
2892
3536
  */
2893
3537
  interface BlipOptions {
2894
3538
  /** File name used as placeholder; the packer's ImageReplacer replaces `{referenceId}` with `rId{N}` */
2895
- readonly referenceId: string;
3539
+ referenceId: string;
2896
3540
  /** Image type for SVG detection */
2897
- readonly type?: "svg" | string;
3541
+ type?: "svg" | string;
2898
3542
  /** For SVG images, the fallback image file name */
2899
- readonly fallbackFileName?: string;
3543
+ fallbackFileName?: string;
2900
3544
  }
2901
3545
  /**
2902
3546
  * Creates a blip element for an image.
@@ -2940,9 +3584,9 @@ interface BlipOptions {
2940
3584
  *
2941
3585
  * @param options - Blip options including referenceId and type
2942
3586
  * @param blipEffects - Optional blip effects (brightness, contrast, etc.)
2943
- * @returns An XML component representing the blip element
3587
+ * @returns An XML string representing the blip element
2944
3588
  */
2945
- declare const createBlip: (options: BlipOptions, blipEffects?: BlipEffectsOptions) => XmlComponent;
3589
+ declare const createBlip: (options: BlipOptions, blipEffects?: BlipEffectsOptions) => string;
2946
3590
  //#endregion
2947
3591
  //#region src/drawingml/blip/blip-fill.d.ts
2948
3592
  /**
@@ -2950,15 +3594,15 @@ declare const createBlip: (options: BlipOptions, blipEffects?: BlipEffectsOption
2950
3594
  */
2951
3595
  interface BlipFillOptions {
2952
3596
  /** DPI of the image */
2953
- readonly dpi?: number;
3597
+ dpi?: number;
2954
3598
  /** Whether the fill rotates with the shape */
2955
- readonly rotWithShape?: boolean;
3599
+ rotWithShape?: boolean;
2956
3600
  /** Image adjustment effects (brightness, contrast, grayscale, etc.) */
2957
- readonly blipEffects?: BlipEffectsOptions;
3601
+ blipEffects?: BlipEffectsOptions;
2958
3602
  /** Source rectangle for cropping */
2959
- readonly srcRect?: SourceRectangleOptions;
3603
+ srcRect?: SourceRectangleOptions;
2960
3604
  /** Tile fill mode (if omitted, defaults to stretch) */
2961
- readonly tile?: TileOptions;
3605
+ tile?: TileOptions;
2962
3606
  }
2963
3607
  /**
2964
3608
  * Creates a blip fill element.
@@ -2983,8 +3627,9 @@ interface BlipFillOptions {
2983
3627
  *
2984
3628
  * @param blipOptions - Blip options including referenceId and type
2985
3629
  * @param fillOptions - Optional blip fill options
3630
+ * @returns An XML string representing the blip fill element
2986
3631
  */
2987
- declare const createBlipFill: (blipOptions: BlipOptions, fillOptions?: BlipFillOptions) => XmlComponent;
3632
+ declare const createBlipFill: (blipOptions: BlipOptions, fillOptions?: BlipFillOptions) => string;
2988
3633
  //#endregion
2989
3634
  //#region src/drawingml/blip/blip-extentions.d.ts
2990
3635
  /**
@@ -3003,53 +3648,36 @@ declare const createBlipFill: (blipOptions: BlipOptions, fillOptions?: BlipFillO
3003
3648
  * ```
3004
3649
  *
3005
3650
  * @param svgReferenceId - The reference ID for the SVG image
3006
- * @returns An XML component representing the extension list
3651
+ * @returns An XML string representing the extension list
3007
3652
  */
3008
- declare const createExtentionList: (svgReferenceId: string) => XmlComponent;
3653
+ declare const createExtentionList: (svgReferenceId: string) => string;
3009
3654
  //#endregion
3010
3655
  //#region src/drawingml/blip/stretch.d.ts
3011
3656
  /**
3012
- * Represents a stretch fill mode for blip fills.
3657
+ * Stretch fill stringifier for blip fills.
3013
3658
  *
3014
- * This element specifies that the blip (image) should be stretched to fill
3015
- * the entire shape. The stretch fill is one of the fill mode properties
3016
- * that determines how an image is applied to a shape.
3017
- *
3018
- * Reference: http://officeopenxml.com/drwPic.php
3019
- *
3020
- * ## XSD Schema
3021
- * ```xml
3022
- * <xsd:complexType name="CT_StretchInfoProperties">
3023
- * <xsd:sequence>
3024
- * <xsd:element name="fillRect" type="CT_RelativeRect" minOccurs="0" maxOccurs="1"/>
3025
- * </xsd:sequence>
3026
- * </xsd:complexType>
3027
- * ```
3028
- *
3029
- * @example
3030
- * ```typescript
3031
- * const stretch = new Stretch();
3032
- * ```
3659
+ * @module
3033
3660
  */
3034
- declare class Stretch extends XmlComponent {
3035
- constructor();
3036
- }
3661
+ /**
3662
+ * Build a:stretch XML string with a:fillRect child.
3663
+ */
3664
+ declare function stringifyStretch(): string;
3037
3665
  //#endregion
3038
3666
  //#region src/drawingml/transform.d.ts
3039
3667
  interface Transform2DOptions {
3040
- readonly x?: number;
3041
- readonly y?: number;
3042
- readonly width?: number;
3043
- readonly height?: number;
3044
- readonly flipHorizontal?: boolean;
3045
- readonly flipVertical?: boolean;
3046
- readonly rotation?: number;
3668
+ x?: number | UniversalMeasure;
3669
+ y?: number | UniversalMeasure;
3670
+ width?: number | UniversalMeasure;
3671
+ height?: number | UniversalMeasure;
3672
+ flipHorizontal?: boolean;
3673
+ flipVertical?: boolean;
3674
+ rotation?: number;
3047
3675
  }
3048
3676
  interface GroupTransform2DOptions extends Transform2DOptions {
3049
- readonly childOffsetX?: number;
3050
- readonly childOffsetY?: number;
3051
- readonly childExtentWidth?: number;
3052
- readonly childExtentHeight?: number;
3677
+ childOffsetX?: number | UniversalMeasure;
3678
+ childOffsetY?: number | UniversalMeasure;
3679
+ childExtentWidth?: number | UniversalMeasure;
3680
+ childExtentHeight?: number | UniversalMeasure;
3053
3681
  }
3054
3682
  /**
3055
3683
  * Creates a 2D transform element (a:xfrm).
@@ -3057,43 +3685,43 @@ interface GroupTransform2DOptions extends Transform2DOptions {
3057
3685
  * @param options - Transform options including position, size, rotation, and flip.
3058
3686
  * @param elementName - Element name, defaults to "a:xfrm".
3059
3687
  */
3060
- declare const createTransform2D: (options: Transform2DOptions, elementName?: string) => XmlComponent;
3688
+ declare const createTransform2D: (options: Transform2DOptions, elementName?: string) => string;
3061
3689
  /**
3062
3690
  * Creates a group transform element (a:xfrm with chOff/chExt children).
3063
3691
  */
3064
- declare const createGroupTransform2D: (options: GroupTransform2DOptions, elementName?: string) => XmlComponent;
3692
+ declare const createGroupTransform2D: (options: GroupTransform2DOptions, elementName?: string) => string;
3065
3693
  //#endregion
3066
3694
  //#region src/drawingml/media/transformation.d.ts
3067
3695
  /**
3068
3696
  * Internal media data transformation with both pixel and EMU values.
3069
3697
  */
3070
3698
  interface MediaDataTransformation {
3071
- readonly offset?: {
3072
- readonly pixels: {
3073
- readonly x: number;
3074
- readonly y: number;
3699
+ offset?: {
3700
+ pixels: {
3701
+ x: number;
3702
+ y: number;
3075
3703
  };
3076
- readonly emus?: {
3077
- readonly x: number;
3078
- readonly y: number;
3704
+ emus?: {
3705
+ x: number;
3706
+ y: number;
3079
3707
  };
3080
3708
  };
3081
- readonly pixels: {
3082
- /** Width in pixels */readonly x: number; /** Height in pixels */
3083
- readonly y: number;
3709
+ pixels: {
3710
+ /** Width in pixels */x: number; /** Height in pixels */
3711
+ y: number;
3084
3712
  };
3085
3713
  /** Display dimensions in EMUs (English Metric Units) */
3086
- readonly emus: {
3087
- /** Width in EMUs (1 inch = 914400 EMUs) */readonly x: number; /** Height in EMUs (1 inch = 914400 EMUs) */
3088
- readonly y: number;
3714
+ emus: {
3715
+ /** Width in EMUs (1 inch = 914400 EMUs) */x: number; /** Height in EMUs (1 inch = 914400 EMUs) */
3716
+ y: number;
3089
3717
  };
3090
3718
  /** Optional flip transformations */
3091
- readonly flip?: {
3092
- /** Whether to flip the image vertically */readonly vertical?: boolean; /** Whether to flip the image horizontally */
3093
- readonly horizontal?: boolean;
3719
+ flip?: {
3720
+ /** Whether to flip the image vertically */vertical?: boolean; /** Whether to flip the image horizontally */
3721
+ horizontal?: boolean;
3094
3722
  };
3095
3723
  /** Optional rotation angle in degrees */
3096
- readonly rotation?: number;
3724
+ rotation?: number;
3097
3725
  }
3098
3726
  /**
3099
3727
  * Transformation options for media display.
@@ -3101,20 +3729,20 @@ interface MediaDataTransformation {
3101
3729
  * Specifies how an image should be transformed when displayed in the document.
3102
3730
  */
3103
3731
  interface MediaTransformation {
3104
- readonly offset?: {
3105
- readonly top?: number;
3106
- readonly left?: number;
3732
+ offset?: {
3733
+ top?: number;
3734
+ left?: number;
3107
3735
  };
3108
- readonly width: number;
3736
+ width: number;
3109
3737
  /** Display height in pixels */
3110
- readonly height: number;
3738
+ height: number;
3111
3739
  /** Optional flip transformations */
3112
- readonly flip?: {
3113
- /** Whether to flip the image vertically */readonly vertical?: boolean; /** Whether to flip the image horizontally */
3114
- readonly horizontal?: boolean;
3740
+ flip?: {
3741
+ /** Whether to flip the image vertically */vertical?: boolean; /** Whether to flip the image horizontally */
3742
+ horizontal?: boolean;
3115
3743
  };
3116
3744
  /** Optional rotation angle in degrees */
3117
- readonly rotation?: number;
3745
+ rotation?: number;
3118
3746
  }
3119
3747
  /**
3120
3748
  * Converts user-facing transformation options (pixels) to internal
@@ -3130,1107 +3758,166 @@ type TableStyleRegion = "tblBg" | "wholeTbl" | "band1H" | "band2H" | "band1V" |
3130
3758
  type OnOffStyleType = "on" | "off" | "def";
3131
3759
  interface TablePartStyleOptions {
3132
3760
  /** Cell text style */
3133
- readonly text?: TableTextStyleOptions;
3761
+ text?: TableTextStyleOptions;
3134
3762
  /** Cell style (fill, borders, 3D) */
3135
- readonly cell?: TableCellStyleOptions;
3763
+ cell?: TableCellStyleOptions;
3136
3764
  }
3137
3765
  interface TableTextStyleOptions {
3138
3766
  /** Bold style */
3139
- readonly bold?: OnOffStyleType;
3767
+ bold?: OnOffStyleType;
3140
3768
  /** Italic style */
3141
- readonly italic?: OnOffStyleType;
3769
+ italic?: OnOffStyleType;
3142
3770
  /** Font reference (themeable) */
3143
- readonly fontRef?: StyleMatrixReferenceOptions;
3771
+ fontRef?: StyleMatrixReferenceOptions;
3144
3772
  /** Color element */
3145
- readonly color?: XmlComponent;
3773
+ color?: string;
3146
3774
  }
3147
3775
  interface TableCellStyleOptions {
3148
3776
  /** Cell borders */
3149
- readonly borders?: TableCellBorderOptions;
3777
+ borders?: TableCellBorderOptions;
3150
3778
  /** Fill reference (themeable) */
3151
- readonly fillRef?: StyleMatrixReferenceOptions;
3779
+ fillRef?: StyleMatrixReferenceOptions;
3152
3780
  /** Direct fill */
3153
- readonly fill?: XmlComponent;
3781
+ fill?: string;
3154
3782
  }
3155
3783
  interface TableCellBorderOptions {
3156
- readonly left?: ThemeableLineStyleOptions;
3157
- readonly right?: ThemeableLineStyleOptions;
3158
- readonly top?: ThemeableLineStyleOptions;
3159
- readonly bottom?: ThemeableLineStyleOptions;
3160
- readonly insideH?: ThemeableLineStyleOptions;
3161
- readonly insideV?: ThemeableLineStyleOptions;
3784
+ left?: ThemeableLineStyleOptions;
3785
+ right?: ThemeableLineStyleOptions;
3786
+ top?: ThemeableLineStyleOptions;
3787
+ bottom?: ThemeableLineStyleOptions;
3788
+ insideH?: ThemeableLineStyleOptions;
3789
+ insideV?: ThemeableLineStyleOptions;
3162
3790
  }
3163
3791
  interface ThemeableLineStyleOptions {
3164
3792
  /** Line width in EMUs */
3165
- readonly width?: number;
3793
+ width?: number;
3166
3794
  /** Fill color component */
3167
- readonly color?: XmlComponent;
3795
+ color?: string;
3168
3796
  /** Line reference index into theme style matrix */
3169
- readonly lineRefIdx?: number;
3797
+ lineRefIdx?: number;
3170
3798
  }
3171
3799
  interface StyleMatrixReferenceOptions {
3172
3800
  /** Index into the theme style matrix */
3173
- readonly idx: number;
3801
+ idx: number;
3174
3802
  /** Color component */
3175
- readonly color?: XmlComponent;
3803
+ color?: string;
3176
3804
  }
3177
3805
  interface TableStyleOptions {
3178
3806
  /** Unique GUID for this style */
3179
- readonly styleId: string;
3807
+ styleId: string;
3180
3808
  /** Display name */
3181
- readonly styleName: string;
3809
+ styleName: string;
3182
3810
  /** Style regions */
3183
- readonly regions?: Partial<Record<TableStyleRegion, TablePartStyleOptions>>;
3811
+ regions?: Partial<Record<TableStyleRegion, TablePartStyleOptions>>;
3184
3812
  }
3185
3813
  interface TableStyleListOptions {
3186
3814
  /** Default style GUID */
3187
- readonly defaultStyleId: string;
3815
+ defaultStyleId: string;
3188
3816
  /** Custom table styles */
3189
- readonly styles?: readonly TableStyleOptions[];
3817
+ styles?: readonly TableStyleOptions[];
3190
3818
  }
3191
3819
  /** Create a single table style (CT_TableStyle) */
3192
- declare function createTableStyle(opts: TableStyleOptions): BuilderElement;
3820
+ declare function createTableStyle(opts: TableStyleOptions): string;
3193
3821
  /** Create table style list (CT_TableStyleList) */
3194
- declare function createTableStyleList(opts: TableStyleListOptions): BuilderElement;
3822
+ declare function createTableStyleList(opts: TableStyleListOptions): string;
3195
3823
  //#endregion
3196
3824
  //#region src/drawingml/locking/locking.d.ts
3197
3825
  interface BaseLockingOptions {
3198
3826
  /** Prevent grouping */
3199
- readonly noGrp?: boolean;
3827
+ noGrp?: boolean;
3200
3828
  /** Prevent selection */
3201
- readonly noSelect?: boolean;
3829
+ noSelect?: boolean;
3202
3830
  /** Prevent rotation */
3203
- readonly noRot?: boolean;
3831
+ noRot?: boolean;
3204
3832
  /** Prevent aspect ratio change */
3205
- readonly noChangeAspect?: boolean;
3833
+ noChangeAspect?: boolean;
3206
3834
  /** Prevent moving */
3207
- readonly noMove?: boolean;
3835
+ noMove?: boolean;
3208
3836
  /** Prevent resizing */
3209
- readonly noResize?: boolean;
3837
+ noResize?: boolean;
3210
3838
  /** Prevent edit points */
3211
- readonly noEditPoints?: boolean;
3839
+ noEditPoints?: boolean;
3212
3840
  /** Prevent adjust handles */
3213
- readonly noAdjustHandles?: boolean;
3841
+ noAdjustHandles?: boolean;
3214
3842
  /** Prevent changing arrowheads */
3215
- readonly noChangeArrowheads?: boolean;
3843
+ noChangeArrowheads?: boolean;
3216
3844
  /** Prevent changing shape type */
3217
- readonly noChangeShapeType?: boolean;
3845
+ noChangeShapeType?: boolean;
3218
3846
  }
3219
3847
  interface ShapeLockingOptions extends BaseLockingOptions {
3220
3848
  /** Prevent text editing */
3221
- readonly noTextEdit?: boolean;
3849
+ noTextEdit?: boolean;
3222
3850
  }
3223
3851
  interface PictureLockingOptions extends BaseLockingOptions {
3224
3852
  /** Prevent cropping */
3225
- readonly noCrop?: boolean;
3853
+ noCrop?: boolean;
3226
3854
  }
3227
3855
  interface GroupLockingOptions {
3228
- readonly noGrp?: boolean;
3229
- readonly noUngrp?: boolean;
3230
- readonly noSelect?: boolean;
3231
- readonly noRot?: boolean;
3232
- readonly noChangeAspect?: boolean;
3233
- readonly noMove?: boolean;
3234
- readonly noResize?: boolean;
3856
+ noGrp?: boolean;
3857
+ noUngrp?: boolean;
3858
+ noSelect?: boolean;
3859
+ noRot?: boolean;
3860
+ noChangeAspect?: boolean;
3861
+ noMove?: boolean;
3862
+ noResize?: boolean;
3235
3863
  }
3236
3864
  interface GraphicFrameLockingOptions {
3237
- readonly noGrp?: boolean;
3238
- readonly noDrilldown?: boolean;
3239
- readonly noSelect?: boolean;
3240
- readonly noChangeAspect?: boolean;
3241
- readonly noMove?: boolean;
3242
- readonly noResize?: boolean;
3243
- }
3244
- declare function createShapeLocking(opts: ShapeLockingOptions): BuilderElement;
3245
- declare function createPictureLocking(opts: PictureLockingOptions): BuilderElement;
3246
- declare function createGroupLocking(opts: GroupLockingOptions): BuilderElement;
3247
- declare function createGraphicFrameLocking(opts: GraphicFrameLockingOptions): BuilderElement;
3248
- //#endregion
3249
- //#region src/drawingml/chart-drawing/chart-drawing.d.ts
3250
- /**
3251
- * Creates a cdr:x element (Marker X Coordinate).
3252
- *
3253
- * ## XSD Schema
3254
- * ```xml
3255
- * <xsd:element name="x" type="ST_MarkerCoordinate"/>
3256
- * ```
3257
- */
3258
- declare const createCdrX: (value: number) => XmlComponent;
3259
- /**
3260
- * Creates a cdr:y element (Marker Y Coordinate).
3261
- *
3262
- * ## XSD Schema
3263
- * ```xml
3264
- * <xsd:element name="y" type="ST_MarkerCoordinate"/>
3265
- * ```
3266
- */
3267
- declare const createCdrY: (value: number) => XmlComponent;
3268
- /**
3269
- * Creates a cdr:from element (Marker - top-left corner).
3270
- *
3271
- * ## XSD Schema
3272
- * ```xml
3273
- * <xsd:element name="from" type="CT_Marker"/>
3274
- * ```
3275
- */
3276
- declare const createCdrFrom: (x: number, y: number) => XmlComponent;
3277
- /**
3278
- * Creates a cdr:to element (Marker - bottom-right corner).
3279
- *
3280
- * ## XSD Schema
3281
- * ```xml
3282
- * <xsd:element name="to" type="CT_Marker"/>
3283
- * ```
3284
- */
3285
- declare const createCdrTo: (x: number, y: number) => XmlComponent;
3286
- /**
3287
- * Creates a cdr:ext element (Positive Size 2D).
3288
- *
3289
- * ## XSD Schema
3290
- * ```xml
3291
- * <xsd:element name="ext" type="a:CT_PositiveSize2D"/>
3292
- * ```
3293
- */
3294
- declare const createCdrExt: (options: {
3295
- readonly cx: number;
3296
- readonly cy: number;
3297
- }) => XmlComponent;
3298
- /**
3299
- * Creates a cdr:cNvPr element (Non-Visual Drawing Properties).
3300
- *
3301
- * ## XSD Schema
3302
- * ```xml
3303
- * <xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps"/>
3304
- * ```
3305
- */
3306
- declare const createCdrCNvPr: (options: {
3307
- readonly id?: number;
3308
- readonly name?: string;
3309
- }) => XmlComponent;
3310
- /**
3311
- * Creates a cdr:cNvSpPr element (Non-Visual Drawing Shape Properties).
3312
- *
3313
- * ## XSD Schema
3314
- * ```xml
3315
- * <xsd:element name="cNvSpPr" type="a:CT_NonVisualDrawingShapeProps"/>
3316
- * ```
3317
- */
3318
- declare const createCdrCNvSpPr: () => XmlComponent;
3319
- /**
3320
- * Creates a cdr:cNvCxnSpPr element (Non-Visual Connector Properties).
3321
- *
3322
- * ## XSD Schema
3323
- * ```xml
3324
- * <xsd:element name="cNvCxnSpPr" type="a:CT_NonVisualConnectorProperties"/>
3325
- * ```
3326
- */
3327
- declare const createCdrCNvCxnSpPr: () => XmlComponent;
3328
- /**
3329
- * Creates a cdr:cNvPicPr element (Non-Visual Picture Properties).
3330
- *
3331
- * ## XSD Schema
3332
- * ```xml
3333
- * <xsd:element name="cNvPicPr" type="a:CT_NonVisualPictureProperties"/>
3334
- * ```
3335
- */
3336
- declare const createCdrCNvPicPr: () => XmlComponent;
3337
- /**
3338
- * Creates a cdr:cNvGrpSpPr element (Non-Visual Group Shape Properties).
3339
- *
3340
- * ## XSD Schema
3341
- * ```xml
3342
- * <xsd:element name="cNvGrpSpPr" type="a:CT_NonVisualGroupDrawingShapeProps"/>
3343
- * ```
3344
- */
3345
- declare const createCdrCNvGrpSpPr: () => XmlComponent;
3346
- /**
3347
- * Creates a cdr:cNvGraphicFramePr element (Non-Visual Graphic Frame Properties).
3348
- *
3349
- * ## XSD Schema
3350
- * ```xml
3351
- * <xsd:element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties"/>
3352
- * ```
3353
- */
3354
- declare const createCdrCNvGraphicFramePr: () => XmlComponent;
3355
- /**
3356
- * Creates a cdr:nvSpPr element (Shape Non-Visual Properties).
3357
- *
3358
- * ## XSD Schema
3359
- * ```xml
3360
- * <xsd:element name="nvSpPr" type="CT_ShapeNonVisual"/>
3361
- * ```
3362
- */
3363
- declare const createCdrNvSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3364
- /**
3365
- * Creates a cdr:nvCxnSpPr element (Connector Non-Visual Properties).
3366
- *
3367
- * ## XSD Schema
3368
- * ```xml
3369
- * <xsd:element name="nvCxnSpPr" type="CT_ConnectorNonVisual"/>
3370
- * ```
3371
- */
3372
- declare const createCdrNvCxnSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3373
- /**
3374
- * Creates a cdr:nvPicPr element (Picture Non-Visual Properties).
3375
- *
3376
- * ## XSD Schema
3377
- * ```xml
3378
- * <xsd:element name="nvPicPr" type="CT_PictureNonVisual"/>
3379
- * ```
3380
- */
3381
- declare const createCdrNvPicPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3382
- /**
3383
- * Creates a cdr:nvGrpSpPr element (Group Shape Non-Visual Properties).
3384
- *
3385
- * ## XSD Schema
3386
- * ```xml
3387
- * <xsd:element name="nvGrpSpPr" type="CT_GroupShapeNonVisual"/>
3388
- * ```
3389
- */
3390
- declare const createCdrNvGrpSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3391
- /**
3392
- * Creates a cdr:nvGraphicFramePr element (Graphic Frame Non-Visual Properties).
3393
- *
3394
- * ## XSD Schema
3395
- * ```xml
3396
- * <xsd:element name="nvGraphicFramePr" type="CT_GraphicFrameNonVisual"/>
3397
- * ```
3398
- */
3399
- declare const createCdrNvGraphicFramePr: (children?: readonly IXmlableObject[]) => XmlComponent;
3400
- /**
3401
- * Creates a cdr:sp element (Shape).
3402
- *
3403
- * ## XSD Schema
3404
- * ```xml
3405
- * <xsd:element name="sp" type="CT_Shape"/>
3406
- * ```
3407
- */
3408
- declare const createCdrSp: (children?: readonly IXmlableObject[]) => XmlComponent;
3409
- /**
3410
- * Creates a cdr:cxnSp element (Connector Shape).
3411
- *
3412
- * ## XSD Schema
3413
- * ```xml
3414
- * <xsd:element name="cxnSp" type="CT_Connector"/>
3415
- * ```
3416
- */
3417
- declare const createCdrCxnSp: (children?: readonly IXmlableObject[]) => XmlComponent;
3418
- /**
3419
- * Creates a cdr:pic element (Picture).
3420
- *
3421
- * ## XSD Schema
3422
- * ```xml
3423
- * <xsd:element name="pic" type="CT_Picture"/>
3424
- * ```
3425
- */
3426
- declare const createCdrPic: (children?: readonly IXmlableObject[]) => XmlComponent;
3427
- /**
3428
- * Creates a cdr:grpSp element (Group Shape).
3429
- *
3430
- * ## XSD Schema
3431
- * ```xml
3432
- * <xsd:element name="grpSp" type="CT_GroupShape"/>
3433
- * ```
3434
- */
3435
- declare const createCdrGrpSp: (children?: readonly IXmlableObject[]) => XmlComponent;
3436
- /**
3437
- * Creates a cdr:graphicFrame element (Graphic Frame).
3438
- *
3439
- * ## XSD Schema
3440
- * ```xml
3441
- * <xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
3442
- * ```
3443
- */
3444
- declare const createCdrGraphicFrame: (children?: readonly IXmlableObject[]) => XmlComponent;
3445
- /**
3446
- * Creates a cdr:spPr element (Shape Properties).
3447
- *
3448
- * ## XSD Schema
3449
- * ```xml
3450
- * <xsd:element name="spPr" type="a:CT_ShapeProperties"/>
3451
- * ```
3452
- */
3453
- declare const createCdrSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3454
- /**
3455
- * Creates a cdr:grpSpPr element (Group Shape Properties).
3456
- *
3457
- * ## XSD Schema
3458
- * ```xml
3459
- * <xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties"/>
3460
- * ```
3461
- */
3462
- declare const createCdrGrpSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3463
- /**
3464
- * Creates a cdr:style element (Shape Style).
3465
- *
3466
- * ## XSD Schema
3467
- * ```xml
3468
- * <xsd:element name="style" type="a:CT_ShapeStyle"/>
3469
- * ```
3470
- */
3471
- declare const createCdrStyle: () => XmlComponent;
3472
- /**
3473
- * Creates a cdr:txBody element (Text Body).
3474
- *
3475
- * ## XSD Schema
3476
- * ```xml
3477
- * <xsd:element name="txBody" type="a:CT_TextBody"/>
3478
- * ```
3479
- */
3480
- declare const createCdrTxBody: (children?: readonly IXmlableObject[]) => XmlComponent;
3481
- /**
3482
- * Creates a cdr:blipFill element (Blip Fill).
3483
- *
3484
- * ## XSD Schema
3485
- * ```xml
3486
- * <xsd:element name="blipFill" type="a:CT_BlipFillProperties"/>
3487
- * ```
3488
- */
3489
- declare const createCdrBlipFill: (children?: readonly IXmlableObject[]) => XmlComponent;
3490
- /**
3491
- * Creates a cdr:xfrm element (2D Transform).
3492
- *
3493
- * ## XSD Schema
3494
- * ```xml
3495
- * <xsd:element name="xfrm" type="a:CT_Transform2D"/>
3496
- * ```
3497
- */
3498
- declare const createCdrXfrm: (children?: readonly IXmlableObject[]) => XmlComponent;
3499
- /**
3500
- * Creates a cdr:relSizeAnchor element (Relative Size Anchor).
3501
- *
3502
- * ## XSD Schema
3503
- * ```xml
3504
- * <xsd:element name="relSizeAnchor" type="CT_RelSizeAnchor"/>
3505
- * ```
3506
- */
3507
- declare const createCdrRelSizeAnchor: (children?: readonly IXmlableObject[]) => XmlComponent;
3508
- /**
3509
- * Creates a cdr:absSizeAnchor element (Absolute Size Anchor).
3510
- *
3511
- * ## XSD Schema
3512
- * ```xml
3513
- * <xsd:element name="absSizeAnchor" type="CT_AbsSizeAnchor"/>
3514
- * ```
3515
- */
3516
- declare const createCdrAbsSizeAnchor: (children?: readonly IXmlableObject[]) => XmlComponent;
3517
- //#endregion
3518
- //#region src/drawingml/chart/dml-chart-elements.d.ts
3519
- declare const createApplyToEnd: () => XmlComponent;
3520
- declare const createApplyToFront: () => XmlComponent;
3521
- declare const createApplyToSides: () => XmlComponent;
3522
- declare const createAutoUpdate: () => XmlComponent;
3523
- declare const createBubble3D: () => XmlComponent;
3524
- declare const createInvertIfNegative: () => XmlComponent;
3525
- declare const createPlotVisOnly: () => XmlComponent;
3526
- declare const createShowDLblsOverMax: () => XmlComponent;
3527
- declare const createShowNegBubbles: () => XmlComponent;
3528
- declare const createShowLeaderLines: () => XmlComponent;
3529
- declare const createSmooth: () => XmlComponent;
3530
- declare const createExplosion: (val: number) => XmlComponent;
3531
- declare const createFmtId: (val: number) => XmlComponent;
3532
- declare const createSize: (val: number) => XmlComponent;
3533
- declare const createBubbleScale: (val: number | string) => XmlComponent;
3534
- declare const createCrossesAt: (val: number) => XmlComponent;
3535
- declare const createCustUnit: (val: number) => XmlComponent;
3536
- declare const createGapDepth: (val: number | string) => XmlComponent;
3537
- declare const createGapWidth: (val: number | string) => XmlComponent;
3538
- declare const createH: (val: number) => XmlComponent;
3539
- declare const createHoleSize: (val: number | string) => XmlComponent;
3540
- declare const createLogBase: (val: number) => XmlComponent;
3541
- declare const createMajorUnit: (val: number) => XmlComponent;
3542
- declare const createMax: (val: number) => XmlComponent;
3543
- declare const createMin: (val: number) => XmlComponent;
3544
- declare const createMinorUnit: (val: number) => XmlComponent;
3545
- declare const createOverlap: (val: number | string) => XmlComponent;
3546
- declare const createSecondPieSize: (val: number | string) => XmlComponent;
3547
- declare const createSplitPos: (val: number) => XmlComponent;
3548
- declare const createW: (val: number) => XmlComponent;
3549
- declare const createX: (val: number) => XmlComponent;
3550
- declare const createY: (val: number) => XmlComponent;
3551
- declare const createBaseTimeUnit: (val: string) => XmlComponent;
3552
- declare const createBuiltInUnit: (val: string) => XmlComponent;
3553
- declare const createCrossBetween: (val: string) => XmlComponent;
3554
- declare const createDispBlanksAs: (val: string) => XmlComponent;
3555
- declare const createHMode: (val: string) => XmlComponent;
3556
- declare const createLayoutTarget: (val: string) => XmlComponent;
3557
- declare const createLblAlgn: (val: string) => XmlComponent;
3558
- declare const createMajorTickMark: (val: string) => XmlComponent;
3559
- declare const createMajorTimeUnit: (val: string) => XmlComponent;
3560
- declare const createMinorTickMark: (val: string) => XmlComponent;
3561
- declare const createMinorTimeUnit: (val: string) => XmlComponent;
3562
- declare const createOfPieType: (val: string) => XmlComponent;
3563
- declare const createPictureFormat: (val: string) => XmlComponent;
3564
- declare const createPictureStackUnit: (val: number) => XmlComponent;
3565
- declare const createShape: (val: string) => XmlComponent;
3566
- declare const createSizeRepresents: (val: string) => XmlComponent;
3567
- declare const createSplitType: (val: string) => XmlComponent;
3568
- declare const createSymbol: (val: string) => XmlComponent;
3569
- declare const createTickLblPos: (val: string) => XmlComponent;
3570
- declare const createTickMarkSkip: (val: number) => XmlComponent;
3571
- declare const createThickness: (val: number | string) => XmlComponent;
3572
- declare const createWMode: (val: string) => XmlComponent;
3573
- declare const createXMode: (val: string) => XmlComponent;
3574
- declare const createYMode: (val: string) => XmlComponent;
3575
- declare const createName: (val: string) => XmlComponent;
3576
- declare const createBackWall: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3577
- declare const createBandFmt: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3578
- declare const createBandFmts: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3579
- declare const createChartObject: () => XmlComponent;
3580
- declare const createClrMapOvr: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3581
- declare const createCustSplit: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3582
- declare const createDLbl: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3583
- declare const createDPt: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3584
- declare const createDTable: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3585
- declare const createData: () => XmlComponent;
3586
- declare const createDispUnits: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3587
- declare const createDispUnitsLbl: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3588
- declare const createDownBars: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3589
- declare const createEvenFooter: (val: string) => XmlComponent;
3590
- declare const createEvenHeader: (val: string) => XmlComponent;
3591
- declare const createExt: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3592
- declare const createExtLst: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3593
- declare const createExternalData: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3594
- declare const createFirstFooter: (val: string) => XmlComponent;
3595
- declare const createFirstHeader: (val: string) => XmlComponent;
3596
- declare const createFloor: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3597
- declare const createFormatting: () => XmlComponent;
3598
- interface HeaderFooterOptions {
3599
- readonly alignWithMargins?: boolean;
3600
- readonly differentOddEven?: boolean;
3601
- readonly differentFirst?: boolean;
3602
- }
3603
- declare const createHeaderFooter: (children?: readonly (IXmlableObject | XmlComponent)[], options?: HeaderFooterOptions) => XmlComponent;
3604
- declare const createHiLowLines: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3605
- declare const createLeaderLines: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3606
- declare const createLegacyDrawingHF: () => XmlComponent;
3607
- declare const createLegendEntry: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3608
- declare const createLvl: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3609
- declare const createMajorGridlines: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3610
- declare const createManualLayout: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3611
- declare const createMarker: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3612
- declare const createMinorGridlines: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3613
- declare const createMinus: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3614
- declare const createMultiLvlStrCache: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3615
- declare const createMultiLvlStrRef: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3616
- declare const createNumLit: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3617
- declare const createOddFooter: (val: string) => XmlComponent;
3618
- declare const createOddHeader: (val: string) => XmlComponent;
3619
- declare const createOfPieChart: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3620
- interface PageMarginsOptions {
3621
- readonly l: number;
3622
- readonly r: number;
3623
- readonly t: number;
3624
- readonly b: number;
3625
- readonly header: number;
3626
- readonly footer: number;
3627
- }
3628
- declare const createPageMargins: (options: PageMarginsOptions) => XmlComponent;
3629
- interface PageSetupOptions {
3630
- readonly paperSize?: number;
3631
- readonly paperHeight?: string;
3632
- readonly paperWidth?: string;
3633
- readonly firstPageNumber?: number;
3634
- readonly orientation?: string;
3635
- readonly blackAndWhite?: boolean;
3636
- readonly draft?: boolean;
3637
- readonly useFirstPageNumber?: boolean;
3638
- readonly horizontalDpi?: number;
3639
- readonly verticalDpi?: number;
3640
- readonly copies?: number;
3641
- }
3642
- declare const createPageSetup: (options?: PageSetupOptions) => XmlComponent;
3643
- declare const createPictureOptions: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3644
- declare const createPivotFmt: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3645
- declare const createPivotFmts: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3646
- declare const createPivotSource: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3647
- declare const createPlus: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3648
- declare const createPrintSettings: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3649
- declare const createProtection: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3650
- declare const createSecondPiePt: (val: number) => XmlComponent;
3651
- declare const createSelection: () => XmlComponent;
3652
- declare const createSerLines: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3653
- declare const createShowHorzBorder: () => XmlComponent;
3654
- declare const createShowKeys: () => XmlComponent;
3655
- declare const createShowOutline: () => XmlComponent;
3656
- declare const createShowVertBorder: () => XmlComponent;
3657
- declare const createSideWall: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3658
- declare const createStrLit: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3659
- declare const createSurface3DChart: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3660
- declare const createTrendlineLbl: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3661
- declare const createUpBars: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3662
- declare const createUpDownBars: (children?: readonly (IXmlableObject | XmlComponent)[]) => XmlComponent;
3663
- declare const createUserInterface: () => XmlComponent;
3664
- declare const createUserShapes: () => XmlComponent;
3665
- //#endregion
3666
- //#region src/drawingml/spreadsheet-drawing/spreadsheet-drawing.d.ts
3667
- interface XdrMarkerOptions {
3668
- readonly col: number;
3669
- readonly colOff: number;
3670
- readonly row: number;
3671
- readonly rowOff: number;
3672
- }
3673
- /**
3674
- * Creates an xdr:col element (Column ID).
3675
- *
3676
- * ## XSD Schema
3677
- * ```xml
3678
- * <xsd:element name="col" type="ST_ColID"/>
3679
- * ```
3680
- */
3681
- declare const createXdrCol: (value: number) => XmlComponent;
3682
- /**
3683
- * Creates an xdr:colOff element (Column Offset).
3684
- *
3685
- * ## XSD Schema
3686
- * ```xml
3687
- * <xsd:element name="colOff" type="a:ST_Coordinate"/>
3688
- * ```
3689
- */
3690
- declare const createXdrColOff: (value: number) => XmlComponent;
3691
- /**
3692
- * Creates an xdr:row element (Row ID).
3693
- *
3694
- * ## XSD Schema
3695
- * ```xml
3696
- * <xsd:element name="row" type="ST_RowID"/>
3697
- * ```
3698
- */
3699
- declare const createXdrRow: (value: number) => XmlComponent;
3700
- /**
3701
- * Creates an xdr:rowOff element (Row Offset).
3702
- *
3703
- * ## XSD Schema
3704
- * ```xml
3705
- * <xsd:element name="rowOff" type="a:ST_Coordinate"/>
3706
- * ```
3707
- */
3708
- declare const createXdrRowOff: (value: number) => XmlComponent;
3709
- /**
3710
- * Creates an xdr:from element (Marker - top-left corner).
3711
- *
3712
- * ## XSD Schema
3713
- * ```xml
3714
- * <xsd:element name="from" type="CT_Marker"/>
3715
- * ```
3716
- */
3717
- declare const createXdrFrom: (options: XdrMarkerOptions) => XmlComponent;
3718
- /**
3719
- * Creates an xdr:to element (Marker - bottom-right corner).
3720
- *
3721
- * ## XSD Schema
3722
- * ```xml
3723
- * <xsd:element name="to" type="CT_Marker"/>
3724
- * ```
3725
- */
3726
- declare const createXdrTo: (options: XdrMarkerOptions) => XmlComponent;
3727
- /**
3728
- * Creates an xdr:cNvPr element (Non-Visual Drawing Properties).
3729
- *
3730
- * ## XSD Schema
3731
- * ```xml
3732
- * <xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps"/>
3733
- * ```
3734
- */
3735
- declare const createXdrCNvPr: (options: {
3736
- readonly id?: number;
3737
- readonly name?: string;
3738
- }) => XmlComponent;
3739
- /**
3740
- * Creates an xdr:cNvSpPr element (Non-Visual Drawing Shape Properties).
3741
- *
3742
- * ## XSD Schema
3743
- * ```xml
3744
- * <xsd:element name="cNvSpPr" type="a:CT_NonVisualDrawingShapeProps"/>
3745
- * ```
3746
- */
3747
- declare const createXdrCNvSpPr: () => XmlComponent;
3748
- /**
3749
- * Creates an xdr:cNvCxnSpPr element (Non-Visual Connector Properties).
3750
- *
3751
- * ## XSD Schema
3752
- * ```xml
3753
- * <xsd:element name="cNvCxnSpPr" type="a:CT_NonVisualConnectorProperties"/>
3754
- * ```
3755
- */
3756
- declare const createXdrCNvCxnSpPr: () => XmlComponent;
3757
- /**
3758
- * Creates an xdr:cNvPicPr element (Non-Visual Picture Properties).
3759
- *
3760
- * ## XSD Schema
3761
- * ```xml
3762
- * <xsd:element name="cNvPicPr" type="a:CT_NonVisualPictureProperties"/>
3763
- * ```
3764
- */
3765
- declare const createXdrCNvPicPr: (options?: {
3766
- readonly preferRelativeResize?: boolean;
3767
- }) => XmlComponent;
3768
- /**
3769
- * Creates an xdr:cNvGrpSpPr element (Non-Visual Group Shape Properties).
3770
- *
3771
- * ## XSD Schema
3772
- * ```xml
3773
- * <xsd:element name="cNvGrpSpPr" type="a:CT_NonVisualGroupDrawingShapeProps"/>
3774
- * ```
3775
- */
3776
- declare const createXdrCNvGrpSpPr: () => XmlComponent;
3777
- /**
3778
- * Creates an xdr:nvSpPr element (Shape Non-Visual Properties).
3779
- *
3780
- * ## XSD Schema
3781
- * ```xml
3782
- * <xsd:element name="nvSpPr" type="CT_ShapeNonVisual"/>
3783
- * ```
3784
- */
3785
- declare const createXdrNvSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3786
- /**
3787
- * Creates an xdr:nvCxnSpPr element (Connector Non-Visual Properties).
3788
- *
3789
- * ## XSD Schema
3790
- * ```xml
3791
- * <xsd:element name="nvCxnSpPr" type="CT_ConnectorNonVisual"/>
3792
- * ```
3793
- */
3794
- declare const createXdrNvCxnSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3795
- /**
3796
- * Creates an xdr:nvPicPr element (Picture Non-Visual Properties).
3797
- *
3798
- * ## XSD Schema
3799
- * ```xml
3800
- * <xsd:element name="nvPicPr" type="CT_PictureNonVisual"/>
3801
- * ```
3802
- */
3803
- declare const createXdrNvPicPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3804
- /**
3805
- * Creates an xdr:nvGrpSpPr element (Group Shape Non-Visual Properties).
3806
- *
3807
- * ## XSD Schema
3808
- * ```xml
3809
- * <xsd:element name="nvGrpSpPr" type="CT_GroupShapeNonVisual"/>
3810
- * ```
3811
- */
3812
- declare const createXdrNvGrpSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3813
- interface XdrShapeAttributes {
3814
- readonly macro?: string;
3815
- readonly textlink?: string;
3816
- readonly fLocksText?: boolean;
3817
- readonly fPublished?: boolean;
3818
- }
3819
- /**
3820
- * Creates an xdr:sp element (Shape).
3821
- *
3822
- * ## XSD Schema
3823
- * ```xml
3824
- * <xsd:element name="sp" type="CT_Shape"/>
3825
- * ```
3826
- */
3827
- declare const createXdrSp: (options?: {
3828
- readonly attributes?: XdrShapeAttributes;
3829
- readonly children?: readonly IXmlableObject[];
3830
- }) => XmlComponent;
3831
- /**
3832
- * Creates an xdr:cxnSp element (Connector Shape).
3833
- *
3834
- * ## XSD Schema
3835
- * ```xml
3836
- * <xsd:element name="cxnSp" type="CT_Connector"/>
3837
- * ```
3838
- */
3839
- declare const createXdrCxnSp: (children?: readonly IXmlableObject[]) => XmlComponent;
3840
- /**
3841
- * Creates an xdr:pic element (Picture).
3842
- *
3843
- * ## XSD Schema
3844
- * ```xml
3845
- * <xsd:element name="pic" type="CT_Picture"/>
3846
- * ```
3847
- */
3848
- declare const createXdrPic: (children?: readonly IXmlableObject[]) => XmlComponent;
3849
- /**
3850
- * Creates an xdr:grpSp element (Group Shape).
3851
- *
3852
- * ## XSD Schema
3853
- * ```xml
3854
- * <xsd:element name="grpSp" type="CT_GroupShape"/>
3855
- * ```
3856
- */
3857
- declare const createXdrGrpSp: (children?: readonly IXmlableObject[]) => XmlComponent;
3858
- /**
3859
- * Creates an xdr:spPr element (Shape Properties).
3860
- *
3861
- * ## XSD Schema
3862
- * ```xml
3863
- * <xsd:element name="spPr" type="a:CT_ShapeProperties"/>
3864
- * ```
3865
- */
3866
- declare const createXdrSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3867
- /**
3868
- * Creates an xdr:grpSpPr element (Group Shape Properties).
3869
- *
3870
- * ## XSD Schema
3871
- * ```xml
3872
- * <xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties"/>
3873
- * ```
3874
- */
3875
- declare const createXdrGrpSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
3876
- /**
3877
- * Creates an xdr:style element (Shape Style).
3878
- *
3879
- * ## XSD Schema
3880
- * ```xml
3881
- * <xsd:element name="style" type="a:CT_ShapeStyle"/>
3882
- * ```
3883
- */
3884
- declare const createXdrStyle: () => XmlComponent;
3885
- /**
3886
- * Creates an xdr:txBody element (Text Body).
3887
- *
3888
- * ## XSD Schema
3889
- * ```xml
3890
- * <xsd:element name="txBody" type="a:CT_TextBody"/>
3891
- * ```
3892
- */
3893
- declare const createXdrTxBody: (children?: readonly IXmlableObject[]) => XmlComponent;
3894
- /**
3895
- * Creates an xdr:blipFill element (Blip Fill).
3896
- *
3897
- * ## XSD Schema
3898
- * ```xml
3899
- * <xsd:element name="blipFill" type="a:CT_BlipFillProperties"/>
3900
- * ```
3901
- */
3902
- declare const createXdrBlipFill: (children?: readonly IXmlableObject[]) => XmlComponent;
3903
- /**
3904
- * Creates an xdr:contentPart element (Content Part).
3905
- *
3906
- * ## XSD Schema
3907
- * ```xml
3908
- * <xsd:element name="contentPart" type="CT_Rel"/>
3909
- * ```
3910
- */
3911
- declare const createXdrContentPart: (rId?: string) => XmlComponent;
3912
- interface XdrTwoCellAnchorOptions {
3913
- readonly editAs?: "twoCell" | "oneCell" | "absolute";
3914
- readonly children?: readonly IXmlableObject[];
3915
- }
3916
- /**
3917
- * Creates an xdr:twoCellAnchor element (Two Cell Anchor).
3918
- *
3919
- * ## XSD Schema
3920
- * ```xml
3921
- * <xsd:element name="twoCellAnchor" type="CT_TwoCellAnchor"/>
3922
- * ```
3923
- */
3924
- declare const createXdrTwoCellAnchor: (options?: XdrTwoCellAnchorOptions) => XmlComponent;
3925
- /**
3926
- * Creates an xdr:oneCellAnchor element (One Cell Anchor).
3927
- *
3928
- * ## XSD Schema
3929
- * ```xml
3930
- * <xsd:element name="oneCellAnchor" type="CT_OneCellAnchor"/>
3931
- * ```
3932
- */
3933
- declare const createXdrOneCellAnchor: (children?: readonly IXmlableObject[]) => XmlComponent;
3934
- //#endregion
3935
- //#region src/drawingml/wordprocessing-drawing/wordprocessing-drawing.d.ts
3936
- interface WpNonVisualDrawingPropsOptions {
3937
- readonly id?: number;
3938
- readonly name?: string;
3939
- readonly descr?: string;
3940
- readonly hidden?: boolean;
3941
- }
3942
- /**
3943
- * Creates a wp:cNvPr element (Non-Visual Drawing Properties).
3944
- *
3945
- * ## XSD Schema
3946
- * ```xml
3947
- * <xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps"/>
3948
- * ```
3949
- */
3950
- declare const createWpCNvPr: (options?: WpNonVisualDrawingPropsOptions) => XmlComponent;
3951
- /**
3952
- * Creates a wp:cNvSpPr element (Non-Visual Drawing Shape Properties).
3953
- *
3954
- * ## XSD Schema
3955
- * ```xml
3956
- * <xsd:element name="cNvSpPr" type="a:CT_NonVisualDrawingShapeProps"/>
3957
- * ```
3958
- */
3959
- declare const createWpCNvSpPr: (options?: {
3960
- readonly txSp?: boolean;
3961
- }) => XmlComponent;
3962
- /**
3963
- * Creates a wp:cNvCnPr element (Non-Visual Connector Properties).
3964
- *
3965
- * ## XSD Schema
3966
- * ```xml
3967
- * <xsd:element name="cNvCnPr" type="a:CT_NonVisualConnectorProperties"/>
3968
- * ```
3969
- */
3970
- declare const createWpCNvCnPr: () => XmlComponent;
3971
- /**
3972
- * Creates a wp:cNvFrPr element (Non-Visual Graphic Frame Properties).
3973
- *
3974
- * ## XSD Schema
3975
- * ```xml
3976
- * <xsd:element name="cNvFrPr" type="a:CT_NonVisualGraphicFrameProperties"/>
3977
- * ```
3978
- */
3979
- declare const createWpCNvFrPr: () => XmlComponent;
3980
- /**
3981
- * Creates a wp:cNvGrpSpPr element (Non-Visual Group Shape Properties).
3982
- *
3983
- * ## XSD Schema
3984
- * ```xml
3985
- * <xsd:element name="cNvGrpSpPr" type="a:CT_NonVisualGroupDrawingShapeProps"/>
3986
- * ```
3987
- */
3988
- declare const createWpCNvGrpSpPr: () => XmlComponent;
3989
- /**
3990
- * Creates a wp:cNvContentPartPr element (Non-Visual Content Part Properties).
3991
- *
3992
- * ## XSD Schema
3993
- * ```xml
3994
- * <xsd:element name="cNvContentPartPr" type="a:CT_NonVisualContentPartProperties"/>
3995
- * ```
3996
- */
3997
- interface ContentPartPropertiesOptions {
3998
- readonly isComment?: boolean;
3999
- }
4000
- declare const createWpCNvContentPartPr: (options?: ContentPartPropertiesOptions) => XmlComponent;
4001
- interface WpShapeOptions {
4002
- readonly cNvPr?: WpNonVisualDrawingPropsOptions;
4003
- readonly normalEastAsianFlow?: boolean;
4004
- readonly children?: readonly IXmlableObject[];
4005
- }
4006
- /**
4007
- * Creates a wp:wsp element (Wordprocessing Shape).
4008
- *
4009
- * ## XSD Schema
4010
- * ```xml
4011
- * <xsd:element name="wsp" type="CT_WordprocessingShape"/>
4012
- * ```
4013
- */
4014
- declare const createWpSp: (options?: WpShapeOptions) => XmlComponent;
4015
- /**
4016
- * Creates a wp:spPr element (Shape Properties within wp namespace).
4017
- *
4018
- * ## XSD Schema
4019
- * ```xml
4020
- * <xsd:element name="spPr" type="a:CT_ShapeProperties"/>
4021
- * ```
4022
- */
4023
- declare const createWpSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
4024
- /**
4025
- * Creates a wp:grpSpPr element (Group Shape Properties within wp namespace).
4026
- *
4027
- * ## XSD Schema
4028
- * ```xml
4029
- * <xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties"/>
4030
- * ```
4031
- */
4032
- declare const createWpGrpSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
4033
- /**
4034
- * Creates a wp:style element (Shape Style).
4035
- *
4036
- * ## XSD Schema
4037
- * ```xml
4038
- * <xsd:element name="style" type="a:CT_ShapeStyle"/>
4039
- * ```
4040
- */
4041
- declare const createWpStyle: () => XmlComponent;
4042
- /**
4043
- * Creates a wp:xfrm element (2D Transform).
4044
- *
4045
- * ## XSD Schema
4046
- * ```xml
4047
- * <xsd:element name="xfrm" type="a:CT_Transform2D"/>
4048
- * ```
4049
- */
4050
- declare const createWpXfrm: (children?: readonly IXmlableObject[]) => XmlComponent;
4051
- /**
4052
- * Creates a wp:bodyPr element (Text Body Properties).
4053
- *
4054
- * ## XSD Schema
4055
- * ```xml
4056
- * <xsd:element name="bodyPr" type="a:CT_TextBodyProperties"/>
4057
- * ```
4058
- */
4059
- declare const createWpBodyPr: () => XmlComponent;
4060
- interface WpTextboxOptions {
4061
- readonly id?: number;
4062
- readonly children?: readonly IXmlableObject[];
4063
- }
4064
- /**
4065
- * Creates a wp:txbx element (Textbox Info).
4066
- *
4067
- * ## XSD Schema
4068
- * ```xml
4069
- * <xsd:element name="txbx" type="CT_TextboxInfo"/>
4070
- * ```
4071
- */
4072
- declare const createWpTxbx: (options?: WpTextboxOptions) => XmlComponent;
4073
- /**
4074
- * Creates a wp:txbxContent element (Textbox Content).
4075
- *
4076
- * ## XSD Schema
4077
- * ```xml
4078
- * <xsd:element name="txbxContent" type="CT_TxbxContent"/>
4079
- * ```
4080
- */
4081
- declare const createWpTxbxContent: (children?: readonly IXmlableObject[]) => XmlComponent;
4082
- interface WpLinkedTextboxOptions {
4083
- readonly id: number;
4084
- readonly seq: number;
4085
- }
4086
- /**
4087
- * Creates a wp:linkedTxbx element (Linked Textbox Information).
4088
- *
4089
- * ## XSD Schema
4090
- * ```xml
4091
- * <xsd:element name="linkedTxbx" type="CT_LinkedTextboxInformation"/>
4092
- * ```
4093
- */
4094
- declare const createWpLinkedTxbx: (options: WpLinkedTextboxOptions) => XmlComponent;
4095
- /**
4096
- * Creates a wp:extLst element (Extension List).
4097
- *
4098
- * ## XSD Schema
4099
- * ```xml
4100
- * <xsd:element name="extLst" type="a:CT_OfficeArtExtensionList"/>
4101
- * ```
4102
- */
4103
- declare const createWpExtLst: (children?: readonly IXmlableObject[]) => XmlComponent;
4104
- interface WpGraphicFrameOptions {
4105
- readonly children?: readonly IXmlableObject[];
4106
- }
4107
- /**
4108
- * Creates a wp:graphicFrame element (Graphic Frame).
4109
- *
4110
- * ## XSD Schema
4111
- * ```xml
4112
- * <xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
4113
- * ```
4114
- */
4115
- declare const createWpGraphicFrame: (options?: WpGraphicFrameOptions) => XmlComponent;
4116
- interface WpContentPartOptions {
4117
- readonly bwMode?: string;
4118
- readonly rId?: string;
4119
- }
4120
- /**
4121
- * Creates a wp:contentPart element (Content Part).
4122
- *
4123
- * ## XSD Schema
4124
- * ```xml
4125
- * <xsd:element name="contentPart" type="CT_WordprocessingContentPart"/>
4126
- * ```
4127
- */
4128
- declare const createWpContentPart: (options?: WpContentPartOptions) => XmlComponent;
4129
- /**
4130
- * Creates a wp:nvContentPartPr element (Non-Visual Content Part Properties).
4131
- *
4132
- * ## XSD Schema
4133
- * ```xml
4134
- * <xsd:element name="nvContentPartPr" type="CT_WordprocessingContentPartNonVisual"/>
4135
- * ```
4136
- */
4137
- declare const createWpNvContentPartPr: (children?: readonly IXmlableObject[]) => XmlComponent;
4138
- interface WpGroupOptions {
4139
- readonly children?: readonly IXmlableObject[];
4140
- }
4141
- /**
4142
- * Creates a wp:wgp element (Wordprocessing Group).
4143
- *
4144
- * ## XSD Schema
4145
- * ```xml
4146
- * <xsd:element name="wgp" type="CT_WordprocessingGroup"/>
4147
- * ```
4148
- */
4149
- declare const createWpGrpSp: (options?: WpGroupOptions) => XmlComponent;
4150
- /**
4151
- * Creates a wp:grpSp element (Nested Group Shape within Wordprocessing Group).
4152
- *
4153
- * ## XSD Schema
4154
- * ```xml
4155
- * <xsd:element name="grpSp" type="CT_WordprocessingGroup"/>
4156
- * ```
4157
- */
4158
- declare const createWpNestedGrpSp: (options?: WpGroupOptions) => XmlComponent;
4159
- interface WpCanvasOptions {
4160
- readonly children?: readonly IXmlableObject[];
4161
- }
4162
- /**
4163
- * Creates a wp:wpc element (Wordprocessing Canvas).
4164
- *
4165
- * ## XSD Schema
4166
- * ```xml
4167
- * <xsd:element name="wpc" type="CT_WordprocessingCanvas"/>
4168
- * ```
4169
- */
4170
- declare const createWpCanvas: (options?: WpCanvasOptions) => XmlComponent;
4171
- /**
4172
- * Creates a wp:bg element (Background Formatting).
4173
- *
4174
- * ## XSD Schema
4175
- * ```xml
4176
- * <xsd:element name="bg" type="a:CT_BackgroundFormatting"/>
4177
- * ```
4178
- */
4179
- declare const createWpBg: () => XmlComponent;
4180
- /**
4181
- * Creates a wp:whole element (Whole E2O Formatting).
4182
- *
4183
- * ## XSD Schema
4184
- * ```xml
4185
- * <xsd:element name="whole" type="a:CT_WholeE2oFormatting"/>
4186
- * ```
4187
- */
4188
- declare const createWpWhole: () => XmlComponent;
3865
+ noGrp?: boolean;
3866
+ noDrilldown?: boolean;
3867
+ noSelect?: boolean;
3868
+ noChangeAspect?: boolean;
3869
+ noMove?: boolean;
3870
+ noResize?: boolean;
3871
+ }
3872
+ declare function createShapeLocking(opts: ShapeLockingOptions): string;
3873
+ declare function createPictureLocking(opts: PictureLockingOptions): string;
3874
+ declare function createGroupLocking(opts: GroupLockingOptions): string;
3875
+ declare function createGraphicFrameLocking(opts: GraphicFrameLockingOptions): string;
4189
3876
  //#endregion
4190
3877
  //#region src/drawingml/diagram/layout-vars.d.ts
4191
3878
  interface AdjOptions {
4192
3879
  /** 1-based index (required) */
4193
- readonly idx: number;
3880
+ idx: number;
4194
3881
  /** Adjustment value (required) */
4195
- readonly val: number;
3882
+ val: number;
4196
3883
  }
4197
3884
  /** Creates a dgm:adj element. */
4198
- declare const createAdj: (options: AdjOptions) => XmlComponent;
3885
+ declare const createAdj: (options: AdjOptions) => string;
4199
3886
  declare const AnimLevelValue: {
4200
3887
  readonly NONE: "none";
4201
3888
  readonly LEVEL: "lvl";
4202
3889
  readonly CENTER: "ctr";
4203
3890
  };
4204
3891
  interface AnimLvlOptions {
4205
- readonly val?: (typeof AnimLevelValue)[keyof typeof AnimLevelValue];
3892
+ val?: (typeof AnimLevelValue)[keyof typeof AnimLevelValue];
4206
3893
  }
4207
3894
  /** Creates a dgm:animLvl element. */
4208
- declare const createAnimLvl: (options?: AnimLvlOptions) => XmlComponent;
3895
+ declare const createAnimLvl: (options?: AnimLvlOptions) => string;
4209
3896
  declare const AnimOneValue: {
4210
3897
  readonly NONE: "none";
4211
3898
  readonly ONE: "one";
4212
3899
  readonly BRANCH: "branch";
4213
3900
  };
4214
3901
  interface AnimOneOptions {
4215
- readonly val?: (typeof AnimOneValue)[keyof typeof AnimOneValue];
3902
+ val?: (typeof AnimOneValue)[keyof typeof AnimOneValue];
4216
3903
  }
4217
3904
  /** Creates a dgm:animOne element. */
4218
- declare const createAnimOne: (options?: AnimOneOptions) => XmlComponent;
3905
+ declare const createAnimOne: (options?: AnimOneOptions) => string;
4219
3906
  interface ChMaxOptions {
4220
- readonly val?: number;
3907
+ val?: number;
4221
3908
  }
4222
3909
  /** Creates a dgm:chMax element. */
4223
- declare const createChMax: (options?: ChMaxOptions) => XmlComponent;
3910
+ declare const createChMax: (options?: ChMaxOptions) => string;
4224
3911
  interface ChPrefOptions {
4225
- readonly val?: number;
3912
+ val?: number;
4226
3913
  }
4227
3914
  /** Creates a dgm:chPref element. */
4228
- declare const createChPref: (options?: ChPrefOptions) => XmlComponent;
3915
+ declare const createChPref: (options?: ChPrefOptions) => string;
4229
3916
  interface OrgChartOptions {
4230
- readonly val?: boolean;
3917
+ val?: boolean;
4231
3918
  }
4232
3919
  /** Creates a dgm:orgChart element. */
4233
- declare const createOrgChart: (options?: OrgChartOptions) => XmlComponent;
3920
+ declare const createOrgChart: (options?: OrgChartOptions) => string;
4234
3921
  declare const HierBranchStyle: {
4235
3922
  readonly LEFT: "l";
4236
3923
  readonly RIGHT: "r";
@@ -4239,17 +3926,17 @@ declare const HierBranchStyle: {
4239
3926
  readonly INITIAL: "init";
4240
3927
  };
4241
3928
  interface HierBranchOptions {
4242
- readonly val?: (typeof HierBranchStyle)[keyof typeof HierBranchStyle];
3929
+ val?: (typeof HierBranchStyle)[keyof typeof HierBranchStyle];
4243
3930
  }
4244
3931
  /** Creates a dgm:hierBranch element. */
4245
- declare const createHierBranch: (options?: HierBranchOptions) => XmlComponent;
3932
+ declare const createHierBranch: (options?: HierBranchOptions) => string;
4246
3933
  interface PresLayoutVarsOptions {
4247
- readonly orgChart?: OrgChartOptions;
4248
- readonly chMax?: ChMaxOptions;
4249
- readonly chPref?: ChPrefOptions;
4250
- readonly animOne?: AnimOneOptions;
4251
- readonly animLvl?: AnimLvlOptions;
4252
- readonly hierBranch?: HierBranchOptions;
3934
+ orgChart?: OrgChartOptions;
3935
+ chMax?: ChMaxOptions;
3936
+ chPref?: ChPrefOptions;
3937
+ animOne?: AnimOneOptions;
3938
+ animLvl?: AnimLvlOptions;
3939
+ hierBranch?: HierBranchOptions;
4253
3940
  }
4254
3941
  /**
4255
3942
  * Creates a dgm:presLayoutVars element (CT_LayoutVariablePropertySet).
@@ -4271,33 +3958,33 @@ interface PresLayoutVarsOptions {
4271
3958
  * </xsd:complexType>
4272
3959
  * ```
4273
3960
  */
4274
- declare const createPresLayoutVars: (options?: PresLayoutVarsOptions) => XmlComponent;
3961
+ declare const createPresLayoutVars: (options?: PresLayoutVarsOptions) => string;
4275
3962
  interface AdjLstOptions {
4276
- readonly adj?: readonly AdjOptions[];
3963
+ adj?: readonly AdjOptions[];
4277
3964
  }
4278
3965
  /** Creates a dgm:adjLst element containing dgm:adj children. */
4279
- declare const createAdjLst: (options?: AdjLstOptions) => XmlComponent;
3966
+ declare const createAdjLst: (options?: AdjLstOptions) => string;
4280
3967
  //#endregion
4281
3968
  //#region src/drawingml/diagram/headers.d.ts
4282
3969
  interface DiagramNameOptions {
4283
- readonly lang?: string;
4284
- readonly val: string;
3970
+ lang?: string;
3971
+ val: string;
4285
3972
  }
4286
3973
  interface DiagramDescriptionOptions {
4287
- readonly lang?: string;
4288
- readonly val: string;
3974
+ lang?: string;
3975
+ val: string;
4289
3976
  }
4290
3977
  interface DiagramCategoryOptions {
4291
- readonly type: string;
4292
- readonly pri: number;
3978
+ type: string;
3979
+ pri: number;
4293
3980
  }
4294
3981
  interface ColorsDefHdrOptions {
4295
- readonly uniqueId: string;
4296
- readonly minVer?: string;
4297
- readonly resId?: number;
4298
- readonly title: readonly DiagramNameOptions[];
4299
- readonly desc: readonly DiagramDescriptionOptions[];
4300
- readonly categories?: readonly DiagramCategoryOptions[];
3982
+ uniqueId: string;
3983
+ minVer?: string;
3984
+ resId?: number;
3985
+ title: readonly DiagramNameOptions[];
3986
+ desc: readonly DiagramDescriptionOptions[];
3987
+ categories?: readonly DiagramCategoryOptions[];
4301
3988
  }
4302
3989
  /**
4303
3990
  * Creates a dgm:colorsDefHdr element (CT_ColorTransformHeader).
@@ -4317,20 +4004,20 @@ interface ColorsDefHdrOptions {
4317
4004
  * </xsd:complexType>
4318
4005
  * ```
4319
4006
  */
4320
- declare const createColorsDefHdr: (options: ColorsDefHdrOptions) => XmlComponent;
4007
+ declare const createColorsDefHdr: (options: ColorsDefHdrOptions) => string;
4321
4008
  interface ColorsDefHdrLstOptions {
4322
- readonly headers?: readonly ColorsDefHdrOptions[];
4009
+ headers?: readonly ColorsDefHdrOptions[];
4323
4010
  }
4324
4011
  /** Creates a dgm:colorsDefHdrLst element. */
4325
- declare const createColorsDefHdrLst: (options?: ColorsDefHdrLstOptions) => XmlComponent;
4012
+ declare const createColorsDefHdrLst: (options?: ColorsDefHdrLstOptions) => string;
4326
4013
  interface LayoutDefHdrOptions {
4327
- readonly uniqueId: string;
4328
- readonly minVer?: string;
4329
- readonly defStyle?: string;
4330
- readonly resId?: number;
4331
- readonly title: readonly DiagramNameOptions[];
4332
- readonly desc: readonly DiagramDescriptionOptions[];
4333
- readonly categories?: readonly DiagramCategoryOptions[];
4014
+ uniqueId: string;
4015
+ minVer?: string;
4016
+ defStyle?: string;
4017
+ resId?: number;
4018
+ title: readonly DiagramNameOptions[];
4019
+ desc: readonly DiagramDescriptionOptions[];
4020
+ categories?: readonly DiagramCategoryOptions[];
4334
4021
  }
4335
4022
  /**
4336
4023
  * Creates a dgm:layoutDefHdr element (CT_DiagramDefinitionHeader).
@@ -4351,19 +4038,19 @@ interface LayoutDefHdrOptions {
4351
4038
  * </xsd:complexType>
4352
4039
  * ```
4353
4040
  */
4354
- declare const createLayoutDefHdr: (options: LayoutDefHdrOptions) => XmlComponent;
4041
+ declare const createLayoutDefHdr: (options: LayoutDefHdrOptions) => string;
4355
4042
  interface LayoutDefHdrLstOptions {
4356
- readonly headers?: readonly LayoutDefHdrOptions[];
4043
+ headers?: readonly LayoutDefHdrOptions[];
4357
4044
  }
4358
4045
  /** Creates a dgm:layoutDefHdrLst element. */
4359
- declare const createLayoutDefHdrLst: (options?: LayoutDefHdrLstOptions) => XmlComponent;
4046
+ declare const createLayoutDefHdrLst: (options?: LayoutDefHdrLstOptions) => string;
4360
4047
  interface StyleDefHdrOptions {
4361
- readonly uniqueId: string;
4362
- readonly minVer?: string;
4363
- readonly resId?: number;
4364
- readonly title: readonly DiagramNameOptions[];
4365
- readonly desc: readonly DiagramDescriptionOptions[];
4366
- readonly categories?: readonly DiagramCategoryOptions[];
4048
+ uniqueId: string;
4049
+ minVer?: string;
4050
+ resId?: number;
4051
+ title: readonly DiagramNameOptions[];
4052
+ desc: readonly DiagramDescriptionOptions[];
4053
+ categories?: readonly DiagramCategoryOptions[];
4367
4054
  }
4368
4055
  /**
4369
4056
  * Creates a dgm:styleDefHdr element (CT_StyleDefinitionHeader).
@@ -4383,12 +4070,12 @@ interface StyleDefHdrOptions {
4383
4070
  * </xsd:complexType>
4384
4071
  * ```
4385
4072
  */
4386
- declare const createStyleDefHdr: (options: StyleDefHdrOptions) => XmlComponent;
4073
+ declare const createStyleDefHdr: (options: StyleDefHdrOptions) => string;
4387
4074
  interface StyleDefHdrLstOptions {
4388
- readonly headers?: readonly StyleDefHdrOptions[];
4075
+ headers?: readonly StyleDefHdrOptions[];
4389
4076
  }
4390
4077
  /** Creates a dgm:styleDefHdrLst element. */
4391
- declare const createStyleDefHdrLst: (options?: StyleDefHdrLstOptions) => XmlComponent;
4078
+ declare const createStyleDefHdrLst: (options?: StyleDefHdrLstOptions) => string;
4392
4079
  //#endregion
4393
4080
  //#region src/drawingml/diagram/diagram-style.d.ts
4394
4081
  declare const StyleMatrixIndex: {
@@ -4403,13 +4090,13 @@ declare const FontCollectionIndex: {
4403
4090
  };
4404
4091
  interface DiagramStyleOptions {
4405
4092
  /** Line style matrix reference index */
4406
- readonly lnIdx?: number;
4093
+ lnIdx?: number;
4407
4094
  /** Fill style matrix reference index */
4408
- readonly fillIdx?: number;
4095
+ fillIdx?: number;
4409
4096
  /** Effect style matrix reference index */
4410
- readonly effectIdx?: number;
4097
+ effectIdx?: number;
4411
4098
  /** Font reference collection index */
4412
- readonly fontIdx?: string;
4099
+ fontIdx?: string;
4413
4100
  }
4414
4101
  /**
4415
4102
  * Creates a dgm:style element (a:CT_ShapeStyle).
@@ -4426,7 +4113,7 @@ interface DiagramStyleOptions {
4426
4113
  * </xsd:complexType>
4427
4114
  * ```
4428
4115
  */
4429
- declare const createDiagramStyle: (options?: DiagramStyleOptions) => XmlComponent;
4116
+ declare const createDiagramStyle: (options?: DiagramStyleOptions) => string;
4430
4117
  declare const ColorMethod: {
4431
4118
  readonly SPAN: "span";
4432
4119
  readonly CYCLE: "cycle";
@@ -4438,27 +4125,27 @@ declare const HueDirection: {
4438
4125
  };
4439
4126
  interface ColorListOptions {
4440
4127
  /** Color method (default: span) */
4441
- readonly meth?: (typeof ColorMethod)[keyof typeof ColorMethod];
4128
+ meth?: (typeof ColorMethod)[keyof typeof ColorMethod];
4442
4129
  /** Hue direction (default: cw) */
4443
- readonly hueDir?: (typeof HueDirection)[keyof typeof HueDirection];
4130
+ hueDir?: (typeof HueDirection)[keyof typeof HueDirection];
4444
4131
  /** Colors (EG_ColorChoice items) */
4445
- readonly colors?: readonly SolidFillOptions[];
4446
- }
4447
- declare const createFillClrLst: (options?: ColorListOptions) => XmlComponent;
4448
- declare const createLinClrLst: (options?: ColorListOptions) => XmlComponent;
4449
- declare const createEffectClrLst: (options?: ColorListOptions) => XmlComponent;
4450
- declare const createTxFillClrLst: (options?: ColorListOptions) => XmlComponent;
4451
- declare const createTxLinClrLst: (options?: ColorListOptions) => XmlComponent;
4452
- declare const createTxEffectClrLst: (options?: ColorListOptions) => XmlComponent;
4132
+ colors?: readonly SolidFillOptions[];
4133
+ }
4134
+ declare const createFillClrLst: (options?: ColorListOptions) => string;
4135
+ declare const createLinClrLst: (options?: ColorListOptions) => string;
4136
+ declare const createEffectClrLst: (options?: ColorListOptions) => string;
4137
+ declare const createTxFillClrLst: (options?: ColorListOptions) => string;
4138
+ declare const createTxLinClrLst: (options?: ColorListOptions) => string;
4139
+ declare const createTxEffectClrLst: (options?: ColorListOptions) => string;
4453
4140
  interface DiagramStyleLblOptions {
4454
4141
  /** Label name (required) */
4455
- readonly name: string;
4456
- readonly fillClrLst?: ColorListOptions;
4457
- readonly linClrLst?: ColorListOptions;
4458
- readonly effectClrLst?: ColorListOptions;
4459
- readonly txFillClrLst?: ColorListOptions;
4460
- readonly txLinClrLst?: ColorListOptions;
4461
- readonly txEffectClrLst?: ColorListOptions;
4142
+ name: string;
4143
+ fillClrLst?: ColorListOptions;
4144
+ linClrLst?: ColorListOptions;
4145
+ effectClrLst?: ColorListOptions;
4146
+ txFillClrLst?: ColorListOptions;
4147
+ txLinClrLst?: ColorListOptions;
4148
+ txEffectClrLst?: ColorListOptions;
4462
4149
  }
4463
4150
  /**
4464
4151
  * Creates a dgm:styleLbl element (CT_StyleLabel or CT_CTStyleLabel).
@@ -4493,18 +4180,25 @@ interface DiagramStyleLblOptions {
4493
4180
  * </xsd:complexType>
4494
4181
  * ```
4495
4182
  */
4496
- declare const createStyleLbl: (options: DiagramStyleLblOptions) => XmlComponent;
4183
+ declare const createStyleLbl: (options: DiagramStyleLblOptions) => string;
4497
4184
  //#endregion
4498
4185
  //#region src/drawingml/diagram/diagram-rel.d.ts
4186
+ /**
4187
+ * Diagram relationship IDs element.
4188
+ *
4189
+ * Reference: ISO/IEC 29500-4, dml-diagram.xsd, CT_RelIds
4190
+ *
4191
+ * @module
4192
+ */
4499
4193
  interface DiagramRelIdsOptions {
4500
4194
  /** Relationship to data model part */
4501
- readonly dm: string;
4195
+ dm: string;
4502
4196
  /** Relationship to layout definition part */
4503
- readonly lo: string;
4197
+ lo: string;
4504
4198
  /** Relationship to quick style part */
4505
- readonly qs: string;
4199
+ qs: string;
4506
4200
  /** Relationship to color transform part */
4507
- readonly cs: string;
4201
+ cs: string;
4508
4202
  }
4509
4203
  /**
4510
4204
  * Creates a dgm:relIds element (CT_RelIds).
@@ -4519,32 +4213,32 @@ interface DiagramRelIdsOptions {
4519
4213
  * </xsd:complexType>
4520
4214
  * ```
4521
4215
  */
4522
- declare const createDiagramRelIds: (options: DiagramRelIdsOptions) => XmlComponent;
4216
+ declare const createDiagramRelIds: (options: DiagramRelIdsOptions) => string;
4523
4217
  //#endregion
4524
4218
  //#region src/drawingml/diagram/diagram-props.d.ts
4525
4219
  interface DiagramExtLstOptions {
4526
4220
  /** Extension URIs */
4527
- readonly extensions?: readonly DiagramExtensionOptions[];
4221
+ extensions?: readonly DiagramExtensionOptions[];
4528
4222
  }
4529
4223
  interface DiagramExtensionOptions {
4530
- readonly uri: string;
4531
- readonly content?: string;
4224
+ uri: string;
4225
+ content?: string;
4532
4226
  }
4533
4227
  /**
4534
4228
  * Creates a dgm:extLst element (a:CT_OfficeArtExtensionList).
4535
4229
  *
4536
4230
  * Generic extension list pattern used across OOXML.
4537
4231
  */
4538
- declare const createDiagramExtLst: (options?: DiagramExtLstOptions) => XmlComponent;
4232
+ declare const createDiagramExtLst: (options?: DiagramExtLstOptions) => string;
4539
4233
  /**
4540
4234
  * Creates a dgm:sp3d element wrapping a:CT_Shape3D.
4541
4235
  *
4542
4236
  * Delegates to the shared createShape3D factory but wraps in dgm: namespace context.
4543
4237
  */
4544
- declare const createDiagramSp3d: (options: Shape3DOptions) => XmlComponent;
4238
+ declare const createDiagramSp3d: (options: Shape3DOptions) => string;
4545
4239
  interface DiagramTextPropsOptions {
4546
4240
  /** 3D text properties (flat text, no 3D) — empty element */
4547
- readonly flat?: boolean;
4241
+ flat?: boolean;
4548
4242
  }
4549
4243
  /**
4550
4244
  * Creates a dgm:txPr element (CT_TextProps).
@@ -4558,179 +4252,64 @@ interface DiagramTextPropsOptions {
4558
4252
  * </xsd:complexType>
4559
4253
  * ```
4560
4254
  */
4561
- declare const createDiagramTxPr: (_options?: DiagramTextPropsOptions) => XmlComponent;
4255
+ declare const createDiagramTxPr: (_options?: DiagramTextPropsOptions) => string;
4256
+ //#endregion
4257
+ //#region src/drawingml/color/color-descriptors.d.ts
4258
+ declare const rgbColorDesc: CustomDescriptor<RgbColorOptions>;
4259
+ declare const schemeColorDesc: CustomDescriptor<SchemeColorOptions>;
4260
+ declare const hslColorDesc: CustomDescriptor<HslColorOptions>;
4261
+ declare const systemColorDesc: CustomDescriptor<SystemColorOptions>;
4262
+ declare const presetColorDesc: CustomDescriptor<PresetColorOptions>;
4263
+ declare const scRgbColorDesc: CustomDescriptor<ScRgbColorOptions>;
4264
+ declare function getColorDescriptor(color: SolidFillOptions): CustomDescriptor<any>;
4265
+ declare const solidFillDesc: CustomDescriptor<SolidFillOptions>;
4266
+ //#endregion
4267
+ //#region src/drawingml/fill/fill-descriptors.d.ts
4268
+ declare const gradientFillDesc: CustomDescriptor<GradientFillOptions>;
4269
+ declare const patternFillDesc: CustomDescriptor<PatternFillOptions>;
4270
+ declare const fillDesc: CustomDescriptor<FillOptions>;
4271
+ //#endregion
4272
+ //#region src/drawingml/outline/outline-descriptors.d.ts
4273
+ declare const outlineDesc: CustomDescriptor<OutlineOptions>;
4274
+ //#endregion
4275
+ //#region src/drawingml/effects/effect-descriptors.d.ts
4276
+ declare const effectListDesc: CustomDescriptor<EffectListOptions>;
4277
+ //#endregion
4278
+ //#region src/drawingml/locking/locking-descriptors.d.ts
4279
+ declare const shapeLockingDesc: CustomDescriptor<ShapeLockingOptions>;
4280
+ declare const pictureLockingDesc: CustomDescriptor<PictureLockingOptions>;
4281
+ declare const groupLockingDesc: CustomDescriptor<GroupLockingOptions>;
4282
+ declare const graphicFrameLockingDesc: CustomDescriptor<GraphicFrameLockingOptions>;
4283
+ //#endregion
4284
+ //#region src/drawingml/geometry/geometry-descriptors.d.ts
4285
+ declare const presetGeometryDesc: CustomDescriptor<PresetGeometryOptions>;
4286
+ declare const customGeometryDesc: CustomDescriptor<CustomGeometryOptions>;
4287
+ //#endregion
4288
+ //#region src/drawingml/transform-descriptors.d.ts
4289
+ declare const transform2DDesc: CustomDescriptor<Transform2DOptions>;
4290
+ declare const groupTransform2DDesc: CustomDescriptor<GroupTransform2DOptions>;
4291
+ //#endregion
4292
+ //#region src/drawingml/three-d/three-d-descriptors.d.ts
4293
+ declare const bevelDesc: CustomDescriptor<BevelOptions>;
4294
+ declare const shape3DDesc: CustomDescriptor<Shape3DOptions>;
4295
+ declare const scene3DDesc: CustomDescriptor<Scene3DOptions>;
4296
+ //#endregion
4297
+ //#region src/drawingml/blip/blip-descriptors.d.ts
4298
+ declare const tileDesc: CustomDescriptor<TileOptions>;
4299
+ declare const sourceRectangleDesc: CustomDescriptor<SourceRectangleOptions>;
4300
+ declare const stretchDesc: CustomDescriptor<SourceRectangleOptions>;
4301
+ declare const blipDesc: CustomDescriptor<BlipOptions & {
4302
+ blipEffects?: BlipEffectsOptions;
4303
+ }>;
4304
+ declare const blipFillDesc: CustomDescriptor<BlipFillOptions & {
4305
+ referenceId?: string;
4306
+ blipEffects?: BlipEffectsOptions;
4307
+ }>;
4562
4308
  //#endregion
4563
- //#region src/drawingml/dml-main-elements.d.ts
4564
- /** Creates an a:sp element (Shape). */
4565
- declare const createSp: (children?: readonly IXmlableObject[]) => XmlComponent;
4566
- /** Creates an a:cxnSp element (Connector Shape). */
4567
- declare const createCxnSp: (children?: readonly IXmlableObject[]) => XmlComponent;
4568
- /** Creates an a:grpSp element (Group Shape). */
4569
- declare const createGrpSp: (children?: readonly IXmlableObject[]) => XmlComponent;
4570
- /** Creates an a:pic element (Picture). */
4571
- declare const createPic: (children?: readonly IXmlableObject[]) => XmlComponent;
4572
- /** Creates an a:graphicFrame element (Graphic Frame). */
4573
- declare const createGraphicFrame: (children?: readonly IXmlableObject[]) => XmlComponent;
4574
- /** Creates an a:txSp element (Text Shape). */
4575
- declare const createTxSp: (children?: readonly IXmlableObject[]) => XmlComponent;
4576
- /** Creates an a:cNvSpPr element (Non-Visual Drawing Shape Properties). */
4577
- declare const createCNvSpPr: () => XmlComponent;
4578
- /** Creates an a:cNvCxnSpPr element (Non-Visual Connector Properties). */
4579
- declare const createCNvCxnSpPr: () => XmlComponent;
4580
- /** Creates an a:cNvGrpSpPr element (Non-Visual Group Shape Properties). */
4581
- declare const createCNvGrpSpPr: () => XmlComponent;
4582
- /** Creates an a:cNvGraphicFramePr element (Non-Visual Graphic Frame Properties). */
4583
- declare const createCNvGraphicFramePr: () => XmlComponent;
4584
- /** Creates an a:nvSpPr element (Shape Non-Visual Properties). */
4585
- declare const createNvSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
4586
- /** Creates an a:nvCxnSpPr element (Connector Non-Visual Properties). */
4587
- declare const createNvCxnSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
4588
- /** Creates an a:nvGrpSpPr element (Group Shape Non-Visual Properties). */
4589
- declare const createNvGrpSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
4590
- /** Creates an a:nvGraphicFramePr element (Graphic Frame Non-Visual Properties). */
4591
- declare const createNvGraphicFramePr: (children?: readonly IXmlableObject[]) => XmlComponent;
4592
- /** Creates an a:nvPicPr element (Picture Non-Visual Properties). */
4593
- declare const createNvPicPr: (children?: readonly IXmlableObject[]) => XmlComponent;
4594
- /** Creates an a:grpSpPr element (Group Shape Properties). */
4595
- declare const createGrpSpPr: (children?: readonly IXmlableObject[]) => XmlComponent;
4596
- /** Creates an a:cpLocks element (Content Part Locking). */
4597
- declare const createCpLocks: () => XmlComponent;
4598
- /** Creates an a:cxnSpLocks element (Connector Locking). */
4599
- declare const createCxnSpLocks: () => XmlComponent;
4600
- /** Creates an a:useSpRect element (Use Shape Rectangle). */
4601
- declare const createUseSpRect: () => XmlComponent;
4602
- /** Creates an a:tableStyle element (Table Style). */
4603
- declare const createTableStyleElement: (children?: readonly IXmlableObject[]) => XmlComponent;
4604
- /** Creates an a:cell3D element (Cell 3-D Properties). */
4605
- declare const createCell3D: (children?: readonly IXmlableObject[]) => XmlComponent;
4606
- /** Creates an a:insideH element (Inside Horizontal Border). */
4607
- declare const createInsideH: (children?: readonly IXmlableObject[]) => XmlComponent;
4608
- /** Creates an a:insideV element (Inside Vertical Border). */
4609
- declare const createInsideV: (children?: readonly IXmlableObject[]) => XmlComponent;
4610
- /** Creates an a:top element (Top Border). */
4611
- declare const createTop: (children?: readonly IXmlableObject[]) => XmlComponent;
4612
- /** Creates an a:bottom element (Bottom Border). */
4613
- declare const createBottom: (children?: readonly IXmlableObject[]) => XmlComponent;
4614
- /** Creates an a:left element (Left Border). */
4615
- declare const createLeft: (children?: readonly IXmlableObject[]) => XmlComponent;
4616
- /** Creates an a:right element (Right Border). */
4617
- declare const createRight: (children?: readonly IXmlableObject[]) => XmlComponent;
4618
- /** Creates an a:tl2br element (Top-Left to Bottom-Right Border). */
4619
- declare const createTl2br: (children?: readonly IXmlableObject[]) => XmlComponent;
4620
- /** Creates an a:tr2bl element (Top-Right to Bottom-Left Border). */
4621
- declare const createTr2bl: (children?: readonly IXmlableObject[]) => XmlComponent;
4622
- /** Creates an a:lnTlToBr element (Top-Left to Bottom-Right Line). */
4623
- declare const createLnTlToBr: (children?: readonly IXmlableObject[]) => XmlComponent;
4624
- /** Creates an a:lnBlToTr element (Bottom-Left to Top-Right Line). */
4625
- declare const createLnBlToTr: (children?: readonly IXmlableObject[]) => XmlComponent;
4626
- /** Creates an a:round element (Round Line Join). */
4627
- declare const createRound: () => XmlComponent;
4628
- /** Creates an a:start element (Connection Start Time). */
4629
- declare const createStart: (children?: readonly IXmlableObject[]) => XmlComponent;
4630
- /** Creates an a:end element (Audio CD End Time). */
4631
- declare const createEnd: (options?: AudioCdTimeOptions) => XmlComponent;
4632
- /** Creates an a:stCxn element (Start Connection). */
4633
- declare const createStCxn: (children?: readonly IXmlableObject[]) => XmlComponent;
4634
- /** Creates an a:endCxn element (End Connection). */
4635
- declare const createEndCxn: (children?: readonly IXmlableObject[]) => XmlComponent;
4636
- /** Creates an a:clrMap element (Color Map). */
4637
- declare const createClrMap: (children?: readonly IXmlableObject[]) => XmlComponent;
4638
- /** Creates an a:overrideClrMapping element (Override Color Mapping). */
4639
- declare const createOverrideClrMapping: (children?: readonly IXmlableObject[]) => XmlComponent;
4640
- /** Creates an a:extraClrScheme element (Extra Color Scheme). */
4641
- declare const createExtraClrScheme: (children?: readonly IXmlableObject[]) => XmlComponent;
4642
- /** Creates an a:custClr element (Custom Color). */
4643
- declare const createCustClr: (children?: readonly IXmlableObject[]) => XmlComponent;
4644
- /** Creates an a:custClrLst element (Custom Color List). */
4645
- declare const createCustClrLst: (children?: readonly IXmlableObject[]) => XmlComponent;
4646
- /** Creates an a:themeManager element (Theme Manager). */
4647
- declare const createThemeManager: () => XmlComponent;
4648
- /** Creates an a:themeOverride element (Theme Override). */
4649
- declare const createThemeOverride: (children?: readonly IXmlableObject[]) => XmlComponent;
4650
- /** Creates an a:font element (Supplemental Font / Font Collection). */
4651
- declare const createFontElement: (children?: readonly IXmlableObject[]) => XmlComponent;
4652
- /** Creates an a:spDef element (Shape Default). */
4653
- declare const createSpDef: (children?: readonly IXmlableObject[]) => XmlComponent;
4654
- /** Creates an a:lnDef element (Line Default). */
4655
- declare const createLnDef: (children?: readonly IXmlableObject[]) => XmlComponent;
4656
- /** Creates an a:txDef element (Text Default). */
4657
- declare const createTxDef: (children?: readonly IXmlableObject[]) => XmlComponent;
4658
- /** Creates an a:br element (Text Line Break). */
4659
- declare const createBr: (children?: readonly IXmlableObject[]) => XmlComponent;
4660
- /** Creates an a:tab element (Text Tab Stop). */
4661
- declare const createTab: (children?: readonly IXmlableObject[]) => XmlComponent;
4662
- /** Creates an a:tabLst element (Text Tab Stop List). */
4663
- declare const createTabLst: (children?: readonly IXmlableObject[]) => XmlComponent;
4664
- /** Creates an a:sym element (Symbol Font). */
4665
- declare const createSym: (children?: readonly IXmlableObject[]) => XmlComponent;
4666
- /** Creates an a:highlight element (Text Highlight). */
4667
- declare const createHighlight: (children?: readonly IXmlableObject[]) => XmlComponent;
4668
- /** Creates an a:buBlip element (Bullet Blip). */
4669
- declare const createBuBlip: (children?: readonly IXmlableObject[]) => XmlComponent;
4670
- /** Creates an a:buClrTx element (Bullet Color - Follow Text). */
4671
- declare const createBuClrTx: () => XmlComponent;
4672
- /** Creates an a:buFontTx element (Bullet Font - Follow Text). */
4673
- declare const createBuFontTx: () => XmlComponent;
4674
- /** Creates an a:buSzPts element (Bullet Size - Points). */
4675
- declare const createBuSzPts: (children?: readonly IXmlableObject[]) => XmlComponent;
4676
- /** Creates an a:buSzTx element (Bullet Size - Follow Text). */
4677
- declare const createBuSzTx: () => XmlComponent;
4678
- /** Creates an a:uFill element (Underline Fill). */
4679
- declare const createUFill: (children?: readonly IXmlableObject[]) => XmlComponent;
4680
- /** Creates an a:uFillTx element (Underline Fill - Follow Text). */
4681
- declare const createUFillTx: () => XmlComponent;
4682
- /** Creates an a:uLn element (Underline Line Properties). */
4683
- declare const createULn: (children?: readonly IXmlableObject[]) => XmlComponent;
4684
- /** Creates an a:uLnTx element (Underline Line - Follow Text). */
4685
- declare const createULnTx: () => XmlComponent;
4686
- /** Creates an a:audioCd element (Audio CD). */
4687
- declare const createAudioCd: (children?: readonly IXmlableObject[]) => XmlComponent;
4688
- /** Creates an a:quickTimeFile element (QuickTime File). */
4689
- declare const createQuickTimeFile: (children?: readonly IXmlableObject[]) => XmlComponent;
4690
- /** Creates an a:snd element (Sound / Embedded WAV Audio). */
4691
- declare const createSnd: (children?: readonly IXmlableObject[]) => XmlComponent;
4692
- /** Creates an a:wavAudioFile element (WAV Audio File). */
4693
- declare const createWavAudioFile: (children?: readonly IXmlableObject[]) => XmlComponent;
4694
- interface BuildChartOptions {
4695
- readonly build?: string;
4696
- readonly animateBackground?: boolean;
4697
- }
4698
- /** Creates an a:bldChart element (Build Chart). */
4699
- declare const createBldChart: (options?: BuildChartOptions) => XmlComponent;
4700
- interface BuildDiagramOptions {
4701
- readonly build?: string;
4702
- readonly reverse?: boolean;
4703
- }
4704
- /** Creates an a:bldDgm element (Build Diagram). */
4705
- declare const createBldDgm: (options?: BuildDiagramOptions) => XmlComponent;
4706
- /** Creates an a:bevel element (Line Join Bevel). */
4707
- declare const createBevelElement: (children?: readonly IXmlableObject[]) => XmlComponent;
4708
- interface ChartAnimationOptions {
4709
- readonly seriesIndex?: number;
4710
- readonly categoryIndex?: number;
4711
- readonly buildStep?: string;
4712
- }
4713
- /** Creates an a:chart element (Animation Chart Element). */
4714
- declare const createChart: (options?: ChartAnimationOptions) => XmlComponent;
4715
- interface DiagramAnimationOptions {
4716
- readonly id?: string;
4717
- readonly buildStep?: string;
4718
- }
4719
- /** Creates an a:dgm element (Animation Diagram Element). */
4720
- declare const createDgm: (options?: DiagramAnimationOptions) => XmlComponent;
4721
- /** Creates an a:headers element (Headers). */
4722
- declare const createHeaders: (children?: readonly IXmlableObject[]) => XmlComponent;
4723
- /** Creates an a:header element (Header). */
4724
- declare const createHeader: (children?: readonly IXmlableObject[]) => XmlComponent;
4725
- /** Creates an a:hlinkMouseOver element (Hyperlink Mouse Over). */
4726
- declare const createHlinkMouseOver: (children?: readonly IXmlableObject[]) => XmlComponent;
4727
- interface AudioCdTimeOptions {
4728
- readonly track?: number;
4729
- readonly time?: number;
4730
- }
4731
- /** Creates an a:st element (Audio CD Start Time). */
4732
- declare const createSt: (options?: AudioCdTimeOptions) => XmlComponent;
4733
- /** Creates an a:style element (Shape Style). */
4734
- declare const createStyleElement: (children?: readonly IXmlableObject[]) => XmlComponent;
4309
+ //#region src/drawingml/diagram/diagram-descriptors.d.ts
4310
+ declare const diagramRelIdsDesc: CustomDescriptor<DiagramRelIdsOptions>;
4311
+ declare const diagramStyleDesc: CustomDescriptor<DiagramStyleOptions>;
4312
+ declare const presLayoutVarsDesc: CustomDescriptor<PresLayoutVarsOptions>;
4313
+ declare const diagramExtLstDesc: CustomDescriptor<DiagramExtLstOptions>;
4735
4314
  //#endregion
4736
- export { createSp as $, createCdrCNvGrpSpPr as $a, PresetColor as $c, createOfPieChart as $i, createWpSpPr as $n, BlipFillOptions as $o, createCustUnit as $r, LineJoin as $s, StyleDefHdrOptions as $t, createGrpSp as A, createSplitPos as Aa, TileFlipMode as Ac, createLegacyDrawingHF as Ai, WpGroupOptions as An, createPictureLocking as Ao, createXdrSpPr as Ar, EffectContainerType as As, ColorListOptions as At, createLnDef as B, createUpDownBars as Ba, SolidFillOptions as Bc, createMax as Bi, createWpCNvGrpSpPr as Bn, TableTextStyleOptions as Bo, createAutoUpdate as Br, createPresetShadowEffect as Bs, createLinClrLst as Bt, createCxnSpLocks as C, createShowNegBubbles as Ca, GradientFillOptions as Cc, createHeaderFooter as Ci, createChPref as Cn, createCdrY as Co, createXdrNvPicPr as Cr, LightRigOptions as Cs, DiagramExtensionOptions as Ct, createExtraClrScheme as D, createSize as Da, PathShadeOptions as Dc, createLayoutTarget as Di, WpCanvasOptions as Dn, ShapeLockingOptions as Do, createXdrRow as Dr, Vector3D as Ds, createDiagramTxPr as Dt, createEndCxn as E, createSideWall as Ea, LinearShadeOptions as Ec, createInvertIfNegative as Ei, createPresLayoutVars as En, PictureLockingOptions as Eo, createXdrPic as Er, SphereCoords as Es, createDiagramSp3d as Et, createHlinkMouseOver as F, createThickness as Fa, createTileInfo as Fc, createMajorTickMark as Fi, createWpBg as Fn, TableCellStyleOptions as Fo, PageMarginsOptions as Fr, createEffectList as Fs, HueDirection as Ft, createNvPicPr as G, createX as Ga, createSystemColor as Gc, createMinorUnit as Gi, createWpExtLst as Gn, MediaTransformation as Go, createBubble3D as Gr, createInnerShadowEffect as Gs, ColorsDefHdrLstOptions as Gt, createNvCxnSpPr as H, createUserShapes as Ha, createSolidFill as Hc, createMinorGridlines as Hi, createWpCNvSpPr as Hn, createTableStyle as Ho, createBandFmt as Hr, RectAlignment as Hs, createTxEffectClrLst as Ht, createInsideH as I, createTickLblPos as Ia, SourceRectangleOptions as Ic, createMajorTimeUnit as Ii, createWpBodyPr as In, TablePartStyleOptions as Io, PageSetupOptions as Ir, ReflectionEffectOptions as Is, StyleMatrixIndex as It, createPic as J, createYMode as Ja, createSchemeColor as Jc, createMultiLvlStrRef as Ji, createWpGrpSpPr as Jn, Transform2DOptions as Jo, createChartObject as Jr, BlendMode as Js, DiagramDescriptionOptions as Jt, createNvSpPr as K, createXMode as Ka, SchemeColor as Kc, createMinus as Ki, createWpGraphicFrame as Kn, createTransformation as Ko, createBubbleScale as Kr, GlowEffectOptions as Ks, ColorsDefHdrOptions as Kt, createInsideV as L, createTickMarkSkip as La, createSourceRectangle as Lc, createMajorUnit as Li, createWpCNvCnPr as Ln, TableStyleListOptions as Lo, createApplyToEnd as Lr, createReflectionEffect as Ls, createDiagramStyle as Lt, createHeader as M, createStrLit as Ma, createGradientStop as Mc, createLogBase as Mi, WpNonVisualDrawingPropsOptions as Mn, OnOffStyleType as Mo, createXdrTo as Mr, createEffectDag as Ms, DiagramStyleLblOptions as Mt, createHeaders as N, createSurface3DChart as Na, TileAlignment as Nc, createLvl as Ni, WpShapeOptions as Nn, StyleMatrixReferenceOptions as No, createXdrTwoCellAnchor as Nr, BlurEffectOptions as Ns, DiagramStyleOptions as Nt, createFontElement as O, createSizeRepresents as Oa, PathShadeType as Oc, createLblAlgn as Oi, WpContentPartOptions as On, createGraphicFrameLocking as Oo, createXdrRowOff as Or, createScene3D as Os, DiagramRelIdsOptions as Ot, createHighlight as P, createSymbol as Pa, TileOptions as Pc, createMajorGridlines as Pi, WpTextboxOptions as Pn, TableCellBorderOptions as Po, createXdrTxBody as Pr, EffectListOptions as Ps, FontCollectionIndex as Pt, createSnd as Q, createCdrCNvGraphicFramePr as Qa, createRgbColor as Qc, createOddHeader as Qi, createWpSp as Qn, createExtentionList as Qo, createCustSplit as Qr, LineCap as Qs, StyleDefHdrLstOptions as Qt, createLeft as R, createTrendlineLbl as Ra, BlipEffectsOptions as Rc, createManualLayout as Ri, createWpCNvContentPartPr as Rn, TableStyleOptions as Ro, createApplyToFront as Rr, PresetShadowEffectOptions as Rs, createEffectClrLst as Rt, createCxnSp as S, createShowLeaderLines as Sa, extractBlipFillMedia as Sc, createHMode as Si, createChMax as Sn, createCdrXfrm as So, createXdrNvGrpSpPr as Sr, CameraOptions as Ss, DiagramExtLstOptions as St, createEnd as T, createShowVertBorder as Ta, GradientStop as Tc, createHoleSize as Ti, createOrgChart as Tn, GroupLockingOptions as To, createXdrOneCellAnchor as Tr, Scene3DOptions as Ts, createDiagramExtLst as Tt, createNvGraphicFramePr as U, createW as Ua, SystemColor as Uc, createMinorTickMark as Ui, createWpCanvas as Un, createTableStyleList as Uo, createBandFmts as Ur, createOuterShadowEffect as Us, createTxFillClrLst as Ut, createLnTlToBr as V, createUserInterface as Va, createColorElement as Vc, createMin as Vi, createWpCNvPr as Vn, ThemeableLineStyleOptions as Vo, createBackWall as Vr, OuterShadowEffectOptions as Vs, createStyleLbl as Vt, createNvGrpSpPr as W, createWMode as Wa, SystemColorOptions as Wc, createMinorTimeUnit as Wi, createWpContentPart as Wn, MediaDataTransformation as Wo, createBaseTimeUnit as Wr, InnerShadowEffectOptions as Ws, createTxLinClrLst as Wt, createRight as X, createCdrBlipFill as Xa, createScRgbColor as Xc, createNumLit as Xi, createWpNestedGrpSp as Xn, createTransform2D as Xo, createCrossBetween as Xr, createFillOverlayEffect as Xs, LayoutDefHdrLstOptions as Xt, createQuickTimeFile as Y, createCdrAbsSizeAnchor as Ya, ScRgbColorOptions as Yc, createName as Yi, createWpLinkedTxbx as Yn, createGroupTransform2D as Yo, createClrMapOvr as Yr, FillOverlayEffectOptions as Ys, DiagramNameOptions as Yt, createRound as Z, createCdrCNvCxnSpPr as Za, RgbColorOptions as Zc, createOddFooter as Zi, createWpNvContentPartPr as Zn, Stretch as Zo, createCrossesAt as Zr, CompoundLine as Zs, LayoutDefHdrOptions as Zt, createChart as _, createSerLines as _a, BlipFillConfigOptions as _c, createFmtId as _i, PresLayoutVarsOptions as _n, createCdrSpPr as _o, createXdrCxnSp as _r, BevelOptions as _s, createUFillTx as _t, createBottom as a, createPictureOptions as aa, LineEndLength as ac, createDispUnits as ai, createColorTransforms as al, createStyleDefHdrLst as an, createCdrFrom as ao, XdrMarkerOptions as ar, GeomRect as as, createSym as at, createCustClr as b, createShowHorzBorder as ba, GradientStopOptions as bc, createGapWidth as bi, createAnimLvl as bn, createCdrTxBody as bo, createXdrGrpSpPr as br, createBottomBevel as bs, createUseSpRect as bt, createBuClrTx as c, createPivotFmts as ca, LineEndWidth as cc, createEvenFooter as ci, AnimLevelValue as cn, createCdrGrpSpPr as co, createXdrBlipFill as cr, PathOptions as cs, createTableStyleElement as ct, createBuSzTx as d, createPlus as da, createCustomDash as dc, createExt as di, AnimOneValue as dn, createCdrNvGrpSpPr as do, createXdrCNvPicPr as dr, PresetGeometryOptions as ds, createTl2br as dt, createOfPieType as ea, OutlineFillProperties as ec, createDLbl as ei, PresetColorOptions as el, createColorsDefHdr as en, createCdrCNvPicPr as eo, createWpStyle as er, createBlipFill as es, createSpDef as et, createCNvCxnSpPr as f, createPrintSettings as fa, createGroupFill as fc, createExtLst as fi, ChMaxOptions as fn, createCdrNvPicPr as fo, createXdrCNvPr as fr, GeometryGuide as fs, createTop as ft, createCell3D as g, createSelection as ga, createNoFill as gc, createFloor as gi, OrgChartOptions as gn, createCdrSp as go, createXdrContentPart as gr, createShape3D as gs, createUFill as gt, createCNvSpPr as h, createSecondPieSize as ha, createPatternFill as hc, createFirstHeader as hi, HierBranchStyle as hn, createCdrRelSizeAnchor as ho, createXdrColOff as hr, Shape3DOptions as hs, createTxSp as ht, createBldDgm as i, createPictureFormat as ia, createOutline as ic, createDispBlanksAs as ii, ColorTransformOptions as il, createStyleDefHdr as in, createCdrExt as io, createWpXfrm as ir, CustomGeometryOptions as is, createStyleElement as it, createGrpSpPr as j, createSplitType as ja, createGradientFill as jc, createLegendEntry as ji, WpLinkedTextboxOptions as jn, createShapeLocking as jo, createXdrStyle as jr, EffectDagOptions as js, ColorMethod as jt, createGraphicFrame as k, createSmooth as ka, RelativeRect as kc, createLeaderLines as ki, WpGraphicFrameOptions as kn, createGroupLocking as ko, createXdrSp as kr, createSoftEdgeEffect as ks, createDiagramRelIds as kt, createBuFontTx as l, createPivotSource as la, createLineEnd as lc, createEvenHeader as li, AnimLvlOptions as ln, createCdrNvCxnSpPr as lo, createXdrCNvCxnSpPr as lr, createCustomGeometry as ls, createThemeManager as lt, createCNvGrpSpPr as m, createSecondPiePt as ma, PresetPattern as mc, createFirstFooter as mi, HierBranchOptions as mn, createCdrPic as mo, createXdrCol as mr, PresetMaterialType as ms, createTxDef as mt, createBevelElement as n, createPageMargins as na, PenAlignment as nc, createDTable as ni, HslColorOptions as nl, createLayoutDefHdr as nn, createCdrCNvSpPr as no, createWpTxbxContent as nr, createBlip as ns, createStCxn as nt, createBr as o, createPictureStackUnit as oa, LineEndOptions as oc, createDispUnitsLbl as oi, AdjLstOptions as on, createCdrGraphicFrame as oo, XdrShapeAttributes as or, PathCommand as os, createTab as ot, createCNvGraphicFramePr as p, createProtection as pa, PatternFillOptions as pc, createExternalData as pi, ChPrefOptions as pn, createCdrNvSpPr as po, createXdrCNvSpPr as pr, createAdjustmentValues as ps, createTr2bl as pt, createOverrideClrMapping as q, createY as qa, SchemeColorOptions as qc, createMultiLvlStrCache as qi, createWpGrpSp as qn, GroupTransform2DOptions as qo, createBuiltInUnit as qr, createGlowEffect as qs, DiagramCategoryOptions as qt, createBldChart as r, createPageSetup as ra, PresetDash as rc, createData as ri, createHslColor as rl, createLayoutDefHdrLst as rn, createCdrCxnSp as ro, createWpWhole as rr, ConnectionSite as rs, createStart as rt, createBuBlip as s, createPivotFmt as sa, LineEndType as sc, createDownBars as si, AdjOptions as sn, createCdrGrpSp as so, XdrTwoCellAnchorOptions as sr, PathFillMode as ss, createTabLst as st, createAudioCd as t, createOverlap as ta, OutlineOptions as tc, createDPt as ti, createPresetColor as tl, createColorsDefHdrLst as tn, createCdrCNvPr as to, createWpTxbx as tr, BlipOptions as ts, createSt as tt, createBuSzPts as u, createPlotVisOnly as ua, DashStop as uc, createExplosion as ui, AnimOneOptions as un, createCdrNvGraphicFramePr as uo, createXdrCNvGrpSpPr as ur, PresetGeometry as us, createThemeOverride as ut, createClrMap as v, createShape as va, BlipFillMediaData as vc, createFormatting as vi, createAdj as vn, createCdrStyle as vo, createXdrFrom as vr, BevelPresetType as vs, createULn as vt, createDgm as w, createShowOutline as wa, GradientShadeOptions as wc, createHiLowLines as wi, createHierBranch as wn, GraphicFrameLockingOptions as wo, createXdrNvSpPr as wr, Point3D as ws, DiagramTextPropsOptions as wt, createCustClrLst as x, createShowKeys as xa, buildFill as xc, createH as xi, createAnimOne as xn, createCdrX as xo, createXdrNvCxnSpPr as xr, BackdropOptions as xs, createWavAudioFile as xt, createCpLocks as y, createShowDLblsOverMax as ya, FillOptions as yc, createGapDepth as yi, createAdjLst as yn, createCdrTo as yo, createXdrGrpSp as yr, createBevel as ys, createULnTx as yt, createLnBlToTr as z, createUpBars as za, createBlipEffects as zc, createMarker as zi, createWpCNvFrPr as zn, TableStyleRegion as zo, createApplyToSides as zr, PresetShadowVal as zs, createFillClrLst as zt };
4315
+ export { createStyleLbl as $, createSchemeColor as $a, zipAndConvert as $i, ReflectionEffectOptions as $n, xsdMaterialType as $r, TableStyleOptions as $t, scRgbColorDesc as A, GradientStop as Aa, convertToEmu as Ai, Shape3DOptions as An, SmartArtRelOptions as Ar, createAdj as At, DiagramRelIdsOptions as B, createTileInfo as Ba, DataType as Bi, Scene3DOptions as Bn, replaceChartPlaceholders as Br, GroupLockingOptions as Bt, fillDesc as C, BlipFillMediaData as Ca, convertEmuToPoints as Ci, PathOptions as Cn, LineEndOptions as Cr, AnimOneValue as Ct, hslColorDesc as D, extractBlipFillMedia as Da, convertPixelsToEmu as Di, GeometryGuide as Dn, DashStop as Dr, HierBranchStyle as Dt, getColorDescriptor as E, buildFill as Ea, convertMillimetersToTwip as Ei, stringifyPresetGeometry as En, createLineEnd as Er, HierBranchOptions as Et, DiagramExtensionOptions as F, TileFlipMode as Fa, compileMapping as Fi, createBottomBevel as Fn, getMediaRefs as Fr, createChPref as Ft, DiagramStyleOptions as G, SolidFillOptions as Ga, ZIP_STORED_LEVEL as Gi, EffectContainerType as Gn, replaceSmartArtPlaceholders as Gr, createPictureLocking as Gt, ColorListOptions as H, createSourceRectangle as Ha, PackerOptions as Hi, Vector3D as Hn, replaceImagePlaceholders as Hr, ShapeLockingOptions as Ht, DiagramTextPropsOptions as I, createGradientFill as Ia, ParsedArchive as Ii, BackdropOptions as In, getReferencedMedia as Ir, createHierBranch as It, StyleMatrixIndex as J, SystemColor as Ja, createPacker as Ji, BlurEffectOptions as Jn, xsdBlendMode as Jr, StyleMatrixReferenceOptions as Jt, FontCollectionIndex as K, createColorElement as Ka, ZipOptions as Ki, EffectDagOptions as Kn, replaceVideoPlaceholders as Kr, createShapeLocking as Kt, createDiagramExtLst as L, createGradientStop as La, parseArchive as Li, CameraOptions as Ln, getVideoRefs as Lr, createOrgChart as Lt, solidFillDesc as M, PathShadeOptions as Ma, convertUniversalMeasureToEmu as Mi, BevelOptions as Mn, collectPlaceholderKeys as Mr, createAnimLvl as Mt, systemColorDesc as N, PathShadeType as Na, convertUniversalMeasureToTwip as Ni, BevelPresetType as Nn, findAndReplaceImagePlaceholders as Nr, createAnimOne as Nt, presetColorDesc as O, GradientFillOptions as Oa, convertPointsToEmu as Oi, stringifyAdjustmentValues as On, createCustomDash as Or, OrgChartOptions as Ot, DiagramExtLstOptions as P, RelativeRect as Pa, parseUniversalMeasure as Pi, createBevel as Pn, formatId as Pr, createChMax as Pt, createLinClrLst as Q, SchemeColorOptions as Qa, unzipSync$1 as Qi, createEffectList as Qn, xsdLineEndSize as Qr, TableStyleListOptions as Qt, createDiagramSp3d as R, TileAlignment as Ra, CompileFn as Ri, LightRigOptions as Rn, hasPlaceholders as Rr, createPresLayoutVars as Rt, outlineDesc as S, BlipFillConfigOptions as Sa, convertEmuToPixels as Si, PathFillMode as Sn, LineEndLength as Sr, AnimOneOptions as St, patternFillDesc as T, GradientStopOptions as Ta, convertInchesToTwip as Ti, PresetGeometryOptions as Tn, LineEndWidth as Tr, ChPrefOptions as Tt, ColorMethod as U, BlipEffectsOptions as Ua, XmlifyedFile as Ui, createScene3D as Un, replaceMediaPlaceholders as Ur, createGraphicFrameLocking as Ut, createDiagramRelIds as V, SourceRectangleOptions as Va, Packer as Vi, SphereCoords as Vn, replaceHyperlinkPlaceholders as Vr, PictureLockingOptions as Vt, DiagramStyleLblOptions as W, createBlipEffects as Wa, ZIP_DEFLATE_LEVEL as Wi, createSoftEdgeEffect as Wn, replaceNumberingPlaceholders as Wr, createGroupLocking as Wt, createEffectClrLst as X, createSystemColor as Xa, strFromU8$1 as Xi, EffectListOptions as Xn, xsdEffectContainer as Xr, TableCellStyleOptions as Xt, createDiagramStyle as Y, SystemColorOptions as Ya, createZipStream as Yi, EffectExtent as Yn, xsdCompoundLine as Yr, TableCellBorderOptions as Yt, createFillClrLst as Z, SchemeColor as Za, toUint8Array as Zi, calculateEffectExtent as Zn, xsdLineCap as Zr, TablePartStyleOptions as Zt, graphicFrameLockingDesc as _, createGroupFill as _a, hashPasswordAgile as _i, createBlip as _n, OutlineFillProperties as _r, createStyleDefHdrLst as _t, blipDesc as a, CoreProperties as aa, xsdStrikeStyle as ai, MediaDataTransformation as an, PresetColorOptions as ao, RectAlignment as ar, DiagramCategoryOptions as at, shapeLockingDesc as b, createPatternFill as ba, PixelPosition as bi, GeomRect as bn, PresetDash as br, AnimLevelValue as bt, stretchDesc as c, parseCorePropsElement as ca, xsdTextCaps as ci, GroupTransform2DOptions as cn, createHslColor as co, createInnerShadowEffect as cr, LayoutDefHdrLstOptions as ct, scene3DDesc as d, createDefault as da, UniqueNumericIdCreator as di, createTransform2D as dn, BlendMode as dr, StyleDefHdrOptions as dt, zipSyncAndConvert as ea, xsdPathFillMode as ei, TableStyleRegion as en, ScRgbColorOptions as eo, createReflectionEffect as er, createTxEffectClrLst as et, shape3DDesc as f, createOverride as fa, hashedId as fi, stringifyStretch as fn, FillOverlayEffectOptions as fr, createColorsDefHdr as ft, presetGeometryDesc as g, APP_PROPS_XML as ga, derivePasswordHash as gi, BlipOptions as gn, LineJoin as gr, createStyleDefHdr as gt, customGeometryDesc as h, TargetModeType as ha, uniqueUuid as hi, createBlipFill as hn, LineCap as hr, createLayoutDefHdrLst as ht, presLayoutVarsDesc as i, convertOutput as ia, xsdRectAlignment as ii, createTableStyleList as in, PresetColor as io, OuterShadowEffectOptions as ir, ColorsDefHdrOptions as it, schemeColorDesc as j, LinearShadeOptions as ja, convertToTwip as ji, createShape3D as jn, addSmartArtRelationships as jr, createAdjLst as jt, rgbColorDesc as k, GradientShadeOptions as ka, convertPositionToEmu as ki, PresetMaterialType as kn, IdFormat as kr, PresLayoutVarsOptions as kt, tileDesc as l, DefaultAttributes as la, xsdUnderlineStyle as li, Transform2DOptions as ln, ColorTransformOptions as lo, GlowEffectOptions as lr, LayoutDefHdrOptions as lt, transform2DDesc as m, Relationships as ma, uniqueNumericIdCreator as mi, BlipFillOptions as mn, CompoundLine as mr, createLayoutDefHdr as mt, diagramRelIdsDesc as n, OutputByType as na, xsdPenAlignment as ni, ThemeableLineStyleOptions as nn, RgbColorOptions as no, PresetShadowVal as nr, createTxLinClrLst as nt, blipFillDesc as o, buildCorePropertiesXml as oa, xsdTextAlign as oi, MediaTransformation as on, createPresetColor as oo, createOuterShadowEffect as or, DiagramDescriptionOptions as ot, groupTransform2DDesc as p, RelationshipType as pa, uniqueId as pi, createExtentionList as pn, createFillOverlayEffect as pr, createColorsDefHdrLst as pt, HueDirection as q, createSolidFill as qa, Zippable$1 as qi, createEffectDag as qn, invertMap as qr, OnOffStyleType as qt, diagramStyleDesc as r, OutputType as ra, xsdPresetShadow as ri, createTableStyle as rn, createRgbColor as ro, createPresetShadowEffect as rr, ColorsDefHdrLstOptions as rt, sourceRectangleDesc as s, buildCorePropertiesXmlString as sa, xsdTextAnchor as si, createTransformation as sn, HslColorOptions as so, InnerShadowEffectOptions as sr, DiagramNameOptions as st, diagramExtLstDesc as t, OoxmlMimeType as ta, xsdPattern as ti, TableTextStyleOptions as tn, createScRgbColor as to, PresetShadowEffectOptions as tr, createTxFillClrLst as tt, bevelDesc as u, OverrideAttributes as ua, xsdVerticalMergeRev as ui, createGroupTransform2D as un, createColorTransforms as uo, createGlowEffect as ur, StyleDefHdrLstOptions as ut, groupLockingDesc as v, PatternFillOptions as va, randomBytes as vi, ConnectionSite as vn, OutlineOptions as vr, AdjLstOptions as vt, gradientFillDesc as w, FillOptions as wa, convertInchesToEmu as wi, createCustomGeometry as wn, LineEndType as wr, ChMaxOptions as wt, effectListDesc as x, createNoFill as xa, convertEmuToInches as xi, PathCommand as xn, createOutline as xr, AnimLvlOptions as xt, pictureLockingDesc as y, PresetPattern as ya, EmuPosition as yi, CustomGeometryOptions as yn, PenAlignment as yr, AdjOptions as yt, createDiagramTxPr as z, TileOptions as za, CompressionOptions as zi, Point3D as zn, replaceAllPlaceholders as zr, GraphicFrameLockingOptions as zt };