pptx-ts 4.0.0 → 4.1.0

package/dist/{text-KnLOtEEu.js → text-BvFFMMFQ.js}

@@ -1,18 +1,18 @@
-import { l as warn, n as InvalidOptionError, r as MediaError, t as InternalError, u as warnOnce } from "./errors-C4oENPcu.js";
-import { F as DEF_PRES_LAYOUT_NAME, J as SLDNUM_PLACEHOLDER_TEXT, P as DEF_PRES_LAYOUT, R as DEF_SLIDE_MARGIN_IN, U as LEVEL_MARGINS_EMU, V as LAYOUT_IDX_SERIES_BASE, X as MIN_SLIDE_MASTER_ID, a as convertRotationDegrees, n as clampRangedInput, q as SLDNUMFLDID, s as getSmartParseNumber, u as mapStated, v as resolveInsetsEmu } from "./units-internal-XJlf-hOl.js";
-import { A as inchesToEmu, D as emuToInches, F as EMU_PER_INCH, T as STANDARD_LAYOUTS } from "./table-cell-margins-EVg0EwxT.js";
-import { $t as THEME_REL, Bt as PRES_PROPS_CONTENT_TYPE, Dt as MS_MEDIA_REL, E as EMBEDDED_FONT_SLOTS, Ft as OFFICE_DOCUMENT_REL, Gt as SLIDE_LAYOUT_CONTENT_TYPE, Ht as RELATIONSHIPS_CONTENT_TYPE, Jt as SLIDE_MASTER_REL, Kt as SLIDE_LAYOUT_REL, Nt as NOTES_SLIDE_REL, Qt as THEME_CONTENT_TYPE, Vt as PRES_PROPS_REL, Wt as SLIDE_CONTENT_TYPE, Xt as TABLE_STYLES_CONTENT_TYPE, Yt as SLIDE_REL, Zt as TABLE_STYLES_REL, _t as CORE_PROPS_REL, a as textAlignToken, an as PML_ROOT_NS, at as CHARTEX_REL, bt as EXTENDED_PROPS_CONTENT_TYPE, c as checkEnumOrThrow, cn as decodeBase64ToBytes, d as xsdBool, dn as toMediaDataUri, en as VIDEO_REL, f as xsdBoolIfTrue, gt as CORE_PROPS_CONTENT_TYPE, h as stripHash, ht as COMMENT_AUTHORS_REL, in as OOXML_NS, jt as NOTES_MASTER_REL, l as checkEnumOrWarn, lt as CHART_REL, nn as VIEW_PROPS_REL, nt as TRANSITION_VARIANT_ATTRIBUTES, p as isHexColor, pt as COMMENTS_REL, qt as SLIDE_MASTER_CONTENT_TYPE, rt as AUDIO_REL, sn as bytesToBase64, tn as VIEW_PROPS_CONTENT_TYPE, tt as TRANSITION_TYPES, vt as CUSTOM_PROPS_CONTENT_TYPE, w as DEFAULT_COLOR_MAP, wt as IMAGE_REL, xt as EXTENDED_PROPS_REL, yt as CUSTOM_PROPS_REL, zt as PRESENTATION_MAIN_CONTENT_TYPE } from "./image-size-CvN2iCA4.js";
-import { a as avContentType, i as audioExtensionForSubtype, o as dataUriMediaType, s as imageContentType } from "./text-anchor-CrYXAfUu.js";
-import { At as getDuplicateObjectNames, C as targetBetweenPptSubparts, Ct as FONT_DATA_CONTENT_TYPE, D as cNvPrEl, Dt as serializeEmbeddedFontLst, Et as flattenEmbeddedFaces, G as clampParaMarginInchesEmu, It as preencodedPath, K as buAutoNumEl, N as spTreeEl, Nt as isHyperlinkRel, Ot as XML_DECL, Pt as isPreencodedPath, R as prstGeomRect, Rt as encodeXmlAttrValue, S as slidePath, St as voidEl, T as targetFromPresentation, Tt as FONT_REL_TYPE, U as clampFontSizeSz, W as clampParaIndentInchesEmu, _ as fontPath, at as fillNamesPaint, b as relsPath, bt as elOrVoid, c as themeFontDefRPr, f as relationshipsPart, g as commentPath, h as SLIDE_MASTER_PATH, ht as createColorElement, i as makeXmlNotesSlide, j as grpXfrmEl, jt as getNewRelId, kt as bracedGuid, l as externalHyperlinkRel, m as PRESENTATION_PATH, n as makeXmlNotesMaster, ot as genXmlColorSelection, p as NOTES_MASTER_PATH, q as buCharEl, s as lvlPPr, t as buildNotesSlideRels, u as relationshipEl, ut as STRETCH_FILL_RECT, v as notesSlidePath, vt as rejectEmptyColor, w as targetFromPptSubpart, wt as FONT_DATA_EXTENSION, x as slideLayoutPath, xt as raw, y as overrideName, yt as el } from "./notes-Dh12JAbn.js";
-import { A as renderedSlideObjects, B as pushMediaRel, C as msMediaRid, D as findLayoutPlaceholder, E as placeholderOptionsForSlide, F as warnUnauthoredChild, I as SLIDE_METHOD_FAMILIES, L as composeFamilies, M as shapeIdCount, N as addChildDefinition, O as resolveTextAnchor, P as isGroupableObject, R as familyMethodUnavailable, S as alternateContentEl, T as addTextDefinition, V as resolveImageSource, _ as chartPartNames, a as mediaFamily, b as GROUP_SHAPE_LOCK_ATTRS, c as commentsFamily, d as textFamily, f as shapeFamily, g as makeXmlCore, h as groupFamily, i as model3dFamily, j as resolveObjectNameToId, k as collectSlideShapeIds, l as chartFamily, m as imageFamily, n as tableFamily, o as measureFamily, p as notesFamily, r as oleFamily, s as connectorFamily, t as zoomFamily, u as animationsFamily, v as FMT_SCHEME_XML, w as previewRid, x as genXmlObjectLock, y as resolveImageExtent, z as requirePresentationAuthor } from "./zoom-cX9sllpH.js";
+import { l as warn, n as InvalidOptionError, r as MediaError, t as InternalError, u as warnOnce } from "./errors-Da2nXCJm.js";
+import { F as DEF_PRES_LAYOUT_NAME, J as SLDNUM_PLACEHOLDER_TEXT, P as DEF_PRES_LAYOUT, R as DEF_SLIDE_MARGIN_IN, U as LEVEL_MARGINS_EMU, V as LAYOUT_IDX_SERIES_BASE, X as MIN_SLIDE_MASTER_ID, a as convertRotationDegrees, n as clampRangedInput, q as SLDNUMFLDID, s as getSmartParseNumber, u as mapStated, v as resolveInsetsEmu } from "./units-internal-DFcUYjh3.js";
+import { A as inchesToEmu, D as emuToInches, F as EMU_PER_INCH, T as STANDARD_LAYOUTS } from "./table-cell-margins-PDshga8T.js";
+import { $t as THEME_CONTENT_TYPE, Bt as PRESENTATION_MAIN_CONTENT_TYPE, E as EMBEDDED_FONT_SLOTS, Gt as SLIDE_CONTENT_TYPE, Ht as PRES_PROPS_REL, It as OFFICE_DOCUMENT_REL, Jt as SLIDE_MASTER_CONTENT_TYPE, Kt as SLIDE_LAYOUT_CONTENT_TYPE, Mt as NOTES_MASTER_REL, Ot as MS_MEDIA_REL, Pt as NOTES_SLIDE_REL, Qt as TABLE_STYLES_REL, St as EXTENDED_PROPS_REL, Tt as IMAGE_REL, Ut as RELATIONSHIPS_CONTENT_TYPE, Vt as PRES_PROPS_CONTENT_TYPE, Xt as SLIDE_REL, Yt as SLIDE_MASTER_REL, Zt as TABLE_STYLES_CONTENT_TYPE, _t as CORE_PROPS_CONTENT_TYPE, a as textAlignToken, an as OOXML_NS, bt as CUSTOM_PROPS_REL, c as checkEnumOrThrow, cn as bytesToBase64, d as xsdBool, en as THEME_REL, f as xsdBoolIfTrue, fn as toMediaDataUri, gt as COMMENT_AUTHORS_REL, h as stripHash, it as AUDIO_REL, l as checkEnumOrWarn, ln as decodeBase64ToBytes, mt as COMMENTS_REL, nn as VIEW_PROPS_CONTENT_TYPE, nt as TRANSITION_TYPES, on as PML_ROOT_NS, ot as CHARTEX_REL, p as isHexColor, qt as SLIDE_LAYOUT_REL, rn as VIEW_PROPS_REL, rt as TRANSITION_VARIANT_ATTRIBUTES, tn as VIDEO_REL, ut as CHART_REL, vt as CORE_PROPS_REL, w as DEFAULT_COLOR_MAP, xt as EXTENDED_PROPS_CONTENT_TYPE, yt as CUSTOM_PROPS_CONTENT_TYPE } from "./image-size-DwDbakcl.js";
+import { a as avContentType, i as audioExtensionForSubtype, o as dataUriMediaType, s as imageContentType } from "./text-anchor-BgLPbwbL.js";
+import { At as getDuplicateObjectNames, C as targetBetweenPptSubparts, Ct as FONT_DATA_CONTENT_TYPE, D as cNvPrEl, Dt as serializeEmbeddedFontLst, Et as flattenEmbeddedFaces, G as clampParaMarginInchesEmu, It as preencodedPath, K as buAutoNumEl, N as spTreeEl, Nt as isHyperlinkRel, Ot as XML_DECL, Pt as isPreencodedPath, R as prstGeomRect, Rt as encodeXmlAttrValue, S as slidePath, St as voidEl, T as targetFromPresentation, Tt as FONT_REL_TYPE, U as clampFontSizeSz, W as clampParaIndentInchesEmu, _ as fontPath, at as fillNamesPaint, b as relsPath, bt as elOrVoid, c as themeFontDefRPr, f as relationshipsPart, g as commentPath, h as SLIDE_MASTER_PATH, ht as createColorElement, i as makeXmlNotesSlide, j as grpXfrmEl, jt as getNewRelId, kt as bracedGuid, l as externalHyperlinkRel, m as PRESENTATION_PATH, n as makeXmlNotesMaster, ot as genXmlColorSelection, p as NOTES_MASTER_PATH, q as buCharEl, s as lvlPPr, t as buildNotesSlideRels, u as relationshipEl, ut as STRETCH_FILL_RECT, v as notesSlidePath, vt as rejectEmptyColor, w as targetFromPptSubpart, wt as FONT_DATA_EXTENSION, x as slideLayoutPath, xt as raw, y as overrideName, yt as el } from "./notes-BcT571R4.js";
+import { A as renderedSlideObjects, B as pushMediaRel, C as msMediaRid, D as findLayoutPlaceholder, E as placeholderOptionsForSlide, F as warnUnauthoredChild, I as SLIDE_METHOD_FAMILIES, L as composeFamilies, M as shapeIdCount, N as addChildDefinition, O as resolveTextAnchor, P as isGroupableObject, R as familyMethodUnavailable, S as alternateContentEl, T as addTextDefinition, V as resolveImageSource, _ as chartPartNames, a as mediaFamily, b as GROUP_SHAPE_LOCK_ATTRS, c as commentsFamily, d as textFamily, f as shapeFamily, g as makeXmlCore, h as groupFamily, i as model3dFamily, j as resolveObjectNameToId, k as collectSlideShapeIds, l as chartFamily, m as imageFamily, n as tableFamily, o as measureFamily, p as notesFamily, r as oleFamily, s as connectorFamily, t as zoomFamily, u as animationsFamily, v as FMT_SCHEME_XML, w as previewRid, x as genXmlObjectLock, y as resolveImageExtent, z as requirePresentationAuthor } from "./zoom-BoNyOlPm.js";
 import { n as setOrClear, t as pickDefined } from "./options-internal-WqgMf720.js";
