@particle-academy/react-fancy 5.53.1 → 5.54.1

package/dist/json-editor.js

@@ -1,7 +1,7 @@
-export { JsonEditor, applyJsonEdit, describeEdit, findJsonConflicts, getAtPath, inferType, parseKeyMap, parsePath, pathToString, resolveKeyRule, typeMatches } from './chunk-OC5OUZSD.js';
+export { JsonEditor, applyJsonEdit, describeEdit, findJsonConflicts, getAtPath, inferType, parseKeyMap, parsePath, pathToString, resolveKeyRule, typeMatches } from './chunk-TBXZ3NGR.js';
 import './chunk-XQDGUXMS.js';
 import './chunk-T45LBTXH.js';
-import './chunk-VQXXX6DK.js';
+import './chunk-DXZCKDYS.js';
 import './chunk-2UTN3EFK.js';
 import './chunk-UVUBV4VZ.js';
 import './chunk-KXYMMNNV.js';
@@ -19,10 +19,10 @@ import './chunk-WHEXTDPV.js';
 import './chunk-6FCQD2KQ.js';
 import './chunk-RGANGU7X.js';
 import './chunk-JXE5XID6.js';
-import './chunk-26JZ47BJ.js';
+import './chunk-45JO5BEZ.js';
 import './chunk-6TBRBN7H.js';
 import './chunk-45BBNJQD.js';
-import './chunk-IVRYSSM7.js';
+import './chunk-J3A4Z2P7.js';
 import './chunk-ZXZJYVWP.js';
 import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';

package/dist/magic-wand.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk2KFHSFFY_cjs = require('./chunk-2KFHSFFY.cjs');
+var chunk6GKR5OAW_cjs = require('./chunk-6GKR5OAW.cjs');
 require('./chunk-MAZEX4EZ.cjs');
 require('./chunk-MRZXTL46.cjs');
 require('./chunk-P53432AK.cjs');
@@ -12,17 +12,17 @@ require('./chunk-NBZC6LOB.cjs');
 require('./chunk-VBWRH4UW.cjs');
 require('./chunk-MOU6O324.cjs');
 require('./chunk-M5MUGSON.cjs');
-require('./chunk-CAMQ5B3V.cjs');
+require('./chunk-XOXA3QZR.cjs');
 require('./chunk-X2FC7ODX.cjs');
 require('./chunk-XCZZVRBY.cjs');
-require('./chunk-QKFOJKVE.cjs');
+require('./chunk-MXWR3T3N.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
 
 
 Object.defineProperty(exports, "MagicWand", {
   enumerable: true,
-  get: function () { return chunk2KFHSFFY_cjs.MagicWand; }
+  get: function () { return chunk6GKR5OAW_cjs.MagicWand; }
 });
 //# sourceMappingURL=magic-wand.cjs.map
 //# sourceMappingURL=magic-wand.cjs.map

package/dist/magic-wand.js

@@ -1,4 +1,4 @@
-export { MagicWand } from './chunk-EJ6P7K4G.js';
+export { MagicWand } from './chunk-EULOJOTU.js';
 import './chunk-UVUBV4VZ.js';
 import './chunk-KXYMMNNV.js';
 import './chunk-WX5XYDVN.js';
@@ -10,10 +10,10 @@ import './chunk-WHEXTDPV.js';
 import './chunk-IQ4KQJAO.js';
 import './chunk-6FCQD2KQ.js';
 import './chunk-LQ4ICCN2.js';
-import './chunk-26JZ47BJ.js';
+import './chunk-45JO5BEZ.js';
 import './chunk-6TBRBN7H.js';
 import './chunk-45BBNJQD.js';
-import './chunk-IVRYSSM7.js';
+import './chunk-J3A4Z2P7.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=magic-wand.js.map
 //# sourceMappingURL=magic-wand.js.map

package/dist/media-viewer.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkE4TRDGSU_cjs = require('./chunk-E4TRDGSU.cjs');
+var chunkSLCR7A6W_cjs = require('./chunk-SLCR7A6W.cjs');
 require('./chunk-TH7VP4CL.cjs');
-require('./chunk-XM3W5ETT.cjs');
+require('./chunk-7MDHCYEB.cjs');
 require('./chunk-7QENPLOP.cjs');
 require('./chunk-M5SEYDSS.cjs');
 require('./chunk-T6YELZPJ.cjs');
@@ -14,7 +14,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "MediaViewer", {
   enumerable: true,
-  get: function () { return chunkE4TRDGSU_cjs.MediaViewer; }
+  get: function () { return chunkSLCR7A6W_cjs.MediaViewer; }
 });
 //# sourceMappingURL=media-viewer.cjs.map
 //# sourceMappingURL=media-viewer.cjs.map

