pptx-react-viewer 3.1.4 → 3.2.0

package/dist/{chunk-QOLYY7E3.mjs → chunk-RX6FE24O.mjs}

@@ -1,4 +1,4 @@
-import { ThemePresets, PptxMarkdownConverter } from './chunk-XIHK52SB.mjs';
+import { ThemePresets, PptxMarkdownConverter } from './chunk-G7UBIKAG.mjs';
 import { __export } from './chunk-XGB3TDIC.mjs';
 import * as mcp from 'pptx-viewer-mcp';
 import * as mcpSchemas from 'pptx-viewer-mcp/schemas';
@@ -16195,11 +16195,6 @@ function changeGhostStyle(change, phase, config2) {
 }
 init_chat_history_store();
 init_chat_history_store();
-function deckIdFromBridge(bridge) {
-  const meta3 = bridge.getDeckMeta();
-  const title = (meta3.title ?? "deck").trim().toLowerCase().replace(/\s+/gu, "-").slice(0, 60);
-  return `${title || "deck"}::${meta3.slideCount}`;
-}
 function isTextPart(part) {
   return part.type === "text";
 }
@@ -16240,6 +16235,12 @@ function toRenderableParts(message) {
   }
   return out;
 }
+init_chat_history_store();
+function deckIdFromBridge(bridge) {
+  const meta3 = bridge.getDeckMeta();
+  const title = (meta3.title ?? "deck").trim().toLowerCase().replace(/\s+/gu, "-").slice(0, 60);
+  return `${title || "deck"}::${meta3.slideCount}`;
+}
 function toolLabel(toolName) {
   if (!toolName) {
     return "Tool";

package/dist/{chunk-A2UAUSJM.mjs → chunk-UHR7EYFM.mjs}

@@ -1,6 +1,6 @@
-import { cloneHistorySnapshot, MIN_ELEMENT_SIZE, ZOOM_TO_SELECTION_PADDING, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, UNGROUPED_SECTION_ID, DEFAULT_SECTION_GROUP_ID, DEFAULT_TABLE_ROWS, DEFAULT_TABLE_COLUMNS, executeMediaCommand, buildPdfFromImageData, buildNotesPdf, GRID_SIZE, DEFAULT_TEXT_FONT_SIZE } from './chunk-BPWSJLLG.mjs';
-import { DEFAULT_VIEWER_OPTIONS, TOOLBAR_TABS, computeVirtualRange, DEFAULT_VIRTUAL_OVERSCAN, createPresenceProjector, BROADCAST_THROTTLE_MS, createSyncGate, clearLocalAwareness, validateRoomId, createDepartureChannel, resolveTransportForServerUrl, isMixedContentBlocked, CONNECTION_TIMEOUT_MS, registerCollaborationTeardown, sanitizeColor, cloneTemplateElementsBySlideId, cloneSlide, createWheelStepBuffer, createViewerZoomStore, clampZoomScale, mapEditingWheel, PresentationAnimationController, PRESENTATION_HASH, PRESENTATION_NONCE_KEY, PRESENTATION_CHANNEL_NAME, swapPresentationWindows, PRESENTATION_MESSAGE_ORIGIN, clearAudienceContent, buildPresentationAudienceUrl, resolveAudienceScreenPlacement, placeAudienceWindow, storeAudienceContent, isPresentationSessionMessage, endAudienceDisplay, createPresentationKeyBuffer, acceptsPresentationInput, resolveAutoAdvanceDelayMs, hasShowSlideAfter, nextShowSlideIndex, previousShowSlideIndex, createPresenterShowGuard, attachPresentationVisibilityPause, buildMorphTransitionPlan, morphOptionToMode, buildMorphAnimationRules, findInSlides, applyFindReplacements, createCollaborationLivePatcher, publishLiveInlineText, PptxHandler, collectMediaElements, collectImagePaths, collectTableCellImagePaths, applyTableCellImagePatches, collectTableStyleImagePaths, applyTableStyleImagePatches, partitionTemplateElements, resolveAuthoredCustomShowId, buildInitialGuides, EncryptedFileError, resolveAutosaveIntervalMs, shouldWriteAutosaveSnapshot, saveAutosaveSnapshot, autosaveSnapshotMark, updateMasterViewElement, isTemplateElementId, hasShapeProperties, hasTextProperties, getInlineEditorSelection, applyStyleToSelectedSegments, setPendingSelectionRestore, applyCaseTransformToSegments, transformTextCase, masterViewElements, replaceMasterViewElements, addSection, renameSection, deleteSection, moveSectionUp, moveSectionDown, moveSlidesToSection, normalizeColorsForCapture, preprocessCssForCapture, slideProgressPercent, slideStatusLabel, EXPORT_ASSEMBLING_PERCENT, EXPORT_DONE_PERCENT, isExportAbortError, recordProgressPercent, downloadBlob, resolveImageResolutionScale, applyThemeToData, THEME_PRESETS, themeColorSchemesEqual, comparePresentation, applyAcceptSlide, applyAcceptAllSlides, collectUsedFonts, describeFontEmbedding, isMobileViewport, mayLeaveSlideShow, stopAllPersistentAudio, remapTextToSegments, guidePxToEmu, buildSaveSlides, embeddedFontSaveOptions, resolveSlideSizeSelection, saveDeckWithPassword, shouldProbeAutosaveRecovery, probeAutosaveRecovery, acceptAutosaveRecovery, discardAutosaveRecovery, shouldLoopContinuously, applyRehearsalTimings, copyFormatFromElement, applyFormatToElement, mapEditorKey, isEditorTextInputTarget, createViewerOptionsStore, readSlidesFromYDoc, shouldRoomSlidesReplaceLoad, reconcileSlidesInYDoc, LOCAL_SYNC_ORIGIN, observeYDocSlides, shouldAutoFollowBroadcaster, detectTouchDevice, detectOrientation, deriveViewportBreakpoints, createTouchGestureRecognizer, MAX_ZOOM_SCALE, MIN_ZOOM_SCALE, isKeyboardOpen, scopeLayoutOptionsToSlide, openPptxFile, readBackstageRecentFile, isActionHidden, resolveInlineEditAutoFitHeight, canInteractWithElement, filterInteractableIds, beginShapeAdjustment, buildElementClipboardPayload, savedPresentationFileName, exportDeckJson, groupElements, generateElementId, makeCloneId, ungroupElements, alignElements, distributeElements, bringForward, sendBackward, bringToFront, sendToBack, newTableElement, createDefaultChartElement, readViewportMetrics, computeKeyboardInset, mergeShapes, mapPresentationKey, lastShowSlideIndex, firstShowSlideIndex, mapPresentationWheel, openPendingPrintWindow, computeColorFilter, filterHiddenSlideIndices, computeSlideIndices, buildPrintDocument, finishPrintWindow, buildPrintHtmlDocument, buildOutlineHtml, buildSlidesHtml, buildNotesHtml, buildHandoutsHtml, createBlankSlide, makeSlideId, buildSlideTemplateSlide, templateSchemeFromTheme, buildThemeColorMap, reResolveSlideColors, computeEntranceAnimationDelay, createPresentationSessionId, resolveTransitionDurationMs, runPresentationAction, createPresenterTimer, createInitialPresentationSnapshot, mergePresentationSnapshot, resetPresenterTimer, presenterElapsed, stepPresenterZoom, togglePresenterTimer, addCommentToList, removeCommentFromList, editCommentInList, toggleCommentResolvedInList, replyToCommentInList, canvasToJpegData, downloadDataUrl, pickSupportedMimeType, WEBM_MIME_CANDIDATES, fpsToFrameIntervalMs, segmentFrameCount, encodeGif, computeGridSpacingPx, resolveShowSlideIndexes, groupSlidesBySection, masterViewPseudoSlide, resolveHistoryDepth, hasCopyableFormat, createBackstagePresentation, buildFieldSubstitutionContext, cloneElementForPaste, computeScrollDelta, getPresetShapeClipPath, svgPathToPolygons, polygonsToSvgPath, rerouteConnectorsForMovedElements, applyReroutedConnectors, SvgExporter, deleteTableColumn, rebuildTableStructureInRawXml, insertTableColumn, deleteTableRow, insertTableRow, updateCellTextStyleInRawXml, setCellText, updateCellTextInRawXml, splitCell, updateMergeAttrsInRawXml, mergeCells, isPpactionUrl, parsePpactionUrl, resolvePresentationAction, ACTION_BUTTON_PRESETS, elementActionToPptxAction, isUrlSafe, buildSmartArtPresetData, classifyMediaType, computeSnapToShape, publishLiveGeometry, getDraggedShapeAdjustments, computeMarqueeHitIds, mergeAdditiveSelection, shouldConfirmExternalHyperlink, safeOpenUrl, applyResize, snapBoxToGrid, applyMotionPathPreset } from './chunk-XIHK52SB.mjs';
-import { translationsEn } from './chunk-ARJE3V6V.mjs';
+import { cloneHistorySnapshot, MIN_ELEMENT_SIZE, ZOOM_TO_SELECTION_PADDING, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, UNGROUPED_SECTION_ID, DEFAULT_SECTION_GROUP_ID, DEFAULT_TABLE_ROWS, DEFAULT_TABLE_COLUMNS, executeMediaCommand, buildPdfFromImageData, buildNotesPdf, GRID_SIZE, DEFAULT_TEXT_FONT_SIZE } from './chunk-FMEEIS6L.mjs';
+import { DEFAULT_VIEWER_OPTIONS, TOOLBAR_TABS, computeVirtualRange, DEFAULT_VIRTUAL_OVERSCAN, createPresenceProjector, BROADCAST_THROTTLE_MS, createSyncGate, clearLocalAwareness, validateRoomId, createDepartureChannel, resolveTransportForServerUrl, isMixedContentBlocked, CONNECTION_TIMEOUT_MS, registerCollaborationTeardown, sanitizeColor, cloneTemplateElementsBySlideId, cloneSlide, createWheelStepBuffer, createViewerZoomStore, clampZoomScale, mapEditingWheel, PresentationAnimationController, PRESENTATION_HASH, PRESENTATION_NONCE_KEY, PRESENTATION_CHANNEL_NAME, swapPresentationWindows, PRESENTATION_MESSAGE_ORIGIN, clearAudienceContent, buildPresentationAudienceUrl, resolveAudienceScreenPlacement, placeAudienceWindow, storeAudienceContent, isPresentationSessionMessage, endAudienceDisplay, createPresentationKeyBuffer, acceptsPresentationInput, resolveAutoAdvanceDelayMs, hasShowSlideAfter, nextShowSlideIndex, previousShowSlideIndex, createPresenterShowGuard, attachPresentationVisibilityPause, buildMorphTransitionPlan, morphOptionToMode, buildMorphAnimationRules, findInSlides, applyFindReplacements, createCollaborationLivePatcher, publishLiveInlineText, PptxHandler, collectMediaElements, collectImagePaths, collectTableCellImagePaths, applyTableCellImagePatches, collectTableStyleImagePaths, applyTableStyleImagePatches, partitionTemplateElements, resolveAuthoredCustomShowId, buildInitialGuides, EncryptedFileError, resolveAutosaveIntervalMs, shouldWriteAutosaveSnapshot, saveAutosaveSnapshot, autosaveSnapshotMark, updateMasterViewElement, isTemplateElementId, hasShapeProperties, hasTextProperties, getInlineEditorSelection, applyStyleToSelectedSegments, setPendingSelectionRestore, applyCaseTransformToSegments, transformTextCase, masterViewElements, replaceMasterViewElements, addSection, renameSection, deleteSection, moveSectionUp, moveSectionDown, moveSlidesToSection, normalizeColorsForCapture, preprocessCssForCapture, slideProgressPercent, slideStatusLabel, EXPORT_ASSEMBLING_PERCENT, EXPORT_DONE_PERCENT, isExportAbortError, recordProgressPercent, downloadBlob, resolveImageResolutionScale, applyThemeToData, THEME_PRESETS, themeColorSchemesEqual, comparePresentation, applyAcceptSlide, applyAcceptAllSlides, collectUsedFonts, describeFontEmbedding, isMobileViewport, mayLeaveSlideShow, stopAllPersistentAudio, remapTextToSegments, guidePxToEmu, buildSaveSlides, embeddedFontSaveOptions, resolveSlideSizeSelection, saveDeckWithPassword, shouldProbeAutosaveRecovery, probeAutosaveRecovery, acceptAutosaveRecovery, discardAutosaveRecovery, shouldLoopContinuously, applyRehearsalTimings, copyFormatFromElement, applyFormatToElement, collectReferencedFontFamilies, resolveGoogleWebfontHref, mapEditorKey, isEditorTextInputTarget, createViewerOptionsStore, readSlidesFromYDoc, shouldRoomSlidesReplaceLoad, reconcileSlidesInYDoc, LOCAL_SYNC_ORIGIN, observeYDocSlides, shouldAutoFollowBroadcaster, detectTouchDevice, detectOrientation, deriveViewportBreakpoints, createTouchGestureRecognizer, MAX_ZOOM_SCALE, MIN_ZOOM_SCALE, isKeyboardOpen, scopeLayoutOptionsToSlide, openPptxFile, readBackstageRecentFile, isActionHidden, resolveInlineEditAutoFitHeight, canInteractWithElement, filterInteractableIds, beginShapeAdjustment, buildElementClipboardPayload, savedPresentationFileName, exportDeckJson, groupElements, generateElementId, makeCloneId, ungroupElements, alignElements, distributeElements, bringForward, sendBackward, bringToFront, sendToBack, newTableElement, createDefaultChartElement, readViewportMetrics, computeKeyboardInset, mergeShapes, mapPresentationKey, lastShowSlideIndex, firstShowSlideIndex, mapPresentationWheel, openPendingPrintWindow, computeColorFilter, filterHiddenSlideIndices, computeSlideIndices, buildPrintDocument, finishPrintWindow, buildPrintHtmlDocument, buildOutlineHtml, buildSlidesHtml, buildNotesHtml, buildHandoutsHtml, createBlankSlide, makeSlideId, buildSlideTemplateSlide, templateSchemeFromTheme, buildThemeColorMap, reResolveSlideColors, computeEntranceAnimationDelay, createPresentationSessionId, resolveTransitionDurationMs, runPresentationAction, createPresenterTimer, createInitialPresentationSnapshot, mergePresentationSnapshot, resetPresenterTimer, presenterElapsed, stepPresenterZoom, togglePresenterTimer, addCommentToList, removeCommentFromList, editCommentInList, toggleCommentResolvedInList, replyToCommentInList, canvasToJpegData, downloadDataUrl, pickSupportedMimeType, WEBM_MIME_CANDIDATES, fpsToFrameIntervalMs, segmentFrameCount, encodeGif, computeGridSpacingPx, resolveShowSlideIndexes, groupSlidesBySection, masterViewPseudoSlide, resolveHistoryDepth, hasCopyableFormat, createBackstagePresentation, buildFieldSubstitutionContext, cloneElementForPaste, computeScrollDelta, getPresetShapeClipPath, svgPathToPolygons, polygonsToSvgPath, rerouteConnectorsForMovedElements, applyReroutedConnectors, SvgExporter, deleteTableColumn, rebuildTableStructureInRawXml, insertTableColumn, deleteTableRow, insertTableRow, updateCellTextStyleInRawXml, setCellText, updateCellTextInRawXml, splitCell, updateMergeAttrsInRawXml, mergeCells, isPpactionUrl, parsePpactionUrl, resolvePresentationAction, ACTION_BUTTON_PRESETS, elementActionToPptxAction, isUrlSafe, buildSmartArtPresetData, classifyMediaType, computeSnapToShape, publishLiveGeometry, getDraggedShapeAdjustments, computeMarqueeHitIds, mergeAdditiveSelection, shouldConfirmExternalHyperlink, safeOpenUrl, applyResize, snapBoxToGrid, applyMotionPathPreset } from './chunk-G7UBIKAG.mjs';
+import { translationsEn } from './chunk-RHSA5BW5.mjs';
 import { createContext, useRef, useState, useEffect, useCallback, useMemo, useLayoutEffect, useContext, useImperativeHandle, useSyncExternalStore } from 'react';
 import { useTranslation } from 'react-i18next';
 
@@ -9179,28 +9179,6 @@ function useIOHandlers(input) {
   });
   return { exportHandlers, printHandlers, themeHandlers, propertyHandlers };
 }
