pptx-react-viewer 2.13.2 → 2.14.0

package/dist/viewer/index.d.ts

@@ -2157,6 +2157,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.
  *
@@ -2816,6 +2827,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.
@@ -5180,7 +5197,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;
@@ -7095,6 +7117,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> {
@@ -8255,6 +8279,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>;
 }
 
 //#region src/theme/types.d.ts
@@ -8772,7 +8814,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 =

package/dist/viewer/index.js

@@ -1,76 +1,76 @@
 'use strict';
 
-var chunkEUQ2IER3_js = require('../chunk-EUQ2IER3.js');
-require('../chunk-VY3KLDJF.js');
-var chunkBNSCH4WT_js = require('../chunk-BNSCH4WT.js');
-var chunkDOS7NY7C_js = require('../chunk-DOS7NY7C.js');
-require('../chunk-BXAK3JFM.js');
-var chunkFDR5W67L_js = require('../chunk-FDR5W67L.js');
+var chunkHOIF5RQI_js = require('../chunk-HOIF5RQI.js');
+require('../chunk-QVQDC7HZ.js');
+var chunk7TEZJZ2O_js = require('../chunk-7TEZJZ2O.js');
+var chunkSMECSYCT_js = require('../chunk-SMECSYCT.js');
+require('../chunk-3ISYPBSX.js');
+var chunkPB7KVDNV_js = require('../chunk-PB7KVDNV.js');
 require('../chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "CollaborationProvider", {
   enumerable: true,
-  get: function () { return chunkEUQ2IER3_js.CollaborationProvider; }
+  get: function () { return chunkHOIF5RQI_js.CollaborationProvider; }
 });
 Object.defineProperty(exports, "CollaborationStatusIndicator", {
   enumerable: true,
-  get: function () { return chunkEUQ2IER3_js.CollaborationStatusIndicator; }
+  get: function () { return chunkHOIF5RQI_js.CollaborationStatusIndicator; }
 });
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkEUQ2IER3_js.PowerPointViewer; }
+  get: function () { return chunkHOIF5RQI_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "RemoteUserCursors", {
   enumerable: true,
-  get: function () { return chunkEUQ2IER3_js.RemoteUserCursors; }
+  get: function () { return chunkHOIF5RQI_js.RemoteUserCursors; }
 });
 Object.defineProperty(exports, "UserAvatarBar", {
   enumerable: true,
-  get: function () { return chunkEUQ2IER3_js.UserAvatarBar; }
+  get: function () { return chunkHOIF5RQI_js.UserAvatarBar; }
 });
 Object.defineProperty(exports, "isAudienceTab", {
   enumerable: true,
-  get: function () { return chunkBNSCH4WT_js.isAudienceTab; }
+  get: function () { return chunk7TEZJZ2O_js.isAudienceTab; }
 });
 Object.defineProperty(exports, "parseAudienceNonce", {
   enumerable: true,
-  get: function () { return chunkBNSCH4WT_js.parseAudienceNonce; }
+  get: function () { return chunk7TEZJZ2O_js.parseAudienceNonce; }
 });
 Object.defineProperty(exports, "useCollaborativeHistory", {
   enumerable: true,
-  get: function () { return chunkBNSCH4WT_js.useCollaborativeHistory; }
+  get: function () { return chunk7TEZJZ2O_js.useCollaborativeHistory; }
 });
 Object.defineProperty(exports, "useCollaborativeState", {
   enumerable: true,
-  get: function () { return chunkBNSCH4WT_js.useCollaborativeState; }
+  get: function () { return chunk7TEZJZ2O_js.useCollaborativeState; }
 });
 Object.defineProperty(exports, "usePresenceTracking", {
   enumerable: true,
-  get: function () { return chunkBNSCH4WT_js.usePresenceTracking; }
+  get: function () { return chunk7TEZJZ2O_js.usePresenceTracking; }
 });
 Object.defineProperty(exports, "useThemeSwitching", {
   enumerable: true,
-  get: function () { return chunkBNSCH4WT_js.useThemeSwitching; }
+  get: function () { return chunk7TEZJZ2O_js.useThemeSwitching; }
 });
 Object.defineProperty(exports, "useYjsProvider", {
   enumerable: true,
-  get: function () { return chunkBNSCH4WT_js.useYjsProvider; }
+  get: function () { return chunk7TEZJZ2O_js.useYjsProvider; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkDOS7NY7C_js.getAnimationInitialStyle; }
+  get: function () { return chunkSMECSYCT_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "clearAudienceContent", {
   enumerable: true,
-  get: function () { return chunkFDR5W67L_js.clearAudienceContent; }
+  get: function () { return chunkPB7KVDNV_js.clearAudienceContent; }
 });
 Object.defineProperty(exports, "loadAudienceContent", {
   enumerable: true,
-  get: function () { return chunkFDR5W67L_js.loadAudienceContent; }
+  get: function () { return chunkPB7KVDNV_js.loadAudienceContent; }
 });
 Object.defineProperty(exports, "storeAudienceContent", {
   enumerable: true,
-  get: function () { return chunkFDR5W67L_js.storeAudienceContent; }
+  get: function () { return chunkPB7KVDNV_js.storeAudienceContent; }
 });

package/dist/viewer/index.mjs

@@ -1,7 +1,7 @@
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-3HWE6QZG.mjs';
-import '../chunk-L5YGPCQW.mjs';
-export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-ZFRPPY2N.mjs';
-export { getAnimationInitialStyle } from '../chunk-GZ6TXBEO.mjs';
-import '../chunk-TEXIGSA6.mjs';
-export { clearAudienceContent, loadAudienceContent, storeAudienceContent } from '../chunk-GKOKCOXR.mjs';
+export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar } from '../chunk-GROIHKI5.mjs';
+import '../chunk-2KRHLUCG.mjs';
+export { isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider } from '../chunk-T4NHPN76.mjs';
+export { getAnimationInitialStyle } from '../chunk-R7MGJCZN.mjs';
+import '../chunk-5YV26HMJ.mjs';
+export { clearAudienceContent, loadAudienceContent, storeAudienceContent } from '../chunk-5MMC7ZR3.mjs';
 import '../chunk-XGB3TDIC.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-react-viewer",
-	"version": "2.13.2",
+	"version": "2.14.0",
 	"description": "React PowerPoint viewer and editor component: render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"editor",

package/dist/useViewerBuildingBlocks-YvCYsxa3.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useViewerBuildingBlocks-YvCYsxa3.d.ts","names":[],"sources":["../src/viewer/components/toolbar/toolbar-types.ts","../src/viewer/utils/table-band-style.tsx","../src/viewer/components/canvas/canvas-types.ts","../src/viewer/hooks/useAutosave.ts","../src/viewer/hooks/useViewerBuildingBlocks.ts"],"mappings":";;;;;UAqBiB;EAChB;EACA,MAAM;EACN;EACA;EACA;EACA;EACA;EACA,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA;EACA,iBAAiB;EACjB,mBAAmB;EACnB;EACA,cAAc;EACd,YAAY;EACZ;EACA;EACA,kBAAkB;EAClB,YAAY,MAAM;EAClB;EACA;;EAEA;;;;;;EAMA,kBAAkB,gBAAgB,OAAO;;EAEzC;EACA;EACA,sBAAsB,SAAS;EAC/B;EACA;EACA;EACA;EACA;EACA;EACA,oBAAoB,MAAM;EAC1B;EACA;EACA;EACA,cAAc,WAAW;EACzB;EACA;EACA,oBAAoB;EACpB,iBAAiB,mBAAmB;EACpC;EACA;EACA;EACA,kBAAkB,MAAM;EACxB,oBAAoB;EACpB,oBAAoB;EACpB,wBAAwB;EACxB;EACA;EACA;;EAEA;EACA;EACA;EACA,yBAAyB;EACzB,gBAAgB;EAChB,kBAAkB;EAClB,kBAAkB;EAClB,kBAAkB;EAClB,mBAAmB;EACnB,aAAa;EACb,kBAAkB;EAClB,uBAAuB;EACvB;EACA;EACA;EACA;EACA,SAAS;EACT,cAAc;EACd,oBAAoB;;EAEpB;;EAEA;;EAEA,uBAAuB,SAAS,QAAQ;;EAExC;;EAEA;EACA;EACA;;EAEA;EACA,oBAAoB;EACpB,uBAAuB;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA,oBAAoB,SAAS,QAAQ;;EAErC,sBAAsB,MAAM;EAC5B;EACA,wBAAwB;EACxB,eAAe;IAAQ;IAAc;;EACrC,0BAA0B,cAAc;EACxC,aAAa;EACb;EACA,0BAA0B;EAC1B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;EACA,cAAc;EACd,qBAAqB,SAAS,QAAQ;EACtC;;EAEA,yBAAyB;;EAEzB;;EAEA;;EAEA;;;;;UClLgB;EAChB,gBAAgB;EAChB,QAAQ;;;;UCOQ;EAChB,mBAAmB,QAAM,UAAU;EACnC,gBAAgB,QAAM,UAAU;EAChC,gBAAgB,QAAM,UAAU;EAChC;;UAuBgB;EAChB,aAAa;EACb,kBAAkB;EAClB,YAAY;EACZ,MAAM;EACN,MAAM;EACN;EACA;EACA,sBAAsB;EACtB,iBAAiB;EACjB;EACA;EACA;EACA,eAAe;EACf,kBAAkB;EAClB,uBAAuB;EACvB,WAAW;IAAQ;IAAc;;EACjC;;EAEA;EACA;;EAEA,YAAY;EACZ,QAAQ;IAAQ;IAAY;IAAiB;;EAC7C,4BAA4B,YAAY;EACxC;EAEA,UAAU,mBAAmB,GAAG,QAAM;EACtC,gBAAgB,mBAAmB,GAAG,QAAM;EAC5C,cAAc,mBAAmB,GAAG,QAAM;EAC1C,gBAAgB,mBAAmB,GAAG,QAAM;;EAE5C,qBAAqB,GAAG,QAAM;EAC9B,sBAAsB,mBAAmB,GAAG,QAAM,YAAY;EAC9D,0BAA0B,mBAAmB,GAAG,QAAM;;EAEtD,YAAY,mBAAmB;EAC/B,qBAAqB;EACrB;EACA;EACA,oBACC,MAAM,KAAK,2CACX;;EAGD,oBAAoB,mBAAmB,kBAAkB,kBAAkB;;;;;;EAM3E,2BAA2B,mBAAmB,SAAS,QAAQ;;;;;;EAM/D,gBAAgB,SAAS,QAAQ;;EAEjC,wBAAwB,mBAAmB;;EAE3C,oBAAoB,mBAAmB,kBAAkB;;EAEzD,cAAc;IACb;IACA;IACA;IACA;IACA;;;EAGD;;EAEA;;EAIA,aAAa;;EAEb;;EAEA;;EAEA,eAAe,QAAM;;EAErB,mBAAmB,KAAK;;EAExB,sBAAsB,OAAO;;EAE7B,qBAAqB;;EAIrB,iBAAiB,mBAAmB,QAAQ;;EAE5C,oBAAoB;;EAIpB,WAAW;;EAEX;;EAEA,wBAAwB;EACxB,eAAe,iBAAiB;EAChC,iBAAiB;EACjB,0BAA0B,iBAAiB;;;;;;EAQ3C,2BAA2B,YAAY;;EAIvC;;EAEA,qBAAqB,WAAW;;EAIhC,qBAAqB;;EAErB,eAAe,0BAA0B;;EAEzC;;EAIA,eAAe;;EAIf,oBAAoB;;EAIpB,uBAAuB,QAAM;;;;;EAO7B;;;;KC/LW;EACP;;EACA;EAAmB;;EACnB;;EACA;EAAgB;;EAChB;EAAgB;;UAEJ;;EAEhB;;EAEA;;EAEA,uBAAuB,QAAQ;;EAE/B;;EAEA;;UAGgB;;EAEhB,gBAAgB;;EAEhB,uBAAuB;;iBAOR,YAAY,OAAO,mBAAmB;;;UCIrC;;EAEhB,SAAS,cAAc;;EAEvB;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,yBAAyB;;EAEzB,SAAS,MAAM,aAAa;EAC5B,mBAAmB,SAAS;EAC5B,iBAAiB;EACjB,uBAAuB;EACvB,gBAAgB,MAAM;EACtB,gBAAgB;EAChB,qBAAqB;EACrB,sBAAsB;;EAEtB;;EAEA;;EAEA;;UAOgB;;EAEhB,cAAc;;EAEd,aAAa;;EAEb,MAAM;;EAEN;;EAEA;;EAEA,gBAAgB;;iBAOD,wBACf,OAAO,+BACL"}