@shbernal/ts-pptx 3.3.0 → 3.5.0

package/dist/{st-enums-bVnezkMJ.js → namespaces-CcKuzeuE.js}

@@ -1,5 +1,209 @@
-import { r as warnOnce } from "./diagnostics-H1QzgRSw.js";
+import { i as warnOnce } from "./diagnostics-CPVADSL1.js";
 import { n as InvalidOptionError } from "./errors-Bvln0H-7.js";
+//#region src/ooxml/check-enum.ts
+/**
+* Check a value against its `ST_` union, reporting and dropping it when outside (the write-path
+* policy — see the module note).
+*
+* `undefined`/`null` returns `null` without reporting: an unset option is not an invalid one, and
+* it is by far the common case.
+*
+* The offending value is interpolated into the message deliberately. {@link warnOnce} dedups on
+* code **and** message, so keeping the value in the text is what lets a second, *different* bad
+* value under the same code still get reported.
+* @param value - the value the caller supplied, if any
+* @param valid - the enum's members
+* @param code - the condition to report
+* @param label - how to name the offending option in the message, e.g. ``'table cell: cell3D `preset`'``
+* @param detail - extra structured context to merge into the diagnostic's `detail`
+* @returns the value when legal, else `null`
+*/
+function checkEnumOrWarn(value, valid, code, label, detail) {
+	if (value === void 0 || value === null) return null;
+	if (valid.includes(value)) return value;
+	warnOnce(code, `${label} value \`${String(value)}\` is not valid and is ignored — use one of ${valid.join(", ")}.`, {
+		received: value,
+		valid,
+		...detail
+	});
+	return null;
+}
+/**
+* Check a value against its `ST_` union, throwing when outside (the read/edit-path policy — see
+* the module note).
+* @param value - the value the caller asked for
+* @param valid - the enum's members
+* @param attribute - the attribute's name, for the message
+* @param code - the condition to report
+* @returns `value`, when it is legal
+*/
+function checkEnumOrThrow(value, valid, attribute, code) {
+	if (valid.includes(value)) return value;
+	throw new InvalidOptionError(code, `Invalid ${attribute}: ${JSON.stringify(value)}. Expected one of: ${valid.join(", ")}.`);
+}
+//#endregion
+//#region src/ooxml/st-enums.ts
+/**
+* `ST_` simple-type enumerations from ECMA-376, declared once as the single source of both the
+* TypeScript union a caller is checked against and the runtime list a value is validated against.
+*
+* **The problem this solves.** Each of these used to exist twice: a hand-written string union in
+* `src/types/` (what the compiler enforces) and a hand-written array in `src/gen/` or `src/read/`
+* (what the validator checks at run time). Nothing tied the two together, so adding a member to
+* one and not the other produced either a value TypeScript accepts and the validator drops, or a
+* value the validator passes and the type rejects. Two of them had already diverged in *order*,
+* which is harmless, but nothing would have caught a divergence in *content*.
+*
+* **The shape.** Every entry is a `readonly` tuple declared `as const`, with its union derived via
+* `(typeof X)[number]`. Widening the tuple widens the union in the same edit — they cannot drift.
+* This is the idiom already used for `EMBEDDED_FONT_SLOTS` and `EXTRA_SHAPE_PRESETS`; this module
+* brings the stragglers onto it.
+*
+* **Why this module is neither `gen/` nor `read/`.** `src/types/` needs the unions for the public
+* write API, `src/gen/` needs the tuples to vet a value before emitting it, and `src/read/` needs
+* them to vet a value before writing it into a loaded part. It is a fact about the schema, so it
+* belongs to none of the three.
+*
+* Values are listed in **schema declaration order**, which is the order the diagnostics print
+* when they tell a caller what is legal.
+*/
+/**
+* `ST_BevelPresetType` — the bevel profile applied to a 3-D edge.
+* @see ECMA-376 Part 1 §20.1.10.9
+*/
+const BEVEL_PRESETS = [
+	"relaxedInset",
+	"circle",
+	"slope",
+	"cross",
+	"angle",
+	"softRound",
+	"convex",
+	"coolSlant",
+	"divot",
+	"riblet",
+	"hardEdge",
+	"artDeco"
+];
+/**
+* `ST_PresetMaterialType` — how a 3-D surface responds to light.
+* @see ECMA-376 Part 1 §20.1.10.50
+*/
+const PRESET_MATERIALS = [
+	"legacyMatte",
+	"legacyPlastic",
+	"legacyMetal",
+	"legacyWireframe",
+	"matte",
+	"plastic",
+	"metal",
+	"warmMatte",
+	"translucentPowder",
+	"powder",
+	"dkEdge",
+	"softEdge",
+	"clear",
+	"flat",
+	"softmetal"
+];
+/**
+* `ST_LightRigType` — the preset lighting scene.
+* @see ECMA-376 Part 1 §20.1.10.35
+*/
+const LIGHT_RIGS = [
+	"legacyFlat1",
+	"legacyFlat2",
+	"legacyFlat3",
+	"legacyFlat4",
+	"legacyNormal1",
+	"legacyNormal2",
+	"legacyNormal3",
+	"legacyNormal4",
+	"legacyHarsh1",
+	"legacyHarsh2",
+	"legacyHarsh3",
+	"legacyHarsh4",
+	"threePt",
+	"balanced",
+	"soft",
+	"harsh",
+	"flood",
+	"contrasting",
+	"morning",
+	"sunrise",
+	"sunset",
+	"chilly",
+	"freezing",
+	"flat",
+	"twoPt",
+	"glow",
+	"brightRoom"
+];
+/**
+* `ST_LightRigDirection` — where the light rig sits relative to the scene.
+* @see ECMA-376 Part 1 §20.1.10.33
+*/
+const LIGHT_RIG_DIRECTIONS = [
+	"tl",
+	"t",
+	"tr",
+	"l",
+	"r",
+	"bl",
+	"b",
+	"br"
+];
+/**
+* `ST_TextHorzOverflowType` — `a:bodyPr/@horzOverflow` and `a:tcPr/@horzOverflow`.
+* @see ECMA-376 Part 1 §20.1.10.68
+*/
+const TEXT_HORZ_OVERFLOW = ["clip", "overflow"];
+/**
+* `ST_TextAnchoringType` — `a:bodyPr/@anchor` and `a:tcPr/@anchor`.
+* @see ECMA-376 Part 1 §20.1.10.60
+*/
+const TEXT_ANCHORS = [
+	"t",
+	"ctr",
+	"b",
+	"just",
+	"dist"
+];
+/**
+* `ST_TextVerticalType` — `a:bodyPr/@vert` and `a:tcPr/@vert`.
+* @see ECMA-376 Part 1 §20.1.10.83
+*/
+const TEXT_VERTICAL = [
+	"horz",
+	"vert",
+	"vert270",
+	"wordArtVert",
+	"eaVert",
+	"mongolianVert",
+	"wordArtVertRtl"
+];
+/**
+* `ST_PresetLineDashVal` — the dash pattern of a line or border (`a:prstDash/@val`).
+*
+* The `sys*` members are the "system" dashes whose exact dot/gap ratio the renderer picks; the
+* rest are defined by the spec. Both `BorderProps.dashType` and `ShapeLineProps.dashType` accept
+* this whole set, so a caller who knows one knows the other.
+* @see ECMA-376 Part 1 §20.1.10.49
+*/
+const PRESET_LINE_DASHES = [
+	"solid",
+	"dot",
+	"dash",
+	"lgDash",
+	"dashDot",
+	"lgDashDot",
+	"lgDashDotDot",
+	"sysDash",
+	"sysDot",
+	"sysDashDot",
+	"sysDashDotDot"
+];
+//#endregion
 //#region src/media/base64.ts
 /**
 * Base64 payload handling for media parts — isomorphic across Node and browsers
@@ -31,6 +235,26 @@ function bytesToBase64(bytes) {
 	return btoa(binary);
 }
 /**
+* Present a freshly loaded media payload as a `data:` URI.
+*
+* A {@link RuntimeAdapter.loadMedia} implementation returns whichever encoding its host
+* makes cheap — the browser adapter a full URI, because `FileReader.readAsDataURL` is what
+* decodes a blob without blocking; Node and the neutral adapter raw base64, because neither
+* has a `FileReader`. This is where the two become one, so nothing downstream of the load
+* has to ask which it got.
+*
+* The mime label is documentary: {@link decodeBase64ToBytes} ignores it, and the one consumer
+* that needs a real URI (`image.src`, in the browser adapter's SVG preview) is handed the
+* adapter's own. It is taken from the rel anyway rather than hard-coded, so an already-correct
+* label is not overwritten with a wrong one.
+* @param {string} payload - what the adapter returned: raw base64, or an already-formed URI
+* @param {string} contentType - the rel's content type, e.g. `image/png`
+* @returns {string} a `data:` URI
+*/
+function toMediaDataUri(payload, contentType) {
+	return payload.startsWith("data:") ? payload : `data:${contentType};base64,${payload}`;
+}
+/**
 * Decode a base64 image payload (raw base64 or a `data:` URI) to bytes.
 * - tolerant of the `data:[mime];base64,` prefix and of whitespace in the payload
 * @param {string} b64 - base64 string or data URI
@@ -251,7 +475,7 @@ function utf8Decode(bytes) {
 //#endregion
 //#region src/ooxml/rel-types.ts
 /**
-* OPC relationship type URIs, and the two schema-URI bases they are built from.
+* OPC relationship type URIs and part content types, and the schema-URI bases they are built from.
 *
 * These are long, near-identical strings that differ in one path segment, which makes a typo
 * both easy to write and invisible on review — a wrong URI does not throw, it silently matches
@@ -268,6 +492,11 @@ function utf8Decode(bytes) {
 * (`chart`, `hyperlink`, `tags`, the two comments parts, `oleObject`, the MS media rels, …) stays
 * declared next to the code that reads or emits it — hoisting those would trade a definition you
 * can see for one you have to go and find, and buy nothing.
+*
+* The same reasoning covers **part content types**, which are the same kind of fact and fail the
+* same silent way. The write side is the exception at the bottom of this file: `[Content_Types].xml`
+* spells its entries out locally so each one stays greppable by its suffix next to the part it
+* declares.
 */
 /** Root of every ECMA-376 schema URI. Private: callers want one of the prefixes below. */
 const SCHEMA_BASE = "http://schemas.openxmlformats.org/";
