@office-kit/pptx-preview 0.13.0 → 0.14.0

package/README.md

@@ -195,4 +195,4 @@ the editable paragraph text.
 
 ### Text regions for editing overlays
 
-`resolveTextBodyRect(preset, bounds, margins)` returns the same inner text rectangle used by the preview before wrapping and autofit. Pass `{x, y, w, h}` and `{left, top, right, bottom}` in the same unit, normally EMU, with inherited/default margins already resolved. It accounts for the preview's constrained preset regions and drops margins if they collapse such a region. Rectangular regions with nonpositive width or height remain degenerate so callers can handle them explicitly. This shares the preview's current geometry approximations; it does not evaluate arbitrary custom-geometry text rectangles.
+`shapeTextRect(shape)` returns where a shape lays out its text, as fractions of its own extent: the `<a:rect>` its custom geometry states, or the one ECMA-376 defines for its preset (an ellipse's inscribed rectangle, a triangle's lower middle), following its adjust values. It is `null` when text takes the whole box. `resolveTextBodyRect(bounds, margins, region)` places that region in `bounds` less the body insets, giving the same inner text rectangle the preview uses before wrapping and autofit. Pass `{x, y, w, h}` and `{left, top, right, bottom}` in the same unit, normally EMU, with inherited/default margins already resolved. Margins that would collapse a region are dropped; a full box with nonpositive width or height stays degenerate so callers can handle it explicitly.

package/dist/{index-DwLYANVE.d.ts → index-DUFPGYOf.d.ts}

@@ -121,41 +121,33 @@ declare const paragraphNumberLabels: (paraData: ReadonlyArray<{
 }>) => Array<string | null>;
 //#endregion
 //#region src/text-body-rect.d.ts
+/** A text rectangle as fractions of the shape's extent. */
+interface TextRectFractions {
+  readonly l: number;
+  readonly t: number;
+  readonly r: number;
+  readonly b: number;
+}
 /**
- * The text rectangle a custom-geometry shape states for itself, as fractions
- * of its own extent, or `null` for a preset shape and for a custom one that
- * states none. `<a:rect>` is written in EMU against the shape's extents, so
- * dividing by them here is what lets the result travel with a shape that a
- * group has scaled.
+ * Where a shape lays out its text, as fractions of its own extent: the
+ * `<a:rect>` its geometry states, written in its `<a:custGeom>` or in
+ * ECMA-376's definition of its preset (an ellipse's inscribed rectangle, a
+ * triangle's lower middle, an arrow's shaft). `null` lays text into the whole
+ * box: a shape that inherits its geometry, or whose rectangle has no room.
+ *
+ * The rectangle is in the shape's own `<a:ext>` space, so dividing by that —
+ * not by on-screen bounds, which carry a group's or autofit's scale — is what
+ * lets the result travel with the shape.
  */
-declare function shapeCustomTextRect(custom: {
-  textRect: {
-    l: number;
-    t: number;
-    r: number;
-    b: number;
-  } | null;
-} | null, extent: {
-  w: number;
-  h: number;
-} | null): {
-  l: number;
-  t: number;
-  r: number;
-  b: number;
-} | null;
+declare function shapeTextRect(shape: SlideShapeData): TextRectFractions | null;
 /**
- * Text layout rectangle used by the preview, including preset geometry and body
- * insets. All coordinates and margins must use the same unit (normally EMU).
- * Preset regions follow the preview's current geometry approximations. When
- * margins collapse a preset region, retain that region without margins.
- *
- * A custom-geometry shape states its own rectangle in `<a:custGeom><a:rect>`.
- * Pass it as `custom`, as fractions of the shape's extent so that it scales
- * with `bounds` the way a preset region does, and it wins: unlike the table
- * above it is not an approximation of anything — it is what the file says.
+ * Text layout rectangle used by the preview: `region` (from
+ * {@link shapeTextRect}, or `null` for the whole box) placed in `bounds`, less
+ * the body insets. All coordinates and margins must use the same unit
+ * (normally EMU). When margins collapse a region, the region is kept without
+ * them, as PowerPoint does.
  */
