ooxml-ui 1.26.2 → 1.27.1

package/dist/pptx/render/live-color-input.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Live preview for a native colour input (`<input type="color">`), decided once for every
+ * binding.
+ *
+ * The picker fires `input` for every shade a drag passes and `change` once the pick settles
+ * (and in some browsers no `change` at all when the pick ends where it started, or on Escape).
+ * PowerPoint shows each shade on the slide while the user drags and makes the settled pick ONE
+ * undo step and ONE Recent Colors entry. A binding that applied every shade through its normal
+ * edit path recorded one undo step per shade; one that applied only on `change` showed nothing
+ * until the picker closed. This controller is the rule between the two:
+ *
+ * - `input`: show the shade live, with no undo step, dirty flag or recent colour;
+ * - `change`, or `blur` for a drag no `change` ended: put back what the previews changed, then
+ *   commit the settled colour through the binding's normal edit path, so its one undo step
+ *   returns to the colour from before the drag, and add it to the recent colours. A pick that
+ *   settles where the drag started is no edit at all: the previews are put back (theme ref
+ *   included) and no undo step is recorded. A `change` there is still the user's pick, so its
+ *   colour goes into the recent colours like any other; a `blur` there is not a pick (an
+ *   Escape, a drag back to the start), so it records nothing.
+ *
+ * The previews own only the leaves they wrote (`shapeStyle.fillColor`, its theme ref, ...),
+ * each remembered with the value it had before the drag. Putting a drag back and committing
+ * its pick are both rebased on the target as it is NOW: only those leaves go back, and the
+ * commit is built on the result, so an edit another hand made to the same element during the
+ * drag (a collaborator's line width, an assistant's text) survives, and the undo step returns
+ * to a state that existed.
+ *
+ * A drag belongs to one target (`key`, the element). It carries over to the next event only
+ * while the control edits that target and the model still shows the drag's work: the value it
+ * last read (a binding that has not re-rendered since), or a colour the drag itself put there.
+ * When the control has moved to another target, the drag is put back on its own target as it
+ * is then (`lookup`; the binding's writes are addressed by key; nothing is written if the
+ * target is gone) and the event that ends it is dropped: a pick made in
+ * a picker opened for one element never lands on another. When the target is the same but its
+ * colour was changed by another hand (a theme swatch, an undo), the drag is dropped as it is,
+ * since putting it back would overwrite that newer colour.
+ *
+ * @module render/live-color-input
+ */
+/** What a colour control edits at the moment of an event. */
+export interface LiveColorSource<T> {
+    /** The edited target's identity (the element id). A drag never crosses targets. */
+    readonly key: string;
+    /** The colour the control shows now. */
+    readonly color: string;
+    /** The target as the binding holds it now: the element, or the style a field reads. */
+    readonly value: T;
+}
+/** What a binding gives {@link createLiveColorInput}; called afresh on every event. */
+export interface LiveColorInputOptions<T, P extends object> {
+    /** The control's target now, or `undefined` when nothing can be edited. */
+    read(): LiveColorSource<T> | undefined;
+    /** The patch that sets `hex` on `value`; `undefined` when `value` cannot take a colour. */
+    patch(value: T, hex: string): P | undefined;
+    /**
+     * The target `key` as the model holds it now (the element by id, or the style a field
+     * reads on it), or `undefined` when it is gone: what a drag the control has left is put
+     * back on. A drag whose target cannot be found is not put back at all.
+     */
+    lookup(key: string): T | undefined;
+    /**
+     * Merge `patch` into the target `key` live: no undo step, dirty flag or recent colour. `key`
+     * can name a target the control has left, when the drag started there is put back.
+     */
+    preview(patch: P, key: string): void;
+    /**
+     * Merge the settled pick into the current target `key` through the normal edit path: ONE
+     * undo step and the dirty flag. The drag is already put back and `patch` is built on it.
+     */
+    commit(patch: P, key: string, hex: string): void;
+    /**
+     * Add `hex` to the recent colours: with every commit (just before it), and for a `change`
+     * that settles on the colour the drag started from (a pick, though not an edit).
+     */
+    remember(hex: string): void;
+}
+/** The native events of one colour input, each with the input's current value. */
+export interface LiveColorInput {
+    /** An `input` event: one shade of a drag. */
+    input(hex: string): void;
+    /** A `change` event: the pick settled. */
+    change(hex: string): void;
+    /** A `blur` event: settles a drag no `change` ended, at the value the input shows. */
+    blur(hex: string): void;
+}
+/** Build the controller for one colour input. */
+export declare function createLiveColorInput<T, P extends object>(options: LiveColorInputOptions<T, P>): LiveColorInput;
+/**
+ * Route a native colour input's DOM `input`, `change` or `blur` event to `control`, with the
+ * value the input shows. Any other event, or an input without a value, is ignored.
+ */
+export declare function handleLiveColorEvent(control: LiveColorInput, event: Event): void;
+//# sourceMappingURL=live-color-input.d.ts.map

