pptx-angular-viewer 1.14.1 → 1.15.0

package/CHANGELOG.md

@@ -4,6 +4,8 @@ All notable changes to this project are documented here.
 This file is generated from [Conventional Commits](https://www.conventionalcommits.org)
 by [git-cliff](https://git-cliff.org); do not edit it by hand.
 
+## [1.14.1](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@1.14.1) - 2026-07-11
+
 ## [1.14.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@1.14.0) - 2026-07-11
 
 ### Other

package/fesm2022/pptx-angular-viewer.mjs

@@ -20766,6 +20766,51 @@ function defaultTextAdvancedState() {
         rtl: false,
     };
 }
+// ==========================================================================
+// Text wrap + autofit mode (standalone; not part of TextAdvancedState so
+// existing consumers of that interface are unaffected by this addition).
+// ==========================================================================
+/** Available text-wrap options (`a:bodyPr/@wrap`). */
+const TEXT_WRAP_OPTIONS = [
+    ['square', 'Wrap text in shape'],
+    ['none', "Don't wrap text"],
+];
+/**
+ * Available autofit-mode options. Per this codebase's {@link TextStyle.autoFitMode}
+ * mapping: `'shrink'` is `a:spAutoFit` (resize the shape to fit the text) and
+ * `'normal'` is `a:normAutofit` (shrink the text on overflow).
+ */
+const AUTOFIT_MODE_OPTIONS = [
+    ['none', 'Do not autofit'],
+    ['normal', 'Shrink text on overflow'],
+    ['shrink', 'Resize shape to fit text'],
+];
+/** Read the effective text-wrap mode, defaulting to `'square'` (wrap on). */
+function textWrapOf(el) {
+    if (!hasTextProperties(el)) {
+        return 'square';
+    }
+    return el.textStyle?.textWrap ?? 'square';
+}
+/** Read the effective autofit mode, defaulting to `'none'`. */
+function autoFitModeOf(el) {
+    if (!hasTextProperties(el)) {
+        return 'none';
+    }
+    return el.textStyle?.autoFitMode ?? 'none';
+}
+/** Patch to update the text-wrap mode, preserving the rest of `textStyle`. */
+function textWrapPatch(el, wrap) {
+    const base = hasTextProperties(el) ? (el.textStyle ?? {}) : {};
+    return { textStyle: { ...base, textWrap: wrap } };
+}
+/** Patch to update the autofit mode, preserving the rest of `textStyle`. */
+function autoFitModePatch(el, mode) {
+    const base = hasTextProperties(el) ? (el.textStyle ?? {}) : {};
+    return {
+        textStyle: { ...base, autoFitMode: mode, autoFit: mode !== 'none' },
+    };
+}
 
 /**
  * PPTX document-theme font + colour resolution helpers.
@@ -31881,6 +31926,155 @@ function sanitizeStops(raw) {
     return sortStops(mapped);
 }
 
+/**
+ * Pure (framework-agnostic) helpers for the image adjustments + crop inspector
+ * panel. Readers extract current values from a PptxElement (falling back to
+ * sensible defaults); patch-builders produce shallow-merge-ready
+ * `Partial<PptxElement>` objects safe to pass to each binding's element-update
+ * action. Mirrors the pattern used by `gradient-picker.ts` / `text-advanced.ts`.
+ *
+ * Scope: brightness/contrast/saturation (`PptxImageEffects`) and the four crop
+ * insets (`PptxImageProperties.cropLeft/Top/Right/Bottom`). Other image effects
+ * (duotone, artistic filters, alpha primitives) are out of scope for the
+ * inspector's "highest-traffic" surface; see `image-effects.ts` for the full
+ * read-side effect model.
+ */
+/** Read the current brightness/contrast/saturation off an element (0 when unset). */
+function imageAdjustmentsStateOf(el) {
+    const fx = isImageLikeElement(el) ? el.imageEffects : undefined;
+    return {
+        brightness: fx?.brightness ?? 0,
+        contrast: fx?.contrast ?? 0,
+        saturation: fx?.saturation ?? 0,
+    };
+}
+/**
+ * Build a Partial<PptxElement> that merges the given adjustment changes into
+ * the element's existing `imageEffects` without dropping other effect fields.
+ * No-op (returns `{}`) for non-image elements.
+ */
+function imageAdjustmentsPatch(el, changes) {
+    if (!isImageLikeElement(el)) {
+        return {};
+    }
+    return {
+        imageEffects: {
+            ...el.imageEffects,
+            ...changes,
+        },
+    };
+}
+/** Read the current crop insets off an element (0 on every edge when unset). */
+function imageCropStateOf(el) {
+    if (!isImageLikeElement(el)) {
+        return { cropLeft: 0, cropTop: 0, cropRight: 0, cropBottom: 0 };
+    }
+    return {
+        cropLeft: el.cropLeft ?? 0,
+        cropTop: el.cropTop ?? 0,
+        cropRight: el.cropRight ?? 0,
+        cropBottom: el.cropBottom ?? 0,
+    };
+}
+/** Clamp a crop fraction to the sane `[0, 0.9]` range (never crop past 90% of an edge). */
+function clampCropFraction(value) {
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.min(0.9, Math.max(0, value));
+}
+/**
+ * Build a Partial<PptxElement> that merges the given crop-inset changes onto
+ * the element. No-op (returns `{}`) for non-image elements.
+ */
+function imageCropPatch(el, changes) {
+    if (!isImageLikeElement(el)) {
+        return {};
+    }
+    const patch = {};
+    for (const [key, value] of Object.entries(changes)) {
+        if (value !== undefined) {
+            patch[key] = clampCropFraction(value);
+        }
+    }
+    return patch;
+}
+
+/**
+ * Pure (framework-agnostic) helpers for the table-level inspector panel
+ * (header row / banded rows toggles + a uniform default cell padding). Mirrors
+ * the reader + patch-builder pattern used by `gradient-picker.ts` /
+ * `text-advanced.ts` / `image-adjustments.ts`.
+ *
+ * Scope note: this binding has no per-cell selection model, so cell-level
+ * formatting (background/border for one specific cell) is out of scope here;
+ * `applyUniformCellPaddingPatch` instead writes the same margin onto every
+ * cell uniformly, which is the closest table-level equivalent.
+ */
+/** Read table-level flags off a table element (all false/0 for non-table elements). */
+function tableInspectorStateOf(el) {
+    if (el.type !== 'table' || !el.tableData) {
+        return { firstRowHeader: false, bandedRows: false, bandedColumns: false, cellPadding: 0 };
+    }
+    const data = el.tableData;
+    return {
+        firstRowHeader: data.firstRowHeader ?? false,
+        bandedRows: data.bandedRows ?? false,
+        bandedColumns: data.bandedColumns ?? false,
+        cellPadding: firstCellPadding(data),
+    };
+}
+function firstCellPadding(data) {
+    const firstCell = data.rows[0]?.cells[0];
+    return firstCell?.style?.marginLeft ?? 0;
+}
+/**
+ * Build a Partial<PptxElement> that merges the given flag changes into the
+ * element's existing `tableData`. No-op (returns `{}`) for non-table elements
+ * or a table with no parsed data.
+ */
+function tableInspectorPatch(el, changes) {
+    if (el.type !== 'table' || !el.tableData) {
+        return {};
+    }
+    return {
+        tableData: {
+            ...el.tableData,
+            ...changes,
+        },
+    };
+}
+/**
+ * Build a Partial<PptxElement> that sets the same left/right/top/bottom margin
+ * (in px) on every cell of every row, so the table gets uniform default
+ * padding. No-op (returns `{}`) for non-table elements or a table with no rows.
+ */
+function applyUniformCellPaddingPatch(el, padding) {
+    if (el.type !== 'table' || !el.tableData) {
+        return {};
+    }
+    const clamped = Math.max(0, Math.round(padding));
+    const rows = el.tableData.rows.map((row) => ({
+        ...row,
+        cells: row.cells.map((cell) => ({
+            ...cell,
+            style: {
+                ...cell.style,
+                marginLeft: clamped,
+                marginRight: clamped,
+                marginTop: clamped,
+                marginBottom: clamped,
+            },
+        })),
+    }));
+    return {
+        tableData: {
+            ...el.tableData,
+            rows,
+        },
+    };
+}
+
 /**
  * Pure, framework-agnostic comment-array transforms, shared by every binding.
  *
@@ -40044,6 +40238,7 @@ const translationsEn = {
     'pptx.table.bandRowCycle': 'Row band size',
     'pptx.table.cell': 'Cell R{{row}} C{{col}}',
     'pptx.table.cellBorders': 'Cell borders',
+    'pptx.table.cellPadding': 'Cell padding',
     'pptx.table.color': 'Text',
     'pptx.table.columnWidths': 'Column widths',
     'pptx.table.even': 'Even',
@@ -40585,6 +40780,9 @@ const translationsEn = {
     'pptx.ribbon.strokeWidth': 'Stroke width',
     'pptx.ribbon.browseThemes': 'Browse Themes',
     'pptx.ribbon.browseThemesTitle': 'Browse and apply built-in themes',
+    'pptx.ribbon.theme.default': 'Default',
+    'pptx.ribbon.theme.light': 'Light (Vermilion)',
+    'pptx.ribbon.theme.dark': 'Dark (Vermilion)',
     'pptx.ribbon.editTheme': 'Edit Theme',
     'pptx.ribbon.editThemeTitle': 'Edit theme - theme editor not yet ported',
     'pptx.ribbon.slideSize': 'Slide Size',
@@ -41337,6 +41535,10 @@ const translationsEn = {
     'pptx.text.characterSpacingTight': 'Tight',
     'pptx.text.characterSpacingVeryLoose': 'Very Loose',
     'pptx.text.characterSpacingVeryTight': 'Very Tight',
+    'pptx.textAdvanced.autoFit': 'AutoFit',
+    'pptx.textAdvanced.autoFitNone': 'Do not autofit',
+    'pptx.textAdvanced.autoFitResize': 'Resize shape to fit text',
+    'pptx.textAdvanced.autoFitShrink': 'Shrink text on overflow',
     'pptx.textAdvanced.autoPlaceholder': 'auto',
     'pptx.textAdvanced.indent': 'Indent',
     'pptx.textAdvanced.indentMargin': 'Indent & Margin',
@@ -41350,6 +41552,7 @@ const translationsEn = {
     'pptx.textAdvanced.spaceBefore': 'Space Before',
     'pptx.textAdvanced.spacing': 'Spacing',
     'pptx.textAdvanced.vAlign': 'V-Align',
+    'pptx.textAdvanced.wrapText': 'Wrap text in shape',
     'pptx.textFormatting.bulleted': 'Bulleted',
     'pptx.textFormatting.numbered': 'Numbered',
     'pptx.textFormatting.paragraphAfter': 'Paragraph After',