-declare function resolveTextBodyRect(preset: string | null, bounds: {
+declare function resolveTextBodyRect(bounds: {
   x: number;
   y: number;
   w: number;
@@ -165,12 +157,7 @@ declare function resolveTextBodyRect(preset: string | null, bounds: {
   top: number;
   right: number;
   bottom: number;
-}, custom?: {
-  l: number;
-  t: number;
-  r: number;
-  b: number;
-} | null): {
+}, region: TextRectFractions | null): {
   x: number;
   y: number;
   w: number;
@@ -245,5 +232,5 @@ declare function shapeTextAnchorOffset(pres: PresentationData, shape: SlideShape
  */
 declare function textUnderlineStyle(underline: TextFormat['underline'], color: string, includeDecorationColor?: boolean): string;
 //#endregion
-export { TIMES as C, substituteFamily as D, defaultMeasurer as E, SERIF as S, TextMeasurer as T, FontSpec as _, VerticalTextStyle as a, RenderSlideOptions as b, resolveTextBodyRect as c, AuditTextLayoutOptions as d, TextAuditIssue as f, ARIAL as g, renderTextEffectsSvg as h, shapeTextAnchorOffset as i, shapeCustomTextRect as l, renderSlideSvg as m, ShapeAutoFitScaleOptions as n, textColumnsStyle as o, auditTextLayout as p, shapeAutoFitScale as r, verticalTextStyle as s, textUnderlineStyle as t, paragraphNumberLabels as u, MONO as v, TextLayoutMode as w, SANS as x, MeasureResult as y };
-//# sourceMappingURL=index-DwLYANVE.d.ts.map
+export { SERIF as C, defaultMeasurer as D, TextMeasurer as E, substituteFamily as O, SANS as S, TextLayoutMode as T, ARIAL as _, VerticalTextStyle as a, MeasureResult as b, TextRectFractions as c, paragraphNumberLabels as d, AuditTextLayoutOptions as f, renderTextEffectsSvg as g, renderSlideSvg as h, shapeTextAnchorOffset as i, resolveTextBodyRect as l, auditTextLayout as m, ShapeAutoFitScaleOptions as n, textColumnsStyle as o, TextAuditIssue as p, shapeAutoFitScale as r, verticalTextStyle as s, textUnderlineStyle as t, shapeTextRect as u, FontSpec as v, TIMES as w, RenderSlideOptions as x, MONO as y };
+//# sourceMappingURL=index-DUFPGYOf.d.ts.map

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { C as TIMES, D as substituteFamily, E as defaultMeasurer, S as SERIF, T as TextMeasurer, _ as FontSpec, a as VerticalTextStyle, b as RenderSlideOptions, c as resolveTextBodyRect, d as AuditTextLayoutOptions, f as TextAuditIssue, g as ARIAL, h as renderTextEffectsSvg, i as shapeTextAnchorOffset, l as shapeCustomTextRect, m as renderSlideSvg, n as ShapeAutoFitScaleOptions, o as textColumnsStyle, p as auditTextLayout, r as shapeAutoFitScale, s as verticalTextStyle, t as textUnderlineStyle, u as paragraphNumberLabels, v as MONO, w as TextLayoutMode, x as SANS, y as MeasureResult } from "./index-DwLYANVE.js";
-export { ARIAL, type AuditTextLayoutOptions, type FontSpec, MONO, type MeasureResult, type RenderSlideOptions, SANS, SERIF, type ShapeAutoFitScaleOptions, TIMES, type TextAuditIssue, type TextLayoutMode, type TextMeasurer, type VerticalTextStyle, auditTextLayout, defaultMeasurer, paragraphNumberLabels, renderSlideSvg as renderSlideToSvg, renderTextEffectsSvg, resolveTextBodyRect, shapeAutoFitScale, shapeCustomTextRect, shapeTextAnchorOffset, substituteFamily, textColumnsStyle, textUnderlineStyle, verticalTextStyle };
+import { C as SERIF, D as defaultMeasurer, E as TextMeasurer, O as substituteFamily, S as SANS, T as TextLayoutMode, _ as ARIAL, a as VerticalTextStyle, b as MeasureResult, c as TextRectFractions, d as paragraphNumberLabels, f as AuditTextLayoutOptions, g as renderTextEffectsSvg, h as renderSlideSvg, i as shapeTextAnchorOffset, l as resolveTextBodyRect, m as auditTextLayout, n as ShapeAutoFitScaleOptions, o as textColumnsStyle, p as TextAuditIssue, r as shapeAutoFitScale, s as verticalTextStyle, t as textUnderlineStyle, u as shapeTextRect, v as FontSpec, w as TIMES, x as RenderSlideOptions, y as MONO } from "./index-DUFPGYOf.js";
+export { ARIAL, type AuditTextLayoutOptions, type FontSpec, MONO, type MeasureResult, type RenderSlideOptions, SANS, SERIF, type ShapeAutoFitScaleOptions, TIMES, type TextAuditIssue, type TextLayoutMode, type TextMeasurer, type TextRectFractions, type VerticalTextStyle, auditTextLayout, defaultMeasurer, paragraphNumberLabels, renderSlideSvg as renderSlideToSvg, renderTextEffectsSvg, resolveTextBodyRect, shapeAutoFitScale, shapeTextAnchorOffset, shapeTextRect, substituteFamily, textColumnsStyle, textUnderlineStyle, verticalTextStyle };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { _ as textColumnsStyle, a as renderTextEffectsSvg, b as shapeCustomTextRect, c as MONO, d as TIMES, f as defaultMeasurer, g as textUnderlineStyle, h as paragraphNumberLabels, i as renderSlideSvg, l as SANS, m as substituteFamily, n as shapeTextAnchorOffset, o as ARIAL, r as auditTextLayout, t as shapeAutoFitScale, u as SERIF, v as verticalTextStyle, y as resolveTextBodyRect } from "./src-DYfIZIh8.js";
-export { ARIAL, MONO, SANS, SERIF, TIMES, auditTextLayout, defaultMeasurer, paragraphNumberLabels, renderSlideSvg as renderSlideToSvg, renderTextEffectsSvg, resolveTextBodyRect, shapeAutoFitScale, shapeCustomTextRect, shapeTextAnchorOffset, substituteFamily, textColumnsStyle, textUnderlineStyle, verticalTextStyle };
+import { _ as textColumnsStyle, a as renderTextEffectsSvg, b as shapeTextRect, c as MONO, d as TIMES, f as defaultMeasurer, g as textUnderlineStyle, h as paragraphNumberLabels, i as renderSlideSvg, l as SANS, m as substituteFamily, n as shapeTextAnchorOffset, o as ARIAL, r as auditTextLayout, t as shapeAutoFitScale, u as SERIF, v as verticalTextStyle, y as resolveTextBodyRect } from "./src-Bwmf324Z.js";
+export { ARIAL, MONO, SANS, SERIF, TIMES, auditTextLayout, defaultMeasurer, paragraphNumberLabels, renderSlideSvg as renderSlideToSvg, renderTextEffectsSvg, resolveTextBodyRect, shapeAutoFitScale, shapeTextAnchorOffset, shapeTextRect, substituteFamily, textColumnsStyle, textUnderlineStyle, verticalTextStyle };

package/dist/node.d.ts

@@ -1,4 +1,4 @@
-import { C as TIMES, D as substituteFamily, E as defaultMeasurer, S as SERIF, T as TextMeasurer, _ as FontSpec, a as VerticalTextStyle, b as RenderSlideOptions, c as resolveTextBodyRect, d as AuditTextLayoutOptions, f as TextAuditIssue, g as ARIAL, h as renderTextEffectsSvg, i as shapeTextAnchorOffset, l as shapeCustomTextRect, m as renderSlideSvg, n as ShapeAutoFitScaleOptions, o as textColumnsStyle, p as auditTextLayout, r as shapeAutoFitScale, s as verticalTextStyle, t as textUnderlineStyle, u as paragraphNumberLabels, v as MONO, w as TextLayoutMode, x as SANS, y as MeasureResult } from "./index-DwLYANVE.js";
+import { C as SERIF, D as defaultMeasurer, E as TextMeasurer, O as substituteFamily, S as SANS, T as TextLayoutMode, _ as ARIAL, a as VerticalTextStyle, b as MeasureResult, c as TextRectFractions, d as paragraphNumberLabels, f as AuditTextLayoutOptions, g as renderTextEffectsSvg, h as renderSlideSvg, i as shapeTextAnchorOffset, l as resolveTextBodyRect, m as auditTextLayout, n as ShapeAutoFitScaleOptions, o as textColumnsStyle, p as TextAuditIssue, r as shapeAutoFitScale, s as verticalTextStyle, t as textUnderlineStyle, u as shapeTextRect, v as FontSpec, w as TIMES, x as RenderSlideOptions, y as MONO } from "./index-DUFPGYOf.js";
 import { PresentationData, SlideData } from "@office-kit/pptx";
 
 //#region src/measure.d.ts
@@ -73,5 +73,5 @@ declare const renderSlideToRgba: (pres: PresentationData, slide: SlideData, opts
   readonly png: Uint8Array;
 };
 //#endregion
-export { ARIAL, type AuditTextLayoutOptions, FONT_DIR, FONT_FILES, type FontSpec, type FontkitMeasurerOptions, MONO, type MeasureResult, type RegisteredFont, RenderImageOptions, type RenderSlideOptions, RgbaImage, SANS, SERIF, type ShapeAutoFitScaleOptions, TIMES, type TextAuditIssue, type TextLayoutMode, type TextMeasurer, type VerticalTextStyle, auditTextLayout, buildFontkitMeasurer, defaultMeasurer, paragraphNumberLabels, renderSlideToImage, renderSlideToRgba, renderSlideSvg as renderSlideToSvg, renderTextEffectsSvg, resolveTextBodyRect, shapeAutoFitScale, shapeCustomTextRect, shapeTextAnchorOffset, substituteFamily, textColumnsStyle, textUnderlineStyle, verticalTextStyle };
+export { ARIAL, type AuditTextLayoutOptions, FONT_DIR, FONT_FILES, type FontSpec, type FontkitMeasurerOptions, MONO, type MeasureResult, type RegisteredFont, RenderImageOptions, type RenderSlideOptions, RgbaImage, SANS, SERIF, type ShapeAutoFitScaleOptions, TIMES, type TextAuditIssue, type TextLayoutMode, type TextMeasurer, type TextRectFractions, type VerticalTextStyle, auditTextLayout, buildFontkitMeasurer, defaultMeasurer, paragraphNumberLabels, renderSlideToImage, renderSlideToRgba, renderSlideSvg as renderSlideToSvg, renderTextEffectsSvg, resolveTextBodyRect, shapeAutoFitScale, shapeTextAnchorOffset, shapeTextRect, substituteFamily, textColumnsStyle, textUnderlineStyle, verticalTextStyle };
 //# sourceMappingURL=node.d.ts.map

package/dist/node.js

@@ -1,4 +1,4 @@
-import { _ as textColumnsStyle, a as renderTextEffectsSvg, b as shapeCustomTextRect, c as MONO, d as TIMES, f as defaultMeasurer, g as textUnderlineStyle, h as paragraphNumberLabels, i as renderSlideSvg, l as SANS, m as substituteFamily, n as shapeTextAnchorOffset, o as ARIAL, p as isCjk, r as auditTextLayout, s as AVG_GLYPH_W_RATIO, t as shapeAutoFitScale, u as SERIF, v as verticalTextStyle, y as resolveTextBodyRect } from "./src-DYfIZIh8.js";
+import { _ as textColumnsStyle, a as renderTextEffectsSvg, b as shapeTextRect, c as MONO, d as TIMES, f as defaultMeasurer, g as textUnderlineStyle, h as paragraphNumberLabels, i as renderSlideSvg, l as SANS, m as substituteFamily, n as shapeTextAnchorOffset, o as ARIAL, p as isCjk, r as auditTextLayout, s as AVG_GLYPH_W_RATIO, t as shapeAutoFitScale, u as SERIF, v as verticalTextStyle, y as resolveTextBodyRect } from "./src-Bwmf324Z.js";
 import { getSlideSize } from "@office-kit/pptx";
 import { Resvg } from "@resvg/resvg-js";
 import * as fontkit from "fontkit";
@@ -195,6 +195,6 @@ const renderSlideToRgba = (pres, slide, opts = {}) => {
 	};
 };
 //#endregion
-export { ARIAL, FONT_DIR, FONT_FILES, MONO, SANS, SERIF, TIMES, auditTextLayout, buildFontkitMeasurer, defaultMeasurer, paragraphNumberLabels, renderSlideToImage, renderSlideToRgba, renderSlideSvg as renderSlideToSvg, renderTextEffectsSvg, resolveTextBodyRect, shapeAutoFitScale, shapeCustomTextRect, shapeTextAnchorOffset, substituteFamily, textColumnsStyle, textUnderlineStyle, verticalTextStyle };
+export { ARIAL, FONT_DIR, FONT_FILES, MONO, SANS, SERIF, TIMES, auditTextLayout, buildFontkitMeasurer, defaultMeasurer, paragraphNumberLabels, renderSlideToImage, renderSlideToRgba, renderSlideSvg as renderSlideToSvg, renderTextEffectsSvg, resolveTextBodyRect, shapeAutoFitScale, shapeTextAnchorOffset, shapeTextRect, substituteFamily, textColumnsStyle, textUnderlineStyle, verticalTextStyle };
 
 //# sourceMappingURL=node.js.map