package/dist/pptx/render/live-color-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-color-input.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/live-color-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAKH,6DAA6D;AAC7D,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CAClB;AAED,uFAAuF;AACvF,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM;IACzD,2EAA2E;IAC3E,IAAI,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACvC,2FAA2F;IAC3F,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC5C;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC9B,6CAA6C;IAC7C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0CAA0C;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sFAAsF;IACtF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAgBD,iDAAiD;AACjD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EACvD,OAAO,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,GAClC,cAAc,CA8FhB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAahF"}

package/dist/pptx/render/live-color-leaves.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The leaves a live colour drag writes, and how they are put back (see `live-color-input.ts`).
+ *
+ * A colour patch writes whole top-level entries (`{ shapeStyle: { ...style, fillColor } }`),
+ * but the drag owns only the leaves inside them that changed. Those are found by a structural
+ * diff of plain objects and arrays, each remembered with the value it had before the drag,
+ * and put back onto the target as it is at that moment, so everything else in the same entry
+ * keeps whatever it holds now. When a preview creates an object the target did not have (a
+ * text colour on an element with no `textStyle`), the drag owns the entries it put inside, not
+ * the object: putting it back removes those, and the object itself only if nothing else went
+ * into it since.
+ *
+ * @module render/live-color-leaves
+ */
+type LiveColorPath = readonly string[];
+/** One leaf a drag's previews wrote, with what the target held there before the first one. */
+export interface LiveColorLeaf {
+    readonly path: LiveColorPath;
+    readonly present: boolean;
+    readonly value: unknown;
+    /** An object the previews created: it goes again once putting the drag back leaves it empty. */
+    readonly created?: boolean;
+}
+/** Note every leaf `patch` writes on `value` that the drag has not written yet. */
+export declare function recordLiveColorLeaves(leaves: Map<string, LiveColorLeaf>, value: unknown, patch: object): void;
+/**
+ * The patch that puts every leaf a drag wrote back to what it was before the drag, rebased on
+ * `value` (the target now): the top-level entries it names are `value`'s own, with only those
+ * leaves changed. An object the drag created goes again if that leaves it empty; a top-level
+ * entry the target did not have comes back as `undefined`.
+ */
+export declare function liveColorRevertPatch<P extends object>(value: unknown, leaves: Iterable<LiveColorLeaf>): P;
+export {};
+//# sourceMappingURL=live-color-leaves.d.ts.map

package/dist/pptx/render/live-color-leaves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-color-leaves.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/live-color-leaves.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,KAAK,aAAa,GAAG,SAAS,MAAM,EAAE,CAAC;AAEvC,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,gGAAgG;IAChG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC3B;AAqED,mFAAmF;AACnF,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EAClC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACX,IAAI,CA6BN;AAyBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EACpD,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC7B,CAAC,CAmCH"}

package/dist/pptx/render/master-view-crud-history.d.ts

@@ -0,0 +1,45 @@
+/**
+ * master-view-crud-history.ts: the undo and redo steps a Slide Master view
+ * command leaves behind when it removed parts from the package.
+ *
+ * Delete Layout and Delete Slide Master remove the layout (or the master and
+ * all its layouts) from the package, which the undo stack cannot put back.
+ * The delete is allowed because no slide uses the layout NOW, but an older
+ * undo step (or an undone redo step) can still have a slide on it: restoring
+ * that step makes the next save write a slide relationship to a part that is
+ * not in the package, and a later Insert Layout that reuses the file name
+ * silently gives the slide a different layout. So after a command the binding
+ * calls {@link forgetStepsUsingRemovedParts}, which forgets the steps that would
+ * bring back what it removed (`EditorHistoryController.forget`).
+ *
+ * @module render/master-view-crud-history
+ */
+import type { PptxData, PptxSlide, PptxSlideMaster } from 'ooxml-core/pptx';
+/** The part of an undo or redo step that can refer to a slide master or layout. */
+export interface SlideMasterHistoryStep {
+    readonly slides: readonly Pick<PptxSlide, 'layoutPath'>[];
+    /** The masters, in a binding whose steps restore them too. */
+    readonly slideMasters?: readonly PptxSlideMaster[] | undefined;
+}
+/**
+ * The slide master and layout part paths `before` has and `after` no longer
+ * has: the layout Delete Layout removed, or the master Delete Slide Master
+ * removed with every one of its layouts. Empty after any other command.
+ */
+export declare function removedSlideMasterParts(before: Pick<PptxData, 'slideMasters'>, after: Pick<PptxData, 'slideMasters'>): string[];
+/**
+ * True when restoring `step` would bring back a part in `removed`: one of its
+ * slides is on a removed layout, or (in a step that restores the masters) its
+ * masters still hold a removed master or layout, which would offer it in the
+ * sidebar and the layout galleries again.
+ */
+export declare function historyStepUsesParts(step: SlideMasterHistoryStep, removed: ReadonlySet<string>): boolean;
+/**
+ * After a Slide Master view command took the deck from `before` to `after`,
+ * forget every undo and redo step that would bring back a part it removed
+ * (nothing, unless it was a delete). In a binding whose steps restore the
+ * masters too, every step taken before a delete still holds what it removed,
+ * so a delete leaves no undo step there.
+ */
+export declare function forgetStepsUsingRemovedParts(forget: (reaches: (step: SlideMasterHistoryStep) => boolean) => void, before: Pick<PptxData, 'slideMasters'>, after: Pick<PptxData, 'slideMasters'>): void;
+//# sourceMappingURL=master-view-crud-history.d.ts.map