@@ -294,211 +523,73 @@ const THEME_REL = OFFICE_REL + "theme";
 const OFFICE_DOCUMENT_REL = OFFICE_REL + "officeDocument";
 /** Any part → an image in `ppt/media/`. */
 const IMAGE_REL = OFFICE_REL + "image";
+/** Root of the ECMA-376 content types. Private: callers want one of the constants below. */
+const OD_CONTENT = "application/vnd.openxmlformats-officedocument.";
+/** `ppt/slides/slideN.xml`. */
+const SLIDE_CONTENT_TYPE = OD_CONTENT + "presentationml.slide+xml";
+/** `ppt/slideMasters/slideMasterN.xml`. */
+const SLIDE_MASTER_CONTENT_TYPE = OD_CONTENT + "presentationml.slideMaster+xml";
+/** `ppt/slideLayouts/slideLayoutN.xml`. */
+const SLIDE_LAYOUT_CONTENT_TYPE = OD_CONTENT + "presentationml.slideLayout+xml";
+/** `ppt/notesSlides/notesSlideN.xml`. */
+const NOTES_SLIDE_CONTENT_TYPE = OD_CONTENT + "presentationml.notesSlide+xml";
+/** `ppt/notesMasters/notesMasterN.xml`. */
+const NOTES_MASTER_CONTENT_TYPE = OD_CONTENT + "presentationml.notesMaster+xml";
+/** `ppt/theme/themeN.xml`. Not `presentationml.`: a theme is a DrawingML part. */
+const THEME_CONTENT_TYPE = OD_CONTENT + "theme+xml";
 //#endregion
-//#region src/ooxml/check-enum.ts
+//#region src/ooxml/namespaces.ts
 /**
-* Check a value against its `ST_` union, reporting and dropping it when outside (the write-path
-* policy — see the module note).
+* OOXML namespace URIs, by their canonical prefix.
 *
-* `undefined`/`null` returns `null` without reporting: an unset option is not an invalid one, and
-* it is by far the common case.
+* A namespace URI is a fact about the format, not about reading or writing one, so it belongs
+* here rather than on either side — the same reasoning `rel-types.ts` states at length, and for
+* the same failure mode: these are long, near-identical strings, and a typo does not throw. It
+* silently matches nothing on the read side and produces a part PowerPoint ignores on the write
+* side.
 *
-* The offending value is interpolated into the message deliberately. {@link warnOnce} dedups on
-* code **and** message, so keeping the value in the text is what lets a second, *different* bad
-* value under the same code still get reported.
-* @param value - the value the caller supplied, if any
-* @param valid - the enum's members
-* @param code - the condition to report
-* @param label - how to name the offending option in the message, e.g. ``'table cell: cell3D `preset`'``
-* @param detail - extra structured context to merge into the diagnostic's `detail`
-* @returns the value when legal, else `null`
+* The table lived in `read/oxml/dom.ts` and could not be reached from `gen/`, because that
+* module imports `@xmldom/xmldom` at module scope and pulling an XML DOM into the write-only
+* bundle is a real cost. So the write side hand-wrote the URIs instead: three separate `A_NS`
+* constants and seven copies of the same `xmlns:a`/`xmlns:r`/`xmlns:p` triple. This module has
+* **no runtime imports** — like `rel-types.ts`, `st-enums.ts` and `sequence.ts` beside it — so
+* both sides can reach it and neither pays for the other's dependencies. `read/oxml/dom.ts`
+* re-exports it, so no read-side import path changed.
 */