package/dist/media-viewer.d.cts

@@ -1,7 +1,7 @@
-export { a as MediaViewer, b as MediaViewerProps } from './index-AesVUjQE.cjs';
+export { a as MediaViewer, b as MediaViewerProps } from './index-Bd4br4sF.cjs';
 import 'react';
 import './ImageViewer.types-CtqaA6KV.cjs';
 import './FauxClient.types-Dtk9aRs6.cjs';
 import './VideoViewer.types-_AwQ8DQr.cjs';
 import './AudioViewer.types-CyhmQVQd.cjs';
-import './PdfViewer.types-Bgn9EmZT.cjs';
+import './PdfViewer.types-DyoUBa2g.cjs';

package/dist/media-viewer.d.ts

@@ -1,7 +1,7 @@
-export { a as MediaViewer, b as MediaViewerProps } from './index-D3wJ8hrZ.js';
+export { a as MediaViewer, b as MediaViewerProps } from './index-Bwrc9ktU.js';
 import 'react';
 import './ImageViewer.types-BDTxBYEN.js';
 import './FauxClient.types-Dtk9aRs6.js';
 import './VideoViewer.types-_AwQ8DQr.js';
 import './AudioViewer.types-CyhmQVQd.js';
-import './PdfViewer.types-xnPpdjJa.js';
+import './PdfViewer.types-BEk2Jq6p.js';

package/dist/media-viewer.js

@@ -1,6 +1,6 @@
-export { MediaViewer } from './chunk-D4QOV56U.js';
+export { MediaViewer } from './chunk-MTTRPPHH.js';
 import './chunk-VOGI7GX3.js';
-import './chunk-HRH5BIYG.js';
+import './chunk-MORXQ5UM.js';
 import './chunk-ICMLLZKZ.js';
 import './chunk-GVMWJ4NI.js';
 import './chunk-CPY7NHXM.js';

package/dist/multi-switch.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-var chunkYVTFODCJ_cjs = require('./chunk-YVTFODCJ.cjs');
+var chunkWUG646R4_cjs = require('./chunk-WUG646R4.cjs');
+require('./chunk-I27K6NLX.cjs');
 require('./chunk-P53432AK.cjs');
 require('./chunk-QF7CD4JH.cjs');
 require('./chunk-O3F6DYWR.cjs');
@@ -13,7 +14,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "MultiSwitch", {
   enumerable: true,
-  get: function () { return chunkYVTFODCJ_cjs.MultiSwitch; }
+  get: function () { return chunkWUG646R4_cjs.MultiSwitch; }
 });
 //# sourceMappingURL=multi-switch.cjs.map
 //# sourceMappingURL=multi-switch.cjs.map

package/dist/multi-switch.js

@@ -1,4 +1,5 @@
-export { MultiSwitch } from './chunk-EEFWVFKO.js';
+export { MultiSwitch } from './chunk-KUJ5XRBD.js';
+import './chunk-SV5BW3IA.js';
 import './chunk-WX5XYDVN.js';
 import './chunk-5WQ6FPSP.js';
 import './chunk-USWQAMI3.js';

package/dist/pdf-viewer.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkXM3W5ETT_cjs = require('./chunk-XM3W5ETT.cjs');
+var chunk7MDHCYEB_cjs = require('./chunk-7MDHCYEB.cjs');
 require('./chunk-M5SEYDSS.cjs');
 require('./chunk-SNHU2AI4.cjs');
 require('./chunk-ZU5Q77OT.cjs');