package/dist/pptx/render/master-view-crud-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-view-crud-history.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/master-view-crud-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5E,mFAAmF;AACnF,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC;IAC1D,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,CAAC;CAC/D;AASD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EACtC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,GACnC,MAAM,EAAE,CAGV;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC1B,OAAO,CAKT;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,KAAK,IAAI,EACpE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EACtC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,GACnC,IAAI,CAKN"}

package/dist/pptx/render/master-view-crud.d.ts

@@ -65,6 +65,17 @@ export type MasterViewCrudApplyResult = MasterViewCrudApplySuccess | MasterLayou
  * `options.name` is required for `renameLayout` / `renameMaster`;
  * `options.layoutDefinition` is optional for `addLayout` (a default
  * title-only layout is generated when omitted, see `insertLayout` in core).
+ *
+ * The command saves `data.slides` and reloads the edited package through a
+ * FRESH handler, so a binding hands it the slides as they are now (not the
+ * deck as it was loaded) and adopts only `result.handler` and the masters
+ * from `result.data`. It keeps its own slides: the reloaded ones carry no
+ * loaded pictures, and nothing the command changes lives on them. And it
+ * keeps the previous handler undisposed, since the slides on screen and the
+ * undo stack still show that handler's pictures (disposing it revokes their
+ * Blob URLs). Then the binding forgets the undo and redo steps that would
+ * bring back a part the command removed (`forgetStepsUsingRemovedParts` in
+ * `./master-view-crud-history`).
  */
 export declare function applyMasterViewCrudAction(handler: PptxHandler, data: PptxData, action: MasterViewCrudActionId, target: MasterViewTarget, options?: MasterViewCrudActionOptions): Promise<MasterViewCrudApplyResult>;
 //# sourceMappingURL=master-view-crud.d.ts.map

package/dist/pptx/render/master-view-crud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"master-view-crud.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/master-view-crud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EACX,gBAAgB,EAChB,uBAAuB,EACvB,QAAQ,EACR,WAAW,EAEX,MAAM,iBAAiB,CAAC;AAYzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,6CAA6C;AAC7C,MAAM,MAAM,sBAAsB,GAC/B,WAAW,GACX,iBAAiB,GACjB,cAAc,GACd,cAAc,GACd,WAAW,GACX,iBAAiB,GACjB,cAAc,GACd,cAAc,CAAC;AAElB,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,sBAAsB,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,EAAE,EAAE,sBAAsB,EAC1B,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GACvC,MAAM,CASR;AAaD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GACzC,oBAAoB,EAAE,CAmDxB;AAED,uGAAuG;AACvG,MAAM,WAAW,2BAA2B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,WAAW,0BAA0B;IAC1C,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CACzB;AACD,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,GAAG,uBAAuB,CAAC;AA2B7F;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC9C,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,yBAAyB,CAAC,CAsGpC"}
+{"version":3,"file":"master-view-crud.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/master-view-crud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EACX,gBAAgB,EAChB,uBAAuB,EACvB,QAAQ,EACR,WAAW,EAEX,MAAM,iBAAiB,CAAC;AAYzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,6CAA6C;AAC7C,MAAM,MAAM,sBAAsB,GAC/B,WAAW,GACX,iBAAiB,GACjB,cAAc,GACd,cAAc,GACd,WAAW,GACX,iBAAiB,GACjB,cAAc,GACd,cAAc,CAAC;AAElB,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,sBAAsB,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,EAAE,EAAE,sBAAsB,EAC1B,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GACvC,MAAM,CASR;AAaD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GACzC,oBAAoB,EAAE,CAmDxB;AAED,uGAAuG;AACvG,MAAM,WAAW,2BAA2B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,WAAW,0BAA0B;IAC1C,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;CACzB;AACD,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,GAAG,uBAAuB,CAAC;AA2B7F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,yBAAyB,CAC9C,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,2BAA2B,GACnC,OAAO,CAAC,yBAAyB,CAAC,CAsGpC"}