-function checkEnumOrWarn(value, valid, code, label, detail) {
-	if (value === void 0 || value === null) return null;
-	if (valid.includes(value)) return value;
-	warnOnce(code, `${label} value \`${String(value)}\` is not valid and is ignored — use one of ${valid.join(", ")}.`, {
-		received: value,
-		valid,
-		...detail
-	});
-	return null;
-}
+/** Canonical OOXML prefix → namespace URI registry. */
+const OOXML_NS = Object.freeze({
+	a: "http://schemas.openxmlformats.org/drawingml/2006/main",
+	c: "http://schemas.openxmlformats.org/drawingml/2006/chart",
+	cp: "http://schemas.openxmlformats.org/package/2006/metadata/core-properties",
+	ct: "http://schemas.openxmlformats.org/package/2006/content-types",
+	cx: "http://schemas.microsoft.com/office/drawing/2014/chartex",
+	dc: "http://purl.org/dc/elements/1.1/",
+	dcterms: "http://purl.org/dc/terms/",
+	dgm: "http://schemas.openxmlformats.org/drawingml/2006/diagram",
+	dsp: "http://schemas.microsoft.com/office/drawing/2008/diagram",
+	ep: "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties",
+	mc: "http://schemas.openxmlformats.org/markup-compatibility/2006",
+	p: "http://schemas.openxmlformats.org/presentationml/2006/main",
+	p14: "http://schemas.microsoft.com/office/powerpoint/2010/main",
+	p188: "http://schemas.microsoft.com/office/powerpoint/2018/8/main",
+	pr: "http://schemas.openxmlformats.org/package/2006/relationships",
+	r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+});
 /**
-* Check a value against its `ST_` union, throwing when outside (the read/edit-path policy — see
-* the module note).
-* @param value - the value the caller asked for
-* @param valid - the enum's members
-* @param attribute - the attribute's name, for the message
-* @param code - the condition to report
-* @returns `value`, when it is legal
-*/
-function checkEnumOrThrow(value, valid, attribute, code) {
-	if (valid.includes(value)) return value;
-	throw new InvalidOptionError(code, `Invalid ${attribute}: ${JSON.stringify(value)}. Expected one of: ${valid.join(", ")}.`);
-}
-//#endregion
-//#region src/ooxml/st-enums.ts
-/**
-* `ST_` simple-type enumerations from ECMA-376, declared once as the single source of both the
-* TypeScript union a caller is checked against and the runtime list a value is validated against.
-*
-* **The problem this solves.** Each of these used to exist twice: a hand-written string union in
-* `src/types/` (what the compiler enforces) and a hand-written array in `src/gen/` or `src/read/`
-* (what the validator checks at run time). Nothing tied the two together, so adding a member to
-* one and not the other produced either a value TypeScript accepts and the validator drops, or a
-* value the validator passes and the type rejects. Two of them had already diverged in *order*,
-* which is harmless, but nothing would have caught a divergence in *content*.
-*
-* **The shape.** Every entry is a `readonly` tuple declared `as const`, with its union derived via
-* `(typeof X)[number]`. Widening the tuple widens the union in the same edit — they cannot drift.
-* This is the idiom already used for `EMBEDDED_FONT_SLOTS` and `EXTRA_SHAPE_PRESETS`; this module
-* brings the stragglers onto it.
-*
-* **Why this module is neither `gen/` nor `read/`.** `src/types/` needs the unions for the public
-* write API, `src/gen/` needs the tuples to vet a value before emitting it, and `src/read/` needs
-* them to vet a value before writing it into a loaded part. It is a fact about the schema, so it
-* belongs to none of the three.
+* The `xmlns` declarations every PresentationML part root carries, in the order the emitters
+* have always written them.
 *
-* Values are listed in **schema declaration order**, which is the order the diagnostics print
-* when they tell a caller what is legal.
-*/
-/**
-* `ST_BevelPresetType` — the bevel profile applied to a 3-D edge.
-* @see ECMA-376 Part 1 §20.1.10.9
+* Spread this **first** in a root element's attribute map: `el()` serializes attributes in
+* object-key order, so the three keys have to keep the positions the literals occupied or the
+* emitted bytes move. A root with extra attributes (`show` on `p:sld`, `def` on `a:tblStyleLst`)
+* lists them after the spread, which is where they already were.
 */
-const BEVEL_PRESETS = [
-	"relaxedInset",
-	"circle",
-	"slope",
-	"cross",
-	"angle",
-	"softRound",
-	"convex",
-	"coolSlant",
-	"divot",
-	"riblet",
-	"hardEdge",
-	"artDeco"
-];
-/**
-* `ST_PresetMaterialType` — how a 3-D surface responds to light.
-* @see ECMA-376 Part 1 §20.1.10.50
-*/
-const PRESET_MATERIALS = [
-	"legacyMatte",
-	"legacyPlastic",
-	"legacyMetal",
-	"legacyWireframe",
-	"matte",
-	"plastic",
-	"metal",
-	"warmMatte",
-	"translucentPowder",
-	"powder",
-	"dkEdge",
-	"softEdge",
-	"clear",
-	"flat",
-	"softmetal"
-];
-/**
-* `ST_LightRigType` — the preset lighting scene.
-* @see ECMA-376 Part 1 §20.1.10.35
-*/
-const LIGHT_RIGS = [
-	"legacyFlat1",
-	"legacyFlat2",
-	"legacyFlat3",
-	"legacyFlat4",
-	"legacyNormal1",
-	"legacyNormal2",
-	"legacyNormal3",
-	"legacyNormal4",
-	"legacyHarsh1",
-	"legacyHarsh2",
-	"legacyHarsh3",
-	"legacyHarsh4",
-	"threePt",
-	"balanced",
-	"soft",
-	"harsh",
-	"flood",
-	"contrasting",
-	"morning",
-	"sunrise",
-	"sunset",
-	"chilly",
-	"freezing",
-	"flat",
-	"twoPt",
-	"glow",
-	"brightRoom"
-];
-/**
-* `ST_LightRigDirection` — where the light rig sits relative to the scene.
-* @see ECMA-376 Part 1 §20.1.10.33
-*/
-const LIGHT_RIG_DIRECTIONS = [
-	"tl",
-	"t",
-	"tr",
-	"l",
-	"r",
-	"bl",
-	"b",
-	"br"
-];
-/**
-* `ST_TextHorzOverflowType` — `a:bodyPr/@horzOverflow` and `a:tcPr/@horzOverflow`.
-* @see ECMA-376 Part 1 §20.1.10.68
-*/
-const TEXT_HORZ_OVERFLOW = ["clip", "overflow"];
-/**
-* `ST_TextAnchoringType` — `a:bodyPr/@anchor` and `a:tcPr/@anchor`.
-* @see ECMA-376 Part 1 §20.1.10.60
-*/
-const TEXT_ANCHORS = [
-	"t",
-	"ctr",
-	"b",
-	"just",
-	"dist"
-];
-/**
-* `ST_TextVerticalType` — `a:bodyPr/@vert` and `a:tcPr/@vert`.
-* @see ECMA-376 Part 1 §20.1.10.83
-*/
-const TEXT_VERTICAL = [
-	"horz",
-	"vert",
-	"vert270",
-	"wordArtVert",
-	"eaVert",
-	"mongolianVert",
-	"wordArtVertRtl"
-];
-/**
-* `ST_PresetLineDashVal` — the dash pattern of a line or border (`a:prstDash/@val`).
-*
-* The `sys*` members are the "system" dashes whose exact dot/gap ratio the renderer picks; the
-* rest are defined by the spec. Both `BorderProps.dashType` and `ShapeLineProps.dashType` accept
-* this whole set, so a caller who knows one knows the other.
-* @see ECMA-376 Part 1 §20.1.10.49
-*/
-const PRESET_LINE_DASHES = [
-	"solid",
-	"dot",
-	"dash",
-	"lgDash",
-	"dashDot",
-	"lgDashDot",
-	"lgDashDotDot",
-	"sysDash",
-	"sysDot",
-	"sysDashDot",
-	"sysDashDotDot"
-];
+const PML_ROOT_NS = Object.freeze({
+	"xmlns:a": OOXML_NS.a,
+	"xmlns:r": OOXML_NS.r,
+	"xmlns:p": OOXML_NS.p
+});
 //#endregion
