ooxml-core 0.2.0

package/dist/units/constants.d.ts

@@ -0,0 +1,13 @@
+/** English Metric Units per CSS pixel at 96 dpi. */
+export declare const EMU_PER_PIXEL = 9525;
+/** English Metric Units per point (1/72 inch). */
+export declare const EMU_PER_POINT = 12700;
+/** English Metric Units per inch. */
+export declare const EMU_PER_INCH = 914400;
+/** Twips per point (a twip is a twentieth of a point). */
+export declare const TWIPS_PER_POINT = 20;
+/** Twips per inch. */
+export declare const TWIPS_PER_INCH = 1440;
+/** CSS pixels per inch the viewers assume. */
+export declare const PIXELS_PER_INCH = 96;
+//# sourceMappingURL=constants.d.ts.map

package/dist/units/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/units/constants.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,kDAAkD;AAClD,eAAO,MAAM,aAAa,QAAQ,CAAC;AACnC,qCAAqC;AACrC,eAAO,MAAM,YAAY,SAAS,CAAC;AACnC,0DAA0D;AAC1D,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,sBAAsB;AACtB,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,8CAA8C;AAC9C,eAAO,MAAM,eAAe,KAAK,CAAC"}

package/dist/units/index.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+// src/units/units.ts
+function integer(unit, value, allowNegative = true) {
+  if (!Number.isSafeInteger(value)) throw new RangeError(`${unit} must be a safe integer`);
+  if (!allowNegative && value < 0) throw new RangeError(`${unit} must not be negative`);
+  return value;
+}
+function finite(unit, value) {
+  if (!Number.isFinite(value)) throw new RangeError(`${unit} must be finite`);
+  return value;
+}
+var roundAway = (unit, value) => Math.sign(finite(unit, value)) * Math.round(Math.abs(value)) || 0;
+var twips = (value) => integer("twips", value, false);
+var signedTwips = (value) => integer("twips", value);
+var halfPoints = (value) => integer("halfPoints", value);
+var eighthPoints = (value) => integer("eighthPoints", value);
+var emu = (value) => integer("emu", value);
+var roundTwips = (value) => integer("twips", Math.max(0, roundAway("twips", value)));
+var roundSignedTwips = (value) => integer("twips", roundAway("twips", value));
+var roundHalfPoints = (value) => integer("halfPoints", roundAway("halfPoints", value));
+var roundEighthPoints = (value) => integer("eighthPoints", Math.max(0, roundAway("eighthPoints", value)));
+var roundEmu = (value) => integer("emu", roundAway("emu", value));
+var twipsFromPoints = (points) => roundTwips(points * 20);
+var signedTwipsFromPoints = (points) => roundSignedTwips(points * 20);
+var twipsFromPixels = (pixels) => roundTwips(pixels * 15);
+var signedTwipsFromPixels = (pixels) => roundSignedTwips(pixels * 15);
+var twipsFromInches = (inches) => roundTwips(inches * 1440);
+var halfPointsFromPoints = (points) => roundHalfPoints(points * 2);
+var eighthPointsFromPoints = (points) => roundEighthPoints(points * 8);
+var emuFromPixels = (pixels) => roundEmu(pixels * 9525);
+var twipsToPoints = (value) => value / 20;
+var twipsToPixels = (value) => value / 15;
+var twipsToInches = (value) => value / 1440;
+var halfPointsToPoints = (value) => value / 2;
+var eighthPointsToPoints = (value) => value / 8;
+var emuToPixels = (value) => value / 9525;
+
+// src/units/constants.ts
+var EMU_PER_PIXEL = 9525;
+var EMU_PER_POINT = 12700;
+var EMU_PER_INCH = 914400;
+var TWIPS_PER_POINT = 20;
+var TWIPS_PER_INCH = 1440;
+var PIXELS_PER_INCH = 96;
+
+exports.EMU_PER_INCH = EMU_PER_INCH;
+exports.EMU_PER_PIXEL = EMU_PER_PIXEL;
+exports.EMU_PER_POINT = EMU_PER_POINT;
+exports.PIXELS_PER_INCH = PIXELS_PER_INCH;
+exports.TWIPS_PER_INCH = TWIPS_PER_INCH;
+exports.TWIPS_PER_POINT = TWIPS_PER_POINT;
+exports.eighthPoints = eighthPoints;
+exports.eighthPointsFromPoints = eighthPointsFromPoints;
+exports.eighthPointsToPoints = eighthPointsToPoints;
+exports.emu = emu;
+exports.emuFromPixels = emuFromPixels;
+exports.emuToPixels = emuToPixels;
+exports.halfPoints = halfPoints;
+exports.halfPointsFromPoints = halfPointsFromPoints;
+exports.halfPointsToPoints = halfPointsToPoints;
+exports.roundEighthPoints = roundEighthPoints;
+exports.roundEmu = roundEmu;
+exports.roundHalfPoints = roundHalfPoints;
+exports.roundSignedTwips = roundSignedTwips;
+exports.roundTwips = roundTwips;
+exports.signedTwips = signedTwips;
+exports.signedTwipsFromPixels = signedTwipsFromPixels;
+exports.signedTwipsFromPoints = signedTwipsFromPoints;
+exports.twips = twips;
+exports.twipsFromInches = twipsFromInches;
+exports.twipsFromPixels = twipsFromPixels;
+exports.twipsFromPoints = twipsFromPoints;
+exports.twipsToInches = twipsToInches;
+exports.twipsToPixels = twipsToPixels;
+exports.twipsToPoints = twipsToPoints;

