pptx-svelte-viewer 2.13.2 → 2.15.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-DqUAMimH.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-CUlfH48o.js";
 export {
   o as LOCALE_CATALOG,
   l as createTranslator,

package/dist/index.d.ts

@@ -2154,6 +2154,17 @@ interface PptxChartUserShape {
  * ```
  */
 type PptxChartType = 'bar' | 'line' | 'pie' | 'ofPie' | 'doughnut' | 'area' | 'scatter' | 'bubble' | 'radar' | 'stock' | 'bar3D' | 'line3D' | 'pie3D' | 'area3D' | 'surface' | 'histogram' | 'waterfall' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap' | 'combo' | 'unknown';
+/**
+ * Bar series direction (OOXML `ST_BarDir`): `"col"` is a vertical column
+ * chart, `"bar"` a horizontal bar chart.
+ *
+ * @example
+ * ```ts
+ * const dir: PptxChartBarDirection = "col";
+ * // => "col" - one of: "col" | "bar"
+ * ```
+ */
+type PptxChartBarDirection = 'col' | 'bar';
 /**
  * Supported trendline regression types.
  *
@@ -2813,6 +2824,12 @@ interface PptxChartData {
    * (`c:holeSize/@val`, 10 through 90). Absent uses the renderer default.
    */
   doughnutHoleSize?: number;
+  /**
+   * Bar series direction (`c:barDir/@val`): `"col"` draws vertical columns,
+   * `"bar"` draws horizontal bars. Absent means `"col"` (PowerPoint's own
+   * default), so only horizontal bar charts need to carry the field.
+   */
+  barDirection?: PptxChartBarDirection;
   /**
    * Bar/column gap between category clusters as a percentage of bar width
    * (`c:gapWidth/@val`, 0 through 500). Absent uses the renderer default.
@@ -5177,7 +5194,12 @@ interface PptxNativeAnimation {
   motionPath?: string;
   /** Motion origin: "layout" or "parent". */
   motionOrigin?: string;
-  /** Whether the element auto-rotates to follow the motion path tangent (`p:animMotion/@rAng` = "0"). */
+  /**
+   * Whether the element auto-rotates to follow the motion path tangent.
+   * Viewer-authoring-only hint: OOXML has no such flag (`p:animMotion/@rAng`
+   * is a plain rotation angle that PowerPoint writes as "0" on every path),
+   * so the parser never sets this.
+   */
   motionPathRotateAuto?: boolean;
   /** Path edit mode from `p:animMotion/@pathEditMode` (e.g. "relative", "fixed"). */
   motionPathEditMode?: string;
@@ -7092,6 +7114,8 @@ interface ChartInput {
   hasLegend?: boolean;
   legendPosition?: 't' | 'b' | 'l' | 'r' | 'tr';
   grouping?: 'clustered' | 'stacked' | 'percentStacked';
+  /** Bar series direction (`c:barDir`): vertical columns (default) or horizontal bars. */
+  barDirection?: 'col' | 'bar';
 }
 interface ChartOptions extends Partial<ElementPosition> {}
 interface ConnectorOptions extends Partial<ElementPosition> {
@@ -8252,6 +8276,24 @@ declare class PptxHandler extends PptxHandlerCore {
    * ```
    */
   static create(options?: PresentationOptions): Promise<PresentationBuilderResult>;
+  /**
+   * Parse a presentation from an `ArrayBuffer`, accepting both `.pptx`
+   * archives and portable `pptx-viewer-json` documents.
+   *
+   * The buffer is sniffed first: JSON documents (leading `{` plus the
+   * `"pptx-viewer-json"` format marker) are routed to {@link loadFromJson};
+   * everything else goes through the regular ZIP/OLE2 pipeline.
+   */
+  load(data: ArrayBuffer, options?: PptxHandlerLoadOptions): Promise<PptxData>;
+  /**
+   * Load a presentation from `pptx-viewer-json` text.
+   *
+   * A minimal blank package is generated and loaded first so that the
+   * handler keeps a valid in-memory archive (editing and {@link save} keep
+   * working), then the imported model is overlaid on top: imported
+   * presentation fields win, and the slide array is replaced wholesale.
+   */
+  loadFromJson(text: string, options?: PptxHandlerLoadOptions): Promise<PptxData>;
 }
 //#endregion
 //#region src/converter/SvgExporter.d.ts
@@ -8591,6 +8633,64 @@ interface ViewerFontSource {
   weight?: string | number;
   style?: 'normal' | 'italic';
 }
+//#endregion
+//#region src/render/session-restore.d.ts
+/**
+ * session-restore: keep the deck a host app has open across a page refresh.
+ *
+ * A host (the demo apps, or any embedder) owns the bytes it hands to the
+ * viewer, so a plain reload drops them and the user lands back on the file
+ * dropzone with their presentation gone. This store remembers the open deck in
+ * IndexedDB and hands it back on the next load.
+ *
+ * Scope is deliberately per-tab: the record is keyed by an id kept in
+ * `sessionStorage`, which survives a reload but NOT a new tab. Refreshing
+ * restores the deck this tab had open, while a second tab opened on the same
+ * origin still starts on the landing page, and two tabs holding different decks
+ * never steal each other's content.
+ *
+ * `restoreSessionDeck` additionally prefers a NEWER autosave snapshot for the
+ * same file (see `./autosave-store`), so a refresh mid-edit comes back with the
+ * edited deck rather than the pristine bytes that were first opened.
+ *
+ * Every operation is best-effort: a blocked IndexedDB, a partitioned
+ * `sessionStorage`, or an exhausted quota degrades to "no restore", never to a
+ * thrown error in the host.
+ */
+/** A deck remembered for the current tab. */
+interface SessionDeck {
+  /** File name the deck was opened under, used as the autosave key. */
+  fileName: string;
+  /** The presentation bytes. */
+  data: Uint8Array;
+  /** When these bytes were remembered (epoch ms). */
+  timestamp: number;
+}
+/**
+ * This tab's session id, or `null` when `sessionStorage` is unavailable (a
+ * sandboxed iframe, or a browser with storage disabled).
+ *
+ * @param create Mint and persist an id when the tab does not have one yet.
+ *   Reads pass `false` so a fresh tab never claims another tab's record.
+ */
+declare function getSessionTabId(create?: boolean): string | null;
+/**
+ * Remember `data` as the deck this tab has open, so the next load can restore
+ * it. Resolves `false` when the browser refused to store it; callers treat that
+ * as "no restore available later", never as an error.
+ */
+declare function rememberSessionDeck(fileName: string, data: Uint8Array): Promise<boolean>;
+/** The deck remembered for this tab, or `null` when there is nothing to restore. */
+declare function loadSessionDeck(): Promise<SessionDeck | null>;
+/** Forget this tab's deck (the host closed it, or handed the tab to another flow). */
+declare function forgetSessionDeck(): Promise<void>;
+/**
+ * The deck to reopen on load: this tab's remembered bytes, upgraded to a newer
+ * autosave snapshot of the same file when the viewer wrote one after they were
+ * remembered. Without that upgrade a refresh mid-edit would silently roll the
+ * presentation back to the state it was opened in.
+ */
+declare function restoreSessionDeck(): Promise<SessionDeck | null>;
 declare function parsePresentationSessionId(hash: string): string | null;
 declare function loadPresentationDeck(sessionId: string): Promise<Uint8Array | null>;
 interface AutosaveRecord {
@@ -8716,7 +8816,7 @@ type PptxAiUIMessage = UIMessage;
  * live deck); the viewer-only tools (navigation, deck outline, element/notes
  * readers, table merge) have no MCP counterpart.
  */
-type PptxAiToolName = 'get_deck_overview' | 'get_slide' | 'get_element' | 'get_speaker_notes' | 'find_text' | 'get_theme' | 'go_to_slide' | 'select_elements' | 'merge_tables' | 'get_metadata' | 'get_layouts' | 'find_placeholders' | 'get_presentation_properties' | 'run_accessibility_check' | 'convert_to_markdown' | 'add_element' | 'update_element' | 'delete_elements' | 'arrange_elements' | 'clone_element' | 'set_element_animation' | 'group_elements' | 'ungroup_elements' | 'batch_update_elements' | 'update_element_style' | 'replace_geometry' | 'set_element_lock' | 'manage_hyperlinks' | 'replace_text' | 'manage_comments' | 'update_table_cells' | 'manage_table_structure' | 'create_chart' | 'update_chart' | 'add_chart_series' | 'remove_chart_series' | 'update_chart_series_data' | 'manage_smart_art' | 'apply_template' | 'add_slide' | 'duplicate_slide' | 'delete_slides' | 'reorder_slides' | 'update_slide_properties' | 'set_slide_transition' | 'apply_theme_preset' | 'update_theme_colors' | 'update_theme_fonts' | 'set_canvas_size' | 'update_metadata' | 'manage_sections' | 'update_presentation_properties' | 'apply_layout';
+type PptxAiToolName = 'get_deck_overview' | 'get_slide' | 'get_element' | 'get_speaker_notes' | 'find_text' | 'get_theme' | 'go_to_slide' | 'select_elements' | 'merge_tables' | 'get_metadata' | 'get_layouts' | 'find_placeholders' | 'get_presentation_properties' | 'run_accessibility_check' | 'convert_to_markdown' | 'export_to_json' | 'add_element' | 'update_element' | 'delete_elements' | 'arrange_elements' | 'clone_element' | 'set_element_animation' | 'group_elements' | 'ungroup_elements' | 'batch_update_elements' | 'update_element_style' | 'replace_geometry' | 'set_element_lock' | 'manage_hyperlinks' | 'replace_text' | 'manage_comments' | 'update_table_cells' | 'manage_table_structure' | 'create_chart' | 'update_chart' | 'add_chart_series' | 'remove_chart_series' | 'update_chart_series_data' | 'manage_smart_art' | 'apply_template' | 'add_slide' | 'duplicate_slide' | 'delete_slides' | 'reorder_slides' | 'update_slide_properties' | 'set_slide_transition' | 'apply_theme_preset' | 'update_theme_colors' | 'update_theme_fonts' | 'set_canvas_size' | 'update_metadata' | 'manage_sections' | 'update_presentation_properties' | 'import_from_json' | 'apply_layout';
 type Resolvable<T> = T | (() => T | Promise<T>);
 /** How the assistant reaches a language model. */
 type PptxAiConnection =
@@ -9339,5 +9439,5 @@ declare const PowerPointViewer: Component<PowerPointViewerProps, PowerPointViewe
  */
 type AutosaveStatus = 'idle' | 'disabled' | 'saving' | 'saved' | 'error';
 
-export { PowerPointViewer, defaultCssVars, defaultRadius, defaultThemeColors, deleteAutosaveSnapshot, exportAllSlidesToSvg, exportAllSlidesToSvgBlobs, exportSlideAsSvg, exportSlideToSvg, exportSlideToSvgBlob, getAutosaveSnapshot, listAutosaveSnapshots, loadPresentationDeck, parsePresentationSessionId, registerTranslations, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius };
-export type { AutosaveRecord, AutosaveStatus, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationTransport, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, PowerPointViewerApi, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiUIMessage, PptxAiWritePolicy, PrintOptions, SvgExportAllOptions, SvgExportSingleSlideOptions, TranslationDictionary, Translator, ViewerLoadDetail, ViewerTheme, ViewerThemeColors };
+export { PowerPointViewer, defaultCssVars, defaultRadius, defaultThemeColors, deleteAutosaveSnapshot, exportAllSlidesToSvg, exportAllSlidesToSvgBlobs, exportSlideAsSvg, exportSlideToSvg, exportSlideToSvgBlob, forgetSessionDeck, getAutosaveSnapshot, getSessionTabId, listAutosaveSnapshots, loadPresentationDeck, loadSessionDeck, parsePresentationSessionId, registerTranslations, rememberSessionDeck, restoreSessionDeck, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius };
+export type { AutosaveRecord, AutosaveStatus, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationTransport, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, PowerPointViewerApi, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiUIMessage, PptxAiWritePolicy, PrintOptions, SessionDeck, SvgExportAllOptions, SvgExportSingleSlideOptions, TranslationDictionary, Translator, ViewerLoadDetail, ViewerTheme, ViewerThemeColors };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,GACX,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,iBAAiB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,EACN,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EACN,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,2BAA2B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,GACX,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,iBAAiB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,OAAO,EACN,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAItF,OAAO,EACN,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACN,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GACf,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -1,26 +1,31 @@
-import { B as e, G as a, H as o, J as t, K as i, Q as r, U as l, V as n, W as m, X as S, Y as d, Z as p, a as v, c as g, l as h, o as T, q as u, s as x, t as A, z as f } from "./export-Oh-2dcFv.js";
-import { i as P } from "./translator-DqUAMimH.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-CC1FYy31.js";
+import { i as V } from "./translator-CUlfH48o.js";
 import "./i18n.js";
 export {
-  A as PowerPointViewer,
-  f as defaultCssVars,
-  e as defaultRadius,
+  C as PowerPointViewer,
+  a as defaultCssVars,
+  l as defaultRadius,
   n as defaultThemeColors,
   o as deleteAutosaveSnapshot,
-  v as exportAllSlidesToSvg,
-  T as exportAllSlidesToSvgBlobs,
-  x as exportSlideAsSvg,
+  p as exportAllSlidesToSvg,
+  D as exportAllSlidesToSvgBlobs,
+  A as exportSlideAsSvg,
   g as exportSlideToSvg,
-  h as exportSlideToSvgBlob,
-  l as getAutosaveSnapshot,
+  u as exportSlideToSvgBlob,
+  i as forgetSessionDeck,
+  f as getAutosaveSnapshot,
+  t as getSessionTabId,
   m as listAutosaveSnapshots,
-  a as loadPresentationDeck,
-  i as parsePresentationSessionId,
-  P as registerTranslations,
-  u as themeToCssVars,
-  t as vermilionDarkColors,
-  d as vermilionDarkTheme,
-  S as vermilionLightColors,
-  p as vermilionLightTheme,
-  r as vermilionRadius
+  S as loadPresentationDeck,
+  d as loadSessionDeck,
+  r as parsePresentationSessionId,
+  V as registerTranslations,
+  e as rememberSessionDeck,
+  T as restoreSessionDeck,
+  b as themeToCssVars,
+  k as vermilionDarkColors,
+  x as vermilionDarkTheme,
+  h as vermilionLightColors,
+  v as vermilionLightTheme,
+  c as vermilionRadius
 };