-var GOOGLE_FONTS_AVAILABLE = {
-  "Atkinson Hyperlegible": "Atkinson+Hyperlegible:wght@400;700",
-  Roboto: "Roboto:wght@400;700",
-  "Open Sans": "Open+Sans:wght@400;700",
-  Lato: "Lato:wght@400;700",
-  Montserrat: "Montserrat:wght@400;700",
-  Poppins: "Poppins:wght@400;700",
-  Raleway: "Raleway:wght@400;700",
-  Nunito: "Nunito:wght@400;700",
-  "Playfair Display": "Playfair+Display:wght@400;700",
-  "Source Sans Pro": "Source+Sans+Pro:wght@400;700",
-  "PT Sans": "PT+Sans:wght@400;700",
-  Merriweather: "Merriweather:wght@400;700",
-  Ubuntu: "Ubuntu:wght@400;700",
-  Oswald: "Oswald:wght@400;700",
-  "Noto Sans": "Noto+Sans:wght@400;700",
-  "Fira Sans": "Fira+Sans:wght@400;700",
-  Inter: "Inter:wght@400;700",
-  "Work Sans": "Work+Sans:wght@400;700",
-  Quicksand: "Quicksand:wght@400;700",
-  Cabin: "Cabin:wght@400;700"
-};
 var EMBEDDED_FONTS_STYLE_ID = "pptx-embedded-fonts";
 var GOOGLE_FONTS_LINK_ID = "pptx-google-fonts";
 var SYMBOL_FONTS_STYLE_ID = "pptx-symbol-font-fallback";
