pptx-svelte-viewer 2.19.0 → 2.20.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-EP8BTIz6.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-Cs5ewuZ4.js";
 export {
   o as LOCALE_CATALOG,
   l as createTranslator,

package/dist/index.d.ts

@@ -183,11 +183,18 @@ interface XmlObject {
   [child: string]: XmlObject | XmlObject[] | string | undefined;
 }
 /**
- * Shape lock attributes from `p:cNvSpPr / a:spLocks`.
+ * Lock attributes from an element's non-visual properties node.
  *
  * When a flag is `true` the corresponding user interaction is disabled
  * in the editor (e.g. `noRotation` prevents free rotation of the shape).
  *
+ * One bag covers every family, but the families are NOT interchangeable in
+ * the file: `a:spLocks` (`CT_ShapeLocking`), `a:picLocks`, `a:cxnSpLocks`,
+ * `a:grpSpLocks` (`CT_GroupLocking`) and `a:graphicFrameLocks`
+ * (`CT_GraphicalObjectFrameLocking`) each declare their own attribute subset.
+ * `runtime/shape-lock-containers` holds that table and is what decides which
+ * of these fields may be written for a given element.
+ *
  * @example
  * ```ts
  * const locks: PptxShapeLocks = { noMove: true, noResize: true };
@@ -206,6 +213,14 @@ interface PptxShapeLocks {
   noAdjustHandles?: boolean;
   noChangeArrowheads?: boolean;
   noChangeShapeType?: boolean;
+  /**
+   * `a:graphicFrameLocks/@noDrilldown`: forbids selecting the individual
+   * parts inside a graphic frame (a chart series, a SmartArt node). Declared
+   * ONLY by `CT_GraphicalObjectFrameLocking`, so it is written for tables,
+   * charts, SmartArt, OLE objects and graphic-frame media, and never onto
+   * `a:spLocks` / `a:picLocks` / `a:cxnSpLocks` / `a:grpSpLocks`.
+   */
+  noDrilldown?: 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
@@ -9869,13 +9884,28 @@ interface PowerPointViewerProps {
     /** Host override for the File > Open action. */
     onopenfile?: () => void;
     /**
-     * Enable debounced crash-recovery autosave. On each edit (when `editable`)
-     * the current slides are serialized to `.pptx` bytes and written to the
-     * shared IndexedDB recovery store (keyed by {@link filePath}), and
-     * `onautosave` is fired with the bytes. Requires `filePath`; without one the
-     * autosave indicator reads "disabled". This binding does not auto-restore on
-     * load; recovery is a host concern (see the re-exported `getAutosaveSnapshot`
-     * / `listAutosaveSnapshots` helpers). Default false.
+     * POLICY CEILING for crash-recovery autosave. Not a switch the host flips on
+     * the user's behalf: it states what this application permits, and the
+     * title-bar AutoSave toggle (and File > Options > Save > AutoSave) is the
+     * user's preference inside it.
+     *
+     *  - `false` turns autosave off AND renders the toggle off and inert; a user
+     *    cannot switch on what the application forbade.
+     *  - `true`, or omitted, PERMITS autosave and lets the toggle decide.
+     *
+     * While active, each edit serializes the current slides to `.pptx` bytes,
+     * writes them to the shared IndexedDB recovery store (keyed by
+     * {@link filePath}) and fires `onautosave`. A snapshot lands no later than
+     * one interval after the first unsaved edit, and no more often than once per
+     * interval. Requires `filePath`; without one the indicator reads "disabled".
+     *
+     * On the next load of the same `filePath` the viewer OFFERS the snapshot back
+     * in a "Recover unsaved changes?" dialog (Restore loads it in place, Discard
+     * deletes it), unless this prop is `false`. The store is also reachable
+     * directly through the re-exported `getAutosaveSnapshot` /
+     * `listAutosaveSnapshots` helpers.
+     *
+     * @default true
      */
     autosave?: boolean;
     /** Fired when the desktop title bar toggles AutoSave for this viewer instance. */
@@ -9885,7 +9915,16 @@ interface PowerPointViewerProps {
      * Autosave is inert until this is set.
      */
     filePath?: string;
-    /** Autosave debounce window in milliseconds. Default 2000. */
+    /**
+     * Autosave cadence in milliseconds: the debounce window, and the ceiling on
+     * how long an unbroken stream of edits may defer a snapshot.
+     *
+     * Optional, and a policy like {@link autosave}: pass it and it wins. Leave it
+     * out and the cadence is the user's own File > Options > Save > "Save
+     * AutoRecover information every N minutes", which defaults to two minutes.
+     *
+     * @default 120000 (Options > Save, "every 2 minutes")
+     */
     autosaveIntervalMs?: number;
     /** Fired with the serialized `.pptx` bytes after each successful autosave. */
     onautosave?: (bytes: Uint8Array) => void;
@@ -10010,6 +10049,13 @@ declare const PowerPointViewer: Component<PowerPointViewerProps, PowerPointViewe
  *  - Vue's debounce-on-edit trigger: an edit marks the document dirty and
  *    (re)arms a debounce timer instead of polling on a fixed interval.
  *
+ * The debounce is CAPPED by the shared `nextAutosaveDelayMs`, so it keeps the
+ * same promise React's and Angular's polling engines do: a snapshot lands no
+ * later than one interval after the FIRST unsaved edit, and no more often than
+ * once per interval. Without that cap a user who keeps typing keeps re-arming
+ * the timer, and at the two-minute AutoRecover cadence that is a whole session
+ * of work that never reaches the recovery store.
+ *
  * The controller registers its own edit-watching `$effect` in the constructor,
  * so the SFC only has to construct it once during setup and read its reactive
  * `status` / `isDirty` for the toolbar indicator.

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;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;AAShE,OAAO,EACN,gBAAgB,EAChB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAQlE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,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;AAKrE,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;AAShE,OAAO,EACN,gBAAgB,EAChB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAQlE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -1,38 +1,38 @@
-import { $ as e, G as a, J as t, K as o, Q as i, U as r, W as n, X as l, Y as S, Z as d, a as m, at as p, c as T, ct as v, dt as P, et as g, ft as u, it as h, l as c, lt 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-CZzvhGTm.js";
-import { i as R } from "./translator-EP8BTIz6.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-Cp97qZ_g.js";
+import { i as R } from "./translator-Cs5ewuZ4.js";
 import "./i18n.js";
 export {
   r as PPTX_OPEN_ACCEPT,
-  n as PRESENTATION_OPEN_EXTENSIONS,
+  a as PRESENTATION_OPEN_EXTENSIONS,
   B as PowerPointViewer,
-  a as defaultCssVars,
-  o as defaultRadius,
-  D as defaultThemeColors,
-  t as deleteAutosaveSnapshot,
+  o as defaultCssVars,
+  D as defaultRadius,
+  t as defaultThemeColors,
+  l as deleteAutosaveSnapshot,
   N as exportAllSlidesToSvg,
   x as exportAllSlidesToSvgBlobs,
-  T as exportSlideAsSvg,
-  c as exportSlideToSvg,
+  p as exportSlideAsSvg,
+  h as exportSlideToSvg,
   O as exportSlideToSvgBlob,
-  S as forgetSessionDeck,
-  l as getAutosaveSnapshot,
-  d as getSessionTabId,
-  i as isLegacyBinaryPresentation,
-  e as isSupportedPresentationFile,
-  g as listAutosaveSnapshots,
-  I as loadPresentationDeck,
-  C as loadSessionDeck,
-  E as parsePresentationSessionId,
-  h as presentationBaseName,
+  n as forgetSessionDeck,
+  S as getAutosaveSnapshot,
+  i as getSessionTabId,
+  e as isLegacyBinaryPresentation,
+  P as isSupportedPresentationFile,
+  I as listAutosaveSnapshots,
+  C as loadPresentationDeck,
+  E as loadSessionDeck,
+  u as parsePresentationSessionId,
+  m as presentationBaseName,
   R as registerTranslations,
-  p as rememberSessionDeck,
-  m as renderToCanvas,
-  f as restoreSessionDeck,
-  b as savedPresentationFileName,
-  v as themeToCssVars,
-  A as vermilionDarkColors,
-  _ as vermilionDarkTheme,
-  P as vermilionLightColors,
-  u as vermilionLightTheme,
-  k as vermilionRadius
+  f as rememberSessionDeck,
+  d as renderToCanvas,
+  b as restoreSessionDeck,
+  T as savedPresentationFileName,
+  c as themeToCssVars,
+  _ as vermilionDarkColors,
+  v as vermilionDarkTheme,
+  g as vermilionLightColors,
+  k as vermilionLightTheme,
+  A as vermilionRadius
 };