ooxml-core 0.21.2 → 0.22.1

package/dist/chart/trendline-equation.d.ts

@@ -0,0 +1,39 @@
+/**
+ * chart-trendline-equation-format.ts: Excel-style trendline equation text
+ * formatting.
+ *
+ * Excel's own trendline equation display (`c:trendlineLbl` with
+ * `c:dispEq val="1"`) rounds every coefficient to a handful of SIGNIFICANT
+ * digits in plain decimal notation, not a fixed number of decimal places: a
+ * small slope like 0.003742 stays "0.003742"-ish (four significant figures),
+ * where `.toFixed(2)` would flatten it to "0.00" and silently erase the fit.
+ * It also lays out each trendline family in its own fixed shape (exponential
+ * as `y = a e^(bx)`, a polynomial in DESCENDING powers), which this module
+ * is the single source of truth for so it cannot drift between the fit types.
+ *
+ * @module chart/trendline-equation
+ */
+/**
+ * Format one coefficient to `SIGNIFICANT_DIGITS` significant figures in plain
+ * decimal notation (falls back to exponential only where `Number#toString`
+ * itself would, i.e. extreme magnitudes), with insignificant trailing zeros
+ * dropped. `-0` normalises to `"0"`.
+ */
+export declare function formatTrendlineCoefficient(value: number): string;
+/** `y = mx + b` (linear) or `y = mx - b` when the intercept is negative. */
+export declare function formatLinearEquation(slope: number, intercept: number): string;
+/** `y = a e^(bx)`: Excel's own exponential trendline layout. */
+export declare function formatExponentialEquation(a: number, b: number): string;
+/** `y = a ln(x) + b` (logarithmic), `-` glue when the intercept is negative. */
+export declare function formatLogarithmicEquation(slope: number, intercept: number): string;
+/** `y = a x^b` (power). */
+export declare function formatPowerEquation(a: number, b: number): string;
+/**
+ * `y = a_n x^n + ... + a_1 x + a_0`: a polynomial in DESCENDING powers of x
+ * (Excel's own layout), from `coeffsAscending` ([a0, a1, ..., an], the order
+ * `fitPolynomial` returns them in). The highest-order term never shows a
+ * redundant leading `+`; `x^1` drops its exponent; the constant term (`x^0`)
+ * drops the variable entirely.
+ */
+export declare function formatPolynomialEquation(coeffsAscending: readonly number[]): string;
+//# sourceMappingURL=trendline-equation.d.ts.map

package/dist/chart/trendline-equation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trendline-equation.d.ts","sourceRoot":"","sources":["../../chart/trendline-equation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWhE;AAOD,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG7E;AAED,gEAAgE;AAChE,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED,2BAA2B;AAC3B,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAanF"}

package/dist/collab/index.cjs

@@ -1274,7 +1274,7 @@ function createTransportProvider({ doc, awareness }, { transport, maxMessageByte
 // collab/websocket-transport.ts
 var OPEN = 1;
 function roomUrl(server, roomId) {
-  return `${server.replace(/\/+$/u, "")}/${encodeURIComponent(roomId)}`;
+  return `${trimTrailingSlashes(server)}/${encodeURIComponent(roomId)}`;
 }
 function createWebSocketTransport(options) {
   const { baseDelayMs = 250, maxDelayMs = 1e4, maxRetries = Infinity } = options;
@@ -1345,6 +1345,11 @@ function createWebSocketTransport(options) {
     }
   };
 }
+function trimTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) end--;
+  return value.slice(0, end);
+}
 
 exports.BROADCAST_THROTTLE_MS = BROADCAST_THROTTLE_MS;
 exports.BoundedMap = BoundedMap;

package/dist/collab/index.mjs

