@alfadocs/ui-kit 0.10.0 → 0.11.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.10.0",
+  "packageVersion": "0.11.0",
   "components": [
     {
       "kind": "component",

package/dist/components/pdf-viewer/index.js

@@ -1,4 +1,4 @@
-import { P as p, p as a } from "../../_chunks/pdf-viewer-CNETPubN.js";
+import { P as p, p as a } from "../../_chunks/pdf-viewer-CnEJvmXC.js";
 export {
   p as PDFViewer,
   a as pdfViewerAgent

package/dist/components/pdf-viewer/pdf-viewer.d.ts

@@ -1,4 +1,30 @@
+import { type ReactNode } from 'react';
 export type PDFZoomPreset = 'fit-width' | 'fit-page' | 'actual-size' | number;
+export type PDFPageRotation = 0 | 90 | 180 | 270;
+/**
+ * Arguments passed to `renderPageOverlay` for each rendered page.
+ *
+ * `pageWidthCss` and `pageHeightCss` are post-zoom, post-rotation CSS
+ * pixel dimensions — exactly the rendered box the consumer is
+ * positioning content over. They update on resize, zoom, and rotation
+ * changes; the render-prop re-runs on every change so positioned
+ * children stay in sync with the page geometry without the consumer
+ * touching a `ResizeObserver`.
+ */
+export interface PDFPageOverlayArgs {
+    /** 1-based page number. */
+    pageNumber: number;
+    /** CSS-pixel width of the rendered page (post-zoom, post-rotation). */
+    pageWidthCss: number;
+    /** CSS-pixel height of the rendered page. */
+    pageHeightCss: number;
+    /**
+     * Effective rotation of the rendered viewport in degrees. Reflects
+     * `pageRotation` (if set) overriding the page's intrinsic `/Rotate`,
+     * otherwise the intrinsic rotation.
+     */
+    rotation: PDFPageRotation;
+}
 export interface PDFViewerProps {
     /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
     id?: string;
@@ -8,6 +34,42 @@ export interface PDFViewerProps {
     initialPage?: number;
     /** Initial zoom preset. Default 'fit-width'. */
     initialZoom?: PDFZoomPreset;
+    /**
+     * Force every page to render at this rotation, overriding the page's
+     * intrinsic `/Rotate` metadata. Useful for scanned PDFs that opened
+     * sideways, and for the signing-flow consumer that lets users
+     * straighten misrotated pages before placing signature fields.
+     * `undefined` (default) honours each page's intrinsic rotation.
+     */
+    pageRotation?: PDFPageRotation;
+    /**
+     * Render a layer of arbitrary React content positioned over each
+     * rendered PDF page — signature fields, redaction boxes, annotation
+     * pins, anything that needs to live in PDF coordinate space.
+     *
+     * The render-prop is invoked **only for pages currently inside the
+     * IntersectionObserver buffer** (visible ±1), and the returned tree
+     * unmounts when the page leaves the buffer. Consumer-held timers /
+     * fetches / subscriptions in overlay children therefore tear down
+     * automatically with the page. The overlay container is absolutely
+     * positioned, sized to the rendered page, and has
+     * `pointer-events: auto` so consumer children can be interactive.
+     * Consumers position children themselves (typically
+     * `position: absolute; inset-inline-start: %; inset-block-start: %`).
+     *
+     * The render-prop re-runs on resize, zoom, and rotation changes so
+     * positioned children stay aligned without the consumer wiring a
+     * `ResizeObserver`. Pages already declare `data-page-number` on the
+     * `<article>` ancestor; consumer-rendered children should be
+     * keyboard-reachable per the kit's a11y contract.
+     *
+     * Composition note: PDF.js's `AnnotationLayer` (for native form
+     * fields and link annotations) is not yet wired in — see the file
+     * header TODO. When it lands, `renderPageOverlay` will compose
+     * **above** the AnnotationLayer in z-order, since interactive
+     * consumer content should sit on top of intrinsic page widgets.
+     */
+    renderPageOverlay?: (args: PDFPageOverlayArgs) => ReactNode;
     /** Emits when the currently-most-visible page changes. */
     onPageChange?: (page: number) => void;
     /** Emits once the PDF document has loaded. */

package/dist/i18n/config.js

@@ -827,7 +827,8 @@ const a = {
     print: "Print",
     download: "Download",
     loading: "Loading PDF…",
-    error: "Failed to load PDF"
+    error: "Failed to load PDF",
+    pageOverlay: "Page {{page}} overlay"
   },
   paywall: {
     title: "Upgrade to keep going",
@@ -1777,7 +1778,8 @@ const a = {
     print: "Stampa",
     download: "Scarica",
     loading: "Caricamento PDF…",
-    error: "Impossibile caricare il PDF"
+    error: "Impossibile caricare il PDF",
+    pageOverlay: "Overlay pagina {{page}}"
   },
   paywall: {
     title: "Esegui l'upgrade per continuare",
@@ -2727,7 +2729,8 @@ const a = {
     print: "Drucken",
     download: "Herunterladen",
     loading: "PDF wird geladen …",
-    error: "PDF konnte nicht geladen werden"
+    error: "PDF konnte nicht geladen werden",
+    pageOverlay: "Seitenoverlay {{page}}"
   },
   paywall: {
     title: "Upgraden, um fortzufahren",
@@ -2888,13 +2891,13 @@ const a = {
       label: "{{state}} {{amount}}"
     }
   }
-}, o = {}, p = ["en", "it", "de", "ar"], m = {
+}, o = {}, p = ["en", "it", "de", "ar"], g = {
   en: a,
   it: n,
   de: i,
   ar: o
 };
-function g(r, s) {
+function m(r, s) {
   t.addResourceBundle(
     r,
     "ui",
@@ -2941,7 +2944,7 @@ export {
   b as default,
   a as enUi,
   n as itUi,
-  g as registerUiBundle,
-  m as uiResources
+  m as registerUiBundle,
+  g as uiResources
 };
 //# sourceMappingURL=config.js.map

package/dist/i18n/resources.d.ts

@@ -840,6 +840,7 @@ export declare const enUi: {
         readonly download: "Download";
         readonly loading: "Loading PDF…";
         readonly error: "Failed to load PDF";
+        readonly pageOverlay: "Page {{page}} overlay";
     };
     readonly paywall: {
         readonly title: "Upgrade to keep going";
@@ -1812,6 +1813,7 @@ export declare const itUi: {
         readonly download: "Scarica";
         readonly loading: "Caricamento PDF…";
         readonly error: "Impossibile caricare il PDF";
+        readonly pageOverlay: "Overlay pagina {{page}}";
     };
     readonly paywall: {
         readonly title: "Esegui l'upgrade per continuare";
@@ -2787,6 +2789,7 @@ export declare const deUi: {
         readonly download: "Herunterladen";
         readonly loading: "PDF wird geladen …";
         readonly error: "PDF konnte nicht geladen werden";
+        readonly pageOverlay: "Seitenoverlay {{page}}";
     };
     readonly paywall: {
         readonly title: "Upgraden, um fortzufahren";

package/dist/index.js

@@ -118,7 +118,7 @@ import { T as _n, t as Gn } from "./_chunks/transcript-panel-BpJqPr7I.js";
 import { T as Un } from "./_chunks/typing-indicator-DHeVN4ob.js";
 import { C as Yn, c as jn, r as zn } from "./_chunks/calendar-zy0tUUVG.js";
 import { P as Qn, f as Jn, p as Xn, a as Zn, s as $n, b as ai, c as ei } from "./_chunks/payment-form-CI77oIx1.js";
-import { P as oi, p as ti } from "./_chunks/pdf-viewer-CNETPubN.js";
+import { P as oi, p as ti } from "./_chunks/pdf-viewer-CnEJvmXC.js";
 import { R as ni, e as ii, r as pi, t as mi, a as li, w as di } from "./_chunks/rich-text-editor-C7TCIlQO.js";
 import { S as gi, s as ci } from "./_chunks/signature-capture-DjMlFOzS.js";
 import { S as ui, f as Ai, i as Si } from "./_chunks/slot-grid-CgpYgBkW.js";

package/dist/locales/de.json

@@ -807,7 +807,8 @@
     "print": "Drucken",
     "download": "Herunterladen",
     "loading": "PDF wird geladen …",
-    "error": "PDF konnte nicht geladen werden"
+    "error": "PDF konnte nicht geladen werden",
+    "pageOverlay": "Seitenoverlay {{page}}"
   },
   "paywall": {
     "title": "Upgraden, um fortzufahren",

package/dist/locales/en.json

@@ -838,7 +838,8 @@
     "print": "Print",
     "download": "Download",
     "loading": "Loading PDF…",
-    "error": "Failed to load PDF"
+    "error": "Failed to load PDF",
+    "pageOverlay": "Page {{page}} overlay"
   },
   "paywall": {
     "title": "Upgrade to keep going",

package/dist/locales/it.json

@@ -807,7 +807,8 @@
     "print": "Stampa",
     "download": "Scarica",
     "loading": "Caricamento PDF…",
-    "error": "Impossibile caricare il PDF"
+    "error": "Impossibile caricare il PDF",
+    "pageOverlay": "Overlay pagina {{page}}"
   },
   "paywall": {
     "title": "Esegui l'upgrade per continuare",