pptx-react-viewer 4.50.0 → 4.51.0

package/dist/{chunk-JWNBTFZZ.js → chunk-Z22RD3E2.js}

@@ -1,20 +1,50 @@
 'use strict';
 
+var i18n = require('ooxml-ui/pptx/i18n');
+var React8 = require('react');
+var reactI18next = require('react-i18next');
 var pptx = require('ooxml-ui/pptx');
 var clsx = require('clsx');
 var tailwindMerge = require('tailwind-merge');
-var React8 = require('react');
 var lu = require('react-icons/lu');
 var pptx$1 = require('ooxml-core/pptx');
 var jsxRuntime = require('react/jsx-runtime');
-var i18n = require('ooxml-ui/pptx/i18n');
-var reactI18next = require('react-i18next');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var React8__default = /*#__PURE__*/_interopDefault(React8);
 
-// src/viewer/utils/animation-effects.ts
+// src/viewer/i18n/use-translation.ts
+var ViewerI18nContext = /* @__PURE__ */ React8.createContext(null);
+var PptxI18nContext = /* @__PURE__ */ React8.createContext(null);
+var NO_LOCALE_CONTROLS = {
+  localeCode: "en",
+  locales: [],
+  selectLocale: () => {
+  },
+  languageSelectable: true
+};
+var ViewerLocaleControlsContext = /* @__PURE__ */ React8.createContext(NO_LOCALE_CONTROLS);
+function useHostI18next() {
+  const { t, i18n } = reactI18next.useTranslation();
+  return { t, i18n };
+}
+
+// src/viewer/i18n/use-translation.ts
+var LABELS_ONLY = { t: (key) => i18n.keyToLabel(key), locale: "en" };
+function useHostTranslation() {
+  const { t, i18n } = useHostI18next();
+  const language = i18n.resolvedLanguage ?? i18n.language ?? "en";
+  return React8.useMemo(() => ({ t, locale: language }), [t, language]);
+}
+function useTranslation() {
+  const fromRoot = React8.useContext(ViewerI18nContext);
+  const provided = React8.useContext(PptxI18nContext);
+  const resolved = fromRoot ?? provided;
+  const [readsHost] = React8.useState(resolved === null);
+  const host = readsHost ? useHostTranslation() : null;
+  return resolved ?? host ?? LABELS_ONLY;
+}
 function getAnimationInitialStyle(preset, nativeAnimation) {
   return pptx.getAnimationInitialStyle(preset, nativeAnimation);
 }