-export { getImageSizeFromBytes as C, svgMarkupToDataUri as E, getImageSizeFromBase64 as S, decodeBase64ToBytes as T, SLIDE_LAYOUT_REL as _, PRESET_MATERIALS as a, THEME_REL as b, TEXT_VERTICAL as c, IMAGE_REL as d, NOTES_MASTER_REL as f, PACKAGE_REL_NS as g, OFFICE_REL as h, PRESET_LINE_DASHES as i, checkEnumOrThrow as l, OFFICE_DOCUMENT_REL as m, LIGHT_RIGS as n, TEXT_ANCHORS as o, NOTES_SLIDE_REL as p, LIGHT_RIG_DIRECTIONS as r, TEXT_HORZ_OVERFLOW as s, BEVEL_PRESETS as t, checkEnumOrWarn as u, SLIDE_MASTER_REL as v, bytesToBase64 as w, fitSrcRectPercents as x, SLIDE_REL as y };
+export { PRESET_MATERIALS as A, decodeBase64ToBytes as C, LIGHT_RIGS as D, BEVEL_PRESETS as E, checkEnumOrWarn as F, TEXT_HORZ_OVERFLOW as M, TEXT_VERTICAL as N, LIGHT_RIG_DIRECTIONS as O, checkEnumOrThrow as P, bytesToBase64 as S, toMediaDataUri as T, THEME_CONTENT_TYPE as _, NOTES_MASTER_REL as a, getImageSizeFromBase64 as b, OFFICE_DOCUMENT_REL as c, SLIDE_CONTENT_TYPE as d, SLIDE_LAYOUT_CONTENT_TYPE as f, SLIDE_REL as g, SLIDE_MASTER_REL as h, NOTES_MASTER_CONTENT_TYPE as i, TEXT_ANCHORS as j, PRESET_LINE_DASHES as k, OFFICE_REL as l, SLIDE_MASTER_CONTENT_TYPE as m, PML_ROOT_NS as n, NOTES_SLIDE_CONTENT_TYPE as o, SLIDE_LAYOUT_REL as p, IMAGE_REL as r, NOTES_SLIDE_REL as s, OOXML_NS as t, PACKAGE_REL_NS as u, THEME_REL as v, svgMarkupToDataUri as w, getImageSizeFromBytes as x, fitSrcRectPercents as y };
 
-//# sourceMappingURL=st-enums-bVnezkMJ.js.map
+//# sourceMappingURL=namespaces-CcKuzeuE.js.map

