pptx-react-viewer 1.10.2 → 1.12.0

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to this project are documented here.
 This file is generated from [Conventional Commits](https://www.conventionalcommits.org)
 by [git-cliff](https://git-cliff.org); do not edit it by hand.
 
+## [1.11.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.11.0) - 2026-07-09
+
+### Features
+
+- **shared:** Add vermilion light/dark theme presets to all bindings (by @ChristopherVR) ([1b6e816](https://github.com/ChristopherVR/pptx-viewer/commit/1b6e8161679a3f984cbfedb09ece0c8c01570c0a))
+
+### Other
+
+- Reconcile with origin/main before push (by @ChristopherVR) ([10acef8](https://github.com/ChristopherVR/pptx-viewer/commit/10acef81a7f5d79e778e4e4464d956cc84682f7c))
+
+## [1.10.2](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.10.2) - 2026-07-09
+
+### Other
+
+- Reconcile with origin/main before push (by @ChristopherVR) ([b8c46bc](https://github.com/ChristopherVR/pptx-viewer/commit/b8c46bc3622e301d3365f5c489144e5aa5401782))
+
 ## [1.10.1](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.10.1) - 2026-07-09
 
 ## [1.10.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.10.0) - 2026-07-08

package/README.md

@@ -167,6 +167,16 @@ Override specific values with the `theme` prop:
 
 All `ViewerTheme.colors` keys are optional; override only what you need. Helpers `defaultThemeColors`, `defaultRadius`, `themeToCssVars`, `defaultCssVars`, `ViewerThemeProvider`, and `useViewerTheme` are exported for advanced use. See the [full docs](https://christophervr.github.io/pptx-viewer/) for the complete token list.
 
+Two ready-made presets ship with the package: `vermilionLightTheme` (warm paper canvas) and `vermilionDarkTheme` (dimmed presenter room), the same vermilion brand look as the [documentation site](https://christophervr.github.io/pptx-viewer/):
+
+```tsx
+import { PowerPointViewer, vermilionLightTheme } from 'pptx-react-viewer';
+
+<PowerPointViewer content={bytes} theme={vermilionLightTheme} />;
+```
+
+The underlying palettes (`vermilionLightColors`, `vermilionDarkColors`) and radius (`vermilionRadius`) are exported too, so you can spread them into your own variant.
+
 ## Localization (i18n)
 
 UI labels go through [i18next](https://www.i18next.com/) / [react-i18next](https://react.i18next.com/) with dotted keys such as `pptx.statusBar.allSaved`. Initialise an i18next instance and wrap your app in `I18nextProvider` (the demo's `demo/i18n.ts` shows a minimal config, including a `parseMissingKeyHandler` that derives Title Case labels for any key you don't explicitly translate). `pptx-react-viewer/i18n` exports `translationsEn` (the English dictionary), `keyToLabel` (the fallback), and a `TranslationKey` type you can use to type-check a new locale dictionary (`Record<TranslationKey, string>`) at compile time. Add a new language by supplying a resource bundle under its language code. See the [Localization guide](https://christophervr.github.io/pptx-viewer/guide/localization) for full wiring examples and how to contribute a translation upstream; the live demo's language picker is a working reference.
@@ -175,6 +185,8 @@ UI labels go through [i18next](https://www.i18next.com/) / [react-i18next](https
 
 You only need the `<PowerPointViewer>` component; everything else is internal. Behind it, the logic lives in many small, focused React hooks, and the components themselves just draw what those hooks produce. Slides are rendered as ordinary HTML and CSS (charts as inline SVG, tables as real `<table>` elements), which is why text stays sharp, selectable, and accessible. For the full component tree, the rendering pipeline, the animation and transition engine, connector routing, collaboration, and a file-by-file map, see the [full documentation](https://christophervr.github.io/pptx-viewer/).
 
+A small curated set of those hooks is exported from `pptx-react-viewer/viewer` with a stable API; the complete set (67+) is also importable from `pptx-react-viewer/hooks-unstable` for advanced integrations, with **no compatibility guarantees** across releases. See the [Hooks reference](https://christophervr.github.io/pptx-viewer/react/hooks-reference) for the full list.
+
 ## Limitations
 
 CSS-based rendering trades a few visual effects for crisp text, accessibility, and DOM interactivity: `backdrop-filter` becomes semi-transparent backgrounds and path gradients approximate as elliptical radials, while `mix-blend-mode` and CSS 3D transforms render natively on screen but flatten in raster export. Text uses fonts available in the browser (embedded fonts are injected when present). Media playback depends on browser codec support. SmartArt is decomposed into editable shapes with a live reflow engine for structural edits, and charts edit via the inspector data grid rather than the chart surface. 3D models need the optional Three.js peer. See the [full docs](https://christophervr.github.io/pptx-viewer/) for the complete list.

package/dist/PowerPointViewer-BzsjqMzg.d.mts

@@ -0,0 +1,26 @@
+import { f, V } from './presentation-CLc4eS3z.js';
+import * as React from 'react';
+import React__default from 'react';
+import { b as PowerPointViewerProps, a as PowerPointViewerHandle } from './types-ui-DlsqFx7_.mjs';
+
+/**
+ * Thin adapter shim: the initial-style resolution now lives in
+ * `pptx-viewer-shared` (`render/animation-effects`). Shared returns a neutral
+ * `AnimationStyle` (camelCase inline-style map); these wrappers re-type the
+ * result as `React.CSSProperties` so React consumers/tests are unchanged.
+ */
+
+declare function getAnimationInitialStyle(preset: f | undefined, nativeAnimation?: V): React__default.CSSProperties;
+
+/**
+ * Root React component for the PowerPoint viewer/editor.
+ *
+ * Accepts binary `.pptx` content and renders a full-featured editor with
+ * slide canvas, toolbar, inspector panels, presentation mode, and more.
+ *
+ * Uses `forwardRef` to expose a `PowerPointViewerHandle` for imperative
+ * access (e.g. serialising the current content for saving).
+ */
+declare const PowerPointViewer: React.ForwardRefExoticComponent<PowerPointViewerProps & React.RefAttributes<PowerPointViewerHandle>>;
+
+export { PowerPointViewer as P, getAnimationInitialStyle as g };

package/dist/PowerPointViewer-C2a7iXAK.d.ts

@@ -0,0 +1,26 @@
+import { f, V } from './presentation-CLc4eS3z.js';
+import * as React from 'react';
+import React__default from 'react';
+import { b as PowerPointViewerProps, a as PowerPointViewerHandle } from './types-ui-DlsqFx7_.js';
+
+/**
+ * Thin adapter shim: the initial-style resolution now lives in
+ * `pptx-viewer-shared` (`render/animation-effects`). Shared returns a neutral
+ * `AnimationStyle` (camelCase inline-style map); these wrappers re-type the
+ * result as `React.CSSProperties` so React consumers/tests are unchanged.
+ */
+
+declare function getAnimationInitialStyle(preset: f | undefined, nativeAnimation?: V): React__default.CSSProperties;
+
+/**
+ * Root React component for the PowerPoint viewer/editor.
+ *
+ * Accepts binary `.pptx` content and renders a full-featured editor with
+ * slide canvas, toolbar, inspector panels, presentation mode, and more.
+ *
+ * Uses `forwardRef` to expose a `PowerPointViewerHandle` for imperative
+ * access (e.g. serialising the current content for saving).
+ */
+declare const PowerPointViewer: React.ForwardRefExoticComponent<PowerPointViewerProps & React.RefAttributes<PowerPointViewerHandle>>;
+
+export { PowerPointViewer as P, getAnimationInitialStyle as g };