pptx-svelte-viewer 3.8.0 → 3.9.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-Bb6pIYyq.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-Cxn32Y3A.js";
 export {
   o as LOCALE_CATALOG,
   l as createTranslator,

package/dist/index.d.ts

@@ -2394,7 +2394,38 @@ interface PptxChartDataPointPicture {
 //#region src/core/types/chart-pivot-format.d.ts
 interface PptxChartPivotFormat {
   index: number;
+  /**
+   * Typed projection of `spPr` (fill/stroke colour, stroke width, dash
+   * style). When the parser is given a colour resolver (the normal case: the
+   * runtime always supplies one), both a literal `a:srgbClr` and an
+   * `a:schemeClr` theme reference (with its `lumMod`/`lumOff`/`tint`/`shade`
+   * modifiers) resolve to a hex colour here, the same theme +
+   * `c:clrMapOvr` chain the rest of chart parsing uses. Without a resolver
+   * (e.g. a hand-built `PptxChartPivotFormat` with no theme to resolve
+   * against), only the literal case resolves. Either way the authored node
+   * is byte-preserved through {@link shapePropertiesXml} until this field is
+   * set to something that no longer matches what re-parses off the current
+   * XML; setting it then re-derives `shapePropertiesXml` on save (merged
+   * onto whatever was already authored, keeping an unrelated schemeClr
+   * reference alive when the colour itself is unchanged) unless
+   * `shapePropertiesXml` is set explicitly, which wins.
+   */
+  shapeProperties?: PptxChartShapeProps;
+  /**
+   * Typed projection of `txPr`'s `a:p/a:pPr/a:defRPr` (size/bold/italic/
+   * colour/family), the same shape a legend entry or data-table's text
+   * override models. Colour resolution mirrors {@link shapeProperties}
+   * (theme-resolved `schemeClr` when a colour resolver is supplied, literal
+   * `srgbClr` otherwise). See {@link txPrXml} for the raw fallback.
+   */
+  textStyle?: PptxChartLegendTextStyle;
+  /**
+   * Typed projection of `marker` (symbol/size/spPr). See {@link markerXml}
+   * for the raw fallback.
+   */
+  marker?: PptxChartMarker;
   shapePropertiesXml?: XmlObject | null;
+  txPrXml?: XmlObject | null;
   markerXml?: XmlObject | null;
   dataLabelXml?: XmlObject | null;
   extensionListXml?: XmlObject | null;
@@ -2587,20 +2618,6 @@ interface PptxChartTitleRun {
 }
 //#endregion
 //#region src/core/types/chart-user-shapes.d.ts
-/**
- * Types for chart drawing-overlay shapes (`c:userShapes`).
- *
- * A chart's `c:userShapes` element carries an `r:id` that references a
- * separate drawing part (`ppt/drawings/drawingN.xml`) whose root is a
- * `c:userShapes` element populated with `cdr:relSizeAnchor` /
- * `cdr:absSizeAnchor` wrappers around `sp` / `pic` / `cxnSp` shapes drawn on
- * top of the chart plot. These interfaces describe the parsed, renderable
- * overlay model. The raw reference is preserved separately on
- * {@link PptxChartData.userShapesXml} for verbatim round-trip save; this model
- * is render-only.
- *
- * @module pptx-types/chart-user-shapes
- */
 /** A single paragraph of overlay-shape text with light formatting. */
 interface PptxChartUserShapeParagraph {
   /** Joined run text of the paragraph. */
@@ -2616,6 +2633,80 @@ interface PptxChartUserShapeParagraph {
   /** Paragraph alignment (`a:pPr/@algn`): left / centre / right. */
   align?: 'l' | 'ctr' | 'r';
 }
+/**
+ * The DrawingML 2D group transform (`a:xfrm` inside `cdr:grpSpPr`) that
+ * anchors a `grpSp`'s own box ({@link off}/{@link ext}) and establishes the
+ * coordinate space its children are expressed in ({@link chOff}/{@link
+ * chExt}), all in EMU. A child's position within the group is mapped into
+ * the group's own box via
+ * `frac = (child.off - chOff) / chExt`, then applied to the enclosing
+ * anchor's box; see `flattenChartUserShapes` in
+ * `chart-user-shapes-parser.ts`.
+ */
+interface PptxChartUserShapeGroupTransform {
+  /** The group's own position in its parent's coordinate space, in EMU. */
+  off: {
+    x: number;
+    y: number;
+  };
+  /** The group's own size in its parent's coordinate space, in EMU. */
+  ext: {
+    cx: number;
+    cy: number;
+  };
+  /** Origin of the child coordinate space (`a:chOff`), in EMU. */
+  chOff: {
+    x: number;
+    y: number;
+  };
+  /** Size of the child coordinate space (`a:chExt`), in EMU. */
+  chExt: {
+    cx: number;
+    cy: number;
+  };
+}
+/**
+ * One shape grouped inside a `cdr:grpSp` (or a nested `cdr:grpSp` itself).
+ * Unlike a top-level {@link PptxChartUserShape}, a group child has no
+ * drawing anchor of its own: its position is expressed in its parent
+ * group's child coordinate space via {@link off}/{@link ext} (EMU, read
+ * from the child's own `a:xfrm`), not as a chart-relative fraction.
+ */
+interface PptxChartUserShapeGroupChild {
+  /** Shape kind, same vocabulary as {@link PptxChartUserShape.kind}. */
+  kind: 'sp' | 'cxnSp' | 'pic' | 'grpSp' | 'graphicFrame';
+  /** Position within the parent group's child coordinate space, in EMU. */
+  off: {
+    x: number;
+    y: number;
+  };
+  /** Size within the parent group's child coordinate space, in EMU. */
+  ext: {
+    cx: number;
+    cy: number;
+  };
+  /** Preset geometry name (`a:prstGeom/@prst`), defaulting to `"rect"`. */
+  prst?: string;
+  /** Resolved solid-fill hex colour, when present. */
+  fill?: string;
+  /** Resolved line/stroke hex colour, when present. */
+  stroke?: string;
+  /** Line width in points (`a:ln/@w` divided by 12700), when present. */
+  strokeWidth?: number;
+  /** Text paragraphs of the shape's `txBody`, when present. */
+  paragraphs?: PptxChartUserShapeParagraph[];
+  /**
+   * Verbatim source XML of a `pic`/`graphicFrame` child, or of this node
+   * itself when `kind === 'grpSp'` and the nested group is untouched since
+   * parse. See {@link PptxChartUserShape.rawXml}'s doc for the same
+   * contract one level up.
+   */
+  rawXml?: XmlObject;
+  /** Present when `kind === 'grpSp'`: this nested group's own transform. */
+  transform?: PptxChartUserShapeGroupTransform;
+  /** Present when `kind === 'grpSp'`: this nested group's own children. */
+  children?: PptxChartUserShapeGroupChild[];
+}
 /**
  * A parsed chart-overlay shape positioned by a drawing anchor.
  *
@@ -2626,12 +2717,13 @@ interface PptxChartUserShapeParagraph {
 interface PptxChartUserShape {
   /**
    * Shape kind: text/preset shape, connector, picture, a group of the
-   * above (`grpSp`, flattened: each grouped child becomes its own entry
-   * reusing the anchor's own bounding box, an approximation since the
-   * group's internal chOff/chExt transform is not applied), or a bare
-   * placeholder for a `graphicFrame` anchor child (deep content such as a
-   * nested chart or table is out of scope; it only keeps the anchor's
-   * space accounted for instead of the whole overlay disappearing).
+   * above (`grpSp`, with its own {@link transform} and {@link children},
+   * nested arbitrarily; use `flattenChartUserShapes` from
+   * `chart-user-shapes-parser.ts` to get a flat, render-ready leaf list
+   * with the group transform already applied), or a bare placeholder for
+   * a `graphicFrame` anchor child (deep content such as a nested chart or
+   * table is out of scope; it only keeps the anchor's space accounted for
+   * instead of the whole overlay disappearing).
    */
   kind: 'sp' | 'cxnSp' | 'pic' | 'grpSp' | 'graphicFrame';
   /** Anchor kind that positioned the shape. */
@@ -2661,6 +2753,26 @@ interface PptxChartUserShape {
   strokeWidth?: number;
   /** Text paragraphs of the shape's `txBody`, when present. */
   paragraphs?: PptxChartUserShapeParagraph[];
+  /**
+   * Verbatim source XML of a `pic` or `graphicFrame` anchor child (the
+   * `cdr:pic` / `cdr:graphicFrame` node itself, not the enclosing anchor),
+   * or of the `cdr:grpSp` node itself when `kind === 'grpSp'` and the
+   * group is untouched since parse (byte-identical passthrough). None of
+   * these three kinds have a reconstructable typed representation that is
+   * guaranteed lossless (a picture's blip reference, a nested chart/table's
+   * graphic content, or a group's exact child ordering/ids), so the
+   * serializer re-emits this verbatim when present instead of a lossy
+   * rebuild. Editing a shape inside a group (via the SDK's path-based
+   * overlay operations) clears the group's `rawXml` so the serializer
+   * regenerates it from {@link transform}/{@link children} instead. Absent
+   * for `sp`/`cxnSp`, which round-trip losslessly through their typed
+   * fields above.
+   */
+  rawXml?: XmlObject;
+  /** Present when `kind === 'grpSp'`: the group's own transform. */
+  transform?: PptxChartUserShapeGroupTransform;
+  /** Present when `kind === 'grpSp'`: the grouped children, nested arbitrarily. */
+  children?: PptxChartUserShapeGroupChild[];
 }
 //#endregion
 //#region src/core/types/chart.d.ts
@@ -5813,6 +5925,21 @@ interface PptxAccessibilityProperties {
    */
   isDecorative?: boolean;
 }
+/**
+ * Accessibility description/title from `p:cNvPr/@descr` / `@title` on a
+ * plain shape, text box or connector (`p:sp` / `p:cxnSp`). The same pair of
+ * attributes already round-trips for a graphic frame (see
+ * {@link TablePptxElement.altText}) and, `descr` only, for a picture
+ * ({@link PptxImageProperties.altText}); this mixin extends it to the three
+ * element kinds whose PowerPoint Alt Text pane data was previously dropped
+ * on load because neither field existed on the model.
+ */
+interface PptxNonVisualDescription {
+  /** `p:cNvPr/@descr`. */
+  altText?: string;
+  /** `p:cNvPr/@title`. */
+  title?: string;
+}
 /**
  * `a:cNvPicPr/@preferRelativeResize` (issue G13), a picture-only non-visual
  * property distinct from `a:picLocks`.
@@ -5845,7 +5972,7 @@ interface PptxPictureNonVisualProperties {
  * // => satisfies TextPptxElement
  * ```
  */
-interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties {
+interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxNonVisualDescription {
   type: 'text';
 }
 /**
@@ -5863,7 +5990,7 @@ interface TextPptxElement extends PptxElementBase, PptxTextProperties, PptxShape
  * // => satisfies ShapePptxElement
  * ```
  */
-interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxCustomPathProperties, PptxAccessibilityProperties {
+interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxCustomPathProperties, PptxAccessibilityProperties, PptxNonVisualDescription {
   type: 'shape';
 }
 /**
@@ -5885,7 +6012,7 @@ interface ShapePptxElement extends PptxElementBase, PptxTextProperties, PptxShap
  * // => satisfies ConnectorPptxElement
  * ```
  */
-interface ConnectorPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties {
+interface ConnectorPptxElement extends PptxElementBase, PptxTextProperties, PptxShapeProperties, PptxNonVisualDescription {
   type: 'connector';
 }
 /**

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-yk0mo1AN.js";
-import { i as R } from "./translator-Bb6pIYyq.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-zAcr-4rr.js";
+import { i as R } from "./translator-Cxn32Y3A.js";
 import "./i18n.js";
 export {
   r as PPTX_OPEN_ACCEPT,