package/dist/pptx/render/theme-by-path.d.ts

@@ -0,0 +1,61 @@
+import type { PptxElement, PptxSlide } from 'ooxml-core/pptx';
+import type { DeckStyleHandler } from './deck-style.js';
+import type { ThemePartWriter } from './theme-history.js';
+/** The handler operations the switch needs (the `PptxHandler` has them all). */
+export type ThemeByPathHandler = Pick<ThemePartWriter, 'getThemePartSchemes' | 'setSlideMasterTheme'> & Pick<DeckStyleHandler, 'reResolveThemeStyleReferences'>;
+/** A slide master as a binding keeps it (`PptxSlideMaster` fits). */
+export interface ThemeByPathMaster {
+    readonly path: string;
+    readonly themePath?: string | undefined;
+    readonly layoutPaths?: readonly string[] | undefined;
+    readonly layouts?: readonly {
+        readonly path: string;
+    }[] | undefined;
+}
+/** Any theme-shaped value: a binding's `PptxTheme`, or the looser record some bindings keep. */
+interface ThemeLike {
+    colorScheme?: unknown;
+    fontScheme?: unknown;
+    formatScheme?: unknown;
+    name?: unknown;
+}
+export interface ThemeByPathInput<M extends ThemeByPathMaster, T extends ThemeLike> {
+    /** The theme part to switch to (`PptxThemeOption.path`). */
+    readonly themePath: string;
+    /** Every master, or only the first one (the inspector's two buttons). */
+    readonly applyToAllMasters: boolean;
+    readonly slides: readonly PptxSlide[];
+    /** The binding's masters, in deck order: the first one's part is the deck's theme. */
+    readonly slideMasters: readonly M[];
+    /** The binding's deck theme (the first master's). */
+    readonly theme: T | null | undefined;
+    /** The master/layout element layer, for bindings that keep it apart from the slides. */
+    readonly templateElementsBySlideId?: Readonly<Record<string, PptxElement[]>> | undefined;
+}
+/** What a binding commits, as one undo step. */
+export interface ThemeByPathChange<M extends ThemeByPathMaster, T extends ThemeLike> {
+    /** Every slide; those on a master that kept its part are the same objects. */
+    readonly slides: PptxSlide[];
+    /** The template layer re-resolved the same way (empty when the input had none). */
+    readonly templateElementsBySlideId: Record<string, PptxElement[]>;
+    /** The masters, re-targeted ones on the new part. */
+    readonly slideMasters: M[];
+    /**
+     * When the first master was re-targeted, the deck theme carrying the new part's colour, font and
+     * format schemes and name, and the colour map built from it. Absent when the deck theme is
+     * unchanged.
+     */
+    readonly deckTheme?: {
+        readonly theme: T;
+        readonly themeColorMap: Record<string, string>;
+    };
+}
+/**
+ * Point the masters at `themePath` in `handler` and return what the binding commits, or
+ * `undefined` when there is nothing to do (no handler, no such part, or every target master is on
+ * it already). Runs on the handler's theme write queue: it waits for the theme writes queued
+ * before it, and a save waits for it.
+ */
+export declare function applyThemeByPath<M extends ThemeByPathMaster, T extends ThemeLike>(handler: ThemeByPathHandler | null | undefined, input: ThemeByPathInput<M, T>): Promise<ThemeByPathChange<M, T> | undefined>;
+export {};
+//# sourceMappingURL=theme-by-path.d.ts.map

package/dist/pptx/render/theme-by-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-by-path.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/theme-by-path.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGzE,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACpC,eAAe,EACf,qBAAqB,GAAG,qBAAqB,CAC7C,GACA,IAAI,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;AAEzD,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC;CACpE;AAED,gGAAgG;AAChG,UAAU,SAAS;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,SAAS,SAAS;IACjF,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,sFAAsF;IACtF,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,CAAC;IACpC,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,wFAAwF;IACxF,QAAQ,CAAC,yBAAyB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;CACzF;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,SAAS,SAAS;IAClF,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAClE,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC3F;AAoDD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,SAAS,SAAS,EAChF,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAC9C,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CA2E9C"}

package/dist/pptx/render/theme-history.d.ts