package/dist/units/index.d.ts

@@ -0,0 +1,3 @@
+export * from './units.js';
+export * from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/units/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/units/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/units/index.mjs

@@ -0,0 +1,45 @@
+// src/units/units.ts
+function integer(unit, value, allowNegative = true) {
+  if (!Number.isSafeInteger(value)) throw new RangeError(`${unit} must be a safe integer`);
+  if (!allowNegative && value < 0) throw new RangeError(`${unit} must not be negative`);
+  return value;
+}
+function finite(unit, value) {
+  if (!Number.isFinite(value)) throw new RangeError(`${unit} must be finite`);
+  return value;
+}
+var roundAway = (unit, value) => Math.sign(finite(unit, value)) * Math.round(Math.abs(value)) || 0;
+var twips = (value) => integer("twips", value, false);
+var signedTwips = (value) => integer("twips", value);
+var halfPoints = (value) => integer("halfPoints", value);
+var eighthPoints = (value) => integer("eighthPoints", value);
+var emu = (value) => integer("emu", value);
+var roundTwips = (value) => integer("twips", Math.max(0, roundAway("twips", value)));
+var roundSignedTwips = (value) => integer("twips", roundAway("twips", value));
+var roundHalfPoints = (value) => integer("halfPoints", roundAway("halfPoints", value));
+var roundEighthPoints = (value) => integer("eighthPoints", Math.max(0, roundAway("eighthPoints", value)));
+var roundEmu = (value) => integer("emu", roundAway("emu", value));
+var twipsFromPoints = (points) => roundTwips(points * 20);
+var signedTwipsFromPoints = (points) => roundSignedTwips(points * 20);
+var twipsFromPixels = (pixels) => roundTwips(pixels * 15);
+var signedTwipsFromPixels = (pixels) => roundSignedTwips(pixels * 15);
+var twipsFromInches = (inches) => roundTwips(inches * 1440);
+var halfPointsFromPoints = (points) => roundHalfPoints(points * 2);
+var eighthPointsFromPoints = (points) => roundEighthPoints(points * 8);
+var emuFromPixels = (pixels) => roundEmu(pixels * 9525);
+var twipsToPoints = (value) => value / 20;
+var twipsToPixels = (value) => value / 15;
+var twipsToInches = (value) => value / 1440;
+var halfPointsToPoints = (value) => value / 2;
+var eighthPointsToPoints = (value) => value / 8;
+var emuToPixels = (value) => value / 9525;
+
+// src/units/constants.ts
+var EMU_PER_PIXEL = 9525;
+var EMU_PER_POINT = 12700;
+var EMU_PER_INCH = 914400;
+var TWIPS_PER_POINT = 20;
+var TWIPS_PER_INCH = 1440;
+var PIXELS_PER_INCH = 96;
+
+export { EMU_PER_INCH, EMU_PER_PIXEL, EMU_PER_POINT, PIXELS_PER_INCH, TWIPS_PER_INCH, TWIPS_PER_POINT, eighthPoints, eighthPointsFromPoints, eighthPointsToPoints, emu, emuFromPixels, emuToPixels, halfPoints, halfPointsFromPoints, halfPointsToPoints, roundEighthPoints, roundEmu, roundHalfPoints, roundSignedTwips, roundTwips, signedTwips, signedTwipsFromPixels, signedTwipsFromPoints, twips, twipsFromInches, twipsFromPixels, twipsFromPoints, twipsToInches, twipsToPixels, twipsToPoints };

