@alfadocs/ui-kit 0.9.1 → 0.11.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.9.1",
+  "packageVersion": "0.11.0",
   "components": [
     {
       "kind": "component",
@@ -2445,6 +2445,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "rating",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "rating",
+          "description": "Marks the element as a kit Rating."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "recaptcha-widget",

package/dist/components/index.d.ts

@@ -47,6 +47,7 @@ export * from './kbd';
 export * from './key-value-pair';
 export * from './list';
 export * from './logo';
+export * from './rating';
 export * from './skeleton';
 export * from './sparkline';
 export * from './stat';

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/components/rating/index.d.ts

@@ -0,0 +1,3 @@
+export { Rating } from './rating';
+export type { RatingProps } from './rating';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/rating/index.js

@@ -0,0 +1,5 @@
+import { R as r } from "../../_chunks/rating-BRD7O74e.js";
+export {
+  r as Rating
+};
+//# sourceMappingURL=index.js.map

package/dist/components/rating/rating.d.ts

@@ -0,0 +1,29 @@
+import { type HTMLAttributes } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+declare const ratingVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+interface RatingProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'aria-label'>, VariantProps<typeof ratingVariants> {
+    /** Average score, 0..max. Fractional values render as half-step fills. */
+    value: number;
+    /** Total number of stars. Defaults to 5. */
+    max?: number;
+    /** Optional inline review-count summary. Plural-aware via i18next. */
+    reviews?: {
+        count: number;
+        label?: string;
+    };
+    /** Underline the reviews summary text — useful when it's a link. */
+    underlined?: boolean;
+    /**
+     * When `true`, the rating is decorative — `aria-hidden`, no role, no
+     * computed label. Use when the surrounding context already announces
+     * the score (e.g. a card whose accessible name includes the value).
+     */
+    decorative?: boolean;
+    /** Override the default i18n-derived `aria-label`. */
+    'aria-label'?: string;
+}
+export declare const Rating: import("react").ForwardRefExoticComponent<RatingProps & import("react").RefAttributes<HTMLSpanElement>>;
+export type { RatingProps };
+//# sourceMappingURL=rating.d.ts.map

package/dist/components/sidebar/index.js

@@ -1,4 +1,4 @@
-import { S as r, a as i, b as s, c as d, d as S, e as b, f as t, g as o, h as m, i as n, j as l, k as c, l as I, m as g, n as p, o as u, p as P, s as f, u as B, q as F } from "../../_chunks/sidebar-CoLHtVrP.js";
+import { S as r, a as i, b as s, c as d, d as S, e as b, f as t, g as o, h as m, i as n, j as l, k as c, l as I, m as g, n as p, o as u, p as P, s as f, u as B, q as F } from "../../_chunks/sidebar-D8Lq065m.js";
 export {
   r as Sidebar,
   i as SidebarBody,

package/dist/i18n/config.js

@@ -349,6 +349,14 @@ const a = {
       secondaryCta: "Contact support"
     }
   },
+  rating: {
+    // Default aria-label for a non-decorative Rating, plus the inline
+    // summary used when `reviews` is provided. `_one` / `_other` plurals
+    // make the i18next CLDR pluralizer pick the right form per locale.
+    label: "{{value}} out of {{max}} stars",
+    reviews_one: "{{value}} stars · 1 review",
+    reviews_other: "{{value}} stars · {{count}} reviews"
+  },
   sparkline: {
     summary: "{{label}}: min {{min}}, max {{max}}, current {{current}}, {{direction}}",
     summaryNoLabel: "min {{min}}, max {{max}}, current {{current}}, {{direction}}",
@@ -819,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",
@@ -1321,6 +1330,11 @@ const a = {
       secondaryCta: "Contatta il supporto"
     }
   },
+  rating: {
+    label: "{{value}} stelle su {{max}}",
+    reviews_one: "{{value}} stelle · 1 opinione",
+    reviews_other: "{{value}} stelle · {{count}} opinioni"
+  },
   sparkline: {
     summary: "{{label}}: min {{min}}, max {{max}}, attuale {{current}}, {{direction}}",
     summaryNoLabel: "min {{min}}, max {{max}}, attuale {{current}}, {{direction}}",
@@ -1764,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",
@@ -2266,6 +2281,11 @@ const a = {
       secondaryCta: "Support kontaktieren"
     }
   },
+  rating: {
+    label: "{{value}} von {{max}} Sternen",
+    reviews_one: "{{value}} Sterne · 1 Bewertung",
+    reviews_other: "{{value}} Sterne · {{count}} Bewertungen"
+  },
   sparkline: {
     summary: "{{label}}: Min. {{min}}, Max. {{max}}, aktuell {{current}}, {{direction}}",
     summaryNoLabel: "Min. {{min}}, Max. {{max}}, aktuell {{current}}, {{direction}}",
@@ -2709,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",
@@ -2870,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",
@@ -2923,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

@@ -367,6 +367,11 @@ export declare const enUi: {
             readonly secondaryCta: "Contact support";
         };
     };
+    readonly rating: {
+        readonly label: "{{value}} out of {{max}} stars";
+        readonly reviews_one: "{{value}} stars · 1 review";
+        readonly reviews_other: "{{value}} stars · {{count}} reviews";
+    };
     readonly sparkline: {
         readonly summary: "{{label}}: min {{min}}, max {{max}}, current {{current}}, {{direction}}";
         readonly summaryNoLabel: "min {{min}}, max {{max}}, current {{current}}, {{direction}}";
@@ -835,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";
@@ -1358,6 +1364,11 @@ export declare const itUi: {
             readonly secondaryCta: "Contatta il supporto";
         };
     };
+    readonly rating: {
+        readonly label: "{{value}} stelle su {{max}}";
+        readonly reviews_one: "{{value}} stelle · 1 opinione";
+        readonly reviews_other: "{{value}} stelle · {{count}} opinioni";
+    };
     readonly sparkline: {
         readonly summary: "{{label}}: min {{min}}, max {{max}}, attuale {{current}}, {{direction}}";
         readonly summaryNoLabel: "min {{min}}, max {{max}}, attuale {{current}}, {{direction}}";
@@ -1802,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";
@@ -2328,6 +2340,11 @@ export declare const deUi: {
             readonly secondaryCta: "Support kontaktieren";
         };
     };
+    readonly rating: {
+        readonly label: "{{value}} von {{max}} Sternen";
+        readonly reviews_one: "{{value}} Sterne · 1 Bewertung";
+        readonly reviews_other: "{{value}} Sterne · {{count}} Bewertungen";
+    };
     readonly sparkline: {
         readonly summary: "{{label}}: Min. {{min}}, Max. {{max}}, aktuell {{current}}, {{direction}}";
         readonly summaryNoLabel: "Min. {{min}}, Max. {{max}}, aktuell {{current}}, {{direction}}";
@@ -2772,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";