@@ -9,7 +9,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "PdfViewer", {
   enumerable: true,
-  get: function () { return chunkXM3W5ETT_cjs.PdfViewer; }
+  get: function () { return chunk7MDHCYEB_cjs.PdfViewer; }
 });
 //# sourceMappingURL=pdf-viewer.cjs.map
 //# sourceMappingURL=pdf-viewer.cjs.map

package/dist/pdf-viewer.d.cts

@@ -1,5 +1,6 @@
 import * as react from 'react';
-import { P as PdfViewerProps } from './PdfViewer.types-Bgn9EmZT.cjs';
+import { b as PdfViewerProps } from './PdfViewer.types-DyoUBa2g.cjs';
+export { P as PdfPageSource, a as PdfViewerPolicy, c as PdfViewerWatermark } from './PdfViewer.types-DyoUBa2g.cjs';
 import './FauxClient.types-Dtk9aRs6.cjs';
 
 /**
@@ -11,6 +12,17 @@ import './FauxClient.types-Dtk9aRs6.cjs';
  * ```tsx
  * <PdfViewer src="/report.pdf" title="report.pdf" style={{ height: 600 }} />
  * ```
+ *
+ * With `pages` it shows page images the app rendered instead, and never
+ * fetches or references the PDF; `policy` and `watermark` apply there.
+ *
+ * ```tsx
+ * <PdfViewer
+ *   pages={{ count: 12, url: (n, scale) => `/docs/7/pages/${n}.png?scale=${scale}` }}
+ *   policy={{ download: false, print: false, copy: false, screenshot: "deter" }}
+ *   watermark={{ text: "jane@example.com" }}
+ * />
+ * ```
  */
 declare const PdfViewer: react.ForwardRefExoticComponent<PdfViewerProps & react.RefAttributes<HTMLDivElement>>;
 

package/dist/pdf-viewer.d.ts

@@ -1,5 +1,6 @@
 import * as react from 'react';
-import { P as PdfViewerProps } from './PdfViewer.types-xnPpdjJa.js';
+import { b as PdfViewerProps } from './PdfViewer.types-BEk2Jq6p.js';
+export { P as PdfPageSource, a as PdfViewerPolicy, c as PdfViewerWatermark } from './PdfViewer.types-BEk2Jq6p.js';
 import './FauxClient.types-Dtk9aRs6.js';
 
 /**
@@ -11,6 +12,17 @@ import './FauxClient.types-Dtk9aRs6.js';
  * ```tsx
  * <PdfViewer src="/report.pdf" title="report.pdf" style={{ height: 600 }} />
  * ```
+ *
+ * With `pages` it shows page images the app rendered instead, and never
+ * fetches or references the PDF; `policy` and `watermark` apply there.
+ *
+ * ```tsx
+ * <PdfViewer
+ *   pages={{ count: 12, url: (n, scale) => `/docs/7/pages/${n}.png?scale=${scale}` }}
+ *   policy={{ download: false, print: false, copy: false, screenshot: "deter" }}
+ *   watermark={{ text: "jane@example.com" }}
+ * />
+ * ```
  */
 declare const PdfViewer: react.ForwardRefExoticComponent<PdfViewerProps & react.RefAttributes<HTMLDivElement>>;
 

package/dist/pdf-viewer.js

@@ -1,4 +1,4 @@
-export { PdfViewer } from './chunk-HRH5BIYG.js';
+export { PdfViewer } from './chunk-MORXQ5UM.js';
 import './chunk-GVMWJ4NI.js';
 import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';

package/dist/prompt-input.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
-var chunkN7ABDCQ6_cjs = require('./chunk-N7ABDCQ6.cjs');
-require('./chunk-X7H75WVP.cjs');
+var chunkI2TBENUQ_cjs = require('./chunk-I2TBENUQ.cjs');
+require('./chunk-BJKKW77L.cjs');
+require('./chunk-I27K6NLX.cjs');
 require('./chunk-AIA5UNQ5.cjs');
 require('./chunk-5JK2VDWY.cjs');
 require('./chunk-UZG6LO4Z.cjs');
