pptx-svelte-viewer 3.2.2 → 3.3.0

package/dist/i18n.js

@@ -1,4 +1,4 @@
-import { a as s, c as e, i as t, n as r, o, r as n, s as i, t as l } from "./translator-Cvwv7iQG.js";
+import { a as s, c as e, i as t, n as r, o, r as n, s as i, t as l } from "./translator-i8zxb8S8.js";
 export {
   o as LOCALE_CATALOG,
   l as createTranslator,

package/dist/index.d.ts

@@ -221,6 +221,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
@@ -2162,13 +2168,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;
@@ -2394,6 +2419,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.
  *
@@ -2822,6 +2861,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;
@@ -3123,6 +3168,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`).
    *
@@ -3320,6 +3387,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;
@@ -3386,18 +3473,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;
@@ -3420,11 +3560,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;
@@ -3448,16 +3588,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.
    */
@@ -3467,24 +3607,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?: {
@@ -3526,7 +3666,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;
@@ -3538,12 +3678,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.
@@ -3613,7 +3753,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
@@ -7530,7 +7679,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;

package/dist/index.js

@@ -1,5 +1,5 @@
-import { $ as e, G as a, J as t, K as o, Q as i, W as r, X as n, Y as l, Z as S, a as d, at as m, c as p, ct as T, dt as v, et as P, ft as g, it as u, l as h, lt as c, mt as A, nt as C, o as N, ot as f, pt as k, q as D, rt as E, s as x, st as b, t as B, tt as I, u as O, ut as _ } from "./export-Cwm0F4Ug.js";
-import { i as R } from "./translator-Cvwv7iQG.js";
+import { $ as e, G as a, J as t, K as o, Q as i, W as r, X as n, Y as l, Z as S, a as d, at as m, c as p, ct as T, dt as v, et as P, ft as g, it as u, l as h, lt as c, mt as A, nt as C, o as N, ot as f, pt as k, q as D, rt as E, s as x, st as b, t as B, tt as I, u as O, ut as _ } from "./export-CL58Fm_4.js";
+import { i as R } from "./translator-i8zxb8S8.js";
 import "./i18n.js";
 export {
   r as PPTX_OPEN_ACCEPT,

package/dist/{translator-Cvwv7iQG.js → translator-i8zxb8S8.js}

@@ -3432,7 +3432,49 @@ Item 3`,
   "pptx.transitionPresets.pageCurlDouble": "Page Curl Double",
   "pptx.transitionPresets.pageCurlSingle": "Page Curl Single",
   "pptx.transitionPresets.airplane": "Airplane",
-  "pptx.transitionPresets.origami": "Origami"
+  "pptx.transitionPresets.origami": "Origami",
+  "pptx.readOnly.modifyVerifierRecommended": "This presentation is password-protected. Opened read-only until the password is provided.",
+  "pptx.readOnly.markedFinal": "This presentation was marked as final by its author. Opened read-only to discourage editing.",
+  "pptx.compatibility.generic": "This presentation contains a feature that may not be fully supported ({{code}}).",
+  "pptx.compatibility.unmodelledPresentationMarkup": "Some presentation-level settings are preserved but not editable in this viewer.",
+  "pptx.compatibility.unmodelledSlideMarkup": "Some slide-level settings are preserved but not editable in this viewer.",
+  "pptx.compatibility.unmodelledShapeProperty": "Some shape properties are preserved but not editable in this viewer.",
+  "pptx.compatibility.unmodelledTextBodyMarkup": "Some text formatting is preserved but not editable in this viewer.",
+  "pptx.compatibility.unmodelledBlipFillMarkup": "Some picture fill settings are preserved but not editable in this viewer.",
+  "pptx.compatibility.unmodelledImageEffect": "Some image effects are preserved but not rendered in this viewer.",
+  "pptx.compatibility.externalImageReference": "This presentation links to an image outside the file, which may not load for other people.",
+  "pptx.compatibility.slideSynchronizationMetadata": "This slide is linked to another presentation for synchronization; that link is preserved but not applied here.",
+  "pptx.compatibility.unsupportedAlternateContentChoice": "This presentation uses a newer PowerPoint feature; a compatible fallback was used instead.",
+  "pptx.compatibility.groupDepthExceeded": "A group of shapes is nested more deeply than this viewer supports and was flattened.",
+  "pptx.compatibility.saveNotesRelationshipMissing": "Speaker notes could not be linked to this slide when saving.",
+  "pptx.compatibility.saveNotesPartMissing": "Speaker notes could not be saved for this slide.",
+  "pptx.compatibility.saveNotesUpdateSkipped": "Changes to speaker notes were not saved for this slide.",
+  "pptx.compatibility.chartExternalDataWritebackUnsupported": "This chart uses external data that cannot be updated by this viewer.",
+  "pptx.compatibility.chartEmbeddedWorkbookMissing": "This chart's embedded data workbook is missing, so its data could not be saved.",
+  "pptx.compatibility.chartEmbeddedWorkbookUnreadable": "This chart's embedded data workbook could not be read, so its data could not be saved.",
+  "pptx.compatibility.chartEmbeddedWorkbookPartialWriteback": "Only some of this chart's data changes could be saved to its embedded workbook.",
+  "pptx.compatibility.saveImagePayloadUnsupported": "One image could not be saved in its original format and was skipped.",
+  "pptx.compatibility.saveMediaPayloadUnsupported": "One audio or video clip could not be saved in its original format and was skipped.",
+  "pptx.compatibility.saveElementSkipped": "One slide element could not be saved and was skipped.",
+  "pptx.compatibility.saveSignaturesStripped": "This presentation had digital signatures, which are removed once the file is edited and saved.",
+  "pptx.compatibility.saveGroupChildSkipped": "One shape inside a group could not be saved and was skipped.",
+  "pptx.compatibility.saveAnimationSoundPayloadUnsupported": "One animation sound could not be saved and was skipped.",
+  "pptx.compatibility.saveBackgroundImageUnsupported": "One slide background image could not be saved and was skipped.",
+  "pptx.compatibility.shapeIdDeduplicated": "Two shapes shared the same internal id; one was reassigned automatically.",
+  "pptx.compatibility.saveTransitionSoundPayloadUnsupported": "One slide transition sound could not be saved and was skipped.",
+  "pptx.compatibility.diagramRelationshipIdsIncomplete": "This SmartArt diagram is missing some internal references, so it may not display exactly as authored.",
+  "pptx.compatibility.exportBackendUnavailable": "Export to this format is not available in the current environment.",
+  "pptx.chart.bar3DShapeBox": "Box",
+  "pptx.chart.bar3DShapeCylinder": "Cylinder",
+  "pptx.chart.bar3DShapeFullPyramid": "Full Pyramid",
+  "pptx.chart.bar3DShapePartialPyramid": "Partial Pyramid",
+  "pptx.chart.bar3DShapeFullCone": "Full Cone",
+  "pptx.chart.bar3DShapePartialCone": "Partial Cone",
+  "pptx.chart.radarStyleStandard": "Standard",
+  "pptx.chart.radarStyleMarker": "Markers",
+  "pptx.chart.radarStyleFilled": "Filled",
+  "pptx.chart.wireframeOn": "Wireframe",
+  "pptx.chart.wireframeOff": "Solid"
 };
 function r(e) {
   return (e.split(".").pop() ?? e).replace(/(?<lower>[a-z])(?<upper>[A-Z])/gu, "$<lower> $<upper>").replace(/^./u, (t) => t.toUpperCase());
@@ -3459,14 +3501,14 @@ var x = [
     nativeLabel: "Deutsch"
   }
 ], a = /* @__PURE__ */ new Map([["en", n]]);
-function c(e, t) {
+function d(e, t) {
   const p = a.get(e);
   a.set(e, p ? {
     ...p,
     ...t
   } : { ...t });
 }
-function d() {
+function c() {
   return [...a.keys()];
 }
 function s(e, t) {
@@ -3485,8 +3527,8 @@ function m(e) {
 export {
   l as a,
   n as c,
-  c as i,
-  d as n,
+  d as i,
+  c as n,
   x as o,
   s as r,
   r as s,