package/dist/units/units.d.ts

@@ -0,0 +1,52 @@
+declare const unitBrand: unique symbol;
+declare const nonNegativeBrand: unique symbol;
+type Branded<Name extends string> = number & {
+    readonly [unitBrand]: Name;
+};
+/** Twentieths of a point (1/1440 inch), possibly negative: `ST_SignedTwipsMeasure`. */
+export type SignedTwips = Branded<'twips'>;
+/**
+ * Non-negative twentieths of a point (`ST_TwipsMeasure`): WordprocessingML's native length unit.
+ * A `Twips` is assignable to `SignedTwips`, never the other way round.
+ */
+export type Twips = SignedTwips & {
+    readonly [nonNegativeBrand]: true;
+};
+/** Half-points (`w:sz`): font sizes are stored as twice their point size. */
+export type HalfPoints = Branded<'halfPoints'>;
+/** Eighth-points (`w:sz` on borders): border widths. */
+export type EighthPoints = Branded<'eighthPoints'>;
+/** English Metric Units (1/914400 inch): DrawingML lengths. */
+export type Emu = Branded<'emu'>;
+/** A non-negative whole number of twips; throws `RangeError` otherwise. */
+export declare const twips: (value: number) => Twips;
+/** A whole number of twips that may be negative; throws `RangeError` unless a safe integer. */
+export declare const signedTwips: (value: number) => SignedTwips;
+export declare const halfPoints: (value: number) => HalfPoints;
+export declare const eighthPoints: (value: number) => EighthPoints;
+export declare const emu: (value: number) => Emu;
+export declare const roundTwips: (value: number) => Twips;
+export declare const roundSignedTwips: (value: number) => SignedTwips;
+export declare const roundHalfPoints: (value: number) => HalfPoints;
+export declare const roundEighthPoints: (value: number) => EighthPoints;
+export declare const roundEmu: (value: number) => Emu;
+/** Points (1/72 inch) to twips; negative input clamps to 0. */
+export declare const twipsFromPoints: (points: number) => Twips;
+export declare const signedTwipsFromPoints: (points: number) => SignedTwips;
+/** CSS pixels at 96 dpi (15 twips per pixel) to twips; negative input clamps to 0. */
+export declare const twipsFromPixels: (pixels: number) => Twips;
+export declare const signedTwipsFromPixels: (pixels: number) => SignedTwips;
+export declare const twipsFromInches: (inches: number) => Twips;
+/** A font size in points to half-points (Word stores `w:sz` as twice the point size). */
+export declare const halfPointsFromPoints: (points: number) => HalfPoints;
+/** A border width in points to eighth-points; negative input clamps to 0. */
+export declare const eighthPointsFromPoints: (points: number) => EighthPoints;
+export declare const emuFromPixels: (pixels: number) => Emu;
+export declare const twipsToPoints: (value: SignedTwips) => number;
+export declare const twipsToPixels: (value: SignedTwips) => number;
+export declare const twipsToInches: (value: SignedTwips) => number;
+export declare const halfPointsToPoints: (value: HalfPoints) => number;
+export declare const eighthPointsToPoints: (value: EighthPoints) => number;
+export declare const emuToPixels: (value: Emu) => number;
+export {};
+//# sourceMappingURL=units.d.ts.map

