pptx-react-viewer 3.13.0 → 3.15.0

package/dist/index.d.ts

@@ -4682,7 +4682,7 @@ interface PptxSmartArtNumericRule extends PptxSmartArtConstraintTarget {
   rawXml?: XmlObject;
 }
 //#endregion
-//#region src/core/types/smart-art-layout-definition.d.ts
+//#region src/core/types/smart-art-layout-primitives.d.ts
 interface PptxSmartArtLocalizedText {
   value: string;
   language?: string;
@@ -4757,6 +4757,8 @@ interface PptxSmartArtLayoutNodeShape {
    */
   lkTxEntry?: boolean;
 }
+//#endregion
+//#region src/core/types/smart-art-layout-definition.d.ts
 /** Identity and ordering metadata from DiagramML CT_LayoutNode. */
 interface PptxSmartArtLayoutNode {
   name?: string;
@@ -4872,6 +4874,30 @@ interface PptxSmartArtLayoutNode {
    * interpreter-when.ts`'s `evaluateWhen`, once per entry, ANDed.
    */
   chooseGuard?: PptxSmartArtWhen[];
+  /**
+   * ROUND 42: the forEach iterator active WHEN EACH ENTRY of {@link
+   * chooseGuard} was declared (index-parallel with it, `undefined` per
+   * entry when no forEach was active at that point) - NOT the same as
+   * {@link forEachOrigin}, which is always this NODE's own single nearest
+   * enclosing forEach, however deep. A `dgm:if` declared ABOVE a `dgm:forEach`
+   * that this node's own branch happens to descend through afterwards needs
+   * ITS OWN, SHALLOWER anchor for a `func="cnt"`/`"maxDepth"`-family
+   * `@axis` condition, not this node's deeper one - `funnel--flat3.pptx`'s
+   * `item1`/`item2`/`item3` (`chooseGuard: [Name5's axis="ch" func="cnt"
+   * op="gte" val="1"]`, declared directly under the composite root, BEFORE
+   * each item's own per-item `dgm:forEach axis="ch" st="2"/"3"/"4" cnt="1"`)
+   * is exactly this shape: evaluating Name5's condition anchored to item1's
+   * OWN forEach binding (one specific data point, with no children of its
+   * own in a flat dataset) wrongly resolves its `axis="ch"` child count to
+   * 0 instead of the diagram's real top-level count, dropping the item
+   * entirely - `chooseGuardOrigins[i]` for that entry is `undefined`
+   * (Name5 sits above ANY forEach), so the guard correctly stays
+   * root-relative. See `smartart-layout-interpreter-composite-
+   * candidates.ts`'s `guardAllows`, the one production consumer.
+   * `undefined` whenever {@link chooseGuard} itself is (no enclosing
+   * choose at all).
+   */
+  chooseGuardOrigins?: (PptxSmartArtIteratorAttributes | undefined)[];
   /**
    * The chain of every enclosing `dgm:choose`'s own GROUP identity + this
    * node's ordinal position within it + THAT branch's own condition,
@@ -4907,11 +4933,20 @@ interface PptxSmartArtLayoutNode {
    * 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.
+   *
+   * ROUND 42: `origin` is the forEach iterator active when THIS branch's
+   * own `dgm:if`/`dgm:else` was declared (the SAME "declaration time, not
+   * whatever descendant ends up carrying it" concept {@link
+   * chooseGuardOrigins} exists for) - the anchor a `func="cnt"`/`"maxDepth"`
+   * -family condition in `guard` needs, NOT a representative member's own
+   * (possibly deeper) `forEachOrigin`. See `smartart-layout-interpreter-
+   * composite-choose-groups.ts`'s `winningOrdinalFor`, the one consumer.
    */
   chooseGroups?: {
     id: string;
     ordinal: number;
     guard?: PptxSmartArtWhen;
+    origin?: PptxSmartArtIteratorAttributes;
   }[];
   /**
    * Every `dgm:presOf` candidate reachable through a `dgm:choose`/`dgm:if`/
@@ -4953,6 +4988,24 @@ interface PptxSmartArtLayoutNode {
     guard: PptxSmartArtWhen[];
     rule: PptxSmartArtNumericRule;
   }[];
+  /**
+   * ROUND 39: every `dgm:constr` reachable through a `dgm:choose`/`dgm:if`/
+   * `dgm:else` wrapping THIS node's `constrLst` (a genuinely count/position
+   * -branched constraint set, e.g. `basic-venn--flat3.pptx`'s composite
+   * `Name9` choose, one `ctrX`/`ctrY`/`w`/`h` per data-point-count branch
+   * for `circ1`/`circ1Tx`/...), each tagged with its guard chain - the SAME
+   * shape {@link presentationOfCandidates}/{@link ruleCandidates} use,
+   * applied to `dgm:constr`. `undefined` when not choose-guarded
+   * (`allConstraints`/`constraints` above then carry the one set, the
+   * common case). See `smartart-constraint-branch-index.ts`'s
+   * `selectConstraints` for how the guard is evaluated against the real
+   * diagram, and that module's own doc comment for why `allConstraints`'s
+   * pre-existing blind union of every branch is not enough on its own.
+   */
+  constraintCandidates?: {
+    guard: PptxSmartArtWhen[];
+    constraint: PptxSmartArtConstraint;
+  }[];
 }
 /** Metadata and root node from DiagramML CT_DiagramDefinition. */
 interface PptxSmartArtLayoutDefinition {

package/dist/index.js

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkUGVPKJSU_js = require('./chunk-UGVPKJSU.js');
-require('./chunk-G2Z7QULX.js');
-var chunkH3GHGSGW_js = require('./chunk-H3GHGSGW.js');
-var chunkIVCYND7A_js = require('./chunk-IVCYND7A.js');
-var chunkTWUAZRCG_js = require('./chunk-TWUAZRCG.js');
+var chunkQ6CSZ7VM_js = require('./chunk-Q6CSZ7VM.js');
+require('./chunk-VVJTEFGP.js');
+var chunkLAB7WX2N_js = require('./chunk-LAB7WX2N.js');
+var chunkGLY4OPMY_js = require('./chunk-GLY4OPMY.js');
+var chunk5KAMDV37_js = require('./chunk-5KAMDV37.js');
 var chunk3AJ54EAB_js = require('./chunk-3AJ54EAB.js');
 require('./chunk-4VNS5WPM.js');
 
@@ -12,163 +12,163 @@ require('./chunk-4VNS5WPM.js');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunkUGVPKJSU_js.PowerPointViewer; }
+  get: function () { return chunkQ6CSZ7VM_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunkUGVPKJSU_js.SlideCanvas; }
+  get: function () { return chunkQ6CSZ7VM_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunkUGVPKJSU_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkQ6CSZ7VM_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunkUGVPKJSU_js.SlideTemplatePreview; }
+  get: function () { return chunkQ6CSZ7VM_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunkUGVPKJSU_js.Toolbar; }
+  get: function () { return chunkQ6CSZ7VM_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunkUGVPKJSU_js.ViewerThemeProvider; }
+  get: function () { return chunkQ6CSZ7VM_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunkUGVPKJSU_js.useViewerTheme; }
+  get: function () { return chunkQ6CSZ7VM_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkH3GHGSGW_js.renderToCanvas; }
+  get: function () { return chunkLAB7WX2N_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkH3GHGSGW_js.useViewerBuildingBlocks; }
+  get: function () { return chunkLAB7WX2N_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkIVCYND7A_js.getAnimationInitialStyle; }
+  get: function () { return chunkGLY4OPMY_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.AVATAR_COLOR_SWATCHES; }
+  get: function () { return chunk5KAMDV37_js.AVATAR_COLOR_SWATCHES; }
 });
 Object.defineProperty(exports, "DEFAULT_VIEWER_PROFILE", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.DEFAULT_VIEWER_PROFILE; }
+  get: function () { return chunk5KAMDV37_js.DEFAULT_VIEWER_PROFILE; }
 });
 Object.defineProperty(exports, "PPTX_OPEN_ACCEPT", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.PPTX_OPEN_ACCEPT; }
+  get: function () { return chunk5KAMDV37_js.PPTX_OPEN_ACCEPT; }
 });
 Object.defineProperty(exports, "PRESENTATION_OPEN_EXTENSIONS", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.PRESENTATION_OPEN_EXTENSIONS; }
+  get: function () { return chunk5KAMDV37_js.PRESENTATION_OPEN_EXTENSIONS; }
 });
 Object.defineProperty(exports, "SLIDE_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.SLIDE_TEMPLATES; }
+  get: function () { return chunk5KAMDV37_js.SLIDE_TEMPLATES; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.THEME_CATALOG; }
+  get: function () { return chunk5KAMDV37_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWER_PREFS_STORAGE_KEY", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.VIEWER_PREFS_STORAGE_KEY; }
+  get: function () { return chunk5KAMDV37_js.VIEWER_PREFS_STORAGE_KEY; }
 });
 Object.defineProperty(exports, "buildSlideTemplateContent", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.buildSlideTemplateContent; }
+  get: function () { return chunk5KAMDV37_js.buildSlideTemplateContent; }
 });
 Object.defineProperty(exports, "buildSlideTemplateSlide", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.buildSlideTemplateSlide; }
+  get: function () { return chunk5KAMDV37_js.buildSlideTemplateSlide; }
 });
 Object.defineProperty(exports, "clearAllLocalViewerData", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.clearAllLocalViewerData; }
+  get: function () { return chunk5KAMDV37_js.clearAllLocalViewerData; }
 });
 Object.defineProperty(exports, "clearStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.clearStoredViewerPrefs; }
+  get: function () { return chunk5KAMDV37_js.clearStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.defaultCssVars; }
+  get: function () { return chunk5KAMDV37_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.defaultRadius; }
+  get: function () { return chunk5KAMDV37_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.defaultThemeColors; }
+  get: function () { return chunk5KAMDV37_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "getLocalStorageUsageSummary", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.getLocalStorageUsageSummary; }
+  get: function () { return chunk5KAMDV37_js.getLocalStorageUsageSummary; }
 });
 Object.defineProperty(exports, "isLegacyBinaryPresentation", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.isLegacyBinaryPresentation; }
+  get: function () { return chunk5KAMDV37_js.isLegacyBinaryPresentation; }
 });
 Object.defineProperty(exports, "isSupportedPresentationFile", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.isSupportedPresentationFile; }
+  get: function () { return chunk5KAMDV37_js.isSupportedPresentationFile; }
 });
 Object.defineProperty(exports, "presentationBaseName", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.presentationBaseName; }
+  get: function () { return chunk5KAMDV37_js.presentationBaseName; }
 });
 Object.defineProperty(exports, "readStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.readStoredViewerPrefs; }
+  get: function () { return chunk5KAMDV37_js.readStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "resolveProfileInitial", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.resolveProfileInitial; }
+  get: function () { return chunk5KAMDV37_js.resolveProfileInitial; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.resolveThemeCatalogEntry; }
+  get: function () { return chunk5KAMDV37_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "saveViewerProfile", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.saveViewerProfile; }
+  get: function () { return chunk5KAMDV37_js.saveViewerProfile; }
 });
 Object.defineProperty(exports, "savedPresentationFileName", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.savedPresentationFileName; }
+  get: function () { return chunk5KAMDV37_js.savedPresentationFileName; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.themeToCssVars; }
+  get: function () { return chunk5KAMDV37_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.vermilionDarkColors; }
+  get: function () { return chunk5KAMDV37_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.vermilionDarkTheme; }
+  get: function () { return chunk5KAMDV37_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.vermilionLightColors; }
+  get: function () { return chunk5KAMDV37_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.vermilionLightTheme; }
+  get: function () { return chunk5KAMDV37_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.vermilionRadius; }
+  get: function () { return chunk5KAMDV37_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "writeStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkTWUAZRCG_js.writeStoredViewerPrefs; }
+  get: function () { return chunk5KAMDV37_js.writeStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,

package/dist/index.mjs

@@ -1,7 +1,7 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-PKHTTHA2.mjs';
-import './chunk-HB7DJENT.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-M7SNS3DQ.mjs';
-export { getAnimationInitialStyle } from './chunk-Y3SA5H5H.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-TS2DHMBS.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-6547ZWC7.mjs';
+import './chunk-AT4BJKON.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-C4Q4WYAJ.mjs';
+export { getAnimationInitialStyle } from './chunk-J7Q7AGN7.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-YNTZCMRI.mjs';
 export { LOCALE_CATALOG } from './chunk-HMX3MQR7.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/internals.d.ts

@@ -4662,7 +4662,7 @@ interface PptxSmartArtNumericRule extends PptxSmartArtConstraintTarget {
   rawXml?: XmlObject;
 }
 //#endregion
-//#region src/core/types/smart-art-layout-definition.d.ts
+//#region src/core/types/smart-art-layout-primitives.d.ts
 interface PptxSmartArtLocalizedText {
   value: string;
   language?: string;
@@ -4737,6 +4737,8 @@ interface PptxSmartArtLayoutNodeShape {
    */
   lkTxEntry?: boolean;
 }
+//#endregion
+//#region src/core/types/smart-art-layout-definition.d.ts
 /** Identity and ordering metadata from DiagramML CT_LayoutNode. */
 interface PptxSmartArtLayoutNode {
   name?: string;
@@ -4852,6 +4854,30 @@ interface PptxSmartArtLayoutNode {
    * interpreter-when.ts`'s `evaluateWhen`, once per entry, ANDed.
    */
   chooseGuard?: PptxSmartArtWhen[];
+  /**
+   * ROUND 42: the forEach iterator active WHEN EACH ENTRY of {@link
+   * chooseGuard} was declared (index-parallel with it, `undefined` per
+   * entry when no forEach was active at that point) - NOT the same as
+   * {@link forEachOrigin}, which is always this NODE's own single nearest
+   * enclosing forEach, however deep. A `dgm:if` declared ABOVE a `dgm:forEach`
+   * that this node's own branch happens to descend through afterwards needs
+   * ITS OWN, SHALLOWER anchor for a `func="cnt"`/`"maxDepth"`-family
+   * `@axis` condition, not this node's deeper one - `funnel--flat3.pptx`'s
+   * `item1`/`item2`/`item3` (`chooseGuard: [Name5's axis="ch" func="cnt"
+   * op="gte" val="1"]`, declared directly under the composite root, BEFORE
+   * each item's own per-item `dgm:forEach axis="ch" st="2"/"3"/"4" cnt="1"`)
+   * is exactly this shape: evaluating Name5's condition anchored to item1's
+   * OWN forEach binding (one specific data point, with no children of its
+   * own in a flat dataset) wrongly resolves its `axis="ch"` child count to
+   * 0 instead of the diagram's real top-level count, dropping the item
+   * entirely - `chooseGuardOrigins[i]` for that entry is `undefined`
+   * (Name5 sits above ANY forEach), so the guard correctly stays
+   * root-relative. See `smartart-layout-interpreter-composite-
+   * candidates.ts`'s `guardAllows`, the one production consumer.
+   * `undefined` whenever {@link chooseGuard} itself is (no enclosing
+   * choose at all).
+   */
+  chooseGuardOrigins?: (PptxSmartArtIteratorAttributes | undefined)[];
   /**
    * The chain of every enclosing `dgm:choose`'s own GROUP identity + this
    * node's ordinal position within it + THAT branch's own condition,
@@ -4887,11 +4913,20 @@ interface PptxSmartArtLayoutNode {
    * 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.
+   *
+   * ROUND 42: `origin` is the forEach iterator active when THIS branch's
+   * own `dgm:if`/`dgm:else` was declared (the SAME "declaration time, not
+   * whatever descendant ends up carrying it" concept {@link
+   * chooseGuardOrigins} exists for) - the anchor a `func="cnt"`/`"maxDepth"`
+   * -family condition in `guard` needs, NOT a representative member's own
+   * (possibly deeper) `forEachOrigin`. See `smartart-layout-interpreter-
+   * composite-choose-groups.ts`'s `winningOrdinalFor`, the one consumer.
    */
   chooseGroups?: {
     id: string;
     ordinal: number;
     guard?: PptxSmartArtWhen;
+    origin?: PptxSmartArtIteratorAttributes;
   }[];
   /**
    * Every `dgm:presOf` candidate reachable through a `dgm:choose`/`dgm:if`/
@@ -4933,6 +4968,24 @@ interface PptxSmartArtLayoutNode {
     guard: PptxSmartArtWhen[];
     rule: PptxSmartArtNumericRule;
   }[];
+  /**
+   * ROUND 39: every `dgm:constr` reachable through a `dgm:choose`/`dgm:if`/
+   * `dgm:else` wrapping THIS node's `constrLst` (a genuinely count/position
+   * -branched constraint set, e.g. `basic-venn--flat3.pptx`'s composite
+   * `Name9` choose, one `ctrX`/`ctrY`/`w`/`h` per data-point-count branch
+   * for `circ1`/`circ1Tx`/...), each tagged with its guard chain - the SAME
+   * shape {@link presentationOfCandidates}/{@link ruleCandidates} use,
+   * applied to `dgm:constr`. `undefined` when not choose-guarded
+   * (`allConstraints`/`constraints` above then carry the one set, the
+   * common case). See `smartart-constraint-branch-index.ts`'s
+   * `selectConstraints` for how the guard is evaluated against the real
+   * diagram, and that module's own doc comment for why `allConstraints`'s
+   * pre-existing blind union of every branch is not enough on its own.
+   */
+  constraintCandidates?: {
+    guard: PptxSmartArtWhen[];
+    constraint: PptxSmartArtConstraint;
+  }[];
 }
 /** Metadata and root node from DiagramML CT_DiagramDefinition. */
 interface PptxSmartArtLayoutDefinition {
@@ -15142,6 +15195,7 @@ interface UseSlideManagementInput {
 }
 interface SlideManagementHandlers {
   handleAddSlide: () => void;
+  handleAddSlideAfter: (afterIndex: number) => void;
   handleMoveSlide: (fromIndex: number, toIndex: number) => void;
   handleSlideContextMenu: (e: React$1.MouseEvent, index: number) => void;
   handleDeleteSlides: (indexes: number[]) => void;
@@ -15327,6 +15381,17 @@ interface UseExportHandlersInput {
    * behavior) when omitted.
    */
   imageExportScale?: number;
+  /**
+   * The raw `resolveImageResolutionScale(viewerOptions)` multiplier (1 at the
+   * default "High fidelity" preset), fed into the shared
+   * `resolveExportCaptureDecision` for GIF/video capture scale. Distinct from
+   * `imageExportScale` (which already has the PNG/PDF 2x baseline folded in):
+   * GIF/video derive their own baseline from this via the shared decision
+   * function instead of reusing `imageExportScale` outright, so a future
+   * GIF/video-specific baseline change only touches that one function.
+   * Defaults to 1 when omitted.
+   */
+  imageResolutionScale?: number;
 }
 interface ExportHandlersResult {
   handleExportPng: () => Promise<void>;
@@ -15894,6 +15959,12 @@ interface UseIOHandlersInput {
   onContentChange: ((content: Uint8Array) => void) | undefined;
   /** File > Options > Advanced > "Image Size and Quality" raster-scale multiplier. */
   imageExportScale?: number;
+  /**
+   * The raw `resolveImageResolutionScale(viewerOptions)` multiplier, fed into
+   * GIF/video export's shared `resolveExportCaptureDecision`. See the
+   * matching field on `UseExportHandlersInput`.
+   */
+  imageResolutionScale?: number;
 }
 interface IOHandlersResult {
   exportHandlers: ExportHandlersResult;
@@ -16036,6 +16107,12 @@ interface UseViewerIntegrationInput {
    * copy-slide-as-image so the option actually controls output resolution.
    */
   imageExportScale?: number;
+  /**
+   * The raw `resolveImageResolutionScale(viewerOptions)` multiplier, fed into
+   * GIF/video export's shared `resolveExportCaptureDecision`. See the
+   * matching field on `UseExportHandlersInput`.
+   */
+  imageResolutionScale?: number;
   mode: ViewerState['mode'];
   slides: PptxSlide[];
   activeSlide: PptxSlide | undefined;
@@ -16231,7 +16308,12 @@ interface VirtualizedSlidesResult extends VirtualizedRange {
 declare function useVirtualizedSlides({ totalItems, itemHeight, overscan }: VirtualizedSlidesOptions): VirtualizedSlidesResult;
 //#endregion
 //#region src/viewer/hooks/useIsMobile.d.ts
-/** Minimum touch target size (px) per WCAG accessibility guidelines. */
+/**
+ * Minimum touch target size (px) per WCAG accessibility guidelines. Re-exported
+ * from `pptx-viewer-shared`'s `MIN_TOUCH_TARGET_PX` (the single source of truth
+ * every binding's dense-panel controls size against) under this module's
+ * existing name, for API stability.
+ */
 declare const MIN_TOUCH_TARGET = 44;
 interface UseIsMobileResult {
   /** True when the browser viewport width is below 768px. */
@@ -16246,6 +16328,10 @@ interface UseIsMobileResult {
   orientation: DeviceOrientation;
   /** True when the virtual keyboard is likely visible (viewport height shrank significantly). */
   isVirtualKeyboardOpen: boolean;
+  /** Raw browser viewport width (px), for decision functions that need more than a tier flag. */
+  viewportWidth: number;
+  /** Raw browser viewport height (px). */
+  viewportHeight: number;
 }
 declare function useIsMobile(): UseIsMobileResult;
 //#endregion