-import { b as isFontCollection, g as FontMetricsRegistry, t as applyMeasuredFit, y as parseFontMetrics } from "./fit-Cb7naFj6.js";
-import { t as ZipWriter } from "./zip-CKd8ihcf.js";
+import { b as isFontCollection, g as FontMetricsRegistry, t as applyMeasuredFit, y as parseFontMetrics } from "./fit-CcXbg__l.js";
+import { t as ZipWriter } from "./zip-CYZ0F6BV.js";
 import { t as transitionSpeedForDuration } from "./transition-speed-kUEWDWTx.js";
 import { n as presentationFormatLabel, r as slideSizeType } from "./slide-size-BalTjFuv.js";
 //#region src/gen/define/background.ts
 /**
-* ts-pptx: Background Definition
+* pptx-ts: Background Definition
 *
 * Registers an `addBackground()` image as a slide media rel (color backgrounds carry no rel);
 * the `<p:bg>` XML is emitted later at slide / layout serialize time.
@@ -272,7 +272,7 @@ var SlideBuilder = class {
 //#endregion
 //#region src/font-source.ts
 /**
-* ts-pptx: getting font bytes out of whatever the caller handed over.
+* pptx-ts: getting font bytes out of whatever the caller handed over.
 *
 * `registerFontMetrics` and `embedFont` are two public methods on one class, forty lines apart,
 * and each resolved its source itself. They agreed on `Uint8Array` and `ArrayBuffer` and
@@ -371,7 +371,7 @@ const IMG_SVG_PLACEHOLDER = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAA
 //#endregion
 //#region src/gen/media.ts
 /**
-* ts-pptx: Media Methods
+* pptx-ts: Media Methods
 */
 function hasEncodingPath(rel) {
 	return typeof rel.path === "string" && rel.path.length > 0 && !isPreencodedPath(rel.path);
@@ -448,7 +448,7 @@ function encodeSlideMediaRels(layout, runtime, onMediaError = "throw") {
 //#endregion
 //#region src/gen/prepare.ts
 /**
-* ts-pptx: the pre-serialization pass
+* pptx-ts: the pre-serialization pass
 *
 * Everything that must happen to authored slide state *before* any XML is built. Two callers
 * reach serialization and both need it:
@@ -1446,7 +1446,7 @@ function slideObjectRelationsToXml(slide, defaultRels, selfPath) {
 //#endregion
 //#region src/gen/slide/slide.ts
 /**
-* ts-pptx: slide part + slide/layout rels
+* pptx-ts: slide part + slide/layout rels
 *
 * Emit a slide (`ppt/slides/slideN.xml`) and the relationship files for slides
 * and layouts (`slideN.xml.rels`, `slideLayoutN.xml.rels`).
@@ -1521,7 +1521,7 @@ function getLayoutIdxForSlide(slides, slideLayouts, slideNumber) {
 //#endregion
 //#region src/gen/pres/theme.ts
 /**
-* ts-pptx: `ppt/theme/theme1.xml`
+* pptx-ts: `ppt/theme/theme1.xml`
 *
 * Emit the Office theme: the `<a:clrScheme>` (with any caller color overrides
 * over the default Office scheme) plus the fixed font/format schemes.
@@ -1877,7 +1877,7 @@ async function extractSlides(source, opts = {}) {
 //#endregion
 //#region src/gen/opc/app.ts
 /**
-* ts-pptx: `docProps/app.xml`
+* pptx-ts: `docProps/app.xml`
 *
 * Emit the extended-properties part (application, slide/notes counts, heading
 * pairs, titles of parts, company).
@@ -1960,7 +1960,7 @@ function makeXmlApp(slides, company, presLayout) {
 //#endregion
 //#region src/gen/opc/content-types.ts
 /**
-* ts-pptx: `[Content_Types].xml`
+* pptx-ts: `[Content_Types].xml`
 *
 * Emit the package content-types part: Default entries for the media extensions
 * actually used by the deck (plus the font default when faces are embedded) and
@@ -2056,7 +2056,7 @@ function makeXmlContTypes(opts) {
 //#endregion
 //#region src/gen/opc/custom-props.ts
 /**
-* ts-pptx: `docProps/custom.xml`
+* pptx-ts: `docProps/custom.xml`
 *
 * Emit the custom-properties part from caller-supplied name/value pairs (bool,
 * date, number and string value types).
@@ -2089,7 +2089,7 @@ function makeXmlCustomProperties(props) {
 //#endregion
 //#region src/gen/opc/root-rels.ts
 /**
-* ts-pptx: `_rels/.rels`
+* pptx-ts: `_rels/.rels`
 *
 * Emit the package root relationships (app/core/presentation, plus custom-props
 * when present).
@@ -2163,7 +2163,7 @@ function makeXmlPresentationRels(slides, embeddedFonts) {
 //#endregion
 //#region src/gen/pres/presentation.ts
 /**
-* ts-pptx: `ppt/presentation.xml` + presProps/viewProps
+* pptx-ts: `ppt/presentation.xml` + presProps/viewProps
 *
 * Emit the presentation part (masters/notes/slide id lists, sizes, embedded-font
 * list, default text styles, sections) and the small presProps/viewProps parts.
@@ -2278,7 +2278,7 @@ function makeXmlTableStyles() {
 //#endregion
 //#region src/gen/slide/layout.ts
 /**
-* ts-pptx: slide-layout part
+* pptx-ts: slide-layout part
 *
 * Emit a slide layout (`ppt/slideLayouts/slideLayoutN.xml`) from a layout object.
 */
@@ -2300,7 +2300,7 @@ function makeXmlLayout(layout, renderers) {
 //#endregion
 //#region src/gen/slide/master.ts
 /**
-* ts-pptx: slide-master parts
+* pptx-ts: slide-master parts
 *
 * The slide master (`slideMaster1.xml`) and its `.rels`, plus the master text
 * styles (`<p:txStyles>`): per-level default values mirroring the built-in
@@ -2931,7 +2931,7 @@ async function writePackage(source, props) {
 //#endregion
 //#region src/presentation.ts
 /**
-* ts-pptx: the presentation core
+* pptx-ts: the presentation core
 *
 * Home of {@link PresentationCore}, the class every entry point subclasses with a runtime
 * adapter (`index.ts`, `node.ts`, `browser.ts`). See the class doc below for the layout of
@@ -2944,7 +2944,7 @@ async function writePackage(source, props) {
 * the OfficeGen project (Copyright 2013 Ziv Barber). This project is likewise MIT; the full
 * license text is in `LICENSE` at the repository root.
 */
-const VERSION = "4.0.0";
+const VERSION = "4.1.0";
 function standardLayoutToPresLayout(layout) {
 	return {
 		name: layout.name,
@@ -3017,7 +3017,7 @@ var PresentationCore = class {
 		return this._layout;
 	}
 	/**
-	* ts-pptx Library Version
+	* pptx-ts Library Version
 	*/
 	_version = VERSION;
 	get version() {
@@ -3191,11 +3191,11 @@ var PresentationCore = class {
 			LAYOUT_16x10: standardLayoutToPresLayout(STANDARD_LAYOUTS.LAYOUT_16x10),
 			LAYOUT_WIDE: standardLayoutToPresLayout(STANDARD_LAYOUTS.LAYOUT_WIDE)
 		};
-		this._author = "ts-pptx";
-		this._company = "ts-pptx";
+		this._author = "pptx-ts";
+		this._company = "pptx-ts";
 		this._revision = "1";
-		this._subject = "ts-pptx Presentation";
-		this._title = "ts-pptx Presentation";
+		this._subject = "pptx-ts Presentation";
+		this._title = "pptx-ts Presentation";
 		const defLayout = this.#requireDefaultLayout();
 		this._presLayout = {
 			name: defLayout.name,
@@ -3255,7 +3255,7 @@ var PresentationCore = class {
 	*/
 	getSections = () => this._sections;
 	/**
-	* Enables the `Slide` class to set ts-pptx [Presentation] master/layout slidenumbers
+	* Enables the `Slide` class to set pptx-ts [Presentation] master/layout slidenumbers
 	* @param {SlideNumberProps} slideNum - slide number config
 	*/
 	setSlideNumber = (slideNum) => {
@@ -3458,7 +3458,9 @@ var PresentationCore = class {
 	/**
 	* Export the current Presentation as ZIP content with the selected type
 	* @param {WriteProps} props output properties
-	* @returns {Promise<string | ArrayBuffer | Blob | Uint8Array>} file content in selected type
+	* @returns file content in the selected type: a `Blob` when `outputType` is left out, else
+	* the {@link WriteOutputMap} entry for it
+	* @example const bytes = await pptx.write({ outputType: 'uint8array' }) // Uint8Array, no cast
 	*/
 	async write(props) {
 		return await writePackage(this.packageSource(), pickDefined(props ?? {}, [
@@ -3650,7 +3652,7 @@ var PresentationCore = class {
 //#endregion
 //#region src/families/core.ts
 /**
-* ts-pptx: the construct families every presentation carries
+* pptx-ts: the construct families every presentation carries
 *
 * The core tier. A composed presentation gets these whether it asks for them or not, so
 * `createPresentation()` with no families still authors text, shapes, images, groups and speaker
@@ -3672,7 +3674,7 @@ const CORE_CONSTRUCT_FAMILIES = [
 //#endregion
 //#region src/entry-compose.ts
 /**
-* ts-pptx: composing a presentation from the construct families it actually needs
+* pptx-ts: composing a presentation from the construct families it actually needs
 *
 * The body behind each entry's `createPresentation`, and the types that describe what comes back.
 * It lives beside `entry-surface.ts` for the same reason that does: `index.ts`, `node.ts` and
@@ -3700,7 +3702,7 @@ function composePresentation(runtime, opts) {
 //#endregion
 //#region src/entry-families.ts
 /**
-* ts-pptx: the construct families the three main entries are composed with
+* pptx-ts: the construct families the three main entries are composed with
 *
 * The full authoring surface, as a list: `index.ts`, `node.ts` and `browser.ts` each compose every
 * family, so `TsPptx` authors everything it ever has; the browser entry adds the table family's
@@ -3803,7 +3805,7 @@ async function placeholderSvgPreview(rel) {
 //#endregion
 //#region src/clip.ts
 /**
-* ts-pptx: named clip silhouettes for images
+* pptx-ts: named clip silhouettes for images
 *
 * A `ClipShape` is declarative data — a named silhouette plus its options — and {@link clipPath}
 * resolves it to the freeform `points` path `addImage` emits as the `<a:custGeom>` clip mask on
@@ -3977,4 +3979,4 @@ function textRuns(runs) {
 //#endregion
 export { fetchMediaBase64 as a, ALL_CONSTRUCT_FAMILIES as c, IMG_SVG_PLACEHOLDER as d, fetchFontBytes as i, composePresentation as l, textRuns as n, isRemote as o, clipPath as r, placeholderSvgPreview as s, textRun as t, PresentationCore as u };
 
-//# sourceMappingURL=text-KnLOtEEu.js.map
+//# sourceMappingURL=text-BvFFMMFQ.js.map