@@ -10,10 +11,10 @@ require('./chunk-NBZC6LOB.cjs');
 require('./chunk-57FQGQJK.cjs');
 require('./chunk-RXDRYWVD.cjs');
 require('./chunk-M5MUGSON.cjs');
-require('./chunk-CAMQ5B3V.cjs');
+require('./chunk-XOXA3QZR.cjs');
 require('./chunk-X2FC7ODX.cjs');
 require('./chunk-XCZZVRBY.cjs');
-require('./chunk-QKFOJKVE.cjs');
+require('./chunk-MXWR3T3N.cjs');
 require('./chunk-SNHU2AI4.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
@@ -21,7 +22,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "PromptInput", {
   enumerable: true,
-  get: function () { return chunkN7ABDCQ6_cjs.PromptInput; }
+  get: function () { return chunkI2TBENUQ_cjs.PromptInput; }
 });
 //# sourceMappingURL=prompt-input.cjs.map
 //# sourceMappingURL=prompt-input.cjs.map

package/dist/prompt-input.js

@@ -1,5 +1,6 @@
-export { PromptInput } from './chunk-2MUGEPRD.js';
-import './chunk-CF5KRDN4.js';
+export { PromptInput } from './chunk-REKY2CM6.js';
+import './chunk-TGBLDJ72.js';
+import './chunk-SV5BW3IA.js';
 import './chunk-TJ66S5K6.js';
 import './chunk-M6XBF2ZS.js';
 import './chunk-XYOT75HH.js';
@@ -8,10 +9,10 @@ import './chunk-WHEXTDPV.js';
 import './chunk-RGANGU7X.js';
 import './chunk-JXE5XID6.js';
 import './chunk-LQ4ICCN2.js';
-import './chunk-26JZ47BJ.js';
+import './chunk-45JO5BEZ.js';
 import './chunk-6TBRBN7H.js';
 import './chunk-45BBNJQD.js';
-import './chunk-IVRYSSM7.js';
+import './chunk-J3A4Z2P7.js';
 import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=prompt-input.js.map

package/dist/reason-tag.cjs

@@ -1,23 +1,23 @@
 'use strict';
 
-var chunkTFKG5FSG_cjs = require('./chunk-TFKG5FSG.cjs');
+var chunk4I4Y5MZO_cjs = require('./chunk-4I4Y5MZO.cjs');
 require('./chunk-UZG6LO4Z.cjs');
 require('./chunk-J2DI6RMR.cjs');
 require('./chunk-NBZC6LOB.cjs');
 require('./chunk-57FQGQJK.cjs');
 require('./chunk-RXDRYWVD.cjs');
 require('./chunk-M5MUGSON.cjs');
-require('./chunk-CAMQ5B3V.cjs');
+require('./chunk-XOXA3QZR.cjs');
 require('./chunk-X2FC7ODX.cjs');
 require('./chunk-XCZZVRBY.cjs');
-require('./chunk-QKFOJKVE.cjs');
+require('./chunk-MXWR3T3N.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
 
 
 Object.defineProperty(exports, "ReasonTag", {
   enumerable: true,
-  get: function () { return chunkTFKG5FSG_cjs.ReasonTag; }
+  get: function () { return chunk4I4Y5MZO_cjs.ReasonTag; }
 });
 //# sourceMappingURL=reason-tag.cjs.map
 //# sourceMappingURL=reason-tag.cjs.map

package/dist/reason-tag.js

@@ -1,14 +1,14 @@
-export { ReasonTag } from './chunk-Y6LL3B5P.js';
+export { ReasonTag } from './chunk-ZFU4FY3Q.js';
 import './chunk-XYOT75HH.js';
 import './chunk-MQ6VGG62.js';
 import './chunk-WHEXTDPV.js';
 import './chunk-RGANGU7X.js';
 import './chunk-JXE5XID6.js';
 import './chunk-LQ4ICCN2.js';
-import './chunk-26JZ47BJ.js';
+import './chunk-45JO5BEZ.js';
 import './chunk-6TBRBN7H.js';
 import './chunk-45BBNJQD.js';
-import './chunk-IVRYSSM7.js';
+import './chunk-J3A4Z2P7.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=reason-tag.js.map
 //# sourceMappingURL=reason-tag.js.map

package/dist/switch.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 require('./chunk-OYZDSMNP.cjs');
-var chunkRVBTDXPD_cjs = require('./chunk-RVBTDXPD.cjs');
+var chunk2O5UXH5R_cjs = require('./chunk-2O5UXH5R.cjs');
 require('./chunk-O3F6DYWR.cjs');
 require('./chunk-KJ22KE56.cjs');
 require('./chunk-L3V3BYVS.cjs');
@@ -12,7 +12,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "Switch", {
   enumerable: true,
-  get: function () { return chunkRVBTDXPD_cjs.Switch; }
+  get: function () { return chunk2O5UXH5R_cjs.Switch; }
 });
 //# sourceMappingURL=switch.cjs.map
 //# sourceMappingURL=switch.cjs.map

