ooxml-core 0.2.0

package/dist/color/color-primitives.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Low-level colour primitives: hex/rgb conversion, clamping,
+ * HSL conversion, and OOXML percent/fraction/angle parsers.
+ *
+ * These are the foundational colour operations used throughout the PPTX
+ * editor. Higher-level colour parsing (from OOXML colour-choice nodes)
+ * lives in `./color-utils.ts`; transforms in `./color-transforms.ts`.
+ *
+ * @module color-primitives
+ */
+/**
+ * Clamp a numeric value to the [0, 1] interval.
+ *
+ * Used extensively when converting OOXML percentage values to normalised
+ * fractions for opacity, saturation, luminance, etc.
+ *
+ * @param value - The number to clamp.
+ * @returns The value clamped to [0, 1].
+ */
+export declare function clampUnitInterval(value: number): number;
+/**
+ * Normalise a hex colour string, ensuring it starts with `#` and
+ * contains exactly 6 hex digits. Returns the fallback colour when
+ * the input is missing, `"transparent"`, or malformed.
+ *
+ * @param value - Raw colour string (with or without leading `#`).
+ * @param fallback - Colour to return when `value` is invalid. Defaults to `"#111827"` (dark grey).
+ * @returns A valid `#RRGGBB` hex colour string.
+ */
+export declare function normalizeHexColor(value: string | undefined, fallback?: string): string;
+/**
+ * Parse a `#RRGGBB` (or `RRGGBB`) hex colour into its individual
+ * red, green, and blue channels (0-255 each).
+ *
+ * @param color - Hex colour string.
+ * @returns An object with `r`, `g`, `b` channels, or `null` if the string is invalid.
+ */
+export declare function hexToRgbChannels(color: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * Convert a hex colour to an `rgba()` CSS colour string with the
+ * given opacity. If `opacity` is `undefined`, the original hex
+ * string is returned unchanged.
+ *
+ * @param color - A `#RRGGBB` hex colour string.
+ * @param opacity - Opacity value in [0, 1], or `undefined` for full opacity.
+ * @returns A CSS colour string (either the original hex or an `rgba(...)` string).
+ */
+export declare function colorWithOpacity(color: string, opacity: number | undefined): string;
+/**
+ * Composite a colour with the given opacity onto an opaque white backdrop,
+ * returning a flat `#RRGGBB` hex colour rather than an `rgba()` string.
+ *
+ * PowerPoint has no "page behind the page": a semi-transparent slide/layout/
+ * master background is always shown against white, so `a:alpha` on a
+ * background `a:solidFill` is not really transparency in the rendered deck,
+ * it is a recipe for a flatter colour. `slide.backgroundColor` (and the
+ * layout/master equivalents) is a single flat value painted behind every
+ * binding's stage, which can itself sit on a white canvas, a dark
+ * presentation-mode backdrop, or a thumbnail strip; emitting `rgba()` there
+ * would let alpha show through those different backdrops, which PowerPoint
+ * never does. Blending onto white once, here, keeps the value a plain hex
+ * colour that renders identically everywhere. See issue #288.
+ *
+ * @param color - A `#RRGGBB` hex colour string.
+ * @param opacity - Opacity in [0, 1]. `undefined` or `>= 1` returns `color` unchanged (nothing to blend).
+ * @returns The blended `#RRGGBB` hex colour, or `color` unchanged when there is nothing to blend.
+ */
+export declare function blendColorOntoWhite(color: string, opacity: number | undefined): string;
+/**
+ * Parse an OOXML percentage value in either lexical form and return it as an
+ * unclamped fraction, without assuming a scale from the caller's context.
+ *
+ * @param value - Raw attribute value from XML (string or number).
+ * @returns Fraction (1 = 100%), or `undefined` if unparseable.
+ */
+export declare function parseOoxmlPercent(value: unknown): number | undefined;
+/**
+ * Parse an OOXML percentage value and return it as a normalised
+ * fraction in [0, 1]. Both the transitional thousandths form (`50000`)
+ * and the strict literal form (`50%`) are accepted.
+ *
+ * The result is clamped to [0, 1]; use {@link parseDrawingFraction}
+ * when unclamped values are needed (e.g. `lumMod` > 100%).
+ *
+ * @param value - Raw attribute value from XML (string or number).
+ * @returns Normalised fraction in [0, 1], or `undefined` if unparseable.
+ */
+export declare function parseDrawingPercent(value: unknown): number | undefined;
+/**
+ * Convert a single scRGB linear-light channel (as a fraction, where `1` =
+ * 100%) to an 8-bit sRGB value in [0, 255] by applying the IEC 61966-2-1
+ * gamma companding (linear -> sRGB).
+ *
+ * `a:scrgbClr` channels are linear-light, so treating them directly as sRGB
+ * (the historical behaviour) over-darkens mid-tones (e.g. 50% linear became
+ * `#80`, whereas the correct companded value is `#BC`). Values outside
+ * [0, 1] are clamped to the displayable range (8-bit output cannot represent
+ * the >100% HDR values scRGB permits).
+ *
+ * @param linear - Linear-light channel fraction (typically [0, 1]).
+ * @returns Companded sRGB channel value in [0, 255].
+ */
+export declare function scrgbLinearToSrgb8(linear: number): number;
+/**
+ * Convert a numeric colour channel value (0-255) to a two-character
+ * uppercase hex string. Values outside [0, 255] are clamped.
+ *
+ * @param value - Colour channel value.
+ * @returns Two-character uppercase hex string (e.g. `"0A"`, `"FF"`).
+ */
+export declare function toHex(value: number): string;
+/**
+ * Represents a colour in the HSL (Hue, Saturation, Lightness) colour space.
+ */
+export interface HslColor {
+    /** Hue in degrees [0, 360). */
+    h: number;
+    /** Saturation [0, 1]. */
+    s: number;
+    /** Lightness [0, 1]. */
+    l: number;
+}
+/**
+ * Convert an RGB colour (each channel 0-255) to HSL.
+ *
+ * Uses the standard algorithm:
+ *  1. Normalise RGB channels to [0, 1].
+ *  2. Find min/max channels and their delta.
+ *  3. Lightness = average of min and max.
+ *  4. Saturation depends on lightness and delta.
+ *  5. Hue is derived from which channel is dominant.
+ *
+ * @param r - Red channel (0-255).
+ * @param g - Green channel (0-255).
+ * @param b - Blue channel (0-255).
+ * @returns HSL colour with h in [0, 360), s and l in [0, 1].
+ */
+export declare function rgbToHsl(r: number, g: number, b: number): HslColor;
+/**
+ * Convert an HSL colour back to RGB (each channel 0-255).
+ *
+ * Uses the standard HSL-to-RGB algorithm with chroma, secondary
+ * component, and match value. The hue determines which 60-degree
+ * sector of the colour wheel the colour falls in.
+ *
+ * @param h - Hue in degrees (will be normalised to [0, 360)).
+ * @param s - Saturation in [0, 1].
+ * @param l - Lightness in [0, 1].
+ * @returns An object with `r`, `g`, `b` channels (0-255 each).
+ */
+export declare function hslToRgb(h: number, s: number, l: number): {
+    r: number;
+    g: number;
+    b: number;
+};
+/**
+ * Parse an OOXML percentage value as a fraction.
+ * Unlike {@link parseDrawingPercent}, this does **not** clamp to [0, 1],
+ * allowing mod values above 100 % and negative offset values.
+ *
+ * This is needed for colour transforms like `lumMod` (which can exceed
+ * 100%) and `satOff` / `lumOff` (which can be negative).
+ *
+ * @param value - Raw attribute value from XML.
+ * @returns Unclamped fraction, or `undefined` if unparseable.
+ */
+export declare function parseDrawingFraction(value: unknown): number | undefined;
+/**
+ * Parse an OOXML angle value given in 60 000ths of a degree and return
+ * the result in degrees (e.g. `5400000` becomes `90`).
+ *
+ * OOXML stores angles as positive integers in 60 000ths of a degree
+ * to avoid floating-point issues in the XML representation.
+ *
+ * @param value - Raw attribute value from XML.
+ * @returns Angle in degrees, or `undefined` if unparseable.
+ */
+export declare function parseDrawingHueDegrees(value: unknown): number | undefined;
+//# sourceMappingURL=color-primitives.d.ts.map

package/dist/color/color-primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-primitives.d.ts","sourceRoot":"","sources":["../../src/color/color-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAE,MAAkB,GAAG,MAAM,CAOjG;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CASnF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CActF;AAuBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGtE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIzD;AAMD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3C;AAMD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;CACV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,CAoClE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAiD7F;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMzE"}

package/dist/color/index.cjs

@@ -0,0 +1,177 @@
+'use strict';
+
+// src/color/color-primitives.ts
+function clampUnitInterval(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function normalizeHexColor(value, fallback = "#111827") {
+  if (!value || value === "transparent") {
+    return fallback;
+  }
+  const candidate = value.startsWith("#") ? value : `#${value}`;
+  return /^#[0-9A-Fa-f]{6}$/.test(candidate) ? candidate : fallback;
+}
+function hexToRgbChannels(color) {
+  const normalized = color.replace("#", "");
+  if (!/^[0-9a-fA-F]{6}$/.test(normalized)) {
+    return null;
+  }
+  return {
+    r: Number.parseInt(normalized.slice(0, 2), 16),
+    g: Number.parseInt(normalized.slice(2, 4), 16),
+    b: Number.parseInt(normalized.slice(4, 6), 16)
+  };
+}
+function colorWithOpacity(color, opacity) {
+  if (opacity === void 0) {
+    return color;
+  }
+  const rgb = hexToRgbChannels(color);
+  if (!rgb) {
+    return color;
+  }
+  return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${clampUnitInterval(opacity)})`;
+}
+function blendColorOntoWhite(color, opacity) {
+  if (opacity === void 0) {
+    return color;
+  }
+  const clamped = clampUnitInterval(opacity);
+  if (clamped >= 1) {
+    return color;
+  }
+  const rgb = hexToRgbChannels(color);
+  if (!rgb) {
+    return color;
+  }
+  const blendChannel = (channel) => toHex(channel * clamped + 255 * (1 - clamped));
+  return `#${blendChannel(rgb.r)}${blendChannel(rgb.g)}${blendChannel(rgb.b)}`;
+}
+function percentDivisorFor(text) {
+  return text.endsWith("%") ? 100 : 1e5;
+}
+function parseOoxmlPercent(value) {
+  const text = String(value ?? "").trim();
+  const divisor = percentDivisorFor(text);
+  const magnitude = Number.parseFloat(divisor === 100 ? text.slice(0, -1) : text);
+  if (!Number.isFinite(magnitude)) {
+    return void 0;
+  }
+  return magnitude / divisor;
+}
+function parseDrawingPercent(value) {
+  const parsed = parseOoxmlPercent(value);
+  return parsed === void 0 ? void 0 : clampUnitInterval(parsed);
+}
+function scrgbLinearToSrgb8(linear) {
+  const l = Math.min(1, Math.max(0, linear));
+  const companded = l <= 31308e-7 ? 12.92 * l : 1.055 * l ** (1 / 2.4) - 0.055;
+  return Math.min(255, Math.max(0, Math.round(companded * 255)));
+}
+function toHex(value) {
+  return Math.min(255, Math.max(0, Math.round(value))).toString(16).padStart(2, "0").toUpperCase();
+}
+function rgbToHsl(r, g, b) {
+  const rN = r / 255;
+  const gN = g / 255;
+  const bN = b / 255;
+  const cMax = Math.max(rN, gN, bN);
+  const cMin = Math.min(rN, gN, bN);
+  const delta = cMax - cMin;
+  const l = (cMax + cMin) / 2;
+  let s = 0;
+  if (delta !== 0) {
+    s = delta / (1 - Math.abs(2 * l - 1));
+  }
+  let h = 0;
+  if (delta !== 0) {
+    if (cMax === rN) {
+      h = 60 * ((gN - bN) / delta % 6);
+    } else if (cMax === gN) {
+      h = 60 * ((bN - rN) / delta + 2);
+    } else {
+      h = 60 * ((rN - gN) / delta + 4);
+    }
+  }
+  if (h < 0) {
+    h += 360;
+  }
+  return { h, s: clampUnitInterval(s), l: clampUnitInterval(l) };
+}
+function hslToRgb(h, s, l) {
+  const sC = clampUnitInterval(s);
+  const lC = clampUnitInterval(l);
+  const hN = (h % 360 + 360) % 360;
+  const c = (1 - Math.abs(2 * lC - 1)) * sC;
+  const x = c * (1 - Math.abs(hN / 60 % 2 - 1));
+  const m = lC - c / 2;
+  let rP = 0;
+  let gP = 0;
+  let bP = 0;
+  if (hN < 60) {
+    rP = c;
+    gP = x;
+    bP = 0;
+  } else if (hN < 120) {
+    rP = x;
+    gP = c;
+    bP = 0;
+  } else if (hN < 180) {
+    rP = 0;
+    gP = c;
+    bP = x;
+  } else if (hN < 240) {
+    rP = 0;
+    gP = x;
+    bP = c;
+  } else if (hN < 300) {
+    rP = x;
+    gP = 0;
+    bP = c;
+  } else {
+    rP = c;
+    gP = 0;
+    bP = x;
+  }
+  return {
+    r: Math.round((rP + m) * 255),
+    g: Math.round((gP + m) * 255),
+    b: Math.round((bP + m) * 255)
+  };
+}
+function parseDrawingFraction(value) {
+  return parseOoxmlPercent(value);
+}
+function parseDrawingHueDegrees(value) {
+  const parsed = Number.parseFloat(String(value ?? "").trim());
+  if (!Number.isFinite(parsed)) {
+    return void 0;
+  }
+  return parsed / 6e4;
+}
+
+// src/color/color-linear.ts
+function srgb255ToLinear(channel) {
+  const c = clampUnitInterval(channel / 255);
+  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+function linearToSrgb255(linear) {
+  const c = clampUnitInterval(linear);
+  return 255 * (c <= 31308e-7 ? c * 12.92 : 1.055 * c ** (1 / 2.4) - 0.055);
+}
+
+exports.blendColorOntoWhite = blendColorOntoWhite;
+exports.clampUnitInterval = clampUnitInterval;
+exports.colorWithOpacity = colorWithOpacity;
+exports.hexToRgbChannels = hexToRgbChannels;
+exports.hslToRgb = hslToRgb;
+exports.linearToSrgb255 = linearToSrgb255;
+exports.normalizeHexColor = normalizeHexColor;
+exports.parseDrawingFraction = parseDrawingFraction;
+exports.parseDrawingHueDegrees = parseDrawingHueDegrees;
+exports.parseDrawingPercent = parseDrawingPercent;
+exports.parseOoxmlPercent = parseOoxmlPercent;
+exports.rgbToHsl = rgbToHsl;
+exports.scrgbLinearToSrgb8 = scrgbLinearToSrgb8;
+exports.srgb255ToLinear = srgb255ToLinear;
+exports.toHex = toHex;

package/dist/color/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/color/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/color/index.mjs

@@ -0,0 +1,161 @@
+// src/color/color-primitives.ts
+function clampUnitInterval(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function normalizeHexColor(value, fallback = "#111827") {
+  if (!value || value === "transparent") {
+    return fallback;
+  }
+  const candidate = value.startsWith("#") ? value : `#${value}`;
+  return /^#[0-9A-Fa-f]{6}$/.test(candidate) ? candidate : fallback;
+}
+function hexToRgbChannels(color) {
+  const normalized = color.replace("#", "");
+  if (!/^[0-9a-fA-F]{6}$/.test(normalized)) {
+    return null;
+  }
+  return {
+    r: Number.parseInt(normalized.slice(0, 2), 16),
+    g: Number.parseInt(normalized.slice(2, 4), 16),
+    b: Number.parseInt(normalized.slice(4, 6), 16)
+  };
+}
+function colorWithOpacity(color, opacity) {
+  if (opacity === void 0) {
+    return color;
+  }
+  const rgb = hexToRgbChannels(color);
+  if (!rgb) {
+    return color;
+  }
+  return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${clampUnitInterval(opacity)})`;
+}
+function blendColorOntoWhite(color, opacity) {
+  if (opacity === void 0) {
+    return color;
+  }
+  const clamped = clampUnitInterval(opacity);
+  if (clamped >= 1) {
+    return color;
+  }
+  const rgb = hexToRgbChannels(color);
+  if (!rgb) {
+    return color;
+  }
+  const blendChannel = (channel) => toHex(channel * clamped + 255 * (1 - clamped));
+  return `#${blendChannel(rgb.r)}${blendChannel(rgb.g)}${blendChannel(rgb.b)}`;
+}
+function percentDivisorFor(text) {
+  return text.endsWith("%") ? 100 : 1e5;
+}
+function parseOoxmlPercent(value) {
+  const text = String(value ?? "").trim();
+  const divisor = percentDivisorFor(text);
+  const magnitude = Number.parseFloat(divisor === 100 ? text.slice(0, -1) : text);
+  if (!Number.isFinite(magnitude)) {
+    return void 0;
+  }
+  return magnitude / divisor;
+}
+function parseDrawingPercent(value) {
+  const parsed = parseOoxmlPercent(value);
+  return parsed === void 0 ? void 0 : clampUnitInterval(parsed);
+}
+function scrgbLinearToSrgb8(linear) {
+  const l = Math.min(1, Math.max(0, linear));
+  const companded = l <= 31308e-7 ? 12.92 * l : 1.055 * l ** (1 / 2.4) - 0.055;
+  return Math.min(255, Math.max(0, Math.round(companded * 255)));
+}
+function toHex(value) {
+  return Math.min(255, Math.max(0, Math.round(value))).toString(16).padStart(2, "0").toUpperCase();
+}
+function rgbToHsl(r, g, b) {
+  const rN = r / 255;
+  const gN = g / 255;
+  const bN = b / 255;
+  const cMax = Math.max(rN, gN, bN);
+  const cMin = Math.min(rN, gN, bN);
+  const delta = cMax - cMin;
+  const l = (cMax + cMin) / 2;
+  let s = 0;
+  if (delta !== 0) {
+    s = delta / (1 - Math.abs(2 * l - 1));
+  }
+  let h = 0;
+  if (delta !== 0) {
+    if (cMax === rN) {
+      h = 60 * ((gN - bN) / delta % 6);
+    } else if (cMax === gN) {
+      h = 60 * ((bN - rN) / delta + 2);
+    } else {
+      h = 60 * ((rN - gN) / delta + 4);
+    }
+  }
+  if (h < 0) {
+    h += 360;
+  }
+  return { h, s: clampUnitInterval(s), l: clampUnitInterval(l) };
+}
+function hslToRgb(h, s, l) {
+  const sC = clampUnitInterval(s);
+  const lC = clampUnitInterval(l);
+  const hN = (h % 360 + 360) % 360;
+  const c = (1 - Math.abs(2 * lC - 1)) * sC;
+  const x = c * (1 - Math.abs(hN / 60 % 2 - 1));
+  const m = lC - c / 2;
+  let rP = 0;
+  let gP = 0;
+  let bP = 0;
+  if (hN < 60) {
+    rP = c;
+    gP = x;
+    bP = 0;
+  } else if (hN < 120) {
+    rP = x;
+    gP = c;
+    bP = 0;
+  } else if (hN < 180) {
+    rP = 0;
+    gP = c;
+    bP = x;
+  } else if (hN < 240) {
+    rP = 0;
+    gP = x;
+    bP = c;
+  } else if (hN < 300) {
+    rP = x;
+    gP = 0;
+    bP = c;
+  } else {
+    rP = c;
+    gP = 0;
+    bP = x;
+  }
+  return {
+    r: Math.round((rP + m) * 255),
+    g: Math.round((gP + m) * 255),
+    b: Math.round((bP + m) * 255)
+  };
+}
+function parseDrawingFraction(value) {
+  return parseOoxmlPercent(value);
+}
+function parseDrawingHueDegrees(value) {
+  const parsed = Number.parseFloat(String(value ?? "").trim());
+  if (!Number.isFinite(parsed)) {
+    return void 0;
+  }
+  return parsed / 6e4;
+}
+
+// src/color/color-linear.ts
+function srgb255ToLinear(channel) {
+  const c = clampUnitInterval(channel / 255);
+  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+function linearToSrgb255(linear) {
+  const c = clampUnitInterval(linear);
+  return 255 * (c <= 31308e-7 ? c * 12.92 : 1.055 * c ** (1 / 2.4) - 0.055);
+}
+
+export { blendColorOntoWhite, clampUnitInterval, colorWithOpacity, hexToRgbChannels, hslToRgb, linearToSrgb255, normalizeHexColor, parseDrawingFraction, parseDrawingHueDegrees, parseDrawingPercent, parseOoxmlPercent, rgbToHsl, scrgbLinearToSrgb8, srgb255ToLinear, toHex };

package/dist/diagram/attributes.d.ts

@@ -0,0 +1,12 @@
+import type { AttributeReader, DiagramConnection, DiagramNodeCustomLayout, DiagramRelationshipIds } from './types.js';
+/** Parses the typed CT_Cxn attributes; `undefined` without `srcId` and `destId`. */
+export declare function parseConnectionAttributes(get: AttributeReader): DiagramConnection | undefined;
+/**
+ * Parses the manual layout override attributes (`cust*`) of a `dgm:prSet`, or `undefined` when it
+ * carries none. Angles are 60,000ths of a degree on disk and plain degrees here; scale and size
+ * factors are 100,000ths on disk and plain ratios here.
+ */
+export declare function parseCustomLayoutAttributes(get: AttributeReader): DiagramNodeCustomLayout | undefined;
+/** Reads `CT_RelIds` (`r:dm`, `r:lo`, `r:qs`, `r:cs`); the reader matches attributes by local name. */
+export declare function parseRelationshipIdAttributes(get: AttributeReader): DiagramRelationshipIds;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/diagram/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../src/diagram/attributes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,MAAM,YAAY,CAAC;AA0BpB,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,eAAe,GAAG,iBAAiB,GAAG,SAAS,CAoB7F;AAqBD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAC1C,GAAG,EAAE,eAAe,GAClB,uBAAuB,GAAG,SAAS,CAWrC;AASD,uGAAuG;AACvG,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,eAAe,GAAG,sBAAsB,CAO1F"}

package/dist/diagram/data-model.d.ts

@@ -0,0 +1,18 @@
+import { type XmlDocument } from '../xml/index.js';
+import { type XmlElement } from './dom.js';
+import type { DiagramConnection, DiagramDataModel } from './types.js';
+/**
+ * `transitionPointModelId -> text` for every transition point that carries non-empty text.
+ * Generic over the point representation so pptx can feed it its object-tree points.
+ */
+export declare function collectTransitionText<T>(points: Iterable<T>, describe: (point: T) => {
+    type?: string;
+    modelId?: string;
+}, text: (point: T) => string): Map<string, string>;
+/** The label of a connection: the parent transition's text, else the sibling transition's. */
+export declare function connectionLabel(connection: DiagramConnection, transitionText: ReadonlyMap<string, string>): string | undefined;
+/** Paragraphs of a `dgm:t` / `dsp:txBody` text body: the concatenated `a:t` of each `a:p`. */
+export declare function textBodyParagraphs(body: XmlElement | undefined): string[];
+/** Parses a data model part. Malformed XML throws; structural problems are returned as `issues`. */
+export declare function parseDiagramDataModel(source: string | XmlDocument, part?: string): DiagramDataModel;
+//# sourceMappingURL=data-model.d.ts.map

package/dist/diagram/data-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-model.d.ts","sourceRoot":"","sources":["../../src/diagram/data-model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAQN,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAA8B,MAAM,YAAY,CAAC;AAOlG;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACtC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GACxB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWrB;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAC9B,UAAU,EAAE,iBAAiB,EAC7B,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,MAAM,GAAG,SAAS,CAQpB;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,EAAE,CAOzE;AAgCD,oGAAoG;AACpG,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,MAAM,GAAG,WAAW,EAC5B,IAAI,CAAC,EAAE,MAAM,GACX,gBAAgB,CAgElB"}

package/dist/diagram/definitions.d.ts

@@ -0,0 +1,14 @@
+import { type XmlDocument } from '../xml/index.js';
+import { type XmlElement } from './dom.js';
+import type { DiagramColorsDefinition, DiagramDefinitionHeader, DiagramLayoutSummary, DiagramQuickStyleDefinition, DiagramStyleLabel } from './types.js';
+/** `uniqueId`, `dgm:title`, `dgm:desc` and `dgm:catLst` shared by the definition parts. */
+export declare function parseDefinitionHeader(root: XmlElement): DiagramDefinitionHeader;
+/** Parses a colours definition part. */
+export declare function parseDiagramColors(source: string | XmlDocument): DiagramColorsDefinition;
+/** The four style-matrix references of a `dgm:style` / `dsp:style` element. */
+export declare function parseStyleReferences(style: XmlElement | undefined): Pick<DiagramStyleLabel, 'line' | 'fill' | 'effect' | 'font'>;
+/** Parses a quick style definition part. */
+export declare function parseDiagramQuickStyle(source: string | XmlDocument): DiagramQuickStyleDefinition;
+/** Parses the header, family and root algorithm of a layout definition part. */
+export declare function parseDiagramLayoutSummary(source: string | XmlDocument): DiagramLayoutSummary;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/diagram/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/diagram/definitions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAON,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAGX,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,EAEjB,MAAM,YAAY,CAAC;AAKpB,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,uBAAuB,CAe/E;AAOD,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,uBAAuB,CAYxF;AAiBD,+EAA+E;AAC/E,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,UAAU,GAAG,SAAS,GAC3B,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,CAW9D;AAKD,4CAA4C;AAC5C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,2BAA2B,CAahG;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,oBAAoB,CAe5F"}

package/dist/diagram/dom.d.ts

@@ -0,0 +1,15 @@
+import { NS, children, elements, first, isElement, type XmlElement } from '../xml/index.js';
+import type { AttributeReader } from './types.js';
+export { children, elements, first, isElement, NS };
+export type { XmlElement };
+/** Reads an attribute by local name regardless of its prefix (`r:dm` and `dm` are the same here). */
+export declare function attributeReader(element: XmlElement | null | undefined): AttributeReader;
+/** A trimmed, non-empty attribute value. */
+export declare function stringAttribute(element: XmlElement | null | undefined, name: string): string | undefined;
+/** An integer attribute (base 10); `undefined` when absent or not a number. */
+export declare function integerAttribute(element: XmlElement | null | undefined, name: string): number | undefined;
+/** `1`, `true` -> true; `0`, `false` -> false; otherwise `undefined`. */
+export declare function booleanAttribute(element: XmlElement | null | undefined, name: string): boolean | undefined;
+/** All descendant elements with a local name, in document order, in any namespace. */
+export declare function descendants(root: XmlElement, local: string): XmlElement[];
+//# sourceMappingURL=dom.d.ts.map

package/dist/diagram/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/diagram/dom.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,CAYvF;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAC9B,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACtC,IAAI,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAGpB;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACtC,IAAI,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAGpB;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACtC,IAAI,EAAE,MAAM,GACV,OAAO,GAAG,SAAS,CAKrB;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAWzE"}

package/dist/diagram/drawing-color.d.ts

@@ -0,0 +1,28 @@
+import { type XmlElement } from './dom.js';
+import type { DiagramColor } from './types.js';
+/** Reads the colour element held directly by `container` (`a:solidFill`, `dgm:fillClrLst` item...). */
+export declare function parseDrawingColorIn(container: XmlElement | undefined): DiagramColor | undefined;
+/** Reads one colour element (`a:srgbClr`, `a:schemeClr`, ...) and its transform children. */
+export declare function parseDrawingColor(element: XmlElement): DiagramColor | undefined;
+/** Every colour element directly under `container`, in order (a `dgm:fillClrLst`). */
+export declare function parseDrawingColorList(container: XmlElement | undefined): DiagramColor[];
+/** Theme lookup the host supplies: `accent1`, `dk1`, `lt1`, `tx1`, `bg1`... to `#RRGGBB`. */
+export interface DrawingColorTheme {
+    scheme(name: string): string | undefined;
+}
+export interface ResolvedDrawingColor {
+    /** `#RRGGBB`. */
+    hex: string;
+    /** 0..1; 1 when the colour has no alpha transform. */
+    alpha: number;
+    /** Transforms this resolver does not apply, so a caller can report an approximation. */
+    unapplied: string[];
+}
+/**
+ * Resolves a colour to `#RRGGBB` plus alpha. Applies the transforms in the order PowerPoint does
+ * (structural, shade/tint in linear light, one HSL round trip, alpha) and lists those it does not
+ * apply (`red*`, `green*`, `blue*`, `gamma`) in `unapplied`. Returns `undefined` when the base
+ * colour cannot be determined (an unknown theme slot, `phClr` with no host value, ...).
+ */
+export declare function resolveDrawingColor(color: DiagramColor, theme?: DrawingColorTheme): ResolvedDrawingColor | undefined;
+//# sourceMappingURL=drawing-color.d.ts.map

package/dist/diagram/drawing-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawing-color.d.ts","sourceRoot":"","sources":["../../src/diagram/drawing-color.ts"],"names":[],"mappings":"AAcA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkB/C,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAQ/F;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,CAc/E;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,EAAE,CAMvF;AAED,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IACjC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACpC,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,SAAS,EAAE,MAAM,EAAE,CAAC;CACpB;AA8DD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,iBAAiB,GACvB,oBAAoB,GAAG,SAAS,CAiElC"}

package/dist/diagram/drawing-fill.d.ts

@@ -0,0 +1,9 @@
+import { type XmlElement } from './dom.js';
+import type { DiagramFill, DiagramLine } from './types.js';
+/** The fill element held directly by a shape-properties or line element, if any. */
+export declare function fillElementOf(properties: XmlElement | undefined): XmlElement | undefined;
+/** Reads the fill of `a:spPr`/`a:ln`; `undefined` when the element declares none (inherit). */
+export declare function parseDrawingFill(properties: XmlElement | undefined): DiagramFill | undefined;
+/** Reads `a:ln`: width in EMU, fill, dash and cap. */
+export declare function parseDrawingLine(ln: XmlElement | undefined): DiagramLine | undefined;
+//# sourceMappingURL=drawing-fill.d.ts.map

package/dist/diagram/drawing-fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawing-fill.d.ts","sourceRoot":"","sources":["../../src/diagram/drawing-fill.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiC,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAW3D,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAQxF;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CA4C5F;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAYpF"}