@@ -1250,7 +1250,7 @@ function createTransportProvider({ doc, awareness }, { transport, maxMessageByte
 // collab/websocket-transport.ts
 var OPEN = 1;
 function roomUrl(server, roomId) {
-  return `${server.replace(/\/+$/u, "")}/${encodeURIComponent(roomId)}`;
+  return `${trimTrailingSlashes(server)}/${encodeURIComponent(roomId)}`;
 }
 function createWebSocketTransport(options) {
   const { baseDelayMs = 250, maxDelayMs = 1e4, maxRetries = Infinity } = options;
@@ -1321,5 +1321,10 @@ function createWebSocketTransport(options) {
     }
   };
 }
+function trimTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) end--;
+  return value.slice(0, end);
+}
 
 export { BROADCAST_THROTTLE_MS, BoundedMap, COLLABORATION_ROLES, COLLAB_LEAVE_MESSAGE, CONNECTION_TIMEOUT_MS, CURSOR_PALETTE, DEFAULT_COLOR, DEFAULT_MAX_PACKAGE_BYTES, DEPARTURE_CHANNEL, Emitter, INITIAL_SYNC_GRACE_MS, IdempotencyCache, LEGACY_PPTX_DEPARTURE_CHANNEL, LEGACY_PPTX_LEAVE_MESSAGE, LOCAL_ORIGIN, MAX_LABEL_CHARS, MAX_UPDATE_BYTES, MESSAGE_AWARENESS, MESSAGE_QUERY_AWARENESS, MESSAGE_SYNC, PRESENCE_FIELD, PRESENCE_HEARTBEAT_MS, STALE_PRESENCE_MS, SequenceTracker, adaptYjsProvider, applyUpdateSafe, asSelectionIds, assignUserColor, bindDocument, borrowAwareness, buildRoster, canBroadcast, canWrite, clampCoordinate, classifyVersion, clearLocalAwareness, createAssetSync, createBroadcastTransport, createClientId, createCollabSession, createDepartureChannel, createIdGenerator, createMemoryHub, createPresencePublisher, createSyncGate, createTransportProvider, createWebSocketTransport, deriveCanvasPresence, derivePresence, encodeDiff, encodeSnapshot, encodeStateVector2 as encodeStateVector, formatCursorLabel, freezeDeep, fromBase64, getUserInitials, isMixedContentBlocked, isNonNegativeSafeInteger, isPresenceFresh, isValidId, isValidRoomId, mergeUpdates2 as mergeUpdates, observeExternalSession, packageAdapter, presenceToCursors, registerTeardown, removeAwarenessStatesLocally, restoreSnapshot, roomUrl, sanitizeAvatarUrl, sanitizeCanvasPayload, sanitizeColor, sanitizeIdentity, sanitizeIndex, sanitizeRole, sanitizeUserName, shouldAutoFollowBroadcaster, shouldRoomReplaceLoad, stripHtmlTags, toBase64, transportProvider, validateDisplayName, validateRoomId, validateUpdate };

package/dist/color/contrast.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Readable-text-colour selection for fills whose text colour was left implicit.
+ *
+ * PowerPoint stores no colour for a great many runs and resolves one at paint
+ * time from what is behind them. Renderers that instead pick a fixed colour get
+ * white text on white panels, so both the 2D and 3D SmartArt paths need the same
+ * decision, made the same way.
+ *
+ * @module color/contrast
+ */
+/** Parse `#rgb`/`#rrggbb` into `[r, g, b]` (0..255); falls back to mid-grey. */
+export declare function parseHex(hex: string): [number, number, number];
+/**
+ * Pick a readable text colour (near-black or near-white) for a given fill,
+ * using the WCAG relative-luminance threshold.
+ */
+export declare function contrastTextColor(fill: string): string;
+//# sourceMappingURL=contrast.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../color/contrast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAY9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAItD"}

package/dist/color/index.cjs

@@ -160,16 +160,49 @@ function linearToSrgb255(linear) {
   return 255 * (c <= 31308e-7 ? c * 12.92 : 1.055 * c ** (1 / 2.4) - 0.055);
 }
 