package/dist/units/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../src/units/units.ts"],"names":[],"mappings":"AAMA,OAAO,CAAC,MAAM,SAAS,EAAE,OAAO,MAAM,CAAC;AACvC,OAAO,CAAC,MAAM,gBAAgB,EAAE,OAAO,MAAM,CAAC;AAC9C,KAAK,OAAO,CAAC,IAAI,SAAS,MAAM,IAAI,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAE5E,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAC3C;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AACxE,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAC/C,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AACnD,+DAA+D;AAC/D,MAAM,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;AAgBjC,2EAA2E;AAC3E,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,KAAG,KAA8C,CAAC;AACrF,+FAA+F;AAC/F,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,WAAmD,CAAC;AAChG,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,UAAsD,CAAC;AAClG,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,YACA,CAAC;AAC9C,eAAO,MAAM,GAAG,GAAI,OAAO,MAAM,KAAG,GAAiC,CAAC;AAKtE,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,KACqB,CAAC;AACjE,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,WACQ,CAAC;AAC1D,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,UACkB,CAAC;AACnE,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,YACmC,CAAC;AACtF,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,KAAG,GAAmD,CAAC;AAG7F,+DAA+D;AAC/D,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,KAAgC,CAAC;AAClF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,KAAG,WAA4C,CAAC;AACpG,sFAAsF;AACtF,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,KAAgC,CAAC;AAClF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,KAAG,WAA4C,CAAC;AACpG,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,KAAkC,CAAC;AACpF,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,KAAG,UAAyC,CAAC;AAChG,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,KAAG,YAC1B,CAAC;AAC/B,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,GAA8B,CAAC;AAG9E,eAAO,MAAM,aAAa,GAAI,OAAO,WAAW,KAAG,MAAoB,CAAC;AACxE,eAAO,MAAM,aAAa,GAAI,OAAO,WAAW,KAAG,MAAoB,CAAC;AACxE,eAAO,MAAM,aAAa,GAAI,OAAO,WAAW,KAAG,MAAsB,CAAC;AAC1E,eAAO,MAAM,kBAAkB,GAAI,OAAO,UAAU,KAAG,MAAmB,CAAC;AAC3E,eAAO,MAAM,oBAAoB,GAAI,OAAO,YAAY,KAAG,MAAmB,CAAC;AAC/E,eAAO,MAAM,WAAW,GAAI,OAAO,GAAG,KAAG,MAAsB,CAAC"}

package/dist/xml/index.cjs