@@ -0,0 +1,146 @@
+/**
+ * A theme change as an undo step, for every binding.
+ *
+ * A Design gallery pick, the theme editor and a colour or font scheme edit change the deck's theme
+ * as well as its slides. Undo must take both back: the slides come back with the history snapshot,
+ * but the theme lives in the binding's theme state and, for a save, in the handler's theme parts.
+ * So each binding records {@link historyTheme} with every snapshot, and an undo or redo that
+ * {@link crossedHistoryTheme crosses} a theme change puts the binding's theme back and writes only
+ * the parts that differ into the handler ({@link restoreCrossedTheme}).
+ *
+ * The record carries the deck's format scheme too, which a Design > Effects pick changes on its own:
+ * a restore across one writes the recorded scheme back as the part held it (the handler's
+ * `restoreThemeFormatScheme`).
+ *
+ * A theme applied by path (`render/theme-by-path`) points slide masters at another theme part, so the
+ * record also holds each master's theme part ({@link historyTheme} with the masters), and a restore
+ * that crosses such a switch points the masters back before it writes anything: Undo returns to
+ * the old part instead of writing the old schemes into the new one. The record describes the deck's
+ * part only, so what such a restore still writes goes into that part alone.
+ *
+ * Each theme part write reads, edits and writes the part back, so the writes on one handler run one
+ * after another ({@link queueThemeWrite}), and every save waits for the ones queued before it
+ * ({@link settleThemeWrites}, which `saveDeckWithPassword` calls).
+ *
+ * @module render/theme-history
+ */
+import type { PptxThemeColorScheme, PptxThemeFontScheme, PptxThemeFormatScheme, PptxThemeOption } from 'ooxml-core/pptx';
+export { queueThemeWrite, settleThemeWrites } from './theme-write-queue.js';
+/**
+ * The part of a theme an undo step records: the colour scheme, the font scheme and the name, which
+ * are what the Design galleries, the theme editor and the assistant change, and the format scheme
+ * (Design > Effects).
+ */
+export interface HistoryTheme {
+    colorScheme?: PptxThemeColorScheme;
+    fontScheme?: PptxThemeFontScheme;
+    /**
+     * The deck's format scheme. Two records hold the same one when it is the same element, however
+     * the colours of its placeholder styles resolved when each was read (`formatSchemeKey`).
+     */
+    formatScheme?: PptxThemeFormatScheme;
+    name?: string;
+    /** Each slide master's theme part, by master path, in master order (the first is the deck's). */
+    masterThemePaths?: Readonly<Record<string, string>>;
+}
+/** A slide master as a binding keeps it: its path and the theme part it uses. */
+export interface HistoryMaster {
+    readonly path: string;
+    readonly themePath?: string | undefined;
+}
+/** Any theme-shaped value: a binding's `PptxTheme`, or the looser record some bindings keep. */
+interface ThemeLike {
+    colorScheme?: unknown;
+    fontScheme?: unknown;
+    formatScheme?: unknown;
+    name?: unknown;
+}
+/**
+ * The part of `theme` an undo step records, as a copy, and with `slideMasters` the theme part each
+ * master uses. Built in a fixed key order, so two records of the same theme serialise to the same
+ * JSON.
+ */
+export declare function historyTheme(theme: ThemeLike, slideMasters?: readonly HistoryMaster[] | undefined): HistoryTheme;
+export declare function historyTheme(theme: ThemeLike | null | undefined, slideMasters?: readonly HistoryMaster[] | undefined): HistoryTheme | undefined;
+/**
+ * The theme an undo or redo from `current` to `target` has to put back, or `undefined` when the
+ * step crosses no theme change (or `target` recorded none).
+ */
+export declare function crossedHistoryTheme(current: HistoryTheme | undefined, target: HistoryTheme | undefined): HistoryTheme | undefined;
+/**
+ * `theme` carrying exactly the recorded parts of `target`: a part `target` does not have is
+ * removed, so the restored theme records the same as the snapshot it came from, and the format
+ * scheme when `target` records another one. Everything else on the theme is kept.
+ */
+export declare function withHistoryTheme<T extends ThemeLike>(theme: T | null | undefined, target: HistoryTheme): T;
+/**
+ * `slideMasters` with each master the record names back on its recorded theme part: the same array
+ * when none differs (a step that crosses no theme by path switch).
+ */
+export declare function withHistoryMasterThemes<M extends HistoryMaster>(slideMasters: readonly M[], target: HistoryTheme | undefined): readonly M[];
+/** One theme part's schemes and name, as the handler reads them (`getThemePartSchemes`). */
+export interface ThemePartSchemes {
+    readonly path: string;
+    readonly name?: string | undefined;
+    readonly colorScheme: PptxThemeColorScheme;
+    readonly fontScheme: PptxThemeFontScheme;
+    readonly formatScheme?: PptxThemeFormatScheme | undefined;
+}
+/**
+ * The handler operations that write the recorded parts (the `PptxHandler` has them all). A scheme
+ * edit writes every part a slide master uses, or only `themePaths`.
+ */
+export interface ThemePartWriter {
+    updateThemeColorScheme(colorScheme: PptxThemeColorScheme, themePaths?: readonly string[]): Promise<void>;
+    updateThemeFontScheme(fontScheme: PptxThemeFontScheme, themePaths?: readonly string[]): Promise<void>;
+    updateThemeName(name: string, themePaths?: readonly string[]): Promise<void>;
+    /** Put back a format scheme a theme part held before (undo and redo of an Effects pick). */
+    restoreThemeFormatScheme(formatScheme: PptxThemeFormatScheme, themePaths?: readonly string[]): Promise<unknown>;
+    /** Point one slide master at a theme part (undo and redo of a theme by path switch). */
+    setSlideMasterTheme(masterPath: string, themePath: string): Promise<void>;
+    /** One theme part's schemes and name as the part holds them now. */
+    getThemePartSchemes(themePath: string): Promise<ThemePartSchemes | undefined>;
+}
+/** One theme part write. */
+export type ThemePartWrite = {
+    readonly part: 'colorScheme';
+    readonly colorScheme: PptxThemeColorScheme;
+} | {
+    readonly part: 'fontScheme';
+    readonly fontScheme: PptxThemeFontScheme;
+} | {
+    readonly part: 'formatScheme';
+    readonly formatScheme: PptxThemeFormatScheme;
+} | {
+    readonly part: 'name';
+    readonly name: string;
+};
+/**
+ * The writes that take the handler's theme parts from `from` to `to`: only the parts that differ,
+ * so undoing a fonts pick leaves the colour scheme part (and its `sysClr` slots) as it is. The
+ * parsed theme carries no name, so `loadedName` (see {@link loadedThemeName}) stands in for a
+ * theme without one: going back to the loaded theme puts its name back.
+ */
+export declare function themePartWrites(from: HistoryTheme | undefined, to: HistoryTheme, loadedName?: string): ThemePartWrite[];
+/**
+ * The name the deck's primary theme part (the first master's) was loaded with; the parsed theme
+ * carries none.
+ */
+export declare function loadedThemeName(themeOptions: readonly Pick<PptxThemeOption, 'path' | 'name'>[] | undefined, slideMasters: readonly {
+    readonly themePath?: unknown;
+}[] | undefined): string | undefined;
+/**
+ * Write {@link themePartWrites} into `handler`, after every write queued on it before. When `to`
+ * has masters on other theme parts (a step across a theme by path switch) they are pointed back
+ * first, and only what then still differs from the deck's part (the first master's) is written,
+ * into that part alone: Undo returns to the old part rather than writing the old schemes into the
+ * new one, and leaves the parts of the other masters, which the record does not describe, alone.
+ */
+export declare function writeThemeParts(handler: ThemePartWriter | null | undefined, from: HistoryTheme | undefined, to: HistoryTheme, loadedName?: string): Promise<void>;
+/**
+ * An undo or redo moved from `current` to `target`: when it crosses a theme change, queue the
+ * writes of the parts that differ on `handler` and return `theme` carrying `target`'s recorded
+ * parts, for the binding to put back. `undefined` when the step crosses no theme change.
+ */
+export declare function restoreCrossedTheme<T extends ThemeLike>(theme: T | null | undefined, current: HistoryTheme | undefined, target: HistoryTheme | undefined, handler: ThemePartWriter | null | undefined, loadedName?: string): T | undefined;
+//# sourceMappingURL=theme-history.d.ts.map