package/dist/switch.js

@@ -1,5 +1,5 @@
 import './chunk-NW3GJWJ7.js';
-export { Switch } from './chunk-VQXXX6DK.js';
+export { Switch } from './chunk-DXZCKDYS.js';
 import './chunk-USWQAMI3.js';
 import './chunk-OL53XYHF.js';
 import './chunk-NRXK42LO.js';

package/dist/tooltip.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-var chunkX7H75WVP_cjs = require('./chunk-X7H75WVP.cjs');
+var chunkBJKKW77L_cjs = require('./chunk-BJKKW77L.cjs');
+require('./chunk-I27K6NLX.cjs');
 require('./chunk-J2DI6RMR.cjs');
 require('./chunk-NBZC6LOB.cjs');
 require('./chunk-ZU5Q77OT.cjs');
@@ -9,7 +10,7 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "Tooltip", {
   enumerable: true,
-  get: function () { return chunkX7H75WVP_cjs.Tooltip; }
+  get: function () { return chunkBJKKW77L_cjs.Tooltip; }
 });
 //# sourceMappingURL=tooltip.cjs.map
 //# sourceMappingURL=tooltip.cjs.map

package/dist/tooltip.js

@@ -1,4 +1,5 @@
-export { Tooltip } from './chunk-CF5KRDN4.js';
+export { Tooltip } from './chunk-TGBLDJ72.js';
+import './chunk-SV5BW3IA.js';
 import './chunk-MQ6VGG62.js';
 import './chunk-WHEXTDPV.js';
 import './chunk-MMW2JGKZ.js';

package/docs/PdfViewer.md

@@ -1,7 +1,13 @@
 # PdfViewer
 
-A standalone PDF viewer — embeds the document via the browser's native PDF
-plugin (`<object>`), falling back to an `<iframe>`, then to a download link.
+A standalone PDF viewer with two modes:
+
+- **`src`**: embeds the document via the browser's native PDF plugin
+  (`<object>`), falling back to an `<iframe>`, then to a download link.
+- **`pages`** (page-image mode): shows page images your app rendered from the
+  PDF, behind its own auth, under an access `policy`, with an optional
+  `watermark`. The viewer never fetches or references the PDF.
+
 Renders for PDF sources inside `MediaViewer`.
 
 ## Import
@@ -19,11 +25,107 @@ import { PdfViewer } from "@particle-academy/react-fancy";
 The viewer fills its container, so give it a height. A `min-h` floor (`20rem`)
 is built in so it stays usable even without an explicit height.
 
