@shbernal/ts-pptx 4.0.1 → 4.2.0

package/dist/{image-size-CvN2iCA4.js → chart-metadata-CwiTTcJq.js}

@@ -1,7 +1,7 @@
-import { n as InvalidOptionError, u as warnOnce } from "./errors-C4oENPcu.js";
-import { w as PERCENT_SCALE } from "./table-cell-margins-EVg0EwxT.js";
-import { t as bytesToBinaryString } from "./binary-string-CKVAYI3M.js";
-//#region src/media/image-formats.ts
+import { d as warnOnce, r as InvalidOptionError } from "./entry-errors-JMthgJ2g.js";
+import { w as PERCENT_SCALE } from "./enums-BP9wsb9Q.js";
+import { t as bytesToBinaryString } from "./binary-string-Ba8VM3b9.js";
+// src/media/image-formats.ts
 /**
 * Every recognised format, keyed by its canonical extension. Iteration order is sniffing order;
 * no two signatures overlap, so it only has to be stable, not carefully chosen.
@@ -87,10 +87,9 @@ function imageFormatForBytes(bytes) {
 	for (const format of Object.values(IMAGE_FORMATS)) if (format.magic?.(bytes)) return format;
 	return null;
 }
-//#endregion
-//#region src/media/base64.ts
+// src/media/base64.ts
 /**
-* Base64 payload handling for media parts — isomorphic across Node and browsers
+* Base64 payload handling for media parts, isomorphic across Node and browsers
 * (`TextEncoder`/`atob`/`btoa` only, no `Buffer`).
 */
 /**
@@ -116,7 +115,7 @@ function bytesToBase64(bytes) {
 * 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
+* 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.
@@ -178,341 +177,178 @@ function decodeBase64ToBytes(b64) {
 function hasBase64Header(data) {
 	return typeof data === "string" && base64PayloadStart(data) >= 0;
 }
-//#endregion
-//#region src/ooxml/namespaces.ts
+// src/hex-color.ts
 /**
-* OOXML namespace URIs, by their canonical prefix.
+* pptx-ts: hex colour text, in the one spelling both halves use.
 *
-* 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.
+* A caller may write a colour with or without a leading `#`, and the library accepts both
+* everywhere, which means every site that validates or parses one strips it first. Those
+* strips had drifted into three spellings across six sites, and one of them was not
+* anchored: `.replace('#', '')` takes the `#` out of `'FF00#0'` and hands `'FF000'` on, which
+* then fails the six-digit test and takes a different branch than the anchored forms would.
+* No caller is known to reach that, which is exactly why it wants one spelling rather than a
+* test at each site.
 *
-* 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**, and no module beside it imports from `gen/` or `read/`, so both sides can
-* reach it and neither pays for the other's dependencies. The two that fail loudly reach outside
-* `ooxml/` for that alone: `sequence.ts` for `errors.ts`, and `check-enum.ts` for `errors.ts` and
-* `diagnostics.ts`. `read/oxml/dom.ts` re-exports it, so no read-side import path changed.
+* This lives at the root rather than under `gen/` or `read/` because both halves need it:
+* the emitters strip on the way in, the readers strip on the way back out. For the same
+* reason, the *validation* belongs here too. `REGEX_HEX_COLOR` used to live in
+* `constants-internal.ts`, which is a write-side module the read path cannot import, so the read
+* path re-spelled the regex; so did one write-side site. Six sites, three spellings of one fact.
 */
-/** Canonical OOXML prefix → namespace URI registry. */
-const OOXML_NS = Object.freeze({
-	a: "http://schemas.openxmlformats.org/drawingml/2006/main",
-	a14: "http://schemas.microsoft.com/office/drawing/2010/main",
-	asvg: "http://schemas.microsoft.com/office/drawing/2016/SVG/main",
-	c: "http://schemas.openxmlformats.org/drawingml/2006/chart",
-	c15: "http://schemas.microsoft.com/office/drawing/2012/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",
-	m: "http://schemas.openxmlformats.org/officeDocument/2006/math",
-	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",
-	p15: "http://schemas.microsoft.com/office/powerpoint/2012/main",
-	p159: "http://schemas.microsoft.com/office/powerpoint/2015/9/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",
-	vt: "http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes"
-});
 /**
-* `a:graphicData/@uri` for a DrawingML table.
+* A colour written as six hex digits, `#` already stripped.
 *
-* The other three payloads a `p:graphicFrame` can hold name a URI that is also a namespace, so
-* they read it off {@link OOXML_NS} (`c`, `cx`, `dgm`). A table's does not: nothing binds a
-* prefix to it, and the table elements themselves are in the `a` namespace. So it lives beside
-* the registry rather than in it, which keeps every entry there a prefix a document can declare.
+* Not exported: {@link isHexColor} is the whole of what the call sites want, and a shared mutable
+* `RegExp` object is a worse export than a predicate.
 */
-const TABLE_GRAPHIC_DATA_URI = "http://schemas.openxmlformats.org/drawingml/2006/table";
+const REGEX_HEX_COLOR = /^[0-9a-fA-F]{6}$/;
+/** An 8-hex RGBA colour, `#` already stripped: {@link splitRgbaHex}'s test. */
+const REGEX_ARGB_HEX = /^[0-9a-fA-F]{8}$/;
+/** Strip a single leading `#` from a colour, leaving any other character alone. */
+function stripHash(value) {
+	return value.startsWith("#") ? value.slice(1) : value;
+}
 /**
-* The `xmlns` declarations every PresentationML part root carries, in the order the emitters
-* have always written them.
+* Is `value` a 6-hex RGB colour? A leading `#` is stripped first, so both spellings agree.
 *
-* 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.
+* This is the *shape* test only. Whether the caller may also name a scheme colour there is the
+* call site's question, and each still asks it: `createColorElement` falls back to the default
+* font colour, `makeXmlTheme` keeps the Office default and warns, `normalizeHex` throws.
+* @param value - the caller's colour, with or without a leading `#`
 */
-const PML_ROOT_NS = Object.freeze({
-	"xmlns:a": OOXML_NS.a,
-	"xmlns:r": OOXML_NS.r,
-	"xmlns:p": OOXML_NS.p
-});
-//#endregion
-//#region src/ooxml/rel-types.ts
+function isHexColor(value) {
+	return REGEX_HEX_COLOR.test(stripHash(value));
+}
 /**
-* 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
-* nothing on the read side and produces a part PowerPoint ignores or rejects on the write side.
-*
-* **Why this module is neither `gen/` nor `read/`.** Both halves need the same URIs, and for a
-* while each kept its own copy (`gen/oxml/schema-uris.ts`, `read/api/rel-types.ts`), with a note
-* in both saying a shared home was "a separate decision". It is this module: a rel type is a fact
-* about the OOXML package format, not about writing or reading one, so neither side should own it.
-* A divergence between the two copies would mean the writer emitting a rel the reader cannot find
-* — a round-trip bug with no compile-time signal.
-*
-* Only types used by more than one module live here. A rel type exactly one module cares about
-* (`tags`, `oleObject`, the modern comments part, …) 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. A writer and a reader of the same part count as two modules even when each
-* names the string once: that pair is exactly the divergence this module exists to prevent.
+* Is `value` an 8-hex RGBA colour? A leading `#` is stripped first.
 *
-* The same reasoning covers **part content types**, which are the same kind of fact and fail the
-* same silent way, including every entry the writer's `[Content_Types].xml` declares.
-*/
-/**
-* Prefix for `.rels` `Type` URIs — append the type name (`slide`, `image`, `theme`, …).
-* Exported for the write side, which builds one-off rel types at their call sites.
-*/
-const OFFICE_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/";
-/** `xmlns` of every `<Relationships>` part. Also the prefix of the package-scoped rel types. */
-const PACKAGE_REL_NS = OOXML_NS.pr;
-/**
-* Prefix for the Microsoft rel types this library emits and reads. Exported for the same reason
-* as {@link OFFICE_REL}: a rel type only one module names is built from it at that module's call site.
-*/
-const MS_REL = "http://schemas.microsoft.com/office/";
-/** `p:sldIdLst` → a slide part. */
-const SLIDE_REL = OFFICE_REL + "slide";
-/** A slide → its layout; a master → each of its layouts. */
-const SLIDE_LAYOUT_REL = OFFICE_REL + "slideLayout";
-/** A layout → its master; the presentation → each master. */
-const SLIDE_MASTER_REL = OFFICE_REL + "slideMaster";
-/** A slide → its notes slide. */
-const NOTES_SLIDE_REL = OFFICE_REL + "notesSlide";
-/** A notes slide → the notes master; the presentation → the notes master. */
-const NOTES_MASTER_REL = OFFICE_REL + "notesMaster";
-/** A master or notes master → its theme. Layouts and slides inherit it rather than holding one. */
-const THEME_REL = OFFICE_REL + "theme";
-/** The package root → `ppt/presentation.xml`. The entry point to everything above. */
-const OFFICE_DOCUMENT_REL = OFFICE_REL + "officeDocument";
-/** Any part → an image in `ppt/media/`. */
-const IMAGE_REL = OFFICE_REL + "image";
-/** Any part → an external or internal jump target. External ones carry `TargetMode="External"`. */
-const HYPERLINK_REL = OFFICE_REL + "hyperlink";
-/** The presentation → `ppt/tableStyles.xml`. */
-const TABLE_STYLES_REL = OFFICE_REL + "tableStyles";
-/** The package root → `docProps/core.xml`. Package-scoped, so not under {@link OFFICE_REL}. */
-const CORE_PROPS_REL = PACKAGE_REL_NS + "/metadata/core-properties";
-/** The package root → `docProps/app.xml`. */
-const EXTENDED_PROPS_REL = OFFICE_REL + "extended-properties";
-/** The package root → `docProps/custom.xml`. */
-const CUSTOM_PROPS_REL = OFFICE_REL + "custom-properties";
-/** A slide → its legacy comments part (`ppt/comments/commentN.xml`). */
-const COMMENTS_REL = OFFICE_REL + "comments";
-/** The presentation → the deck-wide legacy comment-author registry (`ppt/commentAuthors.xml`). */
-const COMMENT_AUTHORS_REL = OFFICE_REL + "commentAuthors";
-/** The presentation → the 2018 comment-author registry (`ppt/authors.xml`), a Microsoft rel type. */
-const MODERN_COMMENT_AUTHORS_REL = MS_REL + "2018/10/relationships/authors";
-/** The presentation → `ppt/presProps.xml`. */
-const PRES_PROPS_REL = OFFICE_REL + "presProps";
-/** The presentation → `ppt/viewProps.xml`. */
-const VIEW_PROPS_REL = OFFICE_REL + "viewProps";
-/** The presentation → the handout master. */
-const HANDOUT_MASTER_REL = OFFICE_REL + "handoutMaster";
-/** A part → a theme override, which replaces the deck theme for that part alone. */
-const THEME_OVERRIDE_REL = OFFICE_REL + "themeOverride";
-/** The presentation → an embedded font part, one per face. */
-const FONT_REL = OFFICE_REL + "font";
-/** A slide → an audio blob in `ppt/media/`. Paired with {@link MS_MEDIA_REL} on the same target. */
-const AUDIO_REL = OFFICE_REL + "audio";
-/** A slide → a video blob in `ppt/media/`, or an online-video placeholder. Paired with {@link MS_MEDIA_REL}. */
-const VIDEO_REL = OFFICE_REL + "video";
-/**
-* The MS-2007 `media` rel every audio/video shape carries alongside the ECMA one, pointing at the
-* same target. It is what `<p14:media r:embed>` resolves, so a media shape needs both.
+* The 8-digit form is RGB followed by one alpha byte; {@link splitRgbaHex} is what takes it apart.
+* @param value - the caller's colour, with or without a leading `#`
 */