package/dist/pptx/render/theme-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-history.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/theme-history.ts"],"names":[],"mappings":"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"}

package/dist/pptx/render/theme-write-queue.d.ts

@@ -0,0 +1,21 @@
+/**
+ * One write queue per handler for its theme parts (`render/theme-history`).
+ *
+ * Each theme part write reads, edits and writes the part back, so the writes on one handler run one
+ * after another ({@link queueThemeWrite}), and every save waits for the ones queued before it
+ * ({@link settleThemeWrites}, which `saveDeckWithPassword` calls).
+ *
+ * @module render/theme-write-queue
+ */
+/**
+ * Run `write` on `handler`'s theme parts after every write queued on it before. An undo landing
+ * while a pick is still writing (or two undos in a row) waits for it instead of interleaving.
+ * With nothing queued the write starts at once, exactly as an unqueued one would.
+ */
+export declare function queueThemeWrite<T>(handler: object, write: () => Promise<T>): Promise<T>;
+/**
+ * Resolves once every theme part write queued on `handler` so far has landed (or failed). A save
+ * waits for this, or it writes a theme an undo or a pick is still replacing.
+ */
+export declare function settleThemeWrites(handler: object | null | undefined): Promise<void>;
+//# sourceMappingURL=theme-write-queue.d.ts.map

package/dist/pptx/render/theme-write-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-write-queue.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/theme-write-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAcvF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF"}

package/dist/pptx/render/viewer-preferences.d.ts