+The native plugin always shows its own download and print buttons and exposes
+the file's URL, and a page cannot restrict it. If a viewer must not get the
+file, use page-image mode.
+
+## Page-image mode
+
+```tsx
+<PdfViewer
+  frame
+  title="contract-7.pdf"
+  pages={{ count: 12, url: (page, scale) => `/documents/7/pages/${page}.png?scale=${scale}` }}
+  policy={{ download: false, print: false, copy: false, screenshot: "deter" }}
+  watermark={{ text: "Jane Doe · jane@example.com · 2026-10-21 14:02" }}
+  style={{ height: 640 }}
+/>
+```
+
+Your app turns the PDF into one image per page on its server, with whatever
+tool it already uses, and serves them behind its own auth. react-fancy only
+displays them. The `pages.url` images are the only requests the viewer makes;
+`src` is ignored in this mode, even if you pass one.
+
+- **`url(page, scale)`**: `page` is 1-based. `scale` is a resolution hint: the
+  zoom times the device pixel ratio, rounded **up** to one of `1`, `1.5`, `2`,
+  `3` or `4`, so a page is fetched at a handful of sizes rather than once per
+  zoom click. Render scale 1 at a width that reads sharply at fit-width in your
+  layout (e.g. 1000-1200 px).
+- **`aspectRatio`** (optional, width / height) sizes a page before its image
+  arrives. Default A4 portrait. Each page switches to its image's real ratio
+  once it has loaded.
+- **Lazy**: only pages near the viewport get an `<img>` (a viewport's height
+  above and below).
+- **Toolbar**: previous / next page with "n / total", zoom out / zoom
+  percentage (click to reset) / zoom in, **Width** (fit width, which is 100%)
+  and **Page** (fit one page to the height). With `frame`, the `FauxClient`
+  frame adds full screen; the current page stays in place when the viewer
+  resizes.
+- **No search.** Page images carry no text, so there is nothing to search.
+  This is a consequence of not sending the PDF.
+- **Controlled state** for agents and hosts: `page` / `onPageChange` and
+  `zoom` / `onZoomChange`. Stable handles:
+  `[data-react-fancy-pdf-viewer-page][data-page="3"]`, and
+  `data-react-fancy-pdf-viewer-{prev,next,zoom-in,zoom-out,zoom-reset,fit-width,fit-page}`
+  on the buttons.
+
+### Policy: what each flag does and does not do
+
+Every flag defaults to allowed. **These are deterrents.** A web page cannot stop
+someone who is determined: anything drawn on a screen can be photographed,
+screenshotted or pulled out of devtools. The real protection is that in this
+mode the app never serves the PDF, and page images are all a viewer ever gets.
+
+| Flag | Does | Does not |
+|------|------|----------|
+| `download: false` | Suppresses the context menu ("Save image as…") on the pages, and makes the images non-draggable. There is no download control in this mode at all, whatever the flag. | Stop the page images being captured: they are ordinary images the browser has fetched, visible in devtools and the browser's cache. |
+| `print: false` | Print CSS blanks the viewer, so printing (Ctrl/Cmd+P, the browser menu, `window.print()`) produces an empty frame. Ctrl/Cmd+P is also intercepted while focus is inside the viewer. | Stop a screenshot, a "save page", or a user who edits the CSS in devtools. |
+| `copy: false` | Turns user selection off. (There is no text layer to copy anyway.) | Anything else; the images can still be captured. |
+| `screenshot: "deter"` | Blurs the pages while the tab is hidden or the window has lost focus. On a PrintScreen key it blurs them for 1.5 s and tries to clear the clipboard, best effort. | **Prevent screenshots. A web page cannot.** OS tools, other apps and phone cameras are all out of its reach, and PrintScreen usually captures before the page hears the key. |
+
+### Watermark
+
+```tsx
+watermark={{ text: "jane@example.com", opacity: 0.15, angle: -30, density: 1 }}
+```
+
+A tiled text overlay drawn over every page in the browser, with
+`pointer-events: none`. Defaults: `opacity` 0.15, `angle` -30°, `density` 1
+(2 halves the gap between repeats).
+
+**A client-side watermark can be removed with devtools.** If yours must hold,
+burn it into the page images on your server: the `url(page, scale)` callback is
+the place to ask for that (e.g. a per-viewer URL your server stamps).
+
 ## Props
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| src | `string` | — | PDF source (`http(s):` / `data:` / `blob:`) |
-| title | `string` | `"PDF document"` | Accessible title for the embedded document |
+| src | `string` | — | PDF source (`http(s):` / `data:` / `blob:`) for the native plugin. Ignored with `pages` |
+| pages | `{ count: number; url: (page, scale) => string; aspectRatio?: number }` | — | Page-image mode |
+| page | `number` | — | Current page (1-based), controlled |
+| defaultPage | `number` | `1` | Starting page, uncontrolled |
+| onPageChange | `(page: number) => void` | — | Page changed (toolbar or scrolling) |
+| zoom | `number` | — | Zoom, 1 = fit width, controlled (page-image mode) |
+| defaultZoom | `number` | `1` | Starting zoom, uncontrolled |
+| onZoomChange | `(zoom: number) => void` | — | Zoom changed |
+| policy | `{ download?: boolean; print?: boolean; copy?: boolean; screenshot?: "allow" \| "deter" }` | all allowed | See above (page-image mode only) |
+| watermark | `{ text: string; opacity?: number; angle?: number; density?: number }` | — | See above (page-image mode only) |
+| frame | `boolean` | `false` | Show inside the `FauxClient` frame, with full screen |
+| frameProps | `Partial<FauxClientProps>` | — | Passed to the frame |
+| title | `string` | `"PDF document"` | Accessible title, and the frame's address-bar text |
 | className | `string` | — | Classes for the container |
 | style | `CSSProperties` | — | Styles for the container (e.g. a height) |