@@ -0,0 +1,98 @@
+'use strict';
+
+var xmldom = require('@xmldom/xmldom');
+
+// src/xml/namespaces.ts
+var NS = {
+  /** WordprocessingML main. */
+  w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
+  /** PresentationML main. */
+  p: "http://schemas.openxmlformats.org/presentationml/2006/main",
+  /** SpreadsheetML main. */
+  x: "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
+  /** DrawingML main. */
+  a: "http://schemas.openxmlformats.org/drawingml/2006/main",
+  /** DrawingML chart. */
+  c: "http://schemas.openxmlformats.org/drawingml/2006/chart",
+  /** DrawingML diagram (SmartArt) main. */
+  dgm: "http://schemas.openxmlformats.org/drawingml/2006/diagram",
+  /** Office 2007+ diagram drawing (`dsp`). */
+  dsp: "http://schemas.microsoft.com/office/drawing/2008/diagram",
+  /** DrawingML Word drawing (`wp:inline`, `wp:anchor`). */
+  wp: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing",
+  /** DrawingML picture. */
+  pic: "http://schemas.openxmlformats.org/drawingml/2006/picture",
+  /** Word 2010 shapes (`wps`). */
+  wps: "http://schemas.microsoft.com/office/word/2010/wordprocessingShape",
+  /** Relationships (`r:id`, `r:embed`). */
+  r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
+  /** Markup compatibility (`mc:AlternateContent`). */
+  mc: "http://schemas.openxmlformats.org/markup-compatibility/2006",
+  /** OPC relationships part. */
+  rels: "http://schemas.openxmlformats.org/package/2006/relationships",
+  /** OPC content types part. */
+  contentTypes: "http://schemas.openxmlformats.org/package/2006/content-types",
+  /** Office Math. */
+  m: "http://schemas.openxmlformats.org/officeDocument/2006/math",
+  /** Core properties. */
+  cp: "http://schemas.openxmlformats.org/package/2006/metadata/core-properties",
+  /** Dublin Core elements. */
+  dc: "http://purl.org/dc/elements/1.1/",
+  /** Legacy VML. */
+  v: "urn:schemas-microsoft-com:vml",
+  /** Office VML extensions. */
+  o: "urn:schemas-microsoft-com:office:office",
+  /** Word VML extensions. */
+  w10: "urn:schemas-microsoft-com:office:word",
+  /** XML itself (`xml:space`). */
+  xml: "http://www.w3.org/XML/1998/namespace"
+};
+function parseXml(xml, options = {}) {
+  const label = options.label ?? "OOXML";
+  if (/<!DOCTYPE|<!ENTITY/i.test(xml))
+    throw new Error(`${label} XML with DTD or entity declarations is not supported`);
+  let parseError = "";
+  let parsed;
+  try {
+    parsed = new xmldom.DOMParser({
+      onError: (level, message) => {
+        if (level !== "warning") parseError = message;
+      }
+    }).parseFromString(xml, "application/xml");
+  } catch (error) {
+    throw new Error(
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (parseError || !parsed.documentElement)
+    throw new Error(`Invalid ${label} XML: ${parseError || "missing root element"}`);
+  return parsed;
+}
+var buildXml = (document) => new xmldom.XMLSerializer().serializeToString(document);
+var isElement = (node) => node.nodeType === 1;
+var elements = (parent) => Array.from(parent.childNodes).filter(isElement);
+var textContent = (element) => element.textContent ?? "";
+var makeNS = (doc, ns, qualified) => doc.createElementNS(ns, qualified);
+function named(element, local, ns, lenient = true) {
+  if (!element || element.localName !== local) return false;
+  return element.namespaceURI === ns || lenient && !element.namespaceURI;
+}
+var children = (parent, local, ns, lenient = true) => elements(parent).filter((element) => named(element, local, ns, lenient));
+var first = (parent, local, ns, lenient = true) => parent ? children(parent, local, ns, lenient)[0] : void 0;
+function attr(element, local, ns, prefix) {
+  return element?.getAttributeNS(ns, local) ?? element?.getAttribute(`${prefix}:${local}`) ?? void 0;
+}
+var relAttr = (element, local) => attr(element, local, NS.r, "r");
+
+exports.NS = NS;
+exports.attr = attr;
+exports.buildXml = buildXml;
+exports.children = children;
+exports.elements = elements;
+exports.first = first;
+exports.isElement = isElement;
+exports.makeNS = makeNS;
+exports.named = named;
+exports.parseXml = parseXml;
+exports.relAttr = relAttr;
+exports.textContent = textContent;

package/dist/xml/index.d.ts

@@ -0,0 +1,3 @@
+export * from './namespaces.js';
+export * from './xml.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/xml/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/xml/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/dist/xml/index.mjs

@@ -0,0 +1,85 @@
+import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
+
+// src/xml/namespaces.ts
+var NS = {
+  /** WordprocessingML main. */
+  w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
+  /** PresentationML main. */
+  p: "http://schemas.openxmlformats.org/presentationml/2006/main",
+  /** SpreadsheetML main. */
+  x: "http://schemas.openxmlformats.org/spreadsheetml/2006/main",
+  /** DrawingML main. */
+  a: "http://schemas.openxmlformats.org/drawingml/2006/main",
+  /** DrawingML chart. */
+  c: "http://schemas.openxmlformats.org/drawingml/2006/chart",
+  /** DrawingML diagram (SmartArt) main. */
+  dgm: "http://schemas.openxmlformats.org/drawingml/2006/diagram",
+  /** Office 2007+ diagram drawing (`dsp`). */
+  dsp: "http://schemas.microsoft.com/office/drawing/2008/diagram",
+  /** DrawingML Word drawing (`wp:inline`, `wp:anchor`). */
+  wp: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing",
+  /** DrawingML picture. */
+  pic: "http://schemas.openxmlformats.org/drawingml/2006/picture",
+  /** Word 2010 shapes (`wps`). */
+  wps: "http://schemas.microsoft.com/office/word/2010/wordprocessingShape",
+  /** Relationships (`r:id`, `r:embed`). */
+  r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
+  /** Markup compatibility (`mc:AlternateContent`). */
+  mc: "http://schemas.openxmlformats.org/markup-compatibility/2006",
+  /** OPC relationships part. */
+  rels: "http://schemas.openxmlformats.org/package/2006/relationships",
+  /** OPC content types part. */
+  contentTypes: "http://schemas.openxmlformats.org/package/2006/content-types",
+  /** Office Math. */
+  m: "http://schemas.openxmlformats.org/officeDocument/2006/math",
+  /** Core properties. */
+  cp: "http://schemas.openxmlformats.org/package/2006/metadata/core-properties",
+  /** Dublin Core elements. */
+  dc: "http://purl.org/dc/elements/1.1/",
+  /** Legacy VML. */
+  v: "urn:schemas-microsoft-com:vml",
+  /** Office VML extensions. */
+  o: "urn:schemas-microsoft-com:office:office",
+  /** Word VML extensions. */
+  w10: "urn:schemas-microsoft-com:office:word",
+  /** XML itself (`xml:space`). */
+  xml: "http://www.w3.org/XML/1998/namespace"
+};
+function parseXml(xml, options = {}) {
+  const label = options.label ?? "OOXML";
+  if (/<!DOCTYPE|<!ENTITY/i.test(xml))
+    throw new Error(`${label} XML with DTD or entity declarations is not supported`);
+  let parseError = "";
+  let parsed;
+  try {
+    parsed = new DOMParser({
+      onError: (level, message) => {
+        if (level !== "warning") parseError = message;
+      }
+    }).parseFromString(xml, "application/xml");
+  } catch (error) {
+    throw new Error(
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (parseError || !parsed.documentElement)
+    throw new Error(`Invalid ${label} XML: ${parseError || "missing root element"}`);
+  return parsed;
+}
+var buildXml = (document) => new XMLSerializer().serializeToString(document);
+var isElement = (node) => node.nodeType === 1;
+var elements = (parent) => Array.from(parent.childNodes).filter(isElement);
+var textContent = (element) => element.textContent ?? "";
+var makeNS = (doc, ns, qualified) => doc.createElementNS(ns, qualified);
+function named(element, local, ns, lenient = true) {
+  if (!element || element.localName !== local) return false;
+  return element.namespaceURI === ns || lenient && !element.namespaceURI;
+}
+var children = (parent, local, ns, lenient = true) => elements(parent).filter((element) => named(element, local, ns, lenient));
+var first = (parent, local, ns, lenient = true) => parent ? children(parent, local, ns, lenient)[0] : void 0;
+function attr(element, local, ns, prefix) {
+  return element?.getAttributeNS(ns, local) ?? element?.getAttribute(`${prefix}:${local}`) ?? void 0;
+}
+var relAttr = (element, local) => attr(element, local, NS.r, "r");
+
+export { NS, attr, buildXml, children, elements, first, isElement, makeNS, named, parseXml, relAttr, textContent };

package/dist/xml/namespaces.d.ts

@@ -0,0 +1,47 @@
+/** Namespace URIs used across the OOXML part families, so parsers never repeat the literals. */
+export declare const NS: {
+    /** WordprocessingML main. */
+    readonly w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    /** PresentationML main. */
+    readonly p: "http://schemas.openxmlformats.org/presentationml/2006/main";
+    /** SpreadsheetML main. */
+    readonly x: "http://schemas.openxmlformats.org/spreadsheetml/2006/main";
+    /** DrawingML main. */
+    readonly a: "http://schemas.openxmlformats.org/drawingml/2006/main";
+    /** DrawingML chart. */
+    readonly c: "http://schemas.openxmlformats.org/drawingml/2006/chart";
+    /** DrawingML diagram (SmartArt) main. */
+    readonly dgm: "http://schemas.openxmlformats.org/drawingml/2006/diagram";
+    /** Office 2007+ diagram drawing (`dsp`). */
+    readonly dsp: "http://schemas.microsoft.com/office/drawing/2008/diagram";
+    /** DrawingML Word drawing (`wp:inline`, `wp:anchor`). */
+    readonly wp: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing";
+    /** DrawingML picture. */
+    readonly pic: "http://schemas.openxmlformats.org/drawingml/2006/picture";
+    /** Word 2010 shapes (`wps`). */
+    readonly wps: "http://schemas.microsoft.com/office/word/2010/wordprocessingShape";
+    /** Relationships (`r:id`, `r:embed`). */
+    readonly r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+    /** Markup compatibility (`mc:AlternateContent`). */
+    readonly mc: "http://schemas.openxmlformats.org/markup-compatibility/2006";
+    /** OPC relationships part. */
+    readonly rels: "http://schemas.openxmlformats.org/package/2006/relationships";
+    /** OPC content types part. */
+    readonly contentTypes: "http://schemas.openxmlformats.org/package/2006/content-types";
+    /** Office Math. */
+    readonly m: "http://schemas.openxmlformats.org/officeDocument/2006/math";
+    /** Core properties. */
+    readonly cp: "http://schemas.openxmlformats.org/package/2006/metadata/core-properties";
+    /** Dublin Core elements. */
+    readonly dc: "http://purl.org/dc/elements/1.1/";
+    /** Legacy VML. */
+    readonly v: "urn:schemas-microsoft-com:vml";
+    /** Office VML extensions. */
+    readonly o: "urn:schemas-microsoft-com:office:office";
+    /** Word VML extensions. */
+    readonly w10: "urn:schemas-microsoft-com:office:word";
+    /** XML itself (`xml:space`). */
+    readonly xml: "http://www.w3.org/XML/1998/namespace";
+};
+export type NamespaceKey = keyof typeof NS;
+//# sourceMappingURL=namespaces.d.ts.map

package/dist/xml/namespaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../../src/xml/namespaces.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,eAAO,MAAM,EAAE;IACd,6BAA6B;;IAE7B,2BAA2B;;IAE3B,0BAA0B;;IAE1B,sBAAsB;;IAEtB,uBAAuB;;IAEvB,yCAAyC;;IAEzC,4CAA4C;;IAE5C,yDAAyD;;IAEzD,yBAAyB;;IAEzB,gCAAgC;;IAEhC,yCAAyC;;IAEzC,oDAAoD;;IAEpD,8BAA8B;;IAE9B,8BAA8B;;IAE9B,mBAAmB;;IAEnB,uBAAuB;;IAEvB,4BAA4B;;IAE5B,kBAAkB;;IAElB,6BAA6B;;IAE7B,2BAA2B;;IAE3B,gCAAgC;;CAEvB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,EAAE,CAAC"}

package/dist/xml/xml.d.ts

@@ -0,0 +1,31 @@
+export type XmlDocument = Document;
+export type XmlElement = Element;
+export type XmlNode = Node;
+export interface ParseOptions {
+    /** Names the document kind in error messages (`Invalid DOCX XML: ...`); defaults to `OOXML`. */
+    label?: string;
+}
+/**
+ * Parses an XML part into a DOM document. Parse errors throw (warnings do not), a missing root
+ * throws, and DTD or entity declarations are rejected outright (no external or expanded entities).
+ */
+export declare function parseXml(xml: string, options?: ParseOptions): XmlDocument;
+export declare const buildXml: (document: XmlDocument) => string;
+export declare const isElement: (node: Node) => node is XmlElement;
+export declare const elements: (parent: ParentNode) => XmlElement[];
+export declare const textContent: (element: XmlElement) => string;
+export declare const makeNS: (doc: XmlDocument, ns: string, qualified: string) => XmlElement;
+/**
+ * Whether `element` has local name `local` in namespace `ns`. With `lenient`, an element with no
+ * namespace also matches (hand-written test XML and some tools omit declarations).
+ */
+export declare function named(element: XmlElement | null | undefined, local: string, ns: string, lenient?: boolean): boolean;
+/** Direct child elements named `local` in `ns`. */
+export declare const children: (parent: ParentNode, local: string, ns: string, lenient?: boolean) => XmlElement[];
+/** The first direct child element named `local` in `ns`. */
+export declare const first: (parent: ParentNode | null | undefined, local: string, ns: string, lenient?: boolean) => XmlElement | undefined;
+/** An attribute by namespace and local name, falling back to the `prefix:local` form. */
+export declare function attr(element: XmlElement | null | undefined, local: string, ns: string, prefix: string): string | undefined;
+/** `r:id`-style relationship attribute (`id`, `embed`, `link`...) on an element. */
+export declare const relAttr: (element: XmlElement | null | undefined, local: string) => string | undefined;
+//# sourceMappingURL=xml.d.ts.map

package/dist/xml/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/xml/xml.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AACnC,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AACjC,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC;AAG3B,MAAM,WAAW,YAAY;IAC5B,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CAoB7E;AAED,eAAO,MAAM,QAAQ,GAAI,UAAU,WAAW,KAAG,MACwB,CAAC;AAE1E,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,IAAI,IAAI,UAAiC,CAAC;AACjF,eAAO,MAAM,QAAQ,GAAI,QAAQ,UAAU,KAAG,UAAU,EACR,CAAC;AACjD,eAAO,MAAM,WAAW,GAAI,SAAS,UAAU,KAAG,MAAmC,CAAC;AACtF,eAAO,MAAM,MAAM,GAAI,KAAK,WAAW,EAAE,IAAI,MAAM,EAAE,WAAW,MAAM,KAAG,UACtC,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,KAAK,CACpB,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACtC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,OAAO,UAAO,GACZ,OAAO,CAGT;AAED,mDAAmD;AACnD,eAAO,MAAM,QAAQ,GACpB,QAAQ,UAAU,EAClB,OAAO,MAAM,EACb,IAAI,MAAM,EACV,iBAAc,KACZ,UAAU,EAA8E,CAAC;AAE5F,4DAA4D;AAC5D,eAAO,MAAM,KAAK,GACjB,QAAQ,UAAU,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,MAAM,EACb,IAAI,MAAM,EACV,iBAAc,KACZ,UAAU,GAAG,SAA2E,CAAC;AAE5F,yFAAyF;AACzF,wBAAgB,IAAI,CACnB,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACtC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAIpB;AAED,oFAAoF;AACpF,eAAO,MAAM,OAAO,GAAI,SAAS,UAAU,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,MAAM,uBAC7C,CAAC"}