pptx-svelte-viewer 2.17.8 → 2.18.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-CZy5sxU0.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-CZ12ZvlE.js";
 export {
   o as LOCALE_CATALOG,
   l as createTranslator,

package/dist/index.d.ts

@@ -1639,7 +1639,28 @@ interface BulletInfo {
   autoNumType?: string;
   /** Auto-numbering start value. */
   autoNumStartAt?: number;
-  /** Zero-based paragraph index within the text body (for auto-numbering). */
+  /**
+   * Auto-numbering ORDINAL OFFSET: the zero-based distance of this paragraph
+   * within its own numbered list, such that
+   * `autoNumStartAt + paragraphIndex` is the ordinal to render. Despite the
+   * name it is NOT the paragraph's position in the text body; the two agree
+   * only for a list that starts at the first paragraph and is never
+   * interrupted.
+   *
+   * It has to be the offset rather than the raw position because every
+   * consumer that re-derives a marker from `BulletInfo` alone (the renderer's
+   * `resolveParagraphBullet`, the Markdown converter's `resolveListMarker`)
+   * computes `autoNumStartAt + paragraphIndex`. The load path resolves the
+   * real sequence itself, restarting the count after any paragraph that
+   * interrupts the list, and publishes the offset here so those consumers
+   * land on the same number. With the raw position they did not, and BOTH
+   * markers were painted ("3.1. Item"), because the paragraph builder drops
+   * the parsed marker segment only when the two strings agree.
+   *
+   * Runtime-only: derived at parse time and never serialized. OOXML has no
+   * counterpart (`a:buAutoNum` carries only `@type` and `@startAt`), so the
+   * writer neither reads nor emits it.
+   */
   paragraphIndex?: number;
   /** Bullet font family from `a:buFont`. */
   fontFamily?: string;
@@ -3934,6 +3955,11 @@ interface PptxTableCellStyle {
   italic?: boolean;
   underline?: boolean;
   color?: string;
+  /**
+   * Font family from the first run's `a:rPr/a:latin@typeface` (falling back to
+   * `a:ea` / `a:cs`). Per-run families live on {@link PptxTableCellTextRun}.
+   */
+  fontFamily?: string;
   /**
    * Raw XML colour-choice node preserved from `a:tc/a:txBody/.../a:rPr/a:solidFill`
    * for round-trip serialisation. Currently unused by the cell-level writer
@@ -4089,6 +4115,45 @@ interface PptxTableCell3D {
   /** Light rig direction (`a:lightRig@dir`, e.g. `tl`, `t`, `tr`). */
   lightRigDirection?: string;
 }
+/**
+ * One styled text run inside a table cell's `a:txBody`.
+ *
+ * `PptxTableCell.text` is a flat string and `PptxTableCell.style` describes
+ * only the FIRST run, so a cell mixing formats ("Revenue **grew 42%** last
+ * year") cannot be represented by those two alone. {@link PptxTableCell.runs}
+ * carries the full sequence, with paragraph and line breaks as marker entries
+ * so a renderer can walk it linearly.
+ *
+ * Structurally identical to `pptx-viewer-shared`'s `CellTextRun`, which every
+ * binding's table renderer already consumes.
+ *
+ * @example
+ * ```ts
+ * const runs: PptxTableCellTextRun[] = [
+ *   { text: "Revenue " },
+ *   { text: "grew 42%", bold: true, color: "#C00000" },
+ * ];
+ * // => satisfies PptxTableCellTextRun[]
+ * ```
+ */
+interface PptxTableCellTextRun {
+  /** Run text. Empty for the break markers below. */
+  text: string;
+  /** This entry starts a new paragraph (`a:p` boundary) rather than carrying text. */
+  isParagraphBreak?: boolean;
+  /** This entry is a soft line break (`a:br`) rather than carrying text. */
+  isLineBreak?: boolean;
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+  strikethrough?: boolean;
+  /** Resolved run colour as a CSS colour string. */
+  color?: string;
+  /** Run font size in points (`a:rPr@sz` / 100). */
+  fontSize?: number;
+  /** Run font family from `a:rPr/a:latin@typeface` (or `a:ea` / `a:cs`). */
+  fontFamily?: string;
+}
 /**
  * A single table cell with text content, optional style, and merge info.
  *
@@ -4105,6 +4170,15 @@ interface PptxTableCell3D {
 interface PptxTableCell {
   text: string;
   style?: PptxTableCellStyle;
+  /**
+   * Per-run formatting for the cell's text, when it has any beyond what
+   * {@link style} can express. Present only for cells whose `a:txBody`
+   * actually carries runs; renderers fall back to {@link text} when absent.
+   *
+   * Editing a cell's text invalidates these (the editor produces a plain
+   * string), so an edit path must clear them alongside setting `text`.
+   */
+  textRuns?: PptxTableCellTextRun[];
   /** Column span (defaults to 1). */
   gridSpan?: number;
   /** Row span (defaults to 1). */
@@ -4884,6 +4958,35 @@ interface UnknownPptxElement extends PptxElementBase {
 type PptxElement = TextPptxElement | ShapePptxElement | ConnectorPptxElement | ImagePptxElement | PicturePptxElement | TablePptxElement | ChartPptxElement | SmartArtPptxElement | OlePptxElement | MediaPptxElement | GroupPptxElement | InkPptxElement | ContentPartPptxElement | ZoomPptxElement | Model3DPptxElement | UnknownPptxElement;
 //#endregion
 //#region src/core/types/masters.d.ts
+/**
+ * A placeholder slot declared on a master or layout.
+ *
+ * The geometry fields are in CSS pixels (EMU / {@link EMU_PER_PX}) and are only
+ * present when the shape carried an explicit `a:xfrm`. Placeholders that
+ * inherit their frame from the master leave them undefined, so consumers that
+ * draw placeholder outlines (the layout gallery) must skip those entries
+ * rather than assume a zero-sized box at the origin.
+ *
+ * @example
+ * ```ts
+ * const frame: PptxPlaceholderFrame = { type: "body", idx: "1", x: 63, y: 130 };
+ * // => satisfies PptxPlaceholderFrame
+ * ```
+ */
+interface PptxPlaceholderFrame {
+  /** `p:ph/@type`, lower-cased by the parser; defaults to `body` when omitted. */
+  type: string;
+  /** `p:ph/@idx`, when present. */
+  idx?: string;
+  /** Left offset in CSS pixels, when the shape declares `a:off`. */
+  x?: number;
+  /** Top offset in CSS pixels, when the shape declares `a:off`. */
+  y?: number;
+  /** Width in CSS pixels, when the shape declares `a:ext`. */
+  width?: number;
+  /** Height in CSS pixels, when the shape declares `a:ext`. */
+  height?: number;
+}
 /**
  * Parsed notes master from `ppt/notesMasters/notesMaster1.xml`.
  *
@@ -4905,10 +5008,7 @@ interface PptxNotesMaster {
   /** Background image data URL. */
   backgroundImage?: string;
   /** Placeholder shapes found on the notes master. */
-  placeholders?: Array<{
-    type: string;
-    idx?: string;
-  }>;
+  placeholders?: PptxPlaceholderFrame[];
   /** Editable elements on the notes master (header, footer, date, page number, slide image, notes body). */
   elements?: PptxElement[];
   /** Header/footer flags from `<p:hf>` on the notes master (P-H3). */
@@ -4936,10 +5036,7 @@ interface PptxHandoutMaster {
   /** Background image data URL. */
   backgroundImage?: string;
   /** Placeholder shapes found on the handout master. */
-  placeholders?: Array<{
-    type: string;
-    idx?: string;
-  }>;
+  placeholders?: PptxPlaceholderFrame[];
   /** Editable elements on the handout master (header, footer, date, page number, slide placeholders). */
   elements?: PptxElement[];
   /** Number of slides per page for handout print layout (1, 2, 3, 4, 6, or 9). */
@@ -4977,10 +5074,7 @@ interface PptxSlideMaster {
   /** Layout paths associated with this master. */
   layoutPaths?: string[];
   /** Placeholder shapes on the master. */
-  placeholders?: Array<{
-    type: string;
-    idx?: string;
-  }>;
+  placeholders?: PptxPlaceholderFrame[];
   /** Parsed element shapes on the master slide (for master view rendering). */
   elements?: PptxElement[];
   /** Parsed slide layout objects associated with this master. */
@@ -5052,10 +5146,7 @@ interface PptxSlideLayout {
   /** Parsed element shapes on the layout. */
   elements?: PptxElement[];
   /** Placeholder shapes on the layout. */
-  placeholders?: Array<{
-    type: string;
-    idx?: string;
-  }>;
+  placeholders?: PptxPlaceholderFrame[];
   /** Matching name attribute for layout identification (`@matchingName`). */
   matchingName?: string;
   /** Whether the layout is marked as preserved (prevent deletion, `@preserve`). */
@@ -5069,6 +5160,42 @@ interface PptxSlideLayout {
   /** Header/footer flags from `<p:hf>` on this layout (P-H3). */
   headerFooter?: PptxHeaderFooterFlags;
 }
+/**
+ * Rendered content of a single layout, used to draw gallery thumbnails.
+ *
+ * Produced on demand rather than during load: materialising every layout's
+ * artwork (and decoding its images) up front costs a noticeable amount of time
+ * on decks with many masters, and most sessions never open the layout gallery
+ * at all.
+ *
+ * @example
+ * ```ts
+ * const preview: PptxLayoutPreview = {
+ *   path: "ppt/slideLayouts/slideLayout2.xml",
+ *   width: 960,
+ *   height: 540,
+ *   elements: [],
+ *   placeholders: [{ type: "title" }],
+ * };
+ * // => satisfies PptxLayoutPreview
+ * ```
+ */
+interface PptxLayoutPreview {
+  /** ZIP path of the layout this preview belongs to. */
+  path: string;
+  /** Slide width in CSS pixels, so a thumbnail can compute its own scale. */
+  width: number;
+  /** Slide height in CSS pixels. */
+  height: number;
+  /** Background resolved from the layout, falling back to its master's. */
+  backgroundColor?: string;
+  /** Background image data URL, when the layout or master declares one. */
+  backgroundImage?: string;
+  /** The layout's own artwork (pictures, shapes and static text). */
+  elements: PptxElement[];
+  /** Placeholder slots, drawn as outlined frames in the gallery. */
+  placeholders: PptxPlaceholderFrame[];
+}
 /**
  * A theme part available in the presentation package.
  *
@@ -7688,6 +7815,8 @@ interface IPptxHandlerRuntime {
   revokeBlobUrls(): void;
   getCompatibilityWarnings(): PptxCompatibilityWarning[];
   getLayoutOptions(): PptxLayoutOption[];
+  getLayoutPreview(layoutPath: string): Promise<PptxLayoutPreview | null>;
+  getLayoutPreviews(layoutPaths?: readonly string[]): Promise<PptxLayoutPreview[]>;
   createXmlBuilder(data: PptxData): PptxXmlBuilder;
   Builder(data: PptxData): PptxXmlBuilder;
   setTemplateBackground(path: string, backgroundColor: string | undefined): void;
@@ -7876,6 +8005,26 @@ declare class PptxHandlerCore {
    * @returns Array of {@link PptxLayoutOption} entries.
    */
   getLayoutOptions(): PptxLayoutOption[];
+  /**
+   * Build the artwork thumbnails backing the New Slide / Layout galleries.
+   *
+   * Parsing happens on first request and is memoised afterwards, so opening
+   * the gallery costs one pass over the layout parts and reopening it costs
+   * nothing. Callers that only need one entry should prefer
+   * {@link getLayoutPreview}.
+   *
+   * @param layoutPaths - Restrict the result to these layouts; defaults to
+   *   every layout in the presentation.
+   * @returns One {@link PptxLayoutPreview} per resolvable layout.
+   */
+  getLayoutPreviews(layoutPaths?: readonly string[]): Promise<PptxLayoutPreview[]>;
+  /**
+   * Build the artwork thumbnail for a single layout.
+   *
+   * @param layoutPath - Archive path of the `p:sldLayout` part.
+   * @returns The preview, or `null` when the presentation has no such layout.
+   */
+  getLayoutPreview(layoutPath: string): Promise<PptxLayoutPreview | null>;
   /**
    * Create a fluent XML builder scoped to the given presentation data.
    *

package/dist/index.js

@@ -1,5 +1,5 @@
-import { $ as e, G as o, H as a, J as t, K as i, Q as r, U as l, W as n, X as S, Y as m, Z as d, a as p, at as v, c as g, et as T, it as h, l as u, nt as k, o as D, ot as c, q as f, rt as x, s as A, t as C, tt as b } from "./export-DxMXX_It.js";
-import { i as V } from "./translator-CZy5sxU0.js";
+import { $ as e, G as o, H as a, J as t, K as i, Q as r, U as l, W as n, X as S, Y as m, Z as d, a as p, at as v, c as g, et as T, it as h, l as u, nt as k, o as D, ot as c, q as f, rt as x, s as A, t as C, tt as b } from "./export-DbSAFc8m.js";
+import { i as V } from "./translator-CZ12ZvlE.js";
 import "./i18n.js";
 export {
   C as PowerPointViewer,