@@ -447,7 +477,7 @@ function PresentationMediaController({
   onPlayStateChange,
   children
 }) {
-  const { t } = reactI18next.useTranslation();
+  const { t } = useTranslation();
   const mediaRef = React8.useRef(null);
   const [isMediaPlaying, setIsMediaPlaying] = React8.useState(false);
   const trimStartSec = element.trimStartMs !== void 0 ? element.trimStartMs / 1e3 : 0;
@@ -1328,7 +1358,7 @@ function renderHyperlink(run, spanNode, key, ctx) {
   );
 }
 function FollowLinkHint() {
-  const { t } = reactI18next.useTranslation();
+  const { t } = useTranslation();
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: t("pptx.linkTooltip.followLink") });
 }
 function wrapWithTextReflection(run, key, spanNode, spanStyle, baseContent) {
@@ -4210,11 +4240,14 @@ exports.DEFAULT_TEXT_FONT_SIZE = DEFAULT_TEXT_FONT_SIZE;
 exports.GRID_SIZE = GRID_SIZE;
 exports.HYPERLINK_COLOR = HYPERLINK_COLOR;
 exports.MIN_ELEMENT_SIZE = MIN_ELEMENT_SIZE;
+exports.PptxI18nContext = PptxI18nContext;
 exports.SHAPE_PRESETS = SHAPE_PRESETS;
 exports.SHORTCUT_REFERENCE_ITEMS = SHORTCUT_REFERENCE_ITEMS;
 exports.SLIDE_NAV_THUMBNAIL_WIDTH = SLIDE_NAV_THUMBNAIL_WIDTH;
 exports.TOOLBAR_SECTIONS = TOOLBAR_SECTIONS;
 exports.UNGROUPED_SECTION_ID = UNGROUPED_SECTION_ID;
+exports.ViewerI18nContext = ViewerI18nContext;
+exports.ViewerLocaleControlsContext = ViewerLocaleControlsContext;
 exports.ZOOM_TO_SELECTION_PADDING = ZOOM_TO_SELECTION_PADDING;
 exports.build3DExtrusionData = build3DExtrusionData;
 exports.buildLineGlowFilter = buildLineGlowFilter;
@@ -4250,3 +4283,5 @@ exports.shouldRenderFallbackLabel = shouldRenderFallbackLabel;
 exports.startMotionPathPreview = startMotionPathPreview;
 exports.startPreviewAnimation = startPreviewAnimation;
 exports.stopPreviewAnimation = stopPreviewAnimation;
+exports.useHostI18next = useHostI18next;
+exports.useTranslation = useTranslation;

package/dist/{chunk-77IXTLKU.mjs → chunk-ZCGYPCZM.mjs}

@@ -1,16 +1,46 @@
+import { translationsEn, keyToLabel } from 'ooxml-ui/pptx/i18n';
+import React8, { createContext, useContext, useState, useMemo, useRef, useEffect, useCallback, useLayoutEffect } from 'react';
+import { useTranslation as useTranslation$1 } from 'react-i18next';
 import { VIEWER_SHORTCUT_REFERENCE, getAnimationInitialStyle as getAnimationInitialStyle$1, cloneHistorySnapshot as cloneHistorySnapshot$1, SHAPE_PRESET_DEFS, getImageFitStyle, getImageFillCounterTransform, getComputedFillStyle, getCropShapeClipPath as getCropShapeClipPath$1, getImageTilingStyle as getImageTilingStyle$1, mediaPlaybackAttributes, getOnlineVideoEmbed, ONLINE_VIDEO_IFRAME_SANDBOX, ONLINE_VIDEO_IFRAME_ALLOW, buildTextBlockStyle, toCssWritingMode, toCssTextOrientation, toCssVerticalDirection, buildTextBodyLayoutStyle, buildTextBody3DSceneStyle as buildTextBody3DSceneStyle$1, buildParagraphs, followingText, colorWithOpacity, normalizeHexColor, hexToRgbUnit, build3DExtrusionData as build3DExtrusionData$1, getFrameEffectStyle, getComputedEffectStyle, getComputedStrokeStyle, getAnimationColorBaseStyle, isStrokeOnlyPresetElement, resolveShapeGeometry, screenStrokeWidth, markerPath, normalizeStrokeDashType, getSvgStrokeDasharray, buildSvgGradientDef, isArrowedCustomPath, buildStrokeOutline, getPresetShapeVectorGeometry, isWedgeCalloutPresetShape, svgGradientFillRef, svgLineCap, getCompoundLineOffsets, getCompoundLineWidths, canDrillDown, computeSelectionRect, DEFAULT_FONT_FAMILY as DEFAULT_FONT_FAMILY$1, cellStyleToCss, TABLE_CELL_TEXT_DEFAULTS, applyTableCellFontWeight, rectToCells, isCellInRect, tableContainerCss, buildChartViewModel, resolveChartKind, chartPreserveAspectRatio, buildNotesPdfBytes, buildTiledSlidesPdfBytes, buildPreviewAnimation, measurePreviewGeometry, buildMotionPathPreview, mediaFallbackVisual, scheduleMediaTrimAndFade, registerCrossSlideAudio, shouldShowMediaFullscreenStopButton, withInlineListDecorationDefaults, segmentStyleToCss, resolveAutoFitFontScale, applyUnderlineVariant, nestedTextDecorationStyle, scaleFontSizeForAutoFit, resolveFontKerning, resolveScriptFontSet, hasDistinctScriptFonts, authoredLetterSpacingPx, eastAsianBreaksForRun, pieceLetterSpacing, resolveMetricTrackingPx, hollowTextFillStyle, splitsUnderlineIntoWords, stripUnderlineDecoration, buildTabContext, TEXT_BUILD_ID_SEP, buildTextBuildSpec, textBuildSpanStyle, apply3dEffects as apply3dEffects$1, buildSubpathPaints, computeColumnBoundaries, computeTableMergeCrossings, columnHandleSegments, rowHandleSegments, getTableCellBandStyle as getTableCellBandStyle$1, parseDrawingColor, parseDrawingColorOpacity, getCellDiagonalBorders as getCellDiagonalBorders$1, cellParagraphBlocks, resolveChartPalette, computeChartLegendLayout, resolveChartSvgDef, mediaFallbackIcon, mediaFallbackLabelKey, MEDIA_CHROME_ATTRIBUTE, convertOmmlToMathMl, sanitizeMathMl, tableCellCss, computeResizedColumnWidths, computeResizedRowHeight, DEFAULT_ROW_HEIGHT, buildRectPathGradient, screenBorder, cellRunStyle, buildRunTabLines, chartPartToAttrs, splitWordsForUnderline, splitRunForMetrics, splitEastAsianBreaks, splitRunByScriptFont } from 'ooxml-ui/pptx';
 export { ACTION_BUTTON_PRESETS, DEFAULT_COLOR_CHANGE_TOLERANCE, INK_REPLAY_KEYFRAMES, MAX_ZOOM_SCALE, MIN_ZOOM_SCALE, SLIDE_TRANSITION_OPTIONS, TABLE_STYLE_PRESETS, applyColorChange, applyFormatToElement, applyReroutedConnectors, buildCacheKey, buildContentPartStrokes, buildCssGradientFromShapeStyle, buildInkGroupStrokes, buildSaveSlides, canvasToJpegData, clampCropValue, cloneSlide, cloneTemplateElementsBySlideId, colorWithOpacity, comparePresentation, computeHandoutLayout, copyFormatFromElement, formatCommentTimestamp, generateNoteLineCount, getAriaLabel, getAriaRole, getAriaRoleDescription, getCachedResult, getCompoundLineOffsets, getCompoundLineWidths, getContentPartReplayStyles, getElementLabel, getElementTransform, getElementTransformWithoutRotation, getImageEffectsFilter, getImageEffectsOpacity, getInkReplayStyles, getPatternSvg, getPrintableArea, getShapeAdjustmentHandleDescriptors, getSvgStrokeDasharray, getTextCompensationTransform, hasCopyableFormat, isEditableTextElement, isImageTiled, isPpactionUrl, isTemplateElementId, isUrlSafe, makeCloneId, mergeCells, normalizeHexColor, normalizeStrokeDashType, openNativeEyeDropper, parsePpactionUrl, partitionTemplateElements, rerouteConnectorsForMovedElements, safeOpenUrl, sanitizeGradientStops, setCachedResult, splitCell, stopAllPersistentAudio, substituteFieldText } from 'ooxml-ui/pptx';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
-import React8, { useRef, useState, useEffect, useCallback, useMemo, useLayoutEffect } from 'react';
 import { LuTriangle, LuPlus, LuMoveRight, LuMinus, LuDiamond, LuDatabase, LuCircle, LuSquare } from 'react-icons/lu';
 import { hasShapeProperties, isImageLikeElement, hasTextProperties, getConnectorPathGeometry as getConnectorPathGeometry$1, isCalloutShape, getCalloutLeaderLineGeometry, buildCalloutLeaderLineSvgPath, getCalloutViewBoxBounds, getSubstituteFontFamily, parsePanoseString, customGeometryPathsToSvgSubpaths, xmlText, ooxmlGradientAngleToCssDegrees } from 'ooxml-core/pptx';
 export { updateCellTextInRawXml, updateCellTextStyleInRawXml, updateMergeAttrsInRawXml } from 'ooxml-core/pptx';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { translationsEn } from 'ooxml-ui/pptx/i18n';
-import { useTranslation } from 'react-i18next';
 
-// src/viewer/utils/animation-effects.ts
+// src/viewer/i18n/use-translation.ts
+var ViewerI18nContext = /* @__PURE__ */ createContext(null);
+var PptxI18nContext = /* @__PURE__ */ createContext(null);
+var NO_LOCALE_CONTROLS = {
+  localeCode: "en",
+  locales: [],
+  selectLocale: () => {
+  },
+  languageSelectable: true
+};
+var ViewerLocaleControlsContext = /* @__PURE__ */ createContext(NO_LOCALE_CONTROLS);
+function useHostI18next() {
+  const { t, i18n } = useTranslation$1();
+  return { t, i18n };
+}
+
+// src/viewer/i18n/use-translation.ts
+var LABELS_ONLY = { t: (key) => keyToLabel(key), locale: "en" };
+function useHostTranslation() {
+  const { t, i18n } = useHostI18next();
+  const language = i18n.resolvedLanguage ?? i18n.language ?? "en";
+  return useMemo(() => ({ t, locale: language }), [t, language]);
+}
+function useTranslation() {
+  const fromRoot = useContext(ViewerI18nContext);
+  const provided = useContext(PptxI18nContext);
+  const resolved = fromRoot ?? provided;
+  const [readsHost] = useState(resolved === null);
+  const host = readsHost ? useHostTranslation() : null;
+  return resolved ?? host ?? LABELS_ONLY;
+}
 function getAnimationInitialStyle(preset, nativeAnimation) {
   return getAnimationInitialStyle$1(preset, nativeAnimation);
 }
@@ -3926,4 +3956,4 @@ function stopPreviewAnimation() {
   activePreview = null;
 }
 
-export { ANIMATION_PRESET_OPTIONS, ARROW_SIZE_OPTIONS, CONNECTOR_ARROW_OPTIONS, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_FILL_COLOR, DEFAULT_FONT_FAMILY, DEFAULT_SECTION_GROUP_ID, DEFAULT_STROKE_COLOR, DEFAULT_TABLE_COLUMNS, DEFAULT_TABLE_ROWS, DEFAULT_TEXT_COLOR, DEFAULT_TEXT_FONT_SIZE, GRID_SIZE, HYPERLINK_COLOR, MIN_ELEMENT_SIZE, SHAPE_PRESETS, SHORTCUT_REFERENCE_ITEMS, SLIDE_NAV_THUMBNAIL_WIDTH, TOOLBAR_SECTIONS, UNGROUPED_SECTION_ID, ZOOM_TO_SELECTION_PADDING, build3DExtrusionData, buildLineGlowFilter, buildLineShadowCss, buildNotesPdf, buildPdfFromTiledImageData, buildReactChartViewModel, buildTextBody3DSceneStyle, cloneHistorySnapshot, cn, getAnimationInitialStyle, getConnectorPathGeometry, getCropShapeClipPath, getDuotoneColors, getImageRenderStyle, getImageSurfaceMaskStyle, getImageSurfaceStyle, getImageTilingStyle, getShapeVisualStyle, getTextLayoutStyle, getTextStyleForElement, getTextWarpStyle, hasDagDuotoneEffect, isConnectorOrLineElement, renderChartElement, renderConnectorMarker, renderDagDuotoneSvgFilter, renderMediaElement, renderTableElement, renderTextSegments, renderVectorShape, shouldRenderFallbackLabel, startMotionPathPreview, startPreviewAnimation, stopPreviewAnimation };
+export { ANIMATION_PRESET_OPTIONS, ARROW_SIZE_OPTIONS, CONNECTOR_ARROW_OPTIONS, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_FILL_COLOR, DEFAULT_FONT_FAMILY, DEFAULT_SECTION_GROUP_ID, DEFAULT_STROKE_COLOR, DEFAULT_TABLE_COLUMNS, DEFAULT_TABLE_ROWS, DEFAULT_TEXT_COLOR, DEFAULT_TEXT_FONT_SIZE, GRID_SIZE, HYPERLINK_COLOR, MIN_ELEMENT_SIZE, PptxI18nContext, SHAPE_PRESETS, SHORTCUT_REFERENCE_ITEMS, SLIDE_NAV_THUMBNAIL_WIDTH, TOOLBAR_SECTIONS, UNGROUPED_SECTION_ID, ViewerI18nContext, ViewerLocaleControlsContext, ZOOM_TO_SELECTION_PADDING, build3DExtrusionData, buildLineGlowFilter, buildLineShadowCss, buildNotesPdf, buildPdfFromTiledImageData, buildReactChartViewModel, buildTextBody3DSceneStyle, cloneHistorySnapshot, cn, getAnimationInitialStyle, getConnectorPathGeometry, getCropShapeClipPath, getDuotoneColors, getImageRenderStyle, getImageSurfaceMaskStyle, getImageSurfaceStyle, getImageTilingStyle, getShapeVisualStyle, getTextLayoutStyle, getTextStyleForElement, getTextWarpStyle, hasDagDuotoneEffect, isConnectorOrLineElement, renderChartElement, renderConnectorMarker, renderDagDuotoneSvgFilter, renderMediaElement, renderTableElement, renderTextSegments, renderVectorShape, shouldRenderFallbackLabel, startMotionPathPreview, startPreviewAnimation, stopPreviewAnimation, useHostI18next, useTranslation };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as React$1 from 'react';
-import React$1__default from 'react';
+import React$1__default, { ReactNode, ReactElement } from 'react';
 import * as ooxml_ui_pptx from 'ooxml-ui/pptx';
 import { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, CanvasSize, DocumentStorage, ViewerAutosaveStatus, AutosaveRecord, ConnectionStatus, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, CollaborationInput, ToolbarActionId, RibbonAddInTab, ViewerCustomization, PowerPointViewerAPI, ViewerCustomizationApi, CollaborationLivePatcher, InlineListReadResult, EditorImagePasteOptions, ViewerMode, RulerUnit, ElementAnimationState, ShapeAdjustmentHandleDescriptor, InlineTextEditSnapshot, ZoomNavigationTarget, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, FreeformToolKind, ElementClipboardPayload, AnimationApplyGroup, InsertChartKind, ChangeCaseMode, SlideTemplateId, ReviewCommentsHost, CollaborationShellState, PptxAutosaveStatus } from 'ooxml-ui/pptx';
 export { AVATAR_COLOR_SWATCHES, AccountAuthConfig, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, BackstageCustomization, CANVAS_CONTEXT_MENU_COMMAND_IDS, CollaborationConfig, CollaborationShellState, ContextMenuCustomization, DEFAULT_VIEWER_PROFILE, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, HostCanvasMenuContext, HostElementMenuContext, HostMenuCommand, KeyboardCustomization, LocalStorageUsageSummary, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PowerPointViewerAPI, RIBBON_TAB_IDS, ResolvedCustomization, RibbonCustomization, SLIDE_TEMPLATES, SavedPresentationFormat, ShortcutChord, SlideTemplateId, SlideTemplateSpec, StoredViewerPrefs, THEME_CATALOG, TOOLBAR_BUTTON_IDS, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarTabId, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, VIEWER_PREFS_STORAGE_KEY, ViewerCustomization, ViewerCustomizationApi, ViewerDialogId, ViewerExportFormatId, ViewerFeatureId, ViewerMode, ViewerPanelId, ViewerProfile, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from 'ooxml-ui/pptx';
@@ -302,21 +302,21 @@ interface PowerPointViewerProps extends ViewportFitOptions {
    */
   onThemeChange?: (key: string) => void;
   /**
-   * Initial locale code for File > Options > Language. Falls back to a
-   * persisted `localStorage` choice, then `'en'`.
+   * Initial locale code for File > Options > Language. Falls back to a persisted `localStorage`
+   * choice, then `'en'`. Ignored inside a `PptxI18nProvider`, whose `locale` is the language.
    */
   defaultLocale?: string;
   /**
-   * Locale choices offered by File > Options > Language. Defaults to the
-   * codes actually registered on the host's `react-i18next` instance
-   * (mapped through the shared `LOCALE_CATALOG` for display labels).
+   * Locale choices offered by File > Options > Language. Defaults to the codes registered on the
+   * host's `react-i18next` instance. Inside a `PptxI18nProvider` there is no default: pass two or
+   * more, together with `onLocaleChange`, to show the Language category.
    */
   availableLocales?: LocaleCatalogEntry[];
   /**
-   * Called when the user picks a language from File > Options > Language.
-   * When provided, the host owns applying and persisting the choice (the
-   * viewer will not call `i18n.changeLanguage` or touch `localStorage`
-   * itself); otherwise the viewer applies and persists it directly.
+   * Called when the user picks a language from File > Options > Language. When provided, the
+   * host owns applying and persisting the choice; otherwise the viewer applies and persists it
+   * itself. Inside a `PptxI18nProvider` the host always owns the language: without this callback
+   * the Language category is left out.
    */
   onLocaleChange?: (code: string) => void;
   /**
@@ -546,6 +546,45 @@ declare function getAnimationInitialStyle(preset: PptxAnimationPreset | undefine
  * access (e.g. serialising the current content for saving).
  */
 declare const PowerPointViewer: React$1.ForwardRefExoticComponent<PowerPointViewerProps & React$1.RefAttributes<PowerPointViewerHandle>>;
+//#endregion
+//#region src/viewer/i18n/types.d.ts
+/** What the viewer passes `translate`: exactly the params of the call. */
+interface PptxTranslateParams {
+  readonly defaultValue?: string;
+  readonly count?: number;
+  readonly [name: string]: unknown;
+}
+/**
+ * A host translator for {@link PptxI18nProvider}: the text for a viewer key (`pptx.*`) in the
+ * host's active language. Return the key itself, an empty string, `null` or `undefined` for "no
+ * translation": the viewer then shows its built-in English text.
+ */
+type PptxTranslate = (key: string, params?: PptxTranslateParams) => string | null | undefined;
+//#endregion
+//#region src/viewer/i18n/provider.d.ts
+interface PptxI18nProviderProps {
+  /**
+   * Translates a viewer key; see {@link PptxTranslate}. Keep it referentially stable (a
+   * module-level function or `useCallback`): the viewer re-translates, re-rendering and re-running
+   * every translated effect, whenever `translate` or `locale` changes. To pick up messages loaded
+   * later for the same language, pass a new function.
+   */
+  readonly translate: PptxTranslate;
+  /**
+   * The host's active language: what the viewer reports and File > Options > Language shows as
+   * selected. A change re-translates the viewer, also when `translate` stays the same.
+   */
+  readonly locale: string;
+  readonly children?: ReactNode;
+}
+/**
+ * Translates every viewer component below it (`PowerPointViewer` and the standalone building
+ * blocks) through the host's own i18n library instead of react-i18next. A `PowerPointViewer`
+ * reads the provider nearest above it; a provider rendered inside the viewer is ignored, so the
+ * whole viewer shares one language. React only: the other bindings translate through their
+ * framework's i18n library or a `messages` dictionary.
+ */
+declare function PptxI18nProvider({ translate, locale, children }: PptxI18nProviderProps): ReactElement;
 
 //#region src/viewer/components/toolbar/toolbar-types.d.ts
 interface ToolbarProps {
@@ -1117,5 +1156,5 @@ declare function SlideTemplatePreview({ templateId, scheme }: SlideTemplatePrevi
  */
 declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
 
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, getAnimationInitialStyle, renderToCanvas, useViewerBuildingBlocks, useViewerTheme };
-export type { CollaborationContextValue, PowerPointViewerHandle, PowerPointViewerProps, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplatePreviewProps, ToolbarProps, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerLoadDetail };
+export { PowerPointViewer, PptxI18nProvider, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, getAnimationInitialStyle, renderToCanvas, useViewerBuildingBlocks, useViewerTheme };
+export type { CollaborationContextValue, PowerPointViewerHandle, PowerPointViewerProps, PptxI18nProviderProps, PptxTranslate, PptxTranslateParams, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplatePreviewProps, ToolbarProps, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerLoadDetail };

package/dist/index.js

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk4OF7X5EE_js = require('./chunk-4OF7X5EE.js');
-var chunkD5NXYXPP_js = require('./chunk-D5NXYXPP.js');
-var chunkJWNBTFZZ_js = require('./chunk-JWNBTFZZ.js');
+var chunkVI5DQRQZ_js = require('./chunk-VI5DQRQZ.js');
+var chunkV3XADJ2O_js = require('./chunk-V3XADJ2O.js');
+var chunkZ22RD3E2_js = require('./chunk-Z22RD3E2.js');
 require('./chunk-PIRHQTI4.js');
 var pptx = require('ooxml-ui/pptx');
 var i18n = require('ooxml-ui/pptx/i18n');
@@ -11,87 +11,91 @@ var i18n = require('ooxml-ui/pptx/i18n');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.PowerPointViewer; }
+  get: function () { return chunkVI5DQRQZ_js.PowerPointViewer; }
+});
+Object.defineProperty(exports, "PptxI18nProvider", {
+  enumerable: true,
+  get: function () { return chunkVI5DQRQZ_js.PptxI18nProvider; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.SlideCanvas; }
+  get: function () { return chunkVI5DQRQZ_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkVI5DQRQZ_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.SlideTemplatePreview; }
+  get: function () { return chunkVI5DQRQZ_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.THEME_CATALOG; }
+  get: function () { return chunkVI5DQRQZ_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.Toolbar; }
+  get: function () { return chunkVI5DQRQZ_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.ViewerThemeProvider; }
+  get: function () { return chunkVI5DQRQZ_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.defaultCssVars; }
+  get: function () { return chunkVI5DQRQZ_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.defaultRadius; }
+  get: function () { return chunkVI5DQRQZ_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.defaultThemeColors; }
+  get: function () { return chunkVI5DQRQZ_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.resolveThemeCatalogEntry; }
+  get: function () { return chunkVI5DQRQZ_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.themeToCssVars; }
+  get: function () { return chunkVI5DQRQZ_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.useViewerTheme; }
+  get: function () { return chunkVI5DQRQZ_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.vermilionDarkColors; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.vermilionDarkTheme; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.vermilionLightColors; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.vermilionLightTheme; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunk4OF7X5EE_js.vermilionRadius; }
+  get: function () { return chunkVI5DQRQZ_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkD5NXYXPP_js.renderToCanvas; }
+  get: function () { return chunkV3XADJ2O_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkD5NXYXPP_js.useViewerBuildingBlocks; }
+  get: function () { return chunkV3XADJ2O_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkJWNBTFZZ_js.getAnimationInitialStyle; }
+  get: function () { return chunkZ22RD3E2_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,

package/dist/index.mjs

@@ -1,6 +1,6 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-5JJQLK7N.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-QHGEPW5G.mjs';
-export { getAnimationInitialStyle } from './chunk-77IXTLKU.mjs';
+export { PowerPointViewer, PptxI18nProvider, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, ViewerThemeProvider, defaultCssVars, defaultRadius, defaultThemeColors, resolveThemeCatalogEntry, themeToCssVars, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius } from './chunk-ETJ752B5.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-ACFR4LFQ.mjs';
+export { getAnimationInitialStyle } from './chunk-ZCGYPCZM.mjs';
 import './chunk-UV2HVMKZ.mjs';
 export { AVATAR_COLOR_SWATCHES, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, CANVAS_CONTEXT_MENU_COMMAND_IDS, DEFAULT_VIEWER_PROFILE, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, RIBBON_TAB_IDS, SLIDE_TEMPLATES, TOOLBAR_BUTTON_IDS, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, describeCollaborationShellState, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, saveViewerProfile, savedPresentationFileName, writeStoredViewerPrefs } from 'ooxml-ui/pptx';
 export { LOCALE_CATALOG } from 'ooxml-ui/pptx/i18n';