@@ -32,11 +32,22 @@ export interface DeckViewPreferences extends ViewerPreferences {
 }
 export declare const DEFAULT_VIEWER_PREFERENCES: ViewerPreferences;
 export declare const DEFAULT_VIEWER_SETTINGS: ViewerPreferences;
+/** The heading a shortcut is listed under in the keyboard shortcut help. */
+export type ShortcutReferenceGroup = 'history' | 'clipboard' | 'editing' | 'navigation' | 'general';
 export interface ShortcutReferenceItem {
     actionKey: string;
     shortcut: string;
+    group: ShortcutReferenceGroup;
 }
 export declare const VIEWER_SHORTCUT_REFERENCE: readonly ShortcutReferenceItem[];
+/** One heading of the shortcut help and the shortcuts under it. */
+export interface ShortcutReferenceBucket {
+    group: ShortcutReferenceGroup;
+    labelKey: string;
+    shortcuts: ShortcutReferenceItem[];
+}
+/** `items` under their headings, in heading order; a heading with no shortcut is left out. */
+export declare function groupShortcutReference(items?: readonly ShortcutReferenceItem[]): ShortcutReferenceBucket[];
 export declare const SHORTCUT_REFERENCE_ITEMS: readonly ShortcutReferenceItem[];
 export interface ViewerPreferenceToggle {
     key: keyof ViewerPreferences;

package/dist/pptx/render/viewer-preferences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-preferences.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/viewer-preferences.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC7D,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,iBAOxC,CAAC;AAEF,eAAO,MAAM,uBAAuB,mBAA6B,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,yBAAyB,EAAE,SAAS,qBAAqB,EA0BrE,CAAC;AAEF,eAAO,MAAM,wBAAwB,kCAA4B,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACtC,GAAG,EAAE,MAAM,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,CAAC;AAEvD,eAAO,MAAM,yBAAyB,EAAE,SAAS,sBAAsB,EAOtE,CAAC;AAEF,eAAO,MAAM,eAAe,mCAA4B,CAAC;AAEzD,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACvE,WAAW,EAAE,iBAAiB,EAC9B,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACzB,iBAAiB,CAEnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE;YACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;YAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;YACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;SAC9B,CAAC;QACF,QAAQ,CAAC,WAAW,CAAC,EAAE;YACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACF,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mCAAmC,CAClD,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,EAAE,mBAAmB,GAC3B,mBAAmB,CAWrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAAC,WAAW,EAAE,mBAAmB,GAAG;IACrF,WAAW,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAClF,WAAW,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAkBA"}
+{"version":3,"file":"viewer-preferences.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/viewer-preferences.ts"],"names":[],"mappings":"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"}