+
+## Through MediaViewer and FileViewer
+
+Both already forward `pdfProps` untouched, so page-image mode needs no new
+props on either:
+
+```tsx
+<MediaViewer kind="pdf" src="" pdfProps={{ pages, policy, watermark }} />
+
+// @particle-academy/fancy-code
+<FileViewer filename="contract.pdf" mediaProps={{ pdfProps: { pages, policy, watermark } }} />
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/react-fancy",
-  "version": "5.53.1",
+  "version": "5.54.1",
   "description": "React UI component library for Human+ UX — controlled, agent-bridgeable primitives",
   "repository": {
     "type": "git",

package/dist/PdfViewer.types-Bgn9EmZT.d.cts

@@ -1,22 +0,0 @@
-import { F as FauxClientProps } from './FauxClient.types-Dtk9aRs6.cjs';
-import { CSSProperties } from 'react';
-
-interface PdfViewerProps {
-    /**
-     * Show the PDF in react-fancy's `FauxClient` frame with a full-screen button,
-     * revealed on hover. Zoom stays on the browser's own PDF toolbar. Default `false`.
-     */
-    frame?: boolean;
-    /** Passed to the frame (`variant`, `onFullscreenChange`, …). */
-    frameProps?: Partial<FauxClientProps>;
-    /** PDF source — an `http(s):`, `data:`, or `blob:` URL. */
-    src: string;
-    /** Accessible title for the embedded document (default `"PDF document"`). */
-    title?: string;
-    /** Additional CSS classes for the container. */
-    className?: string;
-    /** Inline styles for the container (e.g. a fixed height). */
-    style?: CSSProperties;
-}
-
-export type { PdfViewerProps as P };

package/dist/PdfViewer.types-xnPpdjJa.d.ts

@@ -1,22 +0,0 @@
-import { F as FauxClientProps } from './FauxClient.types-Dtk9aRs6.js';
-import { CSSProperties } from 'react';
-
-interface PdfViewerProps {
-    /**
-     * Show the PDF in react-fancy's `FauxClient` frame with a full-screen button,
-     * revealed on hover. Zoom stays on the browser's own PDF toolbar. Default `false`.
-     */
-    frame?: boolean;
-    /** Passed to the frame (`variant`, `onFullscreenChange`, …). */
-    frameProps?: Partial<FauxClientProps>;
-    /** PDF source — an `http(s):`, `data:`, or `blob:` URL. */
-    src: string;
-    /** Accessible title for the embedded document (default `"PDF document"`). */
-    title?: string;
-    /** Additional CSS classes for the container. */
-    className?: string;
-    /** Inline styles for the container (e.g. a fixed height). */
-    style?: CSSProperties;
-}
-
-export type { PdfViewerProps as P };