package/dist/namespaces-CcKuzeuE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces-CcKuzeuE.js","names":[],"sources":["../src/ooxml/check-enum.ts","../src/ooxml/st-enums.ts","../src/media/base64.ts","../src/media/image-size.ts","../src/ooxml/rel-types.ts","../src/ooxml/namespaces.ts"],"sourcesContent":["/**\n * Validating a value against an `ST_` enumeration, under the two policies the library uses.\n *\n * **Why validate at all.** A value outside its `ST_` union makes the containing part\n * schema-invalid, and PowerPoint reports that as a *corrupt file* rather than as a mis-set\n * option — so the cost of letting one through is a deck that will not open, attributed to\n * nothing in particular. Both halves therefore check before a value reaches the XML.\n *\n * **Why two policies.** They differ deliberately, and the difference is about where the value\n * came from:\n *\n * - {@link checkEnumOrWarn} (write path) reports and **drops** the attribute, leaving the\n *   renderer on the schema default. An option here comes from a deck being built, and losing one\n *   attribute is better than failing an entire build over it.\n * - {@link checkEnumOrThrow} (read/edit path) **throws**. A value here comes from a caller\n *   editing one attribute of a loaded deck, so silently doing nothing would leave them looking at\n *   an unchanged file with no explanation.\n *\n * Before this module the two policies were spread across three near-identical private validators\n * (two in `gen/`, one in `read/`), each with its own wording; adding an enum meant writing a\n * fourth. The policy split is worth keeping — the triplication was not.\n */\n\nimport type { DiagnosticCode, InvalidOptionErrorCode } from '../codes.js'\nimport { warnOnce } from '../diagnostics.js'\nimport { InvalidOptionError } from '../errors.js'\n\n/**\n * Check a value against its `ST_` union, reporting and dropping it when outside (the write-path\n * policy — see the module note).\n *\n * `undefined`/`null` returns `null` without reporting: an unset option is not an invalid one, and\n * it is by far the common case.\n *\n * The offending value is interpolated into the message deliberately. {@link warnOnce} dedups on\n * code **and** message, so keeping the value in the text is what lets a second, *different* bad\n * value under the same code still get reported.\n * @param value - the value the caller supplied, if any\n * @param valid - the enum's members\n * @param code - the condition to report\n * @param label - how to name the offending option in the message, e.g. ``'table cell: cell3D `preset`'``\n * @param detail - extra structured context to merge into the diagnostic's `detail`\n * @returns the value when legal, else `null`\n */\nexport function checkEnumOrWarn<T extends string>(\n\tvalue: string | undefined | null,\n\tvalid: readonly T[],\n\tcode: DiagnosticCode,\n\tlabel: string,\n\tdetail?: Readonly<Record<string, unknown>>\n): T | null {\n\tif (value === undefined || value === null) return null\n\tif ((valid as readonly string[]).includes(value)) return value as T\n\twarnOnce(code, `${label} value \\`${String(value)}\\` is not valid and is ignored — use one of ${valid.join(', ')}.`, {\n\t\treceived: value,\n\t\tvalid,\n\t\t...detail,\n\t})\n\treturn null\n}\n\n/**\n * Check a value against its `ST_` union, throwing when outside (the read/edit-path policy — see\n * the module note).\n * @param value - the value the caller asked for\n * @param valid - the enum's members\n * @param attribute - the attribute's name, for the message\n * @param code - the condition to report\n * @returns `value`, when it is legal\n */\nexport function checkEnumOrThrow<T extends string>(\n\tvalue: string,\n\tvalid: readonly T[],\n\tattribute: string,\n\tcode: InvalidOptionErrorCode\n): T {\n\tif ((valid as readonly string[]).includes(value)) return value as T\n\tthrow new InvalidOptionError(\n\t\tcode,\n\t\t`Invalid ${attribute}: ${JSON.stringify(value)}. Expected one of: ${valid.join(', ')}.`\n\t)\n}\n","/**\n * `ST_` simple-type enumerations from ECMA-376, declared once as the single source of both the\n * TypeScript union a caller is checked against and the runtime list a value is validated against.\n *\n * **The problem this solves.** Each of these used to exist twice: a hand-written string union in\n * `src/types/` (what the compiler enforces) and a hand-written array in `src/gen/` or `src/read/`\n * (what the validator checks at run time). Nothing tied the two together, so adding a member to\n * one and not the other produced either a value TypeScript accepts and the validator drops, or a\n * value the validator passes and the type rejects. Two of them had already diverged in *order*,\n * which is harmless, but nothing would have caught a divergence in *content*.\n *\n * **The shape.** Every entry is a `readonly` tuple declared `as const`, with its union derived via\n * `(typeof X)[number]`. Widening the tuple widens the union in the same edit — they cannot drift.\n * This is the idiom already used for `EMBEDDED_FONT_SLOTS` and `EXTRA_SHAPE_PRESETS`; this module\n * brings the stragglers onto it.\n *\n * **Why this module is neither `gen/` nor `read/`.** `src/types/` needs the unions for the public\n * write API, `src/gen/` needs the tuples to vet a value before emitting it, and `src/read/` needs\n * them to vet a value before writing it into a loaded part. It is a fact about the schema, so it\n * belongs to none of the three.\n *\n * Values are listed in **schema declaration order**, which is the order the diagnostics print\n * when they tell a caller what is legal.\n */\n\n/**\n * `ST_BevelPresetType` — the bevel profile applied to a 3-D edge.\n * @see ECMA-376 Part 1 §20.1.10.9\n */\nexport const BEVEL_PRESETS = [\n\t'relaxedInset',\n\t'circle',\n\t'slope',\n\t'cross',\n\t'angle',\n\t'softRound',\n\t'convex',\n\t'coolSlant',\n\t'divot',\n\t'riblet',\n\t'hardEdge',\n\t'artDeco',\n] as const\nexport type BevelPresetType = (typeof BEVEL_PRESETS)[number]\n\n/**\n * `ST_PresetMaterialType` — how a 3-D surface responds to light.\n * @see ECMA-376 Part 1 §20.1.10.50\n */\nexport const PRESET_MATERIALS = [\n\t'legacyMatte',\n\t'legacyPlastic',\n\t'legacyMetal',\n\t'legacyWireframe',\n\t'matte',\n\t'plastic',\n\t'metal',\n\t'warmMatte',\n\t'translucentPowder',\n\t'powder',\n\t'dkEdge',\n\t'softEdge',\n\t'clear',\n\t'flat',\n\t'softmetal',\n] as const\nexport type PresetMaterialType = (typeof PRESET_MATERIALS)[number]\n\n/**\n * `ST_LightRigType` — the preset lighting scene.\n * @see ECMA-376 Part 1 §20.1.10.35\n */\nexport const LIGHT_RIGS = [\n\t'legacyFlat1',\n\t'legacyFlat2',\n\t'legacyFlat3',\n\t'legacyFlat4',\n\t'legacyNormal1',\n\t'legacyNormal2',\n\t'legacyNormal3',\n\t'legacyNormal4',\n\t'legacyHarsh1',\n\t'legacyHarsh2',\n\t'legacyHarsh3',\n\t'legacyHarsh4',\n\t'threePt',\n\t'balanced',\n\t'soft',\n\t'harsh',\n\t'flood',\n\t'contrasting',\n\t'morning',\n\t'sunrise',\n\t'sunset',\n\t'chilly',\n\t'freezing',\n\t'flat',\n\t'twoPt',\n\t'glow',\n\t'brightRoom',\n] as const\nexport type LightRigType = (typeof LIGHT_RIGS)[number]\n\n/**\n * `ST_LightRigDirection` — where the light rig sits relative to the scene.\n * @see ECMA-376 Part 1 §20.1.10.33\n */\nexport const LIGHT_RIG_DIRECTIONS = ['tl', 't', 'tr', 'l', 'r', 'bl', 'b', 'br'] as const\nexport type LightRigDirection = (typeof LIGHT_RIG_DIRECTIONS)[number]\n\n/**\n * `ST_TextHorzOverflowType` — `a:bodyPr/@horzOverflow` and `a:tcPr/@horzOverflow`.\n * @see ECMA-376 Part 1 §20.1.10.68\n */\nexport const TEXT_HORZ_OVERFLOW = ['clip', 'overflow'] as const\nexport type TextHorzOverflowType = (typeof TEXT_HORZ_OVERFLOW)[number]\n\n/**\n * `ST_TextAnchoringType` — `a:bodyPr/@anchor` and `a:tcPr/@anchor`.\n * @see ECMA-376 Part 1 §20.1.10.60\n */\nexport const TEXT_ANCHORS = ['t', 'ctr', 'b', 'just', 'dist'] as const\nexport type TextAnchoringType = (typeof TEXT_ANCHORS)[number]\n\n/**\n * `ST_TextVerticalType` — `a:bodyPr/@vert` and `a:tcPr/@vert`.\n * @see ECMA-376 Part 1 §20.1.10.83\n */\nexport const TEXT_VERTICAL = [\n\t'horz',\n\t'vert',\n\t'vert270',\n\t'wordArtVert',\n\t'eaVert',\n\t'mongolianVert',\n\t'wordArtVertRtl',\n] as const\nexport type TextVerticalType = (typeof TEXT_VERTICAL)[number]\n\n/**\n * `ST_PresetLineDashVal` — the dash pattern of a line or border (`a:prstDash/@val`).\n *\n * The `sys*` members are the \"system\" dashes whose exact dot/gap ratio the renderer picks; the\n * rest are defined by the spec. Both `BorderProps.dashType` and `ShapeLineProps.dashType` accept\n * this whole set, so a caller who knows one knows the other.\n * @see ECMA-376 Part 1 §20.1.10.49\n */\nexport const PRESET_LINE_DASHES = [\n\t'solid',\n\t'dot',\n\t'dash',\n\t'lgDash',\n\t'dashDot',\n\t'lgDashDot',\n\t'lgDashDotDot',\n\t'sysDash',\n\t'sysDot',\n\t'sysDashDot',\n\t'sysDashDotDot',\n] as const\nexport type PresetLineDashVal = (typeof PRESET_LINE_DASHES)[number]\n","/**\n * Base64 payload handling for media parts — isomorphic across Node and browsers\n * (`TextEncoder`/`atob`/`btoa` only, no `Buffer`).\n */\n\n/**\n * Encode raw SVG markup as a base64 `image/svg+xml` data URI.\n * - lets callers pass inline SVG to `addImage({ svg })` without hand-rolling base64\n * - isomorphic and UTF-8 safe: uses the global `TextEncoder`/`btoa` (Node and browsers)\n * @param {string} svg - SVG markup, e.g. `'<svg ...>...</svg>'`\n * @returns {string} a `data:image/svg+xml;base64,...` URI\n */\nexport function svgMarkupToDataUri(svg: string): string {\n\treturn `data:image/svg+xml;base64,${bytesToBase64(new TextEncoder().encode(svg))}`\n}\n\n/**\n * Encode raw bytes as base64 (no `data:` prefix) using only `btoa`, so the result is the same\n * on Node, in a browser, and in a runtime that has neither `Buffer` nor `FileReader`.\n *\n * Chunked because `String.fromCharCode(...spread)` blows the argument-count limit on a payload\n * of any real size — a multi-megabyte video rel would throw rather than encode.\n * @param {Uint8Array} bytes - the payload\n * @returns {string} base64 text\n */\nexport function bytesToBase64(bytes: Uint8Array): string {\n\tconst CHUNK = 0x8000\n\tlet binary = ''\n\tfor (let i = 0; i < bytes.length; i += CHUNK) binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK))\n\treturn btoa(binary)\n}\n\n/**\n * Present a freshly loaded media payload as a `data:` URI.\n *\n * A {@link RuntimeAdapter.loadMedia} implementation returns whichever encoding its host\n * makes cheap — the browser adapter a full URI, because `FileReader.readAsDataURL` is what\n * decodes a blob without blocking; Node and the neutral adapter raw base64, because neither\n * has a `FileReader`. This is where the two become one, so nothing downstream of the load\n * has to ask which it got.\n *\n * The mime label is documentary: {@link decodeBase64ToBytes} ignores it, and the one consumer\n * that needs a real URI (`image.src`, in the browser adapter's SVG preview) is handed the\n * adapter's own. It is taken from the rel anyway rather than hard-coded, so an already-correct\n * label is not overwritten with a wrong one.\n * @param {string} payload - what the adapter returned: raw base64, or an already-formed URI\n * @param {string} contentType - the rel's content type, e.g. `image/png`\n * @returns {string} a `data:` URI\n */\nexport function toMediaDataUri(payload: string, contentType: string): string {\n\treturn payload.startsWith('data:') ? payload : `data:${contentType};base64,${payload}`\n}\n\n/**\n * Decode a base64 image payload (raw base64 or a `data:` URI) to bytes.\n * - tolerant of the `data:[mime];base64,` prefix and of whitespace in the payload\n * @param {string} b64 - base64 string or data URI\n * @returns {Uint8Array | null} decoded bytes, or `null` when the payload is empty/undecodable\n */\nexport function decodeBase64ToBytes(b64: string): Uint8Array | null {\n\tif (!b64) return null\n\t// Strip any `data:...;base64,` prefix and surrounding whitespace\n\tconst comma = b64.indexOf('base64,')\n\tconst payload = (comma >= 0 ? b64.slice(comma + 'base64,'.length) : b64).replace(/\\s/g, '')\n\tif (!payload) return null\n\ttry {\n\t\tconst binary = atob(payload)\n\t\tconst bytes = new Uint8Array(binary.length)\n\t\tfor (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)\n\t\treturn bytes\n\t} catch {\n\t\treturn null\n\t}\n}\n","/**\n * Intrinsic image geometry: reading a natural pixel size out of header bytes, and the\n * `<a:srcRect>` crop math that fits that natural size into a display box.\n *\n * Shared by both sides of the library — the write path (`addImage({ sizing })`) and the read\n * API's `Picture.setImage({ fit })` — which is why it lives outside `gen/` and `read/`.\n * Everything here is synchronous and pure: headers only, never pixel decoding.\n */\n\nimport { decodeBase64ToBytes } from './base64.js'\n\n/**\n * Read the intrinsic dimensions of an image from its header bytes.\n * - synchronous: parses only file-format headers, never decodes pixels\n * - raster: PNG, JPEG, GIF, BMP, and WebP (VP8 / VP8L / VP8X) — natural pixels\n * - vector: SVG — intrinsic size from the root `<svg>` width/height or viewBox\n * - unrecognized formats return `null` (no measurable intrinsic size)\n *\n * Used by image `sizing: 'cover' | 'contain'` to compute an aspect-correct\n * `<a:srcRect>` crop from the *natural* image ratio rather than the displayed box.\n * @param {string} dataB64 - base64 image payload or `data:` URI\n * @returns {{ w: number, h: number } | null} natural size, or `null` when unmeasurable\n */\nexport function getImageSizeFromBase64(dataB64: string): { w: number; h: number } | null {\n\tconst b = decodeBase64ToBytes(dataB64)\n\treturn b ? getImageSizeFromBytes(b) : null\n}\n\n/**\n * Read the intrinsic dimensions of an image from raw header bytes — the\n * byte-level core shared by {@link getImageSizeFromBase64} and the read API's\n * `Picture.setImage({ fit })`, which already holds the media bytes.\n * @param {Uint8Array} b - image bytes\n * @returns {{ w: number, h: number } | null} natural size, or `null` when unmeasurable\n */\nexport function getImageSizeFromBytes(b: Uint8Array): { w: number; h: number } | null {\n\tif (!b || b.length < 24) return null\n\n\t// Bounds-checked byte read: every access below is already guarded by an\n\t// explicit length check, so the `?? 0` fallback is unreachable in practice.\n\tconst u = (n: number): number => b[n] ?? 0\n\n\t// PNG: 8-byte signature, then IHDR with width@16 / height@20 (big-endian uint32)\n\tif (b[0] === 0x89 && b[1] === 0x50 && b[2] === 0x4e && b[3] === 0x47) {\n\t\tconst w = (u(16) << 24) | (u(17) << 16) | (u(18) << 8) | u(19)\n\t\tconst h = (u(20) << 24) | (u(21) << 16) | (u(22) << 8) | u(23)\n\t\treturn w > 0 && h > 0 ? { w, h } : null\n\t}\n\n\t// GIF: \"GIF87a\"/\"GIF89a\", width@6 / height@8 (little-endian uint16)\n\tif (b[0] === 0x47 && b[1] === 0x49 && b[2] === 0x46) {\n\t\tconst w = u(6) | (u(7) << 8)\n\t\tconst h = u(8) | (u(9) << 8)\n\t\treturn w > 0 && h > 0 ? { w, h } : null\n\t}\n\n\t// BMP: \"BM\", width@18 / height@22 (little-endian int32; height may be negative for top-down)\n\tif (b[0] === 0x42 && b[1] === 0x4d) {\n\t\tconst w = u(18) | (u(19) << 8) | (u(20) << 16) | (u(21) << 24)\n\t\tconst h = u(22) | (u(23) << 8) | (u(24) << 16) | (u(25) << 24)\n\t\tconst aw = Math.abs(w)\n\t\tconst ah = Math.abs(h)\n\t\treturn aw > 0 && ah > 0 ? { w: aw, h: ah } : null\n\t}\n\n\t// WebP: \"RIFF\"....\"WEBP\" then a VP8 / VP8L / VP8X chunk\n\tif (\n\t\tb[0] === 0x52 &&\n\t\tb[1] === 0x49 &&\n\t\tb[2] === 0x46 &&\n\t\tb[3] === 0x46 &&\n\t\tb[8] === 0x57 &&\n\t\tb[9] === 0x45 &&\n\t\tb[10] === 0x42 &&\n\t\tb[11] === 0x50\n\t) {\n\t\tconst fourCC = String.fromCharCode(u(12), u(13), u(14), u(15))\n\t\tif (fourCC === 'VP8 ' && b.length >= 30) {\n\t\t\t// Lossy: 14-bit width/height at offset 26/28 (little-endian, mask off scale bits)\n\t\t\tconst w = (u(26) | (u(27) << 8)) & 0x3fff\n\t\t\tconst h = (u(28) | (u(29) << 8)) & 0x3fff\n\t\t\treturn w > 0 && h > 0 ? { w, h } : null\n\t\t}\n\t\tif (fourCC === 'VP8L' && b.length >= 25) {\n\t\t\t// Lossless: 14-bit width/height packed starting at bit 0 of offset 21\n\t\t\tconst bits = u(21) | (u(22) << 8) | (u(23) << 16) | (u(24) << 24)\n\t\t\tconst w = (bits & 0x3fff) + 1\n\t\t\tconst h = ((bits >> 14) & 0x3fff) + 1\n\t\t\treturn w > 0 && h > 0 ? { w, h } : null\n\t\t}\n\t\tif (fourCC === 'VP8X' && b.length >= 30) {\n\t\t\t// Extended: 24-bit canvas width/height minus one at offset 24/27 (little-endian)\n\t\t\tconst w = (u(24) | (u(25) << 8) | (u(26) << 16)) + 1\n\t\t\tconst h = (u(27) | (u(28) << 8) | (u(29) << 16)) + 1\n\t\t\treturn w > 0 && h > 0 ? { w, h } : null\n\t\t}\n\t\treturn null\n\t}\n\n\t// JPEG: \"FFD8\", scan segment markers for a Start-Of-Frame (SOFn) and read height@5 / width@7\n\tif (b[0] === 0xff && b[1] === 0xd8) {\n\t\tlet i = 2\n\t\twhile (i + 9 < b.length) {\n\t\t\tif (b[i] !== 0xff) {\n\t\t\t\ti++\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst marker = u(i + 1)\n\t\t\t// SOF0..SOF15 carry frame dimensions, excluding DHT(C4)/JPG(C8)/DAC(CC)\n\t\t\tif (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {\n\t\t\t\tconst h = (u(i + 5) << 8) | u(i + 6)\n\t\t\t\tconst w = (u(i + 7) << 8) | u(i + 8)\n\t\t\t\treturn w > 0 && h > 0 ? { w, h } : null\n\t\t\t}\n\t\t\t// Standalone markers (RSTn / SOI / EOI / TEM) have no length payload\n\t\t\tif ((marker >= 0xd0 && marker <= 0xd9) || marker === 0x01) {\n\t\t\t\ti += 2\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\t// Otherwise skip this segment using its 2-byte big-endian length\n\t\t\tconst segLen = (u(i + 2) << 8) | u(i + 3)\n\t\t\tif (segLen < 2) break\n\t\t\ti += 2 + segLen\n\t\t}\n\t\treturn null\n\t}\n\n\t// SVG: text-based vector with no binary signature. When the payload is an\n\t// `<svg>` document, read its intrinsic size from the root element so that\n\t// `sizing: 'cover' | 'contain'` is aspect-correct for SVG, not just rasters.\n\tconst text = utf8Decode(b)\n\tif (/<svg[\\s>]/i.test(text)) return getSvgSizeFromMarkup(text)\n\n\treturn null\n}\n\n/**\n * Compute the `<a:srcRect>` crop percentages (each in 1/1000 of a percent, the\n * OOXML unit) for fitting an image of natural size `img` into a display `box`,\n * assuming the cropped region is then stretched to fill the box (`<a:stretch>`).\n *\n * - `cover`: fill the box, cropping the overflowing axis (positive l/r or t/b)\n * - `contain`: fit inside the box, letterboxing the short axis (negative l/r or t/b)\n *\n * Single source of truth for the crop math shared by the write side\n * (`ImageSizingXml`) and the read API's `Picture.setImage({ fit })`. `l`/`r` and\n * `t`/`b` are symmetric (centered crop).\n * @param {'cover' | 'contain'} type - fit mode\n * @param {{ w: number, h: number }} img - natural image pixel size\n * @param {{ w: number, h: number }} box - displayed frame size (any consistent unit)\n * @returns {{ l: number, r: number, t: number, b: number }} srcRect percentages\n */\nexport function fitSrcRectPercents(\n\ttype: 'cover' | 'contain',\n\timg: { w: number; h: number },\n\tbox: { w: number; h: number }\n): { l: number; r: number; t: number; b: number } {\n\tconst imgRatio = img.h / img.w\n\tconst boxRatio = box.h / box.w\n\tlet width: number\n\tlet height: number\n\tif (type === 'cover') {\n\t\tconst isBoxBased = boxRatio > imgRatio\n\t\twidth = isBoxBased ? box.h / imgRatio : box.w\n\t\theight = isBoxBased ? box.h : box.w * imgRatio\n\t} else {\n\t\tconst widthBased = boxRatio > imgRatio\n\t\twidth = widthBased ? box.w : box.h / imgRatio\n\t\theight = widthBased ? box.w * imgRatio : box.h\n\t}\n\tconst hz = Math.round(1e5 * 0.5 * (1 - box.w / width))\n\tconst vz = Math.round(1e5 * 0.5 * (1 - box.h / height))\n\treturn { l: hz, r: hz, t: vz, b: vz }\n}\n\n/**\n * Read the intrinsic size of an SVG document from its root `<svg>` element.\n * Follows the SVG sizing model: an explicit absolute `width`/`height` pair wins;\n * otherwise the `viewBox` width/height defines the size (and thus aspect ratio).\n * Percentage or missing `width`/`height` fall through to `viewBox`.\n * @param {string} svg - SVG markup\n * @returns {{ w: number, h: number } | null} intrinsic size, or `null` when undeterminable\n */\nfunction getSvgSizeFromMarkup(svg: string): { w: number; h: number } | null {\n\tconst openTag = /<svg\\b[^>]*>/i.exec(svg)?.[0]\n\tif (!openTag) return null\n\tconst attr = (name: string): string | null =>\n\t\tnew RegExp(`\\\\b${name}\\\\s*=\\\\s*[\"']([^\"']*)[\"']`, 'i').exec(openTag)?.[1] ?? null\n\t// Leading number with an optional absolute unit; a percentage is not an intrinsic length.\n\tconst absLength = (val: string | null): number => {\n\t\tif (val == null || /%\\s*$/.test(val)) return NaN\n\t\tconst m = /^\\s*\\+?(\\d*\\.?\\d+)/.exec(val)\n\t\treturn m ? parseFloat(m[1] ?? '') : NaN\n\t}\n\tlet w = absLength(attr('width'))\n\tlet h = absLength(attr('height'))\n\tif (!(w > 0 && h > 0)) {\n\t\tconst vb = attr('viewBox')\n\t\tconst p = vb\n\t\t\t? vb\n\t\t\t\t\t.trim()\n\t\t\t\t\t.split(/[\\s,]+/)\n\t\t\t\t\t.map(Number)\n\t\t\t: []\n\t\tconst vw = p[2]\n\t\tconst vh = p[3]\n\t\tif (p.length === 4 && vw != null && vh != null && vw > 0 && vh > 0) {\n\t\t\tw = vw\n\t\t\th = vh\n\t\t}\n\t}\n\treturn w > 0 && h > 0 ? { w, h } : null\n}\n\n/** Decode UTF-8 bytes to a string, isomorphic across Node and browsers. */\nfunction utf8Decode(bytes: Uint8Array): string {\n\treturn new TextDecoder().decode(bytes)\n}\n","/**\n * OPC relationship type URIs and part content types, and the schema-URI bases they are built from.\n *\n * These are long, near-identical strings that differ in one path segment, which makes a typo\n * both easy to write and invisible on review — a wrong URI does not throw, it silently matches\n * nothing on the read side and produces a part PowerPoint ignores or rejects on the write side.\n *\n * **Why this module is neither `gen/` nor `read/`.** Both halves need the same URIs, and for a\n * while each kept its own copy (`gen/oxml/schema-uris.ts`, `read/api/rel-types.ts`), with a note\n * in both saying a shared home was \"a separate decision\". It is this module: a rel type is a fact\n * about the OOXML package format, not about writing or reading one, so neither side should own it.\n * A divergence between the two copies would mean the writer emitting a rel the reader cannot find\n * — a round-trip bug with no compile-time signal.\n *\n * Only types used by more than one module live here. A rel type exactly one module cares about\n * (`chart`, `hyperlink`, `tags`, the two comments parts, `oleObject`, the MS media rels, …) stays\n * declared next to the code that reads or emits it — hoisting those would trade a definition you\n * can see for one you have to go and find, and buy nothing.\n *\n * The same reasoning covers **part content types**, which are the same kind of fact and fail the\n * same silent way. The write side is the exception at the bottom of this file: `[Content_Types].xml`\n * spells its entries out locally so each one stays greppable by its suffix next to the part it\n * declares.\n */\n\n/** Root of every ECMA-376 schema URI. Private: callers want one of the prefixes below. */\nconst SCHEMA_BASE = 'http://schemas.openxmlformats.org/'\n\n/**\n * Prefix for `.rels` `Type` URIs — append the type name (`slide`, `image`, `theme`, …).\n * Exported for the write side, which builds one-off rel types at their call sites.\n */\nexport const OFFICE_REL = SCHEMA_BASE + 'officeDocument/2006/relationships/'\n\n/** `xmlns` of every `<Relationships>` part. Also the prefix of the package-scoped rel types. */\nexport const PACKAGE_REL_NS = SCHEMA_BASE + 'package/2006/relationships'\n\n/** `p:sldIdLst` → a slide part. */\nexport const SLIDE_REL = OFFICE_REL + 'slide'\n/** A slide → its layout; a master → each of its layouts. */\nexport const SLIDE_LAYOUT_REL = OFFICE_REL + 'slideLayout'\n/** A layout → its master; the presentation → each master. */\nexport const SLIDE_MASTER_REL = OFFICE_REL + 'slideMaster'\n/** A slide → its notes slide. */\nexport const NOTES_SLIDE_REL = OFFICE_REL + 'notesSlide'\n/** A notes slide → the notes master; the presentation → the notes master. */\nexport const NOTES_MASTER_REL = OFFICE_REL + 'notesMaster'\n/** A master or notes master → its theme. Layouts and slides inherit it rather than holding one. */\nexport const THEME_REL = OFFICE_REL + 'theme'\n/** The package root → `ppt/presentation.xml`. The entry point to everything above. */\nexport const OFFICE_DOCUMENT_REL = OFFICE_REL + 'officeDocument'\n/** Any part → an image in `ppt/media/`. */\nexport const IMAGE_REL = OFFICE_REL + 'image'\n\n// --- Part content types ----------------------------------------------------\n\n/** Root of the ECMA-376 content types. Private: callers want one of the constants below. */\nconst OD_CONTENT = 'application/vnd.openxmlformats-officedocument.'\n\n/** `ppt/slides/slideN.xml`. */\nexport const SLIDE_CONTENT_TYPE = OD_CONTENT + 'presentationml.slide+xml'\n\n/** `ppt/slideMasters/slideMasterN.xml`. */\nexport const SLIDE_MASTER_CONTENT_TYPE = OD_CONTENT + 'presentationml.slideMaster+xml'\n/** `ppt/slideLayouts/slideLayoutN.xml`. */\nexport const SLIDE_LAYOUT_CONTENT_TYPE = OD_CONTENT + 'presentationml.slideLayout+xml'\n/** `ppt/notesSlides/notesSlideN.xml`. */\nexport const NOTES_SLIDE_CONTENT_TYPE = OD_CONTENT + 'presentationml.notesSlide+xml'\n/** `ppt/notesMasters/notesMasterN.xml`. */\nexport const NOTES_MASTER_CONTENT_TYPE = OD_CONTENT + 'presentationml.notesMaster+xml'\n/** `ppt/theme/themeN.xml`. Not `presentationml.`: a theme is a DrawingML part. */\nexport const THEME_CONTENT_TYPE = OD_CONTENT + 'theme+xml'\n","/**\n * OOXML namespace URIs, by their canonical prefix.\n *\n * A namespace URI is a fact about the format, not about reading or writing one, so it belongs\n * here rather than on either side — the same reasoning `rel-types.ts` states at length, and for\n * the same failure mode: these are long, near-identical strings, and a typo does not throw. It\n * silently matches nothing on the read side and produces a part PowerPoint ignores on the write\n * side.\n *\n * The table lived in `read/oxml/dom.ts` and could not be reached from `gen/`, because that\n * module imports `@xmldom/xmldom` at module scope and pulling an XML DOM into the write-only\n * bundle is a real cost. So the write side hand-wrote the URIs instead: three separate `A_NS`\n * constants and seven copies of the same `xmlns:a`/`xmlns:r`/`xmlns:p` triple. This module has\n * **no runtime imports** — like `rel-types.ts`, `st-enums.ts` and `sequence.ts` beside it — so\n * both sides can reach it and neither pays for the other's dependencies. `read/oxml/dom.ts`\n * re-exports it, so no read-side import path changed.\n */\n\n/** Canonical OOXML prefix → namespace URI registry. */\nexport const OOXML_NS = Object.freeze({\n\ta: 'http://schemas.openxmlformats.org/drawingml/2006/main',\n\tc: 'http://schemas.openxmlformats.org/drawingml/2006/chart',\n\tcp: 'http://schemas.openxmlformats.org/package/2006/metadata/core-properties',\n\tct: 'http://schemas.openxmlformats.org/package/2006/content-types',\n\tcx: 'http://schemas.microsoft.com/office/drawing/2014/chartex',\n\tdc: 'http://purl.org/dc/elements/1.1/',\n\tdcterms: 'http://purl.org/dc/terms/',\n\tdgm: 'http://schemas.openxmlformats.org/drawingml/2006/diagram',\n\tdsp: 'http://schemas.microsoft.com/office/drawing/2008/diagram',\n\tep: 'http://schemas.openxmlformats.org/officeDocument/2006/extended-properties',\n\tmc: 'http://schemas.openxmlformats.org/markup-compatibility/2006',\n\tp: 'http://schemas.openxmlformats.org/presentationml/2006/main',\n\tp14: 'http://schemas.microsoft.com/office/powerpoint/2010/main',\n\tp188: 'http://schemas.microsoft.com/office/powerpoint/2018/8/main',\n\tpr: 'http://schemas.openxmlformats.org/package/2006/relationships',\n\tr: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',\n})\n\n/**\n * The `xmlns` declarations every PresentationML part root carries, in the order the emitters\n * have always written them.\n *\n * Spread this **first** in a root element's attribute map: `el()` serializes attributes in\n * object-key order, so the three keys have to keep the positions the literals occupied or the\n * emitted bytes move. A root with extra attributes (`show` on `p:sld`, `def` on `a:tblStyleLst`)\n * lists them after the spread, which is where they already were.\n */\nexport const PML_ROOT_NS = Object.freeze({\n\t'xmlns:a': OOXML_NS.a,\n\t'xmlns:r': OOXML_NS.r,\n\t'xmlns:p': OOXML_NS.p,\n})\n"],"mappings":"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"}