@shbernal/ts-pptx 4.0.1 → 4.2.0

package/dist/{fit-Cb7naFj6.js → fit-Bpmzep6O.js}

@@ -1,10 +1,10 @@
-import { l as warn, n as InvalidOptionError, o as UnsupportedFeatureError, r as MediaError } from "./errors-C4oENPcu.js";
-import { _ as resolveCellMarginsInches, b as resolveTableColWidthsEmu, d as marginToEmu, s as getSmartParseNumber, t as autoPageLineHeightEmu, v as resolveInsetsEmu, x as resolveTableRowHeightEmu } from "./units-internal-XJlf-hOl.js";
-import { D as emuToInches, I as EMU_PER_POINT } from "./table-cell-margins-EVg0EwxT.js";
-import { t as pickDefined } from "./options-internal-WqgMf720.js";
-import { t as BODY_INSET_DEFAULTS_EMU } from "./body-insets-Dw_BeWD_.js";
-import { n as tableColCount, r as walkTableGrid } from "./grid-DikTjFey.js";
-//#region src/measure/font-collection.ts
+import { D as emuToInches, I as EMU_PER_POINT } from "./enums-BP9wsb9Q.js";
+import { _ as resolveCellMarginsInches, b as resolveTableColWidthsEmu, d as marginToEmu, s as getSmartParseNumber, t as autoPageLineHeightEmu, v as resolveInsetsEmu, x as resolveTableRowHeightEmu } from "./units-internal-BR3a4cIi.js";
+import { i as MediaError, r as InvalidOptionError, s as UnsupportedFeatureError, u as warn } from "./entry-errors-JMthgJ2g.js";
+import { t as BODY_INSET_DEFAULTS_EMU } from "./body-insets-BDHymJvz.js";
+import { t as pickDefined } from "./options-internal-BWgmLPdx.js";
+import { n as tableColCount, r as walkTableGrid } from "./grid-DUIMxjfl.js";
+// src/measure/font-collection.ts
 /**
 * Font **collection** (`.ttc` / `.otc`) support for the write-side metrics.
 *
@@ -262,8 +262,7 @@ function extractFontFace(data, index) {
 	}
 	return out;
 }
-//#endregion
-//#region src/measure/font-metrics.ts
+// src/measure/font-metrics.ts
 /**
 * Write-side font metrics.
 *
@@ -274,7 +273,7 @@ function extractFontFace(data, index) {
 *
 * Width is summed from **raw `hmtx` advances with no kerning/shaping** (GPOS/GSUB
 * are deliberately ignored): kerning almost always narrows a line, so raw advances
-* over-estimate width — the conservative direction (shrink a touch too much, never
+* over-estimate width, the conservative direction (shrink a touch too much, never
 * overflow). See `docs/contributing/design/text-fit.md` ("Font metrics provider").
 */
 var OpentypeFontMetrics = class {
@@ -345,7 +344,7 @@ let heuristicSingleton;
 /**
 * Shared, font-independent `FontMetrics` used when a named face has no registered
 * metrics but the deck has opted into measured fit (some other face is registered).
-* Approximate but conservative — see `heuristicCharRatio`. A deck with no
+* Approximate but conservative; see `heuristicCharRatio`. A deck with no
 * registered metrics at all does not engage measured fit, so this never fires there.
 */
 function getHeuristicFontMetrics() {
@@ -402,7 +401,7 @@ var FontMetricsRegistry = class {
 	* Coverage of code point `cp` for `face`, read from the registered font's cmap:
 	* `true`/`false` when a variant of `face` is registered (see {@link get} for the
 	* exact→regular→any-variant fallback), or `undefined` when the face has **no**
-	* registered metrics — "unknown", deliberately distinct from a `false`
+	* registered metrics: "unknown", deliberately distinct from a `false`
 	* "registered but not covered". A coverage audit must not treat an unregistered
 	* face as fully covered, so callers get `undefined` here rather than the per-face
 	* {@link FontMetrics.hasCodepoint} boolean (which, for the heuristic fallback,
@@ -477,8 +476,7 @@ function collectUncoveredCodepoints(paragraphs, registry, into) {
 		if (missing) into.set(face, missing);
 	}
 }
-//#endregion
-//#region src/measure/text-fit.ts
+// src/measure/text-fit.ts
 /**
 * PowerPoint single-spacing line pitch as a multiple of font size.
 *
@@ -497,10 +495,10 @@ const MIN_FONT_SCALE_PCT = 25;
 * Conservative safety factors applied by the shrink solver (not by the pure
 * `measureHeightPt`). Raw `hmtx` advances summed without shaping still pack a line
 * a little tighter than PowerPoint, which lays text out at a device DPI and rounds
-* each glyph advance up — so PowerPoint wraps marginally earlier and its fitted
+* each glyph advance up, so PowerPoint wraps marginally earlier and its fitted
 * box is marginally taller. Inflating measured width and height by these factors
 * makes the computed `fontScale` ≤ PowerPoint's across the calibration oracle
-* (`test/read/autofit-calibration-oracle.test.js`: 0 violations over the Aptos
+* (`test/read/autofit-calibration-oracle.test.ts`: 0 violations over the Aptos
 * cases). They err on the side of shrinking slightly too much, never overflowing.
 */
 const WIDTH_SAFETY_FACTOR = 1.03;
@@ -515,7 +513,7 @@ const isWhitespace = (ch) => ch === " " || ch === "	" || ch === "\xA0" || /\s/.t
 *
 * **Hangul is deliberately absent.** UAX #14 makes Hangul breakable between
 * syllables, but PowerPoint does not: Korean is written with spaces between words
-* and the app breaks it like Latin. `autofit-cjk-wrap.pptx` pins that directly —
+* and the app breaks it like Latin. `autofit-cjk-wrap.pptx` pins that directly:
 * the same box that lays out in 2 lines in Han or Kana takes 3 in Hangul, because
 * the run moves down whole. A Hangul run longer than one line still breaks between
 * syllables, but that is the over-long-token character-wrap fallback in
@@ -540,7 +538,7 @@ function isCjkBreakCharacter(ch) {
 /**
 * Tokenize one paragraph at a given `fontScalePct`. Words can span run boundaries
 * (a break is only allowed at whitespace, or either side of a per-character
-* breaking code point — see `isCjkBreakCharacter`). Returns `null` if any run's
+* breaking code point; see `isCjkBreakCharacter`). Returns `null` if any run's
 * face has no registered metrics (the paragraph cannot be measured).
 */
 function tokenizeParagraph(para, resolve, fontScalePct, widthSafety) {
@@ -598,7 +596,7 @@ function tokenizeParagraph(para, resolve, fontScalePct, widthSafety) {
 * laid-out line width. `maxLineWidthPt` tracks the running line width and records
 * it whenever a line completes (a wrap or the final line), so callers can measure
 * the actual text extent, not just the box width. Trailing whitespace counts
-* toward width, as PowerPoint counts it, which slightly over-reports — the
+* toward width, as PowerPoint counts it, which slightly over-reports: the
 * conservative direction, consistent with the wrap model erring wide. The
 * PowerPoint behaviour this follows is tabled in `docs/contributing/design/text-fit.md`.
 */
@@ -690,16 +688,16 @@ function measureHeightPt(paragraphs, innerWidthPt, resolve, fontScalePct, lnSpcR
 * Width used for wrap layout: the inner box width when wrapping, or unbounded for a
 * non-wrapping frame (`wrap:false`) so each paragraph lays out as a single line. A
 * non-wrapping frame's width constraint is enforced separately, against the widest
-* laid-out line — see {@link solveShrink}.
+* laid-out line (see {@link solveShrink}).
 */
 function layoutWidthPt(box) {
 	return box.wrap === false ? Infinity : box.innerWidthPt;
 }
 /**
-* Inner height (points) the text needs at full size — the value to bake into the
+* Inner height (points) the text needs at full size: the value to bake into the
 * shape's `a:ext/@cy` for `fit: 'resize'` (`spAutoFit`). Unlike shrink, resize has
 * **no safety net**: an under-estimate overflows (there is no text scaling
-* fallback), so this errs **tall** — width is inflated (earlier wrap ⇒ more lines)
+* fallback), so this errs **tall**. Width is inflated (earlier wrap ⇒ more lines)
 * and the laid-out height by the calibrated height factor, so the computed `cy` is
 * ≥ PowerPoint's and ≥ the LibreOffice-rendered height across the resize oracle.
 */
@@ -716,7 +714,7 @@ function solveResize(paragraphs, box, resolve) {
 * Width and height both re-measured per scale. Conservative: because the model
 * over-estimates, the returned scale is ≤ PowerPoint's and the text never overflows.
 *
-* `lnSpcReduction` is left at 0 — dropping `fontScale` alone is provably
+* `lnSpcReduction` is left at 0: dropping `fontScale` alone is provably
 * conservative (PowerPoint trades line-spacing reduction to keep the font *larger*,
 * so a reduction-free fit is always ≤ PowerPoint's scale). The reduction ramp
 * PowerPoint applies is recorded in `docs/contributing/design/text-fit.md`.
@@ -749,10 +747,9 @@ function solveShrink(paragraphs, box, resolve) {
 		}
 	};
 }
-//#endregion
-//#region src/measure/paragraphs.ts
+// src/measure/paragraphs.ts
 /**
-* ts-pptx: turning a slide text object into the simulator's inputs
+* pptx-ts: turning a slide text object into the simulator's inputs
 *
 * The lower half of the measured-fit pass: normalize a text object's runs into `FitParagraph`s,
 * resolve its body insets and box, and work out how a height change is shared between `off.y` and
@@ -785,9 +782,7 @@ function normalizeRuns(obj) {
 /** Build a measurable `FitParagraph[]` from a text object, or null if not measurable. */
 function extractParagraphs(obj) {
 	const opts = obj.options ?? {};
-	const runs = normalizeRuns(obj);
-	if (runs.length === 0) return null;
-	return buildFitParagraphs(runs, opts);
+	return buildFitParagraphs(normalizeRuns(obj), opts);
 }
 /**
 * Convert a run list (+ box-level default options) into a measurable
@@ -888,7 +883,7 @@ function resolveBodyInsetsEmu(opts) {
 /**
 * Resolve the inner box (shape minus insets) in points; null if degenerate.
 *
-* Reads the object's own `opts.w/h` with no ancestor walk — correct only because a group keeps an
+* Reads the object's own `opts.w/h` with no ancestor walk. That is correct only because a group keeps an
 * identity child coordinate space (`chOff/chExt == off/ext`, see the `gen/slide/object.ts` group renderer and
 * `docs/groups.md`), so a group never scales its children and a grouped text box's authored w/h is its
 * true rendered size. `applyMeasuredFit` reaches here for grouped text via its explicit group descent
@@ -919,10 +914,9 @@ function anchorTopShareOfDelta(opts) {
 	if (anchor === "b") return 1;
 	return .5;
 }
-//#endregion
-//#region src/gen/table/cell-inherit.ts
+// src/gen/table/cell-inherit.ts
 /**
-* ts-pptx: what a table cell inherits from its table.
+* pptx-ts: what a table cell inherits from its table.
 *
 * A cell that states nothing takes the table's value, and two paths resolve that: the emitter,
 * building the bag it hands to the text-body writer, and the measured-fit pass, building the
@@ -948,6 +942,7 @@ function anchorTopShareOfDelta(opts) {
 const CELL_INHERITED_TEXT_KEYS = [
 	"align",
 	"bold",
+	"breakLine",
 	"charSpacing",
 	"fontFace",
 	"fontSize",
@@ -957,25 +952,40 @@ const CELL_INHERITED_TEXT_KEYS = [
 	"margin",
 	"valign"
 ];
-/** The keys only the emitter inherits: they paint, or the fitter does not model them. */
+/**
+* The keys only the emitter inherits: they paint, or the fitter does not model them.
+*
+* `TableProps` takes every `TextBaseProps` key, and each of these writes on a cell. Eleven of them
+* used to be missing from both lists, so a table-level `highlight` or `bullet` was accepted and
+* wrote nothing, with no warning (#227).
+*/
 const CELL_INHERITED_EMIT_KEYS = [
 	"border",
+	"bullet",
+	"caps",
 	"color",
 	"fill",
+	"fontFaceEA",
+	"highlight",
+	"lang",
+	"paraIndent",
+	"paraMarginLeft",
+	"softBreakBefore",
+	"tabStops",
 	"textDirection",
+	"transparency",
 	"underline"
 ];
 /** Every key the emitter inherits from the table onto a cell. */
 const CELL_INHERITED_KEYS = [...CELL_INHERITED_TEXT_KEYS, ...CELL_INHERITED_EMIT_KEYS];
-//#endregion
-//#region src/measure/table-fit.ts
+// src/measure/table-fit.ts
 /**
-* ts-pptx: measuring a table's row heights and cell fits
+* pptx-ts: measuring a table's row heights and cell fits
 *
 * A table is measured cell by cell against its resolved grid: each cell inherits the table's text
 * options where it sets none, gets its own margins resolved to EMU insets, and is laid out inside
 * the column span it actually occupies. A merged region is measured once, at its origin, across
-* the columns it covers — which is what `walkTableGrid` exists to hand out.
+* the columns it covers, which is what `walkTableGrid` exists to hand out.
 */
 /**
 * Effective cell options: the cell's own values, with table-level values filled in where unset.
@@ -984,7 +994,7 @@ const CELL_INHERITED_KEYS = [...CELL_INHERITED_TEXT_KEYS, ...CELL_INHERITED_EMIT
 * emitter's list that decides how text lays out. This used to be its own list, claiming in its
 * docstring to mirror the emitter's while naming four keys the emitter did not.
 *
-* PowerPoint has no text-autofit for a table cell — `a:tcPr` carries no autofit, and the app
+* PowerPoint has no text-autofit for a table cell: `a:tcPr` carries no autofit, and the app
 * ignores a `normAutofit` inside one; rows auto-grow instead. So a cell's `fit: 'shrink'` is
 * honoured by baking a *reduced literal font size* onto its runs, which both PowerPoint and
 * LibreOffice render identically with no edit or resize. That is what makes these options worth
@@ -1034,7 +1044,7 @@ function scaleCellFontSizes(cell, eff, f) {
 * Resolve a table's grid the one way every consumer has to see it.
 *
 * Three sites derived these four things: `pptx.tableLayout()`, the export-time measured-fit
-* pass, and the table emitter (the height alone). They already disagreed — only the fit pass
+* pass, and the table emitter (the height alone). They already disagreed: only the fit pass
 * read `cy`, the EMU height the auto-pager and the fit pass itself stamp onto the options, so
 * `addTable(rows, { cy })` with no `h` gave a file whose rows are pinned and a
 * `pptx.tableLayout()` that reported every row auto-height. That is the same drift the one
@@ -1059,12 +1069,12 @@ function resolveTableGridEmu(rows, opts, presLayout) {
 	};
 }
 /**
-* Compute per-cell geometry (inches) for a table laid out at `opts.x`/`y`/`w` — the
-* engine behind `pptx.tableLayout()`. Column widths come from the same
+* Compute per-cell geometry (inches) for a table laid out at `opts.x`/`y`/`w`. This is
+* the engine behind `pptx.tableLayout()`. Column widths come from the same
 * {@link resolveTableColWidthsEmu} the writer uses, so cell x/width are exact. Row
 * heights are exact when pinned by `rowH` (array or scalar) or table `h`; otherwise
 * each auto-height row is estimated with the same conservative (tall) text model as
-* {@link measureText} and flagged `heightExact: false`. Single-slide only —
+* {@link measureText} and flagged `heightExact: false`. Single-slide only:
 * `autoPage` paging across slides is not modeled. Rowspan cells do not drive a row's
 * estimated height (mirrors `gen/table/autopage.ts`, which exempts them from line-height growth).
 */
@@ -1158,8 +1168,7 @@ function computeTableLayout(rows, opts, presLayout, registry) {
 		heightExact: rowExact.every(Boolean)
 	};
 }
-//#endregion
-//#region src/measure/fit.ts
+// src/measure/fit.ts
 /** Map the public {@link MeasureTextOptions} onto the internal run-option shape. */
 function measureOptsToRunOpts(opts) {
 	return pickDefined(opts, [
@@ -1201,7 +1210,7 @@ function formatCodepoints(cps) {
 	return all.length > shown.length ? `${shown.join(" ")} +${all.length - shown.length} more` : shown.join(" ");
 }
 /**
-* Layout-time text measurement against registered metrics — the public engine
+* Layout-time text measurement against registered metrics: the public engine
 * behind `pptx.measureText()`. Uses the **same** calibrated wrap model, resolver
 * semantics, and conservative safety factors as the export-time bake
 * (`applyMeasuredFit` / {@link solveResize} / {@link solveShrink}), so a
@@ -1218,7 +1227,7 @@ function formatCodepoints(cps) {
 * and is reported in `approximatedFaces`; an unnamed theme-default face returns
 * `measurable: false`. Code points a *registered* face has no glyph for are reported
 * in `uncoveredCodepoints`, and are the one case where the height may come back short
-* rather than tall — there is no font fallback here, only the font's `.notdef` advance.
+* rather than tall: there is no font fallback here, only the font's `.notdef` advance.
 */
 function measureText(registry, text, opts) {
 	const inset = opts.insetIn ?? 0;
@@ -1308,13 +1317,13 @@ function applyMeasuredFit(slides, registry) {
 	const collectUnmeasured = (paragraphs, into) => {
 		for (const para of paragraphs) for (const run of para.runs) if (!resolve(run)) into.add(run.fontFace ?? "(theme default)");
 	};
-	/** Audit every set of runs the pass is about to measure — see the warning below. */
+	/** Audit every set of runs the pass is about to measure (see the warning below). */
 	const auditCoverage = (paragraphs) => collectUncoveredCodepoints(paragraphs, registry, uncoveredByFace);
 	/**
 	* Bake measured shrink into a table's cells. Walks the cell grid (accounting for
 	* colspan/rowspan) to size each cell's box from its column widths and row heights,
 	* then lowers the run font sizes of any `fit:'shrink'` cell that overflows. Cells
-	* in auto-height rows (no fixed `rowH`/table `h`) are skipped — the row grows instead.
+	* in auto-height rows (no fixed `rowH`/table `h`) are skipped. The row grows instead.
 	*/
 	const measureTableCells = (tableObj, layout) => {
 		const rows = tableObj.arrTabRows;
@@ -1410,14 +1419,14 @@ function applyMeasuredFit(slides, registry) {
 			} else collectUnmeasured(paragraphs, unmeasuredResize);
 		}
 	};
-	for (const slide of slides) for (const obj of slide._slideObjects ?? []) measureObject(obj, slide._presLayout);
-	if (unmeasuredShrink.size > 0) warn("measure/shrink-unmeasured", `fit:'shrink' could not be measured for font(s) [${[...unmeasuredShrink].join(", ")}] — no registered metrics. Emitting bare <a:normAutofit/> (text will not pre-shrink in headless renders). Call pptx.registerFontMetrics(face, fontFilePathOrBytes) to enable measured fit.`);
-	if (unmeasuredResize.size > 0) warn("measure/resize-unmeasured", `fit:'resize' could not be measured for font(s) [${[...unmeasuredResize].join(", ")}] — no registered metrics. Emitting bare <a:spAutoFit/> with the authored height (box will not auto-grow in headless renders). Call pptx.registerFontMetrics(face, fontFilePathOrBytes) to enable measured fit.`);
+	for (const slide of slides) for (const obj of slide._slideObjects) measureObject(obj, slide._presLayout);
+	if (unmeasuredShrink.size > 0) warn("measure/shrink-unmeasured", `fit:'shrink' could not be measured for font(s) [${[...unmeasuredShrink].join(", ")}]: no registered metrics. Emitting bare <a:normAutofit/> (text will not pre-shrink in headless renders). Call pptx.registerFontMetrics(face, fontFilePathOrBytes) to enable measured fit.`);
+	if (unmeasuredResize.size > 0) warn("measure/resize-unmeasured", `fit:'resize' could not be measured for font(s) [${[...unmeasuredResize].join(", ")}]: no registered metrics. Emitting bare <a:spAutoFit/> with the authored height (box will not auto-grow in headless renders). Call pptx.registerFontMetrics(face, fontFilePathOrBytes) to enable measured fit.`);
 	if (uncoveredByFace.size > 0) {
 		const perFace = [...uncoveredByFace].map(([face, cps]) => `${face} → ${formatCodepoints(cps)}`).join("; ");
-		warn("measure/uncovered-codepoints", `Measured fit charged the .notdef advance for code point(s) the registered face does not cover (${perFace}) — PowerPoint renders those from a substituted font, so the measured width can be wrong in EITHER direction. Too narrow drops a line and the text overflows the baked size, the one case measured fit does not err safe. Register a face that covers them, or set an explicit fontFace on those runs.`);
+		warn("measure/uncovered-codepoints", `Measured fit charged the .notdef advance for code point(s) the registered face does not cover (${perFace}). PowerPoint renders those from a substituted font, so the measured width can be wrong in EITHER direction. Too narrow drops a line and the text overflows the baked size, the one case measured fit does not err safe. Register a face that covers them, or set an explicit fontFace on those runs.`);
 	}
-	if (heuristicFaces.size > 0) warn("measure/heuristic-metrics", `Note: measured fit used a conservative average-advance estimate for font(s) [${[...heuristicFaces].join(", ")}] — no exact metrics registered. Fit is approximate (may shrink/grow more than necessary). Call pptx.registerFontMetrics(face, fontFilePathOrBytes) for an exact fit.`);
+	if (heuristicFaces.size > 0) warn("measure/heuristic-metrics", `Note: measured fit used a conservative average-advance estimate for font(s) [${[...heuristicFaces].join(", ")}]: no exact metrics registered. Fit is approximate (may shrink/grow more than necessary). Call pptx.registerFontMetrics(face, fontFilePathOrBytes) for an exact fit.`);
 	return restore;
 }
 /**
@@ -1432,7 +1441,6 @@ function restorer(target, key) {
 		else delete target[key];
 	};
 }
-//#endregion
 export { getHeuristicFontMetrics as _, CELL_INHERITED_KEYS as a, isFontCollection as b, HEIGHT_SAFETY_FACTOR as c, WIDTH_SAFETY_FACTOR as d, measureHeightPt as f, FontMetricsRegistry as g, solveShrink as h, computeTableLayout as i, MIN_FONT_SCALE_PCT as l, solveResize as m, measureText as n, buildFitParagraphs as o, measureLayout as p, requireBoxHeight as r, FONT_SCALE_STEP_PCT as s, applyMeasuredFit as t, SINGLE_LINE_PITCH as u, makeRegistryResolver as v, listFontFaces as x, parseFontMetrics as y };
 
-//# sourceMappingURL=fit-Cb7naFj6.js.map
+//# sourceMappingURL=fit-Bpmzep6O.js.map