package/dist/pptx/render/viewer-props-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-props-manifest.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/viewer-props-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,eAAe,YAAI,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AACzF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClE,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACnE;AAoBD,mFAAmF;AACnF,eAAO,MAAM,YAAY,EAAE,SAAS,kBAAkB,EAwErD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,kBAAkB,EAwCtD,CAAC;AAIF,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAExF;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAgBzF;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AA4CD,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC,GAC1D,kBAAkB,EAAE,CAKtB"}
+{"version":3,"file":"viewer-props-manifest.d.ts","sourceRoot":"","sources":["../../../src/pptx/render/viewer-props-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,eAAe,YAAI,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AACzF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClE,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACnE;AAoBD,mFAAmF;AACnF,eAAO,MAAM,YAAY,EAAE,SAAS,kBAAkB,EAyErD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,kBAAkB,EAwCtD,CAAC;AAIF,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAExF;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAgBzF;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AA4CD,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC,GAC1D,kBAAkB,EAAE,CAKtB"}

package/dist/pptx/{smartart-insert-preview-CTBWMXNX.cjs → smartart-insert-preview-MCDHVWHZ.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunk4PYBBOIK_cjs = require('./chunk-4PYBBOIK.cjs');
-require('./chunk-NFP4PCTP.cjs');
+var chunkTMCN2OVN_cjs = require('./chunk-TMCN2OVN.cjs');
+require('./chunk-VMDMICQC.cjs');
 require('./chunk-WSTWYZFM.cjs');
 require('./chunk-2JEQHIAL.cjs');
 require('./chunk-IOR4KOGN.cjs');
@@ -12,10 +12,10 @@ require('./chunk-H5IPNKX6.cjs');
 require('./chunk-XOAXPD2W.cjs');
 require('./chunk-P27CIE4O.cjs');
 require('./chunk-BSGCZ4JZ.cjs');
-require('./chunk-43NFRLCD.cjs');
+require('./chunk-37VJFRCP.cjs');
 require('./chunk-IOOI63TH.cjs');
 require('./chunk-ZJFN5POF.cjs');
-require('./chunk-B4GBGPNL.cjs');
+require('./chunk-CWWL7MCL.cjs');
 require('./chunk-WB25PCHQ.cjs');
 require('./chunk-W3X2UVYQ.cjs');
 require('./chunk-6KLPQQYP.cjs');
@@ -26,7 +26,7 @@ require('./chunk-QWF3PGUX.cjs');
 require('./chunk-FM4C4MBJ.cjs');
 require('./chunk-G4WRLFMJ.cjs');
 require('./chunk-73IDQGYI.cjs');
-require('./chunk-X4FNVH7J.cjs');
+require('./chunk-YMITEJST.cjs');
 require('./chunk-FGKPZFLL.cjs');
 require('./chunk-UPN5FFKP.cjs');
 require('./chunk-FQUX6AUU.cjs');
@@ -34,7 +34,7 @@ require('./chunk-OJFD3SHS.cjs');
 require('./chunk-USBRSEJK.cjs');
 require('./chunk-3ESFHUZI.cjs');
 require('./chunk-U47LRWDT.cjs');
-require('./chunk-OOQMIQT3.cjs');
+require('./chunk-GWKTHP6U.cjs');
 require('./chunk-Y6DO6SVT.cjs');
 require('./chunk-PBZWDEXQ.cjs');
 require('./chunk-HJ3JZXOL.cjs');
@@ -44,5 +44,5 @@ require('./chunk-EW5DW5KR.cjs');
 
 Object.defineProperty(exports, "buildSmartArtInsertPreview", {
   enumerable: true,
-  get: function () { return chunk4PYBBOIK_cjs.buildSmartArtInsertPreview; }
+  get: function () { return chunkTMCN2OVN_cjs.buildSmartArtInsertPreview; }
 });

package/dist/pptx/{smartart-insert-preview-QJBRDU4C.mjs → smartart-insert-preview-QQH5ZBSF.mjs}

@@ -1,5 +1,5 @@
-export { buildSmartArtInsertPreview } from './chunk-HF2YJASV.mjs';
-import './chunk-R5GKUSHI.mjs';
+export { buildSmartArtInsertPreview } from './chunk-OD6REJDV.mjs';
+import './chunk-XZX7EHX4.mjs';
 import './chunk-A63ASSCH.mjs';
 import './chunk-DMWNOP4E.mjs';
 import './chunk-WSR2S2MY.mjs';
@@ -10,10 +10,10 @@ import './chunk-WQA3KZRB.mjs';
 import './chunk-RQJOOXRG.mjs';
 import './chunk-PI47Z46K.mjs';
 import './chunk-QX6XPYVA.mjs';
-import './chunk-72P6AWRA.mjs';
+import './chunk-67L75M6K.mjs';
 import './chunk-KY75GY5O.mjs';
 import './chunk-L55MIOBC.mjs';
-import './chunk-7DIZOCO4.mjs';
+import './chunk-FUKVYJPM.mjs';
 import './chunk-SMSCEGAE.mjs';
 import './chunk-7BHPBO2O.mjs';
 import './chunk-34LEUH5R.mjs';
@@ -24,7 +24,7 @@ import './chunk-MNSWEXYO.mjs';
 import './chunk-AMW2AR7J.mjs';
 import './chunk-2V5ATMMB.mjs';
 import './chunk-A62C6PSL.mjs';
-import './chunk-3ZI57W7O.mjs';
+import './chunk-3LOVEO7U.mjs';
 import './chunk-IXFG46KB.mjs';
 import './chunk-IEAO7N4E.mjs';
 import './chunk-XAOEDYA5.mjs';
@@ -32,7 +32,7 @@ import './chunk-PMURSMHH.mjs';
 import './chunk-T7FRLIDM.mjs';
 import './chunk-MK2ASJSY.mjs';
 import './chunk-AEQGGKRZ.mjs';
-import './chunk-LB3A3GF6.mjs';
+import './chunk-MJACF7Y2.mjs';
 import './chunk-WM5SW737.mjs';
 import './chunk-PEDGPFLR.mjs';
 import './chunk-7JBQPQ6G.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ooxml-ui",
-	"version": "1.26.2",
+	"version": "1.27.1",
 	"description": "Shared, format-neutral web components and styles for the Office viewers (Word, PowerPoint, Excel)",
 	"keywords": [
 		"custom-elements",
@@ -171,7 +171,7 @@
 		"dompurify": "^3.4.17",
 		"emf-converter": "4.21.0",
 		"lit": "^3.3.3",
-		"ooxml-core": "^1.25.2",
+		"ooxml-core": "^1.26.1",
 		"opentype.js": "^2.0.0",
 		"prosemirror-collab": "^1.3.1",
 		"prosemirror-commands": "^1.7.2",