@@ -9211,21 +9189,6 @@ var SYMBOL_FONT_FAMILIES = [
   "Symbol",
   "Webdings"
 ];
-function collectReferencedFontFamilies(slides) {
-  const families = /* @__PURE__ */ new Set();
-  for (const slide of slides) {
-    for (const el of slide.elements) {
-      if (hasTextProperties(el) && el.textSegments) {
-        for (const seg of el.textSegments) {
-          if (seg.style.fontFamily) {
-            families.add(seg.style.fontFamily);
-          }
-        }
-      }
-    }
-  }
-  return families;
-}
 var FONT_NAME_UNSAFE_CHARS = /["\\\n\r;}<>]/u;
 var FONT_FORMAT_ALLOWED = /* @__PURE__ */ new Set([
   "truetype",
@@ -9286,31 +9249,29 @@ function useFontInjection({ embeddedFonts, slides }) {
   }, [embeddedFonts]);
   const referencedFamilies = useMemo(() => collectReferencedFontFamilies(slides), [slides]);
   useEffect(() => {
-    const embeddedFamilies = new Set(embeddedFonts.map((f) => f.name));
-    const googleFamilies = [];
-    for (const family of referencedFamilies) {
-      if (embeddedFamilies.has(family)) {
-        continue;
+    let cancelled = false;
+    void resolveGoogleWebfontHref(slides, embeddedFonts).then((href) => {
+      if (cancelled) {
+        return null;
       }
-      if (GOOGLE_FONTS_AVAILABLE[family]) {
-        googleFamilies.push(family);
+      if (!href || document.getElementById(GOOGLE_FONTS_LINK_ID)) {
+        return null;
       }
-    }
-    if (googleFamilies.length === 0) {
-      return;
-    }
-    const linkEl = document.createElement("link");
-    linkEl.id = GOOGLE_FONTS_LINK_ID;
-    linkEl.rel = "stylesheet";
-    linkEl.href = `https://fonts.googleapis.com/css2?${googleFamilies.map((f) => `family=${encodeURIComponent(GOOGLE_FONTS_AVAILABLE[f])}`).join("&")}&display=swap`;
-    document.head.appendChild(linkEl);
+      const linkEl = document.createElement("link");
+      linkEl.id = GOOGLE_FONTS_LINK_ID;
+      linkEl.rel = "stylesheet";
+      linkEl.href = href;
+      document.head.appendChild(linkEl);
+      return href;
+    });
     return () => {
+      cancelled = true;
       const existing = document.getElementById(GOOGLE_FONTS_LINK_ID);
       if (existing) {
         document.head.removeChild(existing);
       }
     };
-  }, [embeddedFonts, referencedFamilies]);
+  }, [embeddedFonts, slides]);
   useEffect(() => {
     const neededSymbolFonts = SYMBOL_FONT_FAMILIES.filter((f) => referencedFamilies.has(f));
     if (neededSymbolFonts.length === 0) {

package/dist/i18n.js

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkSWRY3SI5_js = require('./chunk-SWRY3SI5.js');
+var chunkALO4ZOHQ_js = require('./chunk-ALO4ZOHQ.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkSWRY3SI5_js.LOCALE_CATALOG; }
+  get: function () { return chunkALO4ZOHQ_js.LOCALE_CATALOG; }
 });
 Object.defineProperty(exports, "keyToLabel", {
   enumerable: true,
-  get: function () { return chunkSWRY3SI5_js.keyToLabel; }
+  get: function () { return chunkALO4ZOHQ_js.keyToLabel; }
 });
 Object.defineProperty(exports, "translationsEn", {
   enumerable: true,
-  get: function () { return chunkSWRY3SI5_js.translationsEn; }
+  get: function () { return chunkALO4ZOHQ_js.translationsEn; }
 });

package/dist/i18n.mjs

@@ -1,2 +1,2 @@
-export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-ARJE3V6V.mjs';
+export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-RHSA5BW5.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/index.d.ts

@@ -241,6 +241,12 @@ interface PptxShapeLocks {
    * `a:spLocks` / `a:picLocks` / `a:cxnSpLocks` / `a:grpSpLocks`.
    */
   noDrilldown?: boolean;
+  /**
+   * `a:picLocks/@noCrop`: forbids cropping the picture. Declared ONLY by
+   * `CT_PictureLocking`, so it is written for pictures (and media authored as
+   * a `p:pic`) and never onto the other lock elements.
+   */
+  noCrop?: boolean;
   /**
    * Text-box flag from `p:cNvSpPr/@txBox`. Not a lock in the strict sense,
    * but it lives on the same non-visual-properties node as `a:spLocks`, so
@@ -2182,13 +2188,32 @@ interface PlaceholderTextLevelStyle {
   bulletSizePercent?: number;
   /** Bullet colour from `a:buClr` as hex string. */
   bulletColor?: string;
+  /**
+   * The colour-choice node inside `a:buClr` this level's {@link bulletColor}
+   * resolved from (`a:schemeClr` / `a:sysClr` / `a:prstClr` / `a:srgbClr`,
+   * transforms included), mirroring `BulletInfo.colorXml`. Re-emitted
+   * verbatim on save so a themed bullet is not downgraded to a literal
+   * `a:srgbClr`. Absent when the level declares no bullet colour.
+   */
+  bulletColorXml?: XmlObject;
   /** Bullet size in points from `a:buSzPts`. */
   bulletSizePts?: number;
   /** True when `a:buNone` is present at this level. */
   bulletNone?: boolean;
   marginLeft?: number;
+  /** Paragraph right margin in px (from `@_marR` EMU). */
+  marginRight?: number;
   indent?: number;
+  /**
+   * Paragraph alignment as a `TextStyle['align']` token (`left`, `center`,
+   * `right`, `justify`, `justLow`, `dist`, `thaiDist`), never the raw OOXML
+   * `@algn` value.
+   */
   alignment?: string;
+  /** Right-to-left paragraph direction (`@rtl`). */
+  rtl?: boolean;
+  /** Tab stops from `a:tabLst/a:tab` (positions in px). */
+  tabStops?: TextStyle['tabStops'];
   lineSpacing?: number;
   lineSpacingExactPt?: number;
   spaceBefore?: number;
@@ -2414,6 +2439,20 @@ type PptxChartType = 'bar' | 'line' | 'pie' | 'ofPie' | 'doughnut' | 'area' | 's
  * ```
  */
 type PptxChartBarDirection = 'col' | 'bar';
+/**
+ * 3-D bar/column shape (OOXML `ST_Shape`, `c:bar3DChart/c:shape/@val` or a
+ * per-series `c:ser/c:shape` override). `coneToMax` / `pyramidToMax` scale
+ * the cone/pyramid so it reaches full height at the value axis maximum,
+ * appearing truncated below it; the plain `cone`/`pyramid` always come to a
+ * full point at the bar's own value.
+ *
+ * @example
+ * ```ts
+ * const shape: PptxBar3DShape = "cylinder";
+ * // => "cylinder", one of: "box" | "cone" | "coneToMax" | "cylinder" | "pyramid" | "pyramidToMax"
+ * ```
+ */
+type PptxBar3DShape = 'box' | 'cone' | 'coneToMax' | 'cylinder' | 'pyramid' | 'pyramidToMax';
 /**
  * Supported trendline regression types.
  *
@@ -2842,6 +2881,12 @@ interface PptxChartSeries {
    * series.
    */
   seriesChartType?: PptxChartType;
+  /**
+   * Per-series 3-D bar/column shape override (`c:ser/c:shape`), legal only
+   * inside a bar3D chart-type container. Overrides {@link PptxChartData.barShape}
+   * for this series alone.
+   */
+  shape?: PptxBar3DShape;
   boxWhiskerOptions?: PptxChartBoxWhiskerOptions;
   histogramOptions?: PptxChartHistogramOptions;
   waterfallOptions?: PptxChartWaterfallOptions;
@@ -3143,6 +3188,28 @@ interface PptxChartData {
    * default), so only horizontal bar charts need to carry the field.
    */
   barDirection?: PptxChartBarDirection;
+  /**
+   * 3-D bar/column shape (`c:bar3DChart/c:shape/@val`). Bar3D only; a plain
+   * bar chart has no `c:shape` element. A per-series `c:ser/c:shape`
+   * ({@link PptxChartSeries.shape}) overrides this for that series.
+   */
+  barShape?: PptxBar3DShape;
+  /**
+   * Radar chart drawing style (`c:radarChart/c:radarStyle/@val`). `standard`
+   * draws an outline only, `marker` adds markers at each vertex (PowerPoint's
+   * own default for every radar chart it authors), and `filled` paints the
+   * enclosed polygon with the series fill and omits markers. Radar only.
+   */
+  radarStyle?: 'standard' | 'marker' | 'filled';
+  /**
+   * Whether a surface chart renders as a wireframe grid rather than a solid
+   * coloured surface (`c:surfaceChart/c:wireframe/@val` or
+   * `c:surface3DChart/c:wireframe/@val`, both modeled as chart type
+   * `"surface"`). A `CT_Boolean` element: absent from the source XML
+   * defaults to `true` per schema, so `undefined` here means "not present in
+   * the source" and callers should treat it as `true`. Surface only.
+   */
+  wireframe?: boolean;
   /**
    * Scatter presentation mode (`c:scatterChart/c:scatterStyle/@val`).
    *
@@ -3340,6 +3407,26 @@ interface PptxBackgroundRemovalMark {
  * // => retains the middle of the image; the marks list stays empty
  * ```
  */
+/**
+ * Snapshot of the a14 Corrections / Color panel values as they were read from
+ * the file, kept on {@link PptxImageEffects.prerenderedCorrections} so a
+ * renderer can tell a baked-in value from one changed in this library.
+ */
+interface PptxImagePrerenderedCorrections {
+  sharpenSoften?: {
+    amount: number;
+  };
+  brightnessContrast?: {
+    bright?: number;
+    contrast?: number;
+  };
+  colorTemperature?: {
+    colorTemp: number;
+  };
+  colorSaturation?: {
+    sat: number;
+  };
+}
 interface PptxBackgroundRemoval {
   /** Top edge of the retained rectangle (0..1 fraction of the image height). */
   top: number;
@@ -3406,18 +3493,71 @@ interface PptxImageEffects {
    */
   backgroundRemoval?: PptxBackgroundRemoval;
   /**
-   * `a14:imgLayer/@r:embed` — relationship id of the PRISTINE original image
+   * `a14:imgLayer/@r:embed`: relationship id of the PRISTINE original image
    * the baked effects were derived from (PowerPoint stores it as an HD Photo
    * `.wdp` part, which browsers cannot decode).
    */
   originalImageRelId?: string;
+  /**
+   * PowerPoint 2010+ Corrections panel "Sharpen/Soften"
+   * (`a14:sharpenSoften/@amount`). Raw as the XML carries it: 1/1000ths of a
+   * percent, `-100000` (fully softened) .. `100000` (fully sharpened).
+   * Edit-time metadata like the artistic effects: PowerPoint bakes the result
+   * into the stored bitmap.
+   */
+  sharpenSoften?: {
+    amount: number;
+  };
+  /**
+   * PowerPoint 2010+ Corrections panel "Brightness/Contrast"
+   * (`a14:brightnessContrast/@bright`, `@contrast`). Raw 1/1000ths of a
+   * percent, `-100000` .. `100000`. Distinct from the legacy `a:blip/@bright`
+   * + `@contrast` pair in {@link PptxImageEffects.brightness} /
+   * {@link PptxImageEffects.contrast}, which PowerPoint 2007 wrote and which
+   * a renderer still applies.
+   */
+  brightnessContrast?: {
+    bright?: number;
+    contrast?: number;
+  };
+  /**
+   * PowerPoint 2010+ Color panel "Color Tone"
+   * (`a14:colorTemperature/@colorTemp`). Raw Kelvin value, `1500` .. `11500`;
+   * `6500` is neutral.
+   */
+  colorTemperature?: {
+    colorTemp: number;
+  };
+  /**
+   * PowerPoint 2010+ Color panel "Color Saturation" (`a14:saturation/@sat`).
+   * Raw 1/1000ths of a percent: `100000` is unchanged, `0` is grayscale,
+   * `400000` the maximum. Named `colorSaturation` because
+   * {@link PptxImageEffects.saturation} is the viewer-side -100..100 knob
+   * that has no OOXML counterpart.
+   */
+  colorSaturation?: {
+    sat: number;
+  };
+  /**
+   * The Corrections / Color panel values ALREADY baked into the image data,
+   * which a renderer must not apply a second time. The a14 counterpart of
+   * {@link PptxImageEffects.artisticPrerenderedEffect}: PowerPoint writes the
+   * corrected bitmap to the main `a:blip` and keeps the pristine original in
+   * `a14:imgLayer` (measured on a real deck: the stored PNG is a monotone tonal
+   * transform of the `.wdp` original, slope 0.7 for `contrast="-40000"`).
+   *
+   * Holds the VALUES rather than a boolean so that changing one of the four
+   * fields in this library's inspector still renders: a field that differs
+   * from its snapshot is applied, one that matches is skipped.
+   */
+  prerenderedCorrections?: PptxImagePrerenderedCorrections;
   /** Alpha modulation fixed: non-negative percentage (100 means unchanged opacity). */
   alphaModFix?: number;
   /** Original alpha modulation fixed node, including foreign attributes. */
   alphaModFixRawXml?: XmlObject;
-  /** Bi-level threshold — converts to 1-bit black/white (0-100). */
+  /** Bi-level threshold: converts to 1-bit black/white (0-100). */
   biLevel?: number;
-  /** Colour change — swap one colour range for another (used for transparency keying). */
+  /** Colour change: swap one colour range for another (used for transparency keying). */
   clrChange?: {
     clrFrom: string;
     clrTo: string;
@@ -3440,11 +3580,11 @@ interface PptxImageEffects {
     /** Original effect XML, including colour transforms and foreign attributes. */
     rawXml?: XmlObject;
   };
-  /** Alpha ceiling (`a:alphaCeiling`) — clamps any non-zero alpha to fully opaque. Boolean flag. */
+  /** Alpha ceiling (`a:alphaCeiling`): clamps any non-zero alpha to fully opaque. Boolean flag. */
   alphaCeiling?: boolean;
   /** Original alpha ceiling node, including foreign attributes. */
   alphaCeilingRawXml?: XmlObject;
-  /** Alpha floor (`a:alphaFloor`) — clamps any non-fully-opaque alpha to fully transparent. Boolean flag. */
+  /** Alpha floor (`a:alphaFloor`): clamps any non-fully-opaque alpha to fully transparent. Boolean flag. */
   alphaFloor?: boolean;
   /** Original alpha floor node, including foreign attributes. */
   alphaFloorRawXml?: XmlObject;
@@ -3468,16 +3608,16 @@ interface PptxImageEffects {
      */
     amt?: number;
   };
-  /** Alpha replace (`a:alphaRepl`) — replaces alpha with the given fixed-percent value (0..100). */
+  /** Alpha replace (`a:alphaRepl`): replaces alpha with the given fixed-percent value (0..100). */
   alphaRepl?: number;
   /** Original alpha replace node, including foreign attributes. */
   alphaReplRawXml?: XmlObject;
-  /** Alpha bi-level (`a:alphaBiLevel`) — threshold (0..100) above which alpha becomes fully opaque. */
+  /** Alpha bi-level (`a:alphaBiLevel`): threshold (0..100) above which alpha becomes fully opaque. */
   alphaBiLevel?: number;
   /** Original alpha bi-level node, including foreign attributes. */
   alphaBiLevelRawXml?: XmlObject;
   /**
-   * Colour replace (`a:clrRepl`) — replaces all colour information in an image
+   * Colour replace (`a:clrRepl`): replaces all colour information in an image
    * with the given solid colour. Stores the raw colour child to preserve scheme
    * colour references and modifiers.
    */
@@ -3487,24 +3627,24 @@ interface PptxImageEffects {
     /** Raw opaque colour XML for round-trip. */
     rawXml?: Record<string, unknown>;
   };
-  /** Luminance modulation (`a:lum`) — bright/contrast as fixed percentages (0..100). */
+  /** Luminance modulation (`a:lum`): bright/contrast as fixed percentages (0..100). */
   lum?: {
     bright?: number;
     contrast?: number;
   };
-  /** HSL modulation (`a:hsl`) — hue (0..360 degrees), saturation/luminance (-100..100). */
+  /** HSL modulation (`a:hsl`): hue (0..360 degrees), saturation/luminance (-100..100). */
   hsl?: {
     hue?: number;
     sat?: number;
     lum?: number;
   };
-  /** Image-effect tint (`a:tint` inside blip) — hue (0..360), amount (-100..100). */
+  /** Image-effect tint (`a:tint` inside blip): hue (0..360), amount (-100..100). */
   tint?: {
     hue?: number;
     amt?: number;
   };
   /**
-   * Fill overlay (`a:fillOverlay`) — overlays a fill on top of the blip.
+   * Fill overlay (`a:fillOverlay`): overlays a fill on top of the blip.
    * Stores blend mode and the raw inner fill XML for round-trip.
    */
   fillOverlay?: {
@@ -3546,7 +3686,7 @@ interface PptxImageEffects {
       background?: string;
     };
   };
-  /** Blur (`a:blur`) — radius in EMU and grow flag. */
+  /** Blur (`a:blur`): radius in EMU and grow flag. */
   blur?: {
     rad?: number;
     grow?: boolean;
@@ -3558,12 +3698,12 @@ interface PptxImageEffects {
  * @example
  * ```ts
  * const shape: PptxCropShape = "ellipse";
- * // => "ellipse" — one of: none | ellipse | roundedRect | triangle | diamond | pentagon | hexagon | star
+ * // => "ellipse": one of: none | ellipse | roundedRect | triangle | diamond | pentagon | hexagon | star
  * ```
  */
 type PptxCropShape = 'none' | 'ellipse' | 'roundedRect' | 'triangle' | 'diamond' | 'pentagon' | 'hexagon' | 'star';
 /**
- * Image content mixin — present on image and picture elements.
+ * Image content mixin: present on image and picture elements.
  *
  * Contains the decoded image data (base64 data URL or archive path),
  * alt text, crop insets, tiling settings, and image effects.
@@ -3633,7 +3773,16 @@ interface PptxImageProperties {
   dpi?: number;
   /** Image recolour/artistic effect properties. */
   imageEffects?: PptxImageEffects;
-  /** Crop-to-shape — CSS clip-path shape name. */
+  /**
+   * Crop-to-shape (CSS clip-path shape name).
+   *
+   * PowerPoint implements "Crop to Shape" by writing the picture's own
+   * `a:prstGeom`, so this is a typed view over `shapeType`: on load it is
+   * derived from the preset (`ellipse` -> `'ellipse'`, `roundRect` ->
+   * `'roundedRect'`, `star5` -> `'star'`, ...; see
+   * `utils/crop-shape-geometry`), and on save a changed value rewrites the
+   * preset. `'none'` / `undefined` leaves the geometry alone.
+   */
   cropShape?: PptxCropShape;
 }
 //#endregion
@@ -7550,7 +7699,11 @@ interface PptxSlide {
    */
   slideId?: string;
   sourceSlideId?: string;
-  /** Optional author-supplied slide name (set via `SlideBuilder.setName`). */
+  /**
+   * The slide name, `p:cSld/@name`: loaded from the part, written back on
+   * save (an empty string clears the attribute), and settable via
+   * `SlideBuilder.setName`.
+   */
   name?: string;
   layoutPath?: string;
   layoutName?: string;