+// color/contrast.ts
+function parseHex(hex) {
+  let h = hex.trim().replace(/^#/u, "");
+  if (h.length === 3) {
+    h = h.split("").map((c) => c + c).join("");
+  }
+  if (h.length !== 6 || /[^0-9a-fA-F]/u.test(h)) {
+    return [128, 128, 128];
+  }
+  return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+}
+function contrastTextColor(fill) {
+  const [r, g, b] = parseHex(fill);
+  const lum = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+  return lum > 0.6 ? "#1a1a1a" : "#ffffff";
+}
+
+// color/unit-rgb.ts
+function hexToRgbUnit(hex) {
+  const clean = hex.replace(/^#/u, "");
+  const r = Number.parseInt(clean.substring(0, 2), 16) / 255;
+  const g = Number.parseInt(clean.substring(2, 4), 16) / 255;
+  const b = Number.parseInt(clean.substring(4, 6), 16) / 255;
+  return {
+    r: Number.isFinite(r) ? r : 0,
+    g: Number.isFinite(g) ? g : 0,
+    b: Number.isFinite(b) ? b : 0
+  };
+}
+
 exports.blendColorOntoWhite = blendColorOntoWhite;
 exports.clampUnitInterval = clampUnitInterval;
 exports.colorWithOpacity = colorWithOpacity;
+exports.contrastTextColor = contrastTextColor;
 exports.hexToRgbChannels = hexToRgbChannels;
+exports.hexToRgbUnit = hexToRgbUnit;
 exports.hslToRgb = hslToRgb;
 exports.linearToSrgb255 = linearToSrgb255;
 exports.normalizeHexColor = normalizeHexColor;
 exports.parseDrawingFraction = parseDrawingFraction;
 exports.parseDrawingHueDegrees = parseDrawingHueDegrees;
 exports.parseDrawingPercent = parseDrawingPercent;
+exports.parseHex = parseHex;
 exports.parseOoxmlPercent = parseOoxmlPercent;
 exports.rgbToHsl = rgbToHsl;
 exports.scrgbLinearToSrgb8 = scrgbLinearToSrgb8;

package/dist/color/index.d.ts

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

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

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

package/dist/color/index.mjs

@@ -158,4 +158,34 @@ function linearToSrgb255(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 };
+// color/contrast.ts
+function parseHex(hex) {
+  let h = hex.trim().replace(/^#/u, "");
+  if (h.length === 3) {
+    h = h.split("").map((c) => c + c).join("");
+  }
+  if (h.length !== 6 || /[^0-9a-fA-F]/u.test(h)) {
+    return [128, 128, 128];
+  }
+  return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+}
+function contrastTextColor(fill) {
+  const [r, g, b] = parseHex(fill);
+  const lum = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+  return lum > 0.6 ? "#1a1a1a" : "#ffffff";
+}
+
+// color/unit-rgb.ts
+function hexToRgbUnit(hex) {
+  const clean = hex.replace(/^#/u, "");
+  const r = Number.parseInt(clean.substring(0, 2), 16) / 255;
+  const g = Number.parseInt(clean.substring(2, 4), 16) / 255;
+  const b = Number.parseInt(clean.substring(4, 6), 16) / 255;
+  return {
+    r: Number.isFinite(r) ? r : 0,
+    g: Number.isFinite(g) ? g : 0,
+    b: Number.isFinite(b) ? b : 0
+  };
+}
+
+export { blendColorOntoWhite, clampUnitInterval, colorWithOpacity, contrastTextColor, hexToRgbChannels, hexToRgbUnit, hslToRgb, linearToSrgb255, normalizeHexColor, parseDrawingFraction, parseDrawingHueDegrees, parseDrawingPercent, parseHex, parseOoxmlPercent, rgbToHsl, scrgbLinearToSrgb8, srgb255ToLinear, toHex };

package/dist/color/unit-rgb.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Colour-unit conversion helpers shared across the SVG `<filter>` builders in
+ * `render/`.
+ *
+ * `hexToRgbUnit` used to exist as three private, byte-identical copies:
+ * `visual-effects.ts` (DAG duotone filter), `image-effects.ts` (image duotone
+ * filter), and Angular's `duotone-filter.ts`. This is the one canonical copy;
+ * the other two shared modules now import it instead of redefining it.
+ */
+/**
+ * Parse a hex colour (`#RRGGBB`/`RRGGBB`, `#` optional) to normalised 0-1 RGB
+ * components. Any channel that fails to parse (missing/invalid hex digits,
+ * including a short 3-digit `#RGB` shorthand, which this does NOT expand)
+ * produces `0`, matching every prior copy's behaviour exactly.
+ */
+export declare function hexToRgbUnit(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+};
+//# sourceMappingURL=unit-rgb.d.ts.map

package/dist/color/unit-rgb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-rgb.d.ts","sourceRoot":"","sources":["../../color/unit-rgb.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAU7E"}

package/dist/docx/embedded.cjs

@@ -1149,7 +1149,7 @@ async function applyCoreProperties(zip, next, prior) {
   await ensureContentTypeOverride(zip, CORE_PATH, CORE_TYPE);
   const rels = zip.file("_rels/.rels");
   const relsXml = await rels?.async("string") ?? '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>';
-  if (!relsXml.includes(CORE_REL)) {
+  if (!relsXml.includes(`Type="${CORE_REL}"`)) {
     const ids = [...relsXml.matchAll(/Id="rId(\d+)"/g)].map((match) => Number(match[1]));
     const id = `rId${Math.max(0, ...ids) + 1}`;
     zip.file(

package/dist/docx/embedded.mjs

@@ -1143,7 +1143,7 @@ async function applyCoreProperties(zip, next, prior) {
   await ensureContentTypeOverride(zip, CORE_PATH, CORE_TYPE);
   const rels = zip.file("_rels/.rels");
   const relsXml = await rels?.async("string") ?? '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>';
-  if (!relsXml.includes(CORE_REL)) {
+  if (!relsXml.includes(`Type="${CORE_REL}"`)) {
     const ids = [...relsXml.matchAll(/Id="rId(\d+)"/g)].map((match) => Number(match[1]));
     const id = `rId${Math.max(0, ...ids) + 1}`;
     zip.file(

package/dist/docx/index.cjs

@@ -1787,7 +1787,7 @@ async function applyCoreProperties(zip, next, prior) {
   await ensureContentTypeOverride(zip, CORE_PATH, CORE_TYPE);
   const rels = zip.file("_rels/.rels");
   const relsXml = await rels?.async("string") ?? '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>';
-  if (!relsXml.includes(CORE_REL)) {
+  if (!relsXml.includes(`Type="${CORE_REL}"`)) {
     const ids = [...relsXml.matchAll(/Id="rId(\d+)"/g)].map((match) => Number(match[1]));
     const id = `rId${Math.max(0, ...ids) + 1}`;
     zip.file(

package/dist/docx/index.mjs

@@ -1781,7 +1781,7 @@ async function applyCoreProperties(zip, next, prior) {
   await ensureContentTypeOverride(zip, CORE_PATH, CORE_TYPE);
   const rels = zip.file("_rels/.rels");
   const relsXml = await rels?.async("string") ?? '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>';
-  if (!relsXml.includes(CORE_REL)) {
+  if (!relsXml.includes(`Type="${CORE_REL}"`)) {
     const ids = [...relsXml.matchAll(/Id="rId(\d+)"/g)].map((match) => Number(match[1]));
     const id = `rId${Math.max(0, ...ids) + 1}`;
     zip.file(

package/dist/docx/load/index.cjs

@@ -2110,7 +2110,7 @@ async function applyCoreProperties(zip, next, prior) {
   await ensureContentTypeOverride(zip, CORE_PATH, CORE_TYPE);
   const rels = zip.file("_rels/.rels");
   const relsXml = await rels?.async("string") ?? '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>';
-  if (!relsXml.includes(CORE_REL)) {
+  if (!relsXml.includes(`Type="${CORE_REL}"`)) {
     const ids = [...relsXml.matchAll(/Id="rId(\d+)"/g)].map((match) => Number(match[1]));
     const id = `rId${Math.max(0, ...ids) + 1}`;
     zip.file(

package/dist/docx/load/index.mjs

@@ -2104,7 +2104,7 @@ async function applyCoreProperties(zip, next, prior) {
   await ensureContentTypeOverride(zip, CORE_PATH, CORE_TYPE);
   const rels = zip.file("_rels/.rels");
   const relsXml = await rels?.async("string") ?? '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>';
-  if (!relsXml.includes(CORE_REL)) {
+  if (!relsXml.includes(`Type="${CORE_REL}"`)) {
     const ids = [...relsXml.matchAll(/Id="rId(\d+)"/g)].map((match) => Number(match[1]));
     const id = `rId${Math.max(0, ...ids) + 1}`;
     zip.file(

package/dist/geometry/align-distribute.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Pure geometry helpers for the align / distribute editor operations.
+ *
+ * These functions operate over a list of slide elements (anything carrying the
+ * `{ id, x, y, width, height }` bounding-box fields of {@link PptxElement}) and
+ * return a `Map` keyed by element `id` describing the *new* position(s) for the
+ * elements that need to move. Elements that already sit on the target edge (or
+ * the two outer-most elements during distribution) are still included with
+ * their unchanged coordinate so callers can apply the whole map uniformly; the
+ * map only ever contains the axis that the operation touches.
+ *
+ * The reference box the selection is aligned against is either the union of
+ * the selected boxes (PowerPoint's "Align Selected Objects") or the slide
+ * itself ("Align to Slide"). PowerPoint defaults to the slide whenever a
+ * single object is selected, which is why a one-element selection is not a
+ * no-op once a `slideSize` is supplied: Align Center on a lone title is one
+ * of the commonest arrange gestures there is.
+ *
+ * The helpers are deliberately framework-agnostic: no DOM, no Vue reactivity,
+ * no side effects. The host wires them into the editor by feeding the current
+ * selection in and applying the returned `Map` via its element-transform
+ * operation (one batched history entry per call).
+ */
+/** Edge / centre that {@link alignElements} can snap a selection to. */
+export type AlignEdge = 'left' | 'centerH' | 'right' | 'top' | 'middle' | 'bottom';
+/** Axis along which {@link distributeElements} evenly spaces a selection. */
+export type DistributeAxis = 'horizontal' | 'vertical';
+/**
+ * What a selection is aligned / distributed against.
+ *
+ * - `'selection'`: the union bounding box of the selected elements
+ *   (PowerPoint's "Align Selected Objects"). Needs at least two elements.
+ * - `'slide'`: the slide bounds (`0, 0, slideSize.width, slideSize.height`),
+ *   PowerPoint's "Align to Slide". Works for any non-empty selection.
+ */
+export type AlignReference = 'selection' | 'slide';
+/** Slide dimensions in the same (pixel) units as the element boxes. */
+export interface AlignSlideSize {
+    width: number;
+    height: number;
+}
+/** Optional reference selection for {@link alignElements} and friends. */
+export interface AlignOptions {
+    /**
+     * Explicit reference. When omitted, `'slide'` is assumed for a single
+     * element (PowerPoint's default) and `'selection'` otherwise. Either way
+     * the slide is only used when `slideSize` is supplied.
+     */
+    reference?: AlignReference;
+    /** Slide bounds; required for the slide to act as the reference. */
+    slideSize?: AlignSlideSize;
+}
+/** New position for a single element. Only the affected axis is populated. */
+export interface ElementPosition {
+    x?: number;
+    y?: number;
+}
+/**
+ * The minimal bounding-box shape the helpers need. {@link PptxElement} already
+ * satisfies this, but accepting the structural subset keeps the helpers usable
+ * (and testable) with plain geometry objects too.
+ */
+export interface BoundingBoxElement {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** An axis-aligned reference rectangle. */
+export interface AlignReferenceBox {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/**
+ * Decide whether the slide (rather than the selection) is the reference for a
+ * given selection + options. The slide is chosen when asked for explicitly or
+ * when only one element is selected, but only when its size is known.
+ */
+export declare function usesSlideReference(elementCount: number, options: AlignOptions | undefined): options is AlignOptions & {
+    slideSize: AlignSlideSize;
+};
+/**
+ * The rectangle a selection is aligned against, or `null` when there is
+ * nothing to align to (an empty selection, or a lone element with no slide
+ * size to fall back on).
+ */
+export declare function resolveAlignReferenceBox(elements: readonly BoundingBoxElement[], options?: AlignOptions): AlignReferenceBox | null;
+/**
+ * Align every element in the selection to a shared edge (or centre line) of
+ * the reference box (see {@link resolveAlignReferenceBox}).
+ *
+ * - `left` / `right` / `centerH` move elements horizontally (set `x`).
+ * - `top` / `bottom` / `middle` move elements vertically (set `y`).
+ *
+ * Without a `slideSize` the behaviour is unchanged from before the option
+ * existed: the reference is the selection's union box and fewer than two
+ * elements yields an empty map.
+ *
+ * @param elements - The selected elements.
+ * @param edge - The edge / centre line to align to.
+ * @param options - Reference selection; see {@link AlignOptions}.
+ * @returns A `Map<id, {x?, y?}>` of new positions (only the touched axis set).
+ */
+export declare function alignElements(elements: readonly BoundingBoxElement[], edge: AlignEdge, options?: AlignOptions): Map<string, ElementPosition>;
+/**
+ * Distribute a selection so the gaps between adjacent elements are equal.
+ *
+ * Elements are ordered by their leading edge on the chosen axis. Against the
+ * selection, the two outer-most elements are pinned and the free space (span
+ * minus the sum of element sizes) is divided evenly into the gaps between
+ * consecutive elements; this needs at least three elements (two outer + one
+ * interior to move). Against the slide (`'slide'` reference, or a single
+ * element with a `slideSize`), the span is the whole slide and the free space
+ * is divided into `n + 1` equal gaps so the margins to both slide edges match
+ * the gaps between elements, as PowerPoint's "Align to Slide" distribution
+ * does; any non-empty selection qualifies.
+ *
+ * @param elements - The selected elements.
+ * @param axis - `'horizontal'` distributes along `x`; `'vertical'` along `y`.
+ * @param options - Reference selection; see {@link AlignOptions}.
+ * @returns A `Map<id, {x?, y?}>` of new positions (only the touched axis set).
+ */
+export declare function distributeElements(elements: readonly BoundingBoxElement[], axis: DistributeAxis, options?: AlignOptions): Map<string, ElementPosition>;
+/** Alias of {@link AlignEdge}. */
+export type AlignMode = AlignEdge;
+/** Alias of {@link DistributeAxis}. */
+export type DistributeMode = DistributeAxis;
+/** Alias of {@link BoundingBoxElement}. */
+export type AlignBox = BoundingBoxElement;
+/** Alias of {@link ElementPosition}. */
+export type PositionUpdate = ElementPosition;
+/**
+ * {@link alignElements} (slide reference included) filtered to the boxes that
+ * actually move.
+ */
+export declare function computeAlign(boxes: readonly AlignBox[], mode: AlignMode, options?: AlignOptions): Map<string, PositionUpdate>;
+/**
+ * {@link distributeElements} (slide reference included) filtered to the boxes
+ * that actually move.
+ */
+export declare function computeDistribute(boxes: readonly AlignBox[], mode: DistributeMode, options?: AlignOptions): Map<string, PositionUpdate>;
+//# sourceMappingURL=align-distribute.d.ts.map

package/dist/geometry/align-distribute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"align-distribute.d.ts","sourceRoot":"","sources":["../../geometry/align-distribute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnF,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,CAAC;AAEnD,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,oEAAoE;IACpE,SAAS,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC/B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,GAAG,SAAS,GAC/B,OAAO,IAAI,YAAY,GAAG;IAAE,SAAS,EAAE,cAAc,CAAA;CAAE,CAKzD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,OAAO,CAAC,EAAE,YAAY,GACpB,iBAAiB,GAAG,IAAI,CAgB1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,YAAY,GACpB,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAkC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,YAAY,GACpB,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAkC9B;AASD,kCAAkC;AAClC,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC;AAClC,uCAAuC;AACvC,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC;AAC5C,2CAA2C;AAC3C,MAAM,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAC1C,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC;AAuB7C;;;GAGG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,YAAY,GACpB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAE7B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,YAAY,GACpB,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAE7B"}