pptx-react-viewer 3.11.0 → 3.12.0

package/dist/i18n.js

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkY6GG2OOW_js = require('./chunk-Y6GG2OOW.js');
+var chunk3AJ54EAB_js = require('./chunk-3AJ54EAB.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkY6GG2OOW_js.LOCALE_CATALOG; }
+  get: function () { return chunk3AJ54EAB_js.LOCALE_CATALOG; }
 });
 Object.defineProperty(exports, "keyToLabel", {
   enumerable: true,
-  get: function () { return chunkY6GG2OOW_js.keyToLabel; }
+  get: function () { return chunk3AJ54EAB_js.keyToLabel; }
 });
 Object.defineProperty(exports, "translationsEn", {
   enumerable: true,
-  get: function () { return chunkY6GG2OOW_js.translationsEn; }
+  get: function () { return chunk3AJ54EAB_js.translationsEn; }
 });

package/dist/i18n.mjs

@@ -1,2 +1,2 @@
-export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-TAGG5YNA.mjs';
+export { LOCALE_CATALOG, keyToLabel, translationsEn } from './chunk-HMX3MQR7.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/index.d.ts

@@ -4872,6 +4872,87 @@ interface PptxSmartArtLayoutNode {
    * interpreter-when.ts`'s `evaluateWhen`, once per entry, ANDed.
    */
   chooseGuard?: PptxSmartArtWhen[];
+  /**
+   * The chain of every enclosing `dgm:choose`'s own GROUP identity + this
+   * node's ordinal position within it + THAT branch's own condition,
+   * outermost first - identifies WHICH `dgm:choose` instance and WHERE
+   * within its own `dgm:if`/`dgm:else` list this node's branch sits, unlike
+   * {@link chooseGuard} (a flat AND-chain of every condition with no group/
+   * position identity, and no entry at all for a `dgm:else` branch, which
+   * has no condition of its own - see that field's doc comment). `id` is a
+   * synthetic, process-unique identifier assigned per `dgm:choose` instance
+   * during flattening (`smartart-layout-definition-nesting.ts`'s
+   * `nestedLayoutNodes`, a monotonic counter - NOT round-tripped, NOT the
+   * choose's own `@_name`, which is not guaranteed unique across a whole
+   * layoutDef); `ordinal` is 0-based document order within that ONE choose
+   * (every `dgm:if` in order, then `dgm:else` last, if present); `guard` is
+   * that branch's OWN condition (`undefined` for a `dgm:else` entry, which
+   * has none - deliberately kept PER-ENTRY rather than cross-referenced by
+   * index against {@link chooseGuard}, whose own length can diverge from
+   * this chain's whenever an ancestor `dgm:else` contributed a group
+   * position but no guard).
+   *
+   * Lets a consumer recover ECMA-376's real `dgm:choose` semantics - "the
+   * FIRST branch whose condition holds wins, siblings never coexist" -
+   * from the flattened `.children` array, where that grouping would
+   * otherwise be lost: `balance--hier5.pptx`'s `balance_NN`/`left_NN_M`/
+   * `right_NN_M` family (127 members across ~30 NESTED `dgm:choose`
+   * instances, not one flat 127-branch choose) needs first-match-wins
+   * WITHIN each individual choose to resolve to the single genuinely-live
+   * arrangement, not the "every guard-true node is an independent
+   * candidate" reading `smartart-layout-interpreter-composite-choose.ts`'s
+   * `collectRawCandidates` used before this field existed - see that
+   * module's own consumer of this field for the actual selection rule.
+   * `undefined` (or an empty array) for a node reached without any
+   * enclosing choose (a direct child, or a `dgm:forEach`-only path) -
+   * every PRE-EXISTING caller that does not consult this field is
+   * unaffected by its mere presence.
+   */
+  chooseGroups?: {
+    id: string;
+    ordinal: number;
+    guard?: PptxSmartArtWhen;
+  }[];
+  /**
+   * Every `dgm:presOf` candidate reachable through a `dgm:choose`/`dgm:if`/
+   * `dgm:else` wrapping THIS node's OWN presOf (as opposed to
+   * {@link chooseGuard}, which gates the layoutNode's own EXISTENCE), each
+   * tagged with the FULL chain of enclosing `dgm:if` conditions that select
+   * it (`guard`, empty for an unconditional or `dgm:else`-reached
+   * candidate), in document order (every `dgm:if` then `dgm:else` last).
+   * `undefined` when this node's presOf is not choose-guarded at all (the
+   * overwhelmingly common case) - {@link presentationOf} already carries
+   * the one-and-only value then. Exists for a genuinely conditional presOf
+   * where TWO OR MORE branches each declare a real, DIFFERENT axis
+   * (`funnel--flat3.pptx`'s `item1`/`item2`/`item3`, one literal axis per
+   * data-point count): `smartart-layout-definition-constraints.ts`'s
+   * `choosePresentationOf` (feeding {@link presentationOf}) can only ever
+   * guess ONE branch statically, at parse time, with no diagram to
+   * evaluate against; this field lets an interpret-time caller with the
+   * actual diagram (`smartart-layout-interpreter-when.ts`'s
+   * `resolvePresentationOf`, the one consumer) pick the branch PowerPoint's
+   * own runtime would, first-match-wins.
+   */
+  presentationOfCandidates?: {
+    guard: PptxSmartArtWhen[];
+    presentationOf: PptxSmartArtIteratorAttributes;
+  }[];
+  /**
+   * SESSION 17: every `dgm:rule` reachable through a `dgm:choose`/`dgm:if`/
+   * `dgm:else` wrapping THIS node's `ruleLst` (a genuinely count-gated rule
+   * set, e.g. `diverging-radial`'s own `w for="ch" forName="node"` ceiling:
+   * 6 `dgm:if cnt<=N` branches, each its own `fact`), tagged with its guard
+   * chain - the SAME shape {@link presentationOfCandidates} uses for
+   * choose-guarded `presOf`, applied to `dgm:rule`. `undefined` when not
+   * choose-guarded (`rules` above then carries the one set, the common
+   * case). See `smartart-layout-interpreter-cycle-hub-ratio.ts`'s
+   * `resolveHubToNodeRatio` (COM-verified live mechanism, not a guess) for
+   * how the guard is evaluated against the real satellite count.
+   */
+  ruleCandidates?: {
+    guard: PptxSmartArtWhen[];
+    rule: PptxSmartArtNumericRule;
+  }[];
 }
 /** Metadata and root node from DiagramML CT_DiagramDefinition. */
 interface PptxSmartArtLayoutDefinition {
@@ -12211,6 +12292,17 @@ interface ViewerAdvancedOptions {
    * for their machine. See `resolve3DRenderingFlags`.
    */
   disable3DRendering: boolean;
+  /**
+   * `p:animEffect/@filter="pixelate"` defaults to snapping the element to
+   * its end state (`cutIn`/`cutOut`), matching PowerPoint's own behaviour
+   * (COM `CreateVideo` frame-diffing shows PowerPoint performs no animation
+   * at all for this filter value). This turns on the blocky mosaic reveal
+   * this renderer can build instead, for a viewer that would rather show
+   * something animating than PowerPoint's own instant swap. See
+   * `resolveFilterEffect` in `animation-filter-effects.ts` and
+   * `docs/guide/visual-effects.md`.
+   */
+  pixelateMosaicAnimation: boolean;
   openDocumentsView: OpenDocumentsView;
   slideShowShowMenuOnRightClick: boolean;
   slideShowShowPopupToolbar: boolean;

package/dist/index.js

@@ -1,176 +1,176 @@
 'use strict';
 
-var chunk4PL3GBSD_js = require('./chunk-4PL3GBSD.js');
-require('./chunk-BX4XVY5X.js');
-var chunkMRBHJ26I_js = require('./chunk-MRBHJ26I.js');
-var chunkIK25LY4C_js = require('./chunk-IK25LY4C.js');
-var chunkLY5535CF_js = require('./chunk-LY5535CF.js');
-var chunkY6GG2OOW_js = require('./chunk-Y6GG2OOW.js');
+var chunkT7MY5L3O_js = require('./chunk-T7MY5L3O.js');
+require('./chunk-45AVHO7M.js');
+var chunkAARQTIMN_js = require('./chunk-AARQTIMN.js');
+var chunkO27KNZLJ_js = require('./chunk-O27KNZLJ.js');
+var chunk3WK4AE52_js = require('./chunk-3WK4AE52.js');
+var chunk3AJ54EAB_js = require('./chunk-3AJ54EAB.js');
 require('./chunk-4VNS5WPM.js');
 
 
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunk4PL3GBSD_js.PowerPointViewer; }
+  get: function () { return chunkT7MY5L3O_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunk4PL3GBSD_js.SlideCanvas; }
+  get: function () { return chunkT7MY5L3O_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunk4PL3GBSD_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkT7MY5L3O_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunk4PL3GBSD_js.SlideTemplatePreview; }
+  get: function () { return chunkT7MY5L3O_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunk4PL3GBSD_js.Toolbar; }
+  get: function () { return chunkT7MY5L3O_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunk4PL3GBSD_js.ViewerThemeProvider; }
+  get: function () { return chunkT7MY5L3O_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunk4PL3GBSD_js.useViewerTheme; }
+  get: function () { return chunkT7MY5L3O_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkMRBHJ26I_js.renderToCanvas; }
+  get: function () { return chunkAARQTIMN_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkMRBHJ26I_js.useViewerBuildingBlocks; }
+  get: function () { return chunkAARQTIMN_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkIK25LY4C_js.getAnimationInitialStyle; }
+  get: function () { return chunkO27KNZLJ_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.AVATAR_COLOR_SWATCHES; }
+  get: function () { return chunk3WK4AE52_js.AVATAR_COLOR_SWATCHES; }
 });
 Object.defineProperty(exports, "DEFAULT_VIEWER_PROFILE", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.DEFAULT_VIEWER_PROFILE; }
+  get: function () { return chunk3WK4AE52_js.DEFAULT_VIEWER_PROFILE; }
 });
 Object.defineProperty(exports, "PPTX_OPEN_ACCEPT", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.PPTX_OPEN_ACCEPT; }
+  get: function () { return chunk3WK4AE52_js.PPTX_OPEN_ACCEPT; }
 });
 Object.defineProperty(exports, "PRESENTATION_OPEN_EXTENSIONS", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.PRESENTATION_OPEN_EXTENSIONS; }
+  get: function () { return chunk3WK4AE52_js.PRESENTATION_OPEN_EXTENSIONS; }
 });
 Object.defineProperty(exports, "SLIDE_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.SLIDE_TEMPLATES; }
+  get: function () { return chunk3WK4AE52_js.SLIDE_TEMPLATES; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.THEME_CATALOG; }
+  get: function () { return chunk3WK4AE52_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWER_PREFS_STORAGE_KEY", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.VIEWER_PREFS_STORAGE_KEY; }
+  get: function () { return chunk3WK4AE52_js.VIEWER_PREFS_STORAGE_KEY; }
 });
 Object.defineProperty(exports, "buildSlideTemplateContent", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.buildSlideTemplateContent; }
+  get: function () { return chunk3WK4AE52_js.buildSlideTemplateContent; }
 });
 Object.defineProperty(exports, "buildSlideTemplateSlide", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.buildSlideTemplateSlide; }
+  get: function () { return chunk3WK4AE52_js.buildSlideTemplateSlide; }
 });
 Object.defineProperty(exports, "clearAllLocalViewerData", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.clearAllLocalViewerData; }
+  get: function () { return chunk3WK4AE52_js.clearAllLocalViewerData; }
 });
 Object.defineProperty(exports, "clearStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.clearStoredViewerPrefs; }
+  get: function () { return chunk3WK4AE52_js.clearStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.defaultCssVars; }
+  get: function () { return chunk3WK4AE52_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.defaultRadius; }
+  get: function () { return chunk3WK4AE52_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.defaultThemeColors; }
+  get: function () { return chunk3WK4AE52_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "getLocalStorageUsageSummary", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.getLocalStorageUsageSummary; }
+  get: function () { return chunk3WK4AE52_js.getLocalStorageUsageSummary; }
 });
 Object.defineProperty(exports, "isLegacyBinaryPresentation", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.isLegacyBinaryPresentation; }
+  get: function () { return chunk3WK4AE52_js.isLegacyBinaryPresentation; }
 });
 Object.defineProperty(exports, "isSupportedPresentationFile", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.isSupportedPresentationFile; }
+  get: function () { return chunk3WK4AE52_js.isSupportedPresentationFile; }
 });
 Object.defineProperty(exports, "presentationBaseName", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.presentationBaseName; }
+  get: function () { return chunk3WK4AE52_js.presentationBaseName; }
 });
 Object.defineProperty(exports, "readStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.readStoredViewerPrefs; }
+  get: function () { return chunk3WK4AE52_js.readStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "resolveProfileInitial", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.resolveProfileInitial; }
+  get: function () { return chunk3WK4AE52_js.resolveProfileInitial; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.resolveThemeCatalogEntry; }
+  get: function () { return chunk3WK4AE52_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "saveViewerProfile", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.saveViewerProfile; }
+  get: function () { return chunk3WK4AE52_js.saveViewerProfile; }
 });
 Object.defineProperty(exports, "savedPresentationFileName", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.savedPresentationFileName; }
+  get: function () { return chunk3WK4AE52_js.savedPresentationFileName; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.themeToCssVars; }
+  get: function () { return chunk3WK4AE52_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.vermilionDarkColors; }
+  get: function () { return chunk3WK4AE52_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.vermilionDarkTheme; }
+  get: function () { return chunk3WK4AE52_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.vermilionLightColors; }
+  get: function () { return chunk3WK4AE52_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.vermilionLightTheme; }
+  get: function () { return chunk3WK4AE52_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.vermilionRadius; }
+  get: function () { return chunk3WK4AE52_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "writeStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkLY5535CF_js.writeStoredViewerPrefs; }
+  get: function () { return chunk3WK4AE52_js.writeStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,
-  get: function () { return chunkY6GG2OOW_js.LOCALE_CATALOG; }
+  get: function () { return chunk3AJ54EAB_js.LOCALE_CATALOG; }
 });

package/dist/index.mjs

@@ -1,7 +1,7 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-N75WRHON.mjs';
-import './chunk-SUEZMQRT.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-VHFPZBUW.mjs';
-export { getAnimationInitialStyle } from './chunk-5T4Y4QPV.mjs';
-export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-6BNPHEEX.mjs';
-export { LOCALE_CATALOG } from './chunk-TAGG5YNA.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-ZOEKVSSU.mjs';
+import './chunk-2FSNTJVI.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-WRHPPTYF.mjs';
+export { getAnimationInitialStyle } from './chunk-HXDNYDRJ.mjs';
+export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-C2BDHCL2.mjs';
+export { LOCALE_CATALOG } from './chunk-HMX3MQR7.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/internals.d.ts

@@ -4852,6 +4852,87 @@ interface PptxSmartArtLayoutNode {
    * interpreter-when.ts`'s `evaluateWhen`, once per entry, ANDed.
    */
   chooseGuard?: PptxSmartArtWhen[];
+  /**
+   * The chain of every enclosing `dgm:choose`'s own GROUP identity + this
+   * node's ordinal position within it + THAT branch's own condition,
+   * outermost first - identifies WHICH `dgm:choose` instance and WHERE
+   * within its own `dgm:if`/`dgm:else` list this node's branch sits, unlike
+   * {@link chooseGuard} (a flat AND-chain of every condition with no group/
+   * position identity, and no entry at all for a `dgm:else` branch, which
+   * has no condition of its own - see that field's doc comment). `id` is a
+   * synthetic, process-unique identifier assigned per `dgm:choose` instance
+   * during flattening (`smartart-layout-definition-nesting.ts`'s
+   * `nestedLayoutNodes`, a monotonic counter - NOT round-tripped, NOT the
+   * choose's own `@_name`, which is not guaranteed unique across a whole
+   * layoutDef); `ordinal` is 0-based document order within that ONE choose
+   * (every `dgm:if` in order, then `dgm:else` last, if present); `guard` is
+   * that branch's OWN condition (`undefined` for a `dgm:else` entry, which
+   * has none - deliberately kept PER-ENTRY rather than cross-referenced by
+   * index against {@link chooseGuard}, whose own length can diverge from
+   * this chain's whenever an ancestor `dgm:else` contributed a group
+   * position but no guard).
+   *
+   * Lets a consumer recover ECMA-376's real `dgm:choose` semantics - "the
+   * FIRST branch whose condition holds wins, siblings never coexist" -
+   * from the flattened `.children` array, where that grouping would
+   * otherwise be lost: `balance--hier5.pptx`'s `balance_NN`/`left_NN_M`/
+   * `right_NN_M` family (127 members across ~30 NESTED `dgm:choose`
+   * instances, not one flat 127-branch choose) needs first-match-wins
+   * WITHIN each individual choose to resolve to the single genuinely-live
+   * arrangement, not the "every guard-true node is an independent
+   * candidate" reading `smartart-layout-interpreter-composite-choose.ts`'s
+   * `collectRawCandidates` used before this field existed - see that
+   * module's own consumer of this field for the actual selection rule.
+   * `undefined` (or an empty array) for a node reached without any
+   * enclosing choose (a direct child, or a `dgm:forEach`-only path) -
+   * every PRE-EXISTING caller that does not consult this field is
+   * unaffected by its mere presence.
+   */
+  chooseGroups?: {
+    id: string;
+    ordinal: number;
+    guard?: PptxSmartArtWhen;
+  }[];
+  /**
+   * Every `dgm:presOf` candidate reachable through a `dgm:choose`/`dgm:if`/
+   * `dgm:else` wrapping THIS node's OWN presOf (as opposed to
+   * {@link chooseGuard}, which gates the layoutNode's own EXISTENCE), each
+   * tagged with the FULL chain of enclosing `dgm:if` conditions that select
+   * it (`guard`, empty for an unconditional or `dgm:else`-reached
+   * candidate), in document order (every `dgm:if` then `dgm:else` last).
+   * `undefined` when this node's presOf is not choose-guarded at all (the
+   * overwhelmingly common case) - {@link presentationOf} already carries
+   * the one-and-only value then. Exists for a genuinely conditional presOf
+   * where TWO OR MORE branches each declare a real, DIFFERENT axis
+   * (`funnel--flat3.pptx`'s `item1`/`item2`/`item3`, one literal axis per
+   * data-point count): `smartart-layout-definition-constraints.ts`'s
+   * `choosePresentationOf` (feeding {@link presentationOf}) can only ever
+   * guess ONE branch statically, at parse time, with no diagram to
+   * evaluate against; this field lets an interpret-time caller with the
+   * actual diagram (`smartart-layout-interpreter-when.ts`'s
+   * `resolvePresentationOf`, the one consumer) pick the branch PowerPoint's
+   * own runtime would, first-match-wins.
+   */
+  presentationOfCandidates?: {
+    guard: PptxSmartArtWhen[];
+    presentationOf: PptxSmartArtIteratorAttributes;
+  }[];
+  /**
+   * SESSION 17: every `dgm:rule` reachable through a `dgm:choose`/`dgm:if`/
+   * `dgm:else` wrapping THIS node's `ruleLst` (a genuinely count-gated rule
+   * set, e.g. `diverging-radial`'s own `w for="ch" forName="node"` ceiling:
+   * 6 `dgm:if cnt<=N` branches, each its own `fact`), tagged with its guard
+   * chain - the SAME shape {@link presentationOfCandidates} uses for
+   * choose-guarded `presOf`, applied to `dgm:rule`. `undefined` when not
+   * choose-guarded (`rules` above then carries the one set, the common
+   * case). See `smartart-layout-interpreter-cycle-hub-ratio.ts`'s
+   * `resolveHubToNodeRatio` (COM-verified live mechanism, not a guess) for
+   * how the guard is evaluated against the real satellite count.
+   */
+  ruleCandidates?: {
+    guard: PptxSmartArtWhen[];
+    rule: PptxSmartArtNumericRule;
+  }[];
 }
 /** Metadata and root node from DiagramML CT_DiagramDefinition. */
 interface PptxSmartArtLayoutDefinition {
@@ -12378,6 +12459,17 @@ interface ViewerAdvancedOptions {
    * for their machine. See `resolve3DRenderingFlags`.
    */
   disable3DRendering: boolean;
+  /**
+   * `p:animEffect/@filter="pixelate"` defaults to snapping the element to
+   * its end state (`cutIn`/`cutOut`), matching PowerPoint's own behaviour
+   * (COM `CreateVideo` frame-diffing shows PowerPoint performs no animation
+   * at all for this filter value). This turns on the blocky mosaic reveal
+   * this renderer can build instead, for a viewer that would rather show
+   * something animating than PowerPoint's own instant swap. See
+   * `resolveFilterEffect` in `animation-filter-effects.ts` and
+   * `docs/guide/visual-effects.md`.
+   */
+  pixelateMosaicAnimation: boolean;
   openDocumentsView: OpenDocumentsView;
   slideShowShowMenuOnRightClick: boolean;
   slideShowShowPopupToolbar: boolean;
@@ -12537,6 +12629,37 @@ interface CompatibilityWarningToast {
   /** `{{code}}` for the generic fallback key; `undefined` for a mapped code. */
   readonly params?: Readonly<Record<string, string>>;
 }
+//#endregion
+//#region src/render/run-program-notice.d.ts
+/**
+ * run-program-notice.ts: turn a resolved `ppaction://program` command string
+ * into the non-blocking notice a binding should show during a running show.
+ *
+ * PowerPoint's "Run program" action (`a:hlinkClick` -> `ppaction://program`,
+ * `packages/shared/src/render/presentation-action.ts`'s `runProgram` intent)
+ * names a free-text "Program to run:" command the author typed, e.g.
+ * `notepad.exe C:\temp\notes.txt`. Path and arguments are ONE unstructured
+ * string; OOXML has no separate arguments field, so this module does not try
+ * to split one out.
+ *
+ * A browser cannot launch a local executable, so the honest behavior on
+ * click is: show the presenter a small, dismissible notice naming the exact
+ * command PowerPoint would have run, with a Copy button, rather than doing
+ * nothing (silently) or blocking the show with a modal dialog.
+ *
+ * Framework-agnostic: no React, Vue, Angular, Svelte or DOM imports.
+ */
+/** A run-program notice ready for a binding's toast/notice UI to render. */
+interface RunProgramNotice {
+  /** Stable id for this invocation, so a binding can dedupe/key a toast list. */
+  readonly id: string;
+  /** The exact resolved command string (path plus whatever arguments the author typed). */
+  readonly target: string;
+  /** i18n key for the notice body. Interpolates `{{target}}`. */
+  readonly messageKey: string;
+  /** i18n key for the Copy button label. */
+  readonly copyLabelKey: string;
+}
 
 //#region src/viewer/types-core.d.ts
 /**
@@ -13820,6 +13943,14 @@ interface UsePresentationModeInput {
   };
   /** The deck's resolved theme colour map, for a scheme-colour (`a:schemeClr`) animation stop. */
   themeColorMap?: Readonly<Record<string, string>>;
+  /**
+   * `viewerOptions.advanced.pixelateMosaicAnimation`. `true` plays the
+   * blocky mosaic reveal for `p:animEffect/@filter="pixelate"`; omitted or
+   * `false` (the default, matching PowerPoint's own behaviour) snaps the
+   * element to its end state. See `resolveFilterEffect`'s doc in
+   * `pptx-viewer-shared`'s `animation-filter-effects.ts`.
+   */
+  pixelateMosaicAnimation?: boolean;
   activeSlideIndex: number;
   containerRef: React.RefObject<HTMLElement | null>;
   /** Raw PPTX bytes: forwarded to audience window for content sharing. */
@@ -13872,6 +14003,13 @@ interface UsePresentationModeInput {
   activeCustomShowId?: string | null;
   /** Switch the active custom show (does not itself navigate). */
   onSetActiveCustomShowId?: (id: string | null) => void;
+  /**
+   * Push a `ppaction://program` ("Run program") notice onto the running
+   * show's toast stack, naming the command PowerPoint would have run since
+   * a browser cannot launch it. Fire-and-forget: the click still counts as
+   * handled regardless of whether this is wired up.
+   */
+  onAddRunProgramNotice?: (notice: RunProgramNotice) => void;
 }
 interface UsePresentationModeResult {
   presentationSlideIndex: number;
@@ -15649,6 +15787,13 @@ interface UsePresentationSetupInput {
   onSetActiveCustomShowId?: (id: string | null) => void;
   /** Options > Advanced > "End with black slide" (default true). */
   endWithBlackSlide?: boolean;
+  /**
+   * Options > Advanced > "Show a mosaic effect for Pixelate transitions"
+   * (default false, matching PowerPoint's own instant-swap behaviour for
+   * `p:animEffect/@filter="pixelate"`). See `resolveFilterEffect`'s doc in
+   * `pptx-viewer-shared`'s `animation-filter-effects.ts`.
+   */
+  pixelateMosaicAnimation?: boolean;
   /**
    * Options > Advanced > "Prompt to keep ink annotations when exiting"
    * (default true). When false, exits skip the keep/discard dialog.
@@ -15662,6 +15807,8 @@ interface UsePresentationSetupInput {
    * without this callback the key is mapped and then lands nowhere.
    */
   onToggleSubtitles?: () => void;
+  /** `ppaction://program`: push a non-blocking "cannot launch this" notice. */
+  onAddRunProgramNotice?: (notice: RunProgramNotice) => void;
 }
 interface PresentationSetupResult {
   presentation: UsePresentationModeResult;
@@ -16387,6 +16534,14 @@ interface UseAnimationPlaybackInput {
   };
   /** The deck's resolved theme colour map, for a scheme-colour (`a:schemeClr`) animation stop. */
   themeColorMap?: Readonly<Record<string, string>>;
+  /**
+   * `viewerOptions.advanced.pixelateMosaicAnimation`. `true` plays the
+   * blocky mosaic reveal for `p:animEffect/@filter="pixelate"`; omitted or
+   * `false` (the default, matching PowerPoint's own behaviour) snaps the
+   * element to its end state. See `resolveFilterEffect`'s doc in
+   * `pptx-viewer-shared`'s `animation-filter-effects.ts`.
+   */
+  pixelateMosaicAnimation?: boolean;
 }
 /** How a slide's animation timeline should be seeded when it becomes active. */
 interface SeedSlideAnimationOptions {
@@ -16551,6 +16706,8 @@ interface UseSlideNavigationInput {
   onPlayMedia?: (elementId: string | undefined) => void;
   /** `ppaction://ole?verb=<n>`. */
   onOleVerb?: (verb: number, elementId: string | undefined) => void;
+  /** `ppaction://program`. */
+  onRunProgram?: (target: string) => void;
 }
 interface UseSlideNavigationResult {
   movePresentationSlide: (direction: 1 | -1, trigger?: SlideAdvanceTrigger) => void;