-const MS_MEDIA_REL = MS_REL + "2007/relationships/media";
-/** A slide → an embedded 3D model (`.glb`). Note `2017/06`, not the `2017` of the model3d namespace. */
-const MODEL3D_REL = MS_REL + "2017/06/relationships/model3d";
-/** A slide → a classic (`c:`) chart part. */
-const CHART_REL = OFFICE_REL + "chart";
-/** A slide → a chartEx (`cx:`, Office 2016) chart part — an MS rel, not the ECMA `chart` one. */
-const CHARTEX_REL = MS_REL + "2014/relationships/chartEx";
-/** A chart part → its mandatory style sidecar. */
-const CHART_STYLE_REL = MS_REL + "2011/relationships/chartStyle";
-/** A chart part → its mandatory colour-style sidecar. */
-const CHART_COLOR_STYLE_REL = MS_REL + "2011/relationships/chartColorStyle";
-/** Any part → an embedded OPC package (an Office file, itself a zip): a chart's workbook, an OLE payload. */
-const PACKAGE_REL = OFFICE_REL + "package";
+function isArgbHex(value) {
+	return REGEX_ARGB_HEX.test(stripHash(value));
+}
 /**
-* Root of the ECMA-376 content types. Exported for a content type only one module names, which is
-* built from it at that module's call site; a shared one is a constant below.
+* Split an 8-hex RGBA colour into its 6-hex RGB and a 0–1 alpha; anything else passes through
+* unchanged with no alpha.
+*
+* `#` is stripped first, so both spellings reach the same answer. Two sites parsed this by
+* hand (`createColorElement`, which turns the alpha into an `<a:alpha>` sibling, and
+* `normalizeShadowOptions`, which turns it into a shadow's `_alpha`), and they divided by 255 at
+* different points in their arithmetic.
+* @param value - the caller's colour, with or without a leading `#`
 */
-const OD_CONTENT = "application/vnd.openxmlformats-officedocument.";
-/** Root of the OPC package-level content types. Private: callers want one of the constants below. */
-const PACKAGE_CONTENT = "application/vnd.openxmlformats-package.";
-/** Root of the Microsoft Office content types the chartEx family uses. Private. */
-const MS_OFFICE_CONTENT = "application/vnd.ms-office.";
-/** Root of the PowerPoint-specific Microsoft content types. Exported for the same reason as {@link OD_CONTENT}. */
-const MS_POWERPOINT_CONTENT = "application/vnd.ms-powerpoint.";
-/** `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";
-/** `ppt/tableStyles.xml`. */
-const TABLE_STYLES_CONTENT_TYPE = OD_CONTENT + "presentationml.tableStyles+xml";
-/** `ppt/presentation.xml` in an editable `.pptx`. A `.potx` template's main part is a different one. */
-const PRESENTATION_MAIN_CONTENT_TYPE = OD_CONTENT + "presentationml.presentation.main+xml";
-/** Every `.rels` part. Declared once as a `Default` for the `rels` extension, never as an Override. */
-const RELATIONSHIPS_CONTENT_TYPE = PACKAGE_CONTENT + "relationships+xml";
-/** `ppt/presProps.xml`. */
-const PRES_PROPS_CONTENT_TYPE = OD_CONTENT + "presentationml.presProps+xml";
-/** `ppt/viewProps.xml`. */
-const VIEW_PROPS_CONTENT_TYPE = OD_CONTENT + "presentationml.viewProps+xml";
-/** `ppt/comments/commentN.xml`, a legacy comments part. */
-const COMMENTS_CONTENT_TYPE = OD_CONTENT + "presentationml.comments+xml";
-/** `ppt/commentAuthors.xml`. */
-const COMMENT_AUTHORS_CONTENT_TYPE = OD_CONTENT + "presentationml.commentAuthors+xml";
-/** `docProps/core.xml`. Package-scoped, so not under the officedocument prefix. */
-const CORE_PROPS_CONTENT_TYPE = PACKAGE_CONTENT + "core-properties+xml";
-/** `docProps/app.xml`. */
-const EXTENDED_PROPS_CONTENT_TYPE = OD_CONTENT + "extended-properties+xml";
-/** `docProps/custom.xml`. */
-const CUSTOM_PROPS_CONTENT_TYPE = OD_CONTENT + "custom-properties+xml";
-/** `ppt/charts/chartN.xml`, a classic (`c:`) chart. */
-const CHART_CONTENT_TYPE = OD_CONTENT + "drawingml.chart+xml";
-/** `ppt/charts/chartExN.xml`. A chartEx part carries a Microsoft content type, not an `openxmlformats` one. */
-const CHARTEX_CONTENT_TYPE = MS_OFFICE_CONTENT + "chartex+xml";
-/** A chart's mandatory `style{N}.xml` sidecar. */
-const CHART_STYLE_CONTENT_TYPE = MS_OFFICE_CONTENT + "chartstyle+xml";
-/** A chart's mandatory `colors{N}.xml` sidecar. */
-const CHART_COLOR_STYLE_CONTENT_TYPE = MS_OFFICE_CONTENT + "chartcolorstyle+xml";
-/** An embedded `.xlsx` workbook: a chart's data, or an OLE payload. */
-const XLSX_CONTENT_TYPE = OD_CONTENT + "spreadsheetml.sheet";
+function splitRgbaHex(value) {
+	const hex = stripHash(value);
+	if (!isArgbHex(hex)) return { rgb: hex };
+	return {
+		rgb: hex.slice(0, 6),
+		alpha: parseInt(hex.slice(6, 8), 16) / 255
+	};
+}
+// src/ooxml/xsd-boolean.ts
 /**
-* Every kind of part a page points at without owning it.
+* Parsing an `xsd:boolean` attribute value.
 *
-* Two questions read this table, under different keys. Copying a page asks whether a relationship's
-* target may be shared by the copies rather than copied (every row, by `relType`). Pruning after a
-* slide is removed asks whether a part is deck chrome that stays even while nothing reaches it (the
-* `deck` rows, by `contentType`). They were two hand-kept lists, and the two author registries were
-* on the first and missing from the second.
-*/
-const SHARED_PARTS = [
-	{
-		relType: SLIDE_LAYOUT_REL,
-		contentType: SLIDE_LAYOUT_CONTENT_TYPE,
-		scope: "deck"
-	},
-	{
-		relType: SLIDE_MASTER_REL,
-		contentType: SLIDE_MASTER_CONTENT_TYPE,
-		scope: "deck"
-	},
-	{
-		relType: NOTES_MASTER_REL,
-		contentType: NOTES_MASTER_CONTENT_TYPE,
-		scope: "deck"
-	},
-	{
-		relType: THEME_REL,
-		contentType: THEME_CONTENT_TYPE,
-		scope: "deck"
-	},
-	{
-		relType: THEME_OVERRIDE_REL,
-		contentType: OD_CONTENT + "themeOverride+xml",
-		scope: "deck"
-	},
-	{
-		relType: HANDOUT_MASTER_REL,
-		contentType: OD_CONTENT + "presentationml.handoutMaster+xml",
-		scope: "deck"
-	},
-	{
-		relType: PRES_PROPS_REL,
-		contentType: PRES_PROPS_CONTENT_TYPE,
-		scope: "deck"
-	},
-	{
-		relType: VIEW_PROPS_REL,
-		contentType: VIEW_PROPS_CONTENT_TYPE,
-		scope: "deck"
-	},
-	{
-		relType: TABLE_STYLES_REL,
-		contentType: TABLE_STYLES_CONTENT_TYPE,
-		scope: "deck"
-	},
-	{
-		relType: OFFICE_DOCUMENT_REL,
-		contentType: PRESENTATION_MAIN_CONTENT_TYPE,
-		scope: "deck"
-	},
-	{
-		relType: COMMENT_AUTHORS_REL,
-		contentType: COMMENT_AUTHORS_CONTENT_TYPE,
-		scope: "deck"
-	},
-	{
-		relType: MODERN_COMMENT_AUTHORS_REL,
-		contentType: "application/vnd.ms-powerpoint.authors+xml",
-		scope: "deck"
-	},
-	{
-		relType: IMAGE_REL,
-		contentType: null,
-		scope: "media"
-	},
-	{
-		relType: AUDIO_REL,
-		contentType: null,
-		scope: "media"
-	},
-	{
-		relType: VIDEO_REL,
-		contentType: null,
-		scope: "media"
-	},
-	{
-		relType: MS_MEDIA_REL,
-		contentType: null,
-		scope: "media"
-	},
-	{
-		relType: MODEL3D_REL,
-		contentType: null,
-		scope: "media"
-	},
-	{
-		relType: FONT_REL,
-		contentType: null,
-		scope: "media"
-	},
-	{
-		relType: SLIDE_REL,
-		contentType: null,
-		scope: "page"
-	},
-	{
-		relType: HYPERLINK_REL,
-		contentType: null,
-		scope: "page"
-	}
-];
-//#endregion
-//#region src/ooxml/st-enums.ts
+* **Why a function at all.** `xsd:boolean` has four lexical forms (`1`, `0`, `true`, `false`),
+* and OOXML attributes typed with it accept every one of them. PowerPoint writes only `1` and
+* `0`, so a hand-rolled `=== '1'` test passes against every deck this library produces and
+* against every deck PowerPoint produces, and silently misreads the other producers. That is the
+* worst shape a bug can have: invisible to the fixtures, visible only on a customer's file.
+*
+* **Why this module is neither `gen/` nor `read/`.** The lexical space of a schema type is a fact
+* about the schema, like `sequence.ts`'s document order and `body-insets.ts`'s defaults. The
+* parser lived in `read/oxml/dom.ts` because reading is where most of the demand is, and three
+* private copies had collapsed into it, but `read/oxml/dom.ts` imports `@xmldom/xmldom`, so
+* anything outside `read/` that wants this five-line function has to take a DOM dependency to get
+* it, or write a fourth copy. `script/from-read/detect.ts` hit exactly that and wrote the copy.
+*
+* The DOM-typed convenience wrapper stays behind in `read/oxml/dom.ts` as `boolAttr`, because
+* *that* one really is about reading an element.
+*
+* **The write direction is here too**, and it is where the interesting distinction lives: an
+* emitter writing a boolean has THREE useful shapes, not one; see {@link xsdBool} and
+* {@link xsdBoolIfTrue}. Sixty-odd inline ternaries spelled them in three ways with nothing
+* naming which was which.
+*/
+/**
+* Parse an `xsd:boolean` OOXML attribute (`1`/`0`/`true`/`false`); else `null`.
+*
+* `null` for an absent *or* unparseable value is deliberate and load-bearing at the call sites:
+* several attributes have a schema default of `true`, so they test `!== false` rather than
+* `=== true` and an unset attribute has to be distinguishable from an explicit `0`.
+*/
+function boolValue(value) {
+	if (value === "1" || value === "true") return true;
+	if (value === "0" || value === "false") return false;
+	return null;
+}
+/**
+* A boolean as the `1`/`0` an `xsd:boolean` attribute takes.
+*
+* Writes the attribute either way, so `false` is *stated*. Use this wherever the schema
+* default is `true`, or wherever the absence of the attribute would mean something other
+* than `false`: a value inherited from a list style, a layout or the theme.
+* @param value - the resolved boolean
+*/
+function xsdBool(value) {
+	return value ? "1" : "0";
+}
+/**
+* A boolean as `1`, or `null` so the attribute is left out entirely.
+*
+* **Correct only where the schema default is `false`.** It collapses "false" and "unset" into
+* one output, which is the two-spellings-for-three-states shape the API policy warns about: the
+* next attribute with a `true` default written this way reads as correct and is wrong. Every
+* current caller is on a `false`-defaulting attribute, so the collapse costs nothing today;
+* naming it is what makes the next one visible.
+* @param value - the resolved boolean
+*/
+function xsdBoolIfTrue(value) {
+	return value ? "1" : null;
+}
+// src/ooxml/check-enum.ts
+/**
+* Check a value against its `ST_` union, reporting and dropping it when outside (the write-path
+* policy, described in 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, described
+* in 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(", ")}.`);
+}
+// 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.
@@ -525,7 +361,7 @@ const SHARED_PARTS = [
 * 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.
+* `(typeof X)[number]`. Widening the tuple widens the union in the same edit, so they cannot drift.
 * This is the idiom `EXTRA_SHAPE_PRESETS` already used; this module brings the stragglers onto it,
 * and holds a few closed schema lists that are not `ST_` types, such as `EMBEDDED_FONT_SLOTS`.
 *
@@ -543,11 +379,11 @@ const SHARED_PARTS = [
 * unfinished for a while. `src/types/chart.ts`
 * hand-wrote four of those unions beside the option that takes them and typed the other three as
 * bare `string`, so `barDir` carried no compile-time check at all, and `dataLabelPosition`'s
-* hand-written union was missing `inBase` — a value the validator accepts on a stacked bar, so
+* hand-written union was missing `inBase`, a value the validator accepts on a stacked bar, so
 * the two spellings had already diverged in content. Both are gone: for every option here, the
 * type a caller is checked against and the tuple the validator checks are one declaration.
 */
-/** `ST_TextAutonumberScheme` — the numbering an auto-numbered bullet counts in (`a:buAutoNum/@type`). */
+/** `ST_TextAutonumberScheme`: the numbering an auto-numbered bullet counts in (`a:buAutoNum/@type`). */
 const TEXT_AUTONUM_SCHEMES = [
 	"alphaLcParenBoth",
 	"alphaUcParenBoth",
@@ -591,19 +427,19 @@ const TEXT_AUTONUM_SCHEMES = [
 	"hindiNumParenR",
 	"hindiAlpha1Period"
 ];
-/** `ST_TextStrikeType` — a run's strikethrough (`a:rPr/@strike`). */
+/** `ST_TextStrikeType`: a run's strikethrough (`a:rPr/@strike`). */
 const TEXT_STRIKE_TYPES = [
 	"noStrike",
 	"sngStrike",
 	"dblStrike"
 ];
-/** `ST_TextCapsType` — a run's capitalization (`a:rPr/@cap`). */
+/** `ST_TextCapsType`: a run's capitalization (`a:rPr/@cap`). */
 const TEXT_CAPS_TYPES = [
 	"none",
 	"small",
 	"all"
 ];
-/** `ST_TextUnderlineType` — a run's underline (`a:rPr/@u`). */
+/** `ST_TextUnderlineType`: a run's underline (`a:rPr/@u`). */
 const TEXT_UNDERLINE_TYPES = [
 	"none",
 	"words",
@@ -624,7 +460,7 @@ const TEXT_UNDERLINE_TYPES = [
 	"wavyHeavy",
 	"wavyDbl"
 ];
-/** `ST_TextTabAlignType` — a tab stop's alignment (`a:tab/@algn`). */
+/** `ST_TextTabAlignType`: a tab stop's alignment (`a:tab/@algn`). */
 const TEXT_TAB_ALIGN_TYPES = [
 	"l",
 	"ctr",
@@ -632,7 +468,7 @@ const TEXT_TAB_ALIGN_TYPES = [
 	"dec"
 ];
 /**
-* `ST_SchemeColorVal` — a theme colour reference (`a:schemeClr/@val`). Wider than
+* `ST_SchemeColorVal`: a theme colour reference (`a:schemeClr/@val`). Wider than
 * {@link THEME_COLOR_SLOTS}: it adds the `bg1`/`tx1`/`bg2`/`tx2` aliases the colour map resolves,
 * and `phClr`, the colour a theme style-matrix entry is applied in.
 */
@@ -713,7 +549,7 @@ const TRANSITION_VARIANT_ATTRIBUTES = {
 	zoom: ["dir"]
 };
 /**
-* `ST_BevelPresetType` — the bevel profile applied to a 3-D edge.
+* `ST_BevelPresetType`: the bevel profile applied to a 3-D edge.
 * @see ECMA-376 Part 1 §20.1.10.9
 */
 const BEVEL_PRESETS = [
@@ -731,7 +567,7 @@ const BEVEL_PRESETS = [
 	"artDeco"
 ];
 /**
-* `ST_PresetMaterialType` — how a 3-D surface responds to light.
+* `ST_PresetMaterialType`: how a 3-D surface responds to light.
 * @see ECMA-376 Part 1 §20.1.10.50
 */
 const PRESET_MATERIALS = [
@@ -752,7 +588,7 @@ const PRESET_MATERIALS = [
 	"softmetal"
 ];
 /**
-* `ST_LightRigType` — the preset lighting scene.
+* `ST_LightRigType`: the preset lighting scene.
 * @see ECMA-376 Part 1 §20.1.10.35
 */
 const LIGHT_RIGS = [
@@ -785,7 +621,7 @@ const LIGHT_RIGS = [
 	"brightRoom"
 ];
 /**
-* `ST_LightRigDirection` — where the light rig sits relative to the scene.
+* `ST_LightRigDirection`: where the light rig sits relative to the scene.
 * @see ECMA-376 Part 1 §20.1.10.33
 */
 const LIGHT_RIG_DIRECTIONS = [
@@ -799,12 +635,12 @@ const LIGHT_RIG_DIRECTIONS = [
 	"br"
 ];
 /**
-* `ST_TextHorzOverflowType` — `a:bodyPr/@horzOverflow` and `a:tcPr/@horzOverflow`.
+* `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`.
+* `ST_TextAnchoringType`: `a:bodyPr/@anchor` and `a:tcPr/@anchor`.
 * @see ECMA-376 Part 1 §20.1.10.60
 */
 const TEXT_ANCHORS = [
@@ -815,7 +651,66 @@ const TEXT_ANCHORS = [
 	"dist"
 ];
 /**
-* `ST_TextVerticalType` — `a:bodyPr/@vert` and `a:tcPr/@vert`.
+* `ST_PresetPatternVal`: `a:pattFill/@prst`, the hatch a pattern fill draws.
+*/
+const PATTERN_PRESETS = [
+	"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"
+];
+/**
+* `ST_TextVerticalType`: `a:bodyPr/@vert` and `a:tcPr/@vert`.
 * @see ECMA-376 Part 1 §20.1.10.83
 */
 const TEXT_VERTICAL = [
@@ -828,7 +723,7 @@ const TEXT_VERTICAL = [
 	"wordArtVertRtl"
 ];
 /**
-* `ST_LineEndType` — the arrowhead at either end of a stroke (`a:headEnd/@type`,
+* `ST_LineEndType`: the arrowhead at either end of a stroke (`a:headEnd/@type`,
 * `a:tailEnd/@type`).
 * @see ECMA-376 Part 1 §20.1.10.33
 */
@@ -855,11 +750,34 @@ const EMBEDDED_FONT_SLOTS = [
 	"boldItalic"
 ];
 /**
-* `ST_TextShapeType` — the preset path text is bent along (`a:prstTxWarp/@prst`), which
+* `ST_PlaceholderType`: the kind of placeholder a `p:ph` fills (`p:ph/@type`). Absent, it means
+* `obj`.
+* @see ECMA-376 Part 1 §19.7.10
+*/
+const PLACEHOLDER_TYPES = [
+	"title",
+	"body",
+	"ctrTitle",
+	"subTitle",
+	"dt",
+	"sldNum",
+	"ftr",
+	"hdr",
+	"obj",
+	"chart",
+	"tbl",
+	"clipArt",
+	"dgm",
+	"media",
+	"sldImg",
+	"pic"
+];
+/**
+* `ST_TextShapeType`: the preset path text is bent along (`a:prstTxWarp/@prst`), which
 * PowerPoint calls WordArt.
 *
 * `textNoShape` is the identity member: it is legal, and it warps nothing. The library does not
-* narrow this set — every member is a shape PowerPoint draws.
+* narrow this set: every member is a shape PowerPoint draws.
 * @see ECMA-376 Part 1 §20.1.10.76
 */
 const TEXT_SHAPE_TYPES = [
@@ -906,7 +824,7 @@ const TEXT_SHAPE_TYPES = [
 	"textCascadeDown"
 ];
 /**
-* `ST_PresetLineDashVal` — the dash pattern of a line or border (`a:prstDash/@val`).
+* `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
@@ -927,12 +845,12 @@ const PRESET_LINE_DASHES = [
 	"sysDashDotDot"
 ];
 /**
-* `ST_BarDir` — whether a bar/column plot runs horizontally or vertically (`c:barDir/@val`).
+* `ST_BarDir`: whether a bar/column plot runs horizontally or vertically (`c:barDir/@val`).
 * @see ECMA-376 Part 1 §21.2.3.3
 */
 const BAR_DIRECTIONS = ["bar", "col"];
 /**
-* `ST_BarGrouping` — how a bar/column plot stacks its series (`c:grouping/@val` inside
+* `ST_BarGrouping`: how a bar/column plot stacks its series (`c:grouping/@val` inside
 * `c:barChart`/`c:bar3DChart`).
 * @see ECMA-376 Part 1 §21.2.3.4
 */
@@ -943,7 +861,7 @@ const BAR_GROUPINGS = [
 	"stacked"
 ];
 /**
-* `ST_Grouping` — the same decision for the plots that have no clustered form
+* `ST_Grouping`: the same decision for the plots that have no clustered form
 * (`c:areaChart`, `c:lineChart`).
 * @see ECMA-376 Part 1 §21.2.3.17
 */
@@ -953,7 +871,7 @@ const GROUPINGS = [
 	"stacked"
 ];
 /**
-* `ST_Shape` — the solid a 3-D bar is drawn as (`c:shape/@val`).
+* `ST_Shape`: the solid a 3-D bar is drawn as (`c:shape/@val`).
 * @see ECMA-376 Part 1 §21.2.3.35
 */
 const BAR_3D_SHAPES = [
@@ -965,7 +883,7 @@ const BAR_3D_SHAPES = [
 	"pyramidToMax"
 ];
 /**
-* `ST_RadarStyle` — how a radar plot is drawn (`c:radarStyle/@val`).
+* `ST_RadarStyle`: how a radar plot is drawn (`c:radarStyle/@val`).
 * @see ECMA-376 Part 1 §21.2.3.33
 */
 const RADAR_STYLES = [
@@ -980,8 +898,8 @@ const RADAR_STYLES = [
 * what made the other two read as typos rather than as a second vocabulary.
 *
 * Both spellings are accepted on the public option and normalized to the wire one at definition
-* time. Before that, `radarStyle: 'marker'` — the schema's word, and the obvious guess for anyone
-* reading a chart part — failed the enum check and silently fell back to `standard`, so a caller
+* time. Before that, `radarStyle: 'marker'` (the schema's word, and the obvious guess for anyone
+* reading a chart part) failed the enum check and silently fell back to `standard`, so a caller
 * asking for markers got a plain radar.
 */
 const RADAR_STYLE_ALIASES = {
@@ -990,12 +908,12 @@ const RADAR_STYLE_ALIASES = {
 };
 /**
 * The alias spellings alone, for the definer's enum check. Derived from the map rather than
-* written out again — the whole point of this module is that the list a value is validated
+* written out again: the whole point of this module is that the list a value is validated
 * against and the union it is typed against cannot drift apart.
 */
 const RADAR_STYLE_ALIAS_NAMES = Object.keys(RADAR_STYLE_ALIASES);
 /**
-* `ST_LegendPos` — where the legend sits relative to the plot area (`c:legendPos/@val`).
+* `ST_LegendPos`: where the legend sits relative to the plot area (`c:legendPos/@val`).
 * @see ECMA-376 Part 1 §21.2.3.24
 */
 const LEGEND_POSITIONS = [
@@ -1006,7 +924,7 @@ const LEGEND_POSITIONS = [
 	"t"
 ];
 /**
-* `ST_DispBlanksAs` — what a plot draws where a value is missing (`c:dispBlanksAs/@val`).
+* `ST_DispBlanksAs`: what a plot draws where a value is missing (`c:dispBlanksAs/@val`).
 * @see ECMA-376 Part 1 §21.2.3.10
 */
 const DISPLAY_BLANKS_AS = [
@@ -1019,7 +937,7 @@ const DISPLAY_BLANKS_AS = [
 *
 * The schema also has `plus`, `star`, `x`, `picture` and `auto`. Neither PowerPoint 2013 nor
 * PowerPoint Online draws the first three, `picture` needs a `c:spPr` blip this API has no
-* spelling for, and `auto` is what leaving the option off already means — so the accepted set is
+* spelling for, and `auto` is what leaving the option off already means, so the accepted set is
 * deliberately smaller than the type. Widen it only with evidence that the member renders.
 * @see ECMA-376 Part 1 §21.2.3.27
 */
@@ -1032,25 +950,25 @@ const LINE_DATA_SYMBOLS = [
 	"square",
 	"triangle"
 ];
-/** `ST_TickLblPos` — where an axis draws its tick labels (`c:tickLblPos/@val`). */
+/** `ST_TickLblPos`: where an axis draws its tick labels (`c:tickLblPos/@val`). */
 const TICK_LABEL_POSITIONS = [
 	"high",
 	"low",
 	"nextTo",
 	"none"
 ];
-/** `ST_Orientation` — which way an axis runs (`c:orientation/@val`). */
+/** `ST_Orientation`: which way an axis runs (`c:orientation/@val`). */
 const AXIS_ORIENTATIONS = ["maxMin", "minMax"];
-/** `ST_TickMark` — an axis' major or minor tick marks (`c:majorTickMark/@val`, `c:minorTickMark/@val`). */
+/** `ST_TickMark`: an axis' major or minor tick marks (`c:majorTickMark/@val`, `c:minorTickMark/@val`). */
 const TICK_MARKS = [
 	"cross",
 	"in",
 	"none",
 	"out"
 ];
-/** `ST_CrossBetween` — whether a value axis crosses its category axis between or on categories (`c:crossBetween/@val`). */
+/** `ST_CrossBetween`: whether a value axis crosses its category axis between or on categories (`c:crossBetween/@val`). */
 const CROSS_BETWEEN = ["between", "midCat"];
-/** `ST_BuiltInUnit` — the unit a value axis displays its labels in (`c:builtInUnit/@val`). */
+/** `ST_BuiltInUnit`: the unit a value axis displays its labels in (`c:builtInUnit/@val`). */
 const BUILT_IN_UNITS = [
 	"hundreds",
 	"thousands",
@@ -1062,21 +980,21 @@ const BUILT_IN_UNITS = [
 	"billions",
 	"trillions"
 ];
-/** `ST_TimeUnit` — a date axis' base, major or minor time unit (`c:baseTimeUnit/@val` and its two siblings). */
+/** `ST_TimeUnit`: a date axis' base, major or minor time unit (`c:baseTimeUnit/@val` and its two siblings). */
 const TIME_UNITS = [
 	"days",
 	"months",
 	"years"
 ];
-/** `ST_ErrDir` — the axis an error bar measures along (`c:errDir/@val`). */
+/** `ST_ErrDir`: the axis an error bar measures along (`c:errDir/@val`). */
 const ERROR_BAR_DIRECTIONS = ["x", "y"];
-/** `ST_ErrBarType` — which sides of a point draw an error bar (`c:errBarType/@val`). */
+/** `ST_ErrBarType`: which sides of a point draw an error bar (`c:errBarType/@val`). */
 const ERROR_BAR_TYPES = [
 	"both",
 	"minus",
 	"plus"
 ];
-/** `ST_ErrValType` — how an error bar's amount is read (`c:errValType/@val`). */
+/** `ST_ErrValType`: how an error bar's amount is read (`c:errValType/@val`). */
 const ERROR_BAR_VALUE_TYPES = [
 	"cust",
 	"fixedVal",
@@ -1087,7 +1005,7 @@ const ERROR_BAR_VALUE_TYPES = [
 /**
 * The twelve theme colour slots (`a:clrScheme` children) a `p:clrMap` token can point at.
 *
-* Not an `ST_` type — these are element names inside `a:CT_ColorScheme`, which the schema
+* Not an `ST_` type: these are element names inside `a:CT_ColorScheme`, which the schema
 * declares as a fixed sequence rather than an enumeration. The effect is the same: a closed,
 * ordered set of twelve names, in the order the scheme declares them.
 * @see ECMA-376 Part 1 §20.1.6.2
@@ -1111,7 +1029,7 @@ const THEME_COLOR_SLOTS = [
 *
 * A slide's `schemeClr val="tx1"` names a *token*, not a slot: the master's `p:clrMap` is the
 * indirection that sends it to a {@link ThemeColorSlot}. Which is why the two lists look alike
-* and are not the same list — `bg1`/`tx1` are tokens, `lt1`/`dk1` are slots.
+* and are not the same list: `bg1`/`tx1` are tokens, `lt1`/`dk1` are slots.
 * @see ECMA-376 Part 1 §19.3.1.6
 */
 const COLOR_MAP_TOKENS = [
@@ -1133,8 +1051,8 @@ const COLOR_MAP_TOKENS = [
 * and the one the script printer recognises so it can skip printing a map that is the default.
 *
 * "Identity" up to the light/dark naming: each token points at the slot of the same name, with
-* `bg`/`tx` reading as light/dark. A deck that maps them anywhere else — swapping the light and
-* dark slots is the usual case — resolves every `schemeClr` in the deck differently.
+* `bg`/`tx` reading as light/dark. A deck that maps them anywhere else (swapping the light and
+* dark slots is the usual case) resolves every `schemeClr` in the deck differently.
 *
 * Typed `Record<ColorMapToken, ThemeColorSlot>` so a token added to {@link COLOR_MAP_TOKENS}
 * without a mapping, or a slot misspelled, is a compile error rather than a theme that opens
@@ -1155,182 +1073,339 @@ const DEFAULT_COLOR_MAP = {
 	hlink: "hlink",
 	folHlink: "folHlink"
 };
-//#endregion
-//#region src/hex-color.ts
-/**
-* ts-pptx: hex colour text, in the one spelling both halves use.
-*
-* A caller may write a colour with or without a leading `#`, and the library accepts both
-* everywhere — which means every site that validates or parses one strips it first. Those
-* strips had drifted into three spellings across six sites, and one of them was not
-* anchored: `.replace('#', '')` takes the `#` out of `'FF00#0'` and hands `'FF000'` on, which
-* then fails the six-digit test and takes a different branch than the anchored forms would.
-* No caller is known to reach that, which is exactly why it wants one spelling rather than a
-* test at each site.
-*
-* This lives at the root rather than under `gen/` or `read/` because both halves need it:
-* the emitters strip on the way in, the readers strip on the way back out — and for the same
-* reason the *validation* belongs here too. `REGEX_HEX_COLOR` used to live in
-* `constants-internal.ts`, which is a write-side module the read path cannot import, so the read
-* path re-spelled the regex; so did one write-side site. Six sites, three spellings of one fact.
-*/
+// src/ooxml/namespaces.ts
 /**
-* A colour written as six hex digits, `#` already stripped.
+* OOXML namespace URIs, by their canonical prefix.
 *
-* Not exported: {@link isHexColor} is the whole of what the call sites want, and a shared mutable
-* `RegExp` object is a worse export than a predicate.
-*/
-const REGEX_HEX_COLOR = /^[0-9a-fA-F]{6}$/;
-/** An 8-hex RGBA colour, `#` already stripped — {@link splitRgbaHex}'s test. */
-const REGEX_ARGB_HEX = /^[0-9a-fA-F]{8}$/;
-/** Strip a single leading `#` from a colour, leaving any other character alone. */
-function stripHash(value) {
-	return value.startsWith("#") ? value.slice(1) : value;
-}
-/**
-* Is `value` a 6-hex RGB colour? A leading `#` is stripped first, so both spellings agree.
+* A namespace URI is a fact about the format, not about reading or writing one, so it belongs
+* here rather than on either side, by 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.
 *
-* This is the *shape* test only. Whether the caller may also name a scheme colour there is the
-* call site's question, and each still asks it: `createColorElement` falls back to the default
-* font colour, `makeXmlTheme` keeps the Office default and warns, `normalizeHex` throws.
-* @param value - the caller's colour, with or without a leading `#`
+* 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**, and no module beside it imports from `gen/` or `read/`, so both sides can
+* reach it and neither pays for the other's dependencies. The two that fail loudly reach outside
+* `ooxml/` for that alone: `sequence.ts` for `errors.ts`, and `check-enum.ts` for `errors.ts` and
+* `diagnostics.ts`. `read/oxml/dom.ts` re-exports it, so no read-side import path changed.
 */
-function isHexColor(value) {
-	return REGEX_HEX_COLOR.test(stripHash(value));
-}
+/** Canonical OOXML prefix → namespace URI registry. */
+const OOXML_NS = Object.freeze({
+	a: "http://schemas.openxmlformats.org/drawingml/2006/main",
+	a14: "http://schemas.microsoft.com/office/drawing/2010/main",
+	ahyp: "http://schemas.microsoft.com/office/drawing/2018/hyperlinkcolor",
+	asvg: "http://schemas.microsoft.com/office/drawing/2016/SVG/main",
+	c: "http://schemas.openxmlformats.org/drawingml/2006/chart",
+	c15: "http://schemas.microsoft.com/office/drawing/2012/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",
+	m: "http://schemas.openxmlformats.org/officeDocument/2006/math",
+	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",
+	p15: "http://schemas.microsoft.com/office/powerpoint/2012/main",
+	p159: "http://schemas.microsoft.com/office/powerpoint/2015/9/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",
+	vt: "http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes"
+});
 /**
-* Is `value` an 8-hex RGBA colour? A leading `#` is stripped first.
+* `a:graphicData/@uri` for a DrawingML table.
 *
-* The 8-digit form is RGB followed by one alpha byte; {@link splitRgbaHex} is what takes it apart.
-* @param value - the caller's colour, with or without a leading `#`
+* The other three payloads a `p:graphicFrame` can hold name a URI that is also a namespace, so
+* they read it off {@link OOXML_NS} (`c`, `cx`, `dgm`). A table's does not: nothing binds a
+* prefix to it, and the table elements themselves are in the `a` namespace. So it lives beside
+* the registry rather than in it, which keeps every entry there a prefix a document can declare.
 */
-function isArgbHex(value) {
-	return REGEX_ARGB_HEX.test(stripHash(value));
-}
+const TABLE_GRAPHIC_DATA_URI = "http://schemas.openxmlformats.org/drawingml/2006/table";
 /**
-* Split an 8-hex RGBA colour into its 6-hex RGB and a 0–1 alpha; anything else passes through
-* unchanged with no alpha.
+* The `xmlns` declarations every PresentationML part root carries, in the order the emitters
+* have always written them.
 *
-* `#` is stripped first, so both spellings reach the same answer. Two sites parsed this by
-* hand — `createColorElement`, which turns the alpha into an `<a:alpha>` sibling, and
-* `normalizeShadowOptions`, which turns it into a shadow's `_alpha` — and they divided by 255 at
-* different points in their arithmetic.
-* @param value - the caller's colour, with or without a leading `#`
+* 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.
 */
-function splitRgbaHex(value) {
-	const hex = stripHash(value);
-	if (!isArgbHex(hex)) return { rgb: hex };
-	return {
-		rgb: hex.slice(0, 6),
-		alpha: parseInt(hex.slice(6, 8), 16) / 255
-	};
-}
-//#endregion
-//#region src/ooxml/xsd-boolean.ts
+const PML_ROOT_NS = Object.freeze({
+	"xmlns:a": OOXML_NS.a,
+	"xmlns:r": OOXML_NS.r,
+	"xmlns:p": OOXML_NS.p
+});
+// src/ooxml/rel-types.ts
 /**
-* Parsing an `xsd:boolean` attribute value.
+* OPC relationship type URIs and part content types, and the schema-URI bases they are built from.
 *
-* **Why a function at all.** `xsd:boolean` has four lexical forms — `1`, `0`, `true`, `false` —
-* and OOXML attributes typed with it accept every one of them. PowerPoint writes only `1` and
-* `0`, so a hand-rolled `=== '1'` test passes against every deck this library produces and
-* against every deck PowerPoint produces, and silently misreads the other producers. That is the
-* worst shape a bug can have: invisible to the fixtures, visible only on a customer's file.
+* 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
+* nothing on the read side and produces a part PowerPoint ignores or rejects on the write side.
 *
-* **Why this module is neither `gen/` nor `read/`.** The lexical space of a schema type is a fact
-* about the schema, like `sequence.ts`'s document order and `body-insets.ts`'s defaults. The
-* parser lived in `read/oxml/dom.ts` because reading is where most of the demand is, and three
-* private copies had collapsed into it — but `read/oxml/dom.ts` imports `@xmldom/xmldom`, so
-* anything outside `read/` that wants this five-line function has to take a DOM dependency to get
-* it, or write a fourth copy. `script/from-read/detect.ts` hit exactly that and wrote the copy.
+* **Why this module is neither `gen/` nor `read/`.** Both halves need the same URIs, and for a
+* while each kept its own copy (`gen/oxml/schema-uris.ts`, `read/api/rel-types.ts`), with a note
+* in both saying a shared home was "a separate decision". It is this module: a rel type is a fact
+* about the OOXML package format, not about writing or reading one, so neither side should own it.
+* A divergence between the two copies would mean the writer emitting a rel the reader cannot find,
+* a round-trip bug with no compile-time signal.
 *
-* The DOM-typed convenience wrapper stays behind in `read/oxml/dom.ts` as `boolAttr`, because
-* *that* one really is about reading an element.
+* Only types used by more than one module live here. A rel type exactly one module cares about
+* (`tags`, `oleObject`, the modern comments part, …) 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. A writer and a reader of the same part count as two modules even when each
+* names the string once: that pair is exactly the divergence this module exists to prevent.
 *
-* **The write direction is here too**, and it is where the interesting distinction lives: an
-* emitter writing a boolean has THREE useful shapes, not one — see {@link xsdBool} and
-* {@link xsdBoolIfTrue}. Sixty-odd inline ternaries spelled them in three ways with nothing
-* naming which was which.
+* The same reasoning covers **part content types**, which are the same kind of fact and fail the
+* same silent way, including every entry the writer's `[Content_Types].xml` declares.
 */
 /**
-* Parse an `xsd:boolean` OOXML attribute (`1`/`0`/`true`/`false`); else `null`.
-*
-* `null` for an absent *or* unparseable value is deliberate and load-bearing at the call sites:
-* several attributes have a schema default of `true`, so they test `!== false` rather than
-* `=== true` and an unset attribute has to be distinguishable from an explicit `0`.
+* Prefix for `.rels` `Type` URIs; append the type name (`slide`, `image`, `theme`, …).
+* Exported for the write side, which builds one-off rel types at their call sites.
 */
-function boolValue(value) {
-	if (value === "1" || value === "true") return true;
-	if (value === "0" || value === "false") return false;
-	return null;
-}
+const OFFICE_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/";
+/** `xmlns` of every `<Relationships>` part. Also the prefix of the package-scoped rel types. */
+const PACKAGE_REL_NS = OOXML_NS.pr;
+/**
+* Prefix for the Microsoft rel types this library emits and reads. Exported for the same reason
+* as {@link OFFICE_REL}: a rel type only one module names is built from it at that module's call site.
+*/
+const MS_REL = "http://schemas.microsoft.com/office/";
+/** `p:sldIdLst` → a slide part. */
+const SLIDE_REL = OFFICE_REL + "slide";
+/** A slide → its layout; a master → each of its layouts. */
+const SLIDE_LAYOUT_REL = OFFICE_REL + "slideLayout";
+/** A layout → its master; the presentation → each master. */
+const SLIDE_MASTER_REL = OFFICE_REL + "slideMaster";
+/** A slide → its notes slide. */
+const NOTES_SLIDE_REL = OFFICE_REL + "notesSlide";
+/** A notes slide → the notes master; the presentation → the notes master. */
+const NOTES_MASTER_REL = OFFICE_REL + "notesMaster";
+/** A master or notes master → its theme. Layouts and slides inherit it rather than holding one. */
+const THEME_REL = OFFICE_REL + "theme";
+/** The package root → `ppt/presentation.xml`. The entry point to everything above. */
+const OFFICE_DOCUMENT_REL = OFFICE_REL + "officeDocument";
+/** Any part → an image in `ppt/media/`. */
+const IMAGE_REL = OFFICE_REL + "image";
+/** Any part → an external or internal jump target. External ones carry `TargetMode="External"`. */
+const HYPERLINK_REL = OFFICE_REL + "hyperlink";
+/** The presentation → `ppt/tableStyles.xml`. */
+const TABLE_STYLES_REL = OFFICE_REL + "tableStyles";
+/** The package root → `docProps/core.xml`. Package-scoped, so not under {@link OFFICE_REL}. */
+const CORE_PROPS_REL = PACKAGE_REL_NS + "/metadata/core-properties";
+/** The package root → `docProps/app.xml`. */
+const EXTENDED_PROPS_REL = OFFICE_REL + "extended-properties";
+/** The package root → `docProps/custom.xml`. */
+const CUSTOM_PROPS_REL = OFFICE_REL + "custom-properties";
+/** A slide → its legacy comments part (`ppt/comments/commentN.xml`). */
+const COMMENTS_REL = OFFICE_REL + "comments";
+/** The presentation → the deck-wide legacy comment-author registry (`ppt/commentAuthors.xml`). */
+const COMMENT_AUTHORS_REL = OFFICE_REL + "commentAuthors";
+/** The presentation → the 2018 comment-author registry (`ppt/authors.xml`), a Microsoft rel type. */
+const MODERN_COMMENT_AUTHORS_REL = MS_REL + "2018/10/relationships/authors";
+/** The presentation → `ppt/presProps.xml`. */
+const PRES_PROPS_REL = OFFICE_REL + "presProps";
+/** The presentation → `ppt/viewProps.xml`. */
+const VIEW_PROPS_REL = OFFICE_REL + "viewProps";
+/** The presentation → the handout master. */
+const HANDOUT_MASTER_REL = OFFICE_REL + "handoutMaster";
+/** A part → a theme override, which replaces the deck theme for that part alone. */
+const THEME_OVERRIDE_REL = OFFICE_REL + "themeOverride";
+/** The presentation → an embedded font part, one per face. */
+const FONT_REL = OFFICE_REL + "font";
+/** A slide → an audio blob in `ppt/media/`. Paired with {@link MS_MEDIA_REL} on the same target. */
+const AUDIO_REL = OFFICE_REL + "audio";
+/** A slide → a video blob in `ppt/media/`, or an online-video placeholder. Paired with {@link MS_MEDIA_REL}. */
+const VIDEO_REL = OFFICE_REL + "video";
 /**
-* A boolean as the `1`/`0` an `xsd:boolean` attribute takes.
-*
-* Writes the attribute either way, so `false` is *stated*. Use this wherever the schema
-* default is `true`, or wherever the absence of the attribute would mean something other
-* than `false` — a value inherited from a list style, a layout or the theme.
-* @param value - the resolved boolean
+* The MS-2007 `media` rel every audio/video shape carries alongside the ECMA one, pointing at the
+* same target. It is what `<p14:media r:embed>` resolves, so a media shape needs both.
 */
-function xsdBool(value) {
-	return value ? "1" : "0";
-}
+const MS_MEDIA_REL = MS_REL + "2007/relationships/media";
+/** A slide → an embedded 3D model (`.glb`). Note `2017/06`, not the `2017` of the model3d namespace. */
+const MODEL3D_REL = MS_REL + "2017/06/relationships/model3d";
+/** A slide → a classic (`c:`) chart part. */
+const CHART_REL = OFFICE_REL + "chart";
+/** A slide → a chartEx (`cx:`, Office 2016) chart part: an MS rel, not the ECMA `chart` one. */
+const CHARTEX_REL = MS_REL + "2014/relationships/chartEx";
+/** A chart part → its mandatory style sidecar. */
+const CHART_STYLE_REL = MS_REL + "2011/relationships/chartStyle";
+/** A chart part → its mandatory colour-style sidecar. */
+const CHART_COLOR_STYLE_REL = MS_REL + "2011/relationships/chartColorStyle";
+/** Any part → an embedded OPC package (an Office file, itself a zip): a chart's workbook, an OLE payload. */
+const PACKAGE_REL = OFFICE_REL + "package";
 /**
-* A boolean as `1`, or `null` so the attribute is left out entirely.
-*
-* **Correct only where the schema default is `false`.** It collapses "false" and "unset" into
-* one output, which is the two-spellings-for-three-states shape the API policy warns about: the
-* next attribute with a `true` default written this way reads as correct and is wrong. Every
-* current caller is on a `false`-defaulting attribute, so the collapse costs nothing today —
-* naming it is what makes the next one visible.
-* @param value - the resolved boolean
+* Root of the ECMA-376 content types. Exported for a content type only one module names, which is
+* built from it at that module's call site; a shared one is a constant below.
 */
-function xsdBoolIfTrue(value) {
-	return value ? "1" : null;
-}
-//#endregion
-//#region src/ooxml/check-enum.ts
+const OD_CONTENT = "application/vnd.openxmlformats-officedocument.";
+/** Root of the OPC package-level content types. Private: callers want one of the constants below. */
+const PACKAGE_CONTENT = "application/vnd.openxmlformats-package.";
+/** Root of the Microsoft Office content types the chartEx family uses. Private. */
+const MS_OFFICE_CONTENT = "application/vnd.ms-office.";
+/** Root of the PowerPoint-specific Microsoft content types. Exported for the same reason as {@link OD_CONTENT}. */
+const MS_POWERPOINT_CONTENT = "application/vnd.ms-powerpoint.";
+/** `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";
+/** `ppt/tableStyles.xml`. */
+const TABLE_STYLES_CONTENT_TYPE = OD_CONTENT + "presentationml.tableStyles+xml";
+/** `ppt/presentation.xml` in an editable `.pptx`. A `.potx` template's main part is a different one. */
+const PRESENTATION_MAIN_CONTENT_TYPE = OD_CONTENT + "presentationml.presentation.main+xml";
+/** Every `.rels` part. Declared once as a `Default` for the `rels` extension, never as an Override. */
+const RELATIONSHIPS_CONTENT_TYPE = PACKAGE_CONTENT + "relationships+xml";
+/** `ppt/presProps.xml`. */
+const PRES_PROPS_CONTENT_TYPE = OD_CONTENT + "presentationml.presProps+xml";
+/** `ppt/viewProps.xml`. */
+const VIEW_PROPS_CONTENT_TYPE = OD_CONTENT + "presentationml.viewProps+xml";
+/** `ppt/comments/commentN.xml`, a legacy comments part. */
+const COMMENTS_CONTENT_TYPE = OD_CONTENT + "presentationml.comments+xml";
+/** `ppt/commentAuthors.xml`. */
+const COMMENT_AUTHORS_CONTENT_TYPE = OD_CONTENT + "presentationml.commentAuthors+xml";
+/** `docProps/core.xml`. Package-scoped, so not under the officedocument prefix. */
+const CORE_PROPS_CONTENT_TYPE = PACKAGE_CONTENT + "core-properties+xml";
+/** `docProps/app.xml`. */
+const EXTENDED_PROPS_CONTENT_TYPE = OD_CONTENT + "extended-properties+xml";
+/** `docProps/custom.xml`. */
+const CUSTOM_PROPS_CONTENT_TYPE = OD_CONTENT + "custom-properties+xml";
+/** `ppt/charts/chartN.xml`, a classic (`c:`) chart. */
+const CHART_CONTENT_TYPE = OD_CONTENT + "drawingml.chart+xml";
+/** `ppt/charts/chartExN.xml`. A chartEx part carries a Microsoft content type, not an `openxmlformats` one. */
+const CHARTEX_CONTENT_TYPE = MS_OFFICE_CONTENT + "chartex+xml";
+/** A chart's mandatory `style{N}.xml` sidecar. */
+const CHART_STYLE_CONTENT_TYPE = MS_OFFICE_CONTENT + "chartstyle+xml";
+/** A chart's mandatory `colors{N}.xml` sidecar. */
+const CHART_COLOR_STYLE_CONTENT_TYPE = MS_OFFICE_CONTENT + "chartcolorstyle+xml";
+/** An embedded `.xlsx` workbook: a chart's data, or an OLE payload. */
+const XLSX_CONTENT_TYPE = OD_CONTENT + "spreadsheetml.sheet";
 /**
-* 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.
+* Every kind of part a page points at without owning it.
 *
-* 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
+* Two questions read this table, under different keys. Copying a page asks whether a relationship's
+* target may be shared by the copies rather than copied (every row, by `relType`). Pruning after a
+* slide is removed asks whether a part is deck chrome that stays even while nothing reaches it (the
+* `deck` rows, by `contentType`). They were two hand-kept lists, and the two author registries were
+* on the first and missing from the second.
 */
-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/line-cap.ts
+const SHARED_PARTS = [
+	{
+		relType: SLIDE_LAYOUT_REL,
+		contentType: SLIDE_LAYOUT_CONTENT_TYPE,
+		scope: "deck"
+	},
+	{
+		relType: SLIDE_MASTER_REL,
+		contentType: SLIDE_MASTER_CONTENT_TYPE,
+		scope: "deck"
+	},
+	{
+		relType: NOTES_MASTER_REL,
+		contentType: NOTES_MASTER_CONTENT_TYPE,
+		scope: "deck"
+	},
+	{
+		relType: THEME_REL,
+		contentType: THEME_CONTENT_TYPE,
+		scope: "deck"
+	},
+	{
+		relType: THEME_OVERRIDE_REL,
+		contentType: OD_CONTENT + "themeOverride+xml",
+		scope: "deck"
+	},
+	{
+		relType: HANDOUT_MASTER_REL,
+		contentType: OD_CONTENT + "presentationml.handoutMaster+xml",
+		scope: "deck"
+	},
+	{
+		relType: PRES_PROPS_REL,
+		contentType: PRES_PROPS_CONTENT_TYPE,
+		scope: "deck"
+	},
+	{
+		relType: VIEW_PROPS_REL,
+		contentType: VIEW_PROPS_CONTENT_TYPE,
+		scope: "deck"
+	},
+	{
+		relType: TABLE_STYLES_REL,
+		contentType: TABLE_STYLES_CONTENT_TYPE,
+		scope: "deck"
+	},
+	{
+		relType: OFFICE_DOCUMENT_REL,
+		contentType: PRESENTATION_MAIN_CONTENT_TYPE,
+		scope: "deck"
+	},
+	{
+		relType: COMMENT_AUTHORS_REL,
+		contentType: COMMENT_AUTHORS_CONTENT_TYPE,
+		scope: "deck"
+	},
+	{
+		relType: MODERN_COMMENT_AUTHORS_REL,
+		contentType: "application/vnd.ms-powerpoint.authors+xml",
+		scope: "deck"
+	},
+	{
+		relType: IMAGE_REL,
+		contentType: null,
+		scope: "media"
+	},
+	{
+		relType: AUDIO_REL,
+		contentType: null,
+		scope: "media"
+	},
+	{
+		relType: VIDEO_REL,
+		contentType: null,
+		scope: "media"
+	},
+	{
+		relType: MS_MEDIA_REL,
+		contentType: null,
+		scope: "media"
+	},
+	{
+		relType: MODEL3D_REL,
+		contentType: null,
+		scope: "media"
+	},
+	{
+		relType: FONT_REL,
+		contentType: null,
+		scope: "media"
+	},
+	{
+		relType: SLIDE_REL,
+		contentType: null,
+		scope: "page"
+	},
+	{
+		relType: HYPERLINK_REL,
+		contentType: null,
+		scope: "page"
+	}
+];
+// src/ooxml/line-cap.ts
 /**
 * Every `cap` the write API names and the token it writes. `satisfies` over `Record<LineCap, …>`
 * makes a member added to `LineCap` without a token a compile error, and `ST_LineCap` has exactly
@@ -1347,8 +1422,16 @@ function lineCapToken(cap) {
 }
 /** A `cap` token back to the `LineCap` that authors it. */
 const LINE_CAP_BY_TOKEN = Object.fromEntries(Object.entries(TOKEN_BY_LINE_CAP).map(([cap, token]) => [token, cap]));
-//#endregion
-//#region src/ooxml/text-align.ts
+// src/ooxml/show-jumps.ts
+const SHOW_JUMPS = [
+	"firstslide",
+	"previousslide",
+	"nextslide",
+	"lastslide",
+	"lastslideviewed",
+	"endshow"
+];
+// src/ooxml/text-align.ts
 /**
 * Every `align` the write API names and the token it writes. `satisfies` over `Record<HAlign, …>`
 * makes a member added to `HAlign` without a token a compile error. `justLow`, `dist` and
@@ -1366,21 +1449,20 @@ function textAlignToken(align) {
 }
 /** An `algn` token back to the `align` a generated script writes. */
 const HALIGN_BY_TEXT_ALIGN = Object.fromEntries(Object.entries(ALGN_BY_ALIGN).map(([align, token]) => [token, align]));
-//#endregion
-//#region src/media/image-size.ts
+// src/media/image-size.ts
 /**
 * Intrinsic image geometry: reading a natural pixel size out of header bytes, and the
 * `<a:srcRect>` crop math that fits that natural size into a display box.
 *
-* Shared by both sides of the library — the write path (`addImage({ sizing })`) and the read
-* API's `Picture.setImage({ fit })` — which is why it lives outside `gen/` and `read/`.
+* Shared by both sides of the library, the write path (`addImage({ sizing })`) and the read
+* API's `Picture.setImage({ fit })`, which is why it lives outside `gen/` and `read/`.
 * Everything here is synchronous and pure: headers only, never pixel decoding.
 */
 /**
 * Read the intrinsic dimensions of an image from its header bytes.
 * - synchronous: parses only file-format headers, never decodes pixels
-* - raster: PNG, JPEG, GIF, BMP, TIFF, and WebP (VP8 / VP8L / VP8X) — natural pixels
-* - vector: SVG — intrinsic size from the root `<svg>` width/height or viewBox
+* - raster: PNG, JPEG, GIF, BMP, TIFF, and WebP (VP8 / VP8L / VP8X): natural pixels
+* - vector: SVG, with the intrinsic size from the root `<svg>` width/height or viewBox
 * - unrecognized formats return `null` (no measurable intrinsic size)
 *
 * Used by image `sizing: 'cover' | 'contain'` to compute an aspect-correct
@@ -1393,7 +1475,7 @@ function getImageSizeFromBase64(dataB64) {
 	return b ? getImageSizeFromBytes(b) : null;
 }
 /**
-* Read the intrinsic dimensions of an image from raw header bytes — the
+* Read the intrinsic dimensions of an image from raw header bytes: the
 * byte-level core shared by {@link getImageSizeFromBase64} and the read API's
 * `Picture.setImage({ fit })`, which already holds the media bytes.
 * @param {Uint8Array} b - image bytes
@@ -1402,7 +1484,7 @@ function getImageSizeFromBase64(dataB64) {
 function getImageSizeFromBytes(b) {
 	if (!b || b.length < 24) return null;
 	const u = (n) => b[n] ?? 0;
-	if (IMAGE_FORMATS.png.magic?.(b)) {
+	if (IMAGE_FORMATS.png.magic(b)) {
 		const w = u(16) << 24 | u(17) << 16 | u(18) << 8 | u(19);
 		const h = u(20) << 24 | u(21) << 16 | u(22) << 8 | u(23);
 		return w > 0 && h > 0 ? {
@@ -1410,7 +1492,7 @@ function getImageSizeFromBytes(b) {
 			h
 		} : null;
 	}
-	if (IMAGE_FORMATS.gif.magic?.(b)) {
+	if (IMAGE_FORMATS.gif.magic(b)) {
 		const w = u(6) | u(7) << 8;
 		const h = u(8) | u(9) << 8;
 		return w > 0 && h > 0 ? {
@@ -1418,7 +1500,7 @@ function getImageSizeFromBytes(b) {
 			h
 		} : null;
 	}
-	if (IMAGE_FORMATS.bmp.magic?.(b)) {
+	if (IMAGE_FORMATS.bmp.magic(b)) {
 		if ((u(14) | u(15) << 8 | u(16) << 16 | u(17) << 24) === 12) {
 			const w = u(18) | u(19) << 8;
 			const h = u(20) | u(21) << 8;
@@ -1437,7 +1519,7 @@ function getImageSizeFromBytes(b) {
 			h: ah
 		} : null;
 	}
-	if (IMAGE_FORMATS.webp.magic?.(b)) {
+	if (IMAGE_FORMATS.webp.magic(b)) {
 		const fourCC = String.fromCharCode(u(12), u(13), u(14), u(15));
 		if (fourCC === "VP8 " && b.length >= 30) {
 			const w = (u(26) | u(27) << 8) & 16383;
@@ -1466,7 +1548,7 @@ function getImageSizeFromBytes(b) {
 		}
 		return null;
 	}
-	if (IMAGE_FORMATS.jpeg.magic?.(b)) {
+	if (IMAGE_FORMATS.jpeg.magic(b)) {
 		let i = 2;
 		while (i + 9 < b.length) {
 			if (b[i] !== 255) {
@@ -1605,7 +1687,22 @@ function getSvgSizeFromMarkup(svg) {
 function utf8Decode(bytes) {
 	return new TextDecoder().decode(bytes);
 }
-//#endregion
-export { TICK_MARKS as $, THEME_REL as $t, GROUPINGS as A, NOTES_MASTER_CONTENT_TYPE as At, RADAR_STYLE_ALIAS_NAMES as B, PRES_PROPS_CONTENT_TYPE as Bt, CROSS_BETWEEN as C, HYPERLINK_REL as Ct, ERROR_BAR_DIRECTIONS as D, MS_MEDIA_REL as Dt, EMBEDDED_FONT_SLOTS as E, MODERN_COMMENT_AUTHORS_REL as Et, LINE_END_TYPES as F, OFFICE_DOCUMENT_REL as Ft, TEXT_HORZ_OVERFLOW as G, SLIDE_LAYOUT_CONTENT_TYPE as Gt, TEXT_ANCHORS as H, RELATIONSHIPS_CONTENT_TYPE as Ht, PRESET_LINE_DASHES as I, OFFICE_REL as It, TEXT_TAB_ALIGN_TYPES as J, SLIDE_MASTER_REL as Jt, TEXT_SHAPE_TYPES as K, SLIDE_LAYOUT_REL as Kt, PRESET_MATERIALS as L, PACKAGE_REL as Lt, LIGHT_RIGS as M, NOTES_SLIDE_CONTENT_TYPE as Mt, LIGHT_RIG_DIRECTIONS as N, NOTES_SLIDE_REL as Nt, ERROR_BAR_TYPES as O, MS_POWERPOINT_CONTENT as Ot, LINE_DATA_SYMBOLS as P, OD_CONTENT as Pt, TICK_LABEL_POSITIONS as Q, THEME_CONTENT_TYPE as Qt, RADAR_STYLES as R, PACKAGE_REL_NS as Rt, COLOR_MAP_TOKENS as S, FONT_REL as St, DISPLAY_BLANKS_AS as T, MODEL3D_REL as Tt, TEXT_AUTONUM_SCHEMES as U, SHARED_PARTS as Ut, SCHEME_COLOR_VALUES as V, PRES_PROPS_REL as Vt, TEXT_CAPS_TYPES as W, SLIDE_CONTENT_TYPE as Wt, TEXT_VERTICAL as X, TABLE_STYLES_CONTENT_TYPE as Xt, TEXT_UNDERLINE_TYPES as Y, SLIDE_REL as Yt, THEME_COLOR_SLOTS as Z, TABLE_STYLES_REL as Zt, BAR_3D_SHAPES as _, CORE_PROPS_REL as _t, textAlignToken as a, PML_ROOT_NS as an, CHARTEX_REL as at, BEVEL_PRESETS as b, EXTENDED_PROPS_CONTENT_TYPE as bt, checkEnumOrThrow as c, decodeBase64ToBytes as cn, CHART_CONTENT_TYPE as ct, xsdBool as d, toMediaDataUri as dn, CHART_STYLE_REL as dt, VIDEO_REL as en, TIME_UNITS as et, xsdBoolIfTrue as f, imageFormatForBytes as fn, COMMENTS_CONTENT_TYPE as ft, AXIS_ORIENTATIONS as g, CORE_PROPS_CONTENT_TYPE as gt, stripHash as h, COMMENT_AUTHORS_REL as ht, HALIGN_BY_TEXT_ALIGN as i, OOXML_NS as in, CHARTEX_CONTENT_TYPE as it, LEGEND_POSITIONS as j, NOTES_MASTER_REL as jt, ERROR_BAR_VALUE_TYPES as k, MS_REL as kt, checkEnumOrWarn as l, hasBase64Header as ln, CHART_REL as lt, splitRgbaHex as m, imageFormatForExtension as mn, COMMENT_AUTHORS_CONTENT_TYPE as mt, getImageSizeFromBase64 as n, VIEW_PROPS_REL as nn, TRANSITION_VARIANT_ATTRIBUTES as nt, LINE_CAP_BY_TOKEN as o, TABLE_GRAPHIC_DATA_URI as on, CHART_COLOR_STYLE_CONTENT_TYPE as ot, isHexColor as p, imageFormatForContentType as pn, COMMENTS_REL as pt, TEXT_STRIKE_TYPES as q, SLIDE_MASTER_CONTENT_TYPE as qt, getImageSizeFromBytes as r, XLSX_CONTENT_TYPE as rn, AUDIO_REL as rt, lineCapToken as s, bytesToBase64 as sn, CHART_COLOR_STYLE_REL as st, fitSrcRectPercents as t, VIEW_PROPS_CONTENT_TYPE as tn, TRANSITION_TYPES as tt, boolValue as u, svgMarkupToDataUri as un, CHART_STYLE_CONTENT_TYPE as ut, BAR_DIRECTIONS as v, CUSTOM_PROPS_CONTENT_TYPE as vt, DEFAULT_COLOR_MAP as w, IMAGE_REL as wt, BUILT_IN_UNITS as x, EXTENDED_PROPS_REL as xt, BAR_GROUPINGS as y, CUSTOM_PROPS_REL as yt, RADAR_STYLE_ALIASES as z, PRESENTATION_MAIN_CONTENT_TYPE as zt };
+// src/ooxml/chart-metadata.ts
+/**
+* The pptx-ts chart-metadata extension on `c:chartSpace/c:extLst`: the `c:ext/@uri` it is filed
+* under and the namespace of its payload.
+*
+* Here because both sides spell them: the writer stamps them from `addChart`'s `metadata`, and
+* `Chart.metadata` finds the extension by them. No runtime imports.
+*/
+/**
+* Stable pptx-ts vendor GUID identifying the chart-metadata extension. Custom data rides under
+* this URI in a foreign namespace so PowerPoint preserves it (the extLst mechanism) instead of
+* stripping or repairing it as it would an unrecognised sibling element.
+*/
+const CHART_METADATA_EXT_URI = "{094A432E-1F6C-499B-95B8-B57DC9536949}";
+/** Foreign namespace for the chart-metadata extension payload. */
+const CHART_METADATA_NS = "http://ts-pptx.com/schema/chart/metadata";
+export { SLIDE_LAYOUT_CONTENT_TYPE as $, TICK_LABEL_POSITIONS as $t, FONT_REL as A, LEGEND_POSITIONS as At, NOTES_SLIDE_CONTENT_TYPE as B, RADAR_STYLE_ALIASES as Bt, COMMENT_AUTHORS_REL as C, DEFAULT_COLOR_MAP as Ct, CUSTOM_PROPS_REL as D, ERROR_BAR_TYPES as Dt, CUSTOM_PROPS_CONTENT_TYPE as E, ERROR_BAR_DIRECTIONS as Et, MS_MEDIA_REL as F, PATTERN_PRESETS as Ft, PACKAGE_REL as G, TEXT_CAPS_TYPES as Gt, OD_CONTENT as H, SCHEME_COLOR_VALUES as Ht, MS_POWERPOINT_CONTENT as I, PLACEHOLDER_TYPES as It, PRES_PROPS_CONTENT_TYPE as J, TEXT_STRIKE_TYPES as Jt, PACKAGE_REL_NS as K, TEXT_HORZ_OVERFLOW as Kt, MS_REL as L, PRESET_LINE_DASHES as Lt, IMAGE_REL as M, LIGHT_RIG_DIRECTIONS as Mt, MODEL3D_REL as N, LINE_DATA_SYMBOLS as Nt, EXTENDED_PROPS_CONTENT_TYPE as O, ERROR_BAR_VALUE_TYPES as Ot, MODERN_COMMENT_AUTHORS_REL as P, LINE_END_TYPES as Pt, SLIDE_CONTENT_TYPE as Q, THEME_COLOR_SLOTS as Qt, NOTES_MASTER_CONTENT_TYPE as R, PRESET_MATERIALS as Rt, COMMENT_AUTHORS_CONTENT_TYPE as S, CROSS_BETWEEN as St, CORE_PROPS_REL as T, EMBEDDED_FONT_SLOTS as Tt, OFFICE_DOCUMENT_REL as U, TEXT_ANCHORS as Ut, NOTES_SLIDE_REL as V, RADAR_STYLE_ALIAS_NAMES as Vt, OFFICE_REL as W, TEXT_AUTONUM_SCHEMES as Wt, RELATIONSHIPS_CONTENT_TYPE as X, TEXT_UNDERLINE_TYPES as Xt, PRES_PROPS_REL as Y, TEXT_TAB_ALIGN_TYPES as Yt, SHARED_PARTS as Z, TEXT_VERTICAL as Zt, CHART_REL as _, imageFormatForBytes as _n, BAR_DIRECTIONS as _t, getImageSizeFromBytes as a, checkEnumOrWarn as an, TABLE_STYLES_REL as at, COMMENTS_CONTENT_TYPE as b, BUILT_IN_UNITS as bt, SHOW_JUMPS as c, xsdBoolIfTrue as cn, VIDEO_REL as ct, AUDIO_REL as d, stripHash as dn, XLSX_CONTENT_TYPE as dt, TICK_MARKS as en, SLIDE_LAYOUT_REL as et, CHARTEX_CONTENT_TYPE as f, bytesToBase64 as fn, OOXML_NS as ft, CHART_CONTENT_TYPE as g, toMediaDataUri as gn, BAR_3D_SHAPES as gt, CHART_COLOR_STYLE_REL as h, svgMarkupToDataUri as hn, AXIS_ORIENTATIONS as ht, getImageSizeFromBase64 as i, checkEnumOrThrow as in, TABLE_STYLES_CONTENT_TYPE as it, HYPERLINK_REL as j, LIGHT_RIGS as jt, EXTENDED_PROPS_REL as k, GROUPINGS as kt, LINE_CAP_BY_TOKEN as l, isHexColor as ln, VIEW_PROPS_CONTENT_TYPE as lt, CHART_COLOR_STYLE_CONTENT_TYPE as m, hasBase64Header as mn, TABLE_GRAPHIC_DATA_URI as mt, CHART_METADATA_NS as n, TRANSITION_TYPES as nn, SLIDE_MASTER_REL as nt, HALIGN_BY_TEXT_ALIGN as o, boolValue as on, THEME_CONTENT_TYPE as ot, CHARTEX_REL as p, decodeBase64ToBytes as pn, PML_ROOT_NS as pt, PRESENTATION_MAIN_CONTENT_TYPE as q, TEXT_SHAPE_TYPES as qt, fitSrcRectPercents as r, TRANSITION_VARIANT_ATTRIBUTES as rn, SLIDE_REL as rt, textAlignToken as s, xsdBool as sn, THEME_REL as st, CHART_METADATA_EXT_URI as t, TIME_UNITS as tn, SLIDE_MASTER_CONTENT_TYPE as tt, lineCapToken as u, splitRgbaHex as un, VIEW_PROPS_REL as ut, CHART_STYLE_CONTENT_TYPE as v, imageFormatForContentType as vn, BAR_GROUPINGS as vt, CORE_PROPS_CONTENT_TYPE as w, DISPLAY_BLANKS_AS as wt, COMMENTS_REL as x, COLOR_MAP_TOKENS as xt, CHART_STYLE_REL as y, imageFormatForExtension as yn, BEVEL_PRESETS as yt, NOTES_MASTER_REL as z, RADAR_STYLES as zt };
 
-//# sourceMappingURL=image-size-CvN2iCA4.js.map
+//# sourceMappingURL=chart-